必须手动启用持久化存储、配置外部记忆引擎、打通模型级记忆参数，三者缺一不可；需初始化memory.md和user.md文件并设644权限，运行hermes memory setup选择local embedded模式，配置llm信息后修改config.yaml启用hindsight并设hybrid检索策略，最后通过跨会话测试、rebuild命令或memory list验证生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你每天跟Hermes Agent聊项目、设偏好、改格式，但它第二天就忘得一干二净——这不是它懒，是长期记忆根本没开。必须手动启用持久化存储、配置外部记忆引擎、打通模型级记忆参数，三者缺一不可。
确认并初始化本地记忆文件
MEMORY.md 和 USER.md 是 Hermes 的“温记忆”基座，缺失或权限错误会导致所有后续配置失效。
进入 Hermes 配置目录：cd ~/.hermes
检查两个核心文件是否存在且可写：ls -l MEMORY.md USER.md。若任一文件缺失，立即创建：touch MEMORY.md USER.md
【必须执行 chmod 644 MEMORY.md USER.md】。权限不对（比如755）会导致 Hermes 进程无法写入，记忆条目看似保存成功，实则静默丢弃。
用编辑器打开 MEMORY.md，写入至少一条带 § 符号的规范条目，例如：§ 我的主力输出风格是技术严谨但口语化。空文件无法触发记忆加载机制。
启用 Hindsight 外部记忆引擎
Hindsight 是 Hermes 官方推荐的结构化长期记忆方案，适合需要自动抽取、分层管理、语义检索的重度用户。
运行交互式配置向导：hermes memory setup
在 Provider 列表中选择 hindsight - API key/local → 选择部署模式为 Local Embedded（本地嵌入式，数据不出设备）
输入 LLM 接入信息：Endpoint URL 填 https://api.deepseek.com，Model name 填 deepseek-v4-flash，粘贴你的 DeepSeek API Key
配置完成后，hermes memory list 应显示 Provider: hindsight 且状态为 active。若显示 disabled，说明配置未生效，需重跑 setup 并确认每步回车确认。
修改 config.yaml 激活关键参数
这是最易被跳过的一步——光装了 Hindsight，不改 config.yaml，它永远不会启动。
用编辑器打开 ~/.hermes/config.yaml，定位到 hindsight: 区块，确保包含以下四行：
hindsight:
enabled: true
bank: hermes
provider: openrouter
同时，在 memory: 区块下，将 retrieval_strategy: 的值从 keyword 改为 hybrid，并添加 vector_db_path: "./memory/vector_index"
保存后执行 hermes restart。重启后检查日志，必须看到 Loaded Hindsight provider 和 Hybrid retrieval initialized 两行提示，否则配置未载入。
验证长期记忆是否真正生效
方法一：跨会话测试
第一步：启动新会话，发送指令 记住：我的邮箱是 dev@liangge.ai
第二步：退出 CLI，等待 3 分钟以上，再运行 hermes 进入新会话
第三步：直接问 我的邮箱是什么？。若返回正确邮箱，说明长期记忆链路通了
方法二：强制索引重建
执行 hermes memory rebuild --force。该命令会扫描全部历史对话，用 Hindsight 提取关键事实并写入向量库。首次运行耗时约 2–5 分钟，期间不要中断终端。
方法三：检查记忆条目
运行 hermes memory list --limit 5。输出中应出现带 tag: user-preference 或 tag: project-decision 的条目，且 created_at 时间戳为当前分钟内——这证明新记忆正在实时写入。
