← 返回首页
🏆

SuperMemory

State-of-the-art Memory & Context Engine for AI

24.1k
⭐ GitHub Stars
#1
三大记忆基准榜首
TypeScript
MIT License

📌 什么是 SuperMemory

SuperMemory 是面向 AI 应用的 state-of-the-art 记忆与上下文引擎。它在 LongMemEval、LoCoMo 和 ConvoMem 三大主流 AI 记忆基准测试中均排名第一,代表了当前 AI 长期记忆能力的最高水平。

与简单的向量存储不同,SuperMemory 实现了完整的记忆生命周期管理:自动提取事实、构建用户画像(静态+动态)、处理矛盾信息、以及自动遗忘过时内容。

核心理念: AI 不应该只是检索文档——它应该 记住 用户、理解上下文、并随时间进化。

🏗️ Hybrid RAG + Memory 架构

SuperMemory 的核心架构创新在于将 RAG(检索增强生成)Memory(记忆系统) 融合在一次查询中,同时获取知识库内容和个性化上下文。

架构组件

  • Semantic Extraction Pipeline — 从原始内容中提取事实、实体和关系
  • Contradiction Resolution — 自动检测并解决信息矛盾,保留最新/最可靠的信息
  • Temporal Expiry — 基于时间衰减的记忆过期机制,模拟人类遗忘曲线
  • Static + Dynamic Profiles — 用户画像分静态属性(偏好、身份)和动态属性(近期行为、上下文)
  • Infrastructure: Cloudflare Workers/KV 边缘计算 + PostgreSQL (Drizzle ORM) 持久化存储
// 查询流程示意
User Query
    ├── RAG Path: 检索知识库文档 (向量 + 关键词混合搜索)
    ├── Memory Path: 检索用户记忆 (事实、画像、历史上下文)
    └── Merge → Ranked Results → LLM Context

📊 基准测试成绩

SuperMemory 在所有三个主要 AI 记忆基准测试中均排名第一:

#1
LongMemEval
长期记忆评估基准
测试跨会话记忆保持能力
#1
LoCoMo
长对话记忆基准
测试多轮对话上下文理解
#1
ConvoMem
对话记忆基准
测试对话历史回忆精度

🔗 Connectors & 多模态提取

数据源连接器

SuperMemory 提供开箱即用的连接器,支持实时 Webhook 同步:

📁 Google Drive 📧 Gmail 📝 Notion ☁️ OneDrive 🐙 GitHub

多模态内容提取

  • PDF — 完整文档解析与结构化提取
  • Images (OCR) — 图片文字识别与内容理解
  • Videos (Transcription) — 视频转录与关键信息提取
  • Code (AST-aware Chunking) — 基于 AST 的智能代码分块,保留语义完整性

⚖️ SuperMemory vs mem0

维度SuperMemorymem0
基准排名✅ 三项基准 #1未上榜
矛盾处理✅ 自动检测 & 解决❌ 需手动管理
自动遗忘✅ 时间衰减过期❌ 无内置机制
用户画像✅ 静态 + 动态双层基本存储
连接器✅ 5+ 平台 + Webhook有限
多模态✅ PDF/图片/视频/代码文本为主
Hybrid RAG✅ 单次查询融合❌ 分离架构
社区规模24.1k ⭐较大

🚀 快速开始

安装
npm install @supermemory/sdk
基本使用 — TypeScript
import { SuperMemory } from '@supermemory/sdk';

const memory = new SuperMemory({
  apiKey: process.env.SUPERMEMORY_API_KEY,
});

// 添加记忆 — 自动提取事实、处理矛盾
await memory.add({
  content: '用户喜欢用 Python 写后端,最近在学 Rust',
  userId: 'user-123',
  metadata: { source: 'conversation' }
});

// 查询 — 混合 RAG + Memory 搜索
const results = await memory.search({
  query: '用户的技术偏好是什么?',
  userId: 'user-123',
});

// 获取用户画像(静态 + 动态属性)
const profile = await memory.getProfile({
  userId: 'user-123',
});
console.log(profile.static);  // { languages: ['Python', 'Rust'], role: 'backend-dev' }
console.log(profile.dynamic); // { recentInterest: 'Rust learning', lastActive: '...' }
连接器配置
// 连接 Google Drive,自动同步文档到记忆库
await memory.connectors.googleDrive({
  userId: 'user-123',
  webhook: true,  // 实时变更通知
  scopes: ['docs.readonly', 'drive.readonly'],
});

🔗 链接