# PR #6573 完整报告

- 仓库：`verl-project/verl`
- 标题：[doc] chore: Update ascend_sglang_best_practices.rst
- 合并时间：2026-06-02 19:23
- 原文链接：http://prhub.com.cn/verl-project/verl/pull/6573

---

## 执行摘要
该 PR 更新了 Ascend SGLang 最佳实践文档，移除了 Qwen2.5-32B 模型配置，更新 Qwen3-30B 脚本路径，修复断链并添加性能采集依赖，确保文档与最新代码仓库保持一致。

## 功能与动机
文档中的模型脚本路径和链接已过时，需要同步更新以避免用户执行错误的脚本或遇到无效链接。

## 实现拆解

1. 移除 Qwen2.5-32B 模型链接及相关内容（下载权重、数据集等），因为该模型不再被推荐使用。
2. 更新 Qwen3-30B 脚本路径从 `examples/grpo_trainer/run_qwen3moe-30b_sglang_megatron_npu.sh` 到 `examples/ascend_extras/grpo_trainer/run_qwen3_30b_a3b_megatron.sh`。
3. 删除部分训练配置（如 `use_dist_checkpointing` 等）以简化文档。
4. 在性能采集部分的 pip 安装命令中添加 `timm` 等依赖。
5. 更新文档时间戳和内部链接，修复因删除 Qwen2.5-32B 导致的断链。

### 无关键源码片段（仅文档变更）。

## 评论区精华
> Gemini Code Assist 机器人指出：
> - 第 97 行仍引用旧的 Qwen3-30B 脚本路径，需统一更新。
> - 删除 Qwen2.5-32B 后，第 175 行的交叉引用失效，会导致 Sphinx 编译失败。
> 这两个问题在最终合并前已修复。

## 风险与影响
低风险。仅文档更新，不影响代码功能。修复了断链和路径不一致问题，提升文档质量。

## 关联脉络
此前已有多个 Ascend 文档相关 PR（#6534、#6532）持续改进文档质量和完整性。