PicoBot/skills/lark-whiteboard/references/lark-whiteboard-query.md
ooodc a7883dbed9 refactor(todo): 重构待办事项管理逻辑及更新状态规则
- 移除 TodoItem 中的 priority、created_at 和 updated_at 字段
- 强制每个任务都必须有唯一 id,且由用户负责生成
- 修改合并模式逻辑,merge=true 下保留未提及的旧任务
- 支持已完成和已取消任务重新激活(状态改回 pending 或 in_progress)
- 禁止 in_progress 状态退回到 pending,必须标记为 completed 或 cancelled
- 优化状态转换校验,允许特定状态间合法切换
- 简化任务变更消息,移除详细的新增/更新/移除统计
- 更新文档和示例,明确 id 必须由用户生成和使用
- 修复和补充测试,增强状态转换和合并模式验证
- 调整任务时间戳生成逻辑,统一使用当前时间及索引
- 该变更提供更合理的任务状态机械及管理模式,提升稳定性和易用性
2026-06-13 09:22:33 +08:00

2.1 KiB
Raw Blame History

whiteboard +query查询画板

前置条件: 先阅读 ../../lark-shared/SKILL.md 了解认证、全局参数和安全规则。

查询画板内容,支持导出为预览图片、提取 PlantUML/Mermaid 代码,或获取飞书 OpenAPI 原生画板节点格式。

参数

参数 必填 说明
--whiteboard-token 画板 token需要拥有画板的读权限
--output_as 输出格式:image(预览图片)、codePlantUML/Mermaid 代码)、rawOpenAPI 原生画板节点格式)
--output 输出路径。当 --output_as image 时必填;当 --output_as code/raw 时可选,不填则直接输出到终端
--overwrite 覆盖已存在的文件,默认为 false

输出格式

  • image:预览图片
  • codePlantUML/Mermaid 代码。仅限画板内有且仅有一个 PlantUML/Mermaid 图时,才可导出代码,否则会在返回值中告知不存在/有多个节点。
  • raw:飞书 OpenAPI 原生画板节点格式。这一 json 格式不适合直接编辑复杂布局或内容,建议仅限于需要修改简单的文本内容/颜色等细节时使用。需要进行更复杂的设计/修改时,建议参考 § 渲染 & 写入画板

示例

示例 1导出画板为预览图片

lark-cli whiteboard +query \
  --whiteboard-token "wbcnxxxxxxxx" \
  --output_as image \
  --output ./preview.png

示例 2提取画板中的代码并直接输出

lark-cli whiteboard +query \
  --whiteboard-token "wbcnxxxxxxxx" \
  --output_as code

示例 3导出画板原始节点结构到文件

lark-cli whiteboard +query \
  --whiteboard-token "wbcnxxxxxxxx" \
  --output_as raw \
  --output ./nodes.json \
  --overwrite