Hermes记忆系统需五步配置：启用五层目录结构、配置MEMORY.md/USER.md自动加载、激活Honcho用户建模、启用FTS5搜索支持、设置时序衰减策略，缺一不可。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已安装 Hermes Agent，但发现它在多次会话后仍无法持续识别您的任务习惯、输出偏好或身份特征，则说明记忆系统未被正确激活或分层配置存在缺失。以下是配置其记忆系统的具体步骤：
一、启用五层记忆体系并验证目录结构
Hermes 的记忆能力依赖于预设的五层结构（常驻提示、短期会话、长期知识、用户画像、技能经验），这些层级需通过标准目录与文件初始化才能生效。缺失任一核心文件将导致跨会话记忆中断。
1、确认 ~/.hermes/ 目录已存在且可写入。
2、检查是否存在 memories/ 子目录：ls -la ~/.hermes/memories/。
3、若该目录为空或不存在，手动创建并初始化两个必需文件：touch ~/.hermes/memories/MEMORY.md ~/.hermes/memories/USER.md。
4、向 USER.md 写入基础用户标识信息，例如：echo "# 用户画像\n- 偏好格式：Markdown\n- 常用工具：shell, browser, file" > ~/.hermes/memories/USER.md。
二、配置 MEMORY.md 与 USER.md 的自动加载机制
MEMORY.md 和 USER.md 是每次新会话启动时作为“冻结快照”注入上下文的核心记忆文件。若未启用自动加载，Agent 将退化为无状态会话模型，无法实现跨轮次认知延续。
1、编辑主配置文件：nano ~/.hermes/config.yaml。
2、确保 memory 部分包含以下字段：enable: true 与 files: ["memories/MEMORY.md", "memories/USER.md"]。
3、保存后执行：hermes doctor --check memory，确认输出中包含 ✓ Memory files loaded successfully。
三、激活 Honcho 用户建模组件
Honcho 是 Hermes 实现“辩证式用户建模”的关键模块，负责从交互日志中提取任务偏好、决策历史和反馈信号，并持久化至 USER.md。未启用 Honcho 将导致用户画像始终静态，无法随使用演进。
1、确认 Honcho 已安装：pip show honcho；若未安装，运行 pip install honcho。
2、在 ~/.hermes/.env 中添加启用标志：HONCHO_ENABLED=true。
3、重启 Hermes 进程使配置生效：pkill -f "hermes chat"; hermes chat。
4、发送一条测试指令如“请总结我上一次要求你生成的 Shell 脚本风格”，观察是否调用历史记录而非报错。
四、启用 FTS5 全文搜索支持以提升记忆检索效率
默认状态下 Hermes 使用轻量级 BM25 检索，但在记忆文件超过 50KB 后响应延迟明显。FTS5 是 SQLite 内置全文搜索引擎，可实现毫秒级跨文档关键词定位，是支撑大规模记忆调用的技术前提。
1、检查系统是否具备 FTS5 支持：sqlite3 ":memory:" "PRAGMA compile_options;" | grep -i fts5；若有输出则已就绪。
2、若无输出，在 Ubuntu/Debian 上运行：sudo apt-get install sqlite3 libsqlite3-dev；在 macOS 上运行：brew install sqlite3 并确保 PATH 指向新版。
3、强制 Hermes 使用 FTS5 引擎，在 config.yaml 中添加：search_engine: fts5。
4、执行 hermes memory rebuild 重建索引。
五、设置时序衰减策略防止记忆过载
长期积累的记忆若无衰减机制，会导致检索噪声上升、LLM 上下文污染及隐私泄露风险。Hermes 支持基于时间戳的自动衰减，仅保留高价值、高频访问的记忆片段。
1、打开 ~/.hermes/memories/MEMORY.md，确认每条记录末尾包含 ISO8601 时间戳注释，例如：[2026-04-14T15:22:03Z]。
2、在 config.yaml 的 memory 区块下添加衰减参数：decay_enabled: true 与 decay_days: 30（表示30天未被检索的记忆项自动降权）。
3、触发一次主动清理：hermes memory prune --days 30。
4、验证清理结果：hermes memory stats，确认 output 中 active_count 显著低于 total_count。
