50-参数注册卡 Template v1.0 | 第0章 前言与使用说明

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

第0章 前言与使用说明

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

• 定义跨链路参数的命名、域与单位、血缘与新鲜度、校验与发布统一规范，确保参数在采集—计算—导出全流程中的一致性与可追溯。
• 适用：物理常量、标定参数、算法超参、环境与几何/时基参数等；与 PTN Template v1.0、实验协议卡 Template v1.0、误差预算卡 Template v1.0 对齐。
• 非适用：不具备可度量单位/量纲、或缺乏血缘与新鲜度策略的临时变量（此类仅可作为内部中间量，不进入注册卡）。

II. 读者与适用域（Audience & Applicability）

• 读者：参数所有者与维护人、计量与数据治理人员、审校与发布负责人、实现绑定/接口开发者。
• 适用域：与到达时 T_arr、相位 Phi、延时 τ_sys、通道偏置 Δτ_ch、参考量 c_ref/λ_ref、介质 n_eff 等相关的参数注册与发布。

III. 引用与版本策略（Citations & Versioning）

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

IV. 数学与路径口径（Normative 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 )
• 要求：凡注册涉及路径量的参数，正文显式路径 gamma(ell) 与测度 d ell；在卡片数据侧记录 delta_form ∈ {general, factored}；量纲闭合随附 check_dim_report.json，发布时 p_dim = 1.0。

V. 注册卡组成与字段（Card Composition）

• 最小字段：param_id（主键）、name、symbol、domain{type,unit,range,default,precision}、lineage（来源/仪器/作业）、freshness{valid_from,valid_to,policy}、uncertainty{type/estimate/distribution/coverage}、constraints{depends_on/derived}、cov_group、status{draft/stable/deprecated}、see[]/references[]/version。
• 样式规则：标识使用 snake_case；符号列使用国际短符号（如 c_ref、λ_ref、τ_sys）。

VI. 合规与质量门（Compliance & Gates）

• G4 量纲闭合：所有参数表达式与单位通过 I70-dim_check；p_dim = 1.0。
• G5 新鲜度：|ts_now − calib.timestamp| ≤ τ_calib 且 clock_state=locked；逾期进入限制模式或触发再标定。
• G2 引用合规：锚点直指率 ≥ 90%，无外链与别名。
• G8 唯一性：param_id 唯一，注册表 checksum 不重复。

VII. 产出与导出（Outputs & Exports）

• 必交付：param_registry.csv（注册表）、param_card.yaml（参数卡）、params_schema.json（模式）、check_dim_report.json（量纲）、audit.jsonl（审计）。
• 可选：gate_map.yaml（参数级门映射）、openapi.yaml（参数查询与解析接口片段）。

VIII. 依赖与交叉引用（Dependencies & Cross-Refs）

• 术语与量纲：见《EFT.WP.Core.Terms v1.0》P10-*、见《EFT.WP.Core.Metrology v1.0》check_dim。
• 控制式与路径：见《EFT.WP.Core.Equations v1.1》Ch.2 S20-1/S21-2。
• 数据契约与发布：见《EFT.WP.Core.DataSpec v1.0》TARR、PTN Template v1.0 Ch.5/Ch.11。
• 误差与协方差：见《误差预算卡 Template v1.0》Ch.5/Ch.8/Ch.9。

IX. 执行勾选清单（Pre-Flight Checklist）

• param_id/name/symbol/domain(unit/range/default/precision) 与 lineage/freshness 完整。
• 若涉及路径量：正文显式 gamma(ell)、d ell，并在卡片记录 delta_form。
• check_dim_report.json 通过；p_dim = 1.0；clock_state=locked、τ_calib 合规。
• uncertainty{type/estimate/distribution/coverage} 与 cov_group 已登记，覆盖口径透明。
• see[]/references[]/version 合规且锚点直指率 ≥ 90%；status ∈ {draft/stable/deprecated} 明确。
• param_registry.csv / param_card.yaml / params_schema.json / audit.jsonl 已生成并签名；checksum 唯一。