版本化运行时发布¶
状态:已通过合并的 #137 实现;v0.1.0 已发布。 作者:@n3wth。日期:2026-10-24。
相关 issue:#124(已完成)。实现:#137,使用了已合并的 #136。
问题与范围¶
用户需要从经过审查的提交构建出可识别的归档文件。准备一个包含来源身份和校验和的草稿发布,然后在发布之前验证其确切工件。
复用 运行时打包设计。不要自动创建标签、自动发布、在 CI 中运行付费模型,或添加主机支持。
版本与工件契约¶
以根插件版本作为规范。要求 Claude 和 Codex 的 manifest 版本匹配。接受不带前导零的 vMAJOR.MINOR.PATCH 标签。绝不为已变更的工件复用已发布的版本。
已实现的 scripts/prepare_release.py 接受 --tag、--commit 和 --output。需要完整的源 SHA 和新的输出目录。生成:
egm-claude-VERSION.zipegm-openai-VERSION.zipSHA256SUMSRELEASE_NOTES.md,其中包含源 SHA、标签和验证限制
本地调用会验证提供的值并构建归档文件。它不证明 Git 祖先关系,也不运行测试。这些检查由工作流负责。本地源 SHA 是调用者的声明,而非经过验证的来源身份。请在生成的说明中标注该限制。发布使用在来源验证和确切工件检查之后由工作流构建的候选版本。
工作流与权限¶
从 main 手动调度工作流,并带上现有的版本标签。将标签解析为提交,并要求该提交是 main 的祖先。检出该提交,运行离线测试,并准备其归档文件。
构建任务具有 contents: read、id-token: write 和 attestations: write。构建完成后,使用固定到特定提交的 actions/attest 为两个运行时 ZIP 签署来源证明,并将其存储在 GitHub 中。禁用注册表存储记录;不需要注册表或工件元数据权限。证明失败会停止构建。本地准备不会创建证明。
该来源证明标识了从 main 调度的工作流。其来源身份可能与任务期间检出的所选标签不同。发布说明记录带标签的源 SHA。发布前请审查这两个身份。证明确立的是工件来源,而非主机兼容性或代码安全性。验证必须识别 refs/heads/main 上的签名工作流,以及所下载 ZIP 的摘要。将记录的标签 SHA 与构建任务解析出的标签进行比较。仅凭工作流身份并不能验证该标签映射。
一个独立的草稿任务接收工件,验证其校验和,重新检查标签身份,并以 contents-write 权限创建草稿。重复创建发布会失败,且不会替换现有资源。两个任务都不会创建标签或发布版本。
验收与发布流程¶
- 设计和实现 #136/#137 已合并,且 #124 已完成。
- 第一个已发布的版本是 v0.1.0。
- 将 #60 中的确切工件主机验证保持打开,以覆盖其余主机。
- 选择经过审查的版本和提交。在维护者创建标签之前,重新生成打包内容并验证所有包含的运行时更改。
- 调度工作流。检查两个归档文件、校验和及来源身份。使用
gh attestation verify FILE --repo google/elephant-goldfish-model验证每个 ZIP。要求来自main的签名工作流.github/workflows/release.yml。 - 使用这些确切工件,为每个声明支持的主机完成 #60 中的确切包验证流程。记录已安装文件身份、主机/模型版本、日期,以及单独的安装、工作流和隔离结果。完成需要干净安装、预期的工件身份,以及受支持的工作流和隔离结果。保留任何部分主机结果。
- 审查最终发布说明并手动发布。目录审批仍独立于版本发布。
测试版本不匹配、格式错误的标签和来源 ID、归档内容、校验和、拒绝覆盖以及生成内容的新鲜度。在将发布准备视为完成之前,对工作流运行 lint 并验证其首次真实调度。
仅在对适用性作出明确说明时,才可复用历史主机证据。不要将旧的候选结果呈现为新的工件通过。在 #105 和 #106 仍存在证据缺口期间,云支持保持部分状态。
失败处理与备选方案¶
让失败或未经验证的候选版本保持未发布状态。构建重试使用全新的本地输出目录。不要替换已发布的归档文件或移动其标签;而是准备一个更正版本。
手工构建的发布可能省略验证或来源身份。自动发布会移除最终的证据审查。经过验证的草稿保留了该审查,同时不重复包构建器。
本草稿不构成维护者批准,也不声称进行了 EGM 设计评审运行。在发布工作流验证完成之前,该 issue 保持打开状态。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 el/elephant-goldfish-model