用 RooFlow 让 VS Code 里的 AI 助手真正“记得”你的项目

——一份写给开发者的持久化上下文实战指南

“

如果你已经用 Roo Code 在 VS Code 里写代码，却还是每次打开新会话都要重复交代项目背景，那这篇长文会给你一条新路：RooFlow。它用一套实验性的 YAML 提示词和 Memory Bank，把“项目记忆”留下来，让 AI 像老同事一样懂你。以下内容全部基于官方文档，没有任何外部演绎。

目录

  1. 为什么项目记忆会断？
  2. RooFlow 是什么？
  3. 五兄弟模式：它们到底做什么？
  4. Memory Bank：项目记忆的硬盘
  5. 安装：一步一步验证成功
  6. 第一次使用：从空白项目到可对话
  7. 更新与共存：Flow 模式与原生模式互不打架
  8. 常见问题答疑（FAQ）
  9. 小结与下一步

1. 为什么项目记忆会断？

当你在 Roo Code 的 Architect 模式里聊了半天架构，第二天打开 VS Code 再切回 Code 模式，AI 却像失忆一样重新问：“咱们项目叫啥？”
原因：默认提示词是 Markdown，每次会话重新加载，上文不会自动落盘。

RooFlow 用 YAML 精简提示、再用 Memory Bank（本地持久目录）把关键信息写进 Markdown，跨会话可找回。

2. RooFlow 是什么？

一句话：RooFlow 是 Roo Code 的非官方“增强包”。

  • 提供 5 个带“Flow-”前缀的模式，对应原生的 Architect、Code、Debug、Ask，再加一个 Orchestrator。
  • 用 YAML 重写系统提示词，官方说能降低 token 用量。
  • 自动维护 memory-bank/ 目录，放 5 份 Markdown 文件，充当项目大脑。

“

⚠️ 实验性质，不保证向后兼容；装之前记得备份旧 .roo/ 配置。

3. 五兄弟模式：它们到底做什么？

模式 原生意图 在 RooFlow 里的变化 与 Memory Bank 的关系
Flow-Architect 架构设计、初始化 帮你创建 memory-bank/ 并写首版上下文 读+写
Flow-Code 写/改/补注释 写完顺手把改动摘要写进 activeContext.md 读+写
Flow-Debug 找 Bug、加日志 把错误现象与修复思路写进 decisionLog.md 读+写
Flow-Ask 解释代码、答疑 只读 Memory Bank，不写入，防止污染 只读
Flow-Orchestrator 复杂任务编排 像项目经理一样拆解任务，再切到上面三兄弟 读+写

“

记忆小贴士：除了 Flow-Ask，其余模式都会随时把“重要”信息写回 Memory Bank，无需你手动记笔记。

4. Memory Bank：项目记忆的硬盘

目录默认叫 memory-bank/，放在项目根。RooFlow 自动生成 5 份文件：

文件名 存放内容 什么时候更新
activeContext.md 当前会话的改动、待办、疑问 每次会话结束或你喊 “Update Memory Bank”
decisionLog.md 关键决策、理由、实施细节 切到 Architect 或 Debug 时
productContext.md 项目愿景、功能清单、高层架构 首次初始化或重大变更
progress.md 任务清单、完成度 每次完成子任务
systemPatterns.md 代码/测试/架构规范（可选） 你主动维护

写作风格：Markdown 列表+二级标题，人类可直接阅读，也可以删改——AI 下次加载会合并。

5. 安装：一步一步验证成功

5.1 先决条件

  • VS Code 已装 Roo Code 扩展
  • 终端能用 git --version
  • 终端能用 python3 --version（或 Windows 的 python --version）
  • pip install pyyaml 成功

5.2 一键脚本（官方推荐）

Windows（CMD 或 PowerShell）

:: 普通文件 Memory Bank
curl -O https://raw.githubusercontent.com/GreatScottyMac/RooFlow/main/config/install_rooflow.cmd
./install_rooflow.cmd

:: 如果你用 Context Portal MCP
curl -O https://raw.githubusercontent.com/GreatScottyMac/RooFlow/main/config/install_rooflow_conport.cmd
./install_rooflow_conport.cmd

macOS / Linux（bash/zsh）

# 普通文件 Memory Bank
curl -O https://raw.githubusercontent.com/GreatScottyMac/RooFlow/main/config/install_rooflow.sh
chmod +x install_rooflow.sh
./install_rooflow.sh

# 如果你用 Context Portal MCP
curl -O https://raw.githubusercontent.com/GreatScottyMac/RooFlow/main/config/install_rooflow_conport.sh
chmod +x install_rooflow_conport.sh
./install_rooflow_conport.sh

5.3 安装脚本会做什么？

  1. 检查 git、python、pyyaml。
  2. 克隆仓库 → 复制 .roo/ 目录和 .roomodes → 清理克隆目录。
  3. 运行 generate_mcp_yaml.py，把路径占位符换成你电脑真实路径。
  4. 如果根目录有 system_prompt.md，自动把 MCP 服务器描述注入新的 YAML 提示词。

5.4 验证

  • 项目根出现 .roo/ 和 .roomodes，即安装成功。
  • 打开任意 .roo/system-prompt-flow-architect.yaml 看 WORKSPACE_PLACEHOLDER 已被替换为真实路径。

6. 第一次使用：从空白项目到可对话

场景：一个全新的 Python CLI 项目

Step 1 打开 VS Code → 新建文件夹 pytodo

Step 2 终端执行安装脚本

./install_rooflow.sh

Step 3 启动 Roo Code 聊天窗口

  • 选择 🌊Flow Architect
  • AI 检测到无 memory-bank/，提示“是否初始化？”
  • 回复 yes
  • 自动创建 memory-bank/ 并写入首版 productContext.md：
# Product Context
## Goals
- Build a lightweight CLI todo manager in Python
## High-level Architecture
- Single `main.py` entry point
- JSON file as storage

Step 4 切到 🌊Flow Code

  • 直接说：“生成 main.py，支持 add、list、done 三个命令。”
  • AI 会：

    1. 读 productContext.md 了解目标
    2. 生成代码
    3. 把本次新增文件列表写入 activeContext.md
    4. 把“使用 JSON 作为存储”写回 decisionLog.md

Step 5 第二天继续

  • 重新打开 VS Code → Roo Code → 🌊Flow Code
  • 问：“我上次做到哪一步？”
  • AI 直接引用 progress.md 回答，无需你重复背景。

7. 更新与共存：Flow 模式与原生模式互不打架

  • 安装后，Roo Code 的下拉菜单会同时出现 Architect 和 Flow-Architect 等。
  • 你可以随时切换；Flow 模式读写 memory-bank/，原生模式不碰。
  • 更新 RooFlow 只需 再次执行安装脚本，脚本会覆盖 .roo/ 和 .roomodes。

    • 如你改过 .roomodes，先重命名备份，再合并。

8. 常见问题答疑（FAQ）

Q1：RooFlow 会不会把我项目源码上传到云端？

A：不会。所有 Memory Bank 文件都保存在本地磁盘，官方脚本不调用外网 API。

Q2：Memory Bank 文件可以手动改吗？

A：可以。RooFlow 只追加或更新片段，不会整文件覆盖，但建议保留 Markdown 语法，以免 AI 解析出错。

Q3：如何彻底卸载？

A：删除项目根目录的 `.roo/`、`.roomodes`、`memory-bank/` 以及任何 `generate_mcp_yaml.py` 即可。

Q4：我在 Windows 用 Python 3.12 会报错？

A：脚本默认调用 `python`，如果你的 3.12 安装路径不在 PATH，请把 `python` 指向正确位置再运行。

Q5：MCP 服务器换了新工具怎么办？

A：
1. 在 Roo Code 设置里重新复制完整系统提示。
2. 保存为 `system_prompt.md` 到项目根。
3. 重新跑安装脚本。
脚本会把最新工具描述注入 YAML。

9. 小结与下一步

  • RooFlow 的价值：把 AI 从“一次性聊天”变成“带记忆的协作伙伴”。
  • 风险：实验功能，API 可能变；生产项目请做好版本控制。
  • 下一步尝试：

    1. 在已有老项目里跑安装脚本，观察 Memory Bank 如何增量学习。
    2. 把 systemPatterns.md 填上团队编码规范，看 AI 能否在 Code 模式自动提醒。

祝你编码愉快，AI 常驻，记忆不断线。