前言¶
在 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
