39 行
1.1 KiB
Markdown
39 行
1.1 KiB
Markdown
# CI 回归报告归档说明（P13-6）
|
||
|
||
更新时间：2026-02-12
|
||
|
||
## 目标
|
||
|
||
在 `ci-regression` 流水线中产出并归档结构化回归报告，确保每次回归可追溯到具体 `run_id` 与 `commit SHA`。
|
||
|
||
## 产物
|
||
|
||
- 回归脚本输出：`/tmp/hyb-oa-regression/report.json`
|
||
- Artifact 名称：`regression-report-<run_id>-<sha>`
|
||
- JSON 契约：`schema_version = "1.0"`
|
||
|
||
## 字段约定
|
||
|
||
报告包含以下关键字段：
|
||
|
||
- `schema_version`
|
||
- `generated_at`
|
||
- `git.sha`
|
||
- `git.branch`
|
||
- `overall.status | duration_ms | passed | failed | skipped | total`
|
||
- `steps[]`：`id | name | enabled | status | exit_code | duration_ms | started_at | ended_at | command`
|
||
|
||
## 回归命令
|
||
|
||
在 CI 中使用：
|
||
|
||
```bash
|
||
RUN_AUDIT_REGRESSION=1 RUN_OCR_REGRESSION=1 ./scripts/regression-all.sh --json-report /tmp/hyb-oa-regression/report.json
|
||
```
|
||
|
||
## 排障建议
|
||
|
||
- 回归失败时优先下载 artifact，检查 `overall.failed` 与 `steps[].status="failed"`。
|
||
- 若报告未生成，检查回归步骤是否在脚本启动前失败（例如服务未就绪）。
|
||
- 若报告字段缺失，优先比对 `server/scripts/lib/regression-report.sh` 与 schema 版本。
|