# PR #2391 完整报告

- 仓库：`radixark/miles`
- 标题：docs: replace DeepSeek V3/R1 page with a DeepSeek-V3.2 recipe
- 合并时间：2026-08-12 06:13
- 原文链接：http://prhub.com.cn/radixark/miles/pull/2391

---

# 执行摘要

- 一句话：以 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`（模块 模型文档；类别 docs；类型 deletion）: 删除旧的 DeepSeek V3/R1 配方页（+0/-244），这是本次文档迁移的主体动作，避免用户继续按已不随仓库发布的脚本操作。
- `docs/models/deepseek/deepseek-v3-2.md`（模块 模型文档；类别 docs；类型 documentation）: 新增的 DeepSeek-V3.2 配方页是核心交付物，内容完全对照 scripts/run_deepseek_v32.py、miles_plugins/mbridge/deepseek_v32.py 和启动器快照输出编写，并记录了两个核验中发现的 launcher bug。
- `docs/docs.json`（模块 文档站；类别 config；类型 configuration）: 文档站导航配置，删除旧页面引用、加入新页面，并在顶层新增 redirects 永久重定向，是避免旧 URL 404 的关键配置变更。
- `docs/models/deepseek/index.md`（模块 模型文档；类别 docs；类型 documentation）: DeepSeek 家族索引页，需要同步描述、变体表和启动命令示例，并与 V4 页面链接保持一致的版式。
- `docs/models/index.md`（模块 模型文档；类别 docs；类型 documentation）: 模型总览页的 DeepSeek 家族表格行被更新，移除 V3/R1 链接并加入 V3.2。
- `docs/advanced/pd-disaggregation.md`（模块 进阶文档；类别 docs；类型 documentation）: PD Disaggregation 指南中的 DeepSeek 配方交叉链接需要指向新页，保证全站链接不悬空。
- `docs/index.md`（模块 首页文档；类别 docs；类型 documentation）: 首页支持的模型表需要列入 V3.2，否则首页与家族页不一致。

关键符号：未识别

## 关键源码片段

### `docs/docs.json`

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

```json
{
  // 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, 纯文档改动无自动化测试覆盖

# 关联脉络

- PR #2216 docs: add GLM-5.2 model page and update supported-models tables: 同为模型文档新增 / 替换并同步 models 索引与首页表格，可对比其页面结构和文档站配置方式。
- PR #2271 docs: refresh the homepage supported-models table: 同样维护首页模型表，保证支持模型清单与各家族配方页一致。
- PR #1908 Snapshot test the argv of all model scripts: 本 PR 用于校验文档 flag 的启动器快照即来自该系列快照测试基础设施。
- PR #2377 fix(kimi): align YaRN parameters with checkpoints: 同为模型配方与启动器参数对齐的维护工作，且都在文档 / 模型中体现模型参数修正。