ooodc
a7883dbed9
- 移除 TodoItem 中的 priority、created_at 和 updated_at 字段 - 强制每个任务都必须有唯一 id，且由用户负责生成 - 修改合并模式逻辑，merge=true 下保留未提及的旧任务 - 支持已完成和已取消任务重新激活（状态改回 pending 或 in_progress） - 禁止 in_progress 状态退回到 pending，必须标记为 completed 或 cancelled - 优化状态转换校验，允许特定状态间合法切换 - 简化任务变更消息，移除详细的新增/更新/移除统计 - 更新文档和示例，明确 id 必须由用户生成和使用 - 修复和补充测试，增强状态转换和合并模式验证 - 调整任务时间戳生成逻辑，统一使用当前时间及索引 - 该变更提供更合理的任务状态机械及管理模式，提升稳定性和易用性
74 lines
1.9 KiB
Markdown
74 lines
1.9 KiB
Markdown
# drive +version-history
|
|
|
|
> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
|
|
|
|
列出指定文件的历史版本快照。该 shortcut 同时支持 `--as user` 和 `--as bot`；自动化场景推荐使用 `--as bot`。
|
|
|
|
## 命令
|
|
|
|
```bash
|
|
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` 为布尔值，表示该历史版本是否已被删除
|
|
|
|
## 返回值
|
|
|
|
```json
|
|
{
|
|
"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](../SKILL.md) -- 云空间（云盘/云存储）全部命令
|
|
- [lark-shared](../../lark-shared/SKILL.md) -- 认证和全局参数
|