# 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 版本。