执行摘要

• 一句话：ZMQ IPv6 支持、bench_serving 采样参数、日志降级
• 推荐动作：该 PR 设计清晰，改动范围小但实用。建议关注 IPv6 端点格式的文档补充；bench_serving 参数已添加但未在文档中提及（可后续补充）；日志降级属易用性微调。整体可安全合入。

功能与动机

根据 PR body，ZMQ IPv6 支持是修复 IPv6-only 多节点 DP 通信的关键需求；bench_serving 参数缺失导致无法使用非贪婪采样；routed_dp_rank 警告在非 DP 服务器上频繁出现，干扰正常日志。

实现拆解

1. 提取 IPv6 检测函数：在 python/sglang/srt/utils/network.py 中新增 is_zmq_endpoint_ipv6() 函数，严格检测 ZMQ TCP 端点是否包含括号内的合法 IPv6 地址。原有 get_zmq_socket 函数的 IPv6 判定从简单的 find("[") 替换为该函数，提升准确性。

2. 应用 IPv6 到 load_snapshot ZMQ 套接字：在 load_snapshot.py 的 ZmqLoadSnapshotWriter 和 ZmqShmLoadSnapshotReader 构造函数中，导入并使用 is_zmq_endpoint_ipv6，当端点符合 IPv6 时设置 zmq.IPV6 选项，确保跨节点通信在纯 IPv6 网络下正常工作。

3. bench_serving 添加采样参数：在 bench_serving.py 中添加 --temperature（默认 0.0）和 --top-p（默认 1.0）命令行参数，并在 async_request_sglang_generate 中动态构建 sampling_params 字典，保持向后兼容。

4. 日志降级：在 engine.py 和 tokenizer_manager.py 中将 routed_dp_rank 被忽略的日志从 logger.warning 改为 logger.debug，仅在调试时可见。

5. 测试覆盖：在 test/registered/utils/test_network_address.py 中新增 TestZmqEndpointIPv6 测试类，覆盖合法 IPv6、IPv4、主机名、IPC 以及畸形端点，验证函数正确性。

关键文件：

• python/sglang/srt/utils/network.py（模块 网络工具；类别 source；类型 core-logic；符号 is_zmq_endpoint_ipv6）: 核心工具函数，新增 is_zmq_endpoint_ipv6 并重构 get_zmq_socket，是 IPv6 支持的基础。
• test/registered/utils/test_network_address.py（模块 网络测试；类别 test；类型 test-coverage；符号 TestZmqEndpointIPv6, test_bracketed_ipv6_endpoint, test_non_ipv6_endpoints, test_malformed_or_non_tcp_endpoints）: 新增 TestZmqEndpointIPv6 测试类，覆盖合法 IPv6、非 IPv6 及畸形端点，确保函数正确性。
• python/sglang/bench_serving.py（模块 基准工具；类别 source；类型 core-logic）: 添加 --temperature 和 --top-p 参数，使 sglang_generate 基准支持非贪婪采样。
• python/sglang/srt/managers/load_snapshot.py（模块 快照模块；类别 source；类型 dependency-wiring）: 导入并使用 is_zmq_endpoint_ipv6，在 ZMQ writer/reader 构造函数中设置 IPV6 选项。
• python/sglang/srt/entrypoints/engine.py（模块 引擎入口；类别 source；类型 core-logic）: 将 routed_dp_rank 忽略的日志从 warning 降级为 debug，减少告警噪音。
• python/sglang/srt/managers/tokenizer_manager.py（模块 Tokenizer管理；类别 source；类型 core-logic）: 同上，同步降级日志级别。

关键符号：is_zmq_endpoint_ipv6

评论区精华

Review 中仅有一条评论：作者 merrymercy 要求将最初在 load_snapshot.py 中定义的 _endpoint_is_ipv6 函数移至 sglang.srt.utils.network 模块（[comment]）。后续提交实现了该重构，最终版本直接复用 is_zmq_endpoint_ipv6，避免了代码重复和模块耦合。

• IPv6 检测函数位置 (design): 在后续提交中重构，使用 shared helper 替代，最终版本直接调用 is_zmq_endpoint_ipv6。

风险与影响

• 风险：
  1. IPv6 兼容性：is_zmq_endpoint_ipv6 的检测逻辑仅对以 tcp://[ 开头的端点启用 IPv6，对现有 IPv4/IPC 路径无影响，风险较低。但若端点格式不符合预期（如未加括号的 IPv6），则会回退到 IPv4 行为，可能仍无法连接，需依赖用户配置正确的端点。
  2. bench_serving 默认值：--temperature 默认为 0.0，--top_p 默认为 1.0，与之前硬编码的贪婪采样行为一致，无行为变化。若用户未指定任何参数，结果不受影响。
  3. 日志降级：routed_dp_rank 警告降级仅影响日志输出级别，无功能风险。
• 影响：
  1. 用户影响：使用 IPv6-only 多节点 DP 的用户可直接受益；bench_serving 用户可获得更灵活的采样配置；非 DP 服务器用户将看到更干净的日志。
  2. 系统影响：无性能退化，代码改动集中在工具函数和配置点，模块间依赖清晰。
  3. 团队影响：统一的 IPv6 检测函数可复用，降低了后续网络相关变更的重复工作。
     - 风险标记：IPv6 端点格式依赖, 低风险

关联脉络

• PR #27145 fix(load-snapshot): avoid duplicate zmq bind in multi-tokenizer mode: 同为 load_snapshot 模块的 ZMQ 相关修复，文件有交集。
• PR #26576 [EPD] feat: encoder DP mode with per-rank subprocess workers: 涉及多节点 DP 通信，与本 PR 的 IPv6 支持同属 disaggregation/DP 基础设施改进。