Prhub

#34886 [Docs] Update Kimi-K3 installation options

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

执行摘要

Kimi-K3 文档改用标准 Python/Docker 安装方式

Kimi-K3 的 cookbook 此前仍引导读者使用预发布专有镜像和 kimi-k3 分支的 Dockerfile。PR body 明确指出:Now that Kimi-K3 is supported by the current SGLang release paths, the installation section should use the standard Python and Docker instructions。即 K3 已进入标准发布路径,安装文档应回归官方统一说明,避免读者绕道源码构建或使用过时镜像标签。

该 PR 体量小、无技术讨论,适合快速浏览而非精读。值得借鉴的是“模型从预发布到正式发布后文档收敛”的流程样板:新增标准安装标签页、统一发布镜像标签、删除预发布 Dockerfile 回退、保留官方链接。若正在维护其他模型 cookbook(如 Qwen3.8-27B、GLM-5.2)可参考其 Accordion / Tabs 结构与文档校验命令。

讨论亮点

本 PR 没有产生任何 review 评论或讨论线程,作者自审并直接合入,属于低争议的文档收尾变更。

实现拆解

  1. 变更入口:唯一改动文件为 docs/cookbook/autoregressive/Moonshotai/Kimi-K3.mdx,改动集中在 Install SGLang 的 Accordion 折叠面板内,保持页面整体结构和命令面板布局不变。
  2. 新增 Python 安装路径:在原有 Docker 标签页前新增 Python (pip / uv) 标签页,给出 pip install --upgrade pip、pip install uv、uv pip install sglang 三步命令,并提示用户运行命令面板生成的 Python 启动命令,使安装说明与部署命令面板的 Python / Docker 切换一一对应。
  3. 统一 Docker 镜像标签:删除 kimi-k3(CUDA13)、kimi-k3-cu12(CUDA12)和 ROCm daily 三个预发布镜像标签,替换为 lmsysorg/sglang:latest,并保留指向官方安装指南 Method 3 的 Docker 启动方式说明。
  4. 清理预发布残留:移除“直到这些标签随公开 K3 发布”的过时声明,以及指向 kimi-k3 分支两个 Dockerfile 的回退指引,防止用户误用源码构建路径。
  5. 配套验证:本 PR 为纯文档变更,未增删测试;作者使用 node docs/scripts/check_cookbook_configs.mjs、mint validate、mint broken-links 校验了文档配置、格式和链接完整性。
文件 模块 状态 重要度
docs/cookbook/autoregressive/Moonshotai/Kimi-K3.mdx 安装文档 modified 2.85

关键源码片段

docs/cookbook/autoregressive/Moonshotai/Kimi-K3.mdx documentation

本 PR 唯一变更文件,集中改写了 Kimi-K3 安装说明,是文档更新的全部内容载体。

<Accordion title="Install SGLang">
  <!-- 安装说明与命令面板的 Python / Docker 开关保持一一对应 -->
  <Tabs>
    <Tab title="Python (pip / uv)">
      <!-- 使用 uv 统一管理 Python 依赖,再运行下方命令面板生成的 Python 启动命令 -->
      ```bash
      pip install --upgrade pip
      pip install uv
      uv pip install sglang
      ```
      Then run the **Python** output of the command panel below in that environment.
    </Tab>
​
    <Tab title="Docker">
      <!-- 直接使用当前发布镜像,取代预发布的 kimi-k3 / kimi-k3-cu12 等标签 -->
      ```bash
      docker pull lmsysorg/sglang:latest
      ```
      For how to launch the image, see
      [Install → Method 3: Using Docker](../../../docs/get-started/install#method-3-using-docker).
    </Tab>
  </Tabs>
</Accordion>

评论区精华

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

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

风险与影响

风险较低但仍有几点需要注意:

  • 文档一致性风险:文档已将 Docker 标签固定为 lmsysorg/sglang:latest,若未来某版本镜像回退或不包含 Kimi-K3 支持,文档将过时;broken-links 只能保证链接不失效,无法校验内容语义。
  • 用户迁移风险:原预发布 ROCm daily 镜像(v0.5.16-rocm720-mi35x)和 CUDA12 镜像的用户,切换 latest 后需自行确认对应硬件平台的镜像仍可用。
  • CI 观察项:PR 的 Extra 测试标记为失败(Run #31849432967),且未说明原因;由于本 PR 不触达运行时代码,该失败大概率是无关的既有问题,但合入时可留意有无连带影响。

影响范围集中在文档读者与文档维护者:

  • 读者:Kimi-K3 部署用户不再需要区分预发布镜像标签,只需按标准 Python 或 Docker 流程安装,降低操作歧义和复制成本。
  • 团队:文档从双轨发布收敛为单一发布路径,后续 K3 相关文档(基准、硬件矩阵等)可复用标准安装模板,减少维护分支。
  • 系统:无运行时影响,不影响任何推理、调度或内核逻辑。
文档一致性 链接有效性 预发布信息残留

关联 Issue

未识别关联 Issue

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

完整报告

参与讨论