执行摘要

• 一句话：移除P2pNcclConnector及相关代码
• 推荐动作：本PR反映了项目架构演进中做减法的决策，值得阅读以理解为何在已有替代方案后移除早期原型实现。对于想自定义连接器的开发者，可参考 KVConnectorBase_V1 API。

功能与动机

根据Issue #33115 的RFC讨论，P2pNcclConnector已不再需要：

1) 社区已有更成熟的NIXL Connector和Mooncake Connector；
2) 项目API已稳定，第三方可自行实现类似连接器；
3) 该连接器缺乏主要用户，同时带来较多维护负担。PR body引用了该issue并感谢了原始贡献者。

实现拆解

本次变更为纯删除操作，未新增任何功能代码。具体步骤包括：

1. 删除核心连接器模块：移除 vllm/distributed/kv_transfer/kv_connector/v1/p2p/ 目录下的 p2p_nccl_engine.py（632行）、p2p_nccl_connector.py（478行）和 tensor_memory_pool.py（273行），这些是P2pNcclConnector的引擎、连接器接口和底层内存池实现。
2. 删除基准测试脚本：移除 benchmarks/disagg_benchmarks/ 目录下与P2pNCCL相关的代理服务器和性能基准脚本（共约570行）。
3. 删除示例和启动脚本：移除 examples/disaggregated/ 下的示例代码和shell启动脚本（共约687行），包括展示如何使用P2pNcclConnector进行分离式推理的完整示例。
4. 清理配置引用和文档：在 vllm/config/kv_transfer.py 和文档中移除对 P2pNcclConnector 的引用和说明，确保配置文件不再识别该连接器。

关键文件：

• vllm/distributed/kv_transfer/kv_connector/v1/p2p/p2p_nccl_engine.py（模块 分布式层；类别 source；类型 deletion；符号 set_p2p_nccl_context, SendQueueItem, P2pNcclEngine, init）: 核心删除文件之一：实现了P2pNcclEngine，包括NCCL通信、ZMQ控制平面、发送接收队列和TensorMemoryPool集成。被完全删除。
• vllm/distributed/kv_transfer/kv_connector/v1/p2p/p2p_nccl_connector.py（模块 分布式层；类别 source；类型 deletion；符号 ReqMeta, make_meta, P2pNcclConnectorMetadata, init）: 核心删除文件：实现了P2pNcclConnector，继承KVConnectorBase_V1，负责KV缓存的注入和加载逻辑。
• vllm/distributed/kv_transfer/kv_connector/v1/p2p/tensor_memory_pool.py（模块 分布式层；类别 source；类型 deletion；符号 MemoryBlock, TensorMemoryPool, init, _round_to_power_of_two）: 核心删除文件：实现了TensorMemoryPool，使用伙伴分配算法管理pinned host memory，供P2pNcclEngine使用。
• benchmarks/disagg_benchmarks/disagg_prefill_proxy_server.py（模块 基准测试；类别 source；类型 deletion；符号 parse_args, main, _normalize_base_url, _get_host_port）: 删除的基准测试脚本：实现了用于分离式推理的代理服务器，配合P2pNcclConnector进行KV调度。
• examples/disaggregated/disaggregated_prefill.py（模块 示例；类别 source；类型 deletion；符号 run_prefill, run_decode, main）: 删除的示例文件：演示了如何使用P2pNcclConnector在prefill和decode实例间传输KV cache。

关键符号：set_p2p_nccl_context, SendQueueItem, P2pNcclEngine.init, P2pNcclEngine.create_connect, P2pNcclEngine.send_tensor, P2pNcclEngine.recv_tensor, P2pNcclEngine.listen_for_requests, ReqMeta, P2pNcclConnectorMetadata, P2pNcclConnector.init, P2pNcclConnector.start_load_kv, P2pNcclConnector.inject_kv_into_layer, MemoryBlock, TensorMemoryPool, disagg_prefill_proxy_server.main, run_prefill, run_decode

评论区精华

此PR没有实质性的review讨论。仅有一个来自mergify[bot]的自动化评论，提供了文档预览链接，以及hmellor的批准，未附带评论。之前的RFC Issue #33115 中讨论了弃用的理由。

• Documentation Preview (documentation): 无实质性讨论，仅自动通知。

风险与影响

• 风险：
  1) 用户迁移风险：若用户环境显式配置了 kv_connector="P2pNcclConnector" ，升级后将报错，需改用其它连接器或外部实现。
  2) 稳定性：删除代码经过了充分讨论，且该连接器在早期版本后已不被推荐使用，因此对主流用户影响很小。
  3) 维护负担：移除了约3k行代码，降低了项目整体维护成本。
  • 影响：影响范围：仅影响采用了 P2pNcclConnector 进行KV传输的用户，对使用其他连接器（NIXL、Mooncake）或未使用分离式KV传输的用户完全透明。影响程度：中等偏下，因为该连接器已在社区通告中标记为可选，且已有成熟替代方案。团队影响：减少维护工作量，使开发者能聚焦于主要连接器。
  • 风险标记：核心删除, 用户迁移风险, 减少维护负担

关联脉络

• 暂无明显关联 PR