iFlow CLI 完整工作流指南

1. 核心概念

概念	说明	维护方式
IFLOW.md	项目的"静态记忆"，记录技术栈、目录结构、编码约定	/init 生成，手动更新
设计文档 (如 DESIGN.md)	动态的需求与设计记录	AI 协助生成和维护，手动保存
Git	代码版本管理	关键节点手动提交
会话管理	保存/恢复对话上下文，实现"思维分支"	/chat save/resume
深度思考	AI 内部推理，让回答更深入准确	关键词触发

2. 完整工作流

1️ 项目初始化

|---|----------------------------------------------|
| | cd your-project |
| | iflow |
| | |
| | # 生成项目记忆文件 |
| | > /init |
| | |
| | # 生成项目设计文档 |
| | > 根据需求，帮我生成一份设计文档 DESIGN.md，包含功能列表、架构、接口等。 |
| | # AI 输出内容后，保存为 DESIGN.md |
| | |
| | # 手动编辑 IFLOW.md，追加一行： |
| | # 设计文档位于 DESIGN.md，所有变更需同步更新。 |

2️⃣ 每次开发会话的开始

|---|--------------------------|
| | iflow |
| | |
| | # 方式一：恢复之前的会话 |
| | > /chat resume 上次的标签 |
| | |
| | # 方式二：新会话，加载项目记忆和设计文档 |
| | > @IFLOW.md @DESIGN.md |
| | > 我们开始实现用户登录功能... |

3️⃣ 日常开发循环

步骤	操作示例	说明
需求讨论	> 用户登录需要加验证码	自然语言描述需求
深度思考	> 深度思考下这个设计的性能影响	复杂问题让 AI 深入分析
代码生成	> 生成登录组件的代码	AI 给出代码方案
文件引用	> @src/login.js 帮我优化这个函数	让 AI 查看/修改特定文件
验证测试	> !npm test	执行命令，AI 可分析结果
保存代码	> !git add . + !git commit -m "feat: 登录功能"	Git 提交代码
保存对话	> /chat save 登录功能设计_v1	保存对话检查点

4️⃣ 需求变更流程

|---|--------------------------------------------|
| | # 1. 提出变更 |
| | > 需求变了，需要增加"记住我"功能，请更新 DESIGN.md 并输出新内容。 |
| | |
| | # 2. 更新设计文档（AI 输出新内容后，手动保存） |
| | # 复制 AI 输出的内容，覆盖 DESIGN.md |
| | |
| | # 3. 继续开发 |
| | > @DESIGN.md 现在开始实现这个新功能... |

5️⃣ 实验性探索（Git 分支）

|---|------------------------------------------|
| | # 创建实验分支 |
| | > !git checkout -b experiment/new-auth |
| | |
| | # 放心尝试，和 AI 折腾各种方案 |
| | > 我们试试用 JWT 重构认证... |
| | |
| | # 如果满意，合并回主分支 |
| | > !git checkout main |
| | > !git merge experiment/new-auth |
| | |
| | # 如果不满意，直接丢弃 |
| | > !git checkout main |
| | > !git branch -D experiment/new-auth |

6️⃣ 跨日工作

|---|--------------------------|
| | # 下班前保存对话 |
| | > /chat save 登录功能_完成 |
| | |
| | # 第二天恢复 |
| | > /chat resume 登录功能_完成 |
| | # 所有上下文都在，继续开发 |

3. 常用命令速查

- 初始化命令

命令	作用
/init	扫描项目，生成/更新 IFLOW.md
/memory	管理长期记忆（团队约定、术语）

- 会话管理

命令	作用
/chat save <标签>	保存当前对话为检查点
/chat resume <标签>	恢复到指定检查点
/chat list	列出所有保存的会话
/chat delete <标签>	删除某个会话
/clear	清空当前对话历史（重置上下文）
/compress	压缩长对话，释放 token

- 文件交互

命令	作用
@<文件路径>	将文件内容发送给 AI（支持通配符）
/fetch --url="..."	抓取网页内容并注入对话

- 系统命令

命令	作用
!<shell命令>	执行 Shell 命令，输出自动进入上下文

- Agent 调用

命令	作用
$<agent名>	调用特定领域专家（如 $code-reviewer）

- 深度思考

命令	作用
包含"想想/思考/think"等关键词	触发 AI 的内部推理（normal/hard/mega/ultra 等级）
特定模型按 Tab 键	快速切换思考模式

- 扩展

命令	作用
/mcp	管理 MCP 服务器（连接外部工具）
/workflow add	从市场安装预制工作流

4. 与 Git 协同

最佳实践

1、关键节点手动提交

|---|-----------------------------------|
| | # 完成一个功能后立即提交 |
| | > !git add . |
| | > !git commit -m "feat: 添加用户注册" |

2、 语义化提交信息

• feat: 添加用户登录 - 新功能
• fix: 修复验证码bug - 修复问题
• docs: 更新设计文档 - 文档变更
• refactor: 重构认证逻辑 - 代码重构
• test: 添加单元测试 - 测试相关

3、用分支隔离实验

|---|-------------------------------------|
| | > !git checkout -b experiment/新功能 |
| | # 放心尝试，不满意就丢弃 |

4、对话即分支

|---|-----------------------------------|
| | > /chat save 方案探索_v1 # 保存对话状态 |
| | > /chat resume 方案探索_v1 # 回到之前思路 |

5、回滚文件

|---|--------------------------|
| | # AI 改坏了代码 |
| | > !git restore 文件名 |
| | # 或 |
| | > !git checkout -- 文件名 |

6、查看历史

|---|------------------------|
| | > !git log --oneline |
| | # AI 可以帮你分析提交历史 |

5. 深度思考功能

什么是深度思考？

• iFlow CLI 内置的思考能力（Thinking Capability），通过关键词触发 AI 的多级内部推理，让回答更深入、更可靠。

如何使用

• 触发方式：输入中包含"想想"、"思考"、"think"、"深度思考"等关键词
• 快速切换（部分模型如 glm-4.6、deepseek-3.2）：在输入时按 Tab 键 循环切换思考模式

推理等级

等级	token 量	适用场景
normal	2000	一般问题
hard	4000	较复杂问题
mega	10000	复杂系统设计
ultra	32000	深度架构分析

示例

|---|-------------------------------|
| | > 深度思考下这个用户认证流程的安全性，给出改进建议。 |
| | # AI 会输出思考过程，然后给出经过深思熟虑的答案 |
| | |
| | > 想想这个数据库设计的潜在问题 |
| | # 触发深度思考模式 |
| | |
| | > 用 ultra 模式分析下系统的性能瓶颈 |
| | # 最高强度思考 |

适用场景

• 系统架构设计
• 复杂逻辑分析
• 性能优化方案
• 安全审查
• 代码重构策略
• 技术选型决策

6. 常见问题

Q1：每次都要手动更新 DESIGN.md，太麻烦怎么办？

• A：可以让 AI 输出更新后的完整文档，你只需复制粘贴。也可以让 AI 生成 diff 格式，你手动合并，但推荐前者，简单不易错。

Q2：IFLOW.md 需要经常更新吗？

• A：项目结构或技术栈变化时才需要，比如新增了重要目录、改变了测试框架。手动编辑或重新 /init 均可。

Q3：如何彻底清除某段对话历史（比如涉及敏感信息）？

• A：用 /clear 清空当前对话；如果需要删除保存的会话，用 /chat delete <标签>。

Q4：能不能让 AI 自动执行 Git 命令？

• A：可以，但需谨慎。比如让 AI 生成提交信息后，你手动执行 !git commit -m "信息"。避免 AI 直接操作，防止意外。

Q5：深度思考怎么用最有效？

• A：
  • 复杂问题一定加"深度思考"关键词
  • 可以指定思考等级："用 ultra 模式分析..."
  • 结合 @ 文件引用，让 AI 基于真实代码思考
  • 思考结果不满意，可以要求"换个角度再想想"

Q6：对话太长影响效果怎么办？

• A：用 /compress 压缩长对话，AI 会提炼关键信息，释放 token 空间。

Q7：如何找回误删的保存会话？

• A：目前不支持恢复已删除的会话，建议定期用 /chat list 查看，重要的可以手动记录标签名。

7. 总结：一个典型的工作日流程

|---|-----------------------------------|
| | # 早上 |
| | iflow |
| | > /chat resume 昨日进度 |
| | > 今天继续开发... |
| | |
| | # 开发中 |
| | > @src/main.js 帮我优化这个函数 |
| | > !npm test |
| | > /chat save 上午进度 |
| | |
| | # 下午 |
| | > /chat resume 上午进度 |
| | > 深度思考下这个架构问题 |
| | > !git commit -m "feat: 完成核心功能" |
| | |
| | # 下班前 |
| | > /chat save 今日完成_日期 |
| | > !git push |