From 40fb7f1ff22b34b01f656dd863bb52b20506c6a2 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Wed, 29 Apr 2026 02:20:09 +0000 Subject: [PATCH] chore(i18n): refresh zh-CN translations --- docs/zh-CN/reference/test.md | 96 ++++++++++++++++++------------------ 1 file changed, 49 insertions(+), 47 deletions(-) diff --git a/docs/zh-CN/reference/test.md b/docs/zh-CN/reference/test.md index b32eeb202..634022158 100644 --- a/docs/zh-CN/reference/test.md +++ b/docs/zh-CN/reference/test.md @@ -1,52 +1,54 @@ --- read_when: - 运行或修复测试 -summary: 如何在本地运行测试（vitest）以及何时使用强制/覆盖率模式 +summary: 如何在本地运行测试（vitest），以及何时使用强制/覆盖率模式 title: 测试 x-i18n: - generated_at: "2026-04-29T00:20:52Z" + generated_at: "2026-04-29T02:19:08Z" model: gpt-5.5 provider: openai - source_hash: 0bf625bfce2734761deb81fea566413e96f86709bdfba3b72a9afb6e7e75719f + source_hash: 9328d6f0383b5067fa8bb5d0f1bf22a3b9048a267908bf85167842ddc3d12e42 source_path: reference/test.md workflow: 16 --- -- 完整测试工具包（套件、live、Docker）：[测试](/zh-CN/help/testing) +- 完整测试工具包（测试套件、真实环境测试、Docker）：[测试](/zh-CN/help/testing) -- `pnpm test:force`：终止所有仍占用默认控制端口的 Gateway 网关进程，然后使用隔离的 Gateway 网关端口运行完整 Vitest 套件，避免服务器测试与正在运行的实例冲突。当之前的 Gateway 网关运行留下端口 18789 被占用时使用此命令。 -- `pnpm test:coverage`：使用 V8 覆盖率运行单元套件（通过 `vitest.unit.config.ts`）。这是已加载文件的单元覆盖率门禁，不是整个仓库的全文件覆盖率。阈值为 70% 行/函数/语句和 55% 分支。由于 `coverage.all` 为 false，该门禁衡量单元覆盖率套件加载的文件，而不是把每个拆分车道源文件都视为未覆盖。 -- `pnpm test:coverage:changed`：仅对自 `origin/main` 以来更改的文件运行单元覆盖率。 -- `pnpm test:changed`：低成本的智能变更测试运行。它会根据直接测试编辑、同级 `*.test.ts` 文件、显式源映射和本地导入图运行精确目标。宽泛/配置/包更改会被跳过，除非它们能映射到精确测试。 +- `pnpm test:force`：终止任何占用默认控制端口的遗留 Gateway 网关进程，然后使用隔离的 Gateway 网关端口运行完整 Vitest 套件，避免服务器测试与正在运行的实例冲突。当之前的 Gateway 网关运行导致端口 18789 被占用时使用此命令。 +- `pnpm test:coverage`：使用 V8 覆盖率运行单元套件（通过 `vitest.unit.config.ts`）。这是已加载文件的单元覆盖率门禁，不是整个仓库所有文件的覆盖率。阈值为 70% 行/函数/语句和 55% 分支。因为 `coverage.all` 为 false，该门禁衡量的是单元覆盖率套件加载的文件，而不是把每个拆分车道的源文件都视为未覆盖。 +- `pnpm test:coverage:changed`：只为自 `origin/main` 以来发生变更的文件运行单元覆盖率。 +- `pnpm test:changed`：廉价的智能变更测试运行。它会从直接测试编辑、同级 `*.test.ts` 文件、显式源映射以及本地导入图运行精确目标。宽泛/配置/包变更会被跳过，除非它们映射到精确测试。 - `OPENCLAW_TEST_CHANGED_BROAD=1 pnpm test:changed`：显式的宽泛变更测试运行。当测试 harness/配置/包编辑应回退到 Vitest 更宽泛的变更测试行为时使用。 -- `pnpm changed:lanes`：显示相对于 `origin/main` 的 diff 触发的架构车道。 -- `pnpm check:changed`：针对相对于 `origin/main` 的 diff 运行智能变更检查门禁。它会为受影响的架构车道运行类型检查、lint 和 guard 命令，但不会运行 Vitest 测试。测试证明请使用 `pnpm test:changed` 或显式的 `pnpm test `。 -- `pnpm test`：通过带作用域的 Vitest 车道路由显式文件/目录目标。无目标运行会使用固定分片组，并展开为叶子配置以便本地并行执行；插件组始终展开为每个插件的分片配置，而不是一个巨大的根项目进程。 -- 测试包装器运行会以简短的 `[test] passed|failed|skipped ... in ...` 摘要结尾。Vitest 自身的持续时间行仍保留每个分片的细节。 -- 共享 OpenClaw 测试状态：当测试需要隔离的 `HOME`、`OPENCLAW_STATE_DIR`、`OPENCLAW_CONFIG_PATH`、配置 fixture、工作区、智能体目录或 auth-profile 存储时，在 Vitest 中使用 `src/test-utils/openclaw-test-state.ts`。对于需要运行中 Gateway 网关的进程级 E2E 测试，使用 `test/helpers/openclaw-test-instance.ts`，让状态、配置、CLI 环境、Gateway 网关启动、日志捕获和清理保持在一起。会 source `scripts/lib/docker-e2e-image.sh` 的 Docker/Bash E2E 车道可以把 `docker_e2e_test_state_shell_b64