执行摘要

• 一句话：auto 检测推理/工具调用解析器
• 推荐动作：值得精读，特别是 template_detection.py 的规则引擎设计可作为类似场景的参考。关注 thinks_internally 和 reasoning_default 如何与 _get_reasoning_from_request 集成，消除 if/elif 是良好的重构模式。

功能与动机

用户无需记忆每个模型对应的 parser 名称，通过 auto 即可自动解析。PR 描述：'...so users no longer have to remember which parser name goes with each model family.'

实现拆解

1. 创建规则引擎：新增 template_detection.py，定义 TemplateDetectionContext、DetectionRule、ReasoningToggleConfig 等数据类，以及 REASONING_MODE_RULES、REASONING_PARSER_RULES、TOOL_CALL_PARSER_RULES 规则元组，通过 match_rules 和 detect_reasoning_pattern 等函数实现基于模板和词汇表的规则匹配。
2. 集成到 TemplateManager：修改 template_manager.py，添加 reasoning_config、suggested_reasoning_parser、suggested_tool_call_parser 属性和 _run_template_detection 方法，在 load_chat_template 流程中调用检测。
3. 启动时自动替换：在 engine.py 的 init_tokenizer_manager 中，如果用户指定 auto，则使用 template_manager.suggested_* 替换参数，若未识别则记录警告并禁用。
4. 增强推理检测器基类：在 reasoning_parser.py 的 BaseReasoningFormatDetector 中添加 thinks_internally 和 reasoning_default 属性。为 Qwen3、KimiK2、GLM-4.5、InternS1、Mistral、Gemma4 等子类设置合理默认值。新增 _DeepSeekV3Detector 和 _MimoDetector 子类覆盖默认值。
5. 重写请求推理判断：修改 serving_chat.py 的 _get_reasoning_from_request，基于 template_manager.reasoning_config（含 toggle_param、default_enabled、special_case）和 self._reasoning_detector 的 reasoning_default 属性驱动，删除整个 if/elif 链。利用 thinks_internally 控制是否在提示前添加 <think> 前缀。
6. 配置与测试：更新 server_args.py 使 auto 成为合法值。新增 test_template_manager.py（334 行，单元测试规则）和扩展 test_serving_chat.py（172 行，测试推理配置逻辑）。

关键文件：

• python/sglang/srt/managers/template_detection.py（模块 检测器；类别 source；类型 core-logic；符号 TemplateDetectionContext, DetectionRule, ReasoningToggleConfig, detect_reasoning_pattern）: 核心检测逻辑，定义规则引擎和所有检测函数。
• python/sglang/srt/managers/template_manager.py（模块 模板管理；类别 source；类型 core-logic；符号 _run_template_detection, reasoning_config, suggested_reasoning_parser, suggested_tool_call_parser）: 集成检测结果到模板管理器，暴露新属性。
• python/sglang/srt/parser/reasoning_parser.py（模块 推理解析；类别 source；类型 core-logic；符号 BaseReasoningFormatDetector.init, Qwen3Detector.init, KimiK2Detector.init, Glm45Detector.init）: 增强检测器基类，添加 thinks_internally/reasoning_default 属性及新子类。
• python/sglang/srt/entrypoints/openai/serving_chat.py（模块 OpenAI 服务；类别 source；类型 core-logic；符号 _get_reasoning_from_request, _apply_conversation_template）: 重写 _get_reasoning_from_request 使用新设计，消除硬编码分支。
• python/sglang/srt/entrypoints/engine.py（模块 引擎；类别 source；类型 dependency-wiring；符号 init_tokenizer_manager）: 在初始化 tokenizer 时替换 auto 参数为检测到的值。
• python/sglang/srt/server_args.py（模块 启动配置；类别 source；类型 configuration）: 将 auto 添加为合法值。
• test/registered/unit/managers/test_template_manager.py（模块 模板检测测试；类别 test；类型 test-coverage；符号 TestTemplateManagerReasoningDetection, TestTemplateDetectionRuleMatrix, _detect）: 新增测试覆盖检测逻辑和各种模板变体。
• test/registered/unit/entrypoints/openai/test_serving_chat.py（模块 服务测试；类别 test；类型 test-coverage；符号 test_get_reasoning_from_request_default_true_toggle, test_get_reasoning_from_request_default_false_toggle, test_get_reasoning_from_request_special_cases, _setup_fallback）: 扩展测试验证新的 reasoning_config 行为。
• .codespellrc（类别 other；类型 other）: 添加违禁词忽略，无实际影响。

关键符号：detect_reasoning_pattern, detect_reasoning_parser, detect_tool_call_parser, match_rules, _run_template_detection, build_detection_context, _get_reasoning_from_request, _apply_conversation_template

评论区精华

在 template_detection.py 第 77 行的 force_reasoning_pattern 正则表达式中，gemini-code-assist[bot] 指出双反斜杠 \\n 可能无法匹配实际换行符，建议改为 \n 或 \s+。PR 作者未做出响应，该模式保留。实际上，由于 Python 原始字符串的特性，\\n 在正则引擎中会被解释为 \n（换行符），因此该评论可能是对原始字符串用法的误解。该模式的正确性不影响主要功能，因为大多数模板中换行符也表示换行。目前该问题未经修改即已合并。

• 正则表达式双反斜杠可能无法匹配换行符 (correctness): 未修改，实际中由于原始字符串与正则引擎转义机制协作，可能仍工作正常。

风险与影响

• 风险：
  1. 规则误判风险：检测规则可能不覆盖所有模型变体，导致 auto 返回错误解析器或无法识别，用户需手动指定。
  2. 正则表达式歧义：部分规则使用复杂模式，可能在 edge case 下误匹配/漏匹配。
  3. 启动延迟：启动时执行一次检测，对大型词汇表可能产生额外延迟，但通常可忽略。
  4. 向后兼容：auto 是新参数，旧参数继续有效。reasoning_config 改变请求推理判断逻辑，但通过回退路径维持与旧行为兼容。
  5. 影响范围：所有使用推理或工具调用功能的服务均受影响，但仅在用户指定 auto 时启用检测，默认行为不变。
     - 影响：对用户：主要受益，无需记忆 parser 名称。对系统：启动时增加一次检测，影响很小。对团队：需要持续维护规则集以支持新模型。兼容性：向后兼容，auto 是新参数，旧参数继续有效。
     - 风险标记：规则覆盖风险, 正则表达式歧义, 启动延迟

关联脉络

• PR #22254 feat(reasoning): two-phase reasoning grammar + --enable-strict-thinking: 本 PR 从 #22254 拆分而来，独立于约束解码部分。