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

apps +list

列出当前用户可见的妙搭应用,用于从应用名定位 app_id。运行时命令事实以 lark-cli apps +list --help 为准。

何时用

在下游操作需要 app_id、而用户只给了应用名/描述时,用 --keyword 定位。无明确目的的全量枚举会浪费上下文,优先按关键词缩小范围。

命令骨架

  • 支持 --keyword 按应用名模糊搜索。
  • --ownership 枚举:all / mine / shared(默认 all = 我创建的 + 共享给我的;mine = 仅我创建;shared = 仅共享给我)。
  • --app-type 枚举:html / full_stack
  • 分页:--page-size 默认 20--page-token 传上一页 cursor。

示例

lark-cli apps +list --keyword "审批"
lark-cli apps +list --ownership mine --app-type full_stack
lark-cli apps +list --page-token "<cursor>"

输出契约

  • 成功读取 data.items[];保留字段为 descriptionapp_idnameis_publishedonline_urlupdated_at,用于候选展示的核心字段是 nameapp_idupdated_at
  • is_published=true 只代表应用历史上有发布版本,不代表最新云端会话、最新代码提交或最新 HTML 产物已经部署。
  • online_url 是当前已有发布态入口;若你没有在本轮确认发布完成,不要把它描述成“最新版本链接”。
  • 默认输出已裁掉 icon_url(图片 URLagent 无法渲染)和 created_at(与 updated_at 冗余);需要时可用 --jq 过滤上述保留字段。
  • data.items 可能为空;不要把空列表当失败。
  • 若有 has_more=true,用返回的 page_token / next_page_token 继续翻页。

Agent 规则

多候选时展示名称、app_id、updated_at 让用户确认。用户描述里已经有 app_xxx 或妙搭链接时,直接提取,不再 +list

+list 当定位工具和发布态快照工具,不要把 is_published 当部署完成证明。需要证明“最新内容已上线”时,使用对应发布命令的完成状态:全栈看 +release-getfinishedHTML 看 +html-publish 的成功返回。