Hindsight 长期记忆接入 Hermes Desktop3 步在 Settings 里给 Agent 装上跨会话记忆【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsight你的 Agent 是不是每次开新对话都像失忆Hermes Desktop 原生集成了 Hindsight 记忆提供方在Settings面板里选Hindsight、粘贴 API Key、点SaveAgent 就能在每次对话前自动回忆相关记忆、在对话后自动留存关键信息——跨会话、跨设备持续生效。这篇文章全程只用图形界面不需要终端也没接触过 Hindsight 的读者可以直接照着做。1. 快速上手3 步完成 Hindsight 长期记忆配置步骤 1打开 Settings → Memory Context。在Memory Provider下拉框中选择Hindsight。Hermes Desktop 中只有 Hindsight 拥有完整的内置配置面板其余记忆提供方选中后设置区域是空白的。步骤 2填写 Hindsight 专属配置字段。选中后表单立即展开各字段含义见下表字段作用默认值Mode记忆后端在哪Cloud只需 API KeyLocal External连自建实例CloudAPI keyHindsight API 认证凭据只写存储—API URLHindsight 服务地址https://api.hindsight.vectorize.ioBank ID当前 profile 读写哪个记忆库memory bank即隔离的记忆空间hermesRecall budget每轮对话回忆recall从记忆中检索的力度mid步骤 3点击 Save。到 Hindsight Cloud 控制台的 Connect 页面领取 API Keyhsk_开头的令牌粘贴进API key输入框保存即完成。2. 模式怎么选Cloud 与 Local External 对比维度CloudLocal External托管成本零本地不跑任何服务需自己维护 Hindsight 实例Docker、Helm 或裸机数据归属存储、retain记忆写入与 recall 都在 Hindsight 端完成记忆数据完全不出自己的基础设施配置量只粘贴 API Key额外填写API URL如http://localhost:8888适用场景个人用户、团队起步数据主权、隐私合规要求严格的场景选Cloud是最短路径Hindsight Cloud 负责存储、事实抽取与检索你只管把 Key 贴进去。选Local External意味着你已有一套自建的 Hindsight 服务把API URL指过去即可。自建实例可以按项目 README 的方式一条命令拉起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 在http://localhost:9999把 API 地址填进面板即可。也支持pip install hindsight-api的裸机部署和 Helm 的 Kubernetes 部署仓库里另有 docker-compose 示例与 Helm Chart 可参考。3. 关键参数深读Bank ID一间上了锁的独立房间记忆库是完整、隔离的存储单元内部包含记忆facts、文档、实体、实体间关系知识图谱和指令directives。不同 bank 之间完全隔离——bank A 里的记忆在 bank B 中不可见。默认值hermes表示每个 Hermes 配置档案profile默认有自己的记忆空间。这里有个反直觉的设计读取一个不存在的 bank 返回 404而不是空结果。好处是 bank ID 拼错或误删时会显式报错不会静默给你看似正常的零记忆数据。Recall Budget回忆该花多大力气low/mid/high对应 recall 请求的budget参数服务端会把它换算成内部检索的thinking_budget同时作用于语义检索、BM25、知识图谱、时序检索等每条检索通道fixed默认thinking_budget取固定值三档默认100/300/1000可用HINDSIGHT_API_RECALL_BUDGET_FIXED_LOW/MID/HIGH调整adaptivethinking_budget round(max_tokens × 比例)比例默认0.025/0.075/0.25并受HINDSIGHT_API_RECALL_BUDGET_MIN/MAX默认20/2000钳制。直白点说low换低延迟适合轻量对话high换深度回忆适合关键任务mid是默认折中。Hermes 侧它对应HINDSIGHT_RECALL_BUDGET环境变量与recallBudget配置项。API Key只写不回读密钥保存时进入系统密钥存储区secret store属于只写密钥之后不会再被回读进表单。面板上会出现 API key set 徽章表示已配置。这是刻意的设计——密钥不在 UI 层反复传输和展示泄露面更小。看到输入框空了不要慌那是正常的。其余字段Mode、API URL没什么悬念一个决定后端形态一个决定请求发往哪里即 HINDSIGHT_API_URL 语义总表里一句话已覆盖。4. 保存之后发生了什么数据分流落位。API key 进 secret storeMode、API URL、Bank ID、Recall budget写入当前 profile 的配置档案。密钥进密钥库、配置进档案各归其位。每轮对话自动发生两件事。Hindsight 通过 Hermes 的记忆提供方机制挂进 Agent 生命周期pre_llm_call钩子每次 LLM 调用前先向 Hindsight 发起 recall把相关记忆注入上下文——力度由Recall budget决定post_llm_call钩子每轮响应结束后把用户/助手的对话做 retain留存供以后会话使用。模型还能显式调工具。除自动钩子外还注册了三个工具供模型主动调用hindsight_retain写入记忆、hindsight_recall检索记忆、hindsight_reflect基于已有记忆综合出一个答案。记忆随档案漫游。每个 profile 对应一个 Bank ID因此记忆按档案隔离、互不干扰同一份档案换台机器登录记忆跟着走偏好、决策、项目上下文在每次对话中都能被正确回忆。5. 常见坑与排查bank 拼错报 404 而不是返回空这正是隔离语义的预期行为。核对Bank ID与后端实际存在的 bank 一致即可。密钥不回显保存后表单不显示 key、只显示 API key set 徽章属只写设计不是丢失。与内置文件记忆打架Hermes 自带基于MEMORY.md的扁平文件记忆可选还有USER.md档案。两个记忆源同时开着模型可能偏向内置那份。在 CLI 中执行hermes config set memory.memory_enabled false需要时再加hermes config set memory.user_profile_enabled false关掉它。桌面端与 CLI 互切Desktop 面板字段与 CLI 的config.json~/.hermes/hindsight/config.json一一对应——mode、api_url、api_key、bank_id、recallBudget。CLI 侧 API Key 走HINDSIGHT_API_KEY环境变量且环境变量优先级高于配置文件。两边改的都是同一套后端随时可切换。连不上自建实例先跑curl http://localhost:9077/health确认本地守护进程存活再看日志~/.hermes/logs/hindsight-embed.log定位错误。6. 保存后自检清单逐项打勾全部通过即可开始使用Memory Provider已选Hindsight并已点SaveMode与真实部署一致Cloud 只需 KeyLocal External 的API URL已指向自己的实例且可达API key输入框显示 API key set 徽章Bank ID拼写正确错误会 404不会静默变空已关闭 Hermes 内置MEMORY.md记忆避免双源干扰开一轮新对话Agent 能想起上一次会话里的信息到这里Hermes 的长期记忆就在纯图形界面里配完了不碰config.json、不写.env、不开终端跨会话、跨设备的记忆能力即刻生效。【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsight创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考