Prhub

#29302 [codex] fix diffusion docs and cookbook drift

原始 PR 作者 mickqian 合并时间 2026-06-25 21:13 文件变更 12 提交数 3 评论 6 代码增减 +51 / -46

执行摘要

修复 diffusion 文档链接与语法错误

PR body 指出:fix remaining public SGLang-Diffusion doc drift in the GitHub README and diffusion cookbook pages - replace legacy GitHub/blob links with current docs.sglang.io diffusion docs pages - add missing public notes for --warmup-mode and the Cache-DiT vs FSDP incompatibility

建议维护者快速合并,以消除文档不一致。未来应建立文档链接检查机制,防止类似漂移。开发者可参考此 PR 继续修复其他残留语法问题。

讨论亮点

语法修正建议:gemini-code-assist[bot] 在 5 个模型 cookbook 文件(FLUX.mdx、MOVA.mdx、Qwen-Image-Edit.mdx、Wan2.2.mdx、Z-Image-Turbo.mdx)中指出“Current supported optimization all listed”语法错误,建议改为“Currently supported optimizations are listed”。但 PR 最终未采纳此建议,其他文件(如 Krea-2.mdx)已用正确语法,造成不一致。

实现拆解

  1. 更新 docs_new/cookbook/diffusion/README.mdx,将仓库名从 sgl-cookbook 改为 sglang,并将所有路径从 sgl-cookbook/docs/diffusion/ 改为 docs_new/cookbook/diffusion/,同时将外部链接指向 docs.sglang.io。
  2. docs_new/docs/sglang-diffusion/caching-acceleration.mdx 中添加 <Note> 块,说明 Cache-DiT 与 --use-fsdp-inference 互斥,提醒用户避免同时启用。
  3. docs_new/docs/sglang-diffusion/api/cli.mdx 中补充 --warmup-mode 参数说明。
  4. 在多个模型 cookbook 页面(FLUX、MOVA、Qwen-Image-Edit、Wan2.2、Z-Image-Turbo)中将兼容性矩阵和 API 文档链接替换为相对路径,并修正配套的语法错误(尽管语法修正不完全,但链接已更新)。
  5. 更新 python/sglang/multimodal_gen/README.md 中的仓库和文档链接,保持与主文档一致。
文件 模块 状态 重要度
docs_new/cookbook/diffusion/README.mdx cookbook modified 3.83
docs_new/docs/sglang-diffusion/caching-acceleration.mdx 扩散文档 modified 2.92
docs_new/cookbook/diffusion/FLUX/FLUX.mdx cookbook modified 2.44
python/sglang/multimodal_gen/README.md 源码文档 modified 2.23
docs_new/cookbook/diffusion/Qwen-Image/Qwen-Image-Edit.mdx cookbook modified 2.44

分析完成后,这里会展示 LLM 生成的相对完整源码片段和详细注释。

评论区精华

语法修正:优化描述语法 style

gemini-code-assist[bot] 指出 'Current supported optimization all listed' 语法错误,建议改为 'Currently supported optimizations are listed',并引用 Krea-2.mdx 的正确用法。

结论:建议未被采纳,PR 中未修改这些文件的语法,导致不一致。 · dismissed

风险与影响

低风险。仅涉及文档文件和链接变更,不会影响代码逻辑。需确保所有替换的链接正确可达,避免出现死链。Cache-DiT 互斥提示若放置不当可能引起歧义。

影响范围包括所有访问 SGLang-Diffusion 文档的用户。文档一致性提升,用户能获取最新兼容性信息和使用指导。CI 测试不受影响。

低风险 文档变更 链接准确性依赖

关联 Issue

未识别关联 Issue

当前没有检测到明确关联的 Issue 链接,后续同步到相关引用后会出现在这里。

完整报告

参与讨论