如何让AI拥有持久记忆?fullstack-agent的ai-memory-vault纯文本记忆库深度解析

原创2026-10-14 14:56:041,997 阅读

如何让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 上,先建好记忆库、写好人格,其他部件才有意义。

对新手最重要的三个特性:

  1. 纯文本、无上限:记忆就是一个个纯文本笔记,跨会话持久保存,没有容量天花板;
  2. 人类可读可管:记忆库直接用笔记应用 Obsidian 打开,AI 记住什么你随时可见、可编辑、可整理,记忆主权始终在人手里;
  3. 旧记忆可迁移:老 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 步:回答几个问题(一次只问一个)

向导坚持"一次只问一个问题、等你的回答",全程是对话而非配置器,主要会问:

  1. 你的名字——让 AI 打招呼时能称呼你;
  2. AI 的身份——三选一:直接用作者现成的 Jarvis、保留 Jarvis 性格只改名、或从零自定义;
  3. 记忆库放在哪——系统会自动读取 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 助手。

登录后查看全文
fullstack-agent