Starlight_Lancher/.claude/skills/lark-apps/references/lark-apps-release-get.md

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_id、status、created_at、updated_at，以及 commit_id（本轮发布对应的 git commit SHA，pretty 输出在其非空时展示一行）。
• status=publishing 继续轮询。此时尚无 online_url；不要拿其它链接（如 +list 里的应用主页 / 开发态预览 URL）冒充"本轮发布的访问链接"——只回报 release_id、status，并说明 finished 后才可能有 online_url。
• status=finished 发布成功——若输出含 online_url，直接读取它作为本轮发布的线上访问链接；未返回时只报告发布完成，不要编造链接。该链接默认仅创建者可见，交付他人前先告知当前仅本人可见、按需用 +access-scope-set 放开可见范围。无需再调 +list（+list 仍可用于按应用名浏览，但不是发布主流程的必经步骤）。
• status=failed 发布失败——若输出含 error_logs（step/error_log），据此向用户转述关键失败步骤和可行动修复；未返回时不要编造失败原因。
• 只有当这个 release_id 已返回 finished，随后读到的 online_url 才能被表述为"本轮发布后的访问链接"。单独从 +list 看到 is_published=true 不能证明最新版本已部署。