44-EFT.WP.Data.ModelCards v1.0 | 第1章 概述与范围

目录 ／ 文档-技术白皮书 ／ 44-EFT.WP.Data.ModelCards v1.0

第1章 概述与范围

I. 章节目的与读者

• 目的：确立“模型卡（Model Card）”在 EFT 数据体系内的定位、最小合规要求与使用边界；规定与数据集卡、计量与引用锚点的衔接方式。
• 读者：模型开发与训练工程师、评测与校准负责人、部署与平台工程师、合规与安全审计人员、外部复现实验与基线维护者。

II. 术语与引用口径

1. 术语来源：通用术语遵循《EFT 技术白皮书与技术备忘模板 全面清单 v0.1》；本卷仅补充与模型卡直接相关的增量术语（如 architecture/backbone、io_schema、calibration、robustness、fairness、safety）。跨卷引用必须携带“卷名 + 版本号 + 章节/锚点”，优先指向 P/S/M/I 条文级锚点。示例：见《EFT.WP.Core.Equations v1.1》Ch.2 S20-1。
2. 内联符号与数学表达：一律用反引号包裹（如 f_θ(x)、p(y|x,θ)、L(θ)、T_arr、c_ref、n_eff）；含除号/积分/复合算符的表达必须加括号并显式声明路径 gamma(ell) 与测度 d ell；公式/符号/定义禁用中文。
3. 到达时两口径（跨卷统一示例）：
   • T_arr = ( 1 / c_ref ) * ( ∫ n_eff d ell )
   • T_arr = ( ∫ ( n_eff / c_ref ) d ell )
     任一处使用 T_arr，需在模型卡元数据登记 delta_form、path="gamma(ell)"、measure="d ell"。

III. 本卷适用范围（In Scope）

• 对象：面向 EFT 体系内任意可部署模型的元数据与文档化要求：任务与 IO 模式、架构与参数、训练数据引用、预处理/特征、目标与优化、评测协议与指标、校准与不确定度、鲁棒性与公平性、安全与使用限制、部署/资源、导出与发布。
• 与数据卡的关系：模型卡引用而非复制数据事实；所有数据来源、切分与质量门统一回指《EFT.WP.Data.DatasetCards v1.0》。
• 与计量/引用规范的关系：单位/量纲、一致性与引用锚点遵循《Core.Metrology v1.0》《引用与交叉引用规范 v0.1》。

IV. 非适用范围（Out of Scope）

V. 产出物与合规门槛

1. 产出物：
   • model_card.yaml（或 JSON）——满足本卷 Schema 与必填字段；
   • export_manifest——含 version 与 references[]；
   • 验证报告：Schema/Lint 校验、计量校验、评测与显著性、校准与覆盖、鲁棒性与公平性条目；
   • 可复现工件：冻结切分引用、随机种子与环境锁定、推理/评测脚本与哈希。
2. 最低合规（发布前必须通过）：
   • 必填字段完整、类型/正则与依赖校验通过；
   • io_schema 明确、与部署接口一致；
   • 评测协议使用冻结切分并回指数据卡；
   • check_dim 通过（涉及物理量/时间/频率/性能单位）；
   • 引用使用“卷名+版本+锚点”，无短码/别名。

VI. 文档结构与跨卷依赖地图

1. 结构映射：
   • Ch.3–Ch.5：字段总览与标准/扩展字段；
   • Ch.6–Ch.7：任务与 IO、架构与参数；
   • Ch.8–Ch.10：训练数据绑定、预处理、目标与优化；
   • Ch.11–Ch.12：评测协议与指标、校准与不确定度；
   • Ch.13–Ch.14：鲁棒性/偏移/对抗性、公平性/伦理与限制；
   • Ch.15–Ch.16：机器可读 Schema/Lint 与实现绑定&验证 API；
   • Ch.17–Ch.18：示例与模板。
2. 依赖约束：
   • 数据事实与切分：回指《DatasetCards v1.0》；
   • 量纲/单位：回指《Core.Metrology v1.0》；
   • 路径相关方程：回指《Core.Equations v1.1》。

VII. 命名与字段风格

• 命名：键名采用 snake_case；保留名（如 model_id、version、task、io_schema、architecture、evaluation、calibration、robustness、fairness、safety、deployment、resources、export_manifest）语义不可重定义。
• 冲突名强制：T_fil 与 T_trans 不可混用；n 与 n_eff 严格区分；公式/符号/定义禁用中文。

VIII. 机器可读与验证接口（概览）

1. Schema & Lint：本卷提供 model_card.schema.json 与 lint_rules.yaml（强制校验：版本/锚点正则、冻结切分引用、计量/单位一致性、符号冲突与数学文本护栏）。
2. 实现绑定要点：
   • see 字段采用 "卷名 vX.Y:锚点"；
   • export_manifest 必含 version 与 references[]；
   • 验证 API 支持结构校验、单位校核、引用校验、泄漏审计、评测与显著性、校准与覆盖、鲁棒性/公平性条目。

IX. 质量、可复现与审计

• 质量门：与 Ch.11–Ch.12 的评测/校准指标阈值对齐；泄漏=0、随机性与重复实验要求满足；
• 可复现：训练/推理的环境、依赖、随机种子与脚本可重放；
• 审计轨：版本化与引用锚点、评测/校准/鲁棒性与公平性报告、导出工件哈希在 export_manifest 中可追溯。

X. 使用与维护

• 使用：对外发布与对内合规审批均以模型卡为唯一口径；引用数据卡与核心卷条目时只用稳定线版本（如 v1.*）。
• 维护：字段口径或依赖条目更新时，按本卷 Ch.14 的发布与版本化策略发布新版本，并在 export_manifest 反映引用变化与公告。