执行摘要

• 一句话：MRV1 弃用前翻转 specdec 检查为黑名单并统一 ngram 分支
• 推荐动作：无需精读，快速浏览即可。值得关注的设计决策是“弃用过渡期把白名单倒置为黑名单”的思路：当旧运行时即将移除时，从维护“支持什么”转向维护“还不支持什么”，既减少维护成本，也让新特性默认流向新实现。对正在做类似运行时迁移的团队有参考价值。

功能与动机

PR body 明确指出动机："Now that we are looking at MRV1 deprecation, change the spec decode method check to be based on unsupported methods rather than supported ones; unify with unnecessarily separate ngram check." 即：MRV1 即将弃用，不再需要以白名单方式长期维护“MRV2 已支持方法”，改为黑名单只维护“尚未支持方法”，并顺手合并多余的独立 ngram 分支。

实现拆解

1. 变更入口：唯一改动文件为 vllm/config/vllm.py，函数是 _get_v2_model_runner_unsupported_features，它收集 V2 model runner 尚不支持的特性，供启动期配置校验决定是否回退到 MRV1。
2. 核心逻辑翻转：specdec 方法检查从 if method not in ("eagle", "eagle3", "mtp", "dflash", "dspark", "extract_hidden_states") 的白名单排除，改为 if method in ("ngram", "ngram_gpu", "draft_model", "suffix", "medusa", "mlp_speculator", "custom_class") 的黑名单命中；黑名单每条都附有引入依据的 PR 链接（PR #40704、PR #43091）。
3. 分支合并与消息统一：原独立的 ngram/ngram_gpu 分支及其专属消息 "ngram/ngram_gpu speculative decoding" 被删除，统一走 "speculative method '{method}'" 格式，行为等价但文本变化。
4. 测试与配套：无测试、文档或配置配套变更；CI 由 /ci run 触发并已在 Buildkite CI #88926 通过。

关键文件：

• vllm/config/vllm.py（模块 配置校验；类别 source；类型 core-logic；符号 _get_v2_model_runner_unsupported_features）: 本 PR 唯一变更文件，核心逻辑位于 _get_v2_model_runner_unsupported_features：将 specdec 方法校验从白名单排除翻转为黑名单命中，并删除独立的 ngram 分支、统一错误消息，是 MRV1 弃用过渡的配置层清理。

关键符号：_get_v2_model_runner_unsupported_features

关键源码片段

vllm/config/vllm.py

本 PR 唯一变更文件，核心逻辑位于 _get_v2_model_runner_unsupported_features：将 specdec 方法校验从白名单排除翻转为黑名单命中，并删除独立的 ngram 分支、统一错误消息，是 MRV1 弃用过渡的配置层清理。

def _get_v2_model_runner_unsupported_features(self) -> list[str]:
    # 收集 V2 model runner 尚不支持的特性，供上层决策是否回退到 MRV1。
    unsupported: list[str] = []
    model_config = self.model_config
    speculative_config = self.speculative_config
​
    if self.compilation_config.mode == CompilationMode.STOCK_TORCH_COMPILE:
        unsupported.append("stock torch.compile")
​
    if (
        self.compilation_config.pass_config.enable_sp
        and self.parallel_config.tensor_parallel_size > 1
    ):
        unsupported.append("sequence parallelism")
​
    if (
        self.parallel_config.distributed_executor_backend == "external_launcher"
        and self.parallel_config.pipeline_parallel_size > 1
    ):
        unsupported.append("pipeline parallelism with external_launcher")
​
    if speculative_config is not None:
        # MRV1 弃用前清理：把“白名单放行”改为“黑名单拒绝”。
        # 这样未来新增 speculative 方法时默认由 MRV2 尝试支持，避免每次
        # 新方法落地都要求同步维护这里的白名单；黑名单条目均对应尚未在
        # V2 model runner 中实现的方法，链接的 PR 是各自的引入依据。
        if speculative_config.method in (
            # https://github.com/vllm-project/vllm/pull/40704
            "ngram",
            "ngram_gpu",
            # https://github.com/vllm-project/vllm/pull/43091
            "draft_model",
            "suffix",
            "medusa",
            "mlp_speculator",
            "custom_class",
        ):
            unsupported.append(f"speculative method '{speculative_config.method}'")
​
        # V2 的 EagleSpeculator 不支持 parallel_drafting（P-Eagle 场景），
        # DFlash 与 DSpark 在 V2 中由各自 speculator 原生支持并行草稿。
        if (
            speculative_config.parallel_drafting
            and speculative_config.method not in ("dflash", "dspark")
        ):
            unsupported.append("parallel drafting for EAGLE speculative decoding")
​
    # ...（其余与 specdec 无关的检查，如 ubatching、elastic EP、logits
    # processors、mamba cache mode 等保持不变）

评论区精华

本 PR 没有代码级 review 评论：claude[bot] 因 fork PR 自动禁用审查，WoosukKwon 直接 approve。唯一值得记录的事实是作者通过 /ci run 触发 Buildkite CI #88926 并通过。真正的设计权衡并未在评论中交锋，而是浓缩在 PR body 一句“MRV1 弃用”背景里：黑名单取代白名单意味着未来新增方法默认放行给 MRV2。

• 暂无高价值评论线程

风险与影响

• 风险：
  1. 语义变化（默认放行）：旧白名单对未列举方法 fail-closed，新黑名单对未列举方法 fail-open。若未来在 MRV2 尚未支持时新增 specdec 方法，将不会在启动期被拦截回退，而可能在运行期暴露错误；这与 MRV1 弃用方向一致，属于预期取舍，但需在 MRV2 后续迭代中留意。
  2. 错误消息文本变化：ngram/ngram_gpu 的报错从 "ngram/ngram_gpu speculative decoding" 变为 "speculative method 'ngram'"，若外部脚本或测试对旧文本有断言会失效；本仓库内未发现相关断言。
  3. 缺少测试覆盖：唯一变更文件无配套测试，等价性依赖人工审查；幸而改动仅 20 行且 CI 通过。
  4. 黑名单维护风险：黑名单中 medusa、mlp_speculator、draft_model 等若未来在 MRV2 落地而忘记从黑名单移除，会误伤用户。
     - 影响：用户影响：使用 MRV2 配置路径的用户，当前受支持的 specdec 方法（eagle、eagle3、mtp、dflash、dspark、extract_hidden_states）行为不变；ngram、medusa、suffix 等方法依旧被标记为不支持，仅报错文案统一。系统影响：启动期配置校验路径的逻辑等价，无性能与内存影响。团队影响：为 MRV1 deprecation 扫清配置层障碍，减少未来新增 specdec 方法时同步维护白名单的负担，同时明确 MRV2 作为默认前进方向。整体影响面小、风险低。
     - 风险标记：行为语义变化（未列举方法默认放行）, 无测试覆盖, 错误消息文本变更

关联脉络

• PR #52228 [Model Runner V2] Acceptance estimation for adaptive verification: 同为 MRV2 与 speculative decoding 能力建设线：该 PR 为 MRV2 增加在线接受率估计器，本 PR 则清理 MRV2 的 specdec 配置校验逻辑，二者共同推进 MRV2 成为 specdec 默认路径。
• PR #56666 [MRV2] Run pooling post processing on non-final PP ranks: 同属 MRV2 成熟化 bugfix 系列，与本 PR 共享 MRV1/MRV2 过渡背景，反映团队正在系统性收敛 MRV2 行为差异。
• PR #56908 [Model Runner V2] Tolerate lack of pinned memory support: 同属 MRV2 支持范围扩展（无 pinned memory 平台回退），与本文一样是在为 MRV1 弃用扫清障碍的系列工作。