跳转至

扩展稳定版与仅变更日志验证

扩展稳定版验证

扩展稳定版验证使用相同的候选者自有辅助程序:确切的源候选者 C 同样拥有资格验证 Q=C。独立受信任的 P 对该请求进行准入并验证。将这些角色与规范发布上下文分开;在冻结 C 之前,刻意回移缺失的资格验证契约。

VALIDATION_SHA="<exact-candidate-sha>"
PUBLISHER_SHA="<recorded-full-trusted-main-ancestor-sha>"
CONTEXT_REF="extended-stable/YYYY.M.33"
pnpm ci:full-release \
  --sha "$VALIDATION_SHA" \
  --target-ref "$CONTEXT_REF" \
  --admission-workflow-sha "$PUBLISHER_SHA" \
  --admission-workflow-ref main \
  -f validation_purpose=publish \
  -f publication_selection_json='{"route":"extended-stable","npmDistTag":"extended-stable","publishOpenclawNpm":true,"pluginPublishScope":"all-publishable","plugins":[]}' \
  -f release_profile=stable \
  -f run_release_soak=true \
  -f fail_fast=false \
  -f rerun_group=all \
  -f reuse_evidence=false \
  -f dispatch_release_evidence=false

在独立准入之后,辅助程序会在 Q=C 处创建 release-ci/<Q-prefix>-<unique-id>,并从该不可变命名分支进行分发。它将确切候选者作为 ref 和 expected_sha 传递,并将规范分支放入 target_context_ref。GitHub 工作流分发的 --ref 接受分支或标签,不接受原始 SHA。发布分支提供上下文,而非资格验证权威。切勿手动创建传输引用,也不要用随 main 变动的机制替代。

共享发布者要求已准入的候选者自有证据、完整的 rerun_group=all 覆盖,以及确切成功的尝试。其受保护的 release-publish/* 引用选择的是 P,而非 Q。发布工具更新不会改变已冻结的候选者或资格验证身份。保留的历史跨修订请求维持其原始恢复契约;新的显式 main/受保护诊断运行不能替代 Q=C 的发布证明。

产品或资格验证机制修复会改变 C/Q,并需要重新进行资格验证。提供者、批准或运行器恢复保留原始身份和输入。不要因为目标较旧而省略必需的包、安装程序、更新、渠道或实际运行行为。

对于常规发布,如果已通过资格验证的 Code SHA 已包含最终发布说明,请使用同一提交作为 Release SHA。保留其成功的完整验证父提交以及准确准备好的发布制品;无需仅为了区分这些角色而额外提交或运行验证。

如果在资格验证后发布说明发生变化,请将选定的发布条目及其允许的记录/索引更新作为新的 Release SHA 提交,并为该提交运行相同的辅助程序。产品证据复用是可选的,且需要 GitHub 证明 Release SHA 派生自 green Code SHA。完整变更路径集必须包含 CHANGELOG/YYYY.M.PATCH.md,并且只能额外包含 CHANGELOG.md 和 CHANGELOG/records/YYYY.M.PATCH.md。允许添加或修改条目/记录;根索引只能被修改。重命名、删除、其他发布文件以及文档源编辑均不符合条件。此路径记录 split-changelog-release-v1;历史的仅根目录收据保留其 changelog-only-release-v1 契约。复用仍会使变更的包和镜像字节通过资格验证。任何其他源代码变更都回到完整 Code 验证。发布顺序请参阅 发布。

概念阶段与当前输入的对应关系如下:

  • beta-publish:release_profile=beta,run_release_soak=false
  • postpublish-confidence:validation_purpose=postpublish-confidence,不选择发布,使用确切已发布的包并加上 run_release_soak=true 或显式聚焦组
  • stable-publish:release_profile=stable

对于匹配的规范发布分支或 beta 标签上的实际 beta 包,使用 release_profile=beta 且不进行 soak 的 all 会记录 coveragePolicy=npm-beta-v1。它保留 Linux、macOS 和 Windows Node 检查、Control UI、插件、包完整性、安装/更新验收、Linux/Windows/macOS 跨操作系统包检查、QA 对等性、核心运行时配对/重启证明以及运行时工具覆盖。原生应用资格验证、产品性能检查以及已发布包的 Telegram 置信度检查会被延迟。广泛的 live/E2E 和 QA-live 也仍在该受限门禁之外。

使用 run_release_soak=true 针对确切已发布的 beta 包运行延后的置信度检查,或显式选择 ci、performance、npm-telegram、package 或相关的 QA/live 组。所选的子任务仍必须完成并通过其现有策略;延后的检查不会运行,也绝不会通过。稳定、完整、启用 soak 以及聚焦验证保留其现有的置信度覆盖。main 和非 beta 目标不符合 npm-beta-v1 的条件。

对于匹配发布分支或标签上的常规最终包,使用 release_profile=stable 的 all 会记录 coveragePolicy=npm-stable-v1,并使用 CI 的 npm-stable 范围。数字修订符合条件,包括基线标签解析到相同源 SHA 的未更改基础包。此策略仅延迟 macOS Swift/OpenClawKit、iOS/Watch、Android 和原生 i18n。Linux、macOS 和 Windows Node 覆盖、Control UI、插件、包和安装程序验收、QA、稳定 soak 以及阻塞性产品性能检查仍然必需。扩展稳定版、无发布上下文的 main、full 以及显式 ci 运行保留完整 CI。证据复用要求相同的覆盖策略、确切的包版本、目标上下文和有效输入;beta 或历史完整收据不能静默替代稳定 npm 资格验证。

原生发布流程负责延迟的资格验证。对于 npm-stable 发布,OpenClaw Release Publish 会启动一次启用 Android 的精确来源完整 CI 运行,与核心发布并行。只有原生资格验证和核心发布均成功后,独立的 Android 任务才能签发 v3 批准收据并调度由标签拥有的 APK 发布者。该收据绑定确切的原生 CI 运行、尝试和工具引用。发布者在写入批准之前、就在调度之前、APK 认证之前以及每次资产上传之前都会重新检查该证明。没有 v3 消费者的已冻结标签,包括 v2026.8.2 及其同源修正,必须使用 release_profile=full;发布流程会在启动核心发布之前拒绝这些目标的仅 npm 证据。它们的历史完整验证路线保留 v2 批准契约。原生失败会被记录并阻塞 Android 批准,而核心 npm 发布和 GitHub 发布最终化保持独立。核心发布完成后,父工作流可保持活动状态以进行原生工作。macOS 保留其独立的原生验证、签名、公证和晋升门禁。稳定的 npm 发布仍会拒绝缺少 soak 和阻塞性产品性能检查的证据。

macOS 应用签名、公证、appcast 发布以及 Windows Hub 资产推广与 npm 发布并行或在 npm 发布之后运行,且绝不会延迟 npm。它们自身的工件验证和推广门禁仍然适用;在常规 GitHub 发布离开草稿状态之前,Windows Hub 资产仍然是必需的。

Package Acceptance 通常根据已解析的 ref 构建候选 tarball,包括使用 pnpm ci:full-release 派发的 full-SHA 运行。在 beta 发布后,传入 release_package_spec=openclaw@YYYY.M.PATCH-beta.N 以在发布检查、Package Acceptance、跨操作系统、发布路径 Docker 和包 Telegram 中复用已发布的 npm 包。仅在 Package Acceptance 需要有意验证不同包时使用 package_acceptance_package_spec。

Codex 插件 live package 通道遵循相同状态:已发布的 release_package_spec 值派生 codex_plugin_spec=npm:@openclaw/codex@<version>;SHA/工件运行从所选 ref 打包 extensions/codex;操作员也可以直接为 npm:、npm-pack: 或 git: 插件源设置 codex_plugin_spec。该通道授予该插件所需的显式 Codex CLI 安装批准,然后运行 Codex CLI preflight 和同一会话内的 OpenAI agent 轮次。其最后一次零重试、medium-thinking 轮次会发送可见进度但不包含 Codex final,读取随机化的工作区输入,写入其确切工件,并发送显式完成信号。这捕获了 v2026.7.1 的回归,在该回归中,一次普通的进度发送会终止该轮次。

选定的源码 Telegram QA 和独立 npm Telegram 测试必须先通过,常规发布验证才能通过。选定的 Package Acceptance Telegram 也必须在每个 profile 中通过。凭据缺失、池耗尽和失败尝试均不视为成功证明。精确的候选身份、凭据隔离和租约清理仍然是必需的。

对于每个不带 soak 的 beta-profile all 运行(包括对 main 的 beta-profile 检查),Package Acceptance Telegram E2E 都会自动推迟。有效的 skip_package_telegram_e2e=true 会被记录在 inputs 和 summary 中,状态为 not run。启用 soak 的运行以及显式的 rerun_group=package 会默认保持 Telegram 选中。现有的 -f skip_package_telegram_e2e=true 输入仍可用于显式推迟 beta;它会在 stable 和 full 下被拒绝,并且不会禁用聚焦的 rerun_group=npm-telegram 工作流。

选定测试要求与显式省略相互独立。经过评审的仅 Telegram 例外是 2026.8.1-owner-approved 和 2026.9.1-owner-approved。经过评审的 Telegram 与 Matrix QA-live 例外是 2026.9.5-owner-approved、2026.9.7-owner-approved、2026.9.8-owner-approved 和 2026.9.9-owner-approved。通过 -f telegram_waiver=<value> 传入所选值。 任何未来的例外都需要经过评审的代码变更;仅凭匹配的 <target-version>-owner-approved 字符串并不构成授权。该值必须指定已验证目标的实际 package.json 版本,封存的候选版本必须与之匹配,并且 profile 必须是 stable 或 full。Beta、预发布(prerelease)和未列出的目标会被拒绝。 Package-spec 覆盖必须恰好为 openclaw@<target-version>;空白 spec 会选中封存候选版本。 它会省略源码 Telegram QA、Package Acceptance Telegram E2E 和已发布包 Telegram E2E;其证据状态为 waived / not run,而不是 passed。Telegram 单元测试和所有其他选定的门禁仍然有效,包括 stable soak 和性能检查。显式的 Telegram 重跑或套件过滤器(包括诸如选择 Telegram 的聚合项 qa-live 或 qa-live-non-slack)与豁免冲突,会被拒绝。声明和目标版本绑定不可变的执行计划、manifest 和复用身份;发布者会将豁免带入发布验证说明中。上述仅限 beta 的包推迟规则保持不变。

源码 Telegram QA 使用发布检查的共享上下文检查:精确的候选 SHA 必须保持为其规范分支的祖先,或等于其发布标签。构建准入和执行准入都会独立重复该检查,并保留候选版本、签名/合并归属和实时维护者检查。推进发布分支不会选择新的候选版本,也不会使旧候选版本失效。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw