完整发布验证
完整发布验证伞形工作流、发布流程和 Docker 发布调度。属于发布验证工作流索引的一部分。
移动商店发布¶
iOS Store Release(ios-store-release.yml)和 Android Store Release(android-store-release.yml)是独立的手动工作流。选择 main 并点击运行工作流,使用默认参数即可;无需提供发布参数。iOS 工作流还提供 screenshots 操作,用于仅捕获截图而不上传。各平台会排队自身的运行,不会取消正在进行的上传。
这些工作流运行与从干净、最新的本地 main 检出中可用的相同命令:pnpm ios:release:upload 和 pnpm android:release:upload。两者都会冻结源提交,使用仓库版本和当前应用商店状态规划发布,生成平台发布说明,然后构建、签名并上传。请在本地设置 OPENAI_API_KEY;Actions 会读取同名仓库密钥。平台设置、签名和应用商店凭据记录在各个应用的 fastlane/SETUP.md 中。
发布准备工作保持在受跟踪源文件之外,不会创建任何提交或拉取请求。成功上传的记录指向 refs/openclaw/mobile-releases/ 下的原始源 SHA。Actions 会将平台规划、release-notes.json 和可用的已签名二进制文件保留 30 天。失败后、开始另一次上传之前,请检查这些产物和应用商店状态。App Review 提审和 Android 生产发布仍为手动操作。
要预览发布说明而无需构建或上传,请使用保存的平台规划和新的输出路径:
pnpm mobile:release:notes -- generate --platform ios --plan /path/to/ios-plan.json --output /path/to/preview-notes.json
使用 --platform android 和 android-plan.json 生成手机和 Wear 的发布说明。该规划标识目标版本/构建、确切的源 SHA 和公共基线构建。对于历史候选版本,请添加与该规划匹配的 --source-sha <full-commit-sha>;该提交必须存在于本地。现有输出会经过验证并在不调用模型的情况下直接复用。要评估不同的草稿,请使用新的输出文件。
生成过程使用 OpenAI Responses API,具备结构化输出、源证据提取和独立的事实审查。它涵盖应用及捆绑的共享代码,包括 Play 特定来源和 Watch RTC。草稿必须符合应用商店的字符限制,生成或审查失败将中止上传。模型仍可能遗漏或误解某项变更;在手动公开推广之前,请检查运行摘要中保存的发布说明。发布说明的可复现性依赖于保留产物,而非期望新的模型请求返回完全相同的文字。
完整发布验证¶
Full Release Validation 是手动发布的伞形工作流。每次运行都会绑定一个确切的元组:候选版本 C、资格验证 Q 和准入/发布 P,并在派发子工作流之前拒绝 expected_sha 不匹配。全新发布使用 Q=C;P 被独立信任,不能提供替代测试。验证 SHA 映射到用于产品验证的 Code SHA,或用于仅变更日志验证的 Release SHA;它不是第三个发布身份。Beta 发布映射到 release_profile=beta,并带有 run_release_soak=false。常规稳定版发布使用 release_profile=stable。
有关阶段矩阵、确切的工作流作业名称、配置文件差异、npm-beta-v1 和 npm-stable-v1 覆盖策略、产物以及聚焦重跑句柄,请参阅完整发布验证。
normal_ci 子工作流使用确切的目标和发布范围派发 ci.yml,不包含 release_gate。每个选定的失败仍然会阻塞,包括 Windows Node 失败。
完整活动(rerun_group=all)保留 QA Smoke 的完整场景配置文件和 Control UI 性能,与变更路径无关。Docker seed 在普通手动/发布范围内运行全部五条泳道:cron-mcp-cleanup、mcp-channels、mcp-code-mode-gateway、published-upgrade-survivor 和 update-channel-switch。这包括 npm-beta 和 npm-stable 资格验证。survivor 使用带 auto-auth 的 legacy-operator-state,因此已发布的驱动必须能够更新正在运行的受管 Gateway。每个被准入的标准 main 运行都保留这一确切组合。冻结目标在其声明的场景目录支持 legacy-operator-state 时保留该组合;历史目标保留带 auto-auth 的 base。缺失的历史目录保留该回退;格式错误或无效的目录会导致失败。PR 将完整的 survivor 延后到每小时 main 和 Full Release Validation 中执行,而其他 Docker seed 泳道和 QA Smoke 保留其所有者映射。
普通手动 CI 构建完整的声明完备包。Full Release Validation 的 Docker seed 子工作流在未配置发布 runner 组时使用 16 类 Blacksmith runner,并使用现有 smoke 包而不移除覆盖范围。托管故障覆盖和重试保留其恢复路径,加权泳道准入保持串行。Main 和选定的 PR(包括精确头部 release_gate 回退)使用现有的 ciArtifacts 配置文件和带 --skip-build 的标准 packer,保留运行时、公共 SDK 声明以及不变的 tarball 完整性检查。每小时受保护的缓存预热器也保留完整的声明生成。托管手动 CI 将 QA Smoke 拆分为六个部分;普通混合首次尝试使用四个部分,覆盖范围相同。
对于支持测试运行时选择的目标,normal_ci 保留完整的 Node 测试清单,并在 Bun 上运行每个被准入的 Bun 兼容选择。两个结果都是必需的;它们共享现有作业,并在每个 worker 槽位内按顺序执行。不具备此能力的旧目标保留仅 Node 测试。当目标的运行时负责人将其准入时,这包括在两个运行时上的完整 Control UI 选择,包括保留断言。旧目标保留 UI 的 Node 通过结果,以及其运行时负责人准入的 Bun 选择。
Package Acceptance 单独保留扩展后的已发布升级场景:当前未发布候选包含原生操作符状态,稳定/完整配置会强制运行 reported-issues 浸泡测试。其常规幸存者重启模式和独立的 update-restart-auth 基础场景并不能取代确切的 Docker seed 组合。Full Release Artifacts 和 Full Release Candidate 准备不可变的包/镜像输入;候选阶段发布检查消费这些输入,而不会转移或削弱该覆盖范围。
现有的冻结目标契约仍然适用:Docker seed 要求其声明的能力,未带 Docker 层级选择器的目标保留幸存者回退。QA Smoke 要求受支持的测试载体,历史性能检查保留其可用性处理。定向重跑会选择所请求的组,已验证证据复用可以复用已完成的证明。其余自动所有者路径之外的回归,或五个仅发布版 Docker seed 通道中的回归,可能首先出现在手动/发布层级中。
live/E2E 选定引用验证器通过稀疏检出获取完整的提交和引用历史。祖先链和发布引用检查保持不变,历史文件内容不会进入此仅元数据任务。构建和测试任务检出各自的完整源码树。
OpenClaw Release Publish 是手动变更发布工作流。在发布标签已存在、且 OpenClaw npm 预检(其检查项包括 pnpm plugins:sync:check)已成功后,从冻结的 Tooling SHA 上受保护的轻量级 release-publish/<tooling-sha12>-<epoch> 标签派发常规 beta 和稳定版发布。该标签仍然选择确切的发布提交,包括 release/YYYY.M.PATCH 上的提交。对于当前验证运行,将 preflight_run_id 和 full_release_validation_run_id 设置为同一个成功的 Full Release Validation 运行 ID,并固定 full_release_validation_run_attempt。发布者从该验证清单密封的 publicationArtifacts.npmPreflight 描述符中解析独立的 Full Release Artifacts 生产者。仅生产者 ID 本身并不具备 Full Release Validation 授权。
Docker Release 在源身份和镜像准备成功(或提供了已准备的工件)之后,在单独的任务中请求 docker-release 环境审批。审批等待保持在 docker-release-publish 之外;只有获得批准的发布者进入该全局注册表/别名锁。然后它会在写入之前重新验证不可变的源、已准备的工件、证明和别名状态。Docker Hub 凭据仍然是调用方必须提供的机密。准备失败、审批被拒和取消均无法发布。
历史恢复仍可在匹配的 Full Release Validation 成功运行及尝试之外,额外提供独立的成功 OpenClaw NPM Release 预检运行 ID。使用发布命令创建工具链标签;在子任务派发之前,从 main 进行的真实核心 npm、插件 npm 或 ClawHub 发布会被拒绝。仅 Docker 恢复仍可使用 main。
发布者为所有可发布的插件包派发 Plugin NPM Release,为同一发布 SHA 派发 Plugin ClawHub Release,然后在插件 npm 成功之后派发 OpenClaw NPM Release。稳定版 Windows 晋升是可选的:同时提供确切的 windows_node_tag 和候选批准的 windows_node_installer_digests,即可在 GitHub 发布定稿后派发其签名安装程序。两者都省略则跳过 Windows。对于 npm 稳定版证据,当带标签的 apps/android/version.json 与稳定版标签的基础版本匹配时,独立的原生资格验证任务会针对确切的发布 SHA 启动启用 Android 的完整 CI。成功结果在核心发布后重新验证,然后独立的 Android 任务创建其现有的审批收据并派发标签所属的 APK 工作流。这使冻结的发布标签保持可用,同时不允许较窄范围的 npm 证据授权未经资格验证的原生构建。原生失败仍然可见并阻止 Android 审批;核心 npm 和 GitHub 发布定稿不会等待它。核心发布后,整个父工作流仍可保持活动状态,等待原生资格验证完成。现有的完整证据和 macOS 的独立验证保留其原生资格验证契约。不匹配的 Android 固定版本会同时跳过原生资格验证和 APK 发布;父工作流摘要和发布证明中会记录该固定版本、发布列车及 Android 版本固定(pnpm android:version:pin -- --from-gateway)补救措施。
定向插件专属修复使用 plugin_publish_scope=selected 和非空包列表。仅插件 all-publishable 运行要求与核心发布相同的不可变 npm 预检和 Full Release Validation 证据。
PUBLISH_REF="release-publish/<tooling-sha12>-<epoch>"
FRV_RUN_ID="<successful-full-release-validation-run-id>"
FRV_RUN_ATTEMPT="<successful-full-release-validation-run-attempt>"
gh workflow run openclaw-release-publish.yml \
--ref "$PUBLISH_REF" \
-f tag=vYYYY.M.PATCH-beta.N \
-f preflight_run_id="$FRV_RUN_ID" \
-f full_release_validation_run_id="$FRV_RUN_ID" \
-f full_release_validation_run_attempt="$FRV_RUN_ATTEMPT" \
-f npm_dist_tag=beta
对于快速演进分支上的固定提交证明,请使用辅助工具而非 gh workflow run ... --ref main -f ref=<sha>:
PUBLISHER_SHA="<recorded-full-trusted-main-ancestor-sha>"
VALIDATION_SHA="<full-release-candidate-sha>"
PUBLICATION_SELECTION='{"route":"normal","npmDistTag":"latest","publishOpenclawNpm":true,"pluginPublishScope":"all-publishable","plugins":[]}'
pnpm ci:full-release \
--sha "$VALIDATION_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"
仅为预期的 prepared-button 使用者选择 npmDistTag=beta(用于 beta)和 route=prepared。源准入验证已提交的元数据;全新发布运行在扇出之前还会保留分别选定的 npm 与 ClawHub 注册表准入。两者均不授予发布权限。两种契约参见 Dispatch。
对于非发布工作,请明确选择 diagnostic、main-qualification 或 postpublish-confidence,并省略发布选择;profile 和过滤器仍会选择实际覆盖范围。
GitHub 工作流分发 ref 必须是分支或标签,不能是原始提交 SHA。辅助程序首先通过在新临时仓库中进行裸 SHA 获取来证明 GitHub 提供的是精确的 Validation SHA,空跑也不例外。在独立准入之后,它会在 Q=C 处推送一个不可变的 release-ci/* 工作流 ref,并通过 ref 和 expected_sha 传递 C。复用的证据必须保留其原始 Q 和覆盖范围;每个新的子工作流 headSha 必须与 Q 匹配。记录全部三种角色,并且绝不从变动的 main 刷新资格认证。常规发布分支只接受其最终包版本或匹配的 beta 预发布版本。
release_profile 控制传递给发布检查的在线/提供程序广度。手动发布工作流默认使用 stable;只有当你确实需要广泛的提供程序/媒体矩阵时才使用 full。Stable 和 full 发布检查始终运行详尽的在线/E2E 和 Docker 发布路径浸泡测试;beta profile 可通过 run_release_soak=true 选择加入。
fail_fast 默认为 false:伞形工作流等待每个已分发的子工作流,并统一报告其各自的失败。仅当在子工作流第一个失败作业后取消它比获取完整失败清单更有用时,才设置 fail_fast=true。在 Release Checks 中,这还会启用 Matrix QA CLI 自身的首个场景取消。
beta保留最快的 OpenAI/核心发布关键通道。stable添加稳定的提供程序/后端集合。full运行广泛的提供程序/媒体矩阵。
伞形工作流记录已分发子运行的 ID,Verify full validation 会在该父尝试期间检查这些 ID。父级取消或超时会使已采用的精确子工作流继续运行;当不再需要时,请显式取消它们。
对于恢复,请为每个失败的测试判断是阻塞问题还是偶发问题,然后在修改之前对产品、测试框架/工具/来源、基础设施/凭据和包装器失败进行分类。只有确认的产品或资格认证测试框架失败才会更改 C/Q。在显式窄范围 rerun_group 验证运行之前,诊断并修复所属缺陷;绝不要自动重试失败的测试或扩大到 all。偶发问题最多获得两次显式的同 SHA 重跑,并在 main 上跟踪修复;记录一个符合条件但仍失败的作业,而不是更改工具、重新切割或启动另一次 Full Release Validation。窄范围证据本身并不构成发布授权。
OpenClaw Release Checks 使用可信的工作流 ref 将所选 ref 一次性解析为 release-package-under-test tarball,然后将该产物传递给跨操作系统检查和 Package Acceptance,以及在运行浸泡覆盖时传递给在线/E2E 发布路径 Docker 工作流。这使包字节在发布机器之间保持一致,并避免在多个子作业中重新打包同一候选。源包准备有 35 分钟的整个作业预算,以便在产物上传之前完成冷声明生成和包清单;下游作业仍然只消费不可变的上传包。对于 Codex npm-plugin 在线通道,发布检查要么传递从 release_package_spec 派生的匹配已发布插件规格,要么传递操作员提供的 codex_plugin_spec,或者将输入留空,以便 Docker 脚本打包所选检出版本的 Codex 插件。
Full Release Validation 的并发以 Validation SHA、Tooling SHA、rerun 组、release profile 和有效浸泡覆盖范围为键,并使用 cancel-in-progress: false。Release Checks 在每个阶段使用相同的覆盖标识,因此 beta、stable 和 full 请求不会相互排队。Stable/full 始终包含浸泡测试;显式设置其浸泡标志不会创建另一个并发组。父级取消不会取消已采用的子工作流。
在规范仓库的 hybrid runner 模式中,目标解析、证据重用、候选发现、候选绑定和候选解析使用小型 Blacksmith runner 池。否则,这些串行作业会在测试开始前加剧托管 runner 准入延迟。其他模式和非规范仓库保留 GitHub 托管的 runner;可重用的测试框架也遵循其显式的托管 runner 覆盖设置。长时间运行的决策和诊断收集器仍保持托管。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw