用途:为当前分支关联的 PR 提供端到端的 snapshot 发布编排。主要能力:在没有 /snapshot 评论时(经用户确认)发布一条;等待 Continuous Releases 工作流结束;从生成的“📦 Snapshot Release”PR 评论中提取并报告 tarball 地址。支持启动新的快照,或接续已在运行、已完成的快照。
使用方式:分两个 Bash 调用执行。第一步 discover,用 gh pr view 获取 PR 编号、URL 和 /snapshot 评论锚点,并检查本地 git 状态;若存在锚点则走快速路径,否则进入第二步确认触发;第三步 orchestrate,条件性执行 git push(仅当用户选择先推送)与 gh pr comment 发布 /snapshot,轮询查找匹配的 Continuous Releases 运行,用 gh run watch 等待完成,并输出最新的快照发布评论。成功时展示该评论并附安装提示 bun add https://pkg.pr.new/@seed-design/<package>@<sha>;失败时列出失败步骤。
适用场景:GitHub 上的 PR 快照发布、验证构建产物、获取可安装的 tarball 链接。
限制:评论正文必须恰好为 /snapshot,不能有多余空格或文字,否则不会触发工作流。快照由 GitHub Actions 基于 PR 远端 HEAD 构建,未提交或未推送的改动不会出现在 tarball 中,确认步骤会提示这一点。工作流运行在默认分支上下文,不能用 --branch 过滤,需按工作流文件、锚点时间和 issue_comment 事件匹配。涉及多个 PR 或指向其他 PR 时需显式提供 PR 编号;同一 SHA 重复触发时使用最近一次运行与最新评论。该流程可重入,若第三步中断,重新调用即可通过快速路径接续,无需清理。长时等待建议以后台方式运行,不要轮询。