给你的 Gemini CLI 装上大脑皮层 —— 仅需复制一段纯文本，赋予 AI 跨会话的持久化物理记忆。

每次打开无状态的 AI CLI，它都不记得你昨天干了什么。

你说：「继续昨天的工作。」 它说：「什么工作？我们第一次见面。请提供项目背景...」

然后你只能花 10 分钟重新解释项目背景、技术栈、上次改到哪里了……每天如此，极度内耗。

只需往你的全局配置文件里粘贴一段「状态机协议声明」。不需要安装插件，不需要配置向量数据库。

从此以后，Gemini CLI 会在你的每个项目里自动维护一组隐藏的"便签"文件（memory-bank/）：

• 🟢 新会话启动 → 自动挂载便签，瞬间无缝恢复上下文
• 🟢 达成里程碑 → 自动在后台静默触发快照，更新进度
• 🟢 下次再打开 → 精准从上次断点继续

你什么都不用做，甚至不用说"保存"。它自己记。

$ gemini "我们开始吧"
[🧠 已挂载] 当前焦点：正在重构 Auth 模块，卡在 JWT 令牌刷新逻辑上。
基于上次的进度，接下来我们应该先测试 `src/auth/jwt.ts`。

$ gemini "这个模块修好了"
太棒了！任务列表已更新，准备进入下一步。(📝 记忆已同步)

⚠️ 前置要求： 确保你已经安装并配置好了 Gemini CLI（或任何支持本地文件读写的 AI 终端工具）。

第一步：找到你的全局配置文件

• Windows: C:\Users\你的用户名\.gemini\GEMINI.md
• macOS / Linux: ~/.gemini/GEMINI.md

(如果文件不存在，请手动新建一个)

第二步：注入 Cortex 协议

打开本仓库的 GEMINI.md 文件，将里面 --- 分割线下方的纯净协议内容，完整复制并追加粘贴到你的全局配置文件末尾。

第三步：唤醒记忆

随便 cd 到你的任何一个项目目录，运行 gemini。它会立刻主动拦截并问你：

⚠️ 未检测到 Memory Bank，是否扫描项目并初始化？(Y/N)

输入 Y。你的赛博副驾长出脑子了。

• 🛡️ 崩溃自愈 (WAL备份)：每次覆写核心文件前自动生成 .bak 备份。即使 Ctrl+C 强杀终端导致文件被截断，下次启动也能瞬间自愈。
• 📦 防膨胀归档 (LRU淘汰)：已完成任务最多保留 5 条。超出部分自动静默归档到冷存储 archive.md，永远不会撑爆 LLM 的上下文窗口。
• 🔒 防幻觉门禁 (HITL)：修改架构文件前必须向你弹窗申请授权 [Y/N]，且强制附带实际代码路径作为物证。杜绝大模型凭空篡改记忆。
• ⚡ 事件驱动微快照：告别"说结束才保存"的旧模式。修完一个 Bug、跑通一段测试，它会在后台立刻主动落盘保存。

当你同意初始化后，项目根目录会自动生成：

你的项目/
└── memory-bank/
    ├── projectbrief.md      ← [静态] 项目身份、主技术栈（极少变动）
    ├── systemPatterns.md    ← [静态] 架构图纸、关键决策（重构时变更）
    ├── activeContext.md     ← [动态] 当前工作焦点、今日排错日志（高频快照）
    └── progress.md          ← [动态] 看板待办/进行中/已完成（高频更新）

Q：不同项目的记忆会串台吗？ 绝对不会。每个项目的 memory-bank/ 都在各自的物理目录下，天然沙盒隔离。A 项目的 AI 绝不会知道 B 项目的秘密。

Q：临时写个脚本，不想用记忆功能怎么办？ 初始化提问时输入 N。它会在当前目录生成一个空的隐藏文件 .mbignore，以后再打开该目录它将彻底静默，不再打扰。

Q：memory-bank/ 需要加进 .gitignore 吗？ 看你的协同模式。团队协作建议加入（不污染同事的工作流）；个人独立开发强烈建议提交入库，它相当于一份会随代码自我生长的完美工程文档。

Q：这个方案只能用在 Gemini CLI 上吗？ 协议是用自然语言写的 Markdown，理论上任何支持读取本地文件的 AI CLI 工具（如 Claude Code）都可以适配，只需要调整配置文件路径。

想了解这套纯文本协议为什么这样设计？四个致命的大模型工程漏洞是如何被发现并用 Prompt 修复的？

👉 查看架构决策记录 (ADR) - docs/DESIGN.md

本方案的物理记忆流灵感源自社区两位先行者的最佳实践：

• CyrilXBT — "Obsidian + Claude Code is the most underrated productivity stack"
• James Bedford — "How I Structure Obsidian & Claude"

本项目在此基础上，引入了严谨的防御性工程架构（快照防崩、冷热隔离、零信任校验），将其打造成了可投入高强度生产环境的通用 CLI 记忆协议。

777秋 (77AutumN) | UESTC 电子硕 | FPGA × AI

• GitHub: @77AutumN
• 小红书: 搜索「777秋」

基于 MIT License 开源 —— 自由使用，欢迎提 PR。