radixark/miles

沙箱辅助函数上收共享 recipe，统一多 provider 资源策略

值得精读，尤其是三个设计决策：`run_with_deadline` 对 `with` 块的论证（线程池 `__exit__` 会 join 被放弃的调用）、配置归属原则（描述一个沙箱的 knob 放 create 旁、fan-out knob 放后端）、异常清理的 try/except 保护模式。建议结合栈的 3/3（#2276 Modal 后端）一起看完整演进，并留意后续 PR 是否补充 provider 层单位映射测试。

OPD 固定打分统一切断梯度，防计算图泄漏

值得精读。该 PR 是训练框架中“固定输入边界”的典型实现，适合负责自定义 loss、TIS、rollout 数据流或 OPD 蒸馏的同学阅读；重点关注 `compute_advantages_and_returns` 的持久化 detach 与 `policy_loss_function` 的防御性 detach 如何互补，以及自定义 TIS 兼容性的取舍。

启动脚本快照测试移出 CI，改为手动执行

值得快速阅读，重点理解“用目录位置控制 CI 发现范围”的模式与 tests/snapshots/README.md 中固化下来的手动执行约定；若团队后续想把更多重测试移出 CI，tests/manual 目录可复用。本 PR 无源码逻辑改动，不建议作为精读对象，但建议在未来修改 tests/ci/ci_register.py 或移动 harness 时回头核对本 PR 建立的路径耦合。

为内联 model args 加 shell 引号，修复 MoE 参数被 glob 展开

值得精读。这是一个小而精的启动器修复：token 级 shlex.quote + round-trip 测试的设计思路可直接复用——它既解决了 shell 注入/展开风险，又用 'quoted 后 shlex.split 与原 argv 一致' 的判据锁死了转义正确性，避免过度转义。建议重点关注 shell_safe_model_args 的 None 分支设计（把 FSDP 特例收进函数内部）和快照最小 churn 策略（shlex.quote 只在必要时加引号），以及 CI 评论区对 'lane 无真实覆盖' 的反思——它提醒我们绿色 CI 不等于测试真的跑了。

模型配置脚本由 shell 重写为 Python，引入统一加载器

值得精读，尤其关注 load_model_args 的单行折叠设计与环境变量语义保留策略，这两处体现了对 shell 行为边界的深入理解。建议与本 PR 后紧邻的 #1911（inline model args 引号修复）和 #2279（快照测试移出 CI）一起阅读，可以完整看到一次大规模脚本迁移从引入、打补丁到成本再平衡的演进闭环。

Python 预展开模型参数，命令构建不再依赖 shell 展开

值得精读。该 PR 展示了三个可复用的技术点：如何在 python 中安全地展开 shell 数组（NUL 分隔 + 空白符断言）；如何通过环境变量冻结保证快照可复现；以及如何用快照锁定重构前后的行为一致性。建议结合 #1908、#1910、#1911 一起阅读，理解这条启动脚本重构链路的完整设计。

为全部模型脚本 argv 增加快照测试

值得精读。重点阅读 `model_args_harness.py` 中如何用最小化环境执行 shell 展开并抽取 argv，以及 `test_model_args.py` 中 `TestDiscovery` 的设计——用「集合一致性」防止快照文件失联的思路值得借鉴。此外，这组快照测试是理解后续 #1909、#1910、#1911 一系列重构的必读前提。

修复 P2P profile 的 rotary_base 未到达模型脚本的问题

值得精读。这个 PR 展示了一个最小但完整的“配置到达真实命令行”修复闭环：把单点配置抽成两个纯函数，用真实 bash 展开而非 mock 来测试，并以快照防回归。对编写启动脚本、命令构造工具或示例类代码的工程师有直接借鉴意义。重点阅读 `build_model_args_command` 中“先设变量再 source”的构造方式，以及测试中“测试真实命令而不是逻辑副本”的策略。