# PR #7710 完整报告

- 仓库：`verl-project/verl`
- 标题：[doc] fix: use fsdp_config.ulysses_sequence_parallel_size in ppo_lora.rst
- 合并时间：2026-09-03 18:30
- 原文链接：http://prhub.com.cn/verl-project/verl/pull/7710

---

## 执行摘要
本 PR 修复了 `docs/advance/ppo_lora.rst` 教程文档中一处引用了已弃用配置键的错误，将其更新为代码库中当前推荐的写法 `fsdp_config.ulysses_sequence_parallel_size`，确保了用户文档的准确性与代码行为同步。

## 功能与动机
此变更旨在修正文档与实际代码配置之间的不一致。根据 PR body 描述，顶级配置键 `actor_rollout_ref.actor.ulysses_sequence_parallel_size` 已在 `verl/trainer/config/actor/dp_actor.yaml` 中被标记为弃用，其功能已迁移至 `actor.fsdp_config` 下。然而，`ppo_lora.rst` 文档中的示例命令仍使用旧键，可能导致用户按文档操作时配置失败或产生困惑。更新文档是为了提供正确、现代的配置指导。

## 实现拆解

1. **变更定位**：变更集中于一个文件 `docs/advance/ppo_lora.rst` 的“Best Practices and Notes”章节。
2. **具体修改**：在该章节列出的示例配置参数中，将第 7 行（约第 197 行）的 `actor_rollout_ref.actor.ulysses_sequence_parallel_size=1` 替换为 `actor_rollout_ref.actor.fsdp_config.ulysses_sequence_parallel_size=1`。
3. **配套验证**：作者在提交前已确认：
 * `dp_actor.yaml` 中对旧键的弃用标记。
 * 示例脚本 `examples/tuning/lora/run_qwen3_8b_fsdp.sh` 已在使用新键。
4. **影响评估**：此变更仅涉及文档字符串，不引入任何代码逻辑、测试或配置文件的变动。

### 不适用。本次变更仅为配置键字符串在文档中的引用替换，不包含需要展示的核心实现片段。

## 评论区精华
审核过程无争议。审核者 **HollowMan6**直接批准了变更，其评论仅为 “Thank you!”，表明该修复简单明了，意图正确，无需进一步讨论。

## 风险与影响
* **风险**：风险极低。变更仅限于一个文档文件，不影响任何运行时代码或系统配置，因此无回归、性能或安全风险。
* **影响**：这是一个积极的维护性变更。
 * **用户影响**：为遵循 LoRA 教程的用户提供了准确的配置信息，提升了文档的可靠性和用户体验。
 * **团队影响**：消除了文档债务，保持了教程与代码库演进的一致性。

## 关联脉络
该 PR 是仓库文档维护工作的一部分，与近期对配置和示例脚本的清理趋势一致（例如近期 PR #7678 更新了 GRPO 示例参数）。它确保了用户指南（特别是涉及配置的教程）与代码库的实际状态保持同步，这在项目持续迭代和功能重构（如配置路径迁移）过程中非常重要。