执行摘要

• 一句话：注册 #27338 到 pr_fix_toggle 逆向开关
• 推荐动作：该 PR 变更简单明了，建议合并。对于关注 EAGLE speculative decoding 和 CUDA graph 稳定性的开发者，可了解该 revert 机制及其对应 PR #27338 的修复内容。

功能与动机

PR #27338 修复了 topk > 1 时 EAGLE draft CUDA-graph 中 kv_indices 缓冲区大小不足的问题。为了便于对该修复进行回归验证（A/B 测试），需要将其注册到 pr_fix_toggle 机制中。PR body 指出：#27338 (EAGLE draft cuda-graph kv_indices topk under-allocation) wasn't registered. This adds it: reverting drops the * self.topk from the buffer alloc, so the always-on size invariant #27338 added in common_template trips deterministically.

实现拆解

1. 新增 YAML revert patch: 在 python/sglang/srt/debug_utils/pr_fix_toggle.py 中定义 _PR_REVERT_YAML_27338 字符串常量，包含一个 patch 配置，其 target 为 sglang.srt.layers.attention.flashinfer_backend.FlashInferMultiStepDraftBackend.init_cuda_graph_state，将 buffer size 分配元组从 (self.speculative_num_steps, max_bs * self.topk * self.max_context_len) 回退为 (self.speculative_num_steps, max_bs * self.max_context_len)，从而移除 topk 缩放因子。
2. 注册到字典: 在 _PR_FIX_REVERT_YAML 字典中添加键值对 27338: _PR_REVERT_YAML_27338，使得 maybe_revert_pr_fix() / _revert_pr_fix() 能够通过 PR 编号定位该 patch。

关键文件：

• python/sglang/srt/debug_utils/pr_fix_toggle.py（模块 调试工具；类别 source；类型 configuration）: 唯一变更文件，新增 YAML patch 配置和注册条目

关键符号：未识别

评论区精华

无人工 review 讨论。gemini-code-assist 机器人自动评论了工具即将下线的通知，未提供实质反馈。

• 暂无高价值评论线程

风险与影响

• 风险：风险极低：变更仅影响调试/测试工具链，不修改任何生产逻辑。pr_fix_toggle 机制仅在 SGLANG_DEBUG_REVERT_PR 环境变量设置且为 '27338' 时生效，默认行为不变。若 YAML patch 格式有误，apply_patches_from_config 可能抛出异常，但该异常将被调用方捕获并影响调试流程，不影响正常推理。
• 影响：影响范围：仅限于开发/测试人员使用调试工具时，多了一个可回退的 PR。影响程度：低，因为 pr_fix_toggle 是内部调试设施，不影响最终用户。同时，它为 #27338 相关回归测试提供了便捷的 A/B 验证手段，有助于提升代码质量。
• 风险标记：仅调试工具变更, 无生产路径影响

关联脉络

• PR #27338 [Bug] Fix EAGLE draft CUDA-graph kv_indices under-allocation for topk > 1: 本 PR 注册的 revert 目标，对应同一个修复的逆向操作
• PR #25015 （未提供标题，来自历史 PR 上下文）: 同文件已有 revert 配置的 PR，说明 pr_fix_toggle 机制持续扩展