Files
bot/docs/zh-CN/reference/test.md
zeekay 6e661b15d3 rebrand: complete OpenClaw→Hanzo Bot cleanup across 424 files
- Rename lobster extension → flow (dir, types, env vars, docs)
- LOBSTER_* env vars → BOT_FLOW_* / BOT_*
- 🦞 → 🤖 everywhere (src, docs, skills, zh-CN)
- docs.bot.ai → docs.hanzo.bot
- github.com/bot/bot → github.com/hanzoai/bot
- @bot/* → @hanzo/bot-* (npm scope)
- ~/.bot/ → ~/.hanzo/bot/ (config paths)
- discord.gg/hanzo → discord.gg/XthHQQj (real Hanzo Discord)
- clawhub.com → skills.hanzo.bot
- ClawDock → BotDock in shell helpers
- EXFOLIATE lore → Hanzo Bot branding in all locales
- LOBSTER_PALETTE → BOT_PALETTE, LOBSTER_ASCII → BOT_ASCII
2026-02-13 13:22:53 -08:00

2.3 KiB
Raw Permalink 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-03T10:09:52Z 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)

新手引导 E2E(Docker)

Docker 是可选的;这仅用于容器化的新手引导冒烟测试。

在干净的 Linux 容器中完整的冷启动流程:

scripts/e2e/onboard-docker.sh

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

QR 导入冒烟测试(Docker)

确保 qrcode-terminal 在 Docker 中的 Node 22+ 下加载:

pnpm test:docker:qr