hyb-oa/docs/ops/ci-regression-reporting.md

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 中使用：

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