前言:项目简介
传统 AI 系统往往在每次对话结束后丢失上下文,而没有持久记忆的能力,这使得跨会话、跨工具的上下文理解极其困难。supermemoryai 官方发布的开源项目supermemory(GitHub) 正是为解决这个问题而设计的——它提供一个面向 AI 的持久记忆与上下文引擎,用于构建可记住用户历史、兴趣、项目背景、偏好等长期信息的 AI 系统。
该项目自称在所有主要 AI 记忆评测基准(如 LongMemEval、LoCoMo、ConvoMem)中表现领先,并且专注于把记忆与检索(RAG + Memory)、用户画像、内容抽取合并为一个统一的系统,而无需单独配置向量数据库或嵌入管道。
发布时间:2026-05-29
一、项目框架设计
该项目采用monorepo结构组织,涵盖多个子应用、SDK、插件和工具链。核心设计可分为以下几个层级:
supermemory ├── apps/ # 多端应用(MCP、dashboard 等) ├── packages/ # 单一 SDK、内核组件、服务包 ├── skills/supermemory/ # Supermemory 在技能框架内的插件封装 ├── README.md ├── package.json ├── tools/ # 工具链脚本 ├── docs/ # 文档与教程 └── various SDK & config主要模块功能划分如下:
1. Memory 引擎
核心内核负责:
自动抽取记忆事实:从对话、文档、消息流自动抽取语义事实;
知识更新与冲突解决:处理知识变更与矛盾信息;
自动忘记机制:按时间和优先级自动清理不再相关的信息;
混合检索:统一 RAG + Memory 检索一体化查询;
项目 README 中明确指出 supermemory 是一个 “记忆而非仅仅是 RAG”,强调记忆和人物/项目画像的长期保持。
2. 用户画像与记忆图谱
系统自动维护用户的:
静态个人信息(如偏好、工作语言等)
动态信息(近期任务、讨论上下文)
项目记忆(跨工程的长期语义内容)
一次查询可同时获得 profile + searchResults,方便模型注入上下文。
3. Connectors 和抽取器
支持自动同步外部数据源:
Google Drive
Gmail
Notion
OneDrive
GitHub 等
这些连接使外部数据实时纳入 memory 图,在检索时可查询整个知识图谱。
4. 多端支持与插件
项目提供多平台支持:
Claude Code / Cursor / Windsurf / VS Code / etc
MCP Memory Protocol 支持
对应插件在官方 GitHub 生态下有多个仓库(如 opencode-supermemory、claude-supermemory 等)。
二、关键功能解析与技术破局
1)革命性持久记忆
传统系统没有持久记忆或只依赖向量数据库检索,而 supermemory核心引擎通过混合记忆 + 个人画像 + 知识图谱实现更类似“大脑”的记忆机制,支持长期记忆保持。
这是它区别于纯向量检索的核心价值。
2)自动抽取与动态更新
超越 RAG 模式,它能从对话内容、文档、邮件甚至文件里自动抽取语义事实。
例如:
await client.add({ content: "User loves TypeScript and prefers functional patterns", containerTag: "user_123", });对话中的事实被存入 memory 引擎并随时可通过 profile 检索。
3)统一的记忆 + RAG 查询
常见 RAG 需要先分词/嵌入/向量检索流程,而 supermemory 内部采用混合检索(hybrid search):
client.search.memories({ q: "user preferences", containerTag: "user_123", searchMode: "hybrid", });一次查询即可同时获得相关静态记忆、动态信息和文档检索结果。
4)自动忘记与冲突管理
记忆系统包含时间线机制,无关长期信息会自动“忘记”,避免噪音累积;当遇到相互矛盾的信息时,系统能自动做出冲突解决策略,让记忆结果更稳定。
这类功能是最难工程化记忆系统的核心。
🔹 5)快速、低延迟的上下文注入
系统设计支持在 <300ms 内完成个性化记忆检索与返回,这对于交互式 AI 系统尤为关键。
🚀 使用教程(实操示例)
1)基本安装
npm install supermemory # 或者 pip install supermemory2)初始化客户端
import Supermemory from "supermemory"; const client = new Supermemory();3)添加记忆
await client.add({ content: "User prefers dark theme and uses VS Code", containerTag: "user_123", });4)获取用户画像 +检索记忆
const { profile, searchResults } = await client.profile({ containerTag: "user_123", q: "User prefers what theme?", });profile.static→ 长期事实profile.dynamic→ 最近活动searchResults→ 相关记忆条目 (GitHub)
总结
supermemoryai/supermemory 是当前AI 记忆领域最值得关注的开源项目之一,它不仅解决了 AI 系统无法持久记忆的问题,还将记忆与 RAG、用户画像、外部数据抽取融合到统一 API 中。相比传统向量数据库检索,supermemory 提供了更“人类化”的语义记忆模型,使得 AI 在跨会话、跨平台、多数据源之间具备真正的上下文理解能力。
对于构建真正具备持久理解、长期学习能力的智能体来说,它不仅仅是一个组件,而是未来智能生态的核心基础设施之一。
互动话题
你更希望 AI “记住什么”?
只记住长期偏好
只记住会话上下文
同时记住偏好 + 会话 + 文件内容
AI 记忆是否应该可由用户完全控制(隐私 vs 便利)
欢迎留言讨论你的观点。