# PR #28064 完整报告

- 仓库：`sgl-project/sglang`
- 标题：[Docs] Add Kimi K2.7 Code cookbook
- 合并时间：2026-06-13 02:19
- 原文链接：http://prhub.com.cn/sgl-project/sglang/pull/28064

---

# 执行摘要

- 一句话：为 Kimi K2.7 Code 添加部署 cookbook
- 推荐动作：该 PR 属于常规文档维护，适合需要部署 Kimi-K2.7-Code 的用户精读。交互式命令生成器组件的设计模式（options 驱动、动态 fallback）可为后续类似文档组件参考。

# 功能与动机

Kimi-K2.7-Code 是 Moonshot AI 新发布的编码聚焦智能体模型，基于 Kimi-K2.6 架构优化长周期编码任务并减少 30% thinking token。PR 旨在提供 SGLang 部署指南，降低新用户上手成本（参见 PR body 中 Hugging Face 模型链接）。

# 实现拆解

1. **新增命令生成器组件**：在 `docs_new/src/snippets/autoregressive/` 下创建 `kimi-k27-code-deployment.jsx`，定义硬件选项、TP 配置、选项状态管理与命令拼接逻辑，并嵌入暗模式检测与 fallback 处理。
2. **新增 MDX 文档页面**：`docs_new/cookbook/autoregressive/Moonshotai/Kimi-K2.7-Code.mdx`，介绍模型特性、基准测试、安装步骤，并嵌入上述交互式组件。
3. **更新导航配置**：在 `docs_new/docs.json` 的 Moonshotai 分组中添加新页面条目，使其出现在文档侧边栏。
4. **调整入口链接**：修改 `docs_new/cookbook/autoregressive/intro.mdx` 中 Moonshotai 卡片的目标链接至新页面。
5. **更新索引列表**：修改 `docs_new/cookbook/intro copy.mdx`，在 Moonshotai 列表中添加 Kimi-K2.7-Code 并标记 NEW。
6. **移除旧版 NEW 标签**：从 `Kimi-K2.6.mdx` 的 metadata 中移除 `tag: NEW`，将标记转移至新模型。

关键文件：
- `docs_new/src/snippets/autoregressive/kimi-k27-code-deployment.jsx`（模块 命令生成器；类别 source；类型 core-logic；符号 KimiK27CodeDeployment, resolveItems, getInitialState, checkDarkMode）: 新增交互式命令生成器组件，是文档的核心可交互部分，包含硬件选项、TP 配置、状态管理与命令拼接逻辑。
- `docs_new/cookbook/autoregressive/Moonshotai/Kimi-K2.7-Code.mdx`（模块 部署文档；类别 docs；类型 dependency-wiring）: 新增模型部署指南，包含模型介绍、基准数据、安装步骤并嵌入命令生成器组件，是本次文档变更的主体页面。
- `docs_new/docs.json`（模块 导航配置；类别 config；类型 configuration）: 在导航配置中添加新文档页面，使其出现在侧边栏 Moonshotai 分组中。
- `docs_new/cookbook/autoregressive/intro.mdx`（模块 目录入口；类别 docs；类型 dependency-wiring）: 更新 Moonshotai 卡片链接指向新文档，确保导航一致性。
- `docs_new/cookbook/intro copy.mdx`（模块 文档索引；类别 docs；类型 core-logic）: 在索引列表中添加 Kimi-K2.7-Code 入口并标记 NEW，同时保留 Kimi-K2.6。
- `docs_new/cookbook/autoregressive/Moonshotai/Kimi-K2.6.mdx`（模块 模型文档调整；类别 docs；类型 core-logic）: 移除已过期的 NEW 标签，将标记转移到新模型页面。

关键符号：KimiK27CodeDeployment, resolveItems, getInitialState, checkDarkMode, handleRadioChange, generateCommand


# 评论区精华

无实质性 review 讨论。仅有的两条评论来自 gemini-code-assist（每日配额提示）和 Mintlify（文档预览部署通知）。合并者直接批准。

- 暂无高价值评论线程

# 风险与影响

- 风险：低风险。所有变更为文档层，不涉及运行时代码。唯一风险是新 MDX 中文档链接或组件引用需正确，已通过 Mintlify 预览验证。无性能、安全或兼容性影响。
- 影响：对用户：提供 Kimi-K2.7-Code 模型可视化部署工具，降低配置复杂度；对系统：无影响；对团队：新增一个文档维护条目，需要后续 model 更新时保持同步。
- 风险标记：文档链接可能失效 , 无代码测试覆盖

# 关联脉络

- PR #28061 docs: 类似的新模型 cookbook 添加，为 MiniMax-M3 提供完整部署文档，展示了相同的文档扩展模式。