执行摘要

• 一句话：删除 DSpark 错误的启动断言，恢复合法配置启动
• 推荐动作：值得快速阅读：它展示了一个错误配置断言的判别与回滚过程。如果你在使用 DSpark 或维护 speculative decoding 配置，建议关注两点：一是删除后下游是否真正容忍小 num_speculative_tokens；二是历史 PR #47419 中该断言为何被引入，避免相似问题复发。

功能与动机

PR body 明确指出：“Removes an invalid assertion added erroneously in PR #47419”。即该断言并非基于真实加载的模型约束，而是错误加入的启动期校验，会让本应可运行的 DSpark 配置在 SpeculativeConfig.__post_init__ 阶段直接抛 ValueError，因此需要移除以恢复启动能力。

实现拆解

1. 变更入口：唯一改动文件 vllm/config/speculative.py，落点为 SpeculativeConfig.__post_init__。这是 speculative decoding 配置的核心校验函数，负责统一裁决 num_speculative_tokens、draft TP 大小与 max_model_len 等参数。
2. 核心逻辑：删除 if self.method == 'dspark' 代码块（约 25 行）。该块从 draft_model_config.hf_config 读取 dspark_block_size，若该属性存在且 num_speculative_tokens 小于 block size，则抛 ValueError。删除后，校验流程从 inkling_mtp 约束直接进入 _verify_and_get_draft_tp，DSpark 的 num_speculative_tokens 不再受配置层下限约束。
3. 配套改动：无。本 PR 没有新增测试、文档或配置样例变更，提交记录仅一个 commit “remove faulty assert”。正确性依赖下游执行路径与社区验证，而非自动回归。

关键文件：

• vllm/config/speculative.py（模块 配置层；类别 source；类型 core-logic；符号 SpeculativeConfig.post_init）: 唯一变更文件，在 SpeculativeConfig.post_init 中删除 PR #47419 错误引入的 DSpark block size 启动断言；删除后 DSpark 配置不再因 num_speculative_tokens 小于 hf_config.dspark_block_size 被拒绝。

关键符号：SpeculativeConfig.post_init

关键源码片段

vllm/config/speculative.py

唯一变更文件，在 SpeculativeConfig.post_init 中删除 PR #47419 错误引入的 DSpark block size 启动断言；删除后 DSpark 配置不再因 num_speculative_tokens 小于 hf_config.dspark_block_size 被拒绝。

# vllm/config/speculative.py -- SpeculativeConfig.__post_init__ 相关校验段（head 版本）
if self.num_speculative_tokens is None:
    raise ValueError(
        'A speculative model was provided, but '
        '`num_speculative_tokens` was not provided'
    )
​
if (
    self.draft_model_config.hf_config.model_type == 'inkling_mtp'
    and self.num_speculative_tokens != 1
):
    raise ValueError(
        'Inkling MTP currently supports exactly one speculative token'
    )
​
# 此处原本存在 PR#47419 错误引入的 DSpark 块大小断言：
# 当 hf_config 中存在 dspark_block_size 且 num_speculative_tokens 小于它时，
# 会直接抛 ValueError。该断言已被删除，因此 DSpark 配置不再被启动阶段
# 误拒绝，block 大小合法性交由下游实际执行路径判断。
​
self.draft_tensor_parallel_size = (
    SpeculativeConfig._verify_and_get_draft_tp(
        self.target_parallel_config,
        self.draft_tensor_parallel_size,
        self.draft_model_config.hf_config,
    )
)

评论区精华

本 PR 没有任何实质技术评论。claude[bot] 说明来自 fork 的 PR 默认禁用自动审查、可手动触发；mgoin 直接 APPROVED 且无附加意见。作者随后自行合并，说明该修复获得了维护者共识，但未公开讨论断言的错误细节。

• fork PR 自动审查与审批 (other): 无技术交锋，变更获维护者批准后由作者合并。

风险与影响

• 风险：删除校验后，若用户以 num_speculative_tokens < dspark_block_size 运行 DSpark，启动阶段不再报错。若原断言描述的问题真实存在，则模型可能进入半自回归块机制不支持的布局，产生乱码输出（原注释明确警告 “yields incorrect (garbled) output”）。同时本 PR 无任何测试或文档配套，无法自动回归验证该删除行为。风险集中在 vllm/config/speculative.py 的 SpeculativeConfig.__post_init__ 路径，影响 DSpark 推测解码用户。
• 影响：对用户：使用 DSpark（如 DeepSeek V4 系）的用户不再被启动断言误杀，num_speculative_tokens 配置自由度恢复。对系统：改动仅配置层，不触碰执行路径与 kernel，运行时行为不变。对团队：这是对 PR #47419 引入回归的快速修正，也提醒配置断言应基于可靠来源；后续如 DSpark 确实需要 block 约束，应在执行侧补充校验。
• 风险标记：配置层校验移除, 缺少测试覆盖, 依赖下游执行路径

关联脉络

• PR #50424 Support quantized DSpark Markov heads: 同属 DSpark 推测解码功能线，PR #50424 在模型侧支持量化 DSpark，本 PR 修正 DSpark 配置侧的启动断言，两者共同演进 DSpark 支持。