Appearance
Model Steering(模型引导)是 Gemini CLI 的实验性功能,允许在代理运行期间(转圈时)直接在输入框输入指导文字并按 Enter,代理会在下一轮立即吸收并调整执行方向——无需停止任务再重新描述。适合在长时间 Plan Mode 或子代理执行中即时纠偏。
Model Steering(模型实时引导,实验性)
实验性功能:默认禁用,需手动开启。
Model Steering 让你在代理执行任务的过程中,随时提供实时指导,而无需中断任务重新开始。
启用方法
在 /settings 中搜索 Model Steering 设为 true,或直接编辑 settings.json:
json
{
"experimental": {
"modelSteering": true
}
}使用方式
- 启动一个任务(如"重构数据库服务模块")
- 代理开始工作(界面显示转圈状态)
- 在输入框输入你的指导文字,按 Enter
Gemini CLI 会立即显示一条确认消息,然后在代理的下一轮将指导内容注入上下文,代理重新评估当前计划并调整行为。
典型用途
| 场景 | 示例指导文字 |
|---|---|
| 纠正路径错误 | "工具类在 src/common/utils,不在 src/helpers" |
| 跳过某个步骤 | "暂时不用写单元测试,先把实现跑通" |
| 补充上下文 | "User 类型定义在 packages/core/types.ts" |
| 重新定向 | "停止搜索代码库,直接开始写计划" |
| 消除歧义 | "用现有的 Logger 类,不要新建" |
工作原理
提交引导文字后,Gemini CLI 执行:
- 立即确认:用小型快速模型生成一句确认话语,让你知道已收到
- 注入上下文:在指导文字前加入内部指令,告诉主代理重新评估当前计划,分类这次更新(是新任务?还是补充信息?),并最小化对任务进度的干扰
- 下一轮生效:指导内容在代理的下一轮开始时生效,确保最快速的方向修正
适用场景
Model Steering 在以下情况特别有用:
常见问题
Q: 引导文字会被当成新的用户 Prompt 吗?
A: 不会。引导文字通过内部机制注入,被标记为"即时方向修正",不会开启新一轮对话,也不会打断代理当前正在执行的步骤。
Q: 和 /rewind 有什么区别?
A: Model Steering 是前向修正——在任务继续执行的同时调整方向;/rewind 是后向回退——撤销已经发生的操作和对话历史。两者互补。
Q: 这个功能稳定吗?
A: 实验性功能,可能存在 Bug。如果遇到问题,可以用 /bug 命令反馈,或在 GitHub Issues 中提报。