执行摘要

• 一句话：XPU Dockerfile 升级 nixl 至 v0.10.1 并新增 PD 分离测试
• 推荐动作：该 PR 属于常规依赖升级与 CI 增强，值得关注的是 nixl 包拆分的设计决策及两步安装的合理性。建议在后续的 nixl 升级 PR 中参考此模式。

功能与动机

升级 nixl 版本是为了解决 XPU 上 nixl>=1.1 版本的问题（贡献者在讨论中提到 xpu has some issues in this version）。新增 PD 分离测试是为了提前发现 KV connector 在 prefill/decode 分离模式下的回归，填补 CI 空白。

实现拆解

1. 更新构建依赖版本：在 docker/Dockerfile.xpu 中将 UCX_VERSION 从固定 commit e5d98879 改为正式标签 v1.21.0-rc2，将 NIXL_VERSION 从 0.7.0 改为 0.10.1。
2. 调整 nixl 安装方式：新版 nixl 拆分为 nixl-cu12（实现包）和 nixl（元包）。在构建 stage 中保持 uv pip install . 从源码构建 nixl-cu12，并新增 uv pip install nixl==${NIXL_VERSION} 命令安装元包；在最终 stage 中同样添加元包安装。
3. 新增 CI 测试步骤：在 .buildkite/intel_jobs/test-intel.yaml 的 XPU V1 test 阶段的 commands 中，在第一个 cd tests 后添加 bash v1/kv_connector/nixl_integration/run_xpu_disagg_accuracy_test.sh，用于运行 PD 分离准确性测试。

关键文件：

• docker/Dockerfile.xpu（模块 Docker 构建；类别 infra；类型 infrastructure）: 升级 nixl 和 UCX 版本，调整 nixl 安装方式以适配新版包结构，是本次变更的核心文件。
• .buildkite/intel_jobs/test-intel.yaml（模块 CI 配置；类别 config；类型 configuration）: 在 XPU V1 测试步骤中新增 PD 分离准确性测试，提升 CI 对 KV connector 功能的验证能力。

关键符号：未识别

关键源码片段

docker/Dockerfile.xpu

升级 nixl 和 UCX 版本，调整 nixl 安装方式以适配新版包结构，是本次变更的核心文件。

# Stage: ucx-nixl-build
# 升级 UCX 版本至正式发布的 v1.21.0-rc2
ARG UCX_VERSION=v1.21.0-rc2
# 升级 NIXL 版本至 v0.10.1
ARG NIXL_VERSION=0.10.1
# ... 省略中间步骤 ...
RUN cd /tmp/nixl_source && \
    uv pip install --upgrade meson pybind11 patchelf && \
    uv pip install -r requirements.txt && \
    # `uv pip install .` 会从源码构建并安装 `nixl-cu12` 实现包
    uv pip install . && \
    # `nixl` 元包需要从 PyPI 单独安装，以提供正确的包名和依赖声明
    uv pip install nixl==${NIXL_VERSION}
​
# Stage: vllm-openai
ARG NIXL_VERSION=0.10.1
# ... 复制 nixl wheel 等 ...
RUN uv pip install --no-deps /tmp/nixl_wheels/nixl*.whl && \
    # 在最终镜像中也安装元包以确保运行时依赖完整
    uv pip install nixl==${NIXL_VERSION}

评论区精华

gemini-code-assist 指出 uv pip install nixl==${NIXL_VERSION} 可能冗余或引发错误，因为 nixl 可能不在公共索引上。
jikunshang 询问为什么需要额外安装 nixl。
zhenwei-intel 解释：新版 nixl 提供两个包——nixl-cu12（实现包，需源码构建）和 nixl（元包，从 PyPI 安装以提供统一入口），两者缺一不可。
xuechendi 追问是否不再需要源码构建，zhenwei-intel 确认仍需构建实现包。
jikunshang 提醒旧脚本 run-xpu-test.sh 将被弃用，建议直接修改 test-intel.yaml，最终变更已采纳此建议。

• Dockerfile 中额外的 nixl pip install 命令 (design): 确认需要两步安装：源码构建 nixl-cu12，然后 pip 安装 nixl 元包。已解释清楚并得到 reviewer 认可。
• 测试脚本放置位置建议 (other): 测试命令最终添加在 test-intel.yaml 的正确位置，符合长期维护方向。

风险与影响

• 风险：
  1. 依赖版本升级风险：nixl 和 UCX 版本跳跃可能引入新的兼容性缺陷，尤其是 UCX 从私有 commit 切换到正式 RC 版本，行为可能变化。
  2. 包安装顺序依赖：两步安装（先 uv pip install . 后 pip install nixl）可能因网络超时或索引不可用失败，影响 Docker 构建稳定性。
  3. CI 测试失败风险：新增的 PD 分离测试脚本对环境依赖敏感（如需要多 GPU 或特定 nixl 配置），在不满足条件时可能导致 CI 任务失败或超时。
     - 影响：影响范围：仅限于 XPU 平台。用户影响：使用 XPU Docker 镜像的用户将自动获得 nixl v0.10.1，可能修复此前版本的已知问题。系统影响：CI 中将多运行一个端到端准确性测试，总耗时增加约 5-10 分钟。团队影响：维护者需了解 nixl 包结构变化，后续升级 nixl 时需同时更新两个安装命令。
     - 风险标记：依赖版本升级, XPU 特定变更, 新增 CI 测试

关联脉络

• PR #45879 [Bugfix] Fix NixlConnector handshake block_len validation for GQA-replicated KV heads: 当前 PR 升级 nixl 至 v0.10.1 是后续修复 NixlConnector handshake 问题的基础依赖。
• PR #45823 [Fix][KV offload] Defer on_request_finished until in-flight transfers drain: 同属于 KV connector / offloading 领域的 bugfix，共享 nixl 依赖环境。