执行摘要

• 一句话：修复 SeedOSS 解析器回合边界 token 缺失，补充边界回退语义测试。
• 推荐动作：本 PR 是一个高质量、低风险的 bugfix，值得精读。它清晰地展示了如何通过简单的属性覆盖来适配模型差异，并补充了关键的测试用例以防止回归。对于负责维护或扩展解析器框架的工程师，本 PR 提供了很好的参考。建议关注 TURN_BOUNDARIES 属性的覆盖机制及其对 is_reasoning_end 方法行为的影响。

功能与动机

作为 PR#54089 的后续修复，解决了两个遗留问题：

1. SeedOSS 解析器从 Qwen3 继承了 ChatML 回合边界 token，但这些 token 不在 Seed 词表中，导致基于边界的作用域划分被静默禁用。
2. PR#54089 引入的边界回退逻辑（initial_state != REASONING）仅在思考启用时进行了测试，缺乏思考禁用场景的覆盖。

实现拆解

1. 修改 SeedOSS 解析器配置：在 vllm/parser/seed_oss.py 中，为 SeedOssParser 类新增类属性 TURN_BOUNDARIES，将其设置为 Seed 词表中真实的边界 token <seed:bos> 和 <seed:eos>，覆盖父类的 ChatML 默认值。同时更新文档字符串以反映这一变更。
2. 扩展 SeedOSS 测试用例：在 tests/parser/engine/test_seed_oss.py 中，新增 TestSeedTurnBoundaries 测试类，包含三个测试用例：验证历史中重放的推理不会被误判为结束、当前轮次中的推理结束标记会被正确识别、以及思考禁用时边界到达即表示推理结束。同时，更新了模拟词表以包含新的边界 token ID。
3. 增强 Qwen3 推理解析器测试：在 tests/parser/engine/test_qwen3_reasoning.py 中，为父类 Qwen3Parser 补充两个测试用例，分别验证在思考禁用（初始状态为 CONTENT）和思考启用（初始状态为 REASONING）时，边界回退逻辑的正确性，从而固化了对 is_reasoning_end 方法在不同配置下行为的预期。

关键文件：

• vllm/parser/seed_oss.py（模块 解析器；类别 source；类型 core-logic）: 核心源码文件，通过覆盖类常量修复了 SeedOSS 解析器的关键配置缺陷。
• tests/parser/engine/test_seed_oss.py（模块 解析器测试；类别 test；类型 test-coverage；符号 TestSeedTurnBoundaries, test_replayed_reasoning_in_history_not_end, test_think_end_in_current_turn_is_end, test_boundary_with_thinking_disabled_is_end）: 新增了针对 SeedOSS 回合边界功能的测试类，是验证修复正确性的关键。
• tests/parser/engine/test_qwen3_reasoning.py（模块 解析器测试；类别 test；类型 test-coverage；符号 test_boundary_with_thinking_disabled_is_end, test_boundary_with_thinking_enabled_not_end）: 为父类 Qwen3Parser 补充了边界回退语义的测试，覆盖了思考禁用场景。

关键符号：is_reasoning_end

关键源码片段

vllm/parser/seed_oss.py

核心源码文件，通过覆盖类常量修复了 SeedOSS 解析器的关键配置缺陷。

class SeedOssParser(Qwen3Parser):
    CONFIG_NAME = "seed_oss"
    THINK_START = "<seed:think>"
    THINK_END = "</seed:think>"
    TOOL_START = "<seed:tool_call>"
    TOOL_END = "</seed:tool_call>"
    # 覆盖父类的 ChatML 边界 token，使用 Seed 词表中实际存在的 token。
    # 这确保了在 Seed-OSS 模型的多轮对话中，基于回合边界的
    # 推理结束检测逻辑能够正常工作。
    TURN_BOUNDARIES = frozenset(("<seed:bos>", "<seed:eos>"))

tests/parser/engine/test_seed_oss.py

新增了针对 SeedOSS 回合边界功能的测试类，是验证修复正确性的关键。

class TestSeedTurnBoundaries:
    """验证 Seed-OSS 模型的回合边界 token 正确作用于推理结束检测。"""
​
    def test_replayed_reasoning_in_history_not_end(self, parser):
        # 模拟历史轮次中重放的推理 token 序列。
        # 遇到 <seed:eos> 边界后应停止向后扫描，避免历史内容干扰当前判断。
        assert not parser.is_reasoning_end(
            [
                _SEED_BOS_ID,
                _THINK_START_ID,
                _TEXT_ID,
                _THINK_END_ID,
                _TEXT_ID,
                _SEED_EOS_ID, # 边界 token，扫描到此停止
                _SEED_BOS_ID,
            ]
        )
​
    def test_boundary_with_thinking_disabled_is_end(self, mock_tokenizer):
        # 当思考功能禁用时（初始状态为 CONTENT），遇到边界 token
        # 即表示推理已结束（模型从未开始推理）。
        parser = SeedOssParser(
            mock_tokenizer, chat_template_kwargs={"enable_thinking": False}
        )
        assert parser.is_reasoning_end([_SEED_BOS_ID, _TEXT_ID])

评论区精华

本 PR 的 review 讨论非常简洁。作者 Xarbirus 在 PR body 中清晰地阐述了变更的两个目的和详细的测试计划。审阅者 sfeng33 仅以 “Thanks!” 表示 approve，未提出任何技术疑问或争议。所有变更均通过了 CI 验证。

• Turn-boundary token adaptation for Seed-OSS parser (correctness): 通过在 SeedOssParser 类中覆盖 TURN_BOUNDARIES 常量解决。
• Test coverage for boundary-fallback with thinking disabled (testing): 为 Qwen3Parser 和 SeedOssParser 分别新增了 test_boundary_with_thinking_disabled_is_end 测试用例。

风险与影响

• 风险：变更风险较低。核心变更仅涉及在解析器类中覆盖一个常量属性，并增加了对应的单元测试。逻辑清晰，影响范围局限于 SeedOSS 模型的解析行为。新增的测试用例有效覆盖了之前缺失的边界情况，提升了代码的健壮性。主要风险在于对 Seed 词表中 <seed:bos>/<seed:eos> token ID 的假设（代码中硬编码为 70, 71），需要与实际模型分词器保持一致。
• 影响：
  1. 用户影响：修复了使用 Seed-OSS 模型进行多轮对话时，推理内容可能被错误截断或保留的潜在问题，提升了工具调用和推理的可靠性。
  2. 系统影响：增强了解析器框架在多语言模型适配上的通用性，展示了如何通过覆盖父类属性来适配不同模型的特殊 token。
  3. 团队影响：为类似的模型适配工作（如添加新的解析器）提供了清晰的范例和更完善的测试基线。
     - 风险标记：硬编码 token ID, 继承覆盖

关联脉络

• PR #54089 [Parser] Scope reasoning end-detection to the current turn: 本 PR 是其直接后续修复，解决了该 PR 引入的基于回合边界的作用域划分逻辑在 SeedOSS 解析器上失效的问题，并补充了缺失的测试覆盖。
• PR #46314 [Parser] Fix malformed function end dropping sibling calls: 本 PR 中的测试用例 test_malformed_function_end_does_not_drop_siblings 是对该历史回归修复的验证。