前言¶
在 DSH 插件里接入记忆能力时，如果目标环境已经有可用的 TencentDB Agent Memory Gateway/Core，通常不希望再在本地复制一套 MemoryCore、向量存储和提取流水线。dsh-tdai-memory-adapter 就是为这种场景准备的轻量 Adapter：它复用已经运行的 Gateway/Core，把 DSH 的生命周期事件接到记忆服务上。
这个插件由 Vocllum 维护，许可证为 MIT，定位为“自动 recall、turn 捕获与只读搜索工具”。它主要解决三件事：在 DSH 每一步动作前把相关记忆注入上下文，在对话 turn 结束时捕获并交给现有 MemoryCore 处理，以及给模型提供一组只读搜索工具。
这是什么¶
dsh-tdai-memory-adapter 是 DeepSeek Harness 的 TencentDB Agent Memory Adapter。
它不是把整套记忆栈搬进 DSH，而是作为 DSH 与已有记忆服务之间的适配层：
- 在 DSH 生命周期中触发 recall；
- 在 turn 结束或会话刷新时捕获对话；
- 复用现有 Gateway/Core 完成后续记忆沉淀；
- 向 DSH 注册只读搜索工具。
核心能力¶
下面几个能力是插件的主线。
自动 recall¶
插件会在 agent/pre-step 前从已有 Gateway 检索相关记忆，并注入当前上下文。也就是说，DSH 在准备执行下一步前，会先拿一次相关记忆，而不是等模型主动查询。
turn 捕获¶
插件会在 agent/turn-stopping 或 session/flush 时捕获对话，用于避免重复提交。捕获之后的记忆处理仍交给现有 MemoryCore 完成。
后台沉淀¶
已有 MemoryCore 会异步完成 L1/L2/L3 与 Skill 提取。插件本身不复制 MemoryCore，也不直接管理本地记忆目录。
只读搜索工具¶
插件会提供以下只读搜索工具：
tdai_memory_searchtdai_conversation_searchtdai_skill_search
这些工具用于查询已有记忆、对话历史和后端管理的 Skill，不提供写入或任意执行入口。
故障隔离¶
当 Gateway 或记忆服务异常时，插件采用 fail-open 行为，不阻断 DSH 主流程。也就是说，记忆链路出问题不应直接导致 DSH 无法继续运行。
与 dsh-tdai-memory 的区别¶
这里需要和另一个项目区分：Scorp1o117/dsh-tdai-memory。
| 项目 | 定位 |
|---|---|
Scorp1o117/dsh-tdai-memory |
把 MemoryCore、存储、向量和提取流水线整体移植到 DSH，并提供设置 UI。 |
dsh-tdai-memory-adapter |
轻量 Adapter，复用已运行的 TencentDB Agent Memory Gateway/Core，只负责 DSH 生命周期、身份传递和聚焦工具注册。 |
dsh-tdai-memory-adapter 不复制 MemoryCore，不管理本地记忆目录，不实现 MemoryProxy，也不暴露任意 URL/HTTP 执行器。
如果部署环境里已经有一个项目占用了同名包名，两者应按部署形态二选一，不能再共用同一个包名。
安装与启用¶
插件要求 Node.js 版本不低于 22：
engines.node >=22
如果目标环境是远程仓库安装，可使用下面的命令：
dsh plugin --profile web add https://github.com/Vocllum/DSH-TDAI-Memory-Adapter.git
安装完成后，重启目标 DSH profile。
如果希望从本地源码安装，可以先 clone 仓库，再添加本地目录：
git clone https://github.com/Vocllum/DSH-TDAI-Memory-Adapter.git
dsh plugin --profile web add ./DSH-TDAI-Memory-Adapter
配置¶
插件通过环境变量连接已有记忆服务。下面是 README 中给出的配置项：
export TDAI_MEMORY_ENDPOINT=http://127.0.0.1:8420
export TDAI_MEMORY_API_KEY=...
export TDAI_MEMORY_INSTANCE_ID=default
export TDAI_MEMORY_TEAM_ID=default
export TDAI_MEMORY_AGENT_ID=your-agent-id
export TDAI_MEMORY_USER_ID=your-user-id
export TDAI_MEMORY_RECALL_LIMIT=5
这里需要注意两点：
TDAI_MEMORY_ENDPOINT指向已经运行的 Gateway；- 缺少身份配置时，该会话的记忆操作会停用，但不会阻断 DSH。
插件说明中提到，密钥不会写入文件、模型上下文或工具结果。
工具与 Gateway 路径¶
插件暴露的是只读搜索工具，对应以下 Gateway 路径：
| 工具 | 用途 | Gateway 路径 |
|---|---|---|
tdai_memory_search |
搜索结构化长期记忆 | /v3/atomic/search |
tdai_conversation_search |
搜索原始对话历史 | /v3/conversation/search |
tdai_skill_search |
搜索后端管理的 Skill | /v3/skill/search |
在 DSH 中使用这些工具时，本质上是调用已有记忆服务中的查询接口，而不是在插件内新建一套本地搜索。
适用场景与注意¶
这个插件更适合下面这类部署：
- 已经存在可运行的 TencentDB Agent Memory Gateway/Core；
- 希望 DSH 直接接入已有记忆，而不是本地维护一套 MemoryCore、存储和向量；
- 需要自动 recall、turn 捕获和少量只读搜索能力；
- 希望记忆服务异常时不阻断 DSH 主流程。
使用前建议确认：
- 当前 DSH 运行环境满足 Node.js 22 及以上；
- Gateway 地址、API Key、实例、团队、Agent 和用户等身份配置可用；
- 插件以当前
dsh进程权限运行，安装前应检查源码、依赖与许可证； - 如果已经部署
Scorp1o117/dsh-tdai-memory，先确认包名和部署形态，不要与本项目混用。
结尾¶
dsh-tdai-memory-adapter 的价值不在于把记忆系统重新实现一遍，而在于把 DSH 的生命周期事件接到已有 TencentDB Agent Memory 服务上：recall、turn 捕获和只读搜索都围绕现有 Gateway/Core 完成。适合已有记忆后端、希望保持 DSH 轻量接入的团队。
目录页：
https://www.skillhub.cn/plugins/Vocllum/DSH-TDAI-Memory-Adapter
GitHub 仓库：
https://github.com/Vocllum/DSH-TDAI-Memory-Adapter
