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

1.9 KiB

Raw Blame History

drive +version-history

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

列出指定文件的历史版本快照。该 shortcut 同时支持 --as user 和 --as bot；自动化场景推荐使用 --as bot。

命令

lark-cli drive +version-history \
  --file-token boxcnxxxxxxxx \
  --as bot

lark-cli drive +version-history \
  --file-token boxcnxxxxxxxx \
  --as user

lark-cli drive +version-history \
  --file-token boxcnxxxxxxxx \
  --limit 50 \
  --cursor 1777013761763 \
  --as bot

lark-cli drive +version-history \
  --file-token boxcnxxxxxxxx \
  --dry-run \
  --as bot

参数

参数	必填	说明
`--file-token`	是	目标文件 token
`--limit`	否	返回条数上限，范围 `1-200`，默认 `20`
`--cursor`	否	分页游标；取上一页返回的 `next_cursor` 回填

关键行为

shortcut 内部固定传 only_tag=true
返回 has_more=true 时，使用 next_cursor 继续翻页
versions[].version 是传给 drive +version-get / +version-revert / +version-delete 的长数字版本串；tag 只是展示序号，不能替代 version
versions[].is_deleted 为布尔值，表示该历史版本是否已被删除

返回值

{
  "ok": true,
  "identity": "bot",
  "data": {
    "versions": [
      {
        "version": "7633658129540910621",
        "name": "report.md",
        "edited_at": "1777013761763",
        "edited_by": "ou_xxx",
        "size_bytes": "12345",
        "action_type": "upload",
        "is_deleted": false,
        "tag": 7
      }
    ],
    "has_more": true,
    "next_cursor": "1777013761763"
  }
}

参考

lark-drive -- 云空间（云盘/云存储）全部命令
lark-shared -- 认证和全局参数

1.9 KiB Raw Blame History

drive +version-history

命令

参数

关键行为

返回值

参考

1.9 KiB

Raw Blame History