48-实验协议卡 Template v1.0 | 第0章 前言与使用说明

目录 ／ 文档-技术白皮书 ／ 48-实验协议卡 Template v1.0

第0章 前言与使用说明

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

• 目标：提供面向执行的一页式实验/观测协议卡写作规范与交付清单，确保跨设备、跨场景的可复现与可审计。
• 适用域：实验室/外场/远程观测的采样—同步—标定—执行—导出全流程；零阶近轴、小角、缓变介质的常规任务。
• 非适用域：超出相干窗的强非线性/强色散/全波耦合问题，仅可在限制模式下给出定性结论。
• 强依赖：Core.Terms v1.0、Core.Equations v1.1、Core.Metrology v1.0、Core.DataSpec v1.0、Metrology.* v1.0、Methods.Repro v1.0、PTN Template v1.0。

II. 写作体例与编号（Style & Numbering）

• 小节标题用罗马数字并加粗；项目符号用“- 空格”；编号列表用“1. 空格”。
• 统一编号：公设 Pxx-?、最小方程 Sxx-?、计量流程 Mx-?、实现绑定 Ixx-?。
• 跨卷引用固定写法：见《<卷名> vX.Y》<章节> <锚点>，优先直指 P/S/M/I 锚点。
• 内联符号一律用反引号包裹（如 phi(x,t)、Xi(x,t)、K、Q、T_fil、T_trans、n_eff）；任何带除号、积分或复合算符的表达一律加括号并显式声明路径 gamma(ell) 与测度 d ell。
• 冲突名强制：T_fil（张力）与 T_trans（透射系数）不可混用；n（数密度）与 n_eff（有效折射率）严格区分。
• 语种约束：公式、符号、定义禁用中文。

III. 到达时与相位的统一口径（可直接复用）

• 常量外提：T_arr = ( 1 / c_ref ) * ( ∫ n_eff d ell )
• 一般口径：T_arr = ( ∫ ( n_eff / c_ref ) d ell )
• 相位累计：Phi = ( 2π / λ_ref ) * ( ∫ n_eff d ell )
• 要求：正文显式 gamma(ell) 与 d ell，并在数据/元数据记录 delta_form ∈ {general, factored}；n_eff 无量纲，c_ref 单位 m/s，T_arr 单位 s，Phi 单位 rad。

IV. 引用规范与示例（Citations）

• 文内示例：见《EFT.WP.Core.Equations v1.1》Ch.2 S20-1、见《EFT.WP.Core.Metrology v1.0》check_dim。
• 数据侧 see: 示例：
• see:
• - "EFT.WP.Core.Equations v1.1:S20-1"
• - "EFT.WP.Core.Metrology v1.0:check_dim"
• - "EFT.WP.Core.DataSpec v1.0:TARR"
• 版本策略：对外发布仅引用 v1.*；如引用 v0.*，须在文内标注“草案/非承诺”。

V. 协议卡的组成（What This Card Must Contain）

• 目的与范围：任务目标、适用/非适用域、强依赖锚点表。
• 前置条件与输入：几何与时基、设备与材料、校准新鲜度、路径/测度、风险与合规。
• 执行步骤：编号流程与关键参数；T_arr/Phi 计算口径；必要的伪代码/流程图。
• 质量门与停止准则：G1–G8（Schema/引用/路径-测度/量纲/新鲜度/残差/守恒/唯一性）与回退策略。
• 数据记录与导出：字段表、manifest.yaml、schema.json、check_dim_report.json、audit.jsonl。
• 结果页与评分：核心指标（ΔT_arr、r_phi、ε_flux、p_dim、Q_res）、图表与 scorecard.json。
• 引用与版本锁定：正文与 see[]/references[] 一致，导出清单含 version。

VI. 与配套文档的衔接（Cross-Works Alignment）

• 与 PTN Template v1.0：对齐 Ch.3（几何与时基）、Ch.5（数据契约）、Ch.6（设计与采样）、Ch.7（不确定度）、Ch.10（结果与评分）、Ch.11（限制）。
• 与 Core.*：术语/方程/计量/数据口径统一；量纲闭合通过 I70-dim_check。
• 与 Metrology.*：TimeBase/Sync/Instrument/PathCorrection 用作校准与同步基准。
• 与 Methods.Repro v1.0：执行与复现的运行期约束与日志格式。

VII. 执行勾选清单（发布前核对）

• 文内与数据 see[]/references[] 为“卷名+版本+锚点”，直指率 ≥ 90%。
• 所有路径型表达显式 gamma(ell) 与 d ell，并记录 delta_form。
• p_dim = 1.0，clock_state = locked，τ_calib 合规。
• 采样满足 Δell 与 f_s 约束；窗函数与频段声明完整。
• 结果包包含 manifest.yaml / schema.json / check_dim_report.json / quality_report.json / audit.jsonl / scorecard.json。
• 禁止裸用 c、T、n；不混用 T_fil 与 T_trans、n 与 n_eff。