版本化发布¶
规范版本是 plugin.json 中的 version。每个声明 EGM 版本的宿主清单都必须与之匹配,包括实验性适配器(如存在时的 Cursor)。没有版本字段的 Marketplace 目录则不需要。版本同步并不会将宿主纳入发布支持范围;其他宿主适配器仍需要显式的打包和验证。
在 EGM 进入 1.0 之前,兼容性修复使用补丁号递增,功能或不兼容的工作流变更使用次版本号递增。在发布说明中解释破坏性变更。版本 1.0 需要为技能名称、参数、输出路径和报告格式提供稳定契约。不要在同一标签下更改已发布的工件。
准备候选版本¶
- 在經過審查的 PR 中,将
plugin.json和每个宿主清单(.claude-plugin/plugin.json、.codex-plugin/plugin.json、.cursor-plugin/plugin.json和.plugin/plugin.json)更新为相同版本。当其中任何一个不一致时,scripts/prepare_release.py会拒绝该标签。 - 运行
pytest tests/unit。在 PR 中包含任何迁移说明。 - 合并后,维护者在选定的 main 提交上创建并推送一个带注释的
vMAJOR.MINOR.PATCH标签。切勿移动现有发布标签。 - 从
main运行 Prepare draft release,提供该现有标签。带标签的提交必须包含发布脚本并通过单元测试。 - 审阅草稿的两个运行时 ZIP、
SHA256SUMS、出处捆绑包(egm-vMAJOR.MINOR.PATCH.intoto.jsonl)和源提交。按下文所述验证两个 ZIP 的证明。将占位说明替换为变更、兼容性/迁移详情以及确切的工件宿主验证证据。未经验证的宿主仍保持未验证状态。 - 仅在审阅后手动发布草稿。目录发布是单独的流程。
该工作流不会创建标签、覆盖发布、自动发布或运行付费的实时测试。重复的发布尝试会失败,而不是替换现有发布。在创建新的候选版本之前,先修复失败的构建。对于本地准备,请使用全新的输出目录:
python scripts/prepare_release.py --tag v0.1.0 --commit "$(git rev-parse HEAD)" --output /tmp/egm-0.1.0-candidate
本地命令会检查清单版本并构建工件。它不会验证调用者提供的源 SHA、Git 标签祖先或测试。这些检查属于工作流。在完成精确工件检查后,仅发布由工作流构建的候选版本。本地构建仍为诊断性候选。精确的已安装捆绑包验证仍在 #60 中跟踪。
验证下载¶
将两个 ZIP、SHA256SUMS 和出处捆绑包下载到同一个目录中。安装 GitHub CLI 后,在该目录中运行以下命令:
sha256sum -c SHA256SUMS
for archive in egm-claude-*.zip egm-openai-*.zip; do
gh attestation verify "$archive" --repo google/elephant-goldfish-model \
--signer-workflow google/elephant-goldfish-model/.github/workflows/release.yml \
--source-ref refs/heads/main || exit 1
done
该工作流在创建草稿之前对两个 ZIP 摘要进行签名,并将出处存储在 GitHub 中。相同的证明作为 egm-<tag>.intoto.jsonl 附加到发布中。它不列在 SHA256SUMS 中。要对照下载的捆绑包验证 ZIP,请使用 --bundle 传递它:
gh attestation verify egm-claude-0.1.2.zip --repo google/elephant-goldfish-model \
--bundle egm-v0.1.2.intoto.jsonl
添加与上述相同的 --signer-workflow 和 --source-ref 标志。
签名失败会阻止草稿创建。本地准备不会创建证明。构建作业使用 id-token: write 请求签名证书,并使用 attestations: write 存储结果。它无法写入发布。
出处标识来自 main 的工作流运行。该运行期间检出的带标签源可以是不同的提交。请查看发布说明中的源 SHA,并在发布前检查工作流运行。证明并不确立宿主支持,也不证明代码是安全的。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 el/elephant-goldfish-model