56-报告级方法附录 Template v1.0 | 第1章 前言与定位

目录 ／ 文档-技术白皮书（V5.05） ／ 56-报告级方法附录 Template v1.0

第1章 前言与定位

I. 目的与定位（强制）

• 定义“报告级方法附录”的角色：以可复现、可审计、可回放为目标，沉淀每一项方法在理论—数学—计量—实现四层的最小闭环。
• 为配套白皮书正文提供方法条目化与机读落地的统一接口（人读正文 × 机读 YAML/JSON 等价）。
• 作为跨卷一致性的判据与依赖清单来源，确保跨团队协作时口径统一、证据链完整。

II. 适用范围与非目标（强制）

• 适用：方法定义、推导要点（S/P）、数学表述、算法与伪代码、数据与实验设计、计量与校准（M）、评测协议与门禁、实现绑定（I）、复现实验与工件导出。
• 非目标：组织流程、人事权限、预算与商务条款；历史变更编年；宏观路线宣介。

III. 读者与角色（强制）

• 读者：方法与计量负责人、实现绑定负责人、数据与管线负责人、审计与发布管理者、卷主编。
• 角色：提出者（Requester）、编撰者（Author）、评审者（Reviewer）、裁决者（Approver/Owner）、实现者（Implementer）、审计者（Auditor）。

IV. 输出与工件（强制）

• 人读：方法条目正文（章节骨架统一）、图表与伪代码、评测与结论、风控与回滚入口。
• 机读：方法清单 method.*、评测与门禁 evaluation.*、计量与校准 metrology.*、实现与复现 impl.* / reproducibility.*、引用清单 references.see[]。
• 导出：yaml/json/pdf 三种工件，含证据哈希与签署信息。

V. 依赖与交叉引用（默认引用集，强制）

1. 固定写法：“见《<卷名> vX.Y》Ch.x S/P/M/I…”，优先锚点而非整卷。
2. 默认可直接引用：
   • 《EFT.WP.Core.Terms v1.0》（术语与符号域，P10-*）
   • 《EFT.WP.Core.Equations v1.1》（最小方程组，S20-*）
   • 《EFT.WP.Core.Metrology v1.0》（量纲/单位/不确定度，check_dim）
   • 《EFT.WP.Core.DataSpec v1.0》（数据契约与导出字段，I30-*）

VI. 全局写作与排版体例（强制）

• 小节标题用罗马数字并加粗；项目符号“- 空格”；编号列表“1. 空格”。
• 内联符号统一反引号包裹：phi(x,t)、Xi(x,t)、K、Q、T_fil、T_trans、n_eff。
• 含除号、积分或复合算符的表达一律加括号并显式声明路径 gamma(ell) 与测度 d ell。
• 统一编号：Pxx-?（公设）、Sxx-?（最小方程）、Mx-?（计量流程）、Ixx-?（实现绑定）。
• 禁混：T_fil≠T_trans，n≠n_eff，c≠c_ref；公式、符号、定义禁用中文。

VII. 统一数学与符号口径（强制）

1. 到达时两口径（跨卷通用判据）：
   • 常量外提：T_arr = ( 1 / c_ref ) * ( ∫ n_eff d ell )
   • 一般口径：T_arr = ( ∫ ( n_eff / c_ref ) d ell )
2. 任一条目出现 T_arr，同段或紧邻段给出 gamma(ell) 与 d ell 的定义或引用其锚点，并在机读层登记 delta_form。
3. 量纲一致性：关键方程标注 check_dim=true，并在计量段落给出单位/维度与不确定度口径。

VIII. 文档结构与阅读地图（强制）

• 每个方法条目遵循骨架：方法名称与定位 → 理论要点（S/P） → 数学表述（含符号表） → 算法与伪代码 → 数据与实验设计 → 计量与校准（M） → 评测协议与门禁 → 不确定度与检验 → 消融与敏感性 → 实现绑定（I） → 可复现与工件 → 风险与回滚入口 → 引用与交叉引用。
• 人读正文与机读清单一一对位：段落与 method.* / evaluation.* / metrology.* / impl.* / references.see[] 字段互相映射。

IX. 质量门与校核点（最小集合，强制）

• 引用门：EFT.WP.* 必须“卷名+版本+锚点”；references.see[] 机读可解析。
• 量纲门：出现方程处 check_dim=true；单位/量纲/不确定度给全。
• 复现门：script@commit、dataset@version、容器镜像与最小复现命令齐备；第三方环境复跑通过。
• 门禁（gates）门：gate_<metric><comparator><threshold>@<window> 命名统一，硬门禁未过不得进入结论。
• 回滚门：定义触发器（如 gate_accuracy<0.98@7d、compat_rate<0.99@replay）与复原验证通过线。

X. 使用方式与更新节奏（强制）

• 新方法进入附录前需完成：条目骨架、人机对位、门禁清单与复现实验；通过编撰者与评审者会签后纳入发布。
• 更新遵循“主干稳定线 v1.* / 草案线 v0.*”策略；涉及 Breaking 需在条目中提供 version_range 与 fallback，并设观察窗口。