如何让AI拥有持久记忆?fullstack-agent的ai-memory-vault纯文本记忆库深度解析
如何让AI拥有持久记忆?fullstack-agent的ai-memory-vault纯文本记忆库深度解析
fullstack-agent 是一个开源的一键式 AI Agent 安装器,本文带你深度解析它内置的 ai-memory-vault 纯文本记忆库:AI 通过直接读写纯文本文件来实现"AI 持久记忆",能跨所有会话记住你、你的工作和每一条经验教训,而且没有容量上限——这是普通新手也能轻松上手的记忆方案。
一、为什么 AI 总是"失忆"?
大多数 AI 助手都有一个通病:新开会话就像换了个人——它不认识你、不知道你做到哪一步、也不记得上次聊过的结论。
根源在于:AI 每次只能"看见"当前上下文窗口,没有外部持久存储。社区常见的解决路线大致两条:
| 特性 | 向量数据库路线 | ai-memory-vault 纯文本路线 |
|---|---|---|
| 记忆形态 | 向量/二进制,人眼不可见 | 纯 Markdown 笔记,随时可读可改 |
| 容量限制 | 通常有限额 | 无大小上限(no size ceiling) |
| 维护成本 | 依赖服务端与配置 | 零依赖,就是一堆文件 |
| 掌控感 | 黑盒 | 你用笔记软件直接管理 |
💡 核心思路:把记忆做成"AI 自己会归档、会查阅的抽屉笔记",简单、透明、可控。
二、ai-memory-vault:给 AI 装上"大脑"
fullstack-agent 官方 README.md 把整套体系拆成四个部件,其中记忆是地基:
- 🧠 大脑(The mind):ai-memory-vault——构建在纯文本文件上的真实持久记忆,AI 可读可写,跨会话记住你的一切
- 🎤 嘴巴:backtalk——按住说话,AI 约一秒后通过音箱回答
- 🖥️ 脸:ai-visualizer——全屏可视化画面,与对话同步"发呆、聆听、思考、说话"
- ✋ 手:barehands——隔空在屏幕上移动便签和图片(可选组件)
安装向导 fullstack-agent.md 明确规定 ai-memory-vault 永远第一个安装,原因很简单:语音、脸、手这些部件都要"挂"在一个有大脑的 Agent 上,先建好记忆库、写好人格,其他部件才有意义。
对新手最重要的三个特性:
- 纯文本、无上限:记忆就是一个个纯文本笔记,跨会话持久保存,没有容量天花板;
- 人类可读可管:记忆库直接用笔记应用 Obsidian 打开,AI 记住什么你随时可见、可编辑、可整理,记忆主权始终在人手里;
- 旧记忆可迁移:老 Claude Code 项目记忆(
~/.claude/projects/*/memory/目录)可以在安装时被复制进新记忆库,且只复制、从不删除原件。
三、一键安装:一条命令完成记忆库配置
前置要求:Claude Code($20 Pro 套餐即可);Mac / Linux 还需要 git,Windows 的installer 会在过程中替你装好。
第 1 步:克隆仓库并启动向导
mkdir -p ~/my-agent && cd ~/my-agent && git clone https://gitcode.com/gh_mirrors/fu/fullstack-agent && cd fullstack-agent && claude "set me up"
关键就在最后的 claude "set me up":Claude Code 一打开,安装向导(即 fullstack-agent.md)就开始和你对话了。
第 2 步:回答几个问题(一次只问一个)
向导坚持"一次只问一个问题、等你的回答",全程是对话而非配置器,主要会问:
- 你的名字——让 AI 打招呼时能称呼你;
- AI 的身份——三选一:直接用作者现成的 Jarvis、保留 Jarvis 性格只改名、或从零自定义;
- 记忆库放在哪——系统会自动读取 Obsidian 的
obsidian.json列出你机器上所有 vault,供你选择:复用已有的,或为这套系统新建一个(默认创建在~/你的vault名,与 agent 文件夹平级,绝不塞进 agent 文件夹里)。
⚠️ Obsidian 不是可选项:它是你"看见"并拥有 AI 记忆的窗口。如果没装,记忆库向导的 Part 1 会在征得你同意后自动安装。
第 3 步:自动安装与接线
回答完毕后,向导自己完成剩余工作:克隆 ai-memory-vault 等各部件到 agent 主文件夹、创建并注册 vault、写入身份文件,再把记忆库路径接线到语音等部件——所谓"接线"只是配置路径,从不移动你的文件。
最后运行 start.sh(Windows 用 start.bat)自测:脸的画面打开、AI 说出第一句问候、你按住按键问它任何问题,几分钟内就能看到完整效果。
四、记忆在哪里?日常怎么用
- 身份文件:AI 的名字、性格、欢迎语写在 agent 主文件夹的
CLAUDE.md里,这是 AI 每次启动时的"自我认知"; - 记忆本体:vault 文件夹里的笔记,用 Obsidian 打开即可人工整理;
- 日常使用:双击桌面快捷方式(Chat / Talk)打开会话即可;关闭窗口后在 agent 文件夹运行
claude --continue能带记忆恢复最近一次会话; - 更新零风险:运行 update.sh(macOS)或直接让 AI"update everything"。因为你的 CLAUDE.md、vault 和笔记都在被更新的仓库之外,更新永远不会碰到它记下的东西。
五、新手常见问题
Q:会删除或覆盖我的笔记吗? 不会。向导的硬性规则是"永不删除、覆盖或移动用户创建的任何东西";已存在的记忆库和 AI 身份会被"照原样收养",绝不重建。
Q:出了问题要自己修吗? 不用。每个部件自带排障指南,跨部件问题汇总在 TROUBLESHOOTING.md;而且 AI 在安装时被写入了"你是自己的修理工"这一职责——在聊天里直接描述问题,它会读指南、诊断并自己修好。
Q:只想装记忆部分可以吗? 可以。菜单里每个部件都可以单独选择,向导会逐项询问你要哪些,只装记忆库完全没问题。
📌 小结:让 AI 拥有持久记忆的关键,不是更强的模型,而是给它一块"它写得到、你看得懂"的存储空间。ai-memory-vault 用最朴素的纯文本做到了这一点——配合 fullstack-agent 的一键向导,零基础用户也能在几分钟内得到一个真正"记得住你"的 AI 助手。