按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。
[!IMPORTANT] - 运行lark-cli --version,确认可用,无需询问用户。 - 运行npx -y @larksuite/whiteboard-cli@^0.2.13 -v,确认可用,无需询问用户。
CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md),其中包含认证、权限处理
快速决策
身份:画板操作默认使用 --as user。仅当需要以应用身份上传时使用 --as bot。
先判断「只读还是写入」,再在对应表内按上到下匹配,命中即停。
A. 只读 · 查看 / 导出(不改画板)
| 用户需求 | 行动 |
|---|---|
| 查看画板内容 / 导出图片 | `+export --output-type preview` |
| 导出 SVG 矢量图 | `+export --output-type svg` |
| 提取画板的 Mermaid/PlantUML 源码 | `+export --output-type source` |
B. 写入 · 创作 / 编辑(会改画板,命中即停)
| 场景 | 行动 | 写入方式 | 对原内容 |
|---|---|---|---|
| 用户已提供 Mermaid/PlantUML/SVG 代码,或明确指定用该格式 | 使用该代码 → `+update`,--input_format 取单值 mermaid / plantuml / svg;写入非空已有画板并需要 overwrite 时,先确认会整板重建;若 SVG 用于修改已有画板,先走 `routes/svg-edit.md` 有损确认 | overwrite / append | 按用户要求 |
| 从零新建复杂图表(架构/流程/组织等) | → [§ 创作 Workflow](references/lark-whiteboard-workflow.md#创作-workflow) | 首次写入 | — |
| 修改 / 增补已有画板 | → [§ 编辑 Workflow](references/lark-whiteboard-workflow.md#编辑-workflow) | 见该表 | 见该表 |
Shortcuts
不在本 skill 范围
- 文档内容编辑 → lark-doc lark-doc
- 在文档中创建画板 → lark-doc-whiteboard.md
- 表格 / Base 操作 → lark-sheets / lark-base

