执行摘要

• 一句话：gRPC GetServerInfo 暴露 KV 事件发现元数据
• 推荐动作：值得快速阅读，以了解如何在不改变协议的情况下向 gRPC 接口添加元数据。设计决策是复用现有方法而非重复实现，值得关注。

功能与动机

Dynamo 的原生 SGLang sidecar 需要 SGLang ZMQ KV-event 发布者的已验证描述，以订阅每个数据并行 rank 的事件流用于事件驱动的 KV 路由。虽然 HTTP /server_info 已暴露该结构化描述，但原生 gRPC GetServerInfo 仅返回原始 ServerArgs 字段，消费方不得不重复实现 SGLang 的端点验证和 DCP 相关块大小计算。

实现拆解

1. 变更入口：在 python/sglang/srt/entrypoints/grpc_bridge.py 的 get_server_info 方法中，于现有 result 字典上新增 kv_events 键，其值为 self.tokenizer_manager.server_args.describe_kv_events_publisher() 的返回结果。
2. 核心逻辑：get_server_info 原本通过 dataclasses.asdict 序列化 server_args 并合并 scheduler_info，现在追加 kv_events 字段，保持所有现有扁平字段不变，且不修改 protobuf 契约，只扩展 JSON 负载。
3. 潜在影响：describe_kv_events_publisher() 仅在调用 GetServerInfo 时执行，不在推理路径上，因此对性能无影响。由于字段是新增的，现有依赖不会受到破坏。
4. 测试与文档：PR 未有直接新增测试文件，仅依赖现有 test_grpc_bridge.py 覆盖该路径；文档未做改动，因为属于增量发现字段。

关键文件：

• python/sglang/srt/entrypoints/grpc_bridge.py（模块 gRPC桥接；类别 source；类型 core-logic；符号 get_server_info）: 这是唯一变更的文件，在 get_server_info 方法中新增 kv_events 字段，向 gRPC 客户端暴露 KV 事件发现元数据。

关键符号：get_server_info

关键源码片段

python/sglang/srt/entrypoints/grpc_bridge.py

这是唯一变更的文件，在 get_server_info 方法中新增 kv_events 字段，向 gRPC 客户端暴露 KV 事件发现元数据。

    def get_server_info(self) -> str:
        # 将 server_args 转为 dict，并合并 scheduler_info
        result: Dict[str, Any] = dataclasses.asdict(self.tokenizer_manager.server_args)
        result.update(self.scheduler_info)
        # 新增 kv_events 字段，暴露 KV 事件发布者描述，供 Dynamo 等外部系统订阅
        # 该字段是在 GetServerInfo 调用时动态计算，不在推理路径上
        result["kv_events"] = (
            self.tokenizer_manager.server_args.describe_kv_events_publisher()
        )
        return json.dumps(msgspec_to_builtins(result), default=str)

评论区精华

本 PR 的 review 仅有一个批准（Approved），没有额外讨论。PR body 中说明了测试策略：未保留冗余的字段存在性测试，依赖现有桥接测试覆盖 GetServerInfo 响应路径。

• 暂无高价值评论线程

风险与影响

• 风险：该变更风险极低：仅向 JSON 响应增加一个字段，不改变现有字段或协议，不影响推理性能。潜在风险是 describe_kv_events_publisher() 的实现可能会抛异常，但该字段仅在调用时计算，且 server_args 已经存在，因此可能性极低。另外，由于未新增测试，若未来该字段被移除或修改，不会立刻被测试捕获。
• 影响：对用户的影响是 gRPC 调用方可以获取到 KV 事件发现元数据，特别是 Dynamo 集成场景。对系统的性能无影响。对团队而言，这是一个小而明确的增强，加速了外部系统与 SGLang 的集成。
• 风险标记：缺少测试覆盖

关联脉络

• 暂无明显关联 PR