Prhub

#26958 [diffusion] doc: add cookbook for lingbot-world

原始 PR 作者 mickqian 合并时间 2026-06-02 14:35 文件变更 4 提交数 3 评论 2 代码增减 +203 / -10

执行摘要

新增 LingBot World 实时 diffusion cookbook

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

建议读者阅读 LingBot World cookbook 了解实时 world model 的部署流程。文档的实时模型分类定义也值得关注,反映了 SGLang-diffusion 中离线与实时模型的架构区分。

讨论亮点

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

实现拆解

  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 文档 added 5.55
docs_new/cookbook/diffusion/intro.mdx 文档 modified 3.72
docs_new/docs.json 文档配置 modified 3.61
docs_new/cookbook/diffusion/Cosmos/Cosmos3.mdx 文档 modified 3.09

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

评论区精华

没有提炼出高价值讨论线程

当前评论区没有形成足够清晰的争议点或结论,后续有更多讨论时会体现在这里。

风险与影响

  1. 文档准确性风险:LingBot World cookbook 依赖于 #26954 中的运行时 API,若运行时接口变更,文档可能过时。
  2. 命令兼容性风险:在 Cosmos3.mdx 中移除了 --model-type 等参数,虽然这些是默认值,但用户若使用旧命令可能失败(若之前显式指定了不同值)。
  3. 缺乏测试:该 PR 没有配套测试,但作为文档通常可接受。

用户:为 LingBot World 模型提供了完整的部署和使用指引,降低了使用门槛。开发者:文档独立维护,与运行时代码解耦。系统:无运行时变更。

依赖运行时 PR #26954 命令参数简化可能不兼容 文档无自动测试

关联 Issue

未识别关联 Issue

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

完整报告

参与讨论