3 分钟,给 Hermes Desktop 装上 Hindsight 完整长期记忆
【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsight
在 Hermes Desktop 里做一次图形化配置,Hindsight 就能成为你的 Agent 的长期记忆后端:选个模式、贴上密钥、保存,跨会话的记忆立刻生效,全程不用碰终端。
Agent 每次新开对话就失忆,怎么办?
每个新会话里,Agent 都不记得你上次聊过的项目、做过的决定、说过的偏好,你只能一遍遍重述。Hindsight 解决的就是这件事:对话开始前,它自动翻出相关记忆塞进上下文;对话结束后,再把关键内容存下来。接上之后,Hermes 从"一次性对话工具"变成"记得住事"的搭档。
3 分钟接上:不用终端的图形化配置
打开 Hermes Desktop 的 Settings → Memory & Context,在 Memory Provider 下拉框里选 Hindsight。它是这里唯一带完整设置面板的记忆提供方——选其他提供方时设置区是空白的,选 Hindsight 则立刻展开一张配置表单。选 Cloud 模式,把密钥粘进 API key 一栏,点 Save。不用打开终端,不用改 config.json,更不用手写 .env 文件。
什么时候选 Cloud、什么时候自托管?
| 模式 | 需要什么 | 数据落在哪 | 适合谁 |
|---|---|---|---|
| Cloud | 一个 API Key | Hindsight 托管服务 | 个人用户、想快速起步的团队 |
| Local External | 自建实例 + 改 API URL | 你自己的基础设施 | 数据主权、合规要求高的场景 |
一句话判据:数据可以上云就选 Cloud,数据必须留在自己机器上就选 Local External。Cloud 模式下,存储、事实抽取、检索全由托管端代劳,你本地一个服务都不用跑。Local External 则要求你先把自己的 Hindsight 实例跑起来(Docker、pip 或 Helm 都行),再把 API URL 指过去,比如http://localhost:8888。
面板上填的每一项
| 字段 | 默认值 | 作用 | 常见坑 |
|---|---|---|---|
| Mode | Cloud | 选托管服务还是自建实例 | 切到 Local External 后忘了同步改 API URL |
| API key | 无 | Hindsight API 认证凭据 | 保存后不再回显,只能看到已设置徽章 |
| API URL | https://api.hindsight.vectorize.io | 所有 retain / recall 请求的目的地 | 自建模式下仍指向云端,白忙一场 |
| Bank ID | hermes | 本档案读写的记忆库 | 写错直接 404,不会拿空结果糊弄你 |
| Recall budget | mid | 每轮对话回忆的投入档位 | 一味拉 high,响应会变慢 |
⚠️ 两个值得留意的点。其一,API Key 只写不回读:存进密钥存储区之后,表单再也不会把它显示出来,面板上只给你一枚 "API key set" 徽章——这是刻意设计,少一层泄露面。其二,Bank ID 指向一个不存在的记忆库时,接口返回 404 而不是空列表,拼写错误当场暴露,不会假装一切正常。
保存之后,后台发生了什么
先说数据流向。点下 Save 的那一刻,API Key 被单独送进系统的密钥存储区,只写不可读;Mode、API URL、Bank ID、Recall budget 则写进当前 Hermes 配置档案(profile config)。换句话说,密钥进保险箱,普通配置进档案袋,各归其位。每个档案对应一个 Bank ID,也就是一个记忆库。记忆库好比每个 Agent 一本独立的笔记本,本子和本子之间互相看不见;档案运行到哪台机器,这本笔记本就跟到哪台机器,记忆始终全局一致。CLI 与桌面端共用同一套字段,环境变量还能覆盖配置文件里的值,所以你随时可以两种方式来回切,记忆后端不用动。
再说运行机制。每轮 LLM 调用之前,pre_llm_call钩子自动发起回忆,把相关记忆注入上下文;响应结束后,post_llm_call钩子自动留存这轮对话。另外还注册了三个显式工具:hindsight_retain写记忆、hindsight_recall查记忆、hindsight_reflect基于已有记忆做综合回答。自动回忆的用力程度,就由 Recall budget 那一项说了算。
❓ 你可能想问的问题
API Key 去哪儿领?注册 Hindsight Cloud(免费),在控制台的 Connect 页面即可拿到hsk_开头的令牌,粘进面板即用。
自建实例怎么起?最常见的姿势是 Docker:
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:8888,UI 在http://localhost:9999,把前者填进面板就行。pip 安装hindsight-api裸跑、Helm 上 Kubernetes 也都是现成路径,见 README 的快速开始。
Recall budget 怎么选?低延迟闲聊用 low,需要深挖历史的关键任务上 high,拿不准就留在默认的 mid。它决定服务端每一路检索的投入强度,不是越高越好。
和 Hermes 内置的 MEMORY.md 会打架吗?会。两个记忆源同时开着,模型可能优先用旧的。在 CLI 里执行hermes config set memory.memory_enabled false,需要的话再关掉 user profile 存储,双源冲突就消了。
回顾一遍:打开 Settings → Memory & Context,选 Hindsight,Cloud 模式粘上 Key,保存——跨会话、跨设备的长期记忆就此到位。更多细节看 Hermes Desktop 集成文档、Hermes Agent 集成文档 和 README 快速开始。
【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsight
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考