【合入来源】

如有社区issue，请关联issue链接
请勿携带内部流程信息（需求链接、问题单、内部issue等）

• 需求
• 问题单
• issue/工单
• 重构优化
• 资料更新

为 HCCL 后端新增 get_p2p_stream_id 接口，用于获取 P2P 通信的 NPU stream ID，方便用户在分布式训练场景下进行 stream 级别的同步和管理。

【修改方案】

1. 新增 C++ 方法 getP2PStreamId
   在 ProcessGroupHCCL 类中新增 getP2PStreamId 方法，支持两种模式：

• 批量模式 (is_batched=1) ：使用 getKeyFromDevices 生成 key，适用于 batch_isend_irecv 场景
• 非批量模式 (is_batched=0) ：使用 getKeySendRecv 生成 key，适用于单独的 send/recv 场景

2. 新增 Python 绑定
   在 Init.cpp 中添加 Python 绑定，暴露 get_p2p_stream_id 接口到 Python 层

【资料变更】

请确认是否涉及资料变更。如涉及，需要在PR中体现，并简要说明修改内容。如不涉及，需填写“不涉及”

【接口变更】

【功能验证】

1. ut验证
   新增测试文件 test/distributed/test_get_p2p_stream_id.py ，包含以下测试场景：

python -m pytest test/distributed/test_get_p2p_stream_id.py

2. 业务场景验证
   调用dist.send/recv方法进行p2p通信后，通过该新增接口get_p2p_stream_id()获取p2p stream id，拿到id对应的Stream实例，指定在该Stream上进行计算操作。
   通过profiling文件可以看到计算在p2p stream上进行
   

【CheckList】

PR提交人对以下CheckList自检项进行全量自检，自检通过或不涉及，均修改 [ ] 为 [x]

• 代码注释完备，正确记录错误日志
• 代码实现进行了返回值、空指针等校验
• PR标题正确使用类型标签，如：feat、fix、refactor、docs、test等
• PR持续集成流水线（CI）执行通过，代码检查无异常