以当前代码为准，核对日期 2026-10-23。入口从中文使用说明开始。当前模式版本是 VMAT/IMRT、CyberKnife 的 geometry-v4，TOMO 的 tomo-v3，Aurora V4 的 aurora-v5-unified-physical-closure1mm。Halcyon/Ethos 新增三层字段另使用 lrt-three-layer-v1，旧字段及其版本保持原定义。
| 内容 | 文档 |
|---|---|
| 安装、GUI、CLI、CSV、空值及版本比较 | 使用说明、项目 README |
| 全指标、分平台定义 | 全部、VMAT/IMRT、TOMO、CyberKnife、Aurora |
| 公式、单位、采样、掩码、归一化、缺失规则 | 逐项公式契约 |
| 可编辑的 Markdown / LaTeX 公式及全指标映射 | 逐键公式索引 |
| IMRT/VMAT：孔径、MCS、运动、MI、SPORT | 公式与使用 |
| Halcyon/Ethos：原生层、effective、stacked、报告配置 | 公式与使用 |
| LRT 三层统一指标、PI/PM/PR、50项候选及51列输出 | 定义与复算、输入清单示例 |
| TOMO：开放时间、sinogram、调制、床运动 | 公式与使用 |
| CyberKnife MLC：XML 分段与标准 MLC 两条路径 | 公式与使用 |
| Aurora：V2、V3、legacy 与 V4 全家族 | 公式与使用 |
| Aurora 七项物理几何及开放条件均值 | 当前定义、当前迁移、历史迁移、DeepPlan 兼容 |
| TOMO 与 Ethos 专属输入/算法边界 | TOMO、Ethos |
| 精度与基线、发布及回退 | 精度说明、参考包、部署回退、临床前提 |
| 可下载 PDF | 项目简介、Aurora 公式 |
定义 Markdown 和本地 CSV 来自 metric_definition_catalog.py；公式契约来自 metric_formula_contracts.py；Aurora PDF 复用目录与注释；项目简介 PDF 从当前版本常量和目录生成。修改定义源后必须重新生成，避免手工修改导出文档后被覆盖。命令见使用说明。
平台公式说明和三层接口说明是可手工编辑的 Markdown，使用 $...$ 行内公式和 $$...$$ 独立 LaTeX 公式。metric_math_links.py 定义逐家族链接，导出器自动生成逐键索引。新增指标家族必须显式补充公式章节及链接；覆盖测试防止静默遗漏。目录共 485 条记录（VMAT/IMRT 337、TOMO 65、CyberKnife 6、Aurora 77），包含层变体、别名和容器，不能称为 485 个独立标量指标。
hybrid-v2、geometry-v3和精度迁移保留原迁移与验证日期。历史测试数量不代表当前测试数量。Aurora 旧比较表保留未锁定当前公式的旧数据，不应作为当前物理面积或 V4 基线。
研究目录保留研究问题、证据和迁移来源；superpowers/plans/、superpowers/specs/ 保留历史实施计划/设计。提出过的功能不等于已经实现，历史命令不作为当前操作指引。原始 reference_text/ 文献及 UCoMX 原版手册属于外部资料，不是本程序现版手册。
指标完整性审计记录恢复阶段发现的问题；本次文档同步记录列出完整审阅清单、未改写的证据和验证方法。历史基线、哈希和 run_reports/validation/ 快照不因文档更新而重写。