44-EFT.WP.Data.ModelCards v1.0 | 第4章 标准字段定义

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

第4章 标准字段定义

I. 章节目的与适用范围

II. 字段总表（必填）

III. 详细定义与示例

1) model_id

• 语义：跨版本稳定的主键，建议组织前缀（如 org.project.model）。
• 约束：^[a-z0-9_\\-.]+$；区分大小写：否。
• 示例：eift.vision.cls.resnet50。
• 引用：与导出结构绑定，见 DataSpec。

2) task

• 语义：模型面向的任务类型。
• 约束：枚举；与 evaluation.protocol、io_schema 一致。
• 示例："classification"。

3) io_schema

• 语义：输入/输出数据契约。
• 结构：
• 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}
• 要求：与部署接口及评测脚本完全一致。

4) architecture

• 语义：核心网络/模块化结构与参数量。
• 结构：
• architecture:
• backbone: "resnet50"
• params: {M_param: 25.6, act: "relu", norm: "bn"}
• head: {type:"linear", out_dim: 1000}

5) training_data

• 语义：训练数据来源与冻结切分引用。
• 结构：
• training_data:
• refs:
• - "EFT.WP.Data.DatasetCards v1.0:Ch.11"
• - "EFT.WP.Data.DatasetCards v1.0:Ch.12"
• splits_ref: "eift.obs.demo@v1.0"
• contamination_policy: "forbid-cross-split"
• 要求：引用不复制；携带版本与锚点。

6) preprocess

• 语义：训练/推理前处理。
• 结构：
• preprocess:
• pipeline_id: "img-prep-v1"
• steps:
• - {name:"normalize", enabled:true, idempotent:true,
• params:{type:"zscore", stats_from:"train-only"}}
• parameter_lock: true
• 规则：统一单位与量纲；开启 parameter_lock。

7) optimization 与 hyperparams

• 语义：目标函数、优化器/调度器与关键超参。
• 结构：
• optimization:
• objective: {name:"cross_entropy"}
• optimizer: {name:"adamw", lr: 3.0e-4, weight_decay: 0.05}
• scheduler: {name:"cosine", warmup_steps: 500}
• hyperparams:
• batch_size: 256
• epochs: 200
• seed: 1701

8) evaluation

• 语义：评测协议、指标与显著性。
• 结构：
• 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"}]
• 要求：冻结切分、显著性必备。

9) calibration

• 语义：概率校准方法与报告。
• 结构：
• calibration:
• method: "temperature"
• params: {t: 1.7}
• report: {ece: 0.018, brier: 0.072}
• 要求：与计量/不确定度条目一致。

10) robustness / fairness / safety

• 结构：
• robustness:
• shifts: ["snr_drop","time_jitter","spec_notch"]
• adversarial: {norm:"Linf", epsilon:0.01}
• thresholds: {drop_rel_max: 0.10}
• fairness:
• axes: ["class","region"]
• gap_metric: "abs_diff"
• threshold: 0.05
• safety:
• allowed_use: ["academic","benchmark"]
• prohibited_use: ["surveillance"]
• audits: ["redteam_v1"]

11) deployment 与 resources

• 结构：
• deployment:
• forms: ["rest","grpc"]
• devices: ["A100","CPU-AVX2"]
• latency_targets_ms: {p50: 5, p99: 20}
• concurrency: 512
• resources:
• M_param: 25.6 # M
• FLOPs: 4.1e9 # per inference
• T_inf: 3.8 # ms per sample
• vram_mb: 1024
• power_w: 210
• 要求：单位与量纲通过 check_dim。

12) 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[] 为强制；禁止短码/别名。

IV. 与路径/到达时相关的必填登记（如适用）

1. 若模型涉及路径依赖量（如 T_arr），在本章字段中至少落地：
2. path_dependence:
3. applies_to: ["T_arr"]
4. delta_form: "const-factor" # 或 "general"
5. path: "gamma(ell)"
6. measure: "d ell"
7. see:
8. - "EFT.WP.Core.Equations v1.1:S20-1"
9. - "EFT.WP.Core.Metrology v1.0:check_dim"
10. 两种等价表达：
    • T_arr = ( 1 / c_ref ) * ( ∫ n_eff d ell )
    • T_arr = ( ∫ ( n_eff / c_ref ) d ell )
11. 登记 delta_form、path、measure 并通过量纲校核。

V. 机器可读 Schema（节选，规范性）

# I15-1 Model Card Schema (required subset)

type: object

required:

[model_id,title,version,task,io_schema,architecture,training_data,

preprocess,optimization,hyperparams,evaluation,calibration,

robustness,fairness,safety,deployment,resources,export_manifest]

properties:

model_id: {type: string, pattern: "^[a-z0-9_\\-\\.]+$"}

title: {type: string, minLength: 3}

version: {type: string, pattern: "^v\\d+\\.\\d+(\\.\\d+)?$"}

task: {type: string}

io_schema:

type: object

required: [inputs,outputs]

properties:

inputs: {type: array}

outputs:{type: array}

batching:{type: object}

streaming:{type: object}

architecture: {type: object}

training_data:

type: object

required: [refs, splits_ref]

properties:

refs: {type: array, items: {type: string}}

splits_ref: {type: string}

preprocess: {type: object, required:[pipeline_id,steps]}

optimization: {type: object}

hyperparams: {type: object}

evaluation:

type: object

required: [protocol, metrics]

calibration: {type: object}

robustness: {type: object}

fairness: {type: object}

safety: {type: object}

deployment: {type: object}

resources:

type: object

properties:

M_param: {type: number}

FLOPs: {type: number}

T_inf: {type: number}

export_manifest:

type: object

required: [version, artifacts, references]

properties:

version: {type: string}

artifacts: {type: array, items: {type: object}}

references: {type: array, items: {type: string, pattern:"^[^:]+ v\\d+\\.\\d+:[A-Z].+$"}}

see:

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

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

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

（引用锚点/单位校核/禁混用符号按《全面清单 v0.1》与《引用规范 v0.1》执行。）

VI. 名称冲突与禁令（适用于本章所有字段）

VII. 本章合规自检

• 表 II 所列全部必填键存在且通过类型/正则校验；保留名未被重定义。
• export_manifest 含 version 与 references[]；references[]/see[] 采用 "卷名 vX.Y:锚点" 固定格式，不允许短码/别名。
• 涉及 T_arr 的条目已登记 delta_form、path、measure 并通过 check_dim。
• 数学表达满足反引号、括号与禁用中文规则；T_fil/T_trans 与 n/n_eff 不混用。