# PR #38367 完整报告

- 仓库：`vllm-project/vllm`
- 标题：[ROCm][Documentation] update quickstart and installation to include rocm nightly docker tips
- 合并时间：2026-03-28 07:20
- 原文链接：http://prhub.com.cn/vllm-project/vllm/pull/38367

---

### 执行摘要
本次 PR 更新了 vLLM 的 ROCm 安装和快速入门文档，添加了 nightly Docker 镜像的使用说明，并清理了过时的 AMD Docker 镜像信息。这是一个简单的文档维护变更，对用户提供便利，但对系统无直接影响。

### 功能与动机
由于 nightly Docker 镜像 `vllm/vllm-openai-rocm:nightly` 现已可用，PR 旨在更新相关文档以帮助用户测试最新开发构建。PR body 中明确说明："As the nightly docker image is available... This PR is to update the quickstart/installation to include nightly docker." 同时，弃用旧 AMD 镜像，简化文档。

### 实现拆解
- **`docs/getting_started/installation/gpu.rocm.inc.md`**：添加 nightly 镜像标签（如 `latest` 和 `nightly`），更新 Docker 命令示例，并将 AMD 的 Docker 镜像标记为已弃用。关键变更包括将单数 "image" 改为复数 "images"，并添加警告块。
- **`docs/getting_started/quickstart.md`**：在 ROCm 部分添加提示，说明 nightly 镜像的可用性，使用 `!!! tip` 块。

### 评论区精华
在 review 中，gemini-code-assist[bot] 评论："> While adding the command for the nightly image is helpful, duplicating the entire `docker run` command block makes the documentation harder to maintain." 建议用文本说明代替重复命令，以避免未来更新不一致。但该建议未被采纳，合并者 gshtras 直接批准了 PR，无其他讨论。

### 风险与影响
- **风险**：文档中重复的 `docker run` 命令块可能在未来更新时导致不一致，例如参数变更可能只修改一处。但风险较低，因为变更内容简单且用户易理解。
- **影响**：用户现在可以方便地获取 nightly 构建信息，加速测试和反馈；团队需注意文档维护性，避免重复内容；系统无代码变更，无性能或安全影响。

### 关联脉络
- **PR #38328**：同为文档更新，澄清 Helm chart 位置，显示团队在持续优化文档结构和一致性。
- **PR #38252**：更新 ROCm CI 基础镜像至 7.2.1 版本，与本 PR 的 ROCm 主题相关，共同反映了 vLLM 项目中 ROCm 支持的持续演进和基础设施改进。