Claude code 必装插件:Supermemory 6行代码给Agent装上永久记忆

标签：#AI记忆 #RAG #用户画像 #开源项目 #知识管理

30秒速览

● 核心价值：让AI Agent在对话之间保持持续记忆，自动提取事实、更新用户画像、处理矛盾与遗忘
● 核心亮点：三大记忆基准测试均排名第一（LongMemEval #1、LoCoMo #1、ConvoMem #1），6行代码集成
● 上手难度：npm/pip安装即用，MCP服务器一键接入主流AI工具
● 适合人群：AI应用开发者、Agent构建者、需要持久化记忆的技术团队

一、你有没有遇到过这种情况？

你让Claude Code做跨周的项目——第二周开始，它完全不记得第一周你们讨论过的技术选型。

你在一个AI聊天助手说了自己是素食者，三周后它推荐了一家牛排馆。

你的AI客服系统每次都要用户重新描述问题，因为"上一轮对话"已经是昨天的事了。

真实案例：一位SaaS创始人分享了他的挫败感——他的AI Agent产品日活用户不少，但用户反馈最集中的问题是"它不记得我"。用户每次打开都要重新介绍自己、重新描述项目、重新说一遍需求。"我们花了半年打磨AI能力，但用户真正在意的是——它能不能记住我是谁。"
"记忆不是功能，是信任的基础。"

这个项目，就是来解决AI记忆问题的。

二、Supermemory：AI的记忆控制平面

Supermemory 是一个为AI打造的记忆和上下文引擎。它不是简单的对话存储，而是能自动从对话中提取事实、构建用户画像、处理知识冲突和时效性的一整套记忆系统。

三大基准测试：全部第一

基准测试	衡量标准	结果
LongMemEval	跨会话长期记忆 + 知识更新	81.6% — 第1名
LoCoMo	长对话中的事实回忆	第1名
ConvoMem	个性化与偏好学习	第1名

核心能力矩阵

能力	说明	一句话
记忆引擎	自动从对话中提取事实，跟踪时序变化	你说的它都记得
用户画像	自动维护稳定事实+近期动态	50ms获取用户上下文
混合搜索	RAG + 记忆一次查询	文档和个人上下文一起返回
连接器	Google Drive/Gmail/Notion/GitHub/OneDrive	自动同步，实时Webhook
多模态	PDF/图片(OCR)/视频(转录)/代码(AST分块)	所有文件格式通吃
自动遗忘	过期信息自动失效，矛盾自动解决	不会记住"明天考试"考完后

支持客户端

Claude Desktop、Cursor、Windsurf、VS Code、Claude Code、OpenCode、OpenClaw、Hermes

三、三大痛点，一个工具全搞定

痛点1：AI是"金鱼"，每次对话都是新的开始

传统AI对话在会话结束后就归零。Supermemory通过自动事实提取将对话中的关键信息持久化——用户偏好、项目背景、重要约定——全部自动写入记忆库。下一次对话，AI自动加载相关上下文，就像从来没离开过。

痛点2：RAG只能查文档，记不住"你是谁"

传统RAG（检索增强生成）擅长从文档库中找答案，但它不知道用户是谁、有什么偏好。Supermemory的混合搜索同时结合了RAG（知识库文档）和Memory（用户个性化上下文）——一次查询，同时返回相关文档和用户画像。让AI的回答既准确又个性化。

痛点3：手动维护知识库太累，经常过期

知识库需要手动更新、手动清理、手动维护。Supermemory的连接器可以自动从Google Drive、Gmail、Notion、GitHub等数据源同步内容，PDF/图片/视频/代码自动处理。自动遗忘机制让过期的信息自动失效，矛盾的信息自动解决——零人工维护。

四、它是怎么工作的？

你的应用 / AI工具（Claude Code、Cursor、自定义Agent等）        │        ▼    ┌──────────────────────────────────────────┐    │              Supermemory                   │    │                                            │    │  ┌─────────────┐    ┌──────────────┐      │    │  │   记忆引擎    │    │   用户画像     │      │    │  │  · 事实提取   │    │  · 稳定事实    │      │    │  │  · 时序更新   │    │  · 近期动态    │      │    │  │  · 矛盾解决   │    │  · 50ms响应   │      │    │  │  · 自动遗忘   │    │              │      │    │  └──────┬──────┘    └──────┬───────┘      │    │         │                  │               │    │  ┌──────▼──────────────────▼───────┐      │    │  │         混合搜索引擎               │      │    │  │    RAG（知识库） + Memory（记忆）    │      │    │  └──────┬──────────────────┬───────┘      │    │         │                  │               │    │  ┌──────▼──────┐  ┌──────▼───────┐      │    │  │   连接器     │  │  多模态提取器  │      │    │  │ Google Drive│  │  PDF / OCR   │      │    │  │ Gmail/Notion│  │  视频/代码    │      │    │  │ GitHub/...  │  │              │      │    │  └─────────────┘  └──────────────┘      │    └──────────────────────────────────────────┘        │   记忆内容 + 用户画像 + 文档结果        ▼    AI模型回复

记忆 vs RAG 的核心区别：

RAG：检索文档 → 返回相关段落（对所有人返回相同结果）     没有用户概念，没有时序概念，没有矛盾解决Supermemory Memory：提取事实 → 跟踪变化 → 构建画像"用户喜欢TypeScript" ✓"用户上周说：喜欢TypeScript" → "用户一直喜欢TypeScript" ✓"用户之前说喜欢Python" → 矛盾检测 → 偏好变更 ✓

五、谁适合用？谁可以跳过？

适合你用，如果：

● 你正在构建AI Agent或AI应用，需要跨越对话边界的记忆能力
● 你的用户抱怨"AI不记得我"——这是最常见的负反馈
● 你想给现有的AI工具（Claude Code、Cursor等）加上持久记忆
● 你希望用户画像自动维护，不需要手动打标签
● 你需要多数据源（Gmail、Notion、GitHub）自动同步到知识库

可以跳过，如果：

● 你做的是一次性的问答应用，不需要跨会话持久化
● 你的用户量很小，记忆不是当前的瓶颈
● 你的场景不需要个性化——所有人得到同样的答案就够了

六、使用方式

方式	说明	适用场景
MCP一键安装	`npx -y install-mcp@latest https://mcp.supermemory.ai/mcp`	给Cursor/Claude等工具加记忆
npm包	`npm install supermemory`	Node/TypeScript项目中集成
pip包	`pip install supermemory`	Python项目中集成
Web App	https://app.supermemory.ai	零代码直接使用
框架插件	Claude Code / OpenCode / OpenClaw / Hermes	AI编码工具原生支持

框架集成

框架	集成方式
Vercel AI SDK	`withSupermemory(openai("gpt-4o"))`
LangChain	Supermemory官方集成
LangGraph	Supermemory官方集成
OpenAI Agents SDK	Supermemory官方集成
Mastra	`withSupermemory(config, userId)`
Agno	Supermemory官方集成
n8n	Supermemory节点

API速览

方法	作用
`client.add()`	存储内容——文本、对话、URL、HTML
`client.profile()`	用户画像 + 可选搜索，一次调用
`client.search.memories()`	混合搜索——记忆和文档一起搜
`client.documents.uploadFile()`	上传PDF/图片/视频/代码
`client.settings.update()`	配置提取和分块策略

七、30秒快速上手

# 第1步：安装npm install supermemory# 或pip install supermemory# 第2步：在代码中集成记忆

importSupermemoryfrom"supermemory";const client = newSupermemory();// 存储一段对话await client.add({content: "用户喜欢TypeScript，偏好函数式编程模式",containerTag: "user_123",});// 获取用户画像 + 相关记忆（一次调用）const { profile, searchResults } = await client.profile({containerTag: "user_123",q: "用户喜欢什么编程语言？",});// profile.static  → ["喜欢TypeScript", "偏好函数式编程"]// searchResults  → 相关记忆按相似度排序

给AI工具加记忆（MCP方式）：

npx -y install-mcp@latest https://mcp.supermemory.ai/mcp --client claude --oauth=yes# 替换 claude 为 cursor / windsurf / vscode 等

八、常见问题解答

Q1：Supermemory和传统RAG有什么区别？

传统RAG检索的是文档段落——它对所有人返回相同的结果，没有用户概念，只是"搜索+拼接"。Supermemory的记忆引擎(不光是检索)还会：自动提取对话中的事实、构建用户画像、跟踪知识变化（用户搬家了？自动更新地址）、解决矛盾（前后说法不一致）、自动遗忘过期信息。Memory不是RAG——Memory是RAG的上层增强。

Q2：基准测试排名第一，含金量如何？

Supermemory在LongMemEval（跨会话知识更新测试，81.6%）、LoCoMo（复杂长对话回忆测试）、ConvoMem（个性化偏好学习）三个独立基准测试中均排名第一。此外Supermemory团队还开源了MemoryBench——一个标准化的记忆系统评测框架，支持在Supermemory、Mem0、Zep等方案之间做横向对比。

Q3：数据安全吗？数据存在哪里？

Supermemory提供了两种模式：在Web App中，数据存储在Supermemory的云服务中（有加密）。自建开发者可以通过API自行控制数据存储位置。MCP Server连接时使用OAuth认证，API Key模式使用Bearer Token认证。

Q4：上手难度高吗？

非常低。对于个人用户：访问app.supermemory.ai即可开始使用，或者用一行命令安装MCP插件给Cursor/Claude加记忆。对于开发者：npm/pip安装后，6行代码即可集成完整的记忆能力——无需配置向量数据库、无需设计embedding管道、无需处理分块策略。

九、项目信息

● GitHub: https://github.com/supermemoryai/supermemory
● 许可证: 未明确标注（参考官方文档）
● 基准排名: LongMemEval #1 / LoCoMo #1 / ConvoMem #1
● 支持: npm / pip / MCP / Web App / 框架插件
● 官方文档: https://supermemory.ai/docs

现在就去试试

别再让AI每次都说"你好，我是谁"了。装上Supermemory，你今天告诉AI的事情，它明天还会记得。

npm install supermemory

一句话总结：三大记忆基准第一，6行代码给AI装上记忆。

喜欢这篇文章？欢迎点赞、转发、评论，关注公众号获取更多AI工具推荐！