触发一次验证运行
Full Release Validation 是发布产品验证的总称。大部分工作
发生在子工作流中,因此某个失败的框可以在不重启整个发布的情况下重新运行。在冻结 Code SHA 之前运行发布准备;当后台机器人尚未落地时,它会刷新 Control UI 语言环境输出,然后强制应用发布 CI 使用的相同严格零回退检查。
生成语言环境漂移是分发前的警告,而不是拒绝验证的理由。源 PR 和序列化的语言环境刷新工作流分别落地,因此生成输出可能暂时滞后。将任何预检漂移记录到冻结目标 SHA 上,并继续分发。常规 CI 子工作流仍会运行严格的 control-ui-i18n 和 native-i18n 作业;它们的失败仍会显示在运行摘要中并使验证失败。PR 侧语言环境检查、发布准备和发布要求保持不变。
Linux(ubuntu)、Windows 和 macOS Gateway 跨操作系统全新安装和升级通道在 beta、stable 和 full 配置中门控发布。失败会阻止发布决策、npm 发布和 pnpm release:candidate。在清单和摘要中保留每个通道的实际结论;所选通道需要终结证据。
常规 CI、npm 资格认证、Docker、包验收以及该配置的性能和浸泡要求保持其现有门控。
在将产品完整提交及其目标上下文冻结为 Code SHA/ref 之前,准备完整的历史清单和实质性版本匹配的发布说明。包源预检要求匹配的发布部分;空占位符不算准备。如果说明是最终的,该提交也可以作为 Release SHA。候选 C 拥有资格认证 Q=C;选择独立可信的准入/发布工具 P,然后运行:
PUBLISHER_SHA="<recorded-full-trusted-main-ancestor-sha>"
PUBLICATION_SELECTION='{"route":"normal","npmDistTag":"latest","publishOpenclawNpm":true,"pluginPublishScope":"all-publishable","plugins":[]}'
pnpm ci:full-release \
--sha <code-sha> \
--target-ref release/YYYY.M.PATCH \
--admission-workflow-sha "$PUBLISHER_SHA" \
--admission-workflow-ref main \
--request-file <private-request-file> \
-f validation_purpose=publish \
-f publication_selection_json="$PUBLICATION_SELECTION"
此示例选择常规最终发布。对于 beta,选择 npmDistTag=beta;当预期使用者是 prepared 发布按钮时,选择 route=prepared。核心发布要求 all-publishable 插件。仅插件的常规发布可以设置 publishOpenclawNpm=false、pluginPublishScope=selected,并在 plugins 中指定明确的规范包名称。
每次全新运行都需要显式 validation_purpose。publish 在投影请求的发布选择之前,以及在解析可以放行任何所选生产者之前,验证完整的已提交源元数据。其保留的源准入事实是仅限源,而不是注册表资格、产品测试成功或发布权限。diagnostic、main-qualification 和 postpublish-confidence 省略 publication_selection_json,并将发布源准入记录为不适用。覆盖范围独立选择。
全新发布请求还需要具有注册表准入的工具。源验证后,解析会收集所选包的有界公共 npm 和 ClawHub 观察结果,上传它们,然后绑定不可变工件和准入时间,之后生产者才能启动。必需的读取错误和不受支持的引导状态会阻止准入;最新依赖漂移仅供参考。受支持的首包或信任修复路由保留未解决的下游所有者权限,而不是发布许可。源事实仍仅限源。非发布请求不收集注册表观察结果。
SHA 固定的辅助程序将其语义 -f validation_purpose 和 -f publication_selection_json 参数打包到现有的 trusted_workflow_json 输入中。原始工作流分发使用此封闭信封:{"trustedWorkflow":{"ref":"main","fullRef":"refs/heads/main","sha":"<tooling-sha>"},"validationPurpose":"diagnostic","publicationSelection":null}。对于现有的直接分支路由,trustedWorkflow:null 允许身份所有者推断执行身份;目的始终显式。子工作流仍然只接收已解析的身份元组。现有请求工件重新打开时,不会转换其输入或见证摘要。
pnpm release:candidate 默认使用常规发布路由。对于 prepared 按钮,在其首次分发之前选择 --publication-route prepared;仅提供受保护的工具引用不会选择该路由。保存的状态绑定该选择,并拒绝矛盾的恢复。没有路由的历史状态保留常规恢复语义,并且不获得源准入声明。对于已注册表准入的父级,检查清单读取经过身份验证的保留规划摘要,而不是重复两次本地注册表扫描。准备和发布将该证据与其实际选择的操作数进行比较;常规父级不能通过事后更改命令来授权 prepared 路由。
将 C、Q 和 P 与请求一起记录。Q 默认为 C;对于新的发布请求,显式资格认证 SHA 必须等于 C。P 可以独立推进,但绝不替代 Q 或选择其测试。产品或资格认证修复会创建新的 C/Q。显式 trusted-main 或 protected-tooling 路由仍可用于诊断、主资格认证和发布后置信度,而不是全新的候选拥有的发布证据。
精确冻结目标测试遗漏¶
候选拥有的 Q=C 资格认证拒绝测试遗漏。以下输入仅适用于显式跨修订诊断和保留的历史契约;它们不授权更窄的新发布请求。
在分发之前,使用精确的仓库相对测试路径的 JSON 数组声明有充分理由的窄范围遗漏。plugin_prerelease_node_exclude_patterns_json 适用于 Plugin Prerelease Node 通道,例如 ["src/plugins/manifest-registry.test.ts"]。extension_test_exclude_patterns_json 适用于 Plugin Prerelease 扩展分片,例如 ["extensions/codex/src/app-server/run-attempt.test.ts"]。两者默认为 [];没有隐式的 Codex 测试遗漏。常规 CI 保留其自己的核心通道;Plugin Prerelease 拥有完整的扩展扫描。
将它们通过 SHA 固定的辅助工具传递,格式为 -f name='["exact/path.test.ts"]'。
该辅助工具会将扩展输入打包到现有的可信分发信封中,以保持在 GitHub 的 25 个输入限制之内,并在创建工作流引用或分发之前拒绝不具备匹配 lane-input 能力的工具。
预检会利用所选目标的实际 Vitest 发现机制,拒绝格式错误、重复、不存在以及超出 lane 的路径。Glob 和 basename 均不接受。固定工具会将每个精确排除项应用到执行配置的 inline projects 中,保留候选项的正常测试运行器和 setup,并在命令后恢复原始配置字节。它不依赖冻结候选项支持新的排除环境变量。
不可变请求、覆盖标识、证据复用比较和最终 manifest 都会保留这两个输入值。更改它们需要新的验证请求;继续操作不能扩大现有排除项。在发布证据中记录每个被排除测试的原因和负责修复。排除项是未测试的覆盖,而不是通过证据。
保留并协调根请求¶
对于新分发(包括 --dry-run),辅助工具首先通过在全新临时仓库中执行裸 SHA fetch,证明 GitHub 提供的是精确的 Validation SHA。fetch 失败会在任何请求工件或远程变更之前停止。只有当独立可信的 P 接受冻结请求后,辅助工具才会在 Q=C 时推送一个不可变的 release-ci/* 工作流引用,然后将 C 作为 ref 和 expected_sha 分发。
在创建该工作流引用之前,辅助工具会在 .artifacts/full-release-validation/<request-id>.json 写入一个私有操作员工件,并打印其路径。使用 --request-file <path> 选择工件位置。它保留仓库、工作流、冻结的 target/tooling 标识、工作流传输引用、完整的带类型/默认值输入、有效 soak,以及首次观察到的 run 和 attempt。辅助工具在其单次工作流分发 POST 之前记录尝试意图。
node scripts/full-release-validation-at-sha.mjs \
--reconcile-request .artifacts/full-release-validation/<request-id>.json
现有的 --request-file 也会进入只读协调;冲突的 target、tooling 或 input 参数会被拒绝。显式选择的 --resume-request <file> 只能在其 qualification ref 变更或工作流 POST 之前继续一个已接受的候选请求。它保留原始 tuple,并且从不重复不确定的写入。恢复过程不会执行 ref 创建/删除、分发、重跑、取消、Git fetch 或请求重写。dispatch=observed 报告精确的 run URL 和 attempt,而不是成功验证。较新的 attempt 不能替换保留的 attempt。
在辅助工具停止创建 validation/target-* refs 之前写入的请求仍会记录 targetRef 和 refs.target,当前辅助工具会将它们拒绝为无效。使用辅助工具从移除 target ref 的 merge commit 的父提交协调此类文件,例如从 git worktree add --detach <path> <merge-commit>^。两个版本在协调期间都不会创建或删除 refs。在 GitHub 重跑或证据诊断可能仍需要剩余 release-ci/* 或 validation/target-* ref 时保留它,然后有意删除它。
缺失或有歧义的 run、不完整的分页、不可用或不匹配的输入见证,以及耗尽的发现均保持为 dispatch=unknown。完整的 HTTP 拒绝会保留为 dispatch=rejected;这两种状态都不允许重新分发。保留工件和打印的工作流引用以供调查。本地工件没有自动保留过期或清理;只能通过操作员有意清理来删除它。丢失或删除它永远不能证明未执行。独立请求和其他主机上的副本不会全局去重。
新的候选项拥有的请求在 Q 中需要 FULL_RELEASE_QUALIFICATION_ADMISSION_CONTRACT=1、FULL_RELEASE_SOURCE_ADMISSION_CONTRACT=1 和 FULL_RELEASE_DISPATCH_WITNESS_CONTRACT=1。较旧的冻结工具会在远程创建之前失败,而不是启动无法证明其输入的工作。辅助工具从不升级 Tooling SHA。对于已在运行的冻结验证,使用 frv status;为新的验证选择不同工具需要发布负责人的明确决定。工作流的独立输入见证与 attempt 绑定,并保留七天。它直接读取事件文件,而不将输入插值到 step 环境变量或日志中。仅上传安全的 GitHub context 和 SHA-256 摘要:输入键按字典序排序,原始值规范化为 wire 字符串,然后进行 JSON 序列化。不可变的工作流 SHA 绑定输入类型;完整的带类型和 wire 映射保留在私有本地工件中。Runner 或 artifact-service 故障可能导致见证不可用;它永远不是发布回执或发布授权。
选择覆盖¶
provider 也接受 anthropic 或 minimax,用于跨操作系统 onboarding 和端到端 agent turn。常规 release/* 目标接受分支的最终包版本或匹配的 beta prerelease。对于更正,使用 --target-ref release/YYYY.M.PATCH-N 在打标签之前保留预期的最终 tag。当 vYYYY.M.PATCH 解析到精确的 Code SHA 时,也接受其基础包版本;准备阶段保留包版本,并为 vYYYY.M.PATCH-N 密封 npm 和 Docker 工件。辅助工具将 beta 发布映射到 beta profile,将最终版本映射到 stable。使用 -f key=value 传递替代工作流输入;仅对广泛的 provider sweep 使用 -f release_profile=full。
fail_fast 默认为 false,因此分发的子工作流会完成并一起暴露独立故障。在该模式下,父工作流不会发起子工作流取消调用。仅当更短的首次失败路径更可取时,才传递 -f fail_fast=true;Release Decision 随后只取消拥有阻塞故障的精确仍活动的子工作流。
同一父级继续要求原始 root 已使用 fail_fast=false 分发。控制器在任何重跑变更之前验证该精确记录的输入。
当前运行会为 npm、Docker 和验证候选项分发独立的 Full Release Artifacts 生产者。每个生产者拥有其不可变的分发记录和输出回执。父级重试会恢复这些精确的生产者 ID 和 attempts,重新检查其 source 和 Tooling SHAs,并复用成功的构建。
产生其自身候选项或发布工件的历史父级无法继续:保持两个 SHAs 冻结,并启动一次全新的 all-group 验证。
自动测试重试已禁用。Dispatch 拒绝 known_flaky_jobs_json;
移除该已退役的输入,并调查原始作业失败。诊断后,显式操作员恢复仍可通过
continuation commands 使用。
调度后,父级会写入一个不可变的
full-release-execution-plan-<run-id> 工件,并在精确的 run-ID Actions 缓存中保留相同字节。它记录已选择和必需的覆盖率、门禁结果、复用标识、原始父级尝试、
当准备阶段运行时新的候选请求以及生产者和发布者证据,以及
每个精确的子运行 ID、尝试、标题、workflow ref 和 Tooling SHA。
Decision、Drain、清单生成、证据验证以及最终验证器会针对其当前尝试消费该工件。在原始
受保护上传成功后,sealer 会在其作业日志中记录计划摘要。
Collector 重试会在发布准入之前恢复精确的 run-ID 缓存,
将其字节与该原始上传和摘要进行认证,并为当前尝试重新上传
未更改的计划和准入。GitHub 会在完整重新运行时删除先前的
父级工件,因此请保留缓存和原始作业日志。
如果缓存不可用,可访问的计划工件可以提供相同的
已认证字节。缺失或无效的证据会失败关闭;重试永远不会
重建计划、重新收集注册表观察结果或重新调度测试。
Release Decision 还会在复用的运行通过之前重复规范复用链验证。
密封的目标 SHA、证据 SHA、策略、变更路径集、
所选运行、根运行、源清单、受信任工具身份和子
元组都必须仍然匹配。
在父级重试时,最终验证会独立选择最新可用的 Release Decision 和 Diagnostic Drain 工件。两者都必须绑定相同的 不可变计划和精确子元组;其源尝试仍记录在 工件中,当只有一个 Collector 需要重试时可能不同。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw