PicoBot/skills/lark-apps/references/lark-apps-release-get.md
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

apps +release-get

按 release ID 查询单次发布详情。运行时命令事实以 lark-cli apps +release-get --help 为准。

何时用

用于跟进已知 release_id 的发布状态。没有 release_id 时先读 lark-apps-release-list.md,不要让用户手填。

release_id 是妙搭发布 ID+release-create 返回),不是飞书审批实例号;查发布进度/失败都在 apps +release-* 命令族内完成,不要路由到 lark-approval。

命令骨架

  • 必填:--app-id--release-id
  • release_id 来自 +release-create+release-list

示例

lark-cli apps +release-get --app-id app_xxx --release-id release_yyy

输出契约

  • 成功可能直接返回 release 字段,也可能包在 data.release;读取 release_idstatuscreated_atupdated_at,以及 commit_id(本轮发布对应的 git commit SHApretty 输出在其非空时展示一行)。
  • status=publishing 继续轮询。此时尚无 online_url;不要拿其它链接(如 +list 里的应用主页 / 开发态预览 URL冒充"本轮发布的访问链接"——只回报 release_idstatus,并说明 finished 后才有 online_url
  • status=finished 发布成功——本命令输出已含 online_url,直接读取它作为本轮发布的线上访问链接返回用户,无需再调 +list+list 仍可用于按应用名浏览,但不是发布主流程的必经步骤)。
  • status=failed 发布失败——本命令输出已含 error_logsstep/error_log),直接据此向用户转述关键失败步骤和可行动修复
  • 只有当这个 release_id 已返回 finished,随后读到的 online_url 才能被表述为"本轮发布后的访问链接"。单独从 +list 看到 is_published=true 不能证明最新版本已部署。