Skip to content

Model Steering(模型引导)是 Gemini CLI 的实验性功能,允许在代理运行期间(转圈时)直接在输入框输入指导文字并按 Enter,代理会在下一轮立即吸收并调整执行方向——无需停止任务再重新描述。适合在长时间 Plan Mode 或子代理执行中即时纠偏。

Model Steering(模型实时引导,实验性)

实验性功能:默认禁用,需手动开启。

Model Steering 让你在代理执行任务的过程中,随时提供实时指导,而无需中断任务重新开始。

启用方法

/settings 中搜索 Model Steering 设为 true,或直接编辑 settings.json

json
{
  "experimental": {
    "modelSteering": true
  }
}

使用方式

  1. 启动一个任务(如"重构数据库服务模块")
  2. 代理开始工作(界面显示转圈状态)
  3. 在输入框输入你的指导文字,按 Enter

Gemini CLI 会立即显示一条确认消息,然后在代理的下一轮将指导内容注入上下文,代理重新评估当前计划并调整行为。

典型用途

场景示例指导文字
纠正路径错误"工具类在 src/common/utils,不在 src/helpers"
跳过某个步骤"暂时不用写单元测试,先把实现跑通"
补充上下文"User 类型定义在 packages/core/types.ts"
重新定向"停止搜索代码库,直接开始写计划"
消除歧义"用现有的 Logger 类,不要新建"

工作原理

提交引导文字后,Gemini CLI 执行:

  1. 立即确认:用小型快速模型生成一句确认话语,让你知道已收到
  2. 注入上下文:在指导文字前加入内部指令,告诉主代理重新评估当前计划,分类这次更新(是新任务?还是补充信息?),并最小化对任务进度的干扰
  3. 下一轮生效:指导内容在代理的下一轮开始时生效,确保最快速的方向修正

适用场景

Model Steering 在以下情况特别有用:

  • 复杂的 Plan Mode 执行中途发现方向偏差
  • 子代理(尤其是通才代理)执行长时间任务时
  • 不想打断任务,但需要补充 AI 遗漏的重要上下文

常见问题

Q: 引导文字会被当成新的用户 Prompt 吗?

A: 不会。引导文字通过内部机制注入,被标记为"即时方向修正",不会开启新一轮对话,也不会打断代理当前正在执行的步骤。

Q: 和 /rewind 有什么区别?

A: Model Steering 是前向修正——在任务继续执行的同时调整方向;/rewind 是后向回退——撤销已经发生的操作和对话历史。两者互补。

Q: 这个功能稳定吗?

A: 实验性功能,可能存在 Bug。如果遇到问题,可以用 /bug 命令反馈,或在 GitHub Issues 中提报。