# PR #37991 完整报告

- 仓库：`vllm-project/vllm`
- 标题：[Docs] Fix build
- 合并时间：2026-03-24 18:20
- 原文链接：http://prhub.com.cn/vllm-project/vllm/pull/37991

---

## 执行摘要
PR #37991 修复了 vllm 项目文档构建中的 transient issues，通过从 mkdocs.yaml 移除对失效 psutil inventory 的引用，确保文档构建流程稳定运行。

## 功能与动机
由于外部依赖 psutil 移除了所有版本，导致其 stable 文档链接失效，从而引发文档构建失败。移除未直接使用的 inventory 引用是解决此问题的直接方案，基于 PR body 中的描述：'psutil has recently created transient issues for those consuming their docs... it is causing problems right now.'

## 实现拆解
仅修改配置文件 `mkdocs.yaml`，删除以下一行：
```yaml
- https://psutil.readthedocs.io/en/stable/objects.inv
```
此变更位于 plugins 部分，移除未使用的交叉引用 inventory。

## 评论区精华
review 中 gemini-code-assist[bot] 评论确认变更直接且正确：
> This pull request addresses a build failure in the documentation by removing a reference to the `psutil` objects inventory... The change is straightforward and appears to be a correct fix.
没有其他争议或讨论。

## 风险与影响
- **风险**：极低，因为移除的是未使用的引用；但需确保无隐藏依赖以避免文档完整性受损。具体到 `mkdocs.yaml` 文件，仅删除一行配置，不会引入新逻辑。
- **影响**：修复构建问题，防止 CI 失败，对用户透明；影响范围仅限于文档生成过程，有助于提升团队维护效率。

## 关联脉络
与近期基础设施 PR 如 #37783（移动 agent queue 到 Release 集群队列）相关，共同体现了项目在优化构建和部署流程方面的持续改进。该 PR 虽小，但反映了对外部依赖管理的最佳实践。