# PR #2655 完整报告

- 仓库：`radixark/miles`
- 标题：docs: improve Miles Diffusion discovery
- 合并时间：2026-08-18 23:54
- 原文链接：http://prhub.com.cn/radixark/miles/pull/2655

---

# 执行摘要

- 一句话：模型索引按模态拆分，新增 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 三处同时可见。

# 实现拆解

1. **拆分模型索引 **（`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` 子目录逐层查找。
2. **同步 landing page**（`docs/index.md`）：在已有 diffusion 家族表（Wan、LTX、Cosmos 等）中追加 `MiniMax` → `MiniMax H3` 一行，使刚验证的 H3 recipe 与其它家族并列，保证首页与索引页信息一致。
3. **README 主导航直达源码仓库 **（`README.md`）：在顶部导航行中加入 `Miles Diffusion` 链接，指向 `github.com/radixark/miles_diffusion`，与 #2599 已有的指引指向一致，让用户在仓库首页即可发现扩散分支。
4. **配套检查**：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 行，与模型索引页的新增保持一致，确保首页与索引页信息同步。

关键符号：未识别


# 评论区精华

1. claude[bot] 自动评论指出该 PR 来自 fork，自动化 review 被禁用，维护者可评论 `@claude review` 触发一次性 review，本 PR 未触发。
2. 维护者 Zhichenzzz 直接批准且未留评论，说明变更无争议；评论数为 0，无实质技术交锋。

- fork PR 的自动化 review 策略 (other): 未运行自动化 review；由维护者 Zhichenzzz 直接批准，说明变更无争议。
- 维护者批准 (question): 已批准合并，无未解决疑虑。

# 风险与影响

- 风险：
 1. **文档链接有效性**：`Diffusion` 表中的 6 个链接指向 `docs/diffusion/models/` 下页面，其中 `MiniMax H3` 指向 `/diffusion/models/h3/h3`，需依赖 #2583 建立的 diffusion 文档分区中对应页面真实存在，否则会产生 404。
 2. **外部仓库链接**：README 新增的 `Miles Diffusion` 指向 `github.com/radixark/miles_diffusion`，是外部仓库，若仓库改名或下线链接即失效。
 3. **无自动化测试覆盖**：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）的整理工作，显示模型索引页正在持续系统化演进。