- 移除 TodoItem 中的 priority、created_at 和 updated_at 字段 - 强制每个任务都必须有唯一 id,且由用户负责生成 - 修改合并模式逻辑,merge=true 下保留未提及的旧任务 - 支持已完成和已取消任务重新激活(状态改回 pending 或 in_progress) - 禁止 in_progress 状态退回到 pending,必须标记为 completed 或 cancelled - 优化状态转换校验,允许特定状态间合法切换 - 简化任务变更消息,移除详细的新增/更新/移除统计 - 更新文档和示例,明确 id 必须由用户生成和使用 - 修复和补充测试,增强状态转换和合并模式验证 - 调整任务时间戳生成逻辑,统一使用当前时间及索引 - 该变更提供更合理的任务状态机械及管理模式,提升稳定性和易用性
32 lines
1.1 KiB
Markdown
32 lines
1.1 KiB
Markdown
# apps +release-list
|
||
|
||
分页查询妙搭应用发布历史,最新发布在前。运行时命令事实以 `lark-cli apps +release-list --help` 为准。
|
||
|
||
## 何时用
|
||
|
||
用户问"最近发布""历史版本""上次为什么失败",但没有提供 `release_id` 时使用。拿到候选 release 后再接 `+release-get`。
|
||
|
||
## 命令骨架
|
||
|
||
- 必填:`--app-id`。
|
||
- 可选 `--status`:`publishing` / `finished` / `failed`。
|
||
- 可选 `--page-size`:默认 20,最大 500;总是发送给服务端。
|
||
- 可选 `--page-token`:上一页 cursor。
|
||
|
||
## 示例
|
||
|
||
```bash
|
||
lark-cli apps +release-list --app-id app_xxx --page-size 10
|
||
lark-cli apps +release-list --app-id app_xxx --status failed
|
||
```
|
||
|
||
## 输出契约
|
||
|
||
- 成功读取 `data.releases[]`;关键字段是 `release_id`、`status`、`created_at`、`updated_at`。
|
||
- `release_id` 用于继续查 `+release-get`。
|
||
- 若 `has_more=true`,用 `next_page_token` / `page_token` 翻页。
|
||
|
||
## Agent 规则
|
||
|
||
用户限定只看 N 条("最近 N 条""最新 N 个""只要前 N 条")时用 `--page-size N`(如"最近一次发布"→ `--page-size 1`),而不是取全量再本地截断。
|