- 移除 TodoItem 中的 priority、created_at 和 updated_at 字段 - 强制每个任务都必须有唯一 id,且由用户负责生成 - 修改合并模式逻辑,merge=true 下保留未提及的旧任务 - 支持已完成和已取消任务重新激活(状态改回 pending 或 in_progress) - 禁止 in_progress 状态退回到 pending,必须标记为 completed 或 cancelled - 优化状态转换校验,允许特定状态间合法切换 - 简化任务变更消息,移除详细的新增/更新/移除统计 - 更新文档和示例,明确 id 必须由用户生成和使用 - 修复和补充测试,增强状态转换和合并模式验证 - 调整任务时间戳生成逻辑,统一使用当前时间及索引 - 该变更提供更合理的任务状态机械及管理模式,提升稳定性和易用性
2.1 KiB
2.1 KiB
docs +media-download(下载文档素材/画板缩略图)
前置条件: 先阅读
../lark-shared/SKILL.md了解认证、全局参数和安全规则。
下载文档中的图片/文件素材(file_token),或下载画板缩略图(whiteboard_id)。当 --output 不带扩展名时,会根据响应的 Content-Type 自动补全扩展名。
选择规则
- 用户明确说“下载素材”时,使用
docs +media-download - 用户只是想查看、预览图片或文件素材时,优先使用
docs +media-preview - 如果目标明确是画板 / whiteboard / 画板缩略图,继续使用
docs +media-download --type whiteboard;+media-preview不支持画板
命令
# 下载图片/文件素材(默认 type=media)
lark-cli docs +media-download --token "Z1Fjxxxxxxxx" --output ./asset
# 指定输出文件名(带扩展名则不会自动补全)
lark-cli docs +media-download --token "Z1Fjxxxxxxxx" --output ./asset.png
# 下载画板缩略图(whiteboard token)
lark-cli docs +media-download --type whiteboard --token "wbcnxxxxxxxx" --output ./whiteboard
参数
| 参数 | 必填 | 说明 |
|---|---|---|
--token <token> |
是 | 资源 token:素材为 file_token,画板为 whiteboard_id |
--output <path> |
是 | 本地保存路径;不带扩展名会自动补全 |
--type <type> |
否 | media(默认)或 whiteboard |
token 从哪里来
- 若你是从文档内容里提取:
lark-doc-fetch返回的 Markdown 里可能包含:- 图片:
<image token="..." .../> - 文件:
<file token="..." name="..."/> - 画板:
<whiteboard token="..."/>
- 图片:
排障
- 如果报错返回的信息包含
HTTP 403,且目标是图片/文件素材,可以改成调用docs +media-preview看是否能先预览内容
参考
- lark-doc-fetch — 获取文档内容(用于提取 token)
- lark-doc-media-preview — 预览素材
- lark-shared — 认证和全局参数