执行摘要

• 一句话：Muse Glimmer cookbook 安装改为指向 PR 提交
• 推荐动作：不建议精读，内容简单直接；但有两个值得留意的实践：一是临时安装未发布功能时固定到 commit 而非分支，保证文档可复现性；二是在注释中写明来源 PR 与回退时机，降低后续维护门槛。对文档维护者，建议在 #34262 合并或 Muse Glimmer 发布后及时回退本页安装命令。

功能与动机

Muse Glimmer 支持尚未进入任何 release，uv pip install sglang 安装的版本不含该模型，原 cookbook 安装步骤对用户不可用。PR body 原话为 “Muse Glimmer support is not in a release yet, so uv pip install sglang does not work. Points the install step at #34262”，即把安装指引指向实现该功能的 PR #34262 的提交。

实现拆解

1. 变更入口：唯一致动文件是 docs/cookbook/autoregressive/Meta/MuseGlimmer.mdx 的安装小节（+3/-1）。
2. 核心改动：将 uv pip install sglang 替换为从 PR #34262 的提交 caa91b7d01ca610bb2e37bc095af6e427aa7e358 安装 sglang[all]（git+https 方式，subdirectory=python），并新增两行注释说明“支持尚未发布，故安装该提交”。
3. 提交演进：第一个 commit 直接从 muse-glimmer 分支安装；第二个 commit 改为 pin 到具体 commit hash 而非 clone 分支，避免分支后续移动导致文档安装失效，可复现性更好。
4. 测试与配套：无源码与测试改动；Mintlify 预览机器人自动渲染文档预览，用于核对渲染效果。

关键文件：

• docs/cookbook/autoregressive/Meta/MuseGlimmer.mdx（模块 使用文档；类别 docs；类型 configuration）: 唯一改动文件：将失效的 uv pip install sglang 安装步骤替换为从 PR #34262 指定提交安装，并附注释说明；整个 PR 的价值与风险都集中在这几行安装指引上。

关键符号：未识别

关键源码片段

docs/cookbook/autoregressive/Meta/MuseGlimmer.mdx

唯一改动文件：将失效的 uv pip install sglang 安装步骤替换为从 PR #34262 指定提交安装，并附注释说明；整个 PR 的价值与风险都集中在这几行安装指引上。

# Muse Glimmer 支持尚未进入正式 release，以下安装来自 PR #34262 的指定提交；
# 特性随 release 发布后应改回 `uv pip install sglang`。
pip install --upgrade pip
pip install uv
# Muse Glimmer support is not in a release yet -- install the commit from
# https://github.com/sgl-project/sglang/pull/34262
uv pip install "sglang[all] @ git+https://github.com/sgl-project/sglang@caa91b7d01ca610bb2e37bc095af6e427aa7e358#subdirectory=python"

评论区精华

本 PR 没有任何人工 review 评论：唯一评论来自 Mintlify 机器人（自动发布文档预览供核对），审核人 zijiexia 直接 approve 且未附意见。真正值得记录的“讨论”发生在两个 commit 之间：第一版从 PR 分支安装，第二版改为固定 commit hash。固定 hash 的可复现性更好、不受分支后续推送影响，代价是 PR #34262 一旦被 rebase 或 force push，该 hash 可能失效。

• 暂无高价值评论线程

风险与影响

• 风险：风险集中在文档时效性，具体到 docs/cookbook/autoregressive/Meta/MuseGlimmer.mdx 中硬编码的 commit hash（caa91b7d01ca610bb2e37bc095af6e427aa7e358）：
  1) PR #34262 若被 rebase 或 force push，该 hash 指向的内容会变化甚至失效，安装命令随之不可用；
  2) Muse Glimmer 进入正式 release 后，固定 hash 会让用户停留在旧版本，需要人为回退为 uv pip install sglang，这是必然发生的维护动作；
  3) 安装范围从 sglang 扩大到 sglang[all]，依赖更重，增大本地安装时间与磁盘占用。改动不触碰任何运行时代码，无回归、性能与安全风险。
• 影响：影响面仅限文档：
  1) 对用户：跟随 Muse Glimmer cookbook 的开发者可以实际安装成功，不再被“包内无该模型”卡住；
  2) 对系统：无任何运行时影响；
  3) 对团队：需要关注 #34262 的合并状态，并在 Muse Glimmer 随 release 发布后回退安装命令，属于轻量但持续的文档维护成本；
  4) 对同仓库其他文档：不涉及。
  • 风险标记：文档时效性风险, 硬编码 PR commit hash, 需随 release 回退

关联脉络

• PR #34262 （标题未提供，见 PR body）: PR body 明确说明安装步骤指向 #34262 —— Muse Glimmer 功能实现所在 PR，本 PR 的安装命令固定到其提交 caa91b7d01ca610bb2e37bc095af6e427aa7e358，构成“功能实现 + 文档配套”联动。
• PR #34281 Muse Glimmer Cookbook: install from the PR branch: 历史 PR 中同标题、同文件（MuseGlimmer.mdx），说明该 cookbook 的安装指引近期在同一方向上被多次调整，二者互为印证或为并行/重复改动。