模型条件覆盖

modelConfigs.overrides 是按每次模型请求上下文匹配的规则列表。它在别名解析后叠加配置，适合只对某个代理降低 temperature，或只为某类请求调整思考预算。

按代理范围覆盖

{
  "modelConfigs": {
    "overrides": [
      {
        "match": {
          "overrideScope": "codebaseInvestigator"
        },
        "modelConfig": {
          "generateContentConfig": {
            "temperature": 0.1
          }
        }
      }
    ]
  }
}

overrideScope 匹配请求携带的范围，通常是代理名。这里采用官方的 codebaseInvestigator 示例；任意自定义标签不会自行创建对应请求范围。

按模型与范围共同匹配

match.model 匹配请求的模型名或别名。可以同时指定 model 与 overrideScope，使覆盖针对更具体的一组请求。

{
  "modelConfigs": {
    "overrides": [
      {
        "match": {
          "model": "gemini-2.5-pro"
        },
        "modelConfig": {
          "generateContentConfig": { "temperature": 0.3 }
        }
      },
      {
        "match": {
          "model": "gemini-2.5-pro",
          "overrideScope": "codebaseInvestigator"
        },
        "modelConfig": {
          "generateContentConfig": { "temperature": 0.1 }
        }
      }
    ]
  }
}

示例名称用于说明匹配规则，不保证该模型在每个账号可用。两个条件同时匹配的请求会获得更具体的 temperature；只匹配第一条的请求采用较宽范围设置。

合并顺序

1. 解析系统与用户别名，并展开继承链，得到基础配置。
2. 找出所有匹配当前请求的 overrides。
3. 按 match 中匹配键的数量排序，先宽泛、后具体。
4. 相同特异性保留数组顺序，后定义的规则覆盖前面的冲突字段。
5. 依次将结果合并到基础配置。

这不是“只执行第一条命中规则”。排查值不符合预期时，检查所有匹配项及别名继承，尤其是后面的同级规则。

思考预算与模型替换

modelConfig.generateContentConfig.thinkingConfig 可以设置所选模型支持的思考参数；官方示例为 codebaseInvestigator 设置 thinkingBudget: 4096，这是示例值而非默认值。

覆盖还可以修改 modelConfig.model，把某个请求名映射到另一个实际模型。目标模型应来自当前可用清单，不直接将文档中的实验性占位模型名当成稳定发布名称。与主会话模型选择和路由回退一起核对，避免把范围覆盖误认为全局切换。