radixark/miles

删除四个废弃模型启动脚本及配套快照与文档

值得精读。本 PR 展示了如何在删除旧功能时进行精确的引用分析（区分"真实引用"与"已禁用引用"），以及如何处理文档与代码的联动清理。关键设计决策包括： - 通过 `disabled` 机制判断测试是否真实执行，从而安全删除看似被引用的模型定义； - 保留仍被基础设施示例（p2p、low-precision）引用的模型定义，避免过度删除； - 重写存活模型文档而非简单删除，保证文档与实际 launcher 对齐。 对维护大型脚本库的团队有很强的参考价值。

修复 ROCm 上 FSDP 混合分片并重新启用 CI

值得快速精读，特别是 build_fsdp_meshes 的分支写法。亮点在于按能力而非版本选择 API，避免对 ROCm 的 PyTorch 版本硬编码；但它依赖 hasattr 探测私有接口，长期看可在注释中写明 _unflatten 的等价语义（二维 mesh 的 rank 映射），或考虑抽象一个 mesh factory 统一两条路径。建议在后续 FSDP 重构中保留双方等价性的回归测试。

修正 offload 参数帮助文案，与真实行为对齐

不值得精读：单文件 3 行帮助文案修复，几分钟可看完。值得借鉴的是作者的校验方式——不凭印象改文案，而是对照 `validate_args` 的真实默认填充逻辑（None 判断）来校正 help 表述，并把“显式 `--no-` 会被尊重”这一行为写进文案；同时刻意不动正确的 `--offload-rollout` 阶段描述，变更面控制得很小，是“文档与实现互相校验”的小型范本。

补齐 SEO 元数据，6 个页面纳入索引

值得作为 Mintlify 文档站导航与 SEO 维护的模板 PR 快速精读，重点学习作者的方法：用 live sitemap 核对导航覆盖率、实测 canonical 优先级、把 docs.json 升级到 v2 schema 并规范化 seo 块。代码层面无风险，不需要深挖；若要精读，关注 docs/docs.json 的顶部 SEO 配置与导航新增组，以及 docs/README.md 新增的页面规范。

修复 NPU 训练脚本的数据/模型路径错位，统一到 DAPO

值得快速精读（约 10 分钟）：这是一个典型的『从示例复制脚本后未同步常量』的修复案例，prepare() 与 execute() 路径不一致的审计思路对维护各类 recipe/launch 脚本很有参考价值。建议审阅时关注两点：一是 TRAIN_DATA_PATH 作为单一事实源的做法是否可推广到其他 NPU 脚本；二是是否应为这类路径一致性补一个 snapshot 或静态检查，避免再次回归。

修复复现页 gsm8k 数据集下载命令

变更小而明确，不需要精读；但其审计思路值得借鉴——核对文档声明的数据源与实际脚本读取的数据契约（路径 + 列名）。若你在处理同类「文档/脚本数据不一致」问题，可参考本 PR 与 #2398、#2402 的联动处理方式。

刷新 MXFP8/NVFP4 低精度 RL 指南并重命名页面

值得精读，尤其适合负责 Blackwell 低精度训练的用户、文档维护者与关注 RoI 的技术管理者。核心看点：① 四阶段精度契约与 rollout × 训练兼容矩阵如何把 MoE RL 精度漂移的排障成本前置；② MXFP8 的 MoE / dense GEMM 后端选择拆分，纠正了旧文档单点建议的误导；③ NVFP4 后向模式「基础 + 高级选项」的分级呈现与外部来源引用策略；④ 文档重命名时全站链接、重定向与跨 PR 冲突处理的最佳实践。建议结合 issue #615 及其实现 PR 对照阅读。

修正 Quick Start 的 DAPO 数据下载，对齐 launcher 期望格式

值得快速浏览而非精读：纯 2 行文档变更，但背景揭示了“以 launcher 数据契约为准验证数据集兼容性”的方法，适合作为文档类修复的范本。关注点：提交说明清晰、验证详尽、善用 follow-up 拆分同类问题。