Document Plan mode workflow

Author: EazyLee30

README.md

@@ -93,6 +93,7 @@ Windows 版本是 portable EXE，不需要 setup，不需要管理员安装，
    - `deepseek-v4-pro`：适合审查、合并、高风险推理和复杂分析。
 5. 在 AI 面板中选择工作方式：
    - **Ask**：只读理解代码、解释知识点、定位问题。
+   - **Plan**：先生成可审查的实施计划和待办拆解，不急着改文件。
    - **Agent**：允许 AI 调用工具修改项目文件。
 
 API Key 会保存在本机设置中。请不要把 API Key 粘贴进聊天内容、项目源码或公开截图。
@@ -119,16 +120,38 @@ XFXCode 针对 DeepSeek V4 做了专门的 Agent Harness 融合：
 - 支持 context cache telemetry。
 - 原生工具调用不稳定时，可切换 ReAct XML 手动工具解析 fallback。
 
-### 3. Agent / Ask 双模式
+### 3. Ask / Plan / Agent 三模式
 
 | 模式 | 适合场景 | 文件修改 |
 | --- | --- | --- |
 | Ask | 解释代码、知识点讲解、查找问题、阅读项目 | 默认不主动修改 |
+| Plan | 复杂任务拆解、课堂讨论、方案评审、执行前确认 | 先产出计划，不直接改文件 |
 | Agent | 实现功能、修复 bug、重构代码、生成页面、运行命令 | 可通过工具修改 |
 
-这种设计很适合课堂环境：先让学生用 Ask 理解，再用 Agent 实践，最后 review 变更。
+这种设计很适合课堂环境：先用 Ask 理解，再用 Plan 拆解任务和讨论方案，确认后再用 Agent 实践，最后 review 变更。
 
-### 4. 文件变更可见、可追踪、可撤销
+### 4. Plan 模式：先规划，再执行
+
+Plan 模式是 XFXCode 面向教学和复杂任务设计的“刹车层”。当一个需求涉及多个文件、多个步骤或存在不确定性时，Plan 会先让 AI 输出结构化计划，而不是立刻动手改代码。
+
+Plan 模式适合：
+
+- 把大作业拆成可执行的待办列表。
+- 在动手前比较不同实现方案。
+- 让学生先讲清楚“为什么这么做”，再进入 Agent 执行。
+- 给教师一个检查点，确认任务边界、风险和验证方式。
+- 对重构、页面生成、工具安装、批量修改等高影响操作先做预案。
+
+典型流程：
+
+```text
+Ask：先解释这个项目现在的结构。
+Plan：为“新增一个课程作品展示页”生成实施计划，不要改文件。
+Agent：按计划执行第一步，并在完成后说明改了哪些文件。
+Review：查看消息下方的文件变更卡片，必要时撤销或继续下一步。
+```
+
+### 5. 文件变更可见、可追踪、可撤销
 
 每条 Assistant 回复下方都会展示本轮变更：
 
@@ -141,7 +164,7 @@ XFXCode 针对 DeepSeek V4 做了专门的 Agent Harness 融合：
 
 新建文件、多文件撤销、不可撤销变更等风险操作会有更明确的提示，避免误操作。
 
-### 5. Skills 能力系统
+### 6. Skills 能力系统
 
 XFXCode 支持 Agent Skills，让 AI 按任务加载更专业的指令和资料：
 
@@ -160,16 +183,18 @@ XFXCode 支持 Agent Skills，让 AI 按任务加载更专业的指令和资料
 | --- | --- |
 | 编程入门 | 解释 Python / JavaScript 代码，指出变量、函数、循环和条件判断 |
 | 作品开发 | 生成网页、小游戏、数据展示页面、课程项目原型 |
+| 任务规划 | 用 Plan 模式拆解功能需求，先讨论方案再进入实现 |
 | 代码修复 | 读取报错、定位文件、修改代码、解释为什么这样改 |
 | 项目制学习 | 围绕一个作品目录持续迭代，保留文件结构和变更记录 |
-| 教师演示 | 用 Agent 展示“需求 -> 计划 -> 修改 -> 验证”的完整过程 |
+| 教师演示 | 用 Ask / Plan / Agent 展示“理解 -> 计划 -> 修改 -> 验证”的完整过程 |
 | AI 素养教育 | 让学生看到 AI 调用了什么工具、改了什么文件、哪些操作需要确认 |
 
 ## 安全与治理
 
 XFXCode 的 AI 执行有明确边界：
 
 - Ask 模式偏只读。
+- Plan 模式先生成计划和待办，适合执行前确认。
 - Agent 模式才允许写文件。
 - 工具调用过程可见。
 - 失败工具不会伪装成成功文件变更。
@@ -220,3 +245,5 @@ Available builds:
 - macOS Apple Silicon DMG: `XFXCode_<version>_aarch64.dmg`
 
 GitHub automatically adds `Source code (zip)` and `Source code (tar.gz)` to every release. Those archives are only snapshots of this public download repository. To install XFXCode, download the `.exe` or `.dmg` asset from the Release page.
+
+XFXCode supports Ask, Plan, and Agent workflows: Ask explains, Plan breaks work into reviewable steps, and Agent executes file changes through governed tools.