53-模型卡 Template v1.0 | 第2章 模型总览与适用范围

目录 ／ 文档-技术白皮书 ／ 53-模型卡 Template v1.0

第2章 模型总览与适用范围

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

• 给出模型的定位、目标与边界，明确允许/禁止的应用场景与合规前置。
• 覆盖：模型输入/输出概览、单位与量纲、依赖矩阵、版本策略与依赖闭合、质量门映射与机读制品。
• 凡涉及路径量（到达时/相位），正文显式路径 gamma(ell) 与测度 d ell，数据侧记录 delta_form ∈ {general, factored}；发布要求 p_dim = 1.0。

II. 输入/输出概览（I/O Overview & Schemas）

1. 输入（Inputs）
   • 结构：x ∈ R^{B×T×D}（示例），字段与单位/量纲对齐数据集卡第4章 schema.json/contract.yaml。
   • 典型字段：path.gamma_ell (m)、path.d_ell (m)、medium.n_eff_profile (1)、ref.c_ref (m/s)、（相位类）ref.lambda_ref (m)。
2. 输出（Outputs）
   • 任务型输出：分类/回归/时序/路径等；示例：obs.T_arr (s)、obs.Phi (rad)、score.logits (1)、score.uncertainty (unit follows target)。
   • 不确定度字段：u/Σ/coverage 必须与误差预算卡口径一致（k/alpha/quantile 三选一且全卷一致）。
3. 量纲与校核
   • 统一口径（两种等价）：
     T_arr = ( 1 / c_ref ) * ( ∫ n_eff d ell )
     T_arr = ( ∫ ( n_eff / c_ref ) d ell )
     相位：Phi = ( 2π / λ_ref ) * ( ∫ n_eff d ell )。
   • 发布前通过 I70-dim_check，随附 check_dim_report.json，要求 p_dim = 1.0。

III. 适用场景与限制（Use Cases & Limitations）

• 允许：近轴小角、缓变介质、相干窗内的批/流/近实时推理与计量；与数据/参数/误差/管线各卷的合规执行。
• 限制/禁止：超出相干窗、强非线性/强色散、缺失路径块或失锁时钟的数据；法律/伦理禁止用途。
• 路径一致性：len(gamma_ell)=len(d_ell)=len(n_eff)≥2，Δell ≤ ( c_ref / f_s ) / max(n_eff)；相位在参考窗内对齐后评估。

IV. 依赖矩阵（Dependency Matrix）

V. 版本策略与依赖闭合（Versioning & Closure）

• SemVer：MAJOR（控制式/单位/量纲/契约破坏性变更）、MINOR（向后兼容新增）、PATCH（修补）。
• 闭合：所有 see[]/references[]/version 必须与发布清单同步；仅允许对外引用 v1.*；manifest 记录依赖 checksum 与签名。
• 回滚：为本模型与关键依赖设置锁版本与回滚点，记录于 audit.jsonl。

VI. 质量门映射（Gate Mapping）

• G1 Schema 完整：I/O 字段与契约一致；
• G2 引用合规：锚点直指率 ≥ 90%，禁止外链与别名；
• G3 路径规范：gamma/measure/delta_form 齐备，步长与对齐合规；
• G4 量纲闭合：p_dim = 1.0 且通过 I70-dim_check；
• G5 新鲜度：clock_state="locked"、|ts_start − calib.timestamp| ≤ τ_calib；
• G6 覆盖口径一致：k/alpha/quantile 与误差卷一致；
• G7 协方差一致：Σ 正定并与 cov_group 对齐；
• G8 唯一性与无环：record_id/checksum 唯一，lineage DAG 无环。
• 触发 S1–S5（量纲/新鲜度/路径/协方差/引用）即阻断发布，必要时标注 [Restricted]。

VII. 机读制品（Machine-Readable Artifacts）

• model_overview.md：定位、用途限制、I/O 总览与量纲表。
• model_manifest.yaml：依赖、版本、清单与签名。
• compat_matrix.yaml：与运行时/数据/参数/误差/管线的兼容矩阵。
• check_dim_report.json：量纲闭合报告；validate_report.json：门通过/停止与锚点覆盖。

VIII. 交叉引用（Cross-References）

• 数据：数据集卡第4/6/7/8/11/12章；
• 参数：参数注册卡第4/6/8/9/10/11章；
• 误差：误差预算卡第5/6/8/9/10/11章；
• 管线：管线卡第3/6/9/11/12章。

IX. 执行勾选清单（Checklist）

• 模型定位、用途限制与 I/O 概览已明确；字段单位/量纲齐全。
• 路径量显式 gamma(ell)/d ell，记录 delta_form；Δell 与对齐满足约束。
• I70-dim_check 通过、p_dim = 1.0；覆盖 k/alpha/quantile 与误差卷一致。
• 依赖矩阵与 model_manifest.yaml、compat_matrix.yaml 一致；引用锚点直指率 ≥ 90%。
• /validate 通过 G1–G8，无 S1–S5；不合规项已按 [Restricted] 标注与处置。