如何让AI记住你:Hermes Desktop记忆系统与SOUL.md人格编辑完整教程
【免费下载链接】hermes-desktopDesktop Companion for Hermes Agent项目地址: https://gitcode.com/gh_mirrors/her/hermes-desktop
Hermes Desktop 是 Hermes Agent 的桌面伴侣应用,内置一套跨会话的AI 记忆系统,并支持通过SOUL.md 人格文件自定义 AI 的性格与语气。这篇完整教程将带你从零看懂它的记忆机制:如何写入长期记忆、如何编辑用户画像、如何一键重置 AI 人格,并可选接入第三方记忆提供商。
一、为什么 AI 需要"记忆"
普通聊天 AI 每开一个新会话就"失忆":你的技术栈、代码风格、常用偏好都要重复交代。Hermes Desktop 的解决方案是把记忆落盘到本地文件:
- 记忆条目(Memory):AI 在对话中认为重要的事实,逐条保存,跨会话共享
- 用户画像(USER Profile):关于"你"的信息——姓名、角色、偏好、沟通风格
- 人格(SOUL):AI 自身的性格与长期指令,每次对话前重新加载
这样,新会话里的 AI 一开口就"认识你",不需要任何额外提示词。
二、记忆页面导览:四大功能区块
在左侧导航进入「记忆」页面(源码入口:Memory.tsx),顶部是容量卡片,实时展示会话数、消息数、记忆条数与字符用量;下方有 4 个标签页:
| 标签 | 作用 |
|---|---|
| 记忆条目 | 增删改查一条条长期记忆 |
| 用户画像 | 编辑关于你的 USER.md 档案 |
| 提供商 | 激活第三方长期记忆服务 |
| 人格 | 编辑 SOUL.md 人格文件 |
核心读取逻辑在主进程 memory.ts 中实现,字符上限配置解析在 memory-limits.ts。
三、写入记忆:条目与用户画像
3.1 记忆条目(MEMORY.md)
在「记忆条目」标签点击添加记忆,输入一条简短事实即可保存,例如:
用户偏好使用 TypeScript,始终使用严格模式。
支持对任意条目编辑与删除(删除前会二次确认,交互见 MemoryEntries.tsx)。
- 所有条目存储在配置目录下的
memories/MEMORY.md,以特殊分隔符逐条拆分 - 默认容量2200 字符,写满时会提示 "Would exceed memory limit"
- 容量可在
config.yaml中通过memory.memory_char_limit调整
3.2 用户画像(USER.md)
「用户画像」标签对应memories/USER.md,建议写清姓名、角色、偏好、沟通风格,例如:
姓名 Alex。资深开发者。偏好简洁回答。使用 macOS 和 zsh。时区:PST。
默认上限1375 字符(memory.user_char_limit可调)。画像写得越具体,AI 回答越贴合你的习惯。
四、SOUL.md 人格编辑:给 AI 换一副"灵魂"
切到「人格」标签(独立组件:Soul.tsx),你会看到一个纯文本编辑器,背后对应配置文件目录中的SOUL.md,读写逻辑见 soul.ts。
关键特性:
- 自动保存:停止输入约半秒后自动落盘,右上角显示"已保存"提示
- 每次对话重载:人格修改后,下一次对话立即生效,无需重启
- 一键重置:点右上角「重置」可恢复出厂默认人格(当前内容会丢失,会先弹出确认)
默认人格长这样:"You are Hermes, a helpful AI assistant...",简洁友好的助手设定。你可以改写成任何风格——严谨的技术顾问、幽默的陪聊、只说结论的极简回答者等。
一个实用的 SOUL.md 模板思路:
- 第一行定义角色定位("你是……")
- 第二行约定语气与长度(简洁/详细、是否用列表)
- 第三行写长期生效的硬规则("涉及删除操作必须先确认")
五、进阶:接入第三方记忆提供商
内置记忆有字符上限,适合个人场景;如果需要语义搜索、知识图谱、自动去重级别的长期记忆,「提供商」标签可一键激活外部服务(激活逻辑写入memory.provider配置项)。常见选项包括:
- mem0:服务端事实提取 + 语义搜索 + 自动去重
- hindsight:知识图谱 + 多策略检索
- supermemory:语义长期记忆 + 实体提取
- holographic:本地 SQLite 存储,无需 API Key,适合不想出数据的场景
注意:内置记忆(上方条目与画像)会始终与所选提供商一起工作,两者互补而非二选一。提供商卡片与激活交互见 MemoryProviders.tsx,各界面文案出自 zh-CN/memory.ts。
六、快速上手清单
- 打开「记忆」页面,先在用户画像里写清自己是谁(5 分钟)
- 手动补 2~3 条记忆条目:技术栈、代码规范、时区
- 进入人格标签,按"角色 → 语气 → 规则"三段式改写 SOUL.md
- 新开会话验证:AI 是否已按新称呼与风格回答
- (可选)记忆量大时激活 holographic(本地免费)或 mem0 等提供商
总结:Hermes Desktop 用三个文件撑起完整的 AI 记忆体系——MEMORY.md存事实、USER.md存用户画像、SOUL.md定义人格。配合界面化的增删改查与第三方提供商扩展,让"如何让 AI 记住你"从一句愿望变成几行配置的事。
【免费下载链接】hermes-desktopDesktop Companion for Hermes Agent项目地址: https://gitcode.com/gh_mirrors/her/hermes-desktop
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考