执行摘要
- 一句话:模型索引按模态拆分,新增 Diffusion 表并直达 Miles Diffusion 仓库
- 推荐动作:值得快速浏览,作为"用最小文档结构调整提升可发现性"的小样本:按模态拆分索引表 + 三处入口同步 + 外部仓库主导航链接的组合,对文档维护者有参考意义,但无技术深度,不需精读。
功能与动机
PR body 的 Why 表述为 Make diffusion models and their source repository easier to discover。结合历史 PR 可见,Miles 的 Diffusion 后训练能力此前已通过 #2583(移植 diffusion 文档分区)与 #2599(README 指向 miles-diffusion 仓库)进入主站,但模型索引页仍以语言模型为主,diffusion 家族分散在子目录中;已验证的 MiniMax H3 recipe 也没有任何列表入口。本 PR 补齐了这最后一公里:让扩散模型在索引页、landing page 与 README 三处同时可见。
实现拆解
- 拆分模型索引(
docs/models/index.md):将原 By family 标题改为 Language Models,明确该表只覆盖语言模型 recipe;随后新增独立的 ## Diffusion 表格,列出 SD3.5、Qwen-Image、Wan2.2-T2V-A14B、LTX-2.3、Cosmos3-Nano、MiniMax H3 六个家族的 recipe 链接。这样语言模型与扩散模型按模态分离,扩散模型从模型索引页即可直达,无需再进入 /docs/diffusion 子目录逐层查找。
- 同步 landing page(
docs/index.md):在已有 diffusion 家族表(Wan、LTX、Cosmos 等)中追加 MiniMax → MiniMax H3 一行,使刚验证的 H3 recipe 与其它家族并列,保证首页与索引页信息一致。
- README 主导航直达源码仓库(
README.md):在顶部导航行中加入 Miles Diffusion 链接,指向 github.com/radixark/miles_diffusion,与 #2599 已有的指引指向一致,让用户在仓库首页即可发现扩散分支。
- 配套检查:PR body 确认执行了
git diff --check 与文档 diagnostics,因属于 docs-only 变更未运行 pytest 与 pre-commit,也没有测试、配置或部署配套改动。
关键文件:
docs/models/index.md(模块 模型索引;类别 docs;类型 documentation): 变更的核心文件:将模型索引表标题由 By family 改为 Language Models,并新增独立的 Diffusion 表格,列出 6 个扩散家族的 recipe 链接,确立按模态组织索引的信息架构。
README.md(模块 项目入口;类别 docs;类型 documentation): 在 README 顶部主导航中新增 Miles Diffusion 外部仓库链接,与 Documentation、Quick Start、Supported Models 等入口并列,使扩散源码仓库在仓库首页即可直达。
docs/index.md(模块 文档首页;类别 docs;类型 documentation): landing page 的 diffusion 家族表新增 MiniMax H3 行,与模型索引页的新增保持一致,确保首页与索引页信息同步。
关键符号:未识别
评论区精华
- claude[bot] 自动评论指出该 PR 来自 fork,自动化 review 被禁用,维护者可评论
@claude review 触发一次性 review,本 PR 未触发。
- 维护者 Zhichenzzz 直接批准且未留评论,说明变更无争议;评论数为 0,无实质技术交锋。
- fork PR 的自动化 review 策略 (other): 未运行自动化 review;由维护者 Zhichenzzz 直接批准,说明变更无争议。
- 维护者批准 (question): 已批准合并,无未解决疑虑。
风险与影响
- 风险:
- 文档链接有效性:
Diffusion 表中的 6 个链接指向 docs/diffusion/models/ 下页面,其中 MiniMax H3 指向 /diffusion/models/h3/h3,需依赖 #2583 建立的 diffusion 文档分区中对应页面真实存在,否则会产生 404。
- 外部仓库链接:README 新增的
Miles Diffusion 指向 github.com/radixark/miles_diffusion,是外部仓库,若仓库改名或下线链接即失效。
- 无自动化测试覆盖:docs-only 变更未配置链接检查类测试,链接有效性依赖人工维护。整体风险极低,不涉及运行时路径、配置或依赖,无回归、性能、安全风险。
- 影响:用户侧:扩散模型从模型索引页、文档首页与 README 三处入口均可直达,查找成本明显下降;MiniMax H3 从"已验证但不可见"变为"列表可见"。团队侧:模型索引页确立了 Language Models / Diffusion 的模态分区约定,后续新增扩散家族有了明确归属表格;文档维护者需要保持索引页、landing page 与 Recipe 页面之间的链接同步。影响范围限定在文档读者与文档维护流程,对系统运行无影响。
- 风险标记:docs-only 无自动化测试, 新增链接依赖既有文档页面, README 新增外部仓库链接
关联脉络
- PR #2583 docs(diffusion): latest doc ported from miles diffusion 20260818-01:00: 建立了 docs/diffusion 文档分区,为本 PR 中 6 个 diffusion recipe 链接提供了目标页面基础。
- PR #2607 docs: fix diffusion docs: 修正了 diffusion 分区中 Cosmos3 收紧为 Nano 的命名,本 PR 索引表沿用 Cosmos3-Nano 修正后的写法,同属 diffusion 文档发现性改进线。
- PR #2599 docs: point at Miles-diffusion for diffusion post-training: 此前已从 README 与文档首页指向 miles-diffusion 仓库,本 PR 将同一链接提升到 README 主导航位。
- PR #2594 docs: name the dense variant in the Qwen3.8 model-table rows: 同为模型索引表(docs/models/index.md)的整理工作,显示模型索引页正在持续系统化演进。
参与讨论