53-模型卡 Template v1.0 | 第1章 前言与读者须知

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

第1章 前言与读者须知

I. 目标与适用读者（Purpose & Audience）

• 目标：提供面向工程发布的模型说明书与合规清单，确保可复现、可审计、可回滚，并与数据/参数/误差/管线各卷口径一致。
• 读者：模型研发与评测人员、数据与计量治理、合规与风险负责人、运维与发布工程团队。

II. 覆盖范围与责任边界（Scope & Responsibility）

• 覆盖：模型总览与依赖、架构与控制式、训练协议与超参数、误差预算与不确定度、评测与对比评分、偏倚/伦理/安全、部署接口与性能、监控/漂移/回退、附录模板。
• 边界：与**《数据集卡 Template v1.0》负责数据端一致性，与《参数注册卡 Template v1.0》负责参数新鲜度与版本，与《误差预算卡 Template v1.0》负责不确定度与协方差口径，与《管线卡 Template v1.0》**负责执行与发布。

III. 术语与编号（Terms & Numbering）

• 术语与符号采用国际记法；章节内引用统一以“卷名 + 版本 + 锚点（P/S/M/I）”，锚点直指率 ≥ 90%。
• 统一编号：公设 Pxx-?，最小方程 Sxx-?，计量流程 Mx-?，实现绑定 Ixx-?。
• 禁止冲突名：T_fil（张力）≠ T_trans（透射系数）；n（数密度）≠ n_eff（有效折射率）；禁止裸用 c、T、n。

IV. 数学与路径口径（Mathematical Conventions）

• 任何含除号/积分/复合算符的表达必须加括号，并声明路径 gamma(ell) 与测度 d ell。
• 路径量统一口径（两种等价）：
  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，发布要求 p_dim = 1.0，随附 check_dim_report.json。

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

• 数据：见《数据集卡》Ch.3/4/6/7/8/11/12，确保 Schema、Splits、Coverage 与 lineage 对齐。
• 参数：见《参数注册卡》Ch.4/6/8/9/10/11，确保 freshness.policy 与 cov_group 一致。
• 误差：见《误差预算卡》Ch.5/Ch.6/Ch.8/Ch.9/Ch.10/Ch.11，采用同一覆盖与协方差口径。
• 管线：见《管线卡》Ch.3/Ch.6/Ch.9/Ch.11/Ch.12，对齐接口、质量门与发布目录。

VI. 质量门与停止（Gates & Stops）

• G1 Schema 完整｜G2 引用合规｜G3 路径规范｜G4 量纲闭合（p_dim = 1.0）｜G5 新鲜度｜G6 覆盖口径一致｜G7 协方差一致（Σ PD）｜G8 唯一性与无环。
• 触发 S1–S5（量纲失败/新鲜度失效/路径缺失/协方差失配/引用不合规）即阻断发布；必要时标注 [Restricted] 并仅发布定性结果与诊断图。

VII. 产出与清单（Deliverables & Manifests）

• 必交付：model_manifest.yaml、model_overview.md、equations.md、train_config.yaml、model_uq.yaml、uq_summary.json、eval_plan.yaml、scorecard.json、inference_openapi.yaml、inference.proto、perf_report.csv、monitoring_rules.yaml、rollback_fsm.yaml、check_dim_report.json、validate_report.json、audit.jsonl、SIGNATURE.asc。
• 发布目录参考《管线卡》与《数据集卡》之 PTN_EXPORT/ 与 DS_EXPORT/ 规范；所有制品附 checksum 与签名。

VIII. 写作与排版（Style & Layout）

• 小节标题用罗马数字并加粗；项目符号用“- 空格”；编号列表用“1. 空格”。
• 图表双份导出（PDF/SVG 与 PNG/JPG），DPI ≥ 300；图注含单位、see[]/version 与覆盖口径；路径图注标注 Δell 与 delta_form。

IX. 发布前检查（Pre-Flight Checklist）

• 依赖闭合：数据/参数/误差/管线引用合规，锚点直指率 ≥ 90%。
• 数学口径：括号化表达、路径 gamma(ell)/d ell 显式，p_dim = 1.0。
• 覆盖一致：k/alpha/quantile 全卷一致，Σ 正定并与 cov_group 对齐。
• 质量门：/validate 通过 G1–G8，无 S1–S5；不合规项已标注 [Restricted]。
• 清单完备：model_manifest.yaml、check_dim_report.json、validate_report.json、audit.jsonl 与签名齐备。