# PR #32932 完整报告

- 仓库：`sgl-project/sglang`
- 标题：docs: surface diffusion AR and PE guides
- 合并时间：2026-07-30 21:05
- 原文链接：http://prhub.com.cn/sgl-project/sglang/pull/32932

---

# 执行摘要

- 一句话：将 AR 和 PE 指南加入 SGLang Diffusion 导航
- 推荐动作：该 PR 为纯文档变更，无需深入代码审查。建议合并，以消除文档漂移。

# 功能与动机

修复 ERNIE-Image prompt-enhancement 页面已添加但不可从公共文档导航或主入口点访问的问题，消除文档漂移，使 `--pe-server-url` 等新功能更容易被发现。

# 实现拆解

1. **更新 `docs_new/docs.json` 导航配置**：在 Usage 分组中添加 `models_with_ar` 和 `models_with_pe` 两个页面入口。
2. **更新 `index.mdx` 入口页面**：在“Additional Documentation”部分添加指向这两个指南的链接。
3. **修复 CLI 参考文档 `cli.mdx`**：为 `--srt-encoder-url` 和 `--pe-server-url` 添加指向对应指南的站内链接。
4. **修复 AR 和 PE 指南中的示例命令**：在 `models_with_ar.mdx` 和 `models_with_pe.mdx` 中为 diffusion server 添加显式 `--port` 参数，并替换 PE 指南中的 GitHub 源链接为 `See ...` 站内跳转。

关键文件：
- `docs_new/docs.json`（模块 文档配置；类别 config；类型 configuration）: 文档导航配置，添加了两个新页面入口，决定了指南在侧边栏的可见性。
- `docs_new/docs/sglang-diffusion/models_with_pe.mdx`（模块 文档页面；类别 other；类型 data-contract）: PE 指南主要内容修改：添加 description、修复命令示例（添加 --port）、替换外部链接为站内链接。
- `docs_new/docs/sglang-diffusion/models_with_ar.mdx`（模块 文档页面；类别 other；类型 data-contract）: AR 指南主要内容修改：添加 description、修复命令示例（添加 --port）。
- `docs_new/docs/sglang-diffusion/api/cli.mdx`（模块 文档页面；类别 other；类型 entrypoint）: CLI 参考文档，为两个重要 CLI 参数添加站内链接，提升文档互连。
- `docs_new/docs/sglang-diffusion/index.mdx`（模块 文档页面；类别 other；类型 core-logic）: Diffusion 文档首页，添加指向 AR 和 PE 指南的链接，使新功能更容易被发现。

关键符号：未识别


# 评论区精华

该 PR 无人工 review 讨论，仅包含两条 Gemini Code Assist 自动评论（已 sunset，无实际内容）。

- 暂无高价值评论线程

# 风险与影响

- 风险：无技术风险。仅涉及文档元数据、导航配置和示例文本变更，不影响任何运行时行为。
- 影响：用户现在可以直接从 SGLang Diffusion 文档站发现并阅读 AR 和 PE 部署指南，无需回退到源码树链接；CLI 参数文档也会指向相关指南，提升可发现性。
- 风险标记：暂无

# 关联脉络

- PR #30211 [diffusion] encoder_parallel: unify encoder folding and batch data-parallel encoding: 同一 diffusion 功能线，引入了 PE 等新功能，本 PR 的文档补充使其可被发现。