执行摘要

本次 PR 在 Rust 前端的 roundtrip 测试中引入 ThinkingBehavior 枚举，为每个模型 fixture 描述其聊天模板对思考模式的支持方式，并据此生成显式启用、显式禁用（若支持）和不指定三种输入场景，从而覆盖推理解析器的全部初始状态。这是一项纯测试质量提升，不涉及生产代码变更。

功能与动机

此前 roundtrip 测试对所有模型 fixture 使用统一的 thinking 模式，未考虑不同模型的聊天模板对 thinking kwarg 的支持差异。PR 明确指出需要 "cover all different initial states of the reasoning parser"，包括显式启用、显式禁用以及基于模板默认的不指定行为，以防止漏测。

实现拆解

1. 新增 ThinkingBehavior 枚举（rust/src/chat/tests/roundtrip.rs）
   - Toggleable { default: bool }：模板支持通过布尔参数开启/关闭思考，default 记录模板默认值。
   - Always { value: bool }：模板不支持切换，始终按固定值行为运作（如 MiniMax M2.5）。
   - 提供 default() 方法获取默认开启状态，fixtures() 方法生成待测输入列表。

2. 为每个 RoundtripCase fixture 添加 thinking_behavior 字段
   - Qwen3、Qwen3.5、DeepSeek V4、GLM-4.7 使用 Toggleable，default 值根据模板实际行为设置（如 Qwen3 默认启用，DeepSeek V4 默认禁用）。
   - MiniMax M2.5 使用 Always { value: true }，因其模板不支持禁用思考。

3. 修改测试逻辑
   遍历 fixtures() 返回的所有 Option<bool>，对每个输入调用 run_roundtrip_reasoning_and_content_inner 执行 roundtrip 断言，确保三种场景均被覆盖。

4. 仅修改单测试文件
   所有变更局限在 rust/src/chat/tests/roundtrip.rs，增加 75 行、删除 21 行，不涉及生产代码、配置或 CI。

rust/src/chat/tests/roundtrip.rs

唯一变更文件，新增 ThinkingBehavior 枚举并集成到测试 fixture 中，是 PR 核心实现。

/// 枚举描述模型聊天模板对 thinking 模式的支持方式
#[derive(Clone, Copy)]
enum ThinkingBehavior {
    /// 模板支持通过布尔 kwarg 显式开启/关闭思考，并提供默认值
    Toggleable { default: bool },
    /// 模板始终按固定值行为运作（如 MiniMax 不支持禁用思考）
    Always { value: bool },
}
​
impl ThinkingBehavior {
    /// 返回当前配置下，当请求不指定 thinking 时模板的默认行为
    fn default(self) -> bool {
        match self {
            Self::Toggleable { default } => default,
            Self::Always { value } => value,
        }
    }
​
    /// 生成所有需要测试的 thinking 输入场景
    fn fixtures(self) -> Vec<Option<bool>> {
        match self {
            Self::Toggleable { .. } => vec![
                Some(true), // 显式启用思考
                Some(false), // 显式禁用思考
                None, // 不指定，使用模板默认
            ],
            Self::Always { value } => vec![
                Some(value), // 显式请求唯一支持的 behavior
                None, // 不指定，使用模板默认
            ],
        }
    }
}
​
// 在 RoundtripCase 结构体中使用新字段
struct RoundtripCase {
    // ... 其他字段
    thinking_behavior: ThinkingBehavior,
    json_fmt: JsonFmt,
}

评论区精华

该 PR 无 review 评论，由 njhill 直接批准。设计本身已有充分考量：对于不支持禁用思考的模板使用 Always 变体避免生成无效输入；Toggleable 通过 default 字段准确反映模板真实行为，确保测试与生产一致。

风险与影响

• 风险：仅测试文件变更，无生产代码修改，回归风险极低。新增 thinking_behavior 字段为必需项，未来新增 fixture 时若遗忘设置，编译错误会立即提示，反而降低了漏设风险。
• 影响：
  • roundtrip 测试覆盖率提升，推理解析器的所有初始状态分支均被覆盖。
  • 可维护性提升，模型间 thinking 行为差异被显式建模。
  • 对用户、系统性能无任何影响。

关联脉络

• 与 PR #42977（Parser 接口统一）同属推理/思考解析器功能线的测试质量提升。
• 与 PR #43883（Rust 前端 request-id 标志）共同反映团队对 Rust 前端测试基础设施的持续投入，强化了 roundtrip 测试作为质量门禁的作用。