
一、它是什么?
TencentDB Agent Memory 是腾讯云开源的团队级 AI Agent 记忆中心。口号:
Agents remember. Humans innovate.(Agent 负责记忆,人类负责创新。)
它从一个实际问题出发:
用 Agent 干活时,已经解释过的项目上下文,新会话不该重复说;已经读过的文档,每个 Agent 不该从头再读;已经跑通的工作流,下次不该重新摸索。
核心思路:把对话、文档、代码转化成四种可复用的记忆资产,统一治理、共享、跨 Agent/跨框架装配。
它的价值主张可以浓缩成一行:
Existing information → Reusable memory assets → Fewer turns → Less rework → More stable results and higher efficiency (现有信息 → 可复用记忆资产 → 更少轮次 → 更少返工 → 更稳定的结果和更高效率)
二、四种记忆资产(核心设计)
这是它最核心的设计,比单纯的"对话历史"高级得多:
| 资产 | 来源 | 作用 |
|---|---|---|
| Chat Memory(对话记忆) | 从对话和任务中提取 | 记住偏好、事实、决策、交互历史 |
| Skill(技能) | 从工作流中提取 | 把跑通的流程沉淀成可复用技能(带版本、资源、触发边界、执行步骤、验证规则) |
| LLM-Wiki(知识库) | 从文档转化 | 产品文档、设计规范、运维手册变结构化页面 + 链接图(灵感来自 Karpathy 的 LLM 知识库) |
| Code-Graph(代码图谱) | 从代码转化 | 索引代码符号、文件、调用关系、影响路径 |

三、Chat Memory 的分层:L0 → L3
对话不是平铺存储,而是逐层蒸馏:
| 层 | 存什么 | 主要用途 |
|---|---|---|
| L0 Conversation | 带完整上下文的原始对话 | 验证确切措辞、时间戳、来源 |
| L1 Atom | 从对话提取的事实、偏好、约束、事件 | 精确回忆可行动信息 |
| L2 Scenario | 围绕项目或场景组织的知识块 | 快速恢复工作上下文 |
| L3 Core / Persona | 长期画像、稳定模式、高层认知 | 让 Agent 快速进入用户/团队的上下文 |
生成和检索都是分层的:
-
正常情况下,L2/L3 提供快速上下文引导
-
需要具体事实时,BM25 + 向量检索 + RRF 回退到 L1/L0
-
结果还会按条目数、字符预算、超时限制封顶,防止记忆撑爆上下文窗口
-

README 里有一句很生动的例子:
"Don't refactor the old auth module — mobile is still using it."(别重构旧的 auth 模块——移动端还在用。) 这种代价高昂的上下文,不该靠人类每次重复。
四、Skill:不只是 prompt 片段
Skill 不是一段 prompt 文本,它有完整结构:
-
版本
-
资源文件
-
触发边界(什么时候该用)
-
执行步骤
-
验证规则
个人 Skill 默认私有;审查后可以共享给团队并分配给其他 Agent。
排障、代码评审、发布检查清单——学一次,整个团队都能用。
五、Wiki + CodeGraph:文档和代码也是记忆
Wiki
-
把产品文档、设计规范、运维手册变成带链接图的结构化页面
-
灵感来自 Andrej Karpathy 的 "LLM Wiki" gist
-

CodeGraph
-
索引代码符号、文件、调用关系、影响路径
-
Agent 可以搜索、阅读、检查调用者/被调用者,改代码前做影响分析
-

README 的总结很到位:
Wiki 让 Agent 不用在干活前把每个文件列表读一遍。CodeGraph 不只告诉 Agent "代码在这",还告诉它"改这个可能影响那些"。
六、怎么安装?
一键启动三个服务
git clone https://github.com/Tencent/TencentDB-Agent-Memory.git cd TencentDB-Agent-Memory/deploy/global-images cp .env.example .env $EDITOR .env # 填两组 LLM 参数(记忆组 + 代理组) ./start-all.sh # 一键启动 memory-core + memory-hub + proxy
启动完成后会打印一行可以直接粘进 Claude 的命令。
完整文档见 INSTALL.md(中文 INSTALL_CN.md),包括独立 Memory Hub 部署、Proxy + Claude Code/CodeBuddy 用法、停止清理、端口说明。
版本迁移
老版本(v1.x/v0.x)升级到 v2.0.0+ 有官方迁移工具 MemoryCore/scripts/migrate-v2-to-v3/,新安装可忽略。
七、最大卖点:零代码接入所有 Agent
一个 Proxy,协议不变,零代码集成——只要把 Agent 的 base URL 指向 Proxy 就行:
-
不需要插件
-
不需要 hook
-
不需要 MCP server
已支持的 Agent:
| DeepSeek Harness | Claude Code | Codex | CodeBuddy |
| WorkBuddy | Hermes | OpenClaw | 更多框架持续接入中 |
没有你喜欢的 Agent?有 Generic 集成指南可以自己适配,官方欢迎 PR。
八、团队玩法:给一人公司建一支 Agent 团队
README 给了一个很有画面感的例子:
Tiny but Serious Inc. ├── 👤 You · 设定目标 / 做决策 ├── 🔭 Scout · 调研 / 找机会 ├── 🛠 Builder · 写代码 / 做产品 ├── 🧪 Reviewer · 测试 / 找问题 └── 🧠 Agent Memory · 保存团队经验
你不是开了四个独立聊天窗口,而是在组一个班底,不同角色能继承团队积累的经验。
先招兵,再装备
🔭 Scout ├── 用户访谈 Chat Memory ├── 市场调研 Wiki └── 竞品分析 Skill 🛠 Builder ├── 产品 Wiki ├── 项目 CodeGraph └── 功能交付 Skill 🧪 Reviewer ├── 历史故障 Chat Memory ├── 项目 CodeGraph └── 发布检查清单 Skill
不同角色、不同装备。给每个 Agent 它真正需要的记忆资产,减少噪音。
公司可以很小,经验可以无限复利。
九、和普通 RAG / 聊天记录的对比
这张表是它最有说服力的部分:
| 聊天历史 | 标准 RAG | TencentDB Agent Memory | |
|---|---|---|---|
| 跨会话用户理解 | △ | △ | ✅ Chat Memory |
| 蒸馏后的可执行经验 | — | — | ✅ Skill |
| 文档结构与关系 | — | △ 分块检索 | ✅ Wiki + 链接图 |
| 代码调用图与影响范围 | — | △ 文本匹配 | ✅ CodeGraph |
| 所有权/版本/状态 | — | — | ✅ |
| 团队共享与 Agent 装备 | — | — | ✅ |
| 私有/团队/ACL | — | △ | ✅ |
一句话区别:RAG 回答"能找到什么",团队记忆还回答"谁能用、哪个版本有效、该发给哪个 Agent"。
十、治理:Memory Hub 是控制面板,不是展示板
| 玩法 | 在 Hub 里做什么 |
|---|---|
| Team Up | 创建团队,加人和 Agent,定义共享边界 |
| Asset Library | 浏览、搜索、审查、管理四类记忆资产 |
| Agent Loadout | 给不同 Agent 绑定不同记忆资产,调优先级和使用模式 |
| Knowledge Workshop | 构建 Wiki 和 CodeGraph,监控处理状态和资产元数据 |
| Access Control | 在私有/团队/ACL 间切换,需要时撤销共享 |
打开一个资产时,重要的不只是"它说什么",还有"它从哪来、哪个版本、分配给谁、最近有没有用过"。
四种可见性
| 可见性 | 语义 |
|---|---|
private | 只有 Owner 能读,连团队管理员都不行 |
team | 团队成员可读;Owner/Admin 可管理 |
restricted | 通过 User / Role / Agent ACL 精确授权 |
agent | 给同团队内 Agent 定向装备 |
新 Chat Memory 和 Skill 默认私有,共享是显式动作,不是默认泄露。
十一、冷启动:直接加载存档
大多数 Agent 的第一个任务是重新学习你的项目。TencentDB Agent Memory 把你已经付过的学习成本变成存档:

可直接导入并自动处理:
-
代码库:CodeGraph 自动索引符号、文件、调用关系、影响路径
-
文档文件:Wiki 自动生成带链接图的结构化页面
-
会话记录:自动提取 Skill 和 Chat Memory
别再重新训练每个 Agent。给它存档。
十二、每次循环都在积累经验

记忆不运行 Agent 循环,它确保下一次迭代继承上一次的成果:
-
有价值的交互留在 Chat Memory
-
被验证的工作流蒸馏成 Skill
-
文档/代码变更通过 Wiki ingest 和 CodeGraph sync 更新
没有记忆,循环可能只是更快地重复。有了继承的记忆,每次迭代都有机会比上次更好。
十三、Benchmark:PersonaMem +59%
官方给了一个基准测试结果:
| Benchmark | 不带记忆 | 开启记忆 | 相对提升 |
|---|---|---|---|
| PersonaMem | 48% | 76% | +59% |
PersonaMem 测试的是 Agent 在长期交互后能否正确理解和应用用户信息。提升 59% 是很显著的数字。
(注意:这是官方自测数据,建议结合自己的场景验证。)
十四、技术实现三个核心问题
README 明确说它不追求"存一切",而是解决三个问题:什么值得留、谁能用、下次怎么少检索但检对的。
-
记忆不是扁平记录,而是分层生长:L0→L3 异步蒸馏,分层检索
-
记忆不是全局 prompt,而是 Agent 的装备:统一注册为 Memory Asset,Fixed Binding + ACL 决定可用范围
-
知识不是全量注入,而是按需调用:Wiki 可搜索、CodeGraph 可查询,Agent 先
/v3/tools/list发现能力,再/v3/tools/call读取相关页面/代码/影响路径
文档和代码也是记忆的一部分,但它们保持为工具,只在真正需要时才进入上下文。
十五、优点总结
-
零代码接入:改个 base URL 就行,不用写插件/hook/MCP,这是最大优势
-
四类资产分类科学:Chat/Skill/Wiki/CodeGraph 覆盖 Agent 需要的几乎所有记忆类型
-
L0-L3 分层蒸馏:不是全量塞 prompt,有智能分层和预算控制
-
团队级而非个人级:记忆在团队流通,新人第一天就能加载存档
-
Agent 无关:不绑定 Claude/DeepSeek,框架可换、记忆留着
-
ACL 精细:private/team/restricted/agent 四级,默认私有
-
大厂出品:腾讯云背书,有持续维护和商业化预期
-
自带面板:可视化管理审查,比命令行友好
-
有 benchmark:PersonaMem +59%
-
致谢开源社区:CodeGraph 用了 colbymchenry/codegraph,Skill 部分借鉴了 Nous Research 的 Hermes Agent,Wiki 灵感来自 Karpathy
十六、为什么这么火?
-
"Agent 记忆"是 2026 年最热基础设施方向之一:Agent 没记忆就只能做一次性任务
-
"零代码 + Proxy 接入"太香了:别的方案要写 hook/MCP,它改 URL 就搞定
-
DeepSeek Harness 同期爆火带飞:它是 DSH 生态重要配套,首屏就列了 DSH
-
腾讯背书 + 中文友好:有中文文档,国内开发者接受度高
-
"加载团队存档"比喻有画面感:容易传播
-
四资产设计完整:不是单点工具,是完整方案
-
冷启动叙事打动人:别再重新训练每个 Agent
-
MIT 协议:商业友好
十七、注意事项
-
需要配两组 LLM 参数(记忆提取组 + 代理组),有 token 成本
-
目前是 Beta 版本(v2.0.0),迭代很快,API 可能变
-
自托管需要 Docker 环境,三服务有一定资源占用
-
Wiki 和 CodeGraph 是异步构建,需要等处理时间到
ready状态 -
CodeGraph 目前优先支持公开 HTTPS 仓库,私有仓库和 SSH 凭证支持还在完善
-
Hub 支持手动资产绑定,全自动记忆路由还在迭代
-
Node 要求 ≥22.16
附:官方资源
-
安装文档:INSTALL.md / INSTALL_CN.md
-
面板(本地):http://localhost:8125
-
Roadmap:ROADMAP.md / ROADMAP_CN.md(下个版本 v2.0.1:零配置冷启动、更快 Wiki、用户/团队自定义 prompt、Skill 导出、Codex IDE Plan 模式支持)
-
Discord:社区入口在 README
-
致谢项目:codegraph、Hermes Agent、Karpathy's LLM Wiki gist
-
协议:MIT

451

被折叠的 条评论
为什么被折叠?



