执行摘要

此 PR 增强了 Kimi-K2/K2.5 模型的函数调用和推理检测能力，主要修复了推理块内工具调用标记泄漏的 bug 并支持连字符函数名，通过新增检测器类、重构解析逻辑和全面测试确保防御性和兼容性，对依赖工具调用的用户场景有直接积极影响。

功能与动机

动机源于 Issue #18086：Kimi-K2.5 模型在 <think> 推理块内直接输出 <|tool_calls_section_begin|> 而不先关闭 </think>，导致推理解析器误吸收工具调用内容，使特殊令牌泄漏为纯文本响应。这尤其影响使用 coding agents（如 Claude Code）的用户，因此需要防御性修复以提升可靠性。

实现拆解

实现按模块拆解如下：

• 函数调用检测器 (kimik2_detector.py)：
  • 添加 _KIMI_K2_SPECIAL_TOKENS 常量列表和 _strip_special_tokens() 工具函数，统一过滤特殊令牌。
  • 更新正则表达式（如 tool_call_regex）支持连字符函数名（示例：mcp__portal__search-documents）。
  • 修复流式解析中 _last_arguments 累积错误，并改进异常处理防止令牌泄漏。
• 推理检测器 (reasoning_parser.py，未在文件列表中但通过 commit 提及)：
  • 新增 KimiK2ReasoningDetector 类，继承自 Qwen3Detector，通过设置 tool_start_token 重用 PR #17714 的通用机制，检测到工具调用标记时强制退出推理模式。
  • 覆盖 parse_streaming_increment() 处理部分标记缓冲，避免流式输出碎片。
• 测试覆盖 (test_kimik2_detector.py)：
  • 新增 29 个测试用例，覆盖非流式/流式解析、连字符支持、推理检测和端到端管道，确保变更稳健性。

评论区精华

Issue 评论中的关键讨论聚焦于设计重用：

Leoyzen: "How about reusing the in-reasoning tool detection mechanism introduced in #17714? Both PRs address the same root issue..."

这促使作者 rebase 并简化实现，采纳通用 tool_start_token 机制，避免了代码重复并提升一致性。此外，讨论涉及 CI lint 修复和合并协调，体现了团队协作。

风险与影响

• 技术风险：解析逻辑变更可能引入边缘 case 错误，但通过 29 个测试用例和现场验证（TP=16 部署）显著降低；正则表达式更新对性能影响微乎其微。
• 影响评估：
  • 用户：修复了工具调用泄漏 bug，提升 Kimi-K2.5 模型在编码代理等场景的可靠性，变更具防御性不影响正常路径。
  • 系统：新增检测器类增加代码复杂度，但模块化改进增强解析一致性；测试覆盖为后续修改提供保障。
  • 团队：提供了设计重用范例，促进代码库维护和知识共享。

关联脉络

• 与 PR #17714 直接关联：该 PR 引入了通用 tool_start_token 机制，本 PR 重用此机制简化 KimiK2ReasoningDetector，体现了解析组件的演进方向——通过抽象降低重复代码。
• 在同仓库近期历史 PR 中，如 #21258（恢复 repetition_penalty 功能）和 #21671（添加 GLM-V interleave 支持），可见对模型特定行为增强的持续投入，本 PR 是 Kimi 模型系列工具调用解析的重要补强。