模型路由与回退

区分模型选择、可用性回退、Plan 路由以及本地 Gemma 路由器。

This page has not been translated into English yet. The original Chinese version is shown below.

选择模型与每一次实际调用的模型可能不同：可用性回退、内部辅助调用、Plan Mode 路由和 subagent 设置各有作用范围。

选择优先级

官方路由页列出顺序：--model，其次 GEMINI_MODEL，再到 settings.json 的 model.name；之后考虑启用的实验性本地路由器，未指定时使用 auto。这个顺序用于主请求的选择，不能理解为覆盖所有子任务模型。

交互 /model 提供 Auto (Gemini 3)、Auto (Gemini 2.5) 和 Manual；实际模型以当前版本与账号可选项为准。/model 和 --model 不覆盖 subagents，因此用量报告出现别的模型不一定是选择失效。

可用性回退

模型额度或服务出错时，ModelAvailabilityService 按策略选择可用回退。默认主调用会询问用户，也存在策略允许的静默路径，不能承诺每次都弹确认。

内部补全或分类调用的官方示例从 gemini-2.5-flash-lite 静默回退至 gemini-2.5-flash、gemini-2.5-pro，不修改配置中的主模型。排障时区分主会话与辅助请求。

Plan 自动切换

auto 模型在计划阶段使用 Pro，实现已批准计划时使用 Flash；高推理模型不可用可静默回退。此行为默认开启，关闭配置为：

{
  "general": {
    "plan": {
      "modelRouting": false
    }
  }
}

本地路由器

实验性 Local Model Routing 用本地 Gemma 作路由决定，官方入口为 gemini gemma setup。这是选择请求去向的路由能力，不等于后续所有 Gemini 推理、工具或数据处理都变成离线运行。可用自动安装与状态检查准备分类器，受限环境按手动路由设置连接本地 HTTP 服务。