跳转到主要内容
计划模式(Plan mode)让 Agent 在只读状态下调研项目并产出实现方案,方案经你批准后才开始实际改动。

什么时候用

许多表面简单的游戏逻辑实现起来非常复杂,直接下达一句话指令,Agent 倾向于以最快速度满足表面需求,结果容易偏离预期。对于复杂需求,更推荐先让 Agent 输出实现方案,通过对话确认需求、边界条件和关键设计,再进入编码阶段。这一工作方式的完整讨论见使用建议中「复杂任务应先产出方案并完成 Review」一节。 适合计划模式的典型场景:
  • 涉及多个系统的功能开发,例如新的玩法模块、自定义渲染管线。
  • 对既有架构的调整,需要先确认影响范围。
  • 你自己尚未想清楚技术路线,希望先看几种可选方案。

进入与退出

在输入框输入 /plan 并描述任务即可进入(仅 Dev 会话可用)。进入后对话区顶部会出现粘性横幅:规划模式(只读)— 计划批准后才会开始改动,随时可点击横幅上的退出规划手动退出。 「设置 → 默认模型」中可为计划模式单独指定Plan 模式模型,进入计划模式时自动切换,例如用推理更强的模型做方案、用更快的模型做执行。

只读状态的含义

计划模式下 Agent 可以读文件、搜索代码与资产、查询知识库、抓取网页文档,也可以派生子代理做调研(子代理同样被限制为只读)。所有修改类工具被拦截:写文件、执行命令、操作 Unity 都不可用。唯一的例外是计划文件本身,Agent 会把方案写入其中并持续完善。

计划文件的写入范围

计划内容写入 Locus 本地数据目录下按项目和会话划分的 Markdown 文件,不会写进你的项目目录。规划过程不会在工作区产生任何文件改动,也不会污染版本管理状态。

计划审批

方案成形后,对话区会弹出计划待批准卡片,展示完整计划内容:
  • 批准并开始实现:退出规划模式并立即开始实现。
  • 继续规划:拒绝当前方案,可附带反馈说明需要调整的方向,Agent 会继续完善计划后再次提交。
批准后进入正常执行阶段,工具调用回到执行权限所配置的审批规则之下,文件改动照常被记录,可随时查看与撤回