Prhub

#34626 [Docs] Use Meta's canonical Muse Glimmer GGUF filename

原始 PR 作者 Jiminator 合并时间 2026-08-13 07:07 文件变更 1 提交数 1 评论 0 代码增减 +1 / -1

执行摘要

官方 GGUF 文件名更新 Muse Glimmer cookbook 配置

Meta 将 meta-models/Muse-Glimmer-30B-GGUF 仓库工件重命名为编码量化类型的规范命名方案(hub discussion #5),并请求下游仓库同步。PR body 指出 cookbook 的 GGUF 单元格通过 modelNames["default|gguf"] 解析 MODEL_NAME,这是仓库中唯一遗留旧名称的引用(已验证全仓库搜索四个旧名称均无其他匹配)。

该 PR 为纯文档字符串变更,无需精读,但值得关注其展示的规范命名验证流程——全仓库搜索旧名称、新名称在 Hub 上验证可用、以及明确不更新其他名称的理由。对维护 cookbook 配置文件的贡献者有参考价值。

讨论亮点

无 review 评论。审阅者 zijiexia 批准(APPROVED),无讨论。

实现拆解

  1. 修改 docs/src/snippets/configs/meta-models/muse-glimmer.jsxmodelNames 对象:将 "default|gguf" 键对应的值从 meta-models/Muse-Glimmer-30B-GGUF/muse-glimmer-30B-kquant-17gb.gguf 改为 meta-models/Muse-Glimmer-30B-GGUF/Muse-Glimmer-30B-KQuant-17GB-Q4_K_M.gguf
  2. 明确不更新其他三个旧名称:dynamic/Q4_K_XL 不在 cookbook 量化选项中;mmproj 由于 SGLang 没有 mmproj 路径且文档已注明 GGUF 路由仅支持文本而不可用;GGUF DFlash 草稿模型未被使用,rtx5090 + gguf + dflash 单元格实际使用 HF 草稿模型 meta-models/Muse-Glimmer-30B-assistant 并指定 --speculative-draft-load-format auto
  3. 该文件是 cookbook 页面的配置源,MODEL_NAME 占位符被命令和 curl 模板引用,因此此修改会自动传播到所有生成的 GGUF 配置单元格。
文件 模块 状态 重要度
docs/src/snippets/configs/meta-models/muse-glimmer.jsx 文档配置 modified 4.13

关键源码片段

docs/src/snippets/configs/meta-models/muse-glimmer.jsx data-contract

cookbook 配置源文件,其中的 modelNames 映射定义了不同量化格式的模型标识符,本次修改的 `default|gguf` 条目是所有 GGUF 部署单元格的命令生成基础。

export const config = {
  // ...
  modelNames: {
    // GGUF 文件名跟随 Meta 官方规范命名,编码量化类型:
    // 旧名 muse-glimmer-30B-kquant-17gb.gguf → 新名 Muse-Glimmer-30B-KQuant-17GB-Q4_K_M.gguf
    "default|bf16": "meta-models/Muse-Glimmer-30B",
    "default|gguf": "meta-models/Muse-Glimmer-30B-GGUF/Muse-Glimmer-30B-KQuant-17GB-Q4_K_M.gguf",
    "default|nvfp4": "RadixArk/Muse-Glimmer-NVFP4",
    "default|mlx-q4": "RadixArk/Muse-Glimmer-q4-MLX",
    "default|mlx-q4km": "RadixArk/Muse-Glimmer-q4km-gs128-MLX",
    "default|mlx-q4k-dyn": "RadixArk/Muse-Glimmer-q4k-dynamic-MLX",
  },
  // ...
}

评论区精华

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

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

风险与影响

极低风险。唯一变更是一行文档配置字符串,无代码逻辑或运行时影响。潜在轻微风险:如果 Hugging Face 旧名称被移除后新名称解析存在大小写或 URL 编码问题(文件名含大写字母),但 PR body 说明新名称已在 Hub 上有效,且当前新旧名称并存,因此预计无实际问题。

影响范围极小:仅影响 Muse Glimmer cookbook 的 GGUF 配置单元格,用户复制部署命令时会使用新文件名。无运行时影响、无 API 变化、无性能影响。

文档字符串变更

关联 Issue

未识别关联 Issue

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

完整报告

参与讨论