47-PTN Template v1.0 | 第0章 前言与读者须知

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

第0章 前言与读者须知

I. 摘要（Abstract）
本章阐明《PTN Template v1.0》的用途、读者对象与使用方法，给出写作约束、引用口径与快速上手示例。全书统一采用“卷名 + 版本号 + 锚点（P/S/M/I）”的交叉引用规则；内联符号一律使用反引号包裹，含除号、积分或复合算符的表达强制加括号并显式声明路径 gamma(ell) 与测度 d ell。

II. 适用范围（Scope）

• 适用对象：从事“粒子技术备忘（PTN）”撰写、评审、发布与复现的作者与技术负责人。
• 内容覆盖：摘要与范围、控制式与最小方程、可检预测与证伪、数据规范与管线契约、实现绑定接口、结果呈现与限制条款的标准化写作。
• 依赖项（引用口径）：所有规范性条目应按如下固定格式引用：见《<卷名> vX.Y》<章节> <锚点>（优先直指 P/S/M/I 级锚点）。示例：见《EFT.WP.Core.Equations v1.1》Ch.2 S20-1。
• 非目标：本章不讨论领域知识本体推导与工程实现细节，相关内容在后续章节与配套卷中分别给出。
• 风格与排版：小节标题用罗马数字并加粗；项目符号用“- 空格”；编号列表用“1. 空格”；公式、符号、定义禁用中文。

III. 版本与稳定线（Version & Stability Line）

• 版本携带：一切引用必须显式携带版本号（例如：EFT.WP.Core.Tension v1.0），严禁使用别名或短码。
• 稳定线策略：对外发布仅引用 v1.*；若因研究需要引用 v0.* 草案，须在文内显著标注“草案/非承诺”。
• 编号体系：公设 Pxx-?、最小方程 Sxx-?、计量流程 Mx-?、实现绑定 Ixx-?；全书保持一致。

IV. 使用示例（Quick Start）

1. 到达时两种等价口径（均需显式路径与测度）：
   • 常量外提：T_arr = ( 1 / c_ref ) * ( ∫ n_eff d ell )
   • 一般口径：T_arr = ( ∫ ( n_eff / c_ref ) d ell )
     要求：在文本或数据的元信息中记录 delta_form，并在参数/数据对象加入可解析引用：
2. see:
3. - "EFT.WP.Core.Equations v1.1:S20-1"
4. - "EFT.WP.Core.Metrology v1.0:check_dim"
5. - "EFT.WP.Core.DataSpec v1.0:TARR"
6. 内联符号与冲突名约束：在正文中写作 T_fil（张力）、T_trans（透射系数）、n_eff（有效折射率）、c_ref（参考传播上限）；禁止裸用 c、T、n；T_fil 与 T_trans 不可混用，n 与 n_eff 严格区分。
7. 固定引用样式（文内首选）：
   • 公式/定义：见《EFT.WP.Core.Density v1.0》S92-1；见《EFT.WP.Core.Tension v1.0》S72-9。
   • 文字叙述：见《EFT.WP.Core.Terms v1.0》P10-3。
     以上为样式示例，具体锚点以实际选用条目为准。
8. 导出清单要求（机器可解析）：任何 PTN 配套数据/管线导出须包含 references: [...] 与 version: 字段，以支撑自动审校与复现。

V. 参考（References & Cross-Refs）

• 写作与排版统一口径：见《EFT 技术白皮书与技术备忘模板 全面清单 v0.1》。
• 引用与交叉引用规范：见《EFT 引用与交叉引用规范 v0.1》。

本章交付物

• 《读者须知》固定页（发布用）；
• 术语/符号对齐表（最小集，含 see: 与单位/量纲校核入口）。