最慢的 Node 测试族如何拆分、均衡、打包和缓存。属于 CI 作用域与路由 索引的一部分。
最慢的 Node 测试族会被拆分或均衡,使每个作业保持较小规模,同时不过度预留 runner:
- 每小时 main 和普通手动/发布验证保留完整的插件与渠道契约作业,沿用现有的加权进程选择和 runner 回退机制。PR 通过 changed-owner Node 计划选择精确的契约测试;冻结的历史手动目标保留其独立作业。
- 附加检查: 当前目标将导出冲突、会话访问器/转录读取器、SQLite 事务和 SQLite 模式检查合并到一个串行 source-contract 行中,保留每条命令并收集所有失败。完整计划在 main 上有五行,在当前目标分发上有六行;PR 选择适用的静态行;SDK API 报告仅分配给分发。冻结目标保留原有的八行和历史命令回退。
- 核心单元快速/支持通道分别运行;unit-src、Control UI 和 gateway-core 各使用三条确定性的按文件加权条带,而 security 和 media/UI 伴生配置保留其限定范围的整配置支持组;核心运行时基础设施拆分为 process、shared、hooks、secrets 和三个 cron 领域分片。
- 自动回复(auto-reply)以均衡 worker 方式运行,回复子树拆分为 agent-runner、commands、dispatch、session 和 state-routing 分片;dispatch 进一步隔离 core、delivery 和 lifecycle 入口点。
- Agentic gateway/server(control-plane)配置分散到 chat、auth、model、HTTP/plugin、runtime 和 startup 通道,而不是等待构建产物。
- 托管的完整发布计划会为 CLI process、agent/chat、Gateway methods 和 runtime-config 所有者保留完整的已测量代际(generations),即使清单发生变化,直到当前选择被测量为止。匹配的单一测量结果可避免已知文件被粗略权重重新定价。规划器将这些所有者拆分为至多 64 个文件一组,然后仅将具有匹配 runner、构建和环境要求的已测量组打包进串行作业,每个作业包含至多 720 秒的已测量或预估工作。每个组保留自己的进程、计时身份和双 worker 上限;某个组失败仍会使作业失败,而其余组继续运行。PR、每小时 main 和 Blacksmith 规划保留其现有策略。整作业计时导入器会跳过已打包的作业。
scripts/ci-refit-test-timings.mts从 CI 分发(包括失败的工作流)中采样这些作业的成功运行,并且要求在记录每个完整组墙钟时长之前,提供覆盖每一次 Node 和 Bun 调用的完成回执。需要两次独立运行,而且这些部分清单不能裁剪其他测量结果。完整发布矩阵省略冗余名称和默认字段,以保持不超过现有输出预算。 - 普通 CI 仅将隔离的 infra include-pattern 分片打包进确定性的捆绑包,每个捆绑包至多 64 个测试文件,从而缩减 Node 矩阵,同时不合并非隔离的 command/cron、有状态 agents-core 或 gateway/server 套件。重量级固定套件继续使用 8 vCPU,而大多数捆绑和较低权重通道使用 4 vCPU。此前已提升的紧凑型工作负载在打包前仍通过其语义所有者和所选文件保留 8 vCPU 容量。计时或构建所有权变化不能将该容量转移给无关行。托管条带继承其父所有者的容量;完整的具名手动与发布计划保留其现有路由。完整具名捆绑包在存在时包含其 runtime-build 模式,因此
checks-node-bundle-infra-small-runtime-1和checks-node-bundle-infra-small-1标识不同的前置条件组。它们的测试清单和 runner 限制不变;唯一名称让发布收集器无需模糊的尝试证据即可同时保留两个作业。 - 在 GitHub 托管的 runner 上,每小时 main 将 agent-chat 组限制为 30 个文件,将 Gateway-methods 组限制为 96 个文件。超过 32 个文件的 chat 组和 Gateway-methods 组在独立行中运行;较小的 Gateway 尾部保留普通打包方式。已测量的 updater 测试单独运行,而不是扩展某个 storage 行。Storage 保留其 64 文件上限。这些仅限 main 的拆分保留所有选中的测试、配置、worker 限制、构建前置条件和计时代际;PR、完整发布和付费 runner 计划保留其现有打包方式。完整的每小时 main 矩阵仍保持在 77 行的预算内。
- Canonical PR 从有界的 changed owners、传递性导入消费者、workspace/公共 SDK 别名、受保护回归和显式策略监视中解析其运行时测试。Node 构造器消费该选中集合。Windows 和 UI 作业在其平台/区域所有者发生变化时保留完整普通清单;无关的 UI 测试族仍可接纳精确的受保护或受影响文件。全局输入永远不会请求完整的 compact 运行时仓库。缺少选择器能力会使预检失败。Main 保留其完整的自动层级,而普通手动/发布验证会添加现有的仅发布清单。
- 静态正确性与运行时目标选择无关。生产类型和测试类型、语义 lint、格式化、SDK 边界、schema 漂移以及 Knip 均保留其必需检查;模糊的静态所有权会保持完整的编译器/lint 覆盖。运行时目标选择不需要通过完整套件回退来保留这些防护。参见作用域规则。
- 发生变更的工具链测试或所有者会选择其精确的所有者测试、受影响的传递性测试导入者、受保护回归和显式监视,但受下面列出的具名进程证明排除项约束。工具链配置保留其文件并行度、worker 限制、运行时前置条件、后端路由和容量提升。它们永远不会请求全测试族的 PR 回退。
- 精确解析出的带元数据文件保留其 canonical 配置、runner、worker/准入策略和准备要求。Canonical 分配使用现有文件权重对已知子集定价,保留以完整组价格为上限的冷进程余量,并单独计算准备费用;不透明清单保留其完整价格。兼容的完整执行环境可以共享现有行,而无需合并子进程或增加其 worker;串行兄弟可共享该行,而并行兄弟保留其条带族分离。PR 准入过程将选中的文件划分到各个行中,目标为最多 150 个预估测试秒,使用现有文件/组计时证据,并对缺失观测采用保守估计。它保留完整文件和每个断言;不可分割的文件或 canonical 组可以超出该目标。这些是准入估计值,而非实测的作业墙钟时间:环境准备、构建、排队和 runner 争用仍是独立成本。缩减后的组使用不同的计时身份,因此部分观测结果不能覆盖完整父级计时。
- Control UI 变更通过其独立的现有所有者门禁保留完整的普通单元、模拟 E2E、真实 Gateway 和 bootstrap 测试族。受保护和受影响文件会精确地选择加入其他测试族。具名的仅发布 UI 文件保留现有的直接/所有者选择加入机制。空的真实 Gateway 阶段会被省略,而仅限桌面的载体保留其必需的桌面证明。配置、项目隔离、worker 策略和运行时前置条件保持不变。
- 直接变更的插件测试及其选中的所有者测试在 canonical 配置中使用精确文件选择。Unit-fast、contract、bundled 和 E2E 文件保留各自套件边界。不存在整个插件的 PR 回退;每小时 Plugin Prerelease 和 Full Release Validation 保留完整的扩展清单。
- 规划器的
RELEASE_ONLY_TOOLING_SHARDS集合以及混合快速配置中匹配的 maintainer 叶子项会在无关 PR 上推迟完整的 maintainer-tooling 测试族。Tooling Vitest 配置拥有普通清单以及 isolated/Docker 目录。快速配置选中的 maintainer 叶子项保留其 ordinary、isolated 或 fake-timer 所有者与进程固定;过滤混合组会保留产品邻居,并让各子集使用独立的计时身份。专门的产品 E2E 和 live 测试(包括五个test/scripts/*.e2e.test.ts门禁)不在此层级内。触及工具链测试或所有者的 PR 会选择其所有者文件、传递性导入消费者和受保护回归,但受下面显式的发布证明排除项约束:scripts/**、src/scripts/**、test/**、.github/**、config/**、根 package/pnpm 输入、工具链配置,以及由scripts/test-projects.test-support.mts中的共享 changed-path 所有者归类为工具链的其他输入。该所有者还覆盖 Docker、agent/Crabbox 工具链、应用脚本/Fastlane 以及扩展脚本/包输入。直接变更的工具链测试在其自身 PR 上保留覆盖,显式进程证明除外。每小时 main 和普通 CIworkflow_dispatch包含该测试族,包括 Full Release Validation 针对冻结候选运行的normal_ci子作业。其Run Node test shard步骤在常规发布准入之前运行这些未变更的测试;不需要独立的重复发布测试。现有已批准的仅预检 beta 发布例外保持不变。Plugin Prerelease 单独拥有agentic-plugins;CI 的插件排除项不控制工具链层级。Fork 仓库保留完整工具链,因为它们不使用 canonical PR 目标选择。产品测试保留其现有层级,但下面显式的运行时证明清单除外。 - 显式的
CI_PROOF_TEST_FILES清单将test/scripts/frv.release.test.ts和test/scripts/install-ps1.release.test.ts排除在 PR 计划之外,即使是直接编辑的测试也一样。每小时 main、手动 CI 和 Full Release Validation 在 canonical 工具链配置中保留两套完整进程巡检。FRV 在frv.test.ts中保留其进程内续接契约;安装程序在install-ps1.test.ts中保留其源码守卫。不会移除任何用例或断言。 -
显式的
RELEASE_ONLY_RUNTIME_TEST_FILES清单会将已测量的运行时集成巡检从 canonical 自动 PR 和 push 计划中推迟,而较快的所有者测试保留其主契约。它涵盖 Doctor 配置和迁移组合、CLI 启动、Gateway model/plugin/session 和 worker-environment 巡检,以及 updater、打包和存储恢复证明。现有发布清单保持不变:src/flows/doctor-health.test.ts、src/infra/update-managed-service-handoff-foreground.test.ts、src/node-host/node-worker-supervisor.recovery.test.ts、src/state/openclaw-database-preflight.lifecycle.test.ts以及全部八个src/config/state-startup-corpus*.test.ts包装器。它还保留src/gateway/server.sessions.archive-worktree-lifecycle.test.ts和src/gateway/server.sessions.delete-worktree-lifecycle.test.ts中的真实 Git 归档/删除矩阵,以及src/process/supervisor/adapters/child.service-lifecycle.test.ts中原生/broker 子进程退役矩阵。更快的 session-lifecycle、identity、worktree-owner、relay-state 和 readiness 测试仍保留在自动 CI 中。startup-corpus paths 所有者按其现有分区顺序提供完整测试族。这些文件保留其 canonical 配置、进程隔离、运行时前置条件、worker 限制、用例和断言。整配置 CLI 过滤共享 canonical 包含与排除所有者,不引入文件条带,也不改变其 worker 和串行作业策略。并行组在应用 worker 策略时保留缩减覆盖的计时身份,因此自动 CI 采样不能覆盖完整发布估计值。选中的所有者测试和直接测试编辑在 canonical PR 和精确头部 release-gate 替代物中运行;无关路径不会纳入剩余的发布矩阵。手动 CI、Full Release Validation 的normal_ci子作业、本地完整计划和非 canonical 仓库保留完整清单。发布层级还保留独立的published-upgrade-survivorDocker 单元,包含已发布基线、legacy-operator-state场景和auto-auth重启模式;合成的 foreground-handoff 用例不能替代该已发布驱动 × 候选证明。 -
键控发布规模基准(
src/gateway/session-row-projection.keyed-marks.benchmark.test.ts)同样使用运行时发布清单。完整手动 CI 与完整发布验证保留其 4,428 行 SQLite 固定数据集和 70,000 个发布记录;常规 PR 与每小时 main 计划将其推迟。直接编辑仍会在相应 PR 上选中该基准。较小的会话行投影测试在常规 CI 中保留精确键失效、跨代理隔离、行查找和刷新行为。该基准保留在规范 Gateway 核心配置中,所有断言完好无损。 -
十个原生维护者工具链和发布矩阵使用
RELEASE_ONLY_RUNTIME_TEST_FILES:test/scripts/ci-linux-git.test.ts、test/scripts/pr-worktree-provision.test.ts、test/scripts/pr-worktree-interruption.test.ts、test/scripts/pr-merge-outcome.test.ts、test/scripts/pr-merge-admission.test.ts、test/scripts/pr-merge-rest.test.ts、test/scripts/pr-merge-receipt.test.ts、test/scripts/pr-merge-recovery.test.ts、test/scripts/full-release-validation-at-sha.test.ts和test/scripts/package-acceptance-workflow.test.ts。工具链所有者 PR 会推迟这些矩阵,除非其测试文件直接变更;普通 main 和仅产品 PR 本就会省略工具链系列。更快的 Git 所有者、导入闭包、托管合并、完成、状态隔离和发布契约同类测试仍保留在常规工具链覆盖中。 -
同一份显式运行时清单还会将原生运行器状态清理、空发现和入口点矩阵、修正合并集成以及捆绑的浏览器 MCP 包管理器矩阵从工具链所有者 PR 中推迟。更快的状态生命周期、主目录隔离、运行器准入、原生参数解析、修正准备和捆绑 MCP 构件测试保留其主要契约。完整组合在其规范配置中保留全部用例和断言。直接测试编辑仍会选中它们;完整手动 CI(包括每小时 main 和完整发布验证)均予以保留。
-
媒体持久化大型语料证明和 SQLite 可靠性流程演练使用同一发布清单来界定堆、稀疏会话、大负载以及组合式崩溃/恢复边界。常规媒体迁移、本地快照仓库、SQLite 快照和 Doctor 压缩套件在常规覆盖中保留其主要契约;完整的资源规模和进程组合仍保留在手动与发布验证中。
-
发布清单还保留完整的 CLI 帮助、Gateway 支撑的退出、Web 输出背压、插件编写和打包技能演练,真实的 npm 依赖修复和已安装提供程序身份验证组合,以及 256 MiB Git 备份堆证明。更快的输出终结、Gateway RPC、命令策略、技能就绪、插件修复/发现和备份往返测试仍保留在 PR 与每小时 main 覆盖中。被移动的文件保留其规范配置和全部断言,直接编辑时运行,并继续被全层级 CI 和完整发布验证选中。
-
MCP 发布证明(
src/agents/agent-bundle-mcp-retention.test.ts和src/agents/mcp-stdio-client.cleanup.real.test.ts)保留嵌套共享工作进程文件顺序检查,以及全部六个真实 POSIX 中继/锚点关闭用例,包括其生产取消截止时间。常规 CI 保留私有转录和请求方生命周期测试、MCP 清理错误传播,以及使用注入时钟的监督器取消/退出测试。组合式进程证明在手动与发布验证期间通过同一个 agents-core 配置运行。 -
启动语料测试在 PR 上使用变更所有者选择;以下六个文件的固定冒烟集合是无条件运行时下限。规范 main 保留其常规启动语料,完整手动/发布验证保留完整家族。一份完整的精确树 Node 覆盖收据会移除那条原本会为空的快速启动语料行。历史手动目标保留其受支持的分片文件或旧式分片语料回退。当前 PR 不会新增单独的完整语料作业。
-
规范
main推送采用 Blacksmith 集成紧凑配置,包含 nondist Node 作业以及 dist 边界描述符。原先的多配置墙(CLI 加 CLI-process、isolated 加 fake-timers 的 unit fast,以及 logging/process/runtime-config 三件套)被拆分为按配置划分的分片,这样任何单个组都无法单独拖垮某条跑道。真实的 Node+TSX 命令测试归属于 isolated CLI-process 目录,因此普通 CLI 测试无需准备运行时。进程目录按完整文件成本拆分,拆分大小以完整文件成本和运行时前置条件为下限,因此旧的聚合计时无法隐藏新归属的工作。文件打包同样纳入该前置条件;当消耗运行时的 CLI 子任务的完整组合估算符合现有 150 秒预算时,它们可在同一串行作业中共享一次准备。每个子任务保留其选定文件、隔离进程和双工作进程限制;刻意分离的固定条带家族保持分离。gateway 进程文件单独保留,因为其冷启动证明已需 200 秒。CLI 子任务保留 150 秒的规模目标和双工作进程限制。仅包含非构建 CLI 子任务的普通混合分箱最多可合并 250 个预测秒,且每个原始子任务仍单独准入、低于 150 秒;托管运行时前置条件本身有 160 秒下限。它们省略每推送低信号的工具链和 TUI PTY 组,同时保留显式发布层级之外的产品运行时组,包括 unit-src、Control UI 和 gateway-core 各三条按文件加权的条带。Blacksmith 串行准入保持大类别 200 秒、小类别 276 秒。可共享两个进程槽的普通组允许 360 个预测聚合秒;已超过串行上限的组单独保留。手动调度和完整发布验证保留完整的按分片命名矩阵。每小时 main 运行完整的 main 层级清单;预先存在的仅发布组合保留在普通手动计划和完整发布验证计划中。 -
每小时 main 通过现有紧凑规划器在其 77 行 Node 上限内纳入完整工具链清单。显式的仅发布运行时组合保留在普通手动/发布验证中,除非某个 PR 选中其测试。成功的 PR merge-ref 结果证明的是其被测树,而非后续 main 修订;现有门禁仅聚合每个修订实际选中的作业。
-
Doctor 会话和 cron 测试将两个最长的 SQLite 文件保留在独立分片中,其余文件放在一起。每个分片在 commands 配置的现有执行策略下运行完整文件。三位所有者不能共享紧凑作业;Blacksmith 为其提供 8-vCPU 放置和 200 秒准入目标。在规范计时重新拟合获得两个成功的 main 运行样本之前,两位新所有者按观测到的文件主体加上完整组开销计费。固定数据集大小、断言和进程隔离均不变。
-
生成式托管条带的直接测量值拥有自己的打包权重,与原生组一致。GitHub 运行使用托管测量值,混合首次尝试运行使用 Blacksmith 测量值;只有未测量的子任务才分摊父估算。这可以防止开销大的已测量子任务在人为较小的估算下被与额外工作打包在一起,同时保留其测试分区、工作进程绑定和按子任务的文件执行策略。
-
变更插件作业以串行方式运行其独立配置信封,包括内部进程块也按顺序运行的配置。现有工作进程策略随后可使用检测到的 CPU 预算,而无需为重叠计划预留容量;多目标作业保留其独立并发策略。
-
十六条工具链条带使用按文件测量的权重,将 Git 所有者、托管进程、工作进程构件和转换缓存证明保留在独立作业中。Go 设置首先遵循显式选定的文件。对于整配置工具链计划,只有普通工具链配置拥有 docs i18n Go 测试;isolated 和 Docker 目录不拥有。未知历史配置保留其原始 Go 设置。包含统一声明编译器夹具的分片保留现有较大的运行器;托管拆分在打包前将该放置带入每个子任务的选定文件。其合成编译器图使用现有 1,024 MB 堆覆盖,而生产完整构建保留其资源防护。Git 所有者用例各自拥有独立检出和进程树,因此其真实超时和清理检查在每个运行器上最多重叠两个用例。工作进程转换证明使用独立套件及其自有夹具生命周期;迟到的子任务清理无法移除其他套件的输入。这些变更保留测试用例、截止时间和进程隔离;测量准入在现有混合行上限内确定作业数量。
-
Blacksmith 编号工具链分箱在打包后请求 32-vCPU 类别,同时保留其逻辑运行器类别、名称、文件清单、串行项目执行和双工作进程绑定。工具链文件使用共享工作进程调度器;Docker 辅助夹具保留其独立串行配置。在运行 33689551111 中,三个最慢的工具链分箱获得两个 CPU 和 8 GB 内存;其 314–342 秒主体设定了八分钟的非 Windows 墙钟时间。更大的请求解决了该主机容量不匹配,而无需增加分片。托管和混合工具链放置不变;该请求在声称达到八分钟目标之前需要原生计时证明。
-
对于普通 UI 作业,
RELEASE_ONLY_UI_TEST_FILES将app-sidebar.stress.browser.test.ts和control-ui-stale-build-reload.e2e.test.ts从普通规范 PR 与 main 计划中推迟。陈旧构建场景构建两个生产包以演练真实的惰性路由重载恢复;聚焦的陈旧 chunk 和 router-outlet 测试保留快速覆盖。直接变更的测试文件会在其自身 PR 或推送中保持选中;源所有者和目录变更不会扩大该层级,即使所有者选择器提供了显式文件列表。完整手动 CI 和完整发布验证保留完整的规范 UI 配置。Fork、未知变更路径清单和历史兼容目标也保留完整覆盖。其他模拟 UI 流程遵循普通所有者选择和每小时覆盖。规划器在进入现有三个 UI 分片和八条加权 Control UI E2E 分片之前收窄发现范围。普通 E2E 行使用三个并行工作进程,而 private-server 和 runtime-budget 项目各保留一个;完整手动清单保留十二行和两个并行工作进程。独立的 real-Gateway 和 browser-extension 作业保留各自的覆盖和调度。 -
同一
RELEASE_ONLY_UI_TEST_FILES选择也馈入独立的 real-Gateway 作业:cron-duration-save、desktop-resize、control-ui-automation-management(QA Lab)、quota-reset-status、session-pr-reader-lifetime、chat-collaborator-scroll、mcp-app-conformance、usage-sessions-owner-attribution以及 QA Lab 的control-ui-openclaw-delegation、control-ui-media-transcript和session-host-command-state会在完整手动 CI 和完整发布验证的normal_ci子任务中运行。其完整的 browser/Gateway 组合保留在规范预构建配置中,断言和按项目的工作进程策略不变;更快的模拟和所有者边界同类测试留在常规 CI 中。共享路径清单保留所有其他 real-Gateway 和 QA Lab 文件。桌面传输引导保留其独立证明;没有预构建配置的历史目标保留其原始显式文件列表。证明作业准入不变:普通 PR 本就会省略 real-Gateway 作业,main 形态的计划保留直接编辑的测试文件。Browser-extension 路由不变。Real-Gateway 准备使用现有仅运行时完整构建(OPENCLAW_BUILD_PRIVATE_QA=1 OPENCLAW_RUN_NODE_SKIP_DTS_BUILD=1 pnpm build);build-artifacts保留 SDK 声明生成和验证。保持准备独立可避免等待该作业后续的构件检查。当前规划器从同一选定清单发出两行 real-Gateway:现有串行夹具加选定独立伴生项,以及其余经审计的并行夹具。伴生项在串行执行后共享现有双工作进程阶段,无需另一个捆绑预览。预构建调用预览和平台家族夹具复用经过验证的规范 Control UI 字节。默认模拟 Gateway 的 hello 消息接收该构件标识,保留显式覆盖和构建偏差验证;普通本地预览仍构建私有资源。真实 node/SSH 桌面调整大小引导是仅发布项,并遵循同一选定清单;完整手动/发布运行和直接 desktop-spec 编辑会各执行一次两种载体,而高频调整大小和安全所有者测试留在常规 CI 中。规划器负责放置,并消费与 Vitest 调度相同的并行资格允许列表。冻结目标和旧版规划器保留一个完整行;普通 UI 分片数量和运行器标签保持不变。
Control UI 浏览器项目与测试分片¶
- Control UI 浏览器项目会贪婪地打包已发现的测试文件,其依据依次为:已提交的按文件计时数据、冷启动基本名称提示(basename hints)、以及源码字节大小。打包文件默认最多使用两个 worker,受共享 worker 上限和本地限流约束;显式的 Vitest CLI worker 覆盖选项仍然可用。私有源服务器、真实 Gateway 以及运行时预算测试保留在单 worker 项目中;本地全量套件运行会先完成打包工作,再启动该项目。按文件开销会根据串行调用重新拟合;并行调用仍会更新其文件权重。计时键仅提供权重:发现机制仍决定完整的测试清单,包括新文件和没有测量数据的文件。
- 广泛的浏览器、QA、媒体及其他杂项插件测试使用各自的专用 Vitest 配置,而非共享的插件兜底配置。包含模式(include-pattern)分片使用 CI 分片名称记录计时条目,因此
.artifacts/vitest-shard-timings.json可以区分完整配置与过滤后的分片。 - 浏览器扩展的 Chromium 引导命令会准备
qaRuntime。它会构建原生宿主和 relay JavaScript 及运行时资源;独立的 artifact 作业负责 Control UI 和插件 SDK 声明验证。真实 Chromium 流程及其断言保持不变。 - Node E2E 分片通过
OPENCLAW_E2E_USE_PREBUILT_DIST复用qaRuntime。当打包后的@openclaw/ai消费者测试被选中时,CI 分片负责人会检查其包清单中的每个声明条目,并且仅当某个条目缺失时,才在接纳 worker 之前运行 typed AI 构建。通用 Vitest 接纳流程绝不会重复此修复:本地预构建 E2E 运行要求调用者自行准备 artifact,而常规 E2E 设置本就会构建 typed AI 包。无关测试和完整 typed 包不会触发构建;OPENCLAW_E2E_SKIP_BUILD仍将准备工作留给调用者。 - 浏览器原生宿主启动测试是一个独立的 POSIX E2E 用例。Linux
build-artifacts会在构建或恢复 dist 之后显式运行它,并使用OPENCLAW_E2E_USE_PREBUILT_DIST=1,以确保该测试无法启动另一个构建。其 JSON 报告必须恰好包含预期文件中指定的通过断言,且有一个通过的测试、零失败、零待处理测试和零待办事项;缺少 artifact、跳过测试以及缺少结果均视为失败。仅当冻结的历史检出缺少该测试文件时,工作流步骤才会跳过:这属于无法获得的历史证明,而非覆盖范围问题。当前检出若缺少文件仍会失败。对该用例、其安装夹具(fixture)或其 relay-key 夹具的更改,即使在仅测试差异(test-only diffs)的情况下也会选择 artifact 作业;无关的浏览器单元测试保持免构建。手动 CI 使用相同的 artifact 步骤,独立于仅限发布的插件扫描。 - Linux Node 分片作业通过上游 Actions 缓存 API 持久化 Vitest 的文件系统模块缓存。在 Blacksmith runner 上,官方缓存操作使用 Blacksmith 的同地缓存后端 而非 GitHub 的,因此即使缓存键匹配,缓存条目也是后端本地的。Blacksmith CI 分片仅恢复,并将受保护的 Blacksmith 种子解包到隔离的 runner 本地根目录中。当 GitHub 托管的故障后端处于活动状态时,每个
checks-node-*测试分片、checks-ui、普通分片的checks-ui-e2e作业、两个快速合约矩阵,以及运行 Vitest 的checks-fast-core任务都会从 GitHub 后端恢复一个单独发布的不可变转换种子。复合操作的单一默认关闭restore-test-caches输入使得在不更改缓存键或写入策略的情况下易于禁用该扩展;混合 fast-core 行仅对调用 Vitest 的任务启用它。真实 Gateway UI 作业不恢复这些测试缓存;原生和 Control UI i18n 通道不调用 Vitest。混合规划器配置文件在两个后端本地存档之间使用匹配的键合约:attempt-1 Blacksmith 行读取 Blacksmith 种子,而托管重试只能读取单独发布的 GitHub 种子。普通 CI 作业仅恢复;独立的受信 warmer 拥有受保护的后端本地缓存发布的写入权。非取消型 warmer 跟踪 main 分支,跳过仅文档推送,每日运行,并接受 main 上的手动或仓库调度。依赖发布和代码预热按后端、平台和 ref 独立串行化,因此新依赖种子可以在先前构建仍在运行时发布。编译后的 Vitest worker 保留在完整 Linux 代码作业中,在原生 SDK 编译更改解析拓扑之前准备并保存;依赖作业不执行任何编译器工作。普通 Linux 代码行遵循OPENCLAW_CI_RUNNER_BACKEND。混合模式还使用真实 CI 路由、插件/通道合约和 UI 包配置中的十七个文件发布一个有界的托管种子。它运行与托管消费者相同的直接 pnpm 入口点和项目并发;Node UI 保留分片 runner。两条 Linux 代码行都安装校验和固定的 Bun fork,并通过常规 Vitest 启动器收集相同的七个 UI 种子文件到 Bun 上。共享的分片环境所有者将 Bun 转换放置在其单独的运行时缓存叶子中。Node 和 Bun UI 收集使用普通 UI 堆环境,而较重的 Node 组保留 8 GiB 上限。项目、分片、扩展批处理和直接测试包装器将共享缓存根解析到同一配置拥有的叶子中,与配置顺序或单配置与混合配置调用无关。同一配置的并发运行会借用单独的可写槽位,直到其进程组汇合。显式缓存路径仍是调用者拥有的叶子。分片 runner 保持 Node 和 Bun 根分离,并在并发计划启动之前克隆两个恢复的种子。它省略完整构建和广泛的 agent/运行时收集;仅由其他文件或测试主体引用的导入可以保持冷状态。Blacksmith 发布成功不会填充 GitHub 的缓存后端。Linux 行通过常规 runner 以并发一和--testNamePattern=(?!)在每个新的子进程中启动每个选定的分片/配置封装。非 UI 收集保留完整 Node 种子,并通过与普通 CI 相同的运行时分区所有者收集现有的 Bun 兼容清单。托管预热仅添加其有界工具种子中已存在的兼容文件。非 UI 运行时选择器接纳确切的收集过滤器;其他测试名称过滤器和不受支持的标志保留保守的 Node 路由。收集在复用稳定的配置拥有缓存叶子的同时保留包含模式、环境、编译导入和按文件清理。测试主体在普通 CI 中运行;仅在这些主体内部可达的导入可以保持冷状态直到该次运行。warmer 完成每个选定的封装,并在收集失败时也保存内容键控的转换和编译缓存,然后在缓存保存后报告失败;普通 CI 分片执行保持快速失败。这防止配置全局状态泄漏,避免将过滤后的分片扩展为完整配置,并保留先前子进程产生的转换。设置程序在启用转换缓存时仅计算一次转换输入指纹,并将其传递给恢复和生成验证;禁用的缓存不扫描检出。指纹清除不兼容的 lockfile、包、tsconfig 和 Vitest 配置代际。在两个运行时生产者汇合后,最终 Node UI 收集拥有唯一的修剪遍历。发布之前,受信 warmer 在组合转换缓存超过 2 GiB 后扫描并将其修剪至 75%,Node 编译缓存超过 1 GiB 后修剪至 75%。消费者作业从不修剪恢复的种子。Vitest 对模块 ID、源码内容、环境和解析后的转换配置进行哈希,因此普通的部分源码更改会使未更改的条目保持热状态,而更改的模块安全地未命中。粗粒度恢复前缀桥接工作流运行;常规 Actions 缓存 LRU 和非活动驱逐限制旧不可变存档的大小。 - Node 分片作业在执行前和 worker 清理后记录资源快照:CPU 型号、主机负载、可用内存、Node 的可用/受限内存估计值,以及 Linux 的 CPU/内存/I/O 压力(如可用)。当约束未知或不存在时,Node 报告零受限内存值;这不表示零 RAM。主机范围的压�力可以解释 CI 与重放之间的容量差异,但不能识别单个测试失败的原因。
- 受信 Blacksmith Linux Node 作业从一个不可变的上游 Actions 缓存恢复根
node_modules、工作区导入器树(包括插件本地版本和链接)以及工作区本地 pnpm store,Blacksmith 会从其同地后端透明地提供该缓存。Pnpm 在文件系统允许处使用硬链接导入,并将完整安装树和 store 保留在一个存档中即可保留这些链接。Pnpm 的元数据缓存位于同一存档的 store 根之下,因此恢复的安装可以验证供应链策略,而不依赖生产者的主目录。源码 postinstall 和构建准备使 pnpm 拥有的依赖树保持完整。键包含显式存档格式、runner 操作系统和架构、精确 Node 补丁版本以及语义安装输入指纹;没有过期前缀回退。冻结安装从依赖 lockfile 的导入器和本地链接图中选择受追踪清单,因此无关的发布工具和测试夹具不会使存档失效。可变安装、自定义 pnpm 钩子、本地文件依赖和不支持的 lockfile 形状保留保守的受追踪清单清单;冻结 pnpm 对账仍验证每次恢复。清单在哈希之前被规范化。仓库拥有的openclaw元数据块和非安装脚本被排除,因为 pnpm 和被审计的直接根钩子不读取它们,因此运行时模式、发布元数据、格式化以及普通测试/构建脚本编辑保持依赖树热状态;未经审计的生命周期钩子漂移在其源输入加入指纹合约之前以失败关闭。依赖、包管理器、钩子源和 lockfile 更改总是选择新的不可变存档。每次精确恢复都运行冻结的离线 pnpm 对账,因此未更改的存档无需注册表访问或导入器重新链接即可验证。如果对账失败,设置程序首先清除每个导入器树并离线从恢复的 store 重建,然后清除模块和 store 并从网络重试,而不是提供部分树。设置程序随后禁用 pnpm 冗余的运行前依赖检查,使安装和冻结对账成为唯一的依赖写入者;分片命令不得启动并发的隐式安装。独立的受信 warmer 在设置成功之后、构建和转换预热之前立即发布工具链和精确依赖存档;预检和下游 CI 作业仅恢复。规范推送和同仓库拉取请求仅在真正的自托管 runner 上选择精确恢复,包括混合 attempt 1。精确未命中自动回退到更粗粒度的 pnpm store 缓存。手动 CI 调度、fork 拉取请求、托管通道和托管重试仅使用该 store 缓存。缓存恢复/保存失败属于优化未命中而非正确性失败,常规分支范围、LRU 和非活动驱逐限制过时存档。之前可变依赖的 StickyDisk 路径在多次成功写入者确认提交、但后续运行仍恢复为空文件系统后被退役。 -
Node 分片和
build-artifact作业还通过不可变 Actions 缓存恢复 Node 的便携式磁盘编译缓存。在 GitHub 托管的故障模式下,上述托管的 Vitest 通道集会在其转换种子旁边恢复单独发布的 GitHub 测试范围存档。构建、QA 和测试编排共享受信 warmer 的完整构建和测试收集所填充的受保护种子。现有test缓存命名空间保留用于已发布的存档;没有单独的仅构建发布者。普通build-artifacts、QA 和测试作业仅恢复缓存。PR 和普通测试作业只读取受保护快照,因此特性分支字节码永远不会进入共享种子,PR 流量也不会创建缓存存档。当运行时标识和相对于缓存的模块路径匹配时,这会为 Node 加载的编排、构建工具和外部依赖重用 V8 字节码,包括仅部分源图更改的情况。可移植模式不保证跨任意检出布局的重用;Node 内部验证精确运行时分区和源字节。最大 2 GiB 的转换存档大约需要 15–20 秒以约 125 MB/s 的速度恢复;实测快速合约转换大约 21 秒,而恢复约 8 秒,更广泛的冷导入约 100–143 秒。如果实测节省低于恢复成本,应回退该优化。普通 Vitest 运行保留配置的 Node 编译缓存。Vitest 在 worker 及其子进程中为 V8 和自定义覆盖率提供者禁用字节码缓存;显式NODE_DISABLE_COMPILE_CACHE=1为整个调用禁用缓存。 -
两个 Linux 代码预热行都在测试收集之前将原生 SDK 声明归档发布到各自的后端;完整 Linux 行还会在其构建之前发布它。托管 lint 条纹和专用包边界泳道从各自 runner 的后端恢复匹配归档,并在复用前验证原生编译器输入和完整输出。混合模式维护该托管种子,而不重复完整的 Blacksmith 构建。保存后,预热器移除其原生 SDK 输出,以便后续打包声明缓存描述与普通构建消费者相同的树。包存储内容和 pnpm 存储位置簿记不是编译器输入;已安装依赖字节、解析拓扑、显式输入和编译器身份仍会使过期声明失效。全 Blacksmith 配置保留其只读粘滞磁盘路径。Control UI 和 UI E2E 作业共享一个 Linux Playwright Chromium 归档,其键为精确固定的 Playwright 版本。独立依赖发布者还运行一个标准托管
macos-15行,该行安装依赖,并在精确未命中后仅发布 pnpm 存储。它使用现有的操作系统、架构、Node 版本、包和 lockfile 键;macOS CI 仍仅恢复。该行禁用精确依赖、构建、转换和编译缓存,且不运行任何构建或测试预热。Pnpm 负责修剪,而前后磁盘使用量和已保存归档大小暴露保留内容;修剪不施加内容存储大小上限。 - 构建产物和 Docker 种子作业通过共享 Node 设置操作恢复受保护的完整构建缓存。
ciArtifacts和独立 SDK 构建使用scripts/write-plugin-sdk-entry-dts.ts:它暂存一个规范 SDK 声明程序,私有条目仅用于私有 QA。完整构建和包构建在其统一声明程序中包含 SDK 声明;这两个选择具有独立的缓存身份。命中会恢复到新的暂存区;冷代和缓存代都必须包含每个选定的 SDK 条目以及完整的相对声明闭包,然后才能发布到dist/。SDK 缓存从不采用来自实时dist/的声明。本地插件 lint 和包边界编译使用独立的原生声明树,而不是打包声明;参见 声明所有权。已构建的 Doctor 插件索引证明复用该精确的dist/输出,而不是第二次调用 E2E 测试框架的回退 TypeScript 构建。 - 完整构建和包构建分别缓存 AI、workspace-package 和统一声明。统一运行时总是在共享声明所有者暂存一个包含库根、公共 SDK 和插件契约的编译器程序之前重新构建 JavaScript。它将未更改的代恢复到私有暂存区,或在未命中时完整编译一次所选内容;后续 SDK 编译器不会重复该图。每个选择保留其前后输入快照,并在发布前验证每个选定条目、成功的编译器回执、相对声明边和共享块所有者,包括在包准备清空
dist之后。冲突的共享字节或已更改的已消费输入会在写入实时声明之前失败;缓存记录仅在成功发布后刷新。规范 DTS 配置启用 TypeScript 稳定类型排序,因此无关的字面量分配不会在重建组中重新排序未更改的导出类型。完整发布会修剪过期声明,同时保留签名应用包和 Control UI 资产;SDK 发布仅拥有其扁平条目,并保留其他组的共享块。AI 和 workspace-package 步骤在缓存命中时也会重新构建 JavaScript。隐式和显式启用声明的构建共享这些种子;仅运行时配置使用无缓存图,并且不能发布声明代。每个声明组对其成功编译器 Program 中的普通源字节进行哈希,因此对现有未消费测试、UI 源和工作流的编辑会保留其缓存命中。精确的 checkout 本地.cache/vitest临时根目录被排除在解析发现之外;显式消费输入、已安装别名以及相邻或嵌套路径仍会正常失效。它仍会验证继承配置、生成器和包/插件元数据、编译器身份以及解析拓扑;已消费的声明依赖项和新的解析候选项会使该代失效。workspace-package 更改会保守地使 AI 和包声明缓存失效。受保护的预热器在成功完整构建后立即发布构建归档,早于无关的测试预热和 pnpm 维护。每次预热器尝试都会获得一个新的不可变归档键;粗粒度恢复前缀提供先前组,并且每步签名仍然是唯一的内容有效性所有者。重建的组替换其完整的拥有缓存树,包括先前记录缺失或无效的过期字节。GitHub 的缓存配额和不活动驱逐限制旧代;相同的预热器尝试可以发布不同的归档。每周 Node 26 最小泳道改为在main运行成功后发布 14 天工件,并且仅恢复其不可变生产者身份解析到main上该工作流的工件,从而避免配额波动,同时不允许 PR 代码写入共享缓存。私有 QA 声明从不持久化到 Actions 缓存中,因为缓存命名空间不是保密边界。 check-additional-boundaries使用四个并发子进程和每个检查的计时运行完整的补充守卫列表(scripts/run-additional-boundary-checks.mts)。其 20 个检查保留单独失败、截止时间和进程清理。共享的四规则聚焦扫描在所有源根上运行一次;更窄的公共 lint 命令仍可用。Prompt 快照在其独立泳道中运行。包边界编译/金丝雀工作保持在一起,运行时拓扑架构独立于嵌入在build-artifacts中的 Gateway watch 覆盖运行。- 在 32-vCPU 自托管构建 runner 上,Gateway watch、channel 测试和核心支持边界分片在
dist/和dist-runtime/已经构建后,在build-artifacts内一起启动。GitHub 托管的回退运行保持 Gateway watch 串行,以便低核心争用不会消耗其就绪截止时间。完整 Node 构建随后通过串行公共 Gateway 消息操作验证 Discord 组件附件文件名,检查已构建修订版本并保留命名测试 JSON 结果;早于该用例的冻结目标明确报告不可用证明。两条路径随后单独运行两个已构建的 TUI PTY 工件金丝雀。
Discord 证明上传器仅在其生产者步骤以成功或失败状态完成后才会运行。它会保留真实证明失败的诊断信息,并且仍然要求声明的文件。如果更早的失败或取消跳过了生产者,或在完成前取消生产者,则上传器保持跳过状态;该覆盖范围保持未运行。
PR 所有者计划首先使用现有的紧凑行,然后拆分工作以接近 150 秒的测试预算。如果这些拆分超过最终的 Node 矩阵上限,规划器将保留紧凑的已选所有者行,包括插件工作。这会保持所选文件、配置、worker 限制和进程所有者不变;宽泛的 PR 可能拥有更长的行,而不是仅因拆分而在预检中失败。Dist 描述符不会消耗 Node 行预算。如果保留的计划仍超过上限,则仅按构建和并发要求对变更目标块进行分区,然后按预测秒数平衡到剩余行中,同时保留每个已选目标。无法适配这些独立策略的计划,或其他所有者已填满上限的计划,仍会在预检中失败。
显式选择的插件测试保留其规范配置、native-loader 隔离、worker 策略和分组计时。仅发布开关控制完整的插件扫描,而不是其所有者元数据的可用性;无关 PR 仍不会获得该扫描。
激进的 PR 冒烟测试选择两个完整的现有文件:src/config/io.load-async.test.ts 用于冷配置加载和元数据准入,以及 src/plugins/loader.runtime-registry.test.ts 用于插件加载和注册表生命周期。它们保留其规范配置和断言,并最多占用两个 Node 行。全量选择紧急停止开关保留先前的六文件冒烟清单,包括 Gateway 服务、配置兼容性和迁移,以及 message-tool 投递。全部六个仍会在每小时 main 上运行。
PR_EXEMPT_RUNTIME_TEST_FILES 清单位于 scripts/lib/ci-proof-test-inventory.mts,它将实测的慢速集成测试排除在无关的规范 PR 和精确 head PR 回退分发之外。每小时 main 和 Full Release Validation 通过其规范所有者选择这些完整文件:常规 CI 拥有核心、UI 和工具测试;Plugin Prerelease 在其每小时计划和发布活动中拥有完整的扩展运行时清单。独立手动 CI 保留其核心清单;运行 Plugin Prerelease 以获得扩展覆盖。每小时 main 包含完整的工具清单,因此在 PR 选择收窄后,延迟测试和受保护回归都能保留其规范所有者。直接测试编辑和所选主题所有者通过现有的变更目标所有者和传递导入图,将文件重新纳入有界 PR 计划。仅缺失/已删除测试和宽泛未解析输入本身不会启用该清单。缩减组保留不同的计时标识以及原始配置、前置条件、进程隔离、worker 限制、用例和断言。该层级独立于旧的仅发布运行时清单;工具家族现在也每小时运行。清单所有者仅枚举所选检出中为文件的已审计路径。已删除路径无需可运行所有者;每个有效条目仍要求恰好一个每小时和发布所有者。新增和重命名路径立即参与变更所有者选择;单独的审计决定其是否纳入此显式延迟清单。从实测 PR 运行中选择完整的集成、进程、语料库或迁移套件,同时在 PR 上保留其聚焦所有者测试。在添加豁免之前,检查最近的产品修复,包括因测试拆分而移动的回归。每小时 GitHub 托管计划复用现有的完整紧凑清单和串行工具打包器。完整文件估算使用托管成本比例;Blacksmith 进程观测保留在 Blacksmith。打包保留每个子组、其两个 worker 限制和超时,同时保持完整 Node 矩阵在 77 行主层级上限内。在同一托管 runner 上执行的工具组可以共享一行,同时保留最强的原始容量所有者。显式源监视位于 scripts/lib/ci-policy-test-watch.mts,包括动态启动的 worker 和导入图无法发现的脚本。
显式策略监视即使在更广泛的工具或运行时套件被延迟时,也会保留其匹配测试在 PR CI 中。这包括 wrapper 依赖检查、Gateway 客户端调用点扫描,以及升级幸存包检查。无关的延迟测试保持排除。没有 Vitest 配置路由的变更测试文件,例如 skill node:test 和 Python 套件,永远不会是直接目标;其 Vitest wrapper 的监视也必须覆盖这些测试文件,否则仅测试编辑不会在任何 PR 作业中运行。
激进的 PR 选择保留变更测试和直接运行时导入消费者,包括包和 SDK 别名。直接导入者少于 20 个的变更模块还会选择深度二处的测试;枢纽在直接消费者处停止。变更包还会选择直接的包说明符测试消费者;该路径不会通过包读取器重启遍历,并绕过模块枢纽截止。被擦除的类型导入仍由类型检查拥有。
仅当目录最多包含 30 个测试文件时,才会选择同目录测试。更大的扁平目录使用现有的显式所有者映射和名称前缀兄弟文件(foo.ts 选择 foo*.test.ts),不会递归选择子目录。现有的 fixture、生成输入和非导入策略所有者保持显式。配置变更保留其规划器/守卫所有者,而不是选择整个配置清单。受保护/延迟测试遵循这些相同规则,而不是纳入整个所有者区域。
预检作业摘要列出每个所选文件及其选择规则。设置仓库变量 OPENCLAW_CI_NODE_SELECTION=full 可立即恢复先前的 PR 选择。每小时 main 和常规手动/发布计划无论该变量如何,都保留其完整清单。
源模块编辑还会选择六个显式非导入守卫:PR 包装器源闭包、包装器配置、急切导入闭包、更新器交换测试夹具依赖、类型抑制清单,以及插件 SDK 表面报告。这种保守监控会覆盖新增、重命名和删除的模块,以及新的导入边,包括清单中缺失但本应列出它们的依赖项。现有必需架构组仍会检查源差异中的导入循环和拓扑变化。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw