SuperAPI AI 工具集

lark-whiteboard-cli

设计与创作

查看项目

更新于 10-16 09:28

技能介绍

用途:当用户要求用飞书画板绘制架构图、流程图、思维导图、时序图或其他可视化图表时,该技能作为使用 whiteboard-cli 设计图表布局的指南。

环境依赖:绘制画板需要 @larksuite/whiteboard-cli(画板 Node.js CLI 工具)和 lark-cli(LarkSuite CLI 工具)。失败时可手动安装:npm install -g @larksuite/whiteboard-cli@^0.2.0。执行 npm install 安装新依赖前务必征得用户同意。

主要能力与流程:先做路由判断渲染路径(Mermaid 还是 DSL),再读取对应场景指南与核心参考模块(语法、布局、配色、排版、连线),生成完整 DSL(含颜色),渲染并审查,最后交付。思维导图、时序图、类图、饼图默认走 Mermaid;用户输入含 Mermaid 语法也走 Mermaid;其他类型走 DSL。部分图形(鱼骨、飞轮、柱状、折线等)需按场景指南写 .js 脚本生成 JSON,产物目录按 ./diagrams/YYYY-MM-DDTHHMMSS/ 创建。

常用命令:查看图标 npx -y @larksuite/whiteboard-cli@^0.2.0 --icons;渲染 npx -y @larksuite/whiteboard-cli@^0.2.0 -i <输入> -o <输出>。上传飞书画板需飞书认证,上传前必须加 --overwrite --dry-run 探测,若日志提示将删除节点,须先向用户确认覆盖。

限制:画板是无限画布而非网页;含文字节点 height 须用 'fit-content';connector 须放顶层 nodes;flex 容器内 x/y 被忽略;layout: 'none' 容器须固定宽高;Dagre 子容器默认不透明。渲染后最多修复 2 轮,仍有严重问题可走 Mermaid 兜底。收费、价格等细节暂未提供。