执行摘要

• 一句话：移除 5 个文件中未使用的实例属性
• 推荐动作：值得合并，属低风险技术债务清理。建议审核时确认这些字段确实无外部引用（如通过 grep 验证）。此外，此 PR 可作为后续更大范围属性清理（如 scheduler 中类似字段）的参考模式。

功能与动机

PR body 指出这些是“dead state writes / instance attributes that are never read”，覆盖 speculative decoding、disaggregation event publisher 和顶层 Engine 入口。清理无用代码属于常规技术债务管理，出自作者 "fzyzcjy" 的机械重构链（refactor chain ID: drop-unused-spec-engine-fields）。

实现拆解

1. Engine 入口 (entrypoints/engine.py)：删除 __init__ 中根据 scheduler_init_result.engine_info_bootstrap_server 赋值 self.remote_instance_transfer_engine_info 的代码块（5 行）。该字段在后续方法中未被引用，且 engine_info_bootstrap_server 的逻辑已由其他机制覆盖。
2. KV 事件发布器 (disaggregation/kv_events.py)：删除抽象基类 EventPublisher.__init__ 中 self._attn_dp_rank = attn_dp_rank 赋值（4 行）。该属性仅在 EventPublisher 子类 ZmqEventPublisher 中使用，而 ZmqEventPublisher 有自己的 self._dp_rank，无需继承。因此删除父类赋值，并移除子类中对 super().__init__(attn_dp_rank) 的调用。
3. 自适应推测参数 (speculative/adaptive_spec_params.py)：删除 __init__ 中 self.min_steps 和 self.max_steps 的赋值（2 行）。这两个字段在类内未被任何方法使用，推测可能是历史遗留或为未来扩展预留，但当前无读操作。
4. NgramCorpus (speculative/cpp_ngram/ngram_corpus.py)：删除 __init__ 中 self.default_mask 的赋值（1 行）。该字段未被任何方法引用。
5. Eagle 工作器 (speculative/eagle_worker_v2.py)：删除 init_attention_backend 中 self.has_prefill_wrapper_verify = False（1 行）。该字段未被任何方法读取。

关键文件：

• python/sglang/srt/entrypoints/engine.py（模块 入口文件；类别 source；类型 core-logic）: 删除了 Engine 入口中 remote_instance_transfer_engine_info 的赋值逻辑，该字段从未被读取。影响 init 流程中的条件分支。
• python/sglang/srt/disaggregation/kv_events.py（模块 事件发布；类别 source；类型 core-logic；符号 init）: 删除抽象基类 EventPublisher 的 __init__ 及 _attn_dp_rank 属性，并移除子类 ZmqEventPublisher 中对 super().__init__ 的调用。因为 _attn_dp_rank 仅在子类中被覆盖，父类赋值无用。
• python/sglang/srt/speculative/adaptive_spec_params.py（模块 推测解码；类别 source；类型 core-logic）: 删除 __init__ 中 self.min_steps 和 self.max_steps 的赋值，这两个字段未被类内任何方法读取，可能是历史遗留。
• python/sglang/srt/speculative/cpp_ngram/ngram_corpus.py（模块 推测解码；类别 source；类型 core-logic）: 删除 __init__ 中 self.default_mask 的赋值，该字段未被任何方法读取。
• python/sglang/srt/speculative/eagle_worker_v2.py（模块 推测解码；类别 source；类型 core-logic）: 删除 init_attention_backend 中 self.has_prefill_wrapper_verify = False，该字段未被读取。

关键符号：init

关键源码片段

python/sglang/srt/entrypoints/engine.py

删除了 Engine 入口中 remote_instance_transfer_engine_info 的赋值逻辑，该字段从未被读取。影响 init 流程中的条件分支。

# python/sglang/srt/entrypoints/engine.py (head)
# 删除以下 5 行，因为 remote_instance_transfer_engine_info 从未被读取
"""
# Access transfer engine info if bootstrap server is started.
if scheduler_init_result.engine_info_bootstrap_server is not None:
    self.remote_instance_transfer_engine_info = (
        scheduler_init_result.engine_info_bootstrap_server.transfer_engine_info
    )
"""

python/sglang/srt/disaggregation/kv_events.py

删除抽象基类 EventPublisher 的 __init__ 及 _attn_dp_rank 属性，并移除子类 ZmqEventPublisher 中对 super().__init__ 的调用。因为 _attn_dp_rank 仅在子类中被覆盖，父类赋值无用。

# python/sglang/srt/disaggregation/kv_events.py (head)
class EventPublisher(ABC):
    """
    ...
    """
    # 删除了 __init__ 方法，因为 self._attn_dp_rank 在子类中有独立实现
    # def __init__(self, attn_dp_rank: int = 0):
    # self._attn_dp_rank = attn_dp_rank
​
    @abstractmethod
    def publish(self, events: EventBatch) -> None:
        ...
​
class ZmqEventPublisher(EventPublisher):
    def __init__(self, attn_dp_rank: int, ...):
        # Storage
        # 删除了 super().__init__(attn_dp_rank)
        self._event_queue = Queue[Optional[EventBatch]](maxsize=max_queue_size)
        ...

评论区精华

无 review 讨论（评论数为 1，仅为 gemini-code-assist 的配额提示，非人工讨论）。PR 由作者自行合并，表明这是一道低争议的机械重构。

• 暂无高价值评论线程

风险与影响

• 风险：风险极低。所有删除的属性均为只写（write-only）字段，移除后无读操作受影响。但需注意：如果这些字段在外部通过反射（如 getattr）或序列化访问，则可能引发错误。不过从代码上下文看无此可能——NgramCorpus 的 default_mask 在 patch 前后无外部引用，has_prefill_wrapper_verify 仅在当前类中赋值为 False 但从未读取。建议确保下游代码或动态属性检查（如 hasattr）不依赖这些字段。
• 影响：直接影响：5 个文件，13 行删除，无新增代码，无 API 或行为变化。影响范围：仅限于 speculative decoding 和 disaggregation 模块的初始化逻辑。对用户透明，无需迁移。团队受益于点消除了潜在误解（如误以为 min_steps/max_steps 是配置项），降低了维护成本。
• 风险标记：低风险, 无测试覆盖

关联脉络

• PR #25444 Bundle Scheduler rank/size fields into a frozen ParallelState: 同为属性字段清理/封装重构，属于同一波技术债务清理序列。
• PR #25442 Lift forward_ct/cur_batch and use direct access in watchdog: 同为移除防御性代码、简化属性访问的重构。
• PR #25435 Replace single-line defensive getattrs with direct access: 同为移除无用属性访问模式，属于同一重构链。