用途:当用户要求用飞书画板绘制架构图、流程图、思维导图、时序图或其他可视化图表时,本技能作为使用 whiteboard-cli 设计图表布局的指南。
环境依赖:需要 @larksuite/whiteboard-cli(画板 Node.js CLI 工具)与 lark-cli。安装失败可手动执行 npm install -g @larksuite/whiteboard-cli@^0.2.0;安装新依赖前须征得用户同意。
主要能力:区分 Mermaid 与 DSL 两条渲染路径。思维导图、时序图、类图、饼图默认走 Mermaid;用户输入含 Mermaid 语法时走 Mermaid;其他类型走 DSL。DSL 路径按三步执行:路由并读取知识(scene 指南与 references 核心模块)、生成含颜色的完整 DSL、渲染并审查后交付。提供架构图、组织架构图、泳道图、对比图、鱼骨图、柱状图、折线图、树状图、漏斗图、金字塔图、循环/飞轮图、里程碑、流程图等场景指南。
使用方式:产物放在 ./diagrams/YYYY-MM-DDTHHMMSS/ 目录,含 diagram.json、diagram.gen.js、diagram.png、diagram.mmd。查看图标:npx -y @larksuite/whiteboard-cli@^0.2.0 --icons。渲染:npx -y @larksuite/whiteboard-cli@^0.2.0 -i ./diagrams/2026-03-27T143000/diagram.json -o ./diagrams/2026-03-27T143000/diagram.png。上传飞书画板需飞书认证,先获取画板 Token,再上传;向已存在画板写入前必须先用 --overwrite --dry-run 探测,若提示将删除节点须向用户确认后才可去掉 --dry-run 执行。
限制:画板是无限画布,flex 布局为可选增强;含文字节点 height 须用 fit-content;fill-container 仅在 flex 父容器生效;layout: none 容器须有固定宽高;connector 须放顶层 nodes;flex 容器内 x/y 被忽略;Dagre 子容器默认不透明。渲染后审查最多修复 2 轮,仍有严重问题可走 Mermaid 兜底。画板一经上传不可修改。