Prhub

#2391 docs: replace DeepSeek V3/R1 page with a DeepSeek-V3.2 recipe

原始 PR 作者 yueming-yuan 合并时间 2026-08-12 06:13 文件变更 7 提交数 1 评论 0 代码增减 +239 / -257

执行摘要

以 DeepSeek-V3.2 配方页替换 V3/R1 页并同步全站索引

PR 正文指出:DeepSeek 家族页面仍在文档中把 V3 / R1 当作 671B 的规范配方,但该架构真正随仓库发布的是 scripts/run_deepseek_v32.py。删除过时页面并以 V3.2 配方页替换,可让文档与实际代码保持一致;同时通过快速启动快照(tests/snapshots/launch_scripts/py/scripts/run_deepseek_v32.py/full_train.txt)保证页面上的 flag 是启动器真实输出,而非从旧页继承来的笔误。

实现拆解

  1. 配置与运行环境
    - docs/docs.json(configuration):配置/契约;包含 配置键调整;+8/-1
文件 模块 状态 重要度
docs/models/deepseek/deepseek.md 模型文档 removed 5.4
docs/models/deepseek/deepseek-v3-2.md 模型文档 added 5.34
docs/docs.json 文档站 modified 3.82
docs/models/deepseek/index.md 模型文档 modified 3.24
docs/models/index.md 模型文档 modified 1.89
docs/advanced/pd-disaggregation.md 进阶文档 modified 1.54
docs/index.md 首页文档 modified 1.54

关键源码片段

docs/docs.json configuration

文档站导航配置,删除旧页面引用、加入新页面,并在顶层新增 redirects 永久重定向,是避免旧 URL 404 的关键配置变更。

{
  // DeepSeek 组导航:V4 子组之后直接挂新配方页,替换原来的 V3/R1 页
  "group": "DeepSeek",
  "root": "models/deepseek/index",
  "pages": [
    {
      "group": "DeepSeek-V4",
      "pages": [
        "models/deepseek/deepseek-v4-flash",
        "models/deepseek/deepseek-v4-pro"
      ],
      "expanded": false
    },
    "models/deepseek/deepseek-v3-2"
  ],
  "expanded": false
}// 顶层新增 redirects:旧 URL 永久 301 到新页,避免发布在外的链接直接 404
"redirects": [
  {
    "source": "/models/deepseek/deepseek",
    "destination": "/models/deepseek/deepseek-v3-2",
    "permanent": true
  }
]

评论区精华

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

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

风险与影响

文档记录了未修复的启动器 bug Docker 镜像标签未验证 永久重定向影响 SEO 纯文档改动无自动化测试覆盖

关联 Issue

未识别关联 Issue

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

完整报告

参与讨论