47-PTN Template v1.0 | 第1章 模板总览与适用范围

目录 ／ 文档-技术白皮书 ／ 47-PTN Template v1.0

第1章 模板总览与适用范围

I. 依赖图（Dependencies）

• 核心卷（必备）：Core.Terms v1.0、Core.Equations v1.1、Core.Parameters v1.0、Core.Metrology v1.0、Core.Errors v1.0、Core.DataSpec v1.0。引用口径固定为“卷名 + 版本 + 锚点（P/S/M/I）”。
• 方法与计量（强依赖）：Methods.Repro v1.0、Methods.SimStack v1.0、Methods.Inference v1.0、Methods.Falsification v1.0、Methods.Cleaning v1.0、Methods.Imaging v1.0、Methods.CrossStats v1.0、Methods.SynthData v1.0、Metrology.TimeBase v1.0、Metrology.Sync v1.0、Metrology.Instrument v1.0、Metrology.PathCorrection v1.0。
• 数据与工程（配套）：Data.DatasetCards v1.0、Data.ModelCards v1.0、Data.Pipeline v1.0、Data.Benchmarks v1.0；模板族：实验协议卡 Template v1.0、误差预算卡 Template v1.0、参数注册卡 Template v1.0、管线卡 Template v1.0、模型卡 Template v1.0 等。
• 跨卷引用格式（固定）：见《<卷名> vX.Y》<章节> <锚点>；示例：见《EFT.WP.Core.Equations v1.1》Ch.2 S20-1。所有到达时表达需显式 gamma(ell) 与 d ell 并记录 delta_form。

II. 适用域清单（Scope of Use）

• 文类与用途：适用于“粒子技术备忘（PTN）”之撰写、评审、发布与复现；覆盖摘要与范围、控制式、可检预测与证伪、数据与管线契约、实现绑定、结果呈现与限制条款的标准化写作。
• 写作与排版：小节标题用罗马数字并加粗；项目符号用“- 空格”；编号列表用“1. 空格”；内联符号一律用反引号；含除号、积分或复合算符的表达强制加括号并声明路径与测度；公式、符号、定义禁用中文。
• 编号与命名：公设 Pxx-?、最小方程 Sxx-?、计量流程 Mx-?、实现绑定 Ixx-?；T_fil（张力）与 T_trans（透射系数）不可混用；n 与 n_eff 严格区分。
• 版本与稳定线：所有引用必带版本（如 EFT.WP.Core.Tension v1.0），对外发布仅引用 v1.*；如引用 v0.*，须显著标注“草案/非承诺”。

III. 非适用域（显式排除）

• 不承担学科本体的完整推导与证明；该类内容由 Core 四册及相关方法卷承担（如 Core.Threads/Sea/Density/Tension、Methods.*）。
• 不替代工程实现细节、运维手册与硬件说明书；此类文档应分别归档于工程与数据模板族（Pipeline/Benchmarks/Protocol/Instrument 等）。
• 不作为对外政策或授权文件的载体；许可、合规与对外发布策略遵循 Core.DataSpec v1.0 及数据集卡流程。

IV. 里程碑与交付（Milestones & Deliverables）

• M1｜术语与控制式对齐：完成最小术语表与控制式清单（机读 symbols.yml、equations.md），see: 至 Core.Terms v1.0:P10-*、Core.Equations v1.1:S20-*，并通过 check_dim 校核。交付物：术语/方程卡、量纲校核报告。
• M2｜预测与证伪计划：形成阳性/阴性判据、阈值与功效分析；see: 至 Methods.Falsification v1.0、Methods.CrossStats v1.0。交付物：predictions.csv、falsify.md。
• M3｜数据与管线契约：定稿 dataspec.json 与 pipeline.yaml，导出时携带 references[] 与 version；字段与单位对齐 Core.DataSpec v1.0、计量链对齐 Core.Metrology v1.0。交付物：数据契约与管线清单。
• M4｜实验/观测与计量：完成观测几何、校准与同步方案；see: 至 Metrology.TimeBase v1.0、Metrology.Sync v1.0、Metrology.Instrument v1.0、Metrology.PathCorrection v1.0。交付物：实验协议卡与校准脚本。
• M5｜误差预算与结果呈现：完成误差源、传播与合成；统一图表与评分口径；see: 至 Core.Errors v1.0、Methods.Imaging v1.0、Data.Benchmarks v1.0。交付物：误差预算卡、评分表与结果画板。
• M6｜发布审校与复现：完成引用 Lint（版本与锚点覆盖≥90%）、复现实验脚本与导出清单；遵循 Methods.Repro v1.0 与《引用与交叉引用规范 v0.1》。交付物：发布包与复现报告。