hermes agent 的长期记忆以明文存储于本地 ~/.hermes/memories/ 下的 memory.md 和 user.md 文件中，支持直接读取、语义检索、sqlite 查询及配置核查。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望查看 Hermes Agent 中 AI 所保存的长期记忆内容，这些信息并非存储在模型内部或远程服务器中，而是以明文文件形式持久化在本地磁盘上。以下是直接访问和读取这些记忆文件的具体方法：
一、定位并打开 MEMORY.md 与 USER.md 文件
长期情景记忆被拆分为两类结构化文本文件，分别记录环境事实与用户偏好，均存放在 ~/.hermes/memories/ 目录下。MEMORY.md 存储项目上下文、工具使用习惯、技术栈约定等；USER.md 记录沟通风格、格式偏好、工作流习惯等个人画像信息。
1、打开终端（Linux/macOS）或 PowerShell（Windows + WSL2）。
2、执行命令 ls -la ~/.hermes/memories/，确认 MEMORY.md 和 USER.md 文件存在。
3、使用文本编辑器打开对应文件，例如运行 cat ~/.hermes/memories/MEMORY.md 或 code ~/.hermes/memories/USER.md（需已安装 VS Code CLI）。
二、通过会话内工具调用检索记忆条目
Hermes Agent 提供了内置的 memory_search 工具，可在任意对话中触发全文语义检索，无需离开当前交互界面。该工具基于 FTS5 虚拟表对 MEMORY.md 和 USER.md 的全部内容建立索引，支持关键词、短语及布尔逻辑查询。
1、在 Hermes Agent 会话中输入类似指令：“列出所有关于 Next.js 的记忆条目”。
2、Agent 将自动调用 memory_search 工具，并返回匹配的原始记忆段落（以 § 分隔符为边界）。
3、若需精确匹配，可使用双引号包裹短语，例如：““禁用破折号/分号””。
三、使用 SQLite 命令行直接查询会话数据库中的记忆快照
虽然 MEMORY.md 和 USER.md 是主记忆源，但每次会话启动时，系统会将它们的内容注入到会话元数据中，并写入 ~/.hermes/state.db 的 sessions 表。该数据库可被直接读取，用于验证记忆是否成功加载。
1、运行命令 sqlite3 ~/.hermes/state.db 进入交互式 shell。
2、执行 SQL 查询：SELECT memory_snapshot, user_snapshot FROM sessions ORDER BY created_at DESC LIMIT 1;
3、结果中 memory_snapshot 字段即为当前会话所加载的 MEMORY.md 内容快照（已截断至字符限制），user_snapshot 对应 USER.md 快照。
四、检查配置文件确认记忆功能启用状态
若无法查找到预期的记忆内容，需首先确认记忆系统未被禁用。相关开关由配置文件控制，其启用状态直接影响文件读写与快照注入行为。
1、运行 cat ~/.hermes/config.yaml 查看配置。
2、确认以下字段值均为 true：memory_enabled 与 user_profile_enabled。
3、同时核对 memory_char_limit（默认 2200）与 user_char_limit（默认 1375）是否过小导致内容被截断。
