Regression

回归测试教程：从零到发版门禁

本页用于执行完整验证链路：单元测试、冒烟测试、CLI 行为回归。

1. 快速质量门

make cli-quality

执行项目配置的格式化、lint 与静态检查。

2. 工作区测试

cd cli
cargo test --workspace

3. 完整脚本化回归（推荐）

cd cli
./scripts/run_regression_suite.sh

报告写入 cli/reports/。

4. 新手友好的端到端脚本

cd cli
./scripts/tutorial_regression.sh

该脚本会创建隔离临时项目，验证目录/channels/gateway/system 全链路并输出报告。

5. 可选真实 provider 冒烟

export OPENAI_API_KEY=<your_key>
cd cli
LIVE=1 \
BASE_URL=https://api.openai.com \
MODEL=gpt-4o-mini \
./scripts/tutorial_regression.sh

开启 LIVE=1 后，脚本会额外执行 setup、models list、ask。

6. JSON 契约检查

mosaic --project-state --json status
mosaic --project-state --json channels list
mosaic --project-state --json gateway probe
mosaic --project-state --json doctor

7. 发版门禁清单

• cargo test --workspace 全通过。
• 回归脚本无非 0 退出。
• 主通道 test/send 链路健康。
• gateway probe 与 call status 成功。
• --json 输出可稳定供 CI 解析。

8. 回归失败排查

mosaic --project-state doctor
mosaic --project-state logs --tail 200
mosaic --project-state channels status
mosaic --project-state gateway status --deep