第3章 清单结构与制品(Artifacts Layout)


I. 目标与范围(Purpose & Scope)


II. 输入与依赖(Inputs & Dependencies)


III. 目录结构(Directory Layout)

PTN_EXPORT/

model/ # 模型清单与配置

model_manifest.yaml

compat_matrix.yaml

control_spec.yaml

train_config.yaml

hpo_space.yaml

inference/ # 部署接口与绑定

inference_openapi.yaml

inference.proto

binding_spec.md

uq/ # UQ 与误差预算

model_uq.yaml

uq_summary.json

budget_breakdown.csv

eval/ # 评测与评分

bench_plan.yaml

scorecard.json

eval_report.md

monitoring/ # 监控与回退

monitoring_rules.yaml

rollback_fsm.yaml

alerts.jsonl

reports/ # 校核与审计

check_dim_report.json

validate_report.json

audit.jsonl

data/ # 数据快照(可选:或由 Dataset 包引用)

data_refs.yaml

split_manifest.json

figs/ # 图表(双份导出)

model_arch.svg

path_profile.pdf

latency_hist.pdf

throughput_series.svg

report_manifest.yaml # 发布清单(本章强制)

SIGNATURE.asc # 签名(本章强制)

checksums.txt # 全量 sha256(本章强制)


IV. 制品分层(Artifacts by Tier)


V. 清单与校验(Manifest & Verification)
A. report_manifest.yaml(模板)

version: "1.0.0"

bundle:

model: ["model/model_manifest.yaml","model/compat_matrix.yaml","model/control_spec.yaml","model/train_config.yaml"]

inference: ["inference/inference_openapi.yaml","inference/inference.proto","inference/binding_spec.md"]

uq: ["uq/model_uq.yaml","uq/uq_summary.json","uq/budget_breakdown.csv"]

eval: ["eval/bench_plan.yaml","eval/scorecard.json","eval/eval_report.md"]

monitoring: ["monitoring/monitoring_rules.yaml","monitoring/rollback_fsm.yaml","monitoring/alerts.jsonl"]

reports: ["reports/check_dim_report.json","reports/validate_report.json","reports/audit.jsonl"]

figs: ["figs/model_arch.svg","figs/path_profile.pdf","figs/latency_hist.pdf","figs/throughput_series.svg"]

checksums: "checksums.txt"

sign: "SIGNATURE.asc"

see:

- "Dataset Card v1.0:Ch.4"

- "Model Card v1.0:Ch.4"

- "Error Budget Card v1.0:Ch.8"


B. checksums.txt

sha256 model/model_manifest.yaml <64-hex>

sha256 reports/check_dim_report.json <64-hex>

...


VI. 单位/量纲与路径口径(Units/Dimensions & Path Forms)

目录中 control_spec.yaml 与 path_profile.pdf 应与上述口径一致;数据侧记录 delta_form;数组 len(gamma_ell)=len(d_ell)=len(n_eff)≥2。


VII. 质量门映射(Gates Mapping)


VIII. 反例与修正(Anti-Patterns & Fixes)


IX. 交叉引用(Cross-References)


X. 勾选清单(Checklist)