TencentDB Agent Memory 一键部署
腾讯云开源的团队级 Agent 记忆中枢。把记忆引擎（memory-core）、管理面板+知识服务（memory-hub）和 LLM 转发代理（proxy）用 Docker 一键拉起，让 WorkBuddy / CodeBuddy / Claude Code 等客户端共享同一套长期记忆。
本 Skill 的 assets/ 目录已内置官方部署脚本（v2.0.1，Windows / Linux / macOS 通用），并额外提供两个非交互一键脚本。
组件与端口
| 组件 | 容器名 | 宿主机端口 | 用途 |
|---|---|---|---|
| memory-core | tdai-memory-core |
8420 |
内核 gateway：记忆读写、鉴权、skill/RAG 数据面 |
| memory-hub | tdai-memory-hub |
8125 / 8424 |
管理面板 Panel + 知识服务 Knowledge（合并镜像） |
| proxy | tdai-proxy |
8096 |
LLM 请求转发代理，coding agent 的 API 入口（OpenAI 兼容 /v1） |
环境要求
- Docker（Windows → Docker Desktop 勾选 WSL2 / Linux 容器；macOS → Docker Desktop / OrbStack；Linux → 原生 docker）
- bash 4+（Windows 用 Git Bash 即可，安装 Git for Windows 自带）
- 一个 OpenAI 兼容的 LLM 端点 + API Key（默认已预填腾讯混元
https://api.hunyuan.cloud.tencent.com/v1，模型hunyuan-turbo）
快速开始
进入本 Skill 的 assets/ 目录（安装后位于 ~/.workbuddy/skills/tencentdb-agent-memory/assets/）：
Windows
:: 方式 A（Git Bash）：在本目录右键 "Git Bash Here"
cp .env.example .env
notepad .env :: 把两处 REPLACE_ME 换成真 Key
./deploy.sh :: 自动起三件套
:: 方式 B（双击 .bat）：本目录手动新建 deploy.bat，粘贴 README 中的 .bat 片段后双击
Linux / macOS
cp .env.example .env
# 编辑 .env，把两处 REPLACE_ME 换成真 Key
./deploy.sh
> 若 .env 不存在或仍含 REPLACE_ME，脚本会提示你先填好再退出，不会空跑。
部署后访问
| 服务 | 地址 |
|---|---|
| 管理面板 Panel | http://localhost:8125 |
| Proxy（客户端入口） | http://localhost:8096 |
| Knowledge API | http://localhost:8424/v3 |
| Memory Core | http://localhost:8420 |
- 首次启动会在
assets/目录生成.admin-key（随机 admin 登录串），按面板提示使用。 - 面板 "客户端接入地址" 卡片自动拼出局域网 IP + Proxy 端口，别人的电脑直接拷过去即可连。
接入 WorkBuddy / CodeBuddy / Claude Code
把客户端的 模型 API Base URL 指向 Proxy（OpenAI 兼容）：
OPENAI_BASE_URL=http://localhost:8096/v1 # 或 ANTHROPIC_BASE_URL=http://localhost:8096
OPENAI_API_KEY=any-string-if-auth-disabled # auth 默认关闭时可随意填
之后客户端经 proxy 调用 LLM 时，会自动注入团队 / Agent 的长期记忆上下文，实现跨会话、跨设备的记忆共享。
停止 / 清理 / 日志
./stop-all.sh # 停容器，保留 volume（数据还在）
./stop-all.sh --purge # 停容器 + 删 volume + 删网络（彻底清理）
docker logs -f tdai-memory-core
docker logs -f tdai-memory-hub
docker logs -f tdai-proxy
换其它 LLM 供应商
编辑 .env，把 MEMORY_LLM_* 与 PROXY_UPSTREAM_* 的 BASE_URL / API_KEY / MODEL 改成你的端点（DeepSeek / OpenAI / 自建网关均可，协议填 openai 或 anthropic）。
端口冲突
若 8125 / 8420 / 8424 / 8096 被占用，编辑 .env 改端口（注意 KNOWLEDGE_PUBLIC_BASE_URL 的端口要同步）：
MEMORY_CORE_PORT=18420
PANEL_PORT=18125
KNOWLEDGE_PORT=18424
PROXY_PORT=18096
KNOWLEDGE_PUBLIC_BASE_URL=http://host.docker.internal:18424/v3
安全提示
- 本 Skill 不含任何真实密钥；
.env中 Key 均为REPLACE_ME占位符，需自行填入。 - 默认
MEMORY_CORE_GATEWAY_API_KEY留空（本地零配置）。公网暴露 / 多人共用前，务必在.env把该值及 admin 凭据换成随机长串。 - 首次启动会从 Docker Hub 拉三个
agentmemory/*镜像，需联网；国内若拉取慢，可改.env注释里的mirrors.tencent.com私仓（需先docker login）。
参考
- 官方仓库：https://github.com/TencentCloud/TencentDB-Agent-Memory
- 部署细节见
assets/README.md与assets/内官方脚本。
