Files

Josh Palmer 5676a6b38d Docs: normalize zh-CN terminology + tone

What: switch to 你/你的 tone; standardize Skills/Gateway网关/local loopback/私信 wording
Why: align zh-CN docs with issue 6995 feedback + idiomatic tech style
Tests: pnpm docs:build

2026-02-02 16:38:25 +01:00

2.4 KiB

Raw Blame History

read_when, summary, title, x-i18n

read_when

summary

title

x-i18n

运行或修复测试

如何在本地运行测试（vitest）以及何时使用 force/coverage 模式

测试

generated_at	model	provider	source_hash	source_path	workflow
2026-02-01T21:38:10Z	claude-opus-4-5	pi	be7b751fb81c8c94b1293624bdca6582e60a26084960d1df9558061969502e6f	reference/test.md	15

测试

完整测试套件（套件、实时测试、Docker）：测试
pnpm test:force：终止任何占用默认控制端口的残留 Gateway网关进程，然后使用隔离的 Gateway网关端口运行完整的 Vitest 套件，避免服务器测试与正在运行的实例冲突。当之前的 Gateway网关运行导致端口 18789 被占用时使用此命令。
pnpm test:coverage：使用 V8 覆盖率运行 Vitest。全局阈值为 70% 的行/分支/函数/语句覆盖率。覆盖率排除了集成度较高的入口文件（CLI 连接、gateway/telegram 桥接、webchat 静态服务器），以保持目标聚焦于可单元测试的逻辑。
pnpm test:e2e：运行 Gateway网关端到端冒烟测试（多实例 WS/HTTP/节点配对）。
pnpm test:live：运行提供商实时测试（minimax/zai）。需要 API 密钥和 LIVE=1（或提供商特定的 *_LIVE_TEST=1）才能取消跳过。

模型延迟基准测试（本地密钥）

脚本：scripts/bench-model.ts

用法：

source ~/.profile && pnpm tsx scripts/bench-model.ts --runs 10
可选环境变量：MINIMAX_API_KEY、MINIMAX_BASE_URL、MINIMAX_MODEL、ANTHROPIC_API_KEY
默认提示词："Reply with a single word: ok. No punctuation or extra text."

最近一次运行（2025-12-31，20 次）：

minimax 中位数 1279ms（最小 1114，最大 2431）
opus 中位数 2454ms（最小 1224，最大 3170）

新手引导端到端测试（Docker）

Docker 是可选的；仅在需要容器化新手引导冒烟测试时使用。

在干净的 Linux 容器中执行完整的冷启动流程：

scripts/e2e/onboard-docker.sh

此脚本通过伪终端驱动交互式向导，验证配置/工作区/会话文件，然后启动 Gateway网关并运行 openclaw health。

QR 导入冒烟测试（Docker）

确保 qrcode-terminal 在 Docker 中的 Node 22+ 环境下正常加载：

pnpm test:docker:qr

2.4 KiB Raw Blame History Unescape Escape

测试

模型延迟基准测试（本地密钥）

新手引导端到端测试（Docker）

QR 导入冒烟测试（Docker）

2.4 KiB

Raw Blame History