持久记忆库 hydra-db/hydradb-deepseek-plugin

HydraDB DeepSeek Harness 插件

为 DeepSeek Harness（dsh）提供持久化、跨会话记忆，由 HydraDB 驱动。

它在每一轮对话前召回相关上下文，把工作区文档同步进 HydraDB，并把对话记录为持久记忆，与 HydraDB Claude Code / Codex / OpenClaw 插件共用同一套引擎（scripts/plugin.mjs）。

这里有哪些是 dsh 特有的

- 入口模块： index.js，一个普通的 Cordis 插件（export const name + export function apply(ctx)）。dsh 按包名挂载它，并用插件 ctx 调用 apply；它借助共享引擎，在 harness 的拦截接缝上注册监听器。
- 环境变量前缀： 按共享客户端契约，本客户端读取规范的 HYDRADB_ 名称，外加 HYDRA_DEEPSEEK_ 前缀（见 CONTRACT.md）。
- 技能： skills/ 下是共享的 HydraDB 技能，用于手动召回与写入。

接缝

| dsh 扩展点 | 引擎动作 |
| agent/created | 会话打开时，把工作区文档同步进 HydraDB |
| agent/pre-step（每轮的第一步） | 召回相关记忆/知识，并把它前置到该步的消息里 |
| tools/post-execute（写文件的工具） | 增量同步工作区 |
| session/event → turn/end | 记录已完成的这一轮 |

提示词阶段的自动召回（agent/pre-step）和工作区同步开箱即用。agent/pre-step 瀑布是协作式的：插件会 await next()，只向下游的 enter 决策前置一条 user 角色的上下文消息，因此能与其他 pre-step 监听器共存，而不是覆盖它们。

前置条件

- Node.js >= 18
- HydraDB 账号：API key + 数据库（hydradb.com）
- DeepSeek Harness（dsh）

安装

本包以 dsh bundle 形式发布（dsh.bundle + cordis.patch.yml），所以 dsh plugin add 一步就能把它装好，并作为配置档的一层接进去：

dsh plugin --profile <name> add dsh-hydradb

dsh 会把它追加到配置档的 dsh.profile.bundles，并自动插入 hydradb 插件行——不用手动改 cordis.patch.yml。如果想直接内联传配置，而不是走环境变量，就在 bundle 的 cordis.patch.yml 里加一个 config: 块（--patch 覆盖写法见 dsh.config.example.yml）。

凭据来自插件配置（api_key、database，可选 collection/base_url）或环境变量：

export HYDRADB_API_KEY="your-api-key"
export HYDRADB_DATABASE="your-database"
dsh-prefixed names also work: HYDRA_DEEPSEEK_API_KEY / HYDRA_DEEPSEEK_TENANT_ID

默认搜索模式是 memory；如果还想让同步进来的工作区知识也自动召回，就设 HYDRADB_SEARCH_MODE=both。

用法

- 自动召回在每轮的第一步之前，通过 agent/pre-step 运行，并把相关记忆/知识前置到该步的消息里。
- 共享技能提供手动 query / ingest / doctor / setup / last-recall 操作；契约规定的标准斜杠形式是 /hydradb-query、/hydradb-ingest、/hydradb-list、/hydradb-inspect、/hydradb-delete。

配置

配置键、环境变量覆盖，以及 capture/search/ingest 模式，都与其他 HydraDB 插件完全一致——参见 config.example.json 和 CONTRACT.md。

已验证

已针对 DeepSeek Harness（dsh）0.2.0-rc.2 测试：这个 bundle 通过 dsh plugin add 安装，注册为配置档层，其 apply 接缝能干净地激活。一次实时的 dsh headless 轮次（OpenRouter 服务商）成功回答了问题，答案来自 HydraDB 记忆，经 agent/pre-step 召回并注入。

许可证

Apache 2.0 - Copyright (c) 2026 HydraDB