Skip to content

Commit 0a5305d

Browse files
committed
Document Plan mode workflow
1 parent bf7ebb3 commit 0a5305d

1 file changed

Lines changed: 32 additions & 5 deletions

File tree

README.md

Lines changed: 32 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -93,6 +93,7 @@ Windows 版本是 portable EXE,不需要 setup,不需要管理员安装,
9393
- `deepseek-v4-pro`:适合审查、合并、高风险推理和复杂分析。
9494
5. 在 AI 面板中选择工作方式:
9595
- **Ask**:只读理解代码、解释知识点、定位问题。
96+
- **Plan**:先生成可审查的实施计划和待办拆解,不急着改文件。
9697
- **Agent**:允许 AI 调用工具修改项目文件。
9798

9899
API Key 会保存在本机设置中。请不要把 API Key 粘贴进聊天内容、项目源码或公开截图。
@@ -119,16 +120,38 @@ XFXCode 针对 DeepSeek V4 做了专门的 Agent Harness 融合:
119120
- 支持 context cache telemetry。
120121
- 原生工具调用不稳定时,可切换 ReAct XML 手动工具解析 fallback。
121122

122-
### 3. Agent / Ask 双模式
123+
### 3. Ask / Plan / Agent 三模式
123124

124125
| 模式 | 适合场景 | 文件修改 |
125126
| --- | --- | --- |
126127
| Ask | 解释代码、知识点讲解、查找问题、阅读项目 | 默认不主动修改 |
128+
| Plan | 复杂任务拆解、课堂讨论、方案评审、执行前确认 | 先产出计划,不直接改文件 |
127129
| Agent | 实现功能、修复 bug、重构代码、生成页面、运行命令 | 可通过工具修改 |
128130

129-
这种设计很适合课堂环境:先让学生用 Ask 理解,再用 Agent 实践,最后 review 变更。
131+
这种设计很适合课堂环境:先用 Ask 理解,再用 Plan 拆解任务和讨论方案,确认后再用 Agent 实践,最后 review 变更。
130132

131-
### 4. 文件变更可见、可追踪、可撤销
133+
### 4. Plan 模式:先规划,再执行
134+
135+
Plan 模式是 XFXCode 面向教学和复杂任务设计的“刹车层”。当一个需求涉及多个文件、多个步骤或存在不确定性时,Plan 会先让 AI 输出结构化计划,而不是立刻动手改代码。
136+
137+
Plan 模式适合:
138+
139+
- 把大作业拆成可执行的待办列表。
140+
- 在动手前比较不同实现方案。
141+
- 让学生先讲清楚“为什么这么做”,再进入 Agent 执行。
142+
- 给教师一个检查点,确认任务边界、风险和验证方式。
143+
- 对重构、页面生成、工具安装、批量修改等高影响操作先做预案。
144+
145+
典型流程:
146+
147+
```text
148+
Ask:先解释这个项目现在的结构。
149+
Plan:为“新增一个课程作品展示页”生成实施计划,不要改文件。
150+
Agent:按计划执行第一步,并在完成后说明改了哪些文件。
151+
Review:查看消息下方的文件变更卡片,必要时撤销或继续下一步。
152+
```
153+
154+
### 5. 文件变更可见、可追踪、可撤销
132155

133156
每条 Assistant 回复下方都会展示本轮变更:
134157

@@ -141,7 +164,7 @@ XFXCode 针对 DeepSeek V4 做了专门的 Agent Harness 融合:
141164

142165
新建文件、多文件撤销、不可撤销变更等风险操作会有更明确的提示,避免误操作。
143166

144-
### 5. Skills 能力系统
167+
### 6. Skills 能力系统
145168

146169
XFXCode 支持 Agent Skills,让 AI 按任务加载更专业的指令和资料:
147170

@@ -160,16 +183,18 @@ XFXCode 支持 Agent Skills,让 AI 按任务加载更专业的指令和资料
160183
| --- | --- |
161184
| 编程入门 | 解释 Python / JavaScript 代码,指出变量、函数、循环和条件判断 |
162185
| 作品开发 | 生成网页、小游戏、数据展示页面、课程项目原型 |
186+
| 任务规划 | 用 Plan 模式拆解功能需求,先讨论方案再进入实现 |
163187
| 代码修复 | 读取报错、定位文件、修改代码、解释为什么这样改 |
164188
| 项目制学习 | 围绕一个作品目录持续迭代,保留文件结构和变更记录 |
165-
| 教师演示 | 用 Agent 展示“需求 -> 计划 -> 修改 -> 验证”的完整过程 |
189+
| 教师演示 |Ask / Plan / Agent 展示“理解 -> 计划 -> 修改 -> 验证”的完整过程 |
166190
| AI 素养教育 | 让学生看到 AI 调用了什么工具、改了什么文件、哪些操作需要确认 |
167191

168192
## 安全与治理
169193

170194
XFXCode 的 AI 执行有明确边界:
171195

172196
- Ask 模式偏只读。
197+
- Plan 模式先生成计划和待办,适合执行前确认。
173198
- Agent 模式才允许写文件。
174199
- 工具调用过程可见。
175200
- 失败工具不会伪装成成功文件变更。
@@ -220,3 +245,5 @@ Available builds:
220245
- macOS Apple Silicon DMG: `XFXCode_<version>_aarch64.dmg`
221246

222247
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.
248+
249+
XFXCode supports Ask, Plan, and Agent workflows: Ask explains, Plan breaks work into reviewable steps, and Agent executes file changes through governed tools.

0 commit comments

Comments
 (0)