radixark/miles

补齐 Kimi-K3、Nemotron-3-Ultra、Gemma-4 配方文档

值得精读，尤其是 `docs/models/nemotron/nemotron-3-ultra.md` 对 `n_groups=8` 如何约束整个并行布局的分析，以及 `docs/models/kimi/kimi-k3.md` 关于 LoRA 适配 MXFP4、CUDA IPC 权重同步与 `lora_base_cpu_backup` 的工程细节——这些是文档里最接近设计文档的内容。对团队的意义在于确立了 recipe 页必须只引用已存在资源、并与 scripts/ 保持一致内容的约定。

修复 store_true 覆盖 FSDPArgs 布尔默认值

值得精读。这个 PR 展示了如何用 dataclass 反射驱动 CLI 测试，确保“源码单一事实来源”不漂移，并借助 `BooleanOptionalAction` 干净地解决布尔默认值与可关闭性冲突。防御性修复的写法（提前拦截 `default_factory`、遍历字段而非硬编码名单）也值得在类似 CLI 生成场景中借鉴。

以 DeepSeek-V3.2 配方页替换 V3/R1 页并同步全站索引

FSDP 后端移除不可达的上下文并行代码

值得精读，尤其适合作为“删除从未支持的配置分支”的范式：先由共享校验证明分支不可达、再找出已腐烂的引用、删除时保留最小兼容面（cp.group 非 None、保留参数名）。重点关注 miles/backends/fsdp_utils/parallel.py 中 mesh 从二维降一维的写法，以及 PR body 对两个“刻意保留”的论证。

按代码重写开发者文档并新增版本页

值得精读，尤其适合两类读者：新贡献者应细读 contributor-guide 的 Running CI 与 code style 章节，按文档步骤验证测试注册；维护者应阅读 versions.md 的 bumping principle 与镜像标签规则，这是全仓库版本管理策略第一次被系统化写成文字。可以借鉴的做法：文档中每个结论都标注来源（代码文件、workflow、.claude），并将“如何验证”写进文档（如 run_suite.py --list-only、dev 标签时间戳），值得在后续文档维护中推广。

新增授权 Neon SQL 工作流，写权限用户可安全执行任意 SQL

值得精读，尤其适合关注“受权临时数据库访问”“避免 secret 暴露”设计的工程师。重点看三点：双重 actor 权限校验（工作流与客户端各自独立执行）、CMS 加密结果交付与 artifact 自清理、执行器对 SQL 的 byte-for-byte 透传与结果截断语义。鉴于该 PR 没有公开 review 讨论，正式用于生产前建议再补充一轮针对权限与故障路径的走查。

修复 Kimi 系列 YaRN 参数与 checkpoint 配置不一致

值得精读。该 PR 展示了如何在不修改 Megatron 全局默认值的前提下，通过 per-model 包装器解决配置边界不一致问题，并配套了从 CLI 参数到最终 TransformerConfig 的端到端回归测试。关注点：`load_sibling_model_args` 的透传机制、K2.5 包装器的设计，以及测试中如何隔离 TE 依赖。

删除 validate_args 中重复的 rematerialize 校验调用

值得快速了解，是理解 `validate_args` 校验链和参数校验风格的一个小型示例。可以作为小步重构、行为保持型删除的范本——作者在 PR body 中清晰说明了问题来源和等价性论证，对于任何想了解 Miles 参数校验流程的人是一个不错的切入点。无需精读。