Skip to main content
[!IMPORTANT]
  • 运行 lark-cli --version，确认可用，无需询问用户。
  • 运行 npx -y @larksuite/whiteboard-cli@^0.2.10 -v，确认可用，无需询问用户。
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-shared/SKILL.md，其中包含认证、权限处理

​
快速决策

⚠️ 强制规范（通过 stdin 更新）： 数据来源于本地文件时，必须使用 --source - --input_format <格式>。 例：cat chart.mmd | lark-cli whiteboard +update <token> --source - --input_format mermaid

​
Shortcuts

​
创作 Workflow

此 workflow 用于独立创作一个画板。 需要在文档中批量创建多个画板时，由 lark-doc 负责调度，见 lark-doc 技能的 references/lark-doc-whiteboard.md。
Step 1：获取 board_token Step 2：渲染 & 写入 → 进入 § 渲染 & 写入画板 章节，按流程完成后直接返回结果给用户。

​
修改 Workflow

Step 1：获取 board_token（同创作 Workflow Step 1） Step 2：判断修改策略

​
渲染 & 写入画板

​
渲染路由

先自报身份：按训练来源，你属于哪一家？Claude / Gemini / GPT / GLM / Doubao 或 Seed / Other。身份决定 SVG / DSL 分流（不同家族对这两种表达语言的能力不均衡），不要跳过这一步。 然后按图表类型 × 身份选路径，读对应文件按其完整 workflow 执行（含读 scene 指南、生成内容、渲染审查、交付）：
⚠️ SVG 路径失败回退：走 routes/svg.md 时，碰到以下情况之一 → 丢弃当前 SVG，改读 routes/dsl.md 从零重画，不要逐行修补：
  • 渲染命令直接报错（语法级崩溃，不是 --check 的 warn/error）
  • 两轮改写仍无法消除 --check 的 text-overflow error
  • 目测 PNG 视觉严重错乱（文字大面积溢出、元素重叠压住关键信息、布局整体崩溃）
SVG 源码修补常常引入新 bug，换 DSL 从零重画往往更稳。这是 SVG 路径自由发挥的硬兜底，不要侵入 routes/svg.md 的创作流程。

​
产物规范

产物目录：./diagrams/YYYY-MM-DDTHHMMSS/（本地时间，不含冒号和时区后缀）。如用户指定路径，以用户为准。 目录内固定文件名：

​
写入画板

[!CAUTION] 写入前强制 dry-run：向已有内容的画板写入时，必须先加 --overwrite --dry-run 探测。 输出含 XX whiteboard nodes will be deleted → 必须向用户确认后才能执行。
--idempotent-token 最少 10 字符，建议用时间戳+标识拼接（如 1744800000-board-1），避免重试导致重复写入。 如需应用身份上传，将 --as user 替换为 --as bot。