执行摘要

• 一句话：重构工具解析器，将工具依赖从 request.tools 移至 self.tools，统一工具管理逻辑。
• 推荐动作：建议技术管理者和工程师精读此 PR，重点关注基类过滤逻辑的设计决策和跨解析器的一致性变更，以了解工具解析器重构的模式和潜在风险点。

功能与动机

根据 PR body 描述，目的是“迁移工具解析器以从 self.tools（在构造时设置）读取工具，而不是在调用时从 request.tools 读取”，这是工具解析器清理系列的第二部分，跟随 #38029，旨在提升代码清晰度和可维护性。

实现拆解

实现方案分为三个层次：

1. 基类更新：在 vllm/tool_parsers/abstract_tool_parser.py 中，ToolParser.__init__ 方法新增过滤逻辑，仅存储 ChatCompletionToolsParam | FunctionTool 实例到 self.tools。
2. 子类适配：修改了多个工具解析器文件（如 deepseekv32_tool_parser.py、glm4_moe_tool_parser.py 等），将原本从 request.tools 获取工具的逻辑替换为 self.tools，涉及方法如 _convert_params_with_schema、extract_tool_calls 等。
3. 测试更新：所有相关测试文件（如 test_deepseekv32_tool_parser.py）调整为在解析器构造时传递工具，并移除对 request.tools 的依赖。

关键文件：

• vllm/tool_parsers/abstract_tool_parser.py（模块 tool_parsers）: 修改了基类 ToolParser.init 方法，新增工具过滤逻辑，是所有工具解析器的核心变更点。
• vllm/tool_parsers/deepseekv32_tool_parser.py（模块 tool_parsers）: 更新了 _convert_params_with_schema 方法以使用 self.tools 替代 request.tools，展示了子类适配的具体实现。
• tests/tool_parsers/test_deepseekv32_tool_parser.py（模块 tests）: 调整了测试用例，在解析器构造时传递工具，验证了新架构的正确性，是测试覆盖的关键文件。

关键符号：ToolParser.init, _convert_params_with_schema, extract_tool_calls, _parse_xml_function_call

评论区精华

review 中核心讨论点包括：

• 工具类型过滤问题：gemini-code-assist[bot] 警告 FunctionTool 可能被错误过滤，但 sfeng33 和 bbrowning 确认其为 Pydantic 模型而非 TypedDict，确保过滤逻辑正确。
• Responses API 兼容性：chaunceyjiang 询问是否测试了 Responses API，sfeng33 回复已测试并确认 FunctionTool 是 Responses API 使用的类型。

• 遗留代码处理：bbrowning 指出 _WrappedParser 暂时未传递工具，但认为在当前使用场景下可接受，可能在未来步骤中处理。

  • 工具类型过滤的正确性 (correctness): 确认过滤逻辑正确，无需修改，因为代码库中实际传递的是 Pydantic 模型实例。
  • Responses API 兼容性 (design): 变更兼容两种 API，但 _WrappedParser 可能在未来步骤中需要调整。

风险与影响

• 风险：技术风险包括：
  1. 类型过滤风险：在 abstract_tool_parser.py 中，过滤逻辑依赖于 isinstance 检查 ChatCompletionToolsParam 和 FunctionTool，如果传入非标准类型可能导致工具被错误丢弃，但讨论已确认当前代码库中使用的是 Pydantic 模型，风险较低。
  2. API 兼容性风险：Responses API 与 Chat API 的工具类型可能不同，变更可能影响这些路径，但作者表示已测试双方。
  3. 回归风险：修改了多个解析器文件的核心逻辑，如果没有全面测试覆盖，可能引入工具调用解析错误，但 PR 更新了所有相关测试以验证新逻辑。
• 影响：影响分析：
  • 对系统：简化了工具解析器的接口，减少了方法参数传递，提升了代码模块化和可维护性；影响范围集中在工具调用模块，不影响核心推理路径。
  • 对用户：无直接用户界面变更，但工具调用行为应保持相同，确保了向后兼容性。
  • 对团队：为后续工具解析器清理（如 step 3）打下基础，促进统一工具处理逻辑。
  • 风险标记：工具过滤逻辑风险, API 兼容性风险, 测试覆盖不足

关联脉络

• PR #38029 [Tool Parser][1/3] Use self.tools instead of request.tools in tool parsers: 此 PR 是清理系列的第一部分，直接关联作为前置步骤，共同迁移工具解析器架构。
• PR #38264 [Mypy] Fix adjust_request typing: 涉及工具解析器的类型注解调整，与本 PR 共享相同模块，反映了工具调用功能的演进。
• PR #38265 [Refactor] Consolidate Tool type alias in tool_parsers/utils.py: 统一了工具类型别名，与本 PR 同属工具解析器重构的一部分，提升了代码一致性。