执行摘要

• 一句话：XPU 依赖引入 triton shim 包解决版本冲突
• 推荐动作：建议快速浏览：本 PR 改动很小（3 个文件、10 增 5 删），但它是 XPU 发布流程系列的关键一环，需要与 PR#51759 放在一起理解。值得关注的决策点：用 shim 包固定版本解决平台特定依赖冲突的模式，可复用于其他非主流平台的依赖治理；另外移除 --torch-backend xpu 后如何保证 test/xpu.txt 与真实环境的依赖一致性，值得后续观察。

功能与动机

PR body 明确说明目的是支持 XPU wheel 发布：添加 triton shim wheel（https://wheels.vllm.ai/xpu/triton/）来 resolve triton-xpu 与 triton（NVIDIA triton，由 xgrammar 等库引入）的 conflict issue。xgrammar 等库会依赖标准 NVIDIA triton，pip 解析时可能覆盖 XPU 所需的 triton-xpu，导致安装或运行异常；shim 包用固定版本号将两者统一到同一解析结果上。副作用是不能再按旧方式使用 uv pip compile 的 --torch-backend xpu，需要同步调整预提交配置。

实现拆解

整个变更按以下 4 步完成：

1. 在 XPU 依赖入口挂接 shim 索引：requirements/xpu.txt 顶部新增 --extra-index-url=https://wheels.vllm.ai/xpu/ 并固定 triton==3.7.2+xpu。该索引由同系列 PR#51759 发布，pip 解析 XPU 依赖时优先命中 shim 版本，从而阻断 NVIDIA triton 的覆盖。这是整个 PR 的核心动作。

2. 调整 pip-compile-xpu 预提交 hook：.pre-commit-config.yaml 中移除 --torch-backend, xpu 参数。原因：引入 shim 后 torch 的解析来源发生变化，uv 的 xpu torch 后端无法继续正确生成依赖图，因此该参数必须去掉。

3. 重新生成测试依赖清单：requirements/test/xpu.txt 由 uv pip compile 重新生成，triton 从 3.7.1 变为 3.7.2+xpu，triton-xpu 的注释链从 # via torch 扩展为 # via torch 与 # triton 两条；文件头生成命令注释同步去掉 --torch-backend 参数。

4. CI 验证：通过 Buildkite CI（#83541）验证依赖解析与安装，无源码或测试改动，属于纯配置与依赖治理变更。

关键文件：

• requirements/xpu.txt（模块 XPU 依赖；类别 config；类型 dependency）: 核心变更文件：新增 extra-index-url 与 triton==3.7.2+xpu shim 包，是所有 XPU 安装的依赖入口，直接影响依赖解析结果。
• requirements/test/xpu.txt（模块 测试依赖；类别 config；类型 dependency）: uv pip compile 的生成产物，反映 triton 与 triton-xpu 依赖链的实际变化，是验证配置调整效果的直接证据。
• .pre-commit-config.yaml（模块 CI 配置；类别 config；类型 configuration）: pip-compile-xpu hook 移除 --torch-backend xpu 参数，是本次副作用的直接体现，影响后续 XPU 测试依赖的生成方式。

关键符号：未识别

评论区精华

唯一实质性的 review 讨论围绕移除 --torch-backend xpu 展开：jikunshang 在 .pre-commit-config.yaml 第 129 行主动 @hmellor 询问“do you have any concern for this?”；hmellor 回应称非 CUDA 设备一直没有可靠的 Torch wheel 是长期背景问题，但本次 requirements/test/xpu.txt 实际变化不大，“we should be ok”。随后 bigPYJ1151 批准合并。核心结论是变更影响可控，无需额外处理。

• 移除 --torch-backend xpu 的参数影响 (question): hmellor 认可变更影响可控，bigPYJ1151 随后批准合并。

风险与影响

• 风险：
  1. extra-index-url 全局生效：requirements/xpu.txt 是所有 XPU 安装的依赖入口，wheels.vllm.ai/xpu/ 的可用性与包完整性成为新的单点依赖，索引故障或内容不完整可能导致 pip 解析失败。
  2. 版本硬编码：triton==3.7.2+xpu 为固定版本，未来 triton-xpu 或 xgrammar 升级时若 shim 索引未同步更新，可能再次出现依赖覆盖或解析冲突。
  3. pip-compile 行为变化：移除 --torch-backend xpu 后，后续生成的 test/xpu.txt 不再经过 torch 后端过滤，torch 相关依赖可能与真实 XPU 安装环境漂移，生成结果需人工审查。
  4. 无自动化断言：变更依赖 CI 的安装验证，缺乏针对依赖解析结果的测试覆盖。
     - 影响：影响范围集中在 XPU 平台：所有通过 requirements/xpu.txt 安装的 XPU 环境会在依赖解析时额外查询 wheels.vllm.ai/xpu/ 索引，并固定使用 triton shim 包，从根源上避免 triton-xpu 被 NVIDIA triton 覆盖，解决实际安装冲突。对 NVIDIA、ROCm、CPU 用户无影响。对团队而言，这是 XPU wheel 发布链路的关键一步（1/N 发布索引、2/N 接入依赖），后续维护需持续跟踪 shim 版本；CI 依赖生成方式也随之改变，需要人工 review 生成结果。
     - 风险标记：extra-index-url 全局生效, pip-compile 解析行为变化, 依赖版本硬编码, 无自动化断言

关联脉络

• PR #51759 [CI/Release][1/N][XPU] Publish XPU Triton shim index: 本 PR 标题为 2/N，直接消费 1/N 发布的 shim 索引（wheels.vllm.ai/xpu/）作为安装源，两者构成 XPU wheel 发布链路的前后环。
• PR #51923 [CI/Release][XPU] fix workdir path for triton shim job: 同一发布链路的配套修复，保障 shim 索引构建稳定性，与本次依赖接入属于同一条 XPU 发布演进线。