企业官网建设流程全解析

Hermes Agent 持久化记忆指南：它如何跨会话记住你的偏好

【免费下载链接】hermes-agentThe agent that grows with you项目地址: https://gitcode.com/GitHub_Trending/he/hermes-agent

Hermes Agent 的持久化记忆用两个纯文本文件，跨会话记住你的偏好、时区和项目约定，关掉对话也不丢。本文讲清它记了什么、为什么可靠，以及 4 条让你少操心的上手技巧。

从"又忘了"说起：会话型助手的短板

你上周告诉助手"我习惯 tabs 缩进、回复别超过三句"，这周重开一个会话，它又用空格缩进、又写小作文。普通会话型助手的上下文只活在当前对话里，窗口一关，一切归零。

带持久记忆的助手则不同：Hermes Agent 会把值得保留的信息写进本地文件，下次会话开始时自动带进系统提示。于是它跨会话记住你的编码风格、时区、常用工作流——你教一次，管得长远。

它到底记了什么：MEMORY.md 管环境，USER.md 管你

记忆存在~/.hermes/memories目录下的两个文件里，分工很明确：

• MEMORY.md：代理自己的笔记。环境事实、项目约定、工具的小脾气、踩过的坑。
• USER.md：关于你的档案。偏好、沟通风格、时区、你纠正过它的地方。

两个文件都有容量上限，且按字符而非 tokens 计算（MEMORY.md 2200 字符，USER.md 1375 字符），这样不同模型下行为一致。条目之间用段落符号§分隔，单条可以跨多行，看起来像这样：

§ 时区 Asia/Shanghai，回复尽量简短 § 项目 Go 为主，缩进用 tabs

正因为是纯文本，你自己打开也能看、能改、能备份。

为什么关掉对话也没丢：一份快照加实时落盘

机制上它维护着两份状态。会话开始时，agent/system_prompt.py触发加载，从磁盘读出全部记忆，作为系统提示快照冻结——就像开场拍一张照片，整个会话期间提示词里始终是这张照片，不再变化。这样做的好处是前缀稳定，提示缓存不容易失效。

另一份是实时状态：你在会话中让助手加一条记忆，它会立刻写入磁盘，工具响应里返回的也是最新内容。注意，此刻本会话的系统提示快照不会跟着变——新记忆从下一个会话开始生效。

这个设计的取舍很务实：牺牲"立即全知"，换来提示词稳定和数据不丢。

靠谱在哪：原子写入和注入扫描

先说为什么要担心。第一，写入中断会留下半截文件，记忆一旦损坏，每次会话都带着坏数据；第二，记忆最终会被拼进系统提示，等于一条能"长期影响"模型的文字，若被人塞进恶意指令，风险是真实的。

Hermes Agent 的应对有两层：

• 原子写入：先在目标同目录写一个临时文件并同步落盘，成功后再一步重命名覆盖正式文件。同一文件系统内重命名是原子的——要么完整替换成功，要么维持原样，不会出现写到一半。类比保险柜换锁：新锁配好装进盒子再整体换，柜门不会敞开半分钟。任何失败都会清理临时文件。
• 注入扫描：写记忆前逐条检查。不可见字符（如零宽空格）直接拦下；匹配到提示注入、角色劫持、外发窃取等威胁模式的条目也会被拒绝，并返回明确的拦截原因。

相关实现集中在 tools/memory_tool.py 的MemoryStore中，扫描和写入都是添加入口的一部分，绕不过去。

上手技巧：4 条让记忆更准更省

📌只记值得的：偏好、你的纠正、环境事实（系统、工具、项目结构）值得记；随手能重新查到的细节不值得。

📌分清两个目标：跟你本人相关的进user，关于环境和知识的进memory。混放会先占满更小的那本"笔记本"。

📌记提炼，不记流水账：把"调试三次发现的坑"压缩成一句结论，比贴原始日志耐用得多。

📌快满时主动瘦身：使用率接近 80% 就合并、改写或删除过时条目。replace 和 remove 都靠子串定位条目，写一条有辨识度的开头会方便很多。

Hermes Agent 桌面端也提供了会话与来源的管理视图，方便你回看每个会话里实际用了什么上下文：

适合谁用

日常让代理写代码、跑项目的个人开发者最受益——它跨会话记住你的时区和编码风格，省掉每次重复交代。有固定约定的小团队也合适：项目约定进 MEMORY.md，成员各换一台机器，工作流照样接得上。

持久化记忆不神秘：两个文件、一份快照、一套写入和扫描的保护。理解到这里，你就能把它当成一张越写越值钱的"长期便签"来用了。

【免费下载链接】hermes-agentThe agent that grows with you项目地址: https://gitcode.com/GitHub_Trending/he/hermes-agent