54-复现实验清单 Template v1.0 | 第1章 清单总览与适用范围

目录 ／ 文档-技术白皮书（V5.05） ／ 54-复现实验清单 Template v1.0

第1章 清单总览与适用范围

I. 目标与范围（Purpose & Scope）

• 定义**最小可复现包（MRB）**的组成、边界与验收口径，覆盖环境锁定、数据快照与血缘、权重与参数、新鲜度策略、脚本与命令、指标与区间、质量门映射与发布清单。
• 适用：本地/容器/云三种执行模式；模型训练/推理复现、离线评测与上线回归复核。
• 凡涉及路径量（到达时/相位），正文显式路径 gamma(ell) 与测度 d ell，数据侧记录 delta_form ∈ {general, factored}；所有表达括号化，发布要求 p_dim = 1.0 并随附 check_dim_report.json。

II. 清单最小集合（Minimal Bundle）

• 环境锁定：env_lock.json、container_spec.yaml（硬件/OS/驱动/框架/镜像/时钟源）。
• 数据快照：data_refs.yaml、split_manifest.json（来源/Schema/切分/校验和/许可）。
• 权重与参数：weights_manifest.yaml、param_lock.yaml（签名/版本/新鲜度/cov_group）。
• 训练与推理：train_config.yaml、inference_openapi.yaml、inference.proto、binding_spec.md。
• UQ 与误差预算：model_uq.yaml、uq_summary.json、budget_breakdown.csv（覆盖 k/alpha/quantile 三选一且全卷一致）。
• 评测与评分：bench_plan.yaml、scorecard.json、eval_report.md。
• 监控与回退：monitoring_rules.yaml、rollback_fsm.yaml、alerts.jsonl。
• 报告与签名：check_dim_report.json、validate_report.json、audit.jsonl、report_manifest.yaml、SIGNATURE.asc。

根目录：PTN_EXPORT/；所有制品登记 sha256 与签名。

III. 适用范围与限制（Scope of Use & Limits）

• 适用：与《数据集卡》《模型卡》《误差预算卡》《管线卡》《参数注册卡》一致的工程/研究复现、对比评测与发布校核。
• 限制：缺失路径块（gamma/measure/delta_form）、clock_state!="locked"、p_dim < 1 或跨卷覆盖口径不一致时，清单标注 [Restricted]，仅允许定性核对。

IV. 依赖矩阵（Dependency Matrix）

V. 版控与签名（Versioning & Signatures）

• 采用 SemVer：MAJOR（破坏性变更：Schema/单位/量纲/控制式）、MINOR（向后兼容新增）、PATCH（修补）。
• 清单中记录每个制品的 checksum 与签名；回退点以 *-lock 标签固定；对外仅允许引用 v1.*。

VI. 质量门映射（Gate Mapping）

• G1 Schema 完整｜G2 引用合规（锚点直指率 ≥ 90%）｜G3 路径规范（gamma/measure/delta_form 齐备，步长合规）｜G4 量纲闭合（p_dim = 1.0）｜G5 新鲜度（clock_state="locked"）｜G6 覆盖一致（k/alpha/quantile）｜G7 协方差一致（Σ PD）｜G8 唯一性与无环。
• 触发 S1–S5（量纲/新鲜度/路径/协方差/引用）即拒绝验收或标注 [Restricted]。

VII. 到达时/相位规范（Normative Path Forms）

• 到达时（两式等价）：
  T_arr = ( 1 / c_ref ) * ( ( ∫ n_eff d ell ) )
  T_arr = ( ( ∫ ( n_eff / c_ref ) d ell ) )
• 相位：
  Phi = ( ( 2π / λ_ref ) * ( ∫ n_eff d ell ) )

复现计算前按“时间→路径→相位”顺序对齐；数组满足 len(gamma_ell)=len(d_ell)=len(n_eff)≥2；数据侧记录 delta_form。

VIII. 机读索引（Machine-Readable Index）

# repro_manifest.yaml（示例）

version: "1.0.0"

entrypoints:

train: "reproduce.sh train"

infer: "reproduce.sh infer"

eval: "reproduce.sh eval"

artifacts:

env: ["env_lock.json","container_spec.yaml"]

data: ["data_refs.yaml","split_manifest.json"]

model: ["train_config.yaml","weights_manifest.yaml","param_lock.yaml"]

api: ["inference_openapi.yaml","inference.proto","binding_spec.md"]

uq: ["model_uq.yaml","uq_summary.json","budget_breakdown.csv"]

bench: ["bench_plan.yaml","scorecard.json","eval_report.md"]

monitor: ["monitoring_rules.yaml","rollback_fsm.yaml","alerts.jsonl"]

reports: ["check_dim_report.json","validate_report.json","audit.jsonl","report_manifest.yaml","SIGNATURE.asc"]

checksums:

sha256: "checksums.txt"

IX. 执行与验收（Execution & Acceptance）

• 执行：本地/容器/云任一模式完成 train → infer → eval → compare 全流程，并在 audit.jsonl 落日志。
• 验收：指标/区间与清单一致；/validate 通过 G1–G8；所有制品校验和/签名匹配；异常按 [Restricted] 处置并附诊断。

X. 勾选清单（Checklist）

• repro_manifest.yaml 与 report_manifest.yaml 完整，所有制品具 checksum/signature。
• 环境可一键拉起；clock_state="locked"、|ts_start − calib.timestamp| ≤ τ_calib。
• 数据快照/切分一致；路径块显式 gamma/measure/delta_form；I70-dim_check 通过，p_dim = 1.0。
• 覆盖模式统一（k/alpha/quantile），Σ PD；跨卷口径完全一致。
• reproduce.sh/Makefile 能产出等价曲线/区间/评分；/validate 通过 G1–G8；不合规项按 [Restricted] 标注与处置。