# PR #27198 完整报告

- 仓库：`sgl-project/sglang`
- 标题：docs: add SANA-WM diffusion cookbook
- 合并时间：2026-06-09 10:47
- 原文链接：http://prhub.com.cn/sgl-project/sglang/pull/27198

---

## 执行摘要

本 PR 为 SANA-WM 世界模型添加了完整的扩散模型 cookbook，覆盖双向密集生成（dense bidirectional）、离线块因果流式（batch streaming）以及实时 WebSocket（live realtime）三种服务模式。同时更新了文档导航和概述页面，并同步了实时 WebSocket 默认配置。仅涉及文档变更，不影响运行时逻辑。

## 功能与动机

根据 PR body，本次变更为“添加一个 SANA-WM 扩散 cookbook，覆盖支持的 SGLang 服务路径：密集双向生成、离线块因果流式以及实时 WebSocket 服务”。SANA-WM 是一个高效的文本 + 图像生成视频的世界模型，支持精确的 6-DoF 摄像机控制。新 cookbook 帮助用户快速上手三种部署模式，并提供了完整的 API 示例和配置参考。

## 实现拆解

1. **新增主 cookbook 页面**：`docs_new/cookbook/diffusion/SANA-WM/SANA-WM.mdx`（+498 行），详细介绍了模型特性（Hybrid Linear Attention、Dual-Branch Camera Control、Two-Stage Pipeline），并分三节展示密集双向（/v1/videos，SanaWMTwoStagePipeline）、批处理流式（/v1/videos + --streaming）和实时 WebSocket（/v1/realtime_video/generate，SanaWMRealtimePipeline）的调用方式。
2. **更新导航配置**：`docs_new/docs.json` 在 Cookbook > Diffusion 分组下新增 SANA-WM 条目，带“NEW”标签。
3. **更新概述入口**：`docs_new/cookbook/diffusion/intro.mdx` 在卡片列表中添加 SANA-WM 卡片，链接至新页面，并引用新 logo。
4. **添加图片资源**：`docs_new/cards/logos/sana.png` 作为卡片展示。
5. **同步实时默认值**：在 cookbook 中明确实时 WebSocket 的默认分辨率 832×480 和原生输出选项 1280×704，与当前代码运行时的默认值保持一致。

### 以下是 `docs_new/docs.json` 中新增的导航条目配置：

```json
// SANA-WM 导航条目，带 NEW 标签，添加到 Cookbook > Diffusion 分组
{
  "group": "SANA-WM",
  "tag": "NEW",
  "pages": [
    "cookbook/diffusion/SANA-WM/SANA-WM"
  ]
}

```

该配置使新 cookbook 页面在文档侧边栏的“Cookbook > Diffusion”下可见，方便用户查找。

## 评论区精华

无实质性 review 讨论。仅有一条 gemini-code-assist 的配额提醒，无技术争议。

## 风险与影响

- **风险**：纯文档变更，不涉及代码，风险极低。但实时 WebSocket 默认配置可能随版本变化，需维护者保持同步。
- **影响**：为使用 SANA-WM 的用户提供清晰的部署指引，降低上手难度。对系统无影响。

## 关联脉络

本次 PR 是扩散模型文档生态的一部分，此前已有多个扩散模型 cookbook（如 MOVA、LingBot World）。此 PR 无关联 Issue，且未依赖于其他代码 PR。