Second Brain 记忆系统全解:自维护的 Markdown 记忆如何让 AI 越用越懂你
Second Brain 记忆系统全解:自维护的 Markdown 记忆如何让 AI 越用越懂你
Second Brain 是一个本地运行的 AI Agent 框架,把大模型变成一台能读写文件、自动执行任务的"个人操作系统"。它的记忆系统解决了 AI 助手最头疼的问题——每次新开对话就像失忆一样:Second Brain 让 Agent 把了解你的信息写进自维护的 Markdown 记忆文件 MEMORY.md,这些内容会被自动注入每一次对话的系统提示词,从而实现真正的"越用越懂你"。🧠
为什么 AI 需要一套记忆系统?
你可能已经注意到:问 AI 昨天的问题,今天它完全想不起来。这不是 Bug,而是 LLM 的先天限制——上下文窗口有限。Second Brain 的开发者在系统提示词里用了一个很妙的比喻:
"You are like Leonard in Memento(你就像诺兰电影《记忆碎片》里的 Leonard)"
也就是说,Agent 每次对话看到的只是"真理的一个快照"。Second Brain 记忆系统的设计目标很清晰:
- 短期记忆交给上下文窗口(对话本身)
- 长期记忆交给磁盘上的 Markdown 文件(可无限生长、人类可读可编辑)
这样"你告诉过它的偏好、项目背景、重要约定"就能跨越对话存活下来。
MEMORY.md 双层结构:索引 + 主题笔记
Second Brain 的记忆采用"索引 + 主题文件"的双层结构,全部存放在 Agent 自己的工作区里:
| 层级 | 文件 | 作用 |
|---|---|---|
| 📇 索引 | workspace/memory/MEMORY.md |
记忆总目录,每次对话自动注入提示词 |
| 📄 主题笔记 | workspace/memory/*.md |
每个主题一篇笔记,由索引链接 |
举个例子,索引里可能写着"某项目 → proj.md",Agent 需要细节时再去读对应的主题文件。这种设计的好处是:注入提示词的只有轻量索引,大段细节按需加载,不浪费宝贵的 token 预算。
关键机制在 agent/system_prompt.py 的 _agent_memory() 函数:每次调用大模型时,内核都会读取 MEMORY.md 的内容,以"Your memory / Your MEMORY.md file says:"的格式拼进系统提示词。换句话说——你写的每一个字,Agent 下辈子(下次对话)都"记得"。
4000 字符预算:AI 自己管好自己的记忆
记忆文件如果无限膨胀,提示词也会被撑爆。Second Brain 用一个精巧的"预算"机制来约束它:
- 默认上限 4000 字符,由配置项
memory_index_cap控制,见 config/config_data.py - 超出上限时索引会被截断,并且截断标记是故意可见的——Agent 看到"index truncated ... — prune MEMORY.md"就会明白:该给自己的笔记做减法了 ✂️
这就是"自维护"的含义:不是后台程序在偷偷整理,而是 AI 在系统提示词的引导下自己保持笔记精简(提示词原文见 agent/system_prompt_static.md,要求 Agent"keep a disciplined and organized system of notetaking")。
免审批写入:一个被"修好"的设计细节
记忆要能自动维护,前提必须是 Agent 能自由地写。这里有个很能体现设计哲学的历史细节:
- 早期记忆目录放在数据目录顶层
memory/,属于"受保护区"——Agent 每保存一次记忆都要弹审批框。而"一次被拒绝的记忆写入"的失败模式是沉默:没有任何下游知道本该存在的笔记丢了 🤫 - 于是记忆被搬进了
workspace/memory/(Agent 的自有工作区),安全策略 _freely_writable 对它免审批放行——写索引、改笔记、删过期主题都不再打扰你 - 旧目录的存量文件由启动时的迁移逻辑 _move_memory 自动搬入新位置;遇到同名文件绝不猜测合并,两边都保留并提示你处理,保证迁移幂等可重入
这些决策都有专门的测试守护,见 tests/test_memory_location.py。
越用越懂你:日常使用指南
好消息是:你几乎不需要做任何事,记忆就在工作。
- 🗣️ 正常聊天即可:系统提示词已要求 Agent 把值得记住的事写进
MEMORY.md。你对它说"以后周报都用中文""我的项目代号是 X",它会自己落笔记 - 🛒 安装记忆增强包:运行
/packages install可以装bundle_memory(README 称之为"memory that maintains itself, stored as markdown you can edit"——自维护的、以可编辑 Markdown 存储的记忆),获得更强的检索与整理能力 - ✏️ 记忆就是纯文本,你可以直接改:用任何编辑器打开
workspace/memory/MEMORY.md,改错、补充、删除都行——这是和"黑盒向量库"方案最大的不同,你对 AI 的记忆拥有完全可见、可编辑的控制权 - 🔒 无人值守的记忆整理:Second Brain 的 Agent Profile 机制可以为后台子代理划定极小的工具白名单(如
memory_curator档案),让"记忆整理员"在后台安全运行,而不给它任何危险的写权限
记忆系统 vs 对话压缩:两个别混淆的概念
Second Brain 还有一个容易和记忆系统混淆的机制——对话压缩(Compaction):
| 对比项 | 📝 Markdown 记忆 | 🗜️ 对话压缩 |
|---|---|---|
| 存放位置 | workspace/memory/ 纯文本文件 |
数据库中的对话摘要 |
| 生命周期 | 永久,跨所有对话 | 单次对话内部 |
| 谁来维护 | Agent 自己写、你自己也能改 | 摘要服务自动生成,见 bundled/services/service_compactor.py |
| 解决什么 | "跨对话记住你" | "单次对话别撑爆上下文" |
压缩发生时,完整聊天记录仍保留在数据库里(你随时能查),但 Agent 看到的是摘要。而 MEMORY.md 里的内容,则会永远跟着它下辈子。两者配合,才构成完整的"越用越懂你"闭环。
延伸阅读:源码与文档地图
想深入 Second Brain 记忆系统,建议按这条路线阅读:
- agent/system_prompt_static.md — Agent 的"人格设定",其中 When 一节藏着 Memento 比喻,How 一节是记笔记的行为准则
- agent/system_prompt.py —
MEMORY_INDEX_CAP预算常量与MEMORY.md的注入逻辑 - migrations.py — 记忆目录的迁移策略(绝不合并冲突文件)
- sandbox/policy.py — 免审批写入的安全边界
- config/config_data.py —
memory_index_cap配置说明 - tests/test_memory_location.py — 用测试固化的设计意图,读懂它比读代码更快
📌 一句话总结:Second Brain 的记忆系统 = 一层 AI 自维护的 Markdown 笔记(MEMORY.md)+ 每次对话自动注入 + 人类随时可编辑。没有玄学向量库,没有黑盒——翻开文件,你就看到了 AI 是怎么"懂你"的。
