执行摘要
- 一句话:为 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 模型链接)。
实现拆解
- 新增命令生成器组件:在
docs_new/src/snippets/autoregressive/ 下创建 kimi-k27-code-deployment.jsx,定义硬件选项、TP 配置、选项状态管理与命令拼接逻辑,并嵌入暗模式检测与 fallback 处理。
- 新增 MDX 文档页面:
docs_new/cookbook/autoregressive/Moonshotai/Kimi-K2.7-Code.mdx,介绍模型特性、基准测试、安装步骤,并嵌入上述交互式组件。
- 更新导航配置:在
docs_new/docs.json 的 Moonshotai 分组中添加新页面条目,使其出现在文档侧边栏。
- 调整入口链接:修改
docs_new/cookbook/autoregressive/intro.mdx 中 Moonshotai 卡片的目标链接至新页面。
- 更新索引列表:修改
docs_new/cookbook/intro copy.mdx,在 Moonshotai 列表中添加 Kimi-K2.7-Code 并标记 NEW。
- 移除旧版 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 提供完整部署文档,展示了相同的文档扩展模式。
参与讨论