Hermes Desktop 接入 Hindsight 长期记忆：3 步配好 API Key，Agent 即刻拥有跨会话记忆
【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsight
Hindsight 为 Hermes Desktop 桌面应用提供长期记忆能力：在 Settings 中选择 Hindsight 作为记忆提供方，粘贴 API Key 并保存，Agent 即可自动回忆、自动留存，全程零终端操作。
启用 Hindsight 后的实际体验
保存配置后，Hermes 会在每次模型调用前自动查询记忆库（memory bank）并把相关事实注入上下文，在每轮对话结束后自动把用户与助手的对话写入 Hindsight。再配合hindsight_retain/hindsight_recall/hindsight_reflect三个可显式调用的工具，Agent 获得的是跨会话、跨设备持续的持久记忆——上周讨论过的项目偏好、技术选型，这周直接复用，无需重新交代背景。
3 步跑通桌面端 Hindsight 配置
整个流程在应用内完成，不需要打开终端，也没有其他记忆提供方会展开的额外字段。
1. 打开 Settings → Memory & Context。在Memory Provider下拉框中选择Hindsight，只有 Hindsight 会渲染出完整的专属配置表单。
2. 粘贴 API Key。面板提供Mode、API key、API URL、Bank ID、Recall budget五个字段，Cloud 模式下只需填写API key，其余保持默认即可。
3. 点击 Save。面板出现 "API key set" 徽章即配置完成。
Hindsight 配置选项速查表
| 字段 | 作用 | 默认值 | 一句话说明 |
|---|---|---|---|
| Mode | 连接模式 | Cloud | 二选一：托管服务或自建实例 |
| API key | 认证凭据 | — | 以只写密钥存储，保存后不回读 |
| API URL | 服务地址 | https://api.hindsight.vectorize.io | 所有记忆读写请求的落点，自托管时改成自己的地址 |
| Bank ID | 记忆库（memory bank）名称 | hermes | 决定该档案读写哪个完全隔离的记忆空间 |
| Recall budget | 回忆强度 | mid | low / mid / high，控制每轮检索的投入力度 |
API Key 怎么填
Key 从 Hindsight Cloud 控制台的 Connect 页面获取，形如hsk_开头的令牌。它属于只写（write-only）密钥：保存后进入系统密钥存储区（secret store），不会再被回读进表单，面板只显示 "API key set" 徽章，以此缩小密钥的暴露面。
Recall budget 高低有什么区别
该值对应 Hermes 侧HINDSIGHT_RECALL_BUDGET环境变量，服务端把low/mid/high映射为100/300/1000的检索预算，同时作用于语义检索、BM25、知识图谱、时序检索等每一条检索通道（详见 Memory Banks 文档）。日常轻量对话选low换低延迟，需要深度回忆的关键任务选high。
Cloud 与 Local External 连接方式怎么选
场景决定选择，对照即可：
| 场景 | 推荐模式 | 要点 |
|---|---|---|
| 个人用户 / 团队起步 | Cloud | 粘贴 Key 即用，零基础设施成本 |
| 数据不出内网 / 合规要求 | Local External | API URL指向自建实例，记忆不离开自己的基础设施 |
选Cloud：从控制台 Connect 页面拿 Key 粘贴进面板即可，存储、事实抽取与检索全部由 Hindsight 托管，本地不跑任何服务。
选Local External：先起一个自建实例，最短启动命令如下：
docker run -it --pull always --name hindsight --restart unless-stopped -p 8888:8888 \ -e HINDSIGHT_API_LLM_API_KEY=$OPENAI_API_KEY \ -v hindsight-data:/home/hindsight/.pg0 \ ghcr.io/vectorize-io/hindsight:latest启动后把面板的API URL改为http://localhost:8888并保存。更多部署形态见 Docker 部署示例 与 Helm Chart。
保存后密钥和配置存在哪里
- API key：写入系统密钥存储区，永不回读进表单，面板仅显示 "API key set" 徽章。
- Mode、API URL、Bank ID、Recall budget：写入当前 Hermes 配置档案（profile config）。
- 记忆按档案隔离：每个档案指向一个Bank ID，不同档案读写各自的记忆库，互不可见。
- 记忆随档案漫游：同一档案运行在哪台设备上，记忆就跟到哪台设备，多设备间全局一致。
- 读取不存在的 bank 会返回 404 而非空结果，拼错或误删 ID 时能立刻发现，而不是静默返回空数据。
两个动作验证记忆已生效
- 保存后在面板确认出现 "API key set" 徽章，说明密钥已正确进入密钥存储区。
- 新开一轮对话，追问上一轮聊过的内容（例如"我之前让你记住的偏好是什么"）：Agent 能直接引用历史记录，说明自动回忆与自动留存两条链路都已打通。
命令行用户还可以运行hermes memory status做交叉确认。
最短路径回顾：打开 Settings → Memory & Context，选择 Hindsight，粘贴 API Key，保存——桌面端长期记忆就此上线。延伸阅读：Hermes Desktop 集成文档、Hermes Agent 集成文档、自托管快速开始。
【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsight
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
