执行摘要
- 一句话:以 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 是启动器真实输出,而非从旧页继承来的笔误。
实现拆解
- 配置与运行环境
- 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 的关键配置变更。
{
// 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: 同为模型配方与启动器参数对齐的维护工作,且都在文档/模型中体现模型参数修正。
参与讨论