测试

适用场景

在以下情况下使用本页面：

• 运行或修复测试

• 完整测试工具包（套件、live、Docker）：Testing

• pnpm test:force：杀死任何占用默认控制端口的持久网关进程，然后使用隔离的网关端口运行完整的 Vitest 套件，以便服务器测试不会与正在运行的实例冲突。当先前的网关运行导致端口 18789 被占用时，请使用此命令。

• pnpm test:coverage：使用 V8 覆盖率运行 Vitest。全局阈值为 70% 的行/分支/函数/语句。覆盖率排除了集成繁重的入口点（CLI 连接、网关/telegram 桥接、webchat 静态服务器），以保持目标专注于可单元测试的逻辑。

• pnpm test:e2e：运行网关端到端冒烟测试（多实例 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

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

QR 导入冒烟测试（Docker）

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

pnpm test:docker:qr