lark-whiteboard

面向飞书云文档画板的技能：可导出画板预览图片、SVG 矢量图、Mermaid/PlantUML 源码与原始节点结构，也可用 Mermaid、PlantUML、SVG 或 OpenAPI 原生 DSL 更新画板。内置流程图、架构图、组织图、泳道图、漏斗、金字塔等场景指南与布局、配色、连线约束，复杂图形需写脚本生成 DSL 后写入。

未知作者

热度 0.00

最近更新 2026-10-18 15:47:12

分类：创作依赖：代码执行 / 读写文件 / 第三方 API应用场景：模板 / 工作流 / 文件转换 / 图像生成

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add open.feishu.cn/lark-whiteboard

Metadata

name: lark-whiteboard
version: 1.0.0
description: 飞书画板：查询和编辑飞书云文档中的画板。支持导出画板为预览图片、导出原始节点结构、使用多种格式更新画板内容。当用户需要查看画板内容、导出画板图片、编辑画板时使用此 skill。不负责：飞书云文档内容编辑（lark-doc）、文档内嵌电子表格/Base（lark-sheets / lark-base）。
metadata: {"requires":{"bins":["lark-cli"]},"cliHelp":"lark-cli whiteboard --help"}

[!IMPORTANT]

运行 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