# PR #6169 完整报告

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

---

## 执行摘要

更新了 DAPO 多模型优化实践文档，为单节点和多节点任务提供了可直接执行的启动脚本，并新增 `VLLM_VERSION` 环境变量以适配 verl 0.7.1。但 review 中发现的 `pkill -9 python` 安全隐患、`LD_PRELOAD` 路径不一致及 `MASTER_ADDR` 无默认值等问题未在合并前修复，可能影响首次使用的用户体验。

## 功能与动机

原文档仅指导用户修改脚本参数后执行示例脚本，流程不够直观。本 PR 旨在提供更完整的启动脚本，使用户能直接复制运行，降低上手难度，并适配 verl 0.7.1 的依赖要求。PR body 未关联 issue。

## 实现拆解

1. **单节点任务脚本化**：将原有“修改参数并执行”的指引替换为完整的 bash 脚本，包含 `pkill -9 python`、`ray stop --force`、环境变量导出及 ray 启动命令。
2. **多节点任务增强**：新增 `VLLM_VERSION="0.13.0"` 环境变量，明确 `NNODES`、`NPUS_PER_NODE` 等参数的含义和修改要求。
3. **文件与配置**：仅修改 `docs/ascend_tutorial/examples/dapo_multi_model_optimization_practice.md`，无代码变更。

### 无源码变更，仅文档内容更新。

## 评论区精华

> **gemini-code-assist[bot]**：`pkill -9 python` 是高危操作，建议改为 `pkill -u $USER -9 python` 或依赖 Ray 进程管理。
> **gemini-code-assist[bot]**：`/usr/local/lib/libjemalloc.so.2` 路径与文档前文 apt 安装路径不一致，会导致脚本失败。
> **gemini-code-assist[bot]**：单节点脚本中 `MASTER_ADDR` 应默认 `127.0.0.1`，避免直接复制运行出错。

所有评论均未获得作者回复，PR 由 wucong25 直接批准合并。

## 风险与影响

- **安全风险**：`pkill -9 python` 在多用户共享节点上可能误杀其他进程。
- **兼容性**：`LD_PRELOAD` 路径硬编码与文档前面的安装方式（apt）不匹配，按文档操作的用户会失败。
- **可用性**：`MASTER_ADDR` 无默认值，单节点用户复制脚本后需手动修改，否则立即报错。

影响范围限于阅读该教程的 Ascend 用户，但上述问题可能导致初次尝试失败。

## 关联脉络

本 PR 是 PR#6161 的后续更新，相同文件连续两次修改，表明该文档在快速迭代。PR 未关联 issue，也未与近期其他 PR 有直接文件依赖。