44-EFT.WP.Data.ModelCards v1.0 | 第3章 字段总览

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

第3章 字段总览

I. 章节目的与范围

II. 字段分层与命名约定

1. 分层：
   • 必填（Required）：发布时必须存在，且通过类型/正则/依赖校验。
   • 条件必填（Conditionally Required）：满足触发条件时必须存在（见“触发条件”列）。
   • 可选（Optional）：存在即校验，不存在不报错。
2. 命名与引用：键名一律 snake_case；引用字段在 see[] 使用 "卷名 vX.Y:锚点"；导出物含 references[] 与 version。

III. 必填字段清单（Required）

IV. 条件必填字段清单（Conditionally Required）

V. 可选扩展字段清单（Optional）

VI. task 与 io_schema 片段（规范性）

task: "classification" # classification|retrieval|generation|asr|segmentation|timeseries|...

io_schema:

inputs:

- {name:"image", shape:"(H,W,3)", dtype:"uint8", range:"[0,255]"}

outputs:

- {name:"probs", shape:"(K,)", dtype:"float32", range:"[0,1]", semantics:"softmax"}

batching: {mode:"static|dynamic", max_batch: 64}

streaming: {enabled:false}

（I/O 模式与部署接口、评测协议保持一致；单位/量纲遵循计量章。）

VII. 训练数据绑定与冻结切分（节选）

training_data:

refs:

- "EFT.WP.Data.DatasetCards v1.0:Ch.11" # splits & distribution

- "EFT.WP.Data.DatasetCards v1.0:Ch.12" # quality & baselines

splits_ref: "eift.obs.demo@v1.0" # 冻结切分引用

contamination_policy: "forbid-cross-split"

（模型卡引用数据事实，禁止复制；引用携带版本与锚点。）

VIII. 评测与校准（节选）

evaluation:

protocol: {splits:"frozen", seeds:[0,1,2,3,4], repeats:5,

significance:{test:"permutation", alpha:0.05}}

metrics: [{name:"f1_macro"}, {name:"roc_auc"}, {name:"ece"}, {name:"brier"}]

calibration:

method: "temperature"

params: {t: 1.7}

report: {ece: 0.018, brier: 0.072}

（显著性与覆盖指标与质量/计量章一致。）

IX. 导出清单与引用（export_manifest 片段）

export_manifest:

version: "v1.0"

artifacts:

- {path:"model_card.yaml", sha256:"..."}

- {path:"eval/summary.csv", sha256:"..."}

references:

- "EFT.WP.Core.DataSpec v1.0:EXPORT"

- "EFT.WP.Core.Metrology v1.0:check_dim"

- "EFT.WP.Core.Equations v1.1:S20-1"

（导出物必须含 version 与 references[]，引用携带卷名+版本+锚点。）

X. 键模式与最小正则

• 标识与版本：model_id: ^[a-z0-9_\\-.]+$；version: ^v\\d+\\.\\d+(\\.\\d+)?$。
• 引用锚点：references[*]: ^[^:]+ v\\d+\\.\\d+:[A-Z].+$。
• 量纲校核：metrology.units="SI" 且 check_dim=true。

XI. see[] 与跨卷依赖映射（示例）

see:

- "EFT.WP.Data.DatasetCards v1.0:Ch.11"

- "EFT.WP.Core.Metrology v1.0:check_dim"

- "EFT.WP.Core.Equations v1.1:S20-1"

（按固定格式与 P/S/M/I 锚点类型进行条文级引用优先。）

XII. 本章合规自检

• 所有必填键存在且通过类型/正则校验；保留名未被重定义。
• export_manifest 含 version 与 references[]；see[] 使用 "卷名 vX.Y:锚点"。
• 涉及 T_arr 的条目已登记 delta_form、path、measure，并通过 check_dim。
• 符号/公式遵循反引号与括号规则，不使用中文；T_fil/T_trans、n/n_eff 不混用。