# PR #26958 完整报告

- 仓库：`sgl-project/sglang`
- 标题：[diffusion] doc: add cookbook for lingbot-world
- 合并时间：2026-06-02 14:35
- 原文链接：http://prhub.com.cn/sgl-project/sglang/pull/26958

---

# 执行摘要

- 一句话：新增 LingBot World 实时 diffusion cookbook
- 推荐动作：建议读者阅读 LingBot World cookbook 了解实时 world model 的部署流程。文档的实时模型分类定义也值得关注，反映了 SGLang-diffusion 中离线与实时模型的架构区分。

# 功能与动机

该文档从 #26954（LingBot 实时运行时支持）中拆分出来，使得文档可以独立于运行时代码进行审查和合并。PR 依赖 #26954 中的运行时支持。

# 实现拆解

1. **新增 cookbook 文件**：创建 `docs_new/cookbook/diffusion/LingBot-World/LingBot-World.mdx`，提供 LingBot World 模型介绍、快速启动和 streaming 用法。
2. **更新概览页面**：在 `docs_new/cookbook/diffusion/intro.mdx` 中添加“Realtime / World Models”分类，并加入指向 LingBot World 的卡片。
3. **注册导航**：在 `docs_new/docs.json` 的 Diffusion cookbook 分组中新增 "LingBot World" 条目，链接到新页面。
4. **顺便清理**：简化 `docs_new/cookbook/diffusion/Cosmos/Cosmos3.mdx` 中的命令示例，移除多余的默认参数（如 `--model-type`, `--host`, `--port`, `--output-path`），使示例更简洁。

关键文件：
- `docs_new/cookbook/diffusion/LingBot-World/LingBot-World.mdx`（模块 文档；类别 other；类型 core-logic）: 新增 cookbook 页面，提供 LingBot World 模型完整的使用文档。
- `docs_new/cookbook/diffusion/intro.mdx`（模块 文档；类别 other；类型 core-logic）: 更新 diffusion cookbook 概览页面，新增 Realtime / World Models 分类并添加 LingBot World 入口卡片。
- `docs_new/docs.json`（模块 文档配置；类别 config；类型 configuration）: 导航配置，添加 LingBot World 分组链接，确保新页面可访问。
- `docs_new/cookbook/diffusion/Cosmos/Cosmos3.mdx`（模块 文档；类别 other；类型 core-logic）: 附带清理，简化命令示例，移除多余的默认参数。

关键符号：未识别


# 评论区精华

没有 open 的 review 讨论。PR 包含两个来自 gemini-code-assist 的机器人警告（超出每日配额），与文档内容无关。

- 暂无高价值评论线程

# 风险与影响

- 风险：
 1. **文档准确性风险**：LingBot World cookbook 依赖于 #26954 中的运行时 API，若运行时接口变更，文档可能过时。
 2. **命令兼容性风险**：在 Cosmos3.mdx 中移除了 `--model-type` 等参数，虽然这些是默认值，但用户若使用旧命令可能失败（若之前显式指定了不同值）。
 3. **缺乏测试**：该 PR 没有配套测试，但作为文档通常可接受。
 - 影响：用户：为 LingBot World 模型提供了完整的部署和使用指引，降低了使用门槛。开发者：文档独立维护，与运行时代码解耦。系统：无运行时变更。
 - 风险标记：依赖运行时 PR #26954, 命令参数简化可能不兼容 , 文档无自动测试

# 关联脉络

- PR #26954 [diffusion] misc: 本 PR 的依赖项，提供了 LingBot World 的运行时支持，包括实时扩散管道和 causal denoising 实现。
- PR #26959 [diffusion] add WebUI: 同属 diffusion 功能线，为相同的实时视频模型提供 Web 前端。