语义长期记忆 WeilaiSun/dsh-hindsight-memory

dsh-hindsight-memory

为 DeepSeek Harness 提供的语义长期记忆——基于本地 Hindsight 守护进程（PostgreSQL + pgvector + DeepSeek 嵌入），提供原生 hindsight_retain / hindsight_recall / hindsight_reflect 工具，并可在每个 agent 步骤前可选地注入 auto-recall。

一切皆为插件——这是一个 Cordis 插件，可通过 dsh plugin add 安装。

为什么

DeepSeek Harness 的内置记忆是会话级的（每会话事件日志 + AGENTS.md 指令）。本插件增加了跨会话语义记忆：高价值事实、用户偏好和经验教训会被嵌入到向量存储中，并按语义而非关键词检索——就像 Hermes 的 Hindsight 集成一样。

特性

- hindsight_retain —— 写入一条记忆；Hindsight 会自动提取事实、解析实体、生成嵌入、对相似事实去重，并按时间/语义建立关联。
- hindsight_recall —— 语义搜索（嵌入相似度 + 知识图谱扩散激活）。查询不需要匹配关键词。
- hindsight_reflect —— 对召回的事实 / 心智模型 / 指令进行 LLM 综合，给出提炼后的答案。
- autoRecall —— 启用后，插件会挂接 agent/pre-step，并在每个步骤前将相关记忆作为 用户消息注入，使模型不会在冷启动状态下开始任务。
- 隔离 —— 插件驱动其自己的 Hindsight 配置文件（默认 deepseek）：独立的守护进程端口、独立的 PostgreSQL 实例、独立的 bank。它从不读取或写入其他配置文件的数据。

前置条件

- 本地安装的 Hindsight，其 venv 中带有 Python 包 hindsight_embed。
- 用于嵌入的 DeepSeek API key（或任何 OpenAI 兼容端点）。

默认值假定为标准 Hermes 布局（F:\Hermes\HERMES_HOME\...）；如果你的安装位于其他位置，请通过配置覆盖。

安装

从 GitHub 安装（当前可用）：

dsh plugin --profile web add git+https://github.com/WeilaiSun/dsh-hindsight-memory.git

从 npm 安装（发布后）：

dsh plugin --profile web add dsh-hindsight-memory

然后将该行添加到你的 agent 预设或配置文件补丁（cordis.patch.yml）中：

- id: hindsight-memory
name: 'dsh-hindsight-memory'
config:
autoRecall: true

新会话会加载它（agent 预设在会话创建时固定）。

配置

| 键 | 默认值 | 描述 |
| venvPython | F:\Hermes\HERMES_HOME\hermes-agent\venv\Scripts\python.exe | 已安装 hindsight_embed 的 Python |
| configJson | F:\Hermes\HERMES_HOME\hindsight\config.json | 包含 llm_api_key / llm_base_url / llm_model 的 JSON（DeepSeek key 的来源；绝不硬编码） |
| llmBaseUrl / llmModel / llmProvider | DeepSeek 默认值 | 嵌入端点；deepseek/openai_compatible/openrouter 映射为 openai |
| profile | deepseek | Hindsight 配置名称（独立的守护进程端口 + PG 实例 + bank） |
| bank | = profile | 由 retain/recall/reflect 使用的 bank id |
| autoRecall | false | 在每个 agent 步骤前注入相关记忆 |
| recallTypes | ["observation","experience","world"] | 搜索的事实类型 |
| recallLimit | 4 | 每次召回的最大记忆数 |
| recallMinUserChars | 20 | 触发自动召回前用户消息的最小长度 |
| recallBudgetTokens | 1200 | 自动召回注入的 token 预算 |

用法

模型直接调用这些工具。示例保留策略（对应一种自演化协议）：

- 在复杂任务（5 次以上工具调用）之后、解决一个陷阱之后、当用户表达持久偏好时，或在关键设计决策之后进行保留。
- 在复杂任务开始时、当用户引用过去的工作时，或当某种情况看起来像是重复时进行召回。

agent preset row with auto-recall enabled
- id: hindsight-memory
name: 'dsh-hindsight-memory'
config:
autoRecall: true
recallLimit: 5

工作原理

agent step (autoRecall) / model tool call
│
▼
plugin (node) ──ensure daemon──▶ hindsight_embed (Python) ──spawn──▶ Hindsight daemon (REST)
│ │
└────────── fetch ──▶ /v1/default/banks/{bank}/memories[/recall|/reflect]
│
PostgreSQL + pgvector + DeepSeek embeddings

守护进程在首次使用时自动启动，并在空闲时停止（默认 10 分钟）。插件会缓存守护进程 URL，并在失败时重新确保其运行。

开发

git clone
cd dsh-hindsight-memory
node --check lib/index.js # syntax
node smoke-test.mjs # end-to-end: fake ctx + real daemon

许可证

MIT