Prhub

#7091 [doc] refactor: point MLite DAPO example to canonical launcher

原始 PR 作者 ISEEKYAN 合并时间 2026-07-20 10:59 文件变更 1 提交数 1 评论 0 代码增减 +7 / -187

执行摘要

将 DAPO 示例脚本重定向到规范启动器

PR body 指出,verl 中的副本已与活跃维护的 DS4 RL 集成产生分歧。规范脚本现在涵盖了经过验证的 W4/W8 rollout 设置、router replay 开关、依赖锁定、原生 veRL 数据集路径和 Megatron-Lite 运行时配置。保持两个完整启动器会导致修复容易遗漏,并可能把用户引向不受支持的路径。

此 PR 展示了一种消除重复配置的实用模式:用带有明确指引的存根替换过时的副本。对于使用 DeepSeek V4 启动器的用户,建议立即迁移到规范启动器;对于仓库维护者,可参考此做法管理其他可能分叉的示例脚本。

讨论亮点

本 PR 没有产生实质性 review 讨论。wuxibin89 批准了变更,gemini-code-assist[bot] 自动评论了代码审阅但未提出任何问题。

实现拆解

实现分为两步:

  1. 删除 examples/grpo_trainer/run_deepseek_v4_megatron_lite.sh 中原来 187 行的巨型启动脚本(包含注释、环境变量设置、模型变体选择逻辑等)。
  2. 添加一个 7 行的存根,输出迁移指引信息并显示规范启动器的 URL(https://github.com/verl-project/Megatron-LM/blob/lite/experimental/lite/examples/verl/scripts/run_deepseek_v4_dapo.sh),然后以非零状态退出。
    该存根保留了可执行性,原有调用者会收到明确的迁移地址而非静默运行过时脚本。
文件 模块 状态 重要度
examples/grpo_trainer/run_deepseek_v4_megatron_lite.sh 示例脚本 modified 4.33

分析完成后,这里会展示 LLM 生成的相对完整源码片段和详细注释。

评论区精华

没有提炼出高价值讨论线程

当前评论区没有形成足够清晰的争议点或结论,后续有更多讨论时会体现在这里。

风险与影响

风险极低。该存根会破坏直接使用该脚本的现有工作流(脚本退出非0),但提供了明确的迁移路径。不影响核心训练、 rollout 或其他组件。没有性能或安全影响。

影响范围限于使用 examples/grpo_trainer/run_deepseek_v4_megatron_lite.sh 的用户,他们将收到错误消息和规范启动器链接。对团队而言,消除了维护两套 DeepSeek V4 启动配置的负担。长期影响是积极的——所有改进均集中在规范启动器上。

低风险 示例脚本

关联 Issue

未识别关联 Issue

当前没有检测到明确关联的 Issue 链接,后续同步到相关引用后会出现在这里。

完整报告

参与讨论