# PR #6161 完整报告

- 仓库：`verl-project/verl`
- 标题：[doc] fix: update dapo multi model optimization practice
- 合并时间：2026-04-27 13:33
- 原文链接：http://prhub.com.cn/verl-project/verl/pull/6161

---

## 执行摘要

本次 PR 更新了 DAPO 多模型优化实践文档，使硬件和软件版本适配 verl v0.7.1，包括升级 CANN、torch、vllm 等组件，并新增性能相关环境变量。变更仅涉及文档，无源码风险。

## 功能与动机

使 DAPO 多模型优化实践教程与 verl v0.7.1 版本的软件栈和推荐硬件平台保持一致，确保用户按文档操作时能正确运行。

## 实现拆解

1. **更新硬件要求**：将硬件配置从 "2 台 Atlas 800T A3" 改为 "1 台 Atlas 900 A3 SuperPoD"，反映推荐的最低硬件平台变更。
2. **升级软件版本表**：
 - CANN: 8.3.RC1 → 8.5
 - torch: 2.7.1 → 2.8.0
 - torch_npu: 2.7.1 → 2.8.0
 - verl: 特定 commit → v0.7.1 标签
 - vllm: 0.11.0 → 0.13.0
 - vllm-ascend: 0.11.0-dev → 0.13.0
 - transformers: 4.57.3 → 4.57.6
3. **修正 git checkout 命令**：将 `git checkout 252d7690...` 改为 `git checkout release/v0.7.1`（后经 review 修正为与版本表一致的 commitID）。
4. **新增性能环境变量**：在脚本中增加 `CPU_AFFINITY_CONF=2` 和 `HCCL_OP_EXPANSION_MODE="AIV"`，用于绑定 CPU 亲和性和优化 HCCL 通信。
5. **修复 URL 中的空格编码**：将训练脚本路径中的 `%20` 替换为实际下划线，使链接正确跳转。

### 无（仅文档变更）。

## 评论区精华

> Review 评论（gemini-code-assist[bot]）：" 命令使用了分支名 release/v0.7.1，与文档中应使用特定 commitID 以避免问题的说明矛盾。建议使用环境表列出的 commitID 以确保可重现性。"

> 提交历史显示第二个 commit `[docs] update pinned verl commit id` 已将分支名替换为特定 commitID，评论建议已被采纳。

## 风险与影响

**风险**：无技术风险，仅文档变更，不影响源码逻辑。若用户使用与文档不同的版本可能遇到问题，但文档本身即为正确指引。

**影响**：仅影响阅读此教程的用户，提供更准确的环境配置信息。不改变系统功能或 API，无向后兼容性问题。

## 关联脉络

该 PR 本身为独立的文档维护更新，与近期 CI/NPU 相关 PR（如 #6106、#6098、#6102）共同体现了对 Ascend NPU 平台支持的持续优化和版本同步。