执行摘要

本 PR 更新了 vLLM 的 ROCm 安装文档，新增对 ROCm 7.2.1 和夜间 wheel 的支持，通过添加表格、自动化命令和详细指南提升用户安装体验。变更基于近期技术升级，风险较低，主要影响文档准确性。

功能与动机

PR 动机源于两个关联 PR：#37283 开启了夜间 ROCm wheel 发布，而 #38413 将 vLLM 升级到 ROCm 7.2.1、Torch 2.10 和 Triton 3.6。因此，需要同步更新文档，确保用户能获取最新安装信息，避免混淆。

实现拆解

实现集中在文件 docs/getting_started/installation/gpu.rocm.inc.md，关键改动按模块拆解：

• 预构建 wheel 表格：将列表转为表格，添加 ROCm 7.0 和 7.2.1 变体，支持版本范围标识。
• 自动化命令：引入 shell 脚本，通过 curl 和 grep 自动提取 wheel 变体和版本，例如：
  

  export VLLM_ROCM_VARIANT=$(curl -s https://wheels.vllm.ai/rocm/vllm | grep -oP 'rocm\d+' | head -1)
  

• 安装指南更新：更新 uv 和 pip 命令以支持夜间构建、特定 commit 版本，并添加 ROCm Docker 镜像使用说明。
• 文本修正：优化描述一致性，如添加 --upgrade 标志和缩进命令以提高可读性。

评论区精华

review 讨论中，gemini-code-assist[bot] 提供了多轮技术反馈：

• 正则表达式问题：> “The grep regex rocm\d+ is incorrect here as well. It should match the full ROCm version string to avoid errors.”
  作者回复格式为 rocm700，但建议更健壮的 regex 以匹配类似 rocm7.2.1 的字符串。

• 无效 commit hash：> “The example commit hash 5b8c30d62b754b575e043ce2fc0dcbf8a64f6306 is invalid for ROCm wheels and results in a 404 error.”
  作者在后续 commits 中更新了 hash。

• 命令冗余：作者解释 sed 命令处理 %2B 编码的必要性，但 gemini 认为可能误导用户。

• 文档一致性：DarkLight1337 建议：> “Can you make a table so it scales better as more versions get added?” 和缩进命令以避免用户误解。

风险与影响

风险分析：

• 自动化命令依赖外部 URL 结构，若页面变化（如目录重命名）可能导致命令失败。
• 正则表达式可能不完整，提取错误信息影响安装。
• 文档中命令示例若未及时更新，可能引入误导。

影响分析：

• 对用户：简化 ROCm 安装流程，减少困惑，提升 AMD GPU 用户的使用体验。
• 对系统：无直接技术影响，属于文档维护。
• 对团队：支持 ROCm 生态持续演进，强化文档作为关键用户资源。

关联脉络

本 PR 是 ROCm 支持演进的一部分，与历史 PR 紧密关联：

• PR #37283：首次引入夜间 ROCm wheel 发布，为本 PR 提供背景。
• PR #38413：升级到 ROCm 7.2.1，是本 PR 文档更新的技术驱动。
• 近期其他 ROCm 相关 PR（如 #38450、#38317）显示团队持续优化 ROCm 后端和 CI，本 PR 补齐了文档环节，形成完整支持链条。