关于 lark-whiteboard
lark-whiteboard 是用于飞书画板的 Agent Skill，供命令行工具调用。它支持导出画板内容，也支持以 Mermaid、PlantUML、SVG 等格式写入或更新画板。
主要功能
- 01导出预览图片、SVG 或源码
- 02支持 Mermaid、PlantUML、SVG 写入
- 03区分只读与写入操作的决策规则
- 04可在已有画板上追加或覆盖内容
适用场景
- 01导出飞书画板为图片或 SVG
- 02将已有 Mermaid 或 PlantUML 代码写入画板
- 03基于需求从零绘制架构或流程图
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/lark-whiteboard确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
elements/connectors.mdcontent.mdimage.mdlayout.mdschema.mdstyle.mdtypography.mdreferences/lark-whiteboard-export.mdlark-whiteboard-update.mdlark-whiteboard-workflow.mdroutes/dsl.mdmermaid.mdsvg-edit.mdsvg.mdscenes/architecture.mdbar-chart.mdcomparison.mdfishbone.mdflowchart.mdflywheel.mdfunnel.mdline-chart.mdmention.mdmermaid.mdmilestone.mdorganization.mdphoto-showcase.mdpyramid.mdswimlane.mdtreemap.md详细介绍
来自项目 README重要
- 运行
lark-cli --version，确认可用，无需询问用户。- 运行
npx -y @larksuite/whiteboard-cli@^0.2.13 -v，确认可用，无需询问用户。
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../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 | 首次写入 | — |
| 修改 / 增补已有画板 | → § 编辑 Workflow | 见该表 | 见该表 |
Shortcuts
| Shortcut | 说明 |
|---|---|
+export | 导出画板为预览图片、SVG 矢量图、代码或原始节点结构。 |
+update | 更新画板，支持 PlantUML、Mermaid、SVG 或 OpenAPI 原生格式 |
不在本 skill 范围
- 文档内容编辑 → lark-doc lark-doc
- 在文档中创建画板 → lark-doc-whiteboard.md
- 表格 / Base 操作 → lark-sheets / lark-base
评论
支持 Markdown