# PR #27830 完整报告

- 仓库：`sgl-project/sglang`
- 标题：[Docs] Restore right-hand ToC on the DeepSeek-V4 cookbook page
- 合并时间：2026-06-11 02:58
- 原文链接：http://prhub.com.cn/sgl-project/sglang/pull/27830

---

# PR 分析报告：修复 DeepSeek-V4 文档页缺失右侧目录

## 执行摘要

此 PR 修复了 DeepSeek-V4 cookbook 页面缺少右侧 "On this page" 目录的问题，原因是 frontmatter 中误设了 `mode: wide`（该模式会隐藏目录）。修复包括：删除问题页面的 `mode: wide`、从页面模板中移除该设置（根因）、以及更新编码规范和 review 检查以防复发。纯文档变更，无任何运行时影响。

## 功能与动机

DeepSeek-V4 cookbook 页面是 **唯一 **一个没有右侧 "On this page" 目录的模型页面。其他所有模型页面（DeepSeek-V3.2、Kimi-K2、Qwen3 等）均有此目录。根因是 frontmatter 中的 `mode: wide`——Mintlify 的宽模式会加宽内容列并隐藏目录。V4 从页面模板中继承了该设置，而模板硬编码了 `mode: wide`。此设置对模型页面并无必要，因为 Deploy/Playground 面板已自限宽度为 900px 并居中。

## 实现拆解

1. **直接修复**：在 `docs_new/cookbook/autoregressive/DeepSeek/DeepSeek-V4.mdx` 的 frontmatter 中删除 `mode: wide`。
2. **根因修复**：在 `.claude/skills/cookbook-add-model/templates/page.mdx.tmpl` 模板中删除 `mode: wide`，确保新生成的页面不再引入该问题。
3. **规范更新**：在 `.claude/skills/cookbook-add-model/references/mintlify-authoring.md` 中添加说明，明确模型页面应保持 `mode` 不设置，并解释 `mode: wide` 仅适用于类别 `intro.mdx` 卡片网格页面。
4. **审查强化**：在 `.claude/skills/cookbook-review-pr/SKILL.md` 中增加对 `mode: wide` 的审查检查，并修正了一条旧的 frontmatter 规则（从 `metatags.description` 改为顶层 `description:`）。

### 无 — 仅 frontmatter 配置变更，无源码逻辑。

## 评论区精华

无讨论。PR 由 wisclmy0611 批准。

## 风险与影响

- **风险**：无。纯文档变更，不涉及任何运行时代码。
- **影响**：DeepSeek-V4 页面将恢复右侧目录，提升导航体验。同时，通过更新模板和规范，系统性防止未来新页面出现同样问题。

## 关联脉络

此 PR 与前序文档维护 PR（如 #27714、#27708）属于同一文档规范提升方向，体现了团队注意页面布局一致性的质量意识。