54-复现实验清单 Template v1.0 | 第0章 前言与使用说明

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

第0章 前言与使用说明

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

• 定义“最小可复现包”的判定标准、组成与验收口径，覆盖环境锁定、数据快照与血缘、权重与参数、新鲜度策略、脚本与命令、指标与区间、质量门映射与发布清单。
• 凡涉及路径量（到达时/相位），正文显式路径 gamma(ell) 与测度 d ell，数据侧记录 delta_form ∈ {general, factored}；所有表达括号化，发布要求 p_dim = 1.0 并随附 check_dim_report.json。

II. 判定标准（Reproducibility Criteria）

• 工件等价：指定清单中的文件/目录与 checksum/signature 一致。
• 指标等价：主/辅指标与区间相符（覆盖模式三选一：k/alpha/quantile），差异在容忍阈内。
• 流程等价：以提供的 reproduce.sh/Makefile 在受控环境一次运行完成，并产出与清单一致的制品。
• 量纲闭合：所有计算在目标与单位层面一致（I70-dim_check 通过，p_dim = 1.0）。

III. 适用读者与执行前置（Audience & Prerequisites）

• 读者：研发/评测工程师、平台与运维、合规与审计人员。
• 前置：容器/驱动/框架与硬件资源可用，访问数据与权重的凭据已配置；clock_state="locked"，|ts_start − calib.timestamp| ≤ τ_calib。

IV. 组成与路径（Bundle & Layout）

• 根目录：PTN_EXPORT/。
• 必备子目录：model/、inference/、uq/、eval/、monitoring/、reports/、figs/，及签名 SIGNATURE.asc 与 report_manifest.yaml。
• 所有文件提供 sha256 校验和并在清单内登记。

V. 质量门与停止（Gates & Stops）

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

VI. 交叉引用（Cross-References）

• 《数据集卡 Template v1.0》：Ch.3/4/6/7/8/10/11/12（来源/Schema/Splits/QC/UQ/API/Bench）。
• 《模型卡 Template v1.0》：Ch.6/7/8/10/11/12（训练/UQ/Bench/部署/性能/监控）。
• 《误差预算卡 Template v1.0》：Ch.5/6/8/9（协方差/传播/区间/阈值）。
• 《管线卡 Template v1.0》：Ch.3/4/6/9/12（DAG/契约/阶段/质量门/发布）。
• 《参数注册卡 Template v1.0》：Ch.4/6/8/9/10/11（单位/新鲜度/协方差组/接口）。

VII. 输出与清单（Deliverables & Manifests）

• 清单索引：repro_manifest.yaml（版本、依赖、入口、校验和、签名）。
• 环境锁定：env_lock.json、container_spec.yaml。
• 数据血缘：data_refs.yaml、split_manifest.json。
• 权重参数：weights_manifest.yaml、param_lock.yaml。
• 脚本命令：reproduce.sh、Makefile。
• 评测与评分：bench_plan.yaml、scorecard.json、eval_report.md。
• UQ 与误差：model_uq.yaml、uq_summary.json、budget_breakdown.csv。
• 监控回退：monitoring_rules.yaml、rollback_fsm.yaml、alerts.jsonl。
• 报告：check_dim_report.json、validate_report.json、audit.jsonl。

VIII. 路径量统一口径（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。

IX. 执行方式（Execution Modes）

• 本地：bash reproduce.sh；
• 容器：docker compose up / podman run（镜像与标签见 container_spec.yaml）；
• 云端：提供 Terraform/Helm 清单与最小配额说明。
• 任一模式均需在 audit.jsonl 记录输入哈希、时间戳与运行摘要。

X. 勾选清单（Checklist）

• repro_manifest.yaml 与 report_manifest.yaml 就绪，所有制品具 checksum/signature。
• 环境锁定文件已生成并可一键拉起；clock_state="locked"、τ_calib 合规。
• 数据快照与切分一致，路径块显式 gamma/measure/delta_form；I70-dim_check 通过，p_dim = 1.0。
• 覆盖模式在数据/模型/误差/管线四卷统一（k/alpha/quantile）；Σ PD。
• reproduce.sh/Makefile 可复现实验并产出等价曲线、区间与评分；/validate 通过 G1–G8；不合规项已按 [Restricted] 标注与处置。