执行摘要

• 一句话：新增 Phi-4 mini JSON 工具解析器（Rust 前端）
• 推荐动作：建议快速阅读以了解 Rust 前端添加新解析器的标准化流程（配置常量、结构体、注册、测试）。关于 whitespace 差异的设计决策（是否对齐 Python 行为）值得关注，体现了务实的技术权衡。

功能与动机

Phi-4 mini 模型以 functools[...] 格式输出工具调用请求，现有解析器无法处理。此 PR 在 Rust 前端填补这一空白，使 vLLM 能够正确解析并流式输出其工具调用。

实现拆解

1. 在 rust/src/tool-parser/src/json/ 下新建 phi4mini.rs，定义 Phi4MiniJsonToolParser 结构体，通过常量 PHI4MINI_CONFIG 配置解析器（起始标记 functools[、结束标记 ]、参数键兼容 arguments 和 parameters），并实现 ToolParser trait 的 create、parse_into、finish、reset 方法，实际委托给共享的 JsonToolCallParser。
2. 在 rust/src/tool-parser/src/json/mod.rs 中导出 Phi4MiniJsonToolParser 并注册子模块。
3. 在 rust/src/tool-parser/src/lib.rs 的公共导出中添加 Phi4MiniJsonToolParser。
4. 在 rust/src/chat/src/parser/tool/mod.rs 中导入 Phi4MiniJsonToolParser，新增名称常量 PHI4_MINI_JSON: &str = "phi4_mini_json"，并在 ToolParserFactory::new() 的注册链中添加 .register_parser::<Phi4MiniJsonToolParser>(names::PHI4_MINI_JSON)；注意不绑定任何模型名称模式，仅支持显式指定。
5. 在 rust/src/chat/src/parser/tool/tests.rs 中添加测试 factory_new_registers_phi4_mini_json_by_name，验证通过名称可创建解析器。
6. 在 rust/src/chat/src/lib.rs 的 validate_parser_overrides_rejects_unknown_tool_parser 测试中更新错误信息字符串，包含新解析器名称。

关键文件：

• rust/src/tool-parser/src/json/phi4mini.rs（模块 工具解析器；类别 source；类型 core-logic；符号 Phi4MiniJsonToolParser, new, create, parse_into）: 核心新增文件，实现 Phi4MiniJsonToolParser 结构体、ToolParser trait 全部方法及完整测试套。
• rust/src/chat/src/parser/tool/mod.rs（模块 Chat 模块；类别 source；类型 core-logic；符号 PHI4_MINI_JSON, Phi4MiniJsonToolParser）: 注册 phi4_mini_json 解析器到工厂，导出类型和名称常量。
• rust/src/chat/src/parser/tool/tests.rs（模块 Chat 模块；类别 source；类型 test-coverage；符号 factory_new_registers_phi4_mini_json_by_name）: 新增测试验证工厂通过名称可创建 phi4_mini_json 解析器。
• rust/src/chat/src/lib.rs（模块 Chat 模块；类别 source；类型 configuration）: 更新错误信息字符串以包含新解析器名称。
• rust/src/tool-parser/src/json/mod.rs（模块 工具解析器；类别 source；类型 configuration；符号 Phi4MiniJsonToolParser）: 导出 phi4mini 子模块及其结构体。
• rust/src/tool-parser/src/lib.rs（模块 工具解析器；类别 source；类型 configuration；符号 Phi4MiniJsonToolParser）: 将 Phi4MiniJsonToolParser 加入 crate 公共导出。

关键符号：Phi4MiniJsonToolParser::new, Phi4MiniJsonToolParser::create, ToolParser::parse_into, ToolParser::finish, ToolParser::reset

评论区精华

主要讨论围绕 Codex 自动检测的 P2 问题：当 Phi-4 输出 pretty-printed 格式（参数对象后含换行及空格）时，现有 JsonToolCallParser 的关闭解析器要求立即跟 }，导致解析失败。BugenZhao 认为该差异是 Python 端的偶然行为，而非 Rust 端问题，因此决定移除文档中关于 Python 差异的对比注释。此外，BugenZhao 指出 DCO 签名问题，作者 devin-lai 随后修复。最终 BugenZhao 批准合并。

• 解析器与 Python 端行为差异的讨论 (design): 移除注释和文档中关于 Python 差异的说明。
• DCO 签章修复 (other): 已修复。

风险与影响

• 风险：核心逻辑依赖 JsonToolCallParser 的共享实现，若未来该组件行为变更（例如 whitespace 处理），可能影响本解析器。与 Python 端解析器的隐式差异（如尾随空格处理）未通过自动化测试覆盖，需额外质量保障。新增代码独立性强，未改动现有解析器路径，回归风险低。
• 影响：用户侧：提供 phi4_mini_json 工具解析器选项，支持 Phi-4 mini 模型正确解析工具调用。系统侧：Rust 前端模块扩展，无性能或兼容性影响。团队侧：为后续模型解析器提供了清晰的实现模板，延续了按名注册的设计模式。
• 风险标记：新解析器模块依赖共享核心, Python 端行为对齐需持续验证

关联脉络

• 暂无明显关联 PR