零终端搞定 Hermes Desktop 长期记忆：Hindsight 完整配置指南

零终端搞定 Hermes Desktop 长期记忆Hindsight 完整配置指南【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsight你跟 Agent 聊了三天项目它第四天又问你在做什么项目上下文窗口装不下的东西Agent 一翻篇就忘——这是几乎所有 Agent 的通病。Hermes Desktop 的解法是接入 Hindsight 长期记忆而它的配置门槛低到纯点鼠标设置面板里选中 Hindsight、挑一种连接模式、填上几个字段、保存Agent 就开始跨会话记事了全程不用打开终端也不用手写config.json或.env。这篇先帮你把云端还是自建这道选择题做完再带你走一遍最短的配置路径最后把记忆存在哪、为什么会想不起来这些底层问题一次讲透。 先做选择题记忆放云端还是留在自己机器上面板里只有两个模式但它们对应两种完全不同的部署姿态。动字段之前先想清楚一个事你愿不愿意托管一份基础设施Cloud最省事的一档适合绝大多数个人用户和刚起步的团队。选它之后你唯一要做的事就是准备一把钥匙——登录 Hindsight Cloud 控制台在 Connect 页面领一把hsk_开头的令牌。存储、事实抽取retain、检索recall全部发生在云端本地不跑任何服务零基础设施成本直接拿到完整的记忆能力。Local External数据一步不离开你的机房如果你已经在 Docker 或 Kubernetes 上跑了自己的 Hindsight 实例选这个模式把 API URL 指向实例地址比如http://localhost:8888即可。此时记忆数据完全留在你自己的基础设施里专门服务数据主权、隐私合规这类硬性要求。手上还没有实例一条命令就能拉起一个标准服务端形态API 在http://localhost:8888UI 在http://localhost:9999export 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起来后把http://localhost:8888填进面板就完事。想要更多形态裸机可以用pip install hindsight-api部署Kubernetes 场景仓库里备有 Helm Chart各种组合玩法见 docker-compose 示例。⚡ 最短路径在设置面板里配完 Hindsight 长期记忆模式定了接下来的操作路径是固定的Settings → Memory Context在Memory Provider下拉框里挑Hindsight。这里有个值得留意的设计Hindsight 是整个应用中唯一自带完整内置配置面板的记忆提供方——下拉框里选别的提供方设置区域是空白的选 Hindsight 才会展开一整张配置表单。没碰过终端的用户到这里也完全跟得上。选中的瞬间专属表单自动铺开一共五个字段下面逐个说清楚每个字段在管什么Mode连接模式Cloud和Local External二选一决定记忆后端是托管服务还是自建实例默认Cloud对应上一节的选择题。API keyHindsight API 的身份凭据。注意它的特殊待遇——保存动作会把它推进密钥存储区secret store可以理解成系统级的保险箱落库属于只写密钥存完之后不再被回读进表单面板上只留一枚 API key set 徽章告诉你已就位。密钥不在 UI 里反复流转泄露面自然更小。API URLHindsight 的访问端点默认https://api.hindsight.vectorize.io走 Local External 时换成你的实例地址。它的语义等同于服务端的HINDSIGHT_API_URL——客户端所有 retain / recall / reflect 请求都发往这里。Bank ID指定当前 Hermes 配置档案profile读写哪个记忆库memory bank即一个完整、彼此隔离的存储单元。默认值是hermes。Recall budget每轮对话里回忆这件事的投入强度low/mid/high三档默认mid。它对应 Hermes 侧的HINDSIGHT_RECALL_BUDGET环境变量和recallBudget配置项具体机制放后面细讲。填完点Save。到此为止Hermes 就已经拥有持久化的长期记忆了。 你填的值去了哪密钥和配置各进各的门保存按钮按下后字段们会自动流转到各自该待的地方你不需要关心落盘细节但知道一下更安心API key→ 进系统密钥存储区永不回读进表单所以你会看到 API key set 徽章而看不到密钥本身。Mode、API URL、Bank ID、Recall budget→ 写进当前 Hermes 配置档案的 profile config。这套密钥进保险箱、配置进档案的分流和命令行场景是同一套逻辑CLI 里跑hermes memory setup向导或者手维护~/.hermes/hindsight/config.jsonAPI Key 走HINDSIGHT_API_KEY环境变量注入环境变量优先级高于配置文件。桌面面板只是把这一串动作全打包成了图形界面。两边的配置项一一对应mode、api_url、api_key、bank_id、recallBudget你随时可以在两种配置方式之间来回切换记忆后端不用动一根头发。再往下追一层每个配置档案profile只指向一个 Bank ID这带来两个直接后果——记忆按档案隔离不同用途、不同身份的 Hermes 档案各读各的记忆库互不串味记忆随档案漫游这个档案跑在哪台机器上记忆就跟着出现在哪台机器上。换句话说同一份档案在多设备间使用时Agent 的记忆全局一致、跨会话持续你的偏好、做过的决策、项目上下文都会在每次对话中被正确想起来。而 Bank 这个存储单元本身装着什么记忆facts、文档、实体、实体之间的关系也就是知识图谱还有指令directives。不同 bank 之间完全隔离——bank A 里的记忆在 bank B 里不可见。另外有个保护性设计值得知道读取一个不存在的 bank 会直接404而不是返回空列表。这样 bank ID 拼错或误删时你会被显式报错拦住而不是拿到一份看起来很健康的空数据。 保存之后Agent 是怎么自动想起来的配置生效后Hindsight 挂在 Hermes 原生的记忆提供方机制上自动接管 Agent 的对话生命周期pre_llm_call钩子每次 LLM 调用之前先查一遍 Hindsight把相关记忆塞进上下文——这就是自动回忆post_llm_call钩子每次响应结束后把用户与助手的对话存回 Hindsight——这就是自动留存三个显式工具hindsight_retain/hindsight_recall/hindsight_reflect分别对应模型主动发起的记忆写入、检索和综合想查什么、记什么由模型自己决定。自动回忆的力度就由 Recall budget 说了算。Recall budget 三档到底差在哪recall 请求里的budget参数在服务端会被换算成一个thinking_budget整数同时作用于语义检索、BM25、知识图谱、时序检索等每一条检索通道。换算规则有两档fixed默认thinking_budget直接取固定值low/mid/high对应服务端默认的100/300/1000想调可以改HINDSIGHT_API_RECALL_BUDGET_FIXED_LOW/MID/HIGHadaptive按公式thinking_budget round(max_tokens × 比例)算三档比例默认0.025/0.075/0.25检索广度跟着请求的输出 token 预算伸缩再被HINDSIGHT_API_RECALL_BUDGET_MIN/MAX默认20/2000兜底钳制。用大白话总结取舍low给追求低延迟的轻量对话high留给需要深度回忆上下文的关键任务mid是速度与效果之间的平衡点。服务端相关环境变量的完整清单见 Configuration 文档。还有一个容易踩的坑如果你同时开着 Hermes 内置的MEMORY.md扁平文件记忆两个记忆源会互相干扰。建议在 CLI 里执行hermes config set memory.memory_enabled false需要的话再加hermes config set memory.user_profile_enabled false把它关掉只留 Hindsight 一条记忆通道。️ 排障速查与深挖入口出了问题不用慌两条命令先自查# 本地守护进程活着吗 curl http://localhost:9077/health # 本地嵌入进程的日志 cat ~/.hermes/logs/hindsight-embed.log想继续深入这几个入口都给你留好了CLI / 网关用户Telegram、Discord、Slack 等多平台网关模式同样适用Hermes Agent 集成文档含hermes memory setup向导、完整配置参考与故障排查自建后端README 快速开始、docker-compose 部署示例、Helm Chart存储模型与检索机制Memory Banks 文档bank 隔离、404 行为、recall_budget换算公式都有详细展开。点下 Save 的那一刻记忆的飞轮就开始自己转了聊过的会被记住忘掉的重点会在下一轮对话里重新浮现。【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsight创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考