三种模式:Build / Plan / Auto
输入框左侧的模式按钮点击循环切换:BUILD → PLAN → AUTO → BUILD。三种模式的区别是 AI 的权限范围。
BUILD(构建模式)
默认模式,功能完整。AI 可以写文件、改代码、执行构建命令,但每次需要授权的操作都会弹窗询问。
日常开发建议使用此模式。被内置安全防护拦下的高危命令(如 rm 根目录),AI 可带 elevate: true 重试,转由你一次性授权(见工具授权)。
PLAN(计划模式)
进入这个模式后,工具权限策略会拦截编辑文件、执行命令等实施操作。AI 可以使用允许的只读工具及相应动作,读取代码、检索资料、回答问题并构思方案。
适合这些场景:
- 你还不确定怎么改,想先让 AI 探索代码库、给出方案。
- 改动涉及重要架构取舍、影响面不明或风险较高,想先看计划再决定。
- 你只想问问题、了解现有实现,不希望它动手。
AI 会按风险与不确定性判断是否需要先规划;目标明确、风险可控或方案已获批准时,可以直接推进。纯问答与方案讨论可保持 PLAN,需要开始实施时再申请退出并等待审批。
AUTO(自动模式)
普通工具调用(写文件、执行命令、终端操作)自动批准,AI 可在当前任务范围内连续执行。难以撤销、影响共享状态或超出当前任务范围的操作,仍需取得针对该操作的明确授权,例如强推、修改远端、发消息、提/合 PR。
这个模式权限极大
灾难性删除(如 rm 根目录或系统目录)以及无法静态判定的疑似破坏性命令仍会被拦截;确有必要时,AI 可申请一次性授权后重试。Shizuku 宿主 Android 操作仍会逐次确认,其余普通工具调用自动批准。可在「设置 → 工具授权」中开启「禁用安全拦截」取消这些兜底确认。适合你已清楚了解风险、希望 AI 全自动执行批量任务的场景。不熟悉的项目或不确定 AI 会执行什么操作时,不建议使用。
AI 也可主动请求切换
除了你手动点按钮,AI 也可以主动请求进入或退出 PLAN 模式。准备实施时,AI 会先在回复中展示计划,再在同一轮回复中发起退出申请;你在计划审查面板批准后,才会恢复进入 PLAN 前的模式并开始实施。计划正文用于审查修改范围和验证安排,申请理由只是简要概括。
有一个方向上的限制:AUTO 模式只能由你手动进入,AI 无法通过工具切进 AUTO。但反过来,处于 AUTO 模式时 AI 可以主动切到 PLAN——这是 AI 退出 AUTO 的唯一路径。
退出 PLAN 会回到进入前的模式
PLAN 是临时状态:进入 PLAN 时会记下当时的模式,退出时自动恢复。从 AUTO 进入 PLAN,计划做完退出后回到 AUTO;从 BUILD 进入 PLAN,退出后回到 BUILD。不会再一律落回 BUILD。
注意:退出 PLAN 仍需你在计划审查面板上批准(点「批准并实施」),批准后模式才真正恢复。进入或退出成功后,工具结果会直接显示当前模式及对应说明。
运行中也能切换
AI 收到的运行模式提醒由应用自动附加,用于说明当前权限,不属于你的消息内容,也不代表你新增了任务或授权。提醒带有明确的开始和结束标记,便于与原始请求区分。
模式按钮在 AI 正在执行任务时同样可用。你在 AI 执行任务的过程中切换模式,它会当轮立即生效:AI 会收到一条模式切换通知,手头任务从那一刻起按新模式处理(例如你中途切到 AUTO,后续操作就不再逐次弹窗;切到 PLAN,后续写操作会被拦截),无需等待本轮结束。