Hermes Agent 持久化记忆一篇讲透：为什么它跨会话都记得你的习惯

你有没有经历过这种对话：刚纠正完助手"我们项目里一律用黑体注释"，关掉窗口，第二天新会话一开口，它又开始用斜体？这种"AI 又把我上次说的忘了"的瞬间，正是 Hermes Agent 持久化记忆想解决的问题——一套 AI 记忆系统，让它跨会话记住你的偏好与习惯，用得越久越懂你。

📌 概念速览：记忆 = 两个本地文件 + 开会话时自动加载

Hermes Agent 的记忆没有任何黑魔法：就是两个纯文本文件。每次你开启新会话，系统自动把这两个文件的内容读出来、注入到 AI 的"开场白"（系统提示）里；会话中产生的新记忆，则实时写回磁盘。说白了，它"记性好不好"，你打开文件就能看到全部底牌。

📁 记忆文件到底存在哪

两个"笔记本"分工很明确：

• MEMORY.md：AI 的个人记事本。记环境事实（系统、装了什么工具）、项目约定、工具特性、踩坑后学到的知识。
• USER.md：AI 关于你的档案。记你的偏好、沟通风格、期望、工作流习惯。

两者都落在~/.hermes/memories/目录下，你可以随时用任何文本编辑器打开它们检查、修改。文件内每条记忆之间用段落符号§分隔，天然支持多行条目。

⏱ 记忆的"时差"机制：开场是拍立得，落盘是实时录像

这是整套 Hermes Agent 持久化记忆设计里最巧的一环，先给结论：系统提示里看到的记忆是"开场快照"，而你写入的新记忆"立刻生效于文件、下个会话才生效于对话"。

拆开讲：

• 开场注入的是一份冻结快照。会话启动那一刻，系统把两个文件的当前内容拍下来注入系统提示，之后整个会话期间这份快照保持不变——这样能稳住提示前缀缓存，避免每写一条记忆就触发全量重算。
• 写入却是实时的。你在会话中让助手记住一件事，它会立刻写进磁盘文件，工具返回的结果也会反映最新状态。

用摄影打比方：系统提示像拍立得，快门按下的瞬间画面就定格了，后面你摆什么姿势都不影响这张照片；磁盘上的文件像实时录像，新记忆随时被记录进去。所以同一个会话里，AI"嘴上的记忆"会有一点点时差，但"账本上的记忆"永远是最新的——下次开会话，拍立得会重新拍摄。

🔒 数据可信、放心交给它

记忆最终会被注入系统提示，等于 AI 的"长期人格来源"，所以 Hermes Agent 在两个方向做了防护：

文件写不坏（原子写入）

• 每次保存都是先在同一目录下生成临时文件、写完并落盘确认（fsync），再改名为正式文件。
• 同一文件系统上的"改名"是原子操作：要嘛是完整的旧内容，要嘛是完整的新内容，不存在"写一半断电留下一份半截记忆"。
• 中途出任何错，临时文件会被自动清掉，正式文件保持原样。

内容拦得住（安全扫描）

• 写入前逐条扫描：零宽空格等不可见字符一律拦截，防止有人把指令"藏"在肉眼看不见的地方。
• 匹配常见注入威胁模式——"忽略之前的指令"式角色劫持、把信息外传的命令之类，命中即拒绝写入并说明原因。
• 扫描逻辑集中在 agent/ 源码，想逐行验证可以直接翻。

一句话：落盘不会写坏，入口不会进脏东西。

✍️ Hermes Agent 怎么用：add / replace / remove 三板斧

想让助手记住你的编码习惯，不用改任何文件，直接在对话里让它"记住/改一下/忘掉"即可。底层只有三个动作：

• add：加一条新记忆。系统自动查重、自动算字符余量。
• replace：改一条旧记忆。给出一段能唯一定位该条目的子串就行，不用复制全文。
• remove：删掉过时条目，同样靠子串定位。

写进哪个"本子"？判断标准很简单：跟"你是谁、你喜欢什么"相关的进 USER.md；跟"环境长什么样、项目怎么约定"相关的进 MEMORY.md。

容量预警怎么应对？两个本子各有上限：MEMORY.md 为2200 字符，USER.md 为1375 字符——注意是按字符数限制而非 tokens，换任何模型都不跑偏。系统会在接近上限时主动提醒你；使用率超过 80% 就该动手整理了：合并意思相近的条目、删掉过时的信息、把"原始日志转储"提炼成一句结论。

什么值得记、什么不值得？

• ✅ 你的称呼、时区、角色、编码风格，你纠正过的习惯，环境里"只此一家"的约定和 API 特性。
• ❌ 显而易见的事实、下次随手一查就能重新发现的内容，别浪费格子。

写在最后

好的 AI 记忆系统，不是让 AI 变得更神秘，而是把记忆摊在两个你能看懂的纯文本文件里，再配上冻结快照、原子写入和入口扫描把细节都兜住。想让助手越用越贴身的个人用户，需要沉淀团队工作流与项目约定的开发团队，都值得给这套 Hermes Agent 持久化记忆一个机会。