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

# 计划模式

> 让专家先规划再执行

计划模式是一种「先想清楚、再动手做」的对话方式。激活后，专家会先制定一份结构化的计划文档，和你反复讨论确认后再开始执行——而不是直接上手干活。

## 为什么需要计划模式

在以下场景中，先规划再执行能显著提升交付质量：

<CardGroup cols={2}>
  <Card title="复杂任务" icon="sitemap">
    多步骤、跨模块的任务，比如「重构整个支付系统」、「搭建一个完整的博客网站」
  </Card>

  <Card title="架构决策" icon="compass-drafting">
    涉及技术选型或架构权衡时，比如「给应用添加缓存层」「设计数据库表结构」
  </Card>

  <Card title="多方案对比" icon="scale-balanced">
    有多条可行路径时，让专家逐一分析利弊后再选择最优方案
  </Card>

  <Card title="风险管控" icon="shield-halved">
    对不可逆操作（数据迁移、环境变更等）先列明风险点和回滚策略
  </Card>
</CardGroup>

## 如何使用

<Steps>
  <Step title="激活计划模式">
    在输入框点击 "+" 菜单，打开「计划模式」开关。输入框会出现标识提示你当前处于计划模式。
  </Step>

  <Step title="描述你的需求">
    像平常一样向专家描述你想完成的任务。专家会先调研（读取代码、搜索资料等），然后生成一份计划文档。
  </Step>

  <Step title="审阅计划">
    计划文档会以卡片形式展示在对话中，通常包含以下内容：

    * **现状**：当前项目的状态和你的需求
    * **方案**：选定的技术方案及替代方案对比
    * **风险**：潜在风险点和对应的缓解措施
    * **拆解**：具体的执行步骤，每一步都标明涉及的文件和操作
  </Step>

  <Step title="迭代修改">
    对计划不满意？直接告诉专家你的修改意见。比如：

    * 「第三步改用另一种实现方式」
    * 「再加一个回滚方案」
    * 「把这两步合并成一步」

    专家会根据你的反馈更新计划文档。
  </Step>

  <Step title="确认执行">
    对计划满意后，点击计划卡片上的「Build」按钮。专家会退出计划模式，开始按照计划逐步执行。
  </Step>
</Steps>

## 计划模式的约束

计划模式下，专家的行为被严格限制，确保不会产生任何副作用：

<Warning>
  在计划模式中，专家 **无法**执行以下操作：

  * 创建、修改或删除文件
  * 运行命令行指令
  * 生成图片或视频
  * 部署或发布内容

  专家只能进行**只读调研**（读取代码、搜索资料）和**编写计划文档**。
</Warning>

这意味着你可以放心地让专家在计划模式下自由探索——它不会对你的项目做出任何实际更改。

## 常见问题

<AccordionGroup>
  <Accordion title="计划模式和直接下指令有什么区别？">
    直接对话时，专家会边思考边执行。计划模式则把「思考」和「执行」分成两个阶段——先产出完整计划，确认后再执行。这在复杂任务中能避免「做到一半发现方向不对」的情况。
  </Accordion>

  <Accordion title="计划可以保存吗？">
    计划文档会保存在当前会话的工作目录中（`plan.md`），你可以在工作区的文件面板中查看。每次更新计划都会覆盖上一版。
  </Accordion>

  <Accordion title="我可以中途退出计划模式吗？">
    可以。关闭 "+" 菜单中的计划模式开关即可退出，回到正常对话模式。此前生成的计划文档不会丢失。
  </Accordion>

  <Accordion title="点击 Build 后还能修改计划吗？">
    点击 Build 后专家进入执行模式，会按照计划逐步执行。如果中途需要调整，你可以直接在对话中告诉专家修改方向。
  </Accordion>

  <Accordion title="计划模式适合简单任务吗？">
    通常不需要。对于「改一行代码」「加个按钮」这样的简单任务，直接对话更高效。计划模式主要面向需要多步骤、有风险或有多种方案的复杂任务。
  </Accordion>
</AccordionGroup>

## 最佳实践

<Tip>
  **提供充分的上下文**——在激活计划模式前，先告诉专家项目背景、你的目标和约束条件。上下文越丰富，计划质量越高。
</Tip>

* **描述「为什么」而非「怎么做」**：告诉专家你想解决的问题，而不是直接指定实现方式。让专家在调研后给出最优方案。
* **分阶段处理大任务**：如果任务非常庞大（如「重写整个后端」），考虑拆成多个子计划分别执行，每次聚焦一个明确的目标。
* **关注风险部分**：计划中的「风险」部分值得仔细审阅，确保每个风险点都有明确的缓解策略。
