> ## Documentation Index
> Fetch the complete documentation index at: https://unity.farlocus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 计划模式

> 先产出实现方案，批准后再开始改动

计划模式（Plan mode）让 Agent 在只读状态下调研项目并产出实现方案，方案经你批准后才开始实际改动。

## 什么时候用

许多表面简单的游戏逻辑实现起来非常复杂，直接下达一句话指令，Agent 倾向于以最快速度满足表面需求，结果容易偏离预期。对于复杂需求，更推荐先让 Agent 输出实现方案，通过对话确认需求、边界条件和关键设计，再进入编码阶段。这一工作方式的完整讨论见[使用建议](/overview/usage-guidance)中「复杂任务应先产出方案并完成 Review」一节。

适合计划模式的典型场景：

* 涉及多个系统的功能开发，例如新的玩法模块、自定义渲染管线。
* 对既有架构的调整，需要先确认影响范围。
* 你自己尚未想清楚技术路线，希望先看几种可选方案。

## 进入与退出

在输入框输入 `/plan` 并描述任务即可进入（仅 Dev 会话可用）。进入后对话区顶部会出现粘性横幅：`规划模式（只读）— 计划批准后才会开始改动`，随时可点击横幅上的`退出规划`手动退出。

「设置 → 默认模型」中可为计划模式单独指定`Plan 模式模型`，进入计划模式时自动切换，例如用推理更强的模型做方案、用更快的模型做执行。

## 只读状态的含义

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

## 计划文件的写入范围

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

## 计划审批

方案成形后，对话区会弹出`计划待批准`卡片，展示完整计划内容：

* **`批准并开始实现`**：退出规划模式并立即开始实现。
* **`继续规划`**：拒绝当前方案，可附带反馈说明需要调整的方向，Agent 会继续完善计划后再次提交。

批准后进入正常执行阶段，工具调用回到[执行权限](/sessions/permissions)所配置的审批规则之下，文件改动照常被记录，可随时[查看与撤回](/sessions/changes-and-undo)。