Vocllum/DSH-TDAI-Memory-Adapter

🧠 DSH TDAI Memory Adapter

DeepSeek Harness 的 TencentDB Agent Memory Adapter把自动 recall、turn 捕获和主动搜索接入现有 Gateway/Core。

安装 · 功能 · 区别 · 配置 · English

✨ 功能

- 🔎 自动 recall：在 agent/pre-step 前从已有 Gateway 检索相关记忆并注入上下文。
- 🧾 turn 捕获：在 agent/turn-stopping / session/flush 捕获对话，避免重复提交。
- 🌱 后台沉淀：由现有 MemoryCore 异步完成 L1/L2/L3 与 Skill 提取。
- 🧰 主动搜索：提供 tdai_memory_search、tdai_conversation_search、tdai_skill_search 只读工具。
- 🛟 故障隔离：Gateway 或记忆服务异常时 fail-open，不阻断 DSH。

🧭 工作方式

DSH lifecycle → Gateway → MemoryCore
recall       L0 capture       L1/L2/L3/Skill (后台异步)

🎯 和 dsh-tdai-memory 的区别

这是两个不同方向的项目：

| 项目 | 定位 |
| --- | --- |
| Scorp1o117/dsh-tdai-memory | 把 MemoryCore、存储、向量和提取流水线整体移植到 DSH，并提供设置 UI。 |
| 本项目 | 轻量 Adapter，复用已运行的 TencentDB Agent Memory Gateway/Core，只负责 DSH 生命周期、身份传递和聚焦工具注册。 |

本项目不复制 MemoryCore，不管理本地记忆目录，不实现 MemoryProxy，也不暴露任意 URL/HTTP 执行器。两者可以按部署形态二选一，不能再共用同一个包名。

🚀 安装

dsh plugin --profile web add https://github.com/Vocllum/DSH-TDAI-Memory-Adapter.git

安装后重启目标 DSH profile。也可以从本地目录安装：

git clone https://github.com/Vocllum/DSH-TDAI-Memory-Adapter.git
dsh plugin --profile web add ./DSH-TDAI-Memory-Adapter

⚙️ 配置

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

缺少身份配置时，该会话的记忆操作会停用，但不会阻断 DSH。密钥不会写入文件、模型上下文或工具结果。

🧰 工具

| 工具 | 用途 | Gateway 路径 |
| --- | --- | --- |
| tdai_memory_search | 搜索结构化长期记忆 | /v3/atomic/search |
| tdai_conversation_search | 搜索原始对话历史 | /v3/conversation/search |
| tdai_skill_search | 搜索后端管理的 Skill | /v3/skill/search |

🧪 开发

npm test

📄 许可证

MIT

🇬🇧 Read this page in English