50-参数注册卡 Template v1.0 | 第1章 适用范围与依赖

目录 ／ 文档-技术白皮书（V5.05） ／ 50-参数注册卡 Template v1.0

第1章 适用范围与依赖

I. 适用范围（Scope of Use）

• 参数类型：物理常量（c_ref、λ_ref、k_ref）、计量/标定参数（τ_sys、Δτ_ch、PSF、gain）、算法超参（阈值/正则/迭代步长）、环境参数（α_T、ΔT、湿度/压强）、几何与时基参数（q_att、FOV、f_s、t_exp）。
• 工作域：近轴小角、缓变介质，相干窗 T_coh/L_coh/B_coh 内满足 |∇ n_eff|·L_coh ≪ 1；发布要求 p_dim = 1.0。
• 路径量强制：凡涉及 T_arr/Phi 的参数（如 n_eff(ell)、路径相关权重等），正文显式 gamma(ell) 与测度 d ell，并在卡片数据侧记录 delta_form ∈ {general, factored}。
• 非适用：无单位/量纲的临时变量，或缺乏血缘/新鲜度策略的瞬态量（仅作为内部中间量，不入注册）。

II. 参数场景矩阵（Scenarios & Examples）

统一口径（示例）：
T_arr = ( 1 / c_ref ) * ( ∫ n_eff d ell ) 或 T_arr = ( ∫ ( n_eff / c_ref ) d ell )；
Phi = ( 2π / λ_ref ) * ( ∫ n_eff d ell )。

III. 依赖与对齐（Dependencies & Alignment）

• Core（必备）：EFT.WP.Core.Terms v1.0、EFT.WP.Core.Equations v1.1、EFT.WP.Core.Metrology v1.0、EFT.WP.Core.DataSpec v1.0。
  见：《Core.Equations v1.1》Ch.2 S20-1/S21-2；《Core.Metrology v1.0》check_dim；《Core.DataSpec v1.0》TARR。
• Metrology/Methods（强依赖）：Metrology.TimeBase v1.0、Metrology.Sync v1.0、Metrology.Instrument v1.0、Metrology.PathCorrection v1.0、Methods.Repro v1.0。
• 配套模板对齐：PTN Template v1.0（Ch.5/Ch.11）、实验协议卡 Template v1.0（Ch.5/Ch.7）、误差预算卡 Template v1.0（Ch.5/Ch.8/Ch.9）。

IV. 引用与版本（Citations & Versioning）

• 固定写法：见《<卷名> vX.Y》<章节> <锚点>，优先 P/S/M/I；正文与数据侧 see[]/references[] 一致。
• 稳定线：对外仅引用 v1.*；若引用 v0.*，在文内显著标注“草案/非承诺”。
• 覆盖率：锚点直指率 ≥ 90%，禁止外链与别名；版本语义采用 SemVer。

V. 前置条件与合规（Preconditions & Compliance）

• 量纲闭合：参数表达式经 I70-dim_check 校核，p_dim = 1.0，随附 check_dim_report.json。
• 新鲜度：|ts_start − calib.timestamp| ≤ τ_calib；clock_state=locked；逾期进入限制模式或触发再标定。
• 路径一致性：len(gamma_ell) = len(d_ell) = len(n_eff) ≥ 2；Δell 满足采样约束。
• 符号与冲突名：禁止裸用 c、T、n；统一 c_ref、T_arr（或具体量名）、n_eff（或 n 且明示单位）；T_fil ≠ T_trans，n ≠ n_eff。

VI. 产出与接口（Outputs & Interfaces）

1. 必交付：param_registry.csv、param_card.yaml、params_schema.json、check_dim_report.json、audit.jsonl。
2. 接口（建议）：
   • I20-register_param(card) -> {ok, param_id}
   • I21-validate_param(card, gates) -> report.json
   • I22-resolve_param(param_id, at_ts) -> {value, unit, lineage, freshness}
   • I25-check_freshness(param_id) -> {ok, ttl, policy}
   • I26-export_contract(fmt) -> {schema, openapi}

VII. 执行勾选清单（Checklist）

• 已确认参数类型与工作域；路径量显式 gamma(ell)、d ell，并记录 delta_form。
• 依赖卷与锚点齐备；see[]/references[] 合规且锚点直指率 ≥ 90%。
• check_dim_report.json 通过；clock_state=locked、τ_calib 合规；len(path) ≥ 2、Δell 合格。
• param_registry.csv / param_card.yaml / params_schema.json / audit.jsonl 已生成并签名；checksum 唯一。
• 版本与状态明确（SemVer，status ∈ {draft, stable, deprecated}）；禁止裸用与冲突名混用。