执行摘要

• 一句话：重命名 PrefillAdder 构造函数参数以提升语义清晰度。
• 推荐动作：该 PR 变更简单直接，主要价值在于提升代码可读性。建议快速浏览以了解参数语义的澄清，无需深入分析。对于新接触调度模块的开发者，可关注 PrefillAdder 中 num_mixed_decode_tokens 参数如何影响剩余 token 预算的计算逻辑。

功能与动机

根据 PR body 中的描述，当前参数名 mixed_with_decode_tokens 容易引起误解，看起来像是“与解码混合的 token 数量”，但实际上它表示“即将生成的解码 token 数量与预填充混合的数量”。重命名为 num_mixed_decode_tokens 旨在提升代码的可读性和语义清晰度，避免后续开发者产生混淆。

实现拆解

1. 核心参数重命名：在 python/sglang/srt/managers/schedule_policy.py 中，将 PrefillAdder.__init__ 方法的参数 mixed_with_decode_tokens 重命名为 num_mixed_decode_tokens，并同步更新构造函数内部对该参数的所有引用，包括 self.rem_input_tokens、self.rem_chunk_tokens、self.rem_total_token_offset 和 self.cur_rem_token_offset 的计算逻辑。
2. 测试配套更新：在 test/registered/unit/managers/test_prefill_adder.py 中，更新测试辅助函数 create_adder 和测试用例 test_mixed_chunk_prefill_budgets 中对 PrefillAdder 构造函数的调用，将参数名从 mixed_with_decode_tokens 改为 num_mixed_decode_tokens，确保测试与源码保持一致。
3. 代码注释微调：在 schedule_policy.py 中，为 self.rem_total_token_offset 的累加逻辑添加了一行注释“# Estimate the offset in the remaining token space”，提升了代码可读性。

关键文件：

• python/sglang/srt/managers/schedule_policy.py（模块 调度策略；类别 source；类型 core-logic；符号 PrefillAdder.init）: 核心调度策略文件，包含 PrefillAdder 类的定义，参数重命名直接影响其初始化逻辑。
• test/registered/unit/managers/test_prefill_adder.py（模块 调度策略；类别 test；类型 test-coverage；符号 TestPrefillAdder.create_adder, TestPrefillAdder.test_mixed_chunk_prefill_budgets）: PrefillAdder 的单元测试文件，同步更新测试中的参数名以保持一致性。

关键符号：PrefillAdder.init

关键源码片段

python/sglang/srt/managers/schedule_policy.py

核心调度策略文件，包含 PrefillAdder 类的定义，参数重命名直接影响其初始化逻辑。

class PrefillAdder:
    def __init__(
        self,
        page_size: int,
        tree_cache: BasePrefixCache,
        token_to_kv_pool_allocator: BaseTokenToKVPoolAllocator,
        running_batch: ScheduleBatch,
        new_token_ratio: float,
        rem_input_tokens: int,
        rem_chunk_tokens: Optional[int],
        num_mixed_decode_tokens: int = 0, # 重命名：从 mixed_with_decode_tokens 改为 num_mixed_decode_tokens，更清晰表达“混合的解码 token 数量”
        priority_scheduling_preemption_threshold: int = 0,
        max_prefill_bs: int = 0,
        max_running_requests: Optional[int] = None,
        prefill_max_requests: Optional[int] = None,
        prefill_delayer_single_pass: Optional[PrefillDelayerSinglePassExecutor] = None,
        dllm_config: Optional[DllmConfig] = None,
    ):
        self.page_size = page_size
        self.tree_cache = tree_cache
        self.token_to_kv_pool_allocator = token_to_kv_pool_allocator
        self.running_batch = running_batch
        self.new_token_ratio = new_token_ratio
        self.rem_input_tokens = rem_input_tokens - num_mixed_decode_tokens # 更新引用：使用新参数名计算剩余输入 token
        self.rem_chunk_tokens = rem_chunk_tokens
        self.dllm_config = dllm_config
​
        if self.dllm_config is not None:
            self._init_dllm_meta(dllm_config)
​
        if self.rem_chunk_tokens is not None:
            self.rem_chunk_tokens -= num_mixed_decode_tokens # 更新引用：调整剩余块 token 预算
        self.rem_total_token_offset = num_mixed_decode_tokens # 更新引用：设置总 token 偏移量
        self.cur_rem_token_offset = num_mixed_decode_tokens # 更新引用：设置当前剩余 token 偏移量
​
        # ... 其余初始化代码保持不变

评论区精华

本次 PR 没有 review 评论，直接由维护者合并。从 commit 历史看，作者 Edenzzzz 和合并者 hnyls2002 通过多次 merge main 分支解决了可能的冲突，并最终由 hnyls2002 提交了测试文件的更新，确保重命名在测试中同步生效。

• 暂无高价值评论线程

风险与影响

• 风险：低风险。变更仅限于参数重命名和内部变量引用更新，未涉及核心逻辑修改。主要风险点：
  • 回归风险：如果存在其他未更新的调用点或依赖该参数名的外部代码，可能导致运行时错误。但从变更范围看，仅影响 PrefillAdder 的直接调用者，且测试已覆盖，风险较低。
  • 兼容性风险：这是一个 breaking change，因为参数名变更会影响所有直接调用 PrefillAdder 构造函数的代码。但考虑到该参数有默认值（0），且主要内部使用，影响范围可控。
  • 测试覆盖风险：测试文件已同步更新，确保了重命名后的测试通过性，降低了因命名不一致导致的测试失败风险。
  • 影响：影响范围有限。直接影响 PrefillAdder 类的构造函数调用方，主要是调度器内部模块。对用户无感知，不影响 API 或外部行为。对团队而言，提升了代码可读性，但需要确保所有开发者知晓此重命名，避免后续开发中使用旧参数名。
  • 风险标记：参数重命名 breaking change, 依赖调用点需同步更新

关联脉络

• 暂无明显关联 PR