用途:用于查询和编辑飞书云文档中的画板,并支持将结构化信息(架构、流程、组织关系、时间线、因果、对比等)可视化表达。使用前需先用 Read 工具读取 ../lark-shared/SKILL.md,其中包含认证与权限处理。
核心概念:画板 token 是画板唯一标识,可从云文档 docs +fetch 结果中的 <whiteboard token="xxx"/> 标签获取,或从 docs +update 新建画板后的 data.board_tokens 字段中获取。
主要能力:提供两个 shortcut。+query 查询画板,可导出为预览图片、代码或原始节点结构;+update 更新画板内容,支持 PlantUML、Mermaid 或 OpenAPI 原生格式输入。
常见用法:查看内容或导出图片用 +query --output_as image;获取 PlantUML/Mermaid 代码或检查是否由代码块组成用 +query --output_as code;修改节点颜色或文字先用 +query --output_as raw 再 +update;用 PlantUML 绘制用 +update --input_format plantuml;用 Mermaid 绘制用 +update --input_format mermaid;绘制复杂图表用 +update --input_format raw,需使用 whiteboard-cli 工具(参见 lark-whiteboard-cli)。
与 lark-doc 配合:从文档获取画板 token 时,先用 lark-doc 的 +fetch 获取内容,解析 <whiteboard token="xxx"/> 标签。新建画板并编辑时,用 lark-doc 的 +update 传入 <whiteboard type="blank"></whiteboard>(不要转义),从响应 data.board_tokens 获取 token 列表,再逐个用 +update 编辑,确保每个画板都有实际内容。
图表语法参考:架构图、流程图、组织架构图、里程碑/时间线、鱼骨图、对比图、飞轮图、金字塔图、柱状图、折线图、树状图、漏斗图、泳道图推荐 whiteboard-cli DSL;思维导图、饼图、时序图、类图推荐 Mermaid。详细参考指南见 lark-whiteboard-cli/scenes/ 下对应文件。
限制:资料未提供收费、价格、平台支持范围等信息。具体命令参数与完整节点结构以官方文档为准。