Hermes Desktop × Hindsight 长期记忆图形界面接入完整实战指南【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsightHermes Desktop 是 Hermes Agent 的桌面客户端Hindsight 则是让 Agent 记得住事的记忆层。这篇文章讲的是不打开终端、不手写任何配置文件如何全程用图形界面把 Hindsight 长期记忆接进你的 Agent。 Agent 为什么需要长期记忆问题出在会话的边界上。每次新开一个对话Agent 对上一轮聊过的偏好、做过的决定、项目背景一无所知。你上周告诉过它我们统一用 pnpm不要用 npm这周它照样按 npm 给建议。上下文随着会话结束被切断这就是 Agent 最基础的体验断层。长期记忆提供方就是为了解决这个断层而存在的在每次调用模型之前先查一遍与当前话题相关的历史记忆注入上下文在每次响应之后把对话中的关键信息沉淀下来。Hindsight 就是这样一个记忆提供方而 Hermes 对它的支持是原生的——不需要额外安装插件Hermes Desktop 的 Settings 里直接提供了完整的配置面板。 Hindsight 连接模式怎么选在碰配置面板之前先定一件事记忆数据放在哪里。Hermes Desktop 的 Hindsight 面板只有两种模式对应两类典型场景维度CloudLocal External适用场景个人用户、团队起步零基础设施已有自托管实例Docker / Kubernetes对数据主权有严格要求数据存放位置Hindsight Cloud 托管端你自己的基础设施记忆数据不离开本地环境需要提供什么一个 API Key自建实例的 API URL成本有免费额度无需运维自己负责实例的部署与维护拿不准就选 Cloud注册后从 Hindsight Cloud 控制台的 Connect 页面拿到 API Key形如hsk_开头的令牌粘贴即可用。如果数据必须留在自己手里再走 Local External。⚙️ 在设置面板里一次配完 Hindsight打开 Hermes Desktop进入Settings → Memory Context。在Memory Provider下拉框里选择Hindsight。这里有个细节Hindsight 是下拉框中唯一会展开完整表单的记忆提供方选其他选项时该区域保持空白。所以一旦表单出现了说明你选对了。选中后专属配置面板立即展开包含五个字段Mode连接模式、API key、API URL、Bank ID记忆库 ID可理解为 Agent 读写的一个独立记忆空间、Recall budget回忆投入强度决定每轮对话检索历史的力度。按你选好的模式填。Cloud 模式下保持 API URL 默认值把 Connect 页面拿到的 Key 粘进API key表单即可Local External 模式则把API URL改成你自建实例的地址例如http://localhost:8888。Bank ID 和 Recall budget 有合理的默认值不改也能用。填完点击Save——到这一步Hermes 就获得了持久化的长期记忆全程没有碰过终端。 Hindsight 配置字段速查表字段默认值什么时候需要改它ModeCloud已有自建 Hindsight 实例改选Local ExternalAPI key无必填两种模式都需要首次配置时填写一次API URLhttps://api.hindsight.vectorize.ioLocal External 模式下改为自建实例地址Bank IDhermes想让某个 Hermes 档案使用独立记忆空间时Recall budgetmid对延迟或召回深度有明确倾向时Recall budget 三档的一句话建议low给追求低延迟的轻量对话mid兼顾速度与效果是默认的中庸选择high留给需要深度回忆上下文的关键任务。服务端视角下它控制的是每条检索通道语义、BM25、知识图谱、时序的检索深度fixed函数下三档默认对应100/300/1000的检索量adaptive函数下则按请求输出 token 预算按比例伸缩。 保存之后后台发生了什么设置保存下去的这一刻各字段被分流到了各自该在的位置API key写入密钥存储区secret store。它是只写密钥——保存后不会再被回读进表单面板上只会显示一个 API key set 徽章告诉你已完成配置。密钥因此不会在 UI 层反复传输与展示。Mode、API URL、Bank ID、Recall budget写入当前 Hermes 档案profile的配置。记忆库的隔离性由存储模型保证一个 bank 是完整的隔离存储单元内部包含记忆事实、文档、实体、实体间关系知识图谱与指令不同 bank 之间完全不可见。而且读取一个不存在的 bank 会显式返回404而不是悄悄给你一份空数据——拼错 bank ID 时你能立刻知道不会被看似健康的空结果误导。档案与 bank 是绑定关系每个 Hermes 档案指向一个 Bank ID。于是记忆按档案隔离、互不干扰又随档案漫游——同一份档案在哪台机器上运行记忆就跟到哪台机器上。保存生效后Hindsight 通过 Hermes 的生命周期钩子hook可理解为挂在 Agent 运行流程上的自动触发器接入对话全过程pre_llm_call自动回忆。每次调用 LLM 之前查询 Hindsight把相关记忆注入上下文力度由 Recall budget 决定。post_llm_call自动留存。每次响应之后把用户与助手的对话存入 Hindsight。三个可被模型显式调用的工具hindsight_retain写记忆、hindsight_recall查记忆、hindsight_reflect基于已存记忆做综合回答。 验证与排障本地实例怎么查自建实例最省事的起法是一条 Docker 命令取自仓库 README 的快速开始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。几个常用的排查入口健康检查curl http://localhost:8888/health确认自建实例存活Hermes 本地内嵌守护进程则查curl http://localhost:9077/health。日志Hermes 本地守护进程的启动日志在~/.hermes/logs/hindsight-embed.log。遇到 404大概率是 Bank ID 拼错、改名或删除了。回到面板核对 Bank ID或先在服务端确认该 bank 存在。双记忆源干扰Hermes 自带基于MEMORY.md的扁平文件记忆与 Hindsight 同时开启时模型可能更偏向前者。建议在 CLI 中执行hermes config set memory.memory_enabled false可选再加hermes config set memory.user_profile_enabled false把它关掉。 下一步Hindsight Cloud免费从控制台 Connect 页面获取 API Key回到 Desktop 面板粘贴即可零基础设施成本。CLI / 网关场景偏好命令行、或以 CLI 和 gatewayTelegram、Discord、Slack 等多平台网关方式运行 Hermes 的话完整参考 Hermes Agent 集成文档——包含hermes memory setup向导、全量配置项与故障排查。自托管需要 Docker Compose 部署或 Kubernetes 部署时看仓库里的 docker/docker-compose 示例与 helm/hindsight Chartbank 的隔离模型细节可查 Memory Banks 文档。整条路径就四步Settings → Memory Context 选 Hindsight → Cloud 模式粘上 API Key → 保存。从这一刻起Agent 的记忆跨会话、跨设备持续存在而你没有写过一行配置。【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsight创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Hermes Desktop × Hindsight 长期记忆：图形界面接入完整实战指南
Hermes Desktop × Hindsight 长期记忆图形界面接入完整实战指南【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsightHermes Desktop 是 Hermes Agent 的桌面客户端Hindsight 则是让 Agent 记得住事的记忆层。这篇文章讲的是不打开终端、不手写任何配置文件如何全程用图形界面把 Hindsight 长期记忆接进你的 Agent。 Agent 为什么需要长期记忆问题出在会话的边界上。每次新开一个对话Agent 对上一轮聊过的偏好、做过的决定、项目背景一无所知。你上周告诉过它我们统一用 pnpm不要用 npm这周它照样按 npm 给建议。上下文随着会话结束被切断这就是 Agent 最基础的体验断层。长期记忆提供方就是为了解决这个断层而存在的在每次调用模型之前先查一遍与当前话题相关的历史记忆注入上下文在每次响应之后把对话中的关键信息沉淀下来。Hindsight 就是这样一个记忆提供方而 Hermes 对它的支持是原生的——不需要额外安装插件Hermes Desktop 的 Settings 里直接提供了完整的配置面板。 Hindsight 连接模式怎么选在碰配置面板之前先定一件事记忆数据放在哪里。Hermes Desktop 的 Hindsight 面板只有两种模式对应两类典型场景维度CloudLocal External适用场景个人用户、团队起步零基础设施已有自托管实例Docker / Kubernetes对数据主权有严格要求数据存放位置Hindsight Cloud 托管端你自己的基础设施记忆数据不离开本地环境需要提供什么一个 API Key自建实例的 API URL成本有免费额度无需运维自己负责实例的部署与维护拿不准就选 Cloud注册后从 Hindsight Cloud 控制台的 Connect 页面拿到 API Key形如hsk_开头的令牌粘贴即可用。如果数据必须留在自己手里再走 Local External。⚙️ 在设置面板里一次配完 Hindsight打开 Hermes Desktop进入Settings → Memory Context。在Memory Provider下拉框里选择Hindsight。这里有个细节Hindsight 是下拉框中唯一会展开完整表单的记忆提供方选其他选项时该区域保持空白。所以一旦表单出现了说明你选对了。选中后专属配置面板立即展开包含五个字段Mode连接模式、API key、API URL、Bank ID记忆库 ID可理解为 Agent 读写的一个独立记忆空间、Recall budget回忆投入强度决定每轮对话检索历史的力度。按你选好的模式填。Cloud 模式下保持 API URL 默认值把 Connect 页面拿到的 Key 粘进API key表单即可Local External 模式则把API URL改成你自建实例的地址例如http://localhost:8888。Bank ID 和 Recall budget 有合理的默认值不改也能用。填完点击Save——到这一步Hermes 就获得了持久化的长期记忆全程没有碰过终端。 Hindsight 配置字段速查表字段默认值什么时候需要改它ModeCloud已有自建 Hindsight 实例改选Local ExternalAPI key无必填两种模式都需要首次配置时填写一次API URLhttps://api.hindsight.vectorize.ioLocal External 模式下改为自建实例地址Bank IDhermes想让某个 Hermes 档案使用独立记忆空间时Recall budgetmid对延迟或召回深度有明确倾向时Recall budget 三档的一句话建议low给追求低延迟的轻量对话mid兼顾速度与效果是默认的中庸选择high留给需要深度回忆上下文的关键任务。服务端视角下它控制的是每条检索通道语义、BM25、知识图谱、时序的检索深度fixed函数下三档默认对应100/300/1000的检索量adaptive函数下则按请求输出 token 预算按比例伸缩。 保存之后后台发生了什么设置保存下去的这一刻各字段被分流到了各自该在的位置API key写入密钥存储区secret store。它是只写密钥——保存后不会再被回读进表单面板上只会显示一个 API key set 徽章告诉你已完成配置。密钥因此不会在 UI 层反复传输与展示。Mode、API URL、Bank ID、Recall budget写入当前 Hermes 档案profile的配置。记忆库的隔离性由存储模型保证一个 bank 是完整的隔离存储单元内部包含记忆事实、文档、实体、实体间关系知识图谱与指令不同 bank 之间完全不可见。而且读取一个不存在的 bank 会显式返回404而不是悄悄给你一份空数据——拼错 bank ID 时你能立刻知道不会被看似健康的空结果误导。档案与 bank 是绑定关系每个 Hermes 档案指向一个 Bank ID。于是记忆按档案隔离、互不干扰又随档案漫游——同一份档案在哪台机器上运行记忆就跟到哪台机器上。保存生效后Hindsight 通过 Hermes 的生命周期钩子hook可理解为挂在 Agent 运行流程上的自动触发器接入对话全过程pre_llm_call自动回忆。每次调用 LLM 之前查询 Hindsight把相关记忆注入上下文力度由 Recall budget 决定。post_llm_call自动留存。每次响应之后把用户与助手的对话存入 Hindsight。三个可被模型显式调用的工具hindsight_retain写记忆、hindsight_recall查记忆、hindsight_reflect基于已存记忆做综合回答。 验证与排障本地实例怎么查自建实例最省事的起法是一条 Docker 命令取自仓库 README 的快速开始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。几个常用的排查入口健康检查curl http://localhost:8888/health确认自建实例存活Hermes 本地内嵌守护进程则查curl http://localhost:9077/health。日志Hermes 本地守护进程的启动日志在~/.hermes/logs/hindsight-embed.log。遇到 404大概率是 Bank ID 拼错、改名或删除了。回到面板核对 Bank ID或先在服务端确认该 bank 存在。双记忆源干扰Hermes 自带基于MEMORY.md的扁平文件记忆与 Hindsight 同时开启时模型可能更偏向前者。建议在 CLI 中执行hermes config set memory.memory_enabled false可选再加hermes config set memory.user_profile_enabled false把它关掉。 下一步Hindsight Cloud免费从控制台 Connect 页面获取 API Key回到 Desktop 面板粘贴即可零基础设施成本。CLI / 网关场景偏好命令行、或以 CLI 和 gatewayTelegram、Discord、Slack 等多平台网关方式运行 Hermes 的话完整参考 Hermes Agent 集成文档——包含hermes memory setup向导、全量配置项与故障排查。自托管需要 Docker Compose 部署或 Kubernetes 部署时看仓库里的 docker/docker-compose 示例与 helm/hindsight Chartbank 的隔离模型细节可查 Memory Banks 文档。整条路径就四步Settings → Memory Context 选 Hindsight → Cloud 模式粘上 API Key → 保存。从这一刻起Agent 的记忆跨会话、跨设备持续存在而你没有写过一行配置。【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsight创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考