Prhub

#27830 [Docs] Restore right-hand ToC on the DeepSeek-V4 cookbook page

原始 PR 作者 zijiexia 合并时间 2026-06-11 02:58 文件变更 4 提交数 1 评论 2 代码增减 +12 / -4

执行摘要

修复 DeepSeek-V4 文档页缺失右侧目录

DeepSeek-V4 cookbook 页面是所有模型页面中唯一缺失右侧 "On this page" 目录的页面,原因是 frontmatter 中的 mode: wide 会抑制目录显示。此问题源于页面模板中硬编码了 mode: wide

值得精读。该 PR 展示了如何通过修复模板和规范来系统性地防止同类问题,对文档维护者具有参考价值。

讨论亮点

无 reviewer 评论。PR 由 wisclmy0611 批准。

实现拆解

  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:
  4. 更新 review 检查:在 .claude/skills/cookbook-review-pr/SKILL.md 中添加对 mode: wide 的审查规则,并修正 frontmatter 文档要求(从 metatags.description 改为顶层 description:)。
文件 模块 状态 重要度
docs_new/cookbook/autoregressive/DeepSeek/DeepSeek-V4.mdx 文档页面 modified 2.57
.claude/skills/cookbook-add-model/templates/page.mdx.tmpl 模板 modified 2.98
.claude/skills/cookbook-add-model/references/mintlify-authoring.md 编码规范 modified 2.43
.claude/skills/cookbook-review-pr/SKILL.md 审查规范 modified 2.3

分析完成后,这里会展示 LLM 生成的相对完整源码片段和详细注释。

评论区精华

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

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

风险与影响

无风险。仅文档变更,不涉及运行时代码。

影响范围小,仅影响 DeepSeek-V4 cookbook 页面的布局(恢复右侧目录),同时改善后续新页面生成的规范性。

无风险(纯文档变更)

关联 Issue

未识别关联 Issue

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

完整报告

参与讨论