🧠 DSH TDAI Memory Adapter

<p align="center"><strong>DeepSeek Harness 的 TencentDB Agent Memory Adapter</strong><br>把自动 recall、turn 捕获和主动搜索接入现有 Gateway/Core。</p>

<p align="center"><a href="https://github.com/Vocllum/DSH-TDAI-Memory-Adapter"><img src="https://img.shields.io/badge/DSH-plugin-7c3aed?style=flat-square&logo=github&logoColor=white"></a> <a href="https://github.com/Vocllum/DSH-TDAI-Memory-Adapter/blob/main/LICENSE"><img src="https://img.shields.io/github/license/Vocllum/DSH-TDAI-Memory-Adapter?style=flat-square"></a> <a href="README_EN.md"><img src="https://img.shields.io/badge/English-README-64748b?style=flat-square"></a></p>

<p align="center"><a href="#安装">安装</a> · <a href="#功能">功能</a> · <a href="#和-dsh-tdai-memory-的区别">区别</a> · <a href="#配置">配置</a> · <a href="README_EN.md">English</a></p>

✨ 功能

• 🔎 自动 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 的区别

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

本项目不复制 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。密钥不会写入文件、模型上下文或工具结果。

🧰 工具

🧪 开发

npm test

📄 许可证

MIT

<p align="center"><a href="README_EN.md">🇬🇧 Read this page in English</a></p>