执行摘要

本PR通过锁定nixl-cu12和nixl-cu13的版本来修复CI中断问题，确保CUDA 13环境稳定，但可能引入不必要的依赖臃肿，是一个临时解决方案。

功能与动机

由于nixl-cu12==1.0.1发布后与CUDA 13环境不兼容，导致CI流水线崩溃。PR body中说明："nixl-cu12==1.0.1 dropped on PyPI today (19:38 UTC) and ships nixl_ep compiled against libcudart.so.12 — crashes on CUDA 13 CI runners." 现有约束"< 0.10.0"只锁定元包，未锁定后端，因此需要显式添加后端版本约束以防止崩溃。

实现拆解

1. 变更入口：修改requirements/kv_connectors.txt文件，这是KV连接器依赖的核心配置文件。
2. 核心逻辑改造：在文件中添加两行版本约束，确保只安装兼容的后端版本。具体代码片段如下：

lmcache >= 0.3.9
nixl[cu13] >= 0.7.1, < 0.10.0  # 原有元包约束，用于解耦预填充
nixl-cu12 >= 0.7.1, < 0.10.0   # 新增：锁定CUDA 12后端版本，防止1.0.1崩溃
nixl-cu13 >= 0.7.1, < 0.10.0   # 新增：显式锁定CUDA 13后端版本，确保一致性
mooncake-transfer-engine >= 0.3.8

评论区精华

review中讨论了添加nixl-cu12作为全局要求是否合适：

• gemini-code-assist[bot]指出："Adding nixl-cu12 as a direct requirement forces its installation on all systems ... where it is unnecessary and adds significant bloat (100MB+)."
• NickLucche回应："I'm also not super happy with having to install both like this."
• cjackal提出了替代方案：安装特定变体并使用--no-deps选项。
  最终PR被批准以快速解封CI，但环境臃肿问题未解决。

风险与影响

• 技术风险：强制安装nixl-cu12在CUDA 13环境中会导致不必要的依赖臃肿，增加安装时间和磁盘空间。锁定版本可能延迟对NIXL 1.0.0+的支持。
• 影响范围：主要影响CI流水线稳定性，但也可能增加用户安装包大小。对系统功能无直接影响。

关联脉络

关联Issue #39521（跟踪NIXL >= 1.0.0支持）和PR #39797（正在处理NIXL版本升级），本PR是临时修复，揭示了在依赖管理中的快速响应策略。