Prhub

#2655 docs: improve Miles Diffusion discovery

原始 PR 作者 Rockdu 合并时间 2026-08-18 23:54 文件变更 3 提交数 4 评论 0 代码增减 +14 / -2

执行摘要

模型索引按模态拆分,新增 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. claude[bot] 自动评论指出该 PR 来自 fork,自动化 review 被禁用,维护者可评论 @claude review 触发一次性 review,本 PR 未触发。
  2. 维护者 Zhichenzzz 直接批准且未留评论,说明变更无争议;评论数为 0,无实质技术交锋。

实现拆解

  1. 拆分模型索引docs/models/index.md):将原 By family 标题改为 Language Models,明确该表只覆盖语言模型 recipe;随后新增独立的 ## Diffusion 表格,列出 SD3.5Qwen-ImageWan2.2-T2V-A14BLTX-2.3Cosmos3-NanoMiniMax H3 六个家族的 recipe 链接。这样语言模型与扩散模型按模态分离,扩散模型从模型索引页即可直达,无需再进入 /docs/diffusion 子目录逐层查找。
  2. 同步 landing pagedocs/index.md):在已有 diffusion 家族表(Wan、LTX、Cosmos 等)中追加 MiniMaxMiniMax 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 模型索引 modified 2.87
README.md 项目入口 modified 1.32
docs/index.md 文档首页 modified 1.18

分析完成后,这里会展示 LLM 生成的相对完整源码片段和详细注释。

评论区精华

fork PR 的自动化 review 策略 other

claude[bot] 自动评论指出该 PR 来自 fork,自动化 review 被禁用,维护者可评论 `@claude review` 触发一次性 review。

结论:未运行自动化 review;由维护者 Zhichenzzz 直接批准,说明变更无争议。 · 已解决

维护者批准 question

Zhichenzzz 直接批准且未留下评论,评论数与 review 评论数均为 0。

结论:已批准合并,无未解决疑虑。 · 已解决

风险与影响

  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 新增外部仓库链接

关联 Issue

未识别关联 Issue

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

完整报告

参与讨论