# PR #30518 完整报告

- 仓库：`sgl-project/sglang`
- 标题：[diffusion] rename for lingbot world v2
- 合并时间：2026-07-08 19:06
- 原文链接：http://prhub.com.cn/sgl-project/sglang/pull/30518

---

# 执行摘要

- 一句话：重新命名 LingBot World V2 模型标识符
- 推荐动作：该 PR 属于纯命名对齐，无需精读。但可关注注册表文件中模型路径的命名规范。

# 功能与动机

使代码和文档中引用的 Hugging Face 模型仓库 ID 与实际发布的模型名称保持一致，避免运行时因路径不匹配导致模型加载失败。

# 实现拆解

1. **注册表配置更新**：在 `python/sglang/multimodal_gen/registry.py` 中，将 `LingBotWorldV2CausalDMDConfig` 对应的 `hf_model_paths` 列表中的仓库 ID 从 `"robbyant/lingbot-world-v2-diffusers"` 改为 `"robbyant/lingbot-world-v2-14b-causal-fast-diffusers"`。
2. **文档更新**：在 `docs_new/cookbook/diffusion/LingBot-World/LingBot-World-2.0.mdx` 中，将模型介绍和 `--model-path` 示例中的旧仓库 ID 替换为新 ID，同时优化了文档首句，用更具可读性的方式引用模型。

关键文件：
- `python/sglang/multimodal_gen/registry.py`（模块 多模态生成；类别 source；类型 core-logic）: 更新了 LingBot World V2 的 Hugging Face 模型仓库 ID，确保运行时能正确加载模型。
- `docs_new/cookbook/diffusion/LingBot-World/LingBot-World-2.0.mdx`（模块 文档；类别 other；类型 documentation）: 更新文档中的模型介绍和示例命令，与注册表中的模型路径保持一致。

关键符号：未识别

## 关键源码片段

### `python/sglang/multimodal_gen/registry.py`

更新了 LingBot World V2 的 Hugging Face 模型仓库 ID，确保运行时能正确加载模型。

```python
# 在 register_configs 调用中，将模型仓库 ID 更新为实际发布的名称
register_configs(
    sampling_param_cls=LingBotWorldSamplingParams,
    pipeline_config_cls=LingBotWorldV2CausalDMDConfig,
    hf_model_paths=[
        "robbyant/lingbot-world-v2-14b-causal-fast-diffusers",  # 之前为 "robbyant/lingbot-world-v2-diffusers"
    ],
)

```

# 评论区精华

Review 评论中 gemini-code-assist[bot] 建议在文档中保留人类可读的名称 "LingBot World 2.0" 而不是直接以小写模型标识符开头，以提升可读性。该建议已体现在最终代码中，首句改为更清晰的表述。

- 文档首句应保留人类可读名称 (documentation): 文档最终采纳建议，修改了首句。

# 风险与影响

- 风险：极低风险。仅涉及标识符字符串替换，无逻辑变更。若新模型路径在 HF 上不可用或格式变化，可能导致运行时错误，但该风险与 PR 本身无关。
- 影响：影响范围仅限于 LingBot World V2 模型的注册和文档引用。用户需使用新的模型路径才能正确加载模型。
- 风险标记：暂无

# 关联脉络

- PR #30361 [diffusion] support LingBot-World 2.0: 先前的 PR 添加了 LingBot World V2 的支持，本 PR 修正其模型名称以匹配实际发布。