Hermes Desktop 接入 Hindsight 长期记忆配置指南【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsightHermes Desktop 可以直接把 Hindsight 设为 Agent 的长期记忆提供方在 Settings 中选定模式、粘贴 API Key、保存Agent 即获得跨会话、跨设备的持久记忆全程不碰终端和配置文件。本文按 Cloud 与 Local External 两种部署形态带你完成 Hermes 桌面端记忆配置并讲清记忆在底层的存储与隔离方式。Agent 每次重开会话都要重新交代背景用过 Agent 的人都熟悉这个场景上周定下的技术选型、用户的固定偏好、项目的上下文约束新会话一开就全部丢失只能反复粘贴背景。Hermes 内置的MEMORY.md扁平文件能记一点但容量与结构都很有限谈不上检索。Hindsight 是为此设计的 Agent 记忆层它把对话中的事实抽取、归档成记忆并在需要时按相关性召回。接入 Hermes Desktop 后Agent 会在每次 LLM 调用前自动回忆、每次响应后自动留存对应pre_llm_call与post_llm_call钩子同时还能通过hindsight_retain/hindsight_recall/hindsight_reflect三个工具显式读写记忆。Settings 里挑一个 Hindsight配置面板自动出现Hermes 桌面端的记忆提供方是可插拔的打开Settings → Memory Context在Memory Provider下拉框中选择Hindsight。有个细节值得一提下拉框里其他记忆提供方选中后设置区域是空白的只有 Hindsight 会渲染出完整的配置表单。也就是说Hermes 桌面端记忆提供方配置中唯一不需要离开应用就能做完的就是它。Cloud 与 Local External两条部署形态各自怎么配Cloud粘贴一个 API Key 即可选Cloud后面板里真正需要动手的只有一个字段从 Hindsight Cloud 控制台的 Connect 页面复制形如hsk_开头的 API Key粘进表单。该密钥以只写write-only方式存入密钥存储区保存后不会回读进表单面板显示 API key set 徽章即代表设置完成。API URL保持默认值https://api.hindsight.vectorize.io不用动。Cloud 模式下存储、事实抽取、检索全部由托管端完成本地不跑任何服务——对绝大多数个人用户这是成本最低的 Agent 长期记忆接入方式。面板里另外两个字段在两种模式下含义一致Bank ID指定当前 Hermes 配置档案profile读写哪个记忆库memory bank默认hermesRecall budget控制每轮对话 recall 的检索投入强度分low/mid/high三档默认mid。它最终映射为服务端各检索通道语义、BM25、知识图谱、时序的 thinking_budget 数值档位越高检索越深、延迟也越高服务端的各档默认值与上下限可在 Configuration 配置文档中查到并调整。Local External把 API URL 指向自建实例如果数据必须留在自己的基础设施里选Local External把API URL改为你实例的地址如http://localhost:8888再填入对应实例的 API Key。Hindsight Cloud 与 Local External 模式共用同一套配置面板切换只改两个字段。若你还没有自建实例可参考这条 Docker 命令快速拉起一个export OPENAI_API_KEYsk-xxx docker run -it --pull always --name hindsight --restart unless-stopped -p 8888:8888 -p 9999:9999 \ -e HINDSIGHT_API_LLM_API_KEY$OPENAI_API_KEY \ -v hindsight-data:/home/hindsight/.pg0 \ ghcr.io/vectorize-io/hindsight:latest启动后 API 在http://localhost:8888UI 在 9999 端口把地址填进面板即可。更完整的编排方式可参考仓库中的 docker-compose 部署示例 与 Helm Chart。保存之后各字段去了哪里点击 Save 后API key写入系统密钥存储区永不回读进表单Mode、API URL、Bank ID、Recall budget写入当前 Hermes 配置档案profile config。这套分流与 CLI 场景是同一套语义——CLI 里 API Key 走HINDSIGHT_API_KEY环境变量优先级高于配置文件其余设置落在~/.hermes/hindsight/config.json桌面面板只是把这些操作封装成了图形界面两种方式可随意切换字段一一对应mode、api_url、api_key、bank_id、recallBudget。Bank ID 决定了 memory bank 隔离的粒度。记忆库是 Hindsight 中完整、隔离的存储单元内部包含事实、文档、实体与实体关系知识图谱以及指令不同 bank 之间互不可见读取一个不存在的 bank 会直接返回 404 而不是空结果——bank ID 拼错时你能立刻发现而不是拿到一份看似健康的空记忆。由于每个 profile 只指向一个 Bank IDHermes 跨会话记忆同时得到两层好处不同用途的档案各用各的记忆库互不串扰同一档案在哪台机器上运行记忆就跟到哪台机器上。确认记忆生效以及两个容易踩的坑配置完成后开一个新会话直接问 Agent 一个上一会话里提过的事实比如我们之前定的技术栈是什么。如果上下文被正确注入它会直接给出答案而不需要你再交代一遍。⚠️ 两个注意点其一如果同时启用了 Hermes 内置的MEMORY.md文件记忆两个记忆源可能互相干扰建议用hermes config set memory.memory_enabled false将其关闭其二Recall budget 不必一开始就拉满日常对话用默认mid即可深度任务再临时切到high。更完整的字段参考与故障排查如检查本地守护进程、查看日志见 Hermes Agent 集成文档 与 Configuration 配置文档。现在就去 Hindsight Cloud 控制台注册、复制你的 API Key回到 Settings 粘贴保存即可。【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsight创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考