执行摘要
- 一句话:统一 Qwen3.5 NPU 文档,支持 35B 和 122B
- 推荐动作:建议阅读新建的统一指南
qwen3_5_megatron_npu.md,了解 Qwen3.5 在 Ascend NPU 上使用 Megatron+vLLM 进行 GRPO 训练的完整流程,特别是多机 Ray 集群启动参数和并行策略配置。维护者应关注 Docker 镜像和 commit 的时效性,及时更新文档中的版本号。
功能与动机
PR 标题和描述指出需要对 Qwen3.5 的 Ascend 文档进行更新,以覆盖 35B 和 122B 两种模型尺寸。原有的文档仅针对 122B 模型,新增 35B 支持后需要合并为一份指南,便于用户查阅并统一镜像和依赖版本。
实现拆解
实现步骤如下:
- 创建统一指南:在
docs/ascend_tutorial/model_support/examples/ 下新增 qwen3_5_megatron_npu.md,同时包含 Qwen3.5-35B-A3B 和 Qwen3.5-122B-A10B 两个模型的版本要求、硬件并行配置(TP/PP/CP/EP/ETP/GEN_TP)、数据准备命令、Ray 集群启动步骤以及训练执行示例。
- 删除旧文件:移除原有的
qwen3_5_122b_npu.md,避免内容重复。
- 更新引用:修改
model_and_algorithm_support.md 中第 41 行(Qwen3.5-122B-A10B)的示例链接,从旧文件指向新文件的路径。
- 调整索引:更新
docs/ascend_tutorial/index.rst 中的 toctree 条目,将 qwen3_5_122b_npu 替换为 qwen3_5_megatron_npu。
所有变更均为纯文档操作,不涉及任何代码逻辑修改。
关键文件:
docs/ascend_tutorial/model_support/examples/qwen3_5_megatron_npu.md(模块 文档;类别 docs;类型 documentation): 新创建的统一指南,覆盖 35B 和 122B 两个模型,是本次 PR 的核心变更
docs/ascend_tutorial/model_support/examples/qwen3_5_122b_npu.md(模块 文档;类别 docs;类型 deletion): 被统一指南替代,删除以避免内容重复
docs/ascend_tutorial/model_support/model_and_algorithm_support.md(模块 文档;类别 docs;类型 documentation): 更新 Qwen3.5-122B-A10B 行的示例链接,指向新的统一指南
docs/ascend_tutorial/index.rst(模块 文档;类别 docs;类型 documentation): 更新文档索引中的 toctree 条目,替换为新的指南文件名
关键符号:未识别
评论区精华
该 PR 无实质性人工讨论。合并前仅有 Gemini Code Assist 机器人自动评论总结变更内容,随后被维护者 wucong25 直接批准合并,未提出任何修改意见。
风险与影响
- 风险:虽然是文档变更,但仍有以下风险需关注:
- 链接断裂:旧文件
qwen3_5_122b_npu.md 被删除,若其他文档或外部 URL 直接引用该路径,将导致 404。需确认仓库内及外部引用均已更新。
- 版本同步:新文件推荐的 Docker 镜像 Tag
verl-9.0.0-a3-ubuntu22.04-py3.11-latest 和 CANN 版本 9.0.0 必须与镜像构建实际情况一致,否则用户可能无法使用。
- Commit 引用:文档中指定 verl commit 为
cdd9014f,该 Commit 可能随开发推进而被新 Commit 替代,用户需要关注对应版本的兼容性。
- 影响:对用户:NPU 场景用户将获得更完整的 Qwen3.5 GRPO 训练文档,特别是新增了 35B 模型的示例配置;需要从旧文档迁移的用户需注意路径变化。对团队:文档维护成本降低,后续新增模型只需修改统一指南。影响面仅限于文档内容,无功能影响。
- 风险标记:文档链接断裂风险, 依赖版本可能过期, 删除文件后外部引用需检查
关联脉络
- PR #6640 [doc] chore: Update ascend_vllm_best_practices.rst: 同为 Ascend NPU 文档优化,构成本仓库 NPU 文档更新系列
- PR #6617 [doc] chore: Update index.rst: 前后对 Ascend 文档索引进行了重构,本 PR 在此基础上进一步调整 toctree 条目
参与讨论