# PR #23924 完整报告

- 仓库：`sgl-project/sglang`
- 标题：[Diffusion] Move ModelOpt checkpoints to lmsys
- 合并时间：2026-05-02 17:18
- 原文链接：http://prhub.com.cn/sgl-project/sglang/pull/23924

---

# 执行摘要

- 一句话：将 ModelOpt 检查点引用从 BBuf 迁移至 lmsys
- 推荐动作：此 PR 属于基础设施清理，建议快速合并以完成仓库迁移，提高项目的长期可维护性。读者可以关注其组织级仓库管理策略，对于类似依赖清理有参考价值。

# 功能与动机

PR 描述指出需要将扩散模型 ModelOpt 检查点从个人 BBuf/* 仓库迁移到干净的 lmsys/* 组织仓库，以统一管理并减少对个人空间的依赖。参见 Hugging Face 集合 : https://huggingface.co/collections/lmsys/diffusion-modelopt-69f06a1740c02269e36bf285

# 实现拆解

实现分为四步：
1. 更新测试配置文件 `testcase_configs.py` 中 6 个 ModelOpt 仓库常量，将 `BBuf/` 前缀替换为 `lmsys/`。
2. 更新 `docs_new/docs/sglang-diffusion/quantization.mdx` 文档中的表格和说明文字，对应修改仓库路径。
3. 更新 `docs/diffusion/quantization.md` 文档，同步修改仓库路径和说明。
4. 更新 Claude 技能 `SKILL.md` 中的示例注释，将 `BBuf/*` 改为 `lmsys/*`。
所有修改均为纯字符串替换，保持与原始检查点一一对应。

关键文件：
- `python/sglang/multimodal_gen/test/server/testcase_configs.py`（模块 测试配置；类别 test；类型 test-coverage；符号 MODELOPT_FLUX1_FP8_TRANSFORMER, MODELOPT_FLUX2_FP8_TRANSFORMER, MODELOPT_WAN22_FP8_TRANSFORMER, MODELOPT_FLUX1_NVFP4_TRANSFORMER）: 测试配置文件，定义了 B200 CI 使用的 ModelOpt 仓库常量，是本 PR 的核心变更之一，直接影响自动化测试。
- `docs_new/docs/sglang-diffusion/quantization.mdx`（模块 文档；类别 docs；类型 documentation）: 新版文档中的量化表格，更新了仓库路径引用，影响用户阅读文档时的链接。
- `docs/diffusion/quantization.md`（模块 文档；类别 docs；类型 documentation）: 旧版文档，同步更新路径引用，保持与新版文档一致。
- `python/sglang/multimodal_gen/.claude/skills/sglang-diffusion-modelopt-quant/SKILL.md`（模块 技能；类别 docs；类型 documentation）: Claude 技能文档，更新了仓库路径示例注释以匹配新组织。

关键符号：未识别

## 关键源码片段

### `python/sglang/multimodal_gen/test/server/testcase_configs.py`

测试配置文件，定义了 B200 CI 使用的 ModelOpt 仓库常量，是本 PR 的核心变更之一，直接影响自动化测试。

```python
# 将以下常量从 BBuf 迁移到 lmsys 组织，对应 Hugging Face 集合
MODELOPT_FLUX1_FP8_TRANSFORMER = "lmsys/flux1-dev-modelopt-fp8-sglang-transformer"
MODELOPT_FLUX2_FP8_TRANSFORMER = "lmsys/flux2-dev-modelopt-fp8-sglang-transformer"
MODELOPT_WAN22_FP8_TRANSFORMER = "lmsys/wan22-t2v-a14b-modelopt-fp8-sglang-transformer"
MODELOPT_FLUX1_NVFP4_TRANSFORMER = "lmsys/flux1-dev-modelopt-nvfp4-sglang-transformer"
MODELOPT_WAN22_NVFP4_TRANSFORMER = "lmsys/wan22-t2v-a14b-modelopt-nvfp4-sglang-transformer"
# FLUX.2 NVFP4 保持官方路径不变
MODELOPT_FLUX2_NVFP4_WEIGHTS = "black-forest-labs/FLUX.2-dev-NVFP4"

```

# 评论区精华

review 过程中无实质性讨论。gemini-code-assist 机器人表示无反馈，维护者 mickqian 提供了 Approval。

- 暂无高价值评论线程

# 风险与影响

- 风险：风险极低：变更仅涉及字符串常量，不影响控制流。主要风险在于 lmsys 仓库的可用性：如果仓库被删除或路径变化，CI 和文档将失效。但 lmsys 是组织仓库，比个人仓库更稳定。此外，官方 black-forest-labs 路径未修改，减少影响面。
- 影响：直接影响：所有使用这些模型路径的 CI 测试、文档用户和 Claude 技能将指向新的组织仓库。影响范围限于 SGLang 扩散量化功能模块。无向后兼容性问题，因为旧路径不再维护。用户需更新本地引用以继续使用这些预量化模型。
- 风险标记：低风险 , 路径依赖 , 配置变更

# 关联脉络

- PR #23625 Flux2 nvfp4 quantization correctness on Blackwell (B200): 该 PR 同样涉及 ModelOpt 量化检查点和 testcase_configs.py 配置，与本 PR 共享量化依赖路径。
- PR #22625 [diffusion] model: support JoyAI-Image-Edit: 该 PR 引入了新的 diffusion 模型，使用相同的 ModelOpt 量化框架，未来可能需要更新 lmsys 检查点引用。