执行摘要

此PR添加了一个新的Ring SP性能基准文档页面，详细展示了扩散模型中Ring Sequence Parallel配置的性能和内存数据对比，并更新了文档索引和导航以提升可发现性。作为纯文档变更，风险极低，主要服务于社区用户快速参考性能基准，对系统功能无直接影响。

功能与动机

该变更旨在解决扩散文档中Ring SP性能基准不易发现的问题。根据PR body描述，主要动机是"improves diffusion documentation for Ring Sequence Parallel (Ring-SP) performance and makes the benchmark entry easier to discover in the docs navigation"，目标是为特定配置（sp=2, ulysses=1, ring=2）提供清晰、可重现的性能报告，帮助社区用户理解性能增益和内存行为。

实现拆解

实现涉及三个文件的改动：

• 新增 docs/diffusion/performance/ring_sp_performance.md：核心基准页面，包含以下内容：
  • 基准设置：模型Wan2.2-TI2V-5B-Diffusers，硬件48G RTX40系列 * 2。
  • 可重现服务命令：分别针对Ring SP配置（--sp-degree 2 --ulysses-degree 1 --ring-degree 2）和基线配置（--sp-degree 1 --ulysses-degree 1 --ring-degree 1）。
  • 性能数据表格：展示阶段延迟（如Denoising从71.68s加速到52.64s，速度提升1.36x）和内存使用（如Peak GPU Memory从27.40GB降低到20.07GB）。
• 修改 docs/diffusion/performance/index.md：在索引中添加链接"Ring SP Performance"，集成新页面到现有文档结构。
• 修改 docs/index.rst：更新顶级toctree，将diffusion/performance/index和diffusion/performance/ring_sp_performance添加到SGLang Diffusion章节，确保导航中可见。

评论区精华

review讨论中仅有一次交互，由gemini-code-assist[bot]提出格式改进建议：

"The 'Benchmark Disclaimer' text appears to be a sub-heading but is not formatted as one. To improve the document structure and readability, consider making it a level-3 heading"

此建议在后续提交中被采纳，将免责声明文本更新为子标题格式，提升了文档可读性。无其他技术争议或深度讨论。

风险与影响

风险分析：由于是纯文档变更，无代码逻辑改动，技术风险极低。主要潜在风险在于基准数据的准确性——数据基于特定测试环境（如模型版本、硬件配置），未在文档中验证，可能因环境差异导致用户误解。例如，ring_sp_performance.md中的性能数据若未定期更新，可能过时。

影响分析：影响范围限于文档用户：

• 正面影响：社区用户能更方便地访问Ring SP性能基准，参考数据进行模型部署和优化，加速扩散模型应用。
• 中性影响：对系统运行时、性能或安全性无影响，因为未修改任何核心代码。
• 文档结构改进有助于提升整体用户体验，符合仓库对性能文档的重视趋势。

关联脉络

此PR是扩散模型文档演进的一部分。从历史PR分析中可见相关趋势：

• PR #21648（"[diffusion] feat: enhance overlay mechanism"）：同样涉及扩散模型文档更新（如docs/diffusion/api/cli.md），显示扩散模块的文档持续优化，以支持新功能和用户体验。
• PR #19395（"MFU metrics in Prometheus"）：添加性能相关文档（如docs/references/production_metrics.md），反映仓库对性能监控和基准文档的投入，与此PR的绩效基准主题一致。

这些关联PR表明，sglang项目正通过文档改进来增强扩散模型和性能相关的可访问性，帮助用户更好地理解和利用系统能力。