执行摘要

• 一句话：提取共享的 coerce_to_schema_type 类型转换工具函数
• 推荐动作：值得精读。展示了如何安全提取公共工具函数，尤其类型别名映射设计、优先级处理、以及测试覆盖策略。对涉及工具调用的开发者，了解此函数有助于统一处理类型转换。

功能与动机

多个工具解析器（qwen3coder、qwen3xml、deepseekv32、step3p5、minimax_m2）各自实现了近乎相同的字符串到 Schema 类型的转换逻辑，导致代码重复和维护困难。此 PR 提取第一个共享版本以降低重复度，并为后续迁移提供单一的 Bug 修复与类型别名扩展点。

实现拆解

1. 在 vllm/tool_parsers/utils.py 中新增 _TYPE_ALIASES 字典（映射常见类型别名至标准 JSON Schema 类型名，如 str -> string, int -> integer），并实现 coerce_to_schema_type 函数。该函数接受原始字符串值和 Schema 类型（字符串或列表），按优先级（null > integer > number > boolean > object > array > string）依次尝试转换，失败则回退为原字符串或 JSON 解析结果。
2. 在 vllm/tool_parsers/minimax_m2_tool_parser.py 中导入 coerce_to_schema_type，将 _parse_single_invoke 中对 _convert_param_value_with_types 的调用替换为 coerce_to_schema_type，并删除原方法（约 77 行），同时新增辅助方法 _get_param_types_from_config 以清晰获取参数类型配置。
3. 新建测试文件 tests/tool_parsers/test_utils.py，覆盖全部类型（null、string、integer、number、boolean、object、array）及别名、多类型组合、边界情况（无效输入、大小写、特殊字符串 none/nil），确保函数行为正确且稳定。

关键文件：

• vllm/tool_parsers/utils.py（模块 工具解析器；类别 source；类型 core-logic；符号 coerce_to_schema_type, _TYPE_ALIASES）: 新增共享工具函数 coerce_to_schema_type 和类型别名映射 _TYPE_ALIASES，是本次重构的核心。
• vllm/tool_parsers/minimax_m2_tool_parser.py（模块 工具解析器；类别 source；类型 dependency-wiring；符号 _convert_param_value_with_types, _get_param_types_from_config）: 迁入导入调用，删除原重复方法，新增辅助方法 _get_param_types_from_config。
• tests/tool_parsers/test_utils.py（模块 测试；类别 test；类型 test-coverage；符号 TestCoerceToSchemaType, TestNullHandling, test_null_converted_when_type_is_null, test_null_converted_when_null_in_type_list）: 新增全面测试，覆盖所有类型和边界情况，确保共享函数正确性。

关键符号：coerce_to_schema_type, _get_param_types_from_config, _extract_types_from_schema

关键源码片段

vllm/tool_parsers/minimax_m2_tool_parser.py

迁入导入调用，删除原重复方法，新增辅助方法 _get_param_types_from_config。

# vllm/tool_parsers/minimax_m2_tool_parser.py (changes)
​
from vllm.tool_parsers.utils import coerce_to_schema_type
​
# ... 原 _convert_param_value_with_types 方法（约 77 行）被整体删除
# 替换为在 _parse_single_invoke 中直接调用：
​
param_dict[param_name] = coerce_to_schema_type(param_value, param_type)
​
# 同时新增辅助方法以清晰封装类型获取逻辑：
def _get_param_types_from_config(self, param_name: str, param_config: dict) -> list[str]:
    if param_name not in param_config:
        return ["string"]
    param_schema = param_config[param_name]
    if not isinstance(param_schema, dict):
        return ["string"]
    return self._extract_types_from_schema(param_schema)

评论区精华

gemini-code-assist[bot] 指出：类型规范化使用 startswith 过于宽泛，可能导致 "interval" 误归一化为 "integer"，建议改用精确匹配。作者回复“Fixed.”，最终版本采用 _TYPE_ALIASES 字典精确映射。
同一 Bot 另指出：布尔转换有意缩减了支持的字符串，原实现支持 yes/on/no/off，新实现仅保留 true/1/false/0。作者回复查阅 MiniMax 官方指南后确认只支持后一组，故此为有意对齐而非回归。

• 类型归一化使用 startswith 过于宽泛 (design): 作者已修复，最终版本采用 _TYPE_ALIASES 字典精确映射。
• 布尔转换支持范围缩小 (correctness): 作者查阅 MiniMax 官方指南后确认仅支持 true/1/false/0，因此保持现状，未添加。

风险与影响

• 风险：低风险。变更只影响 Minimax M2 解析器内部实现，公共 API 无变化，且新增测试覆盖全部转换路径。需注意：若其他解析器未来迁移至此共享函数，布尔值范围可能因官方限制而缩小，但当前迁移过程可控。
• 影响：影响范围局限于 Minimax M2 解析器的内部实现，对外接口及服务行为完全不变。系统层面显著减少重复代码，提高可维护性。团队层面为后续统一工具调用类型处理奠定了可复用基础。
• 风险标记：布尔值范围有意识缩小, 其他解析器未迁移

关联脉络

• 暂无明显关联 PR