supermemoryai supermemory

以下是翻译后的中文版本，保留了原文结构、技术术语和代码块：

supermemoryai supermemory

面向 AI 的最先进记忆与上下文引擎。没错——你可以将其用作公司或个人大脑。文档 · 快速入门 · 仪表盘 · Discord

Supermemory 是 AI 的记忆与上下文层。在 LongMemEval、LoCoMo 和 ConvoMem 这三大 AI 记忆基准测试中均排名第一。我们是一个研究实验室，围绕它构建引擎、插件和工具。

你的 AI 会在对话之间忘记一切。Supermemory 解决了这个问题。它能自动从对话中学习、提取事实、构建用户画像、处理知识更新与矛盾、遗忘过期信息，并在正确的时间提供正确的上下文。完整的 RAG、连接器、文件处理——整个上下文栈，一个系统搞定。

🧠 记忆：从对话中提取事实。处理时间变化、矛盾以及自动遗忘。
👤 用户画像：自动维护的用户上下文——稳定事实 + 近期活动。一次调用，约 50ms。
🔍 混合搜索：单次查询中的 RAG + 记忆。知识库文档与个性化上下文一起返回。
🔌 连接器：Google Drive · Gmail · Notion · OneDrive · GitHub——通过实时 webhook 自动同步。
📄 多模态提取器：PDF、图片（OCR）、视频（转录）、代码（AST 感知分块）。上传即可使用。

所有这些都包含在我们单一的记忆结构与本体中。

使用 Supermemory

🧑‍💻 我使用 AI 工具

通过使用我们的应用，构建你自己的个人超级记忆。在每一次对话中建立持久的记忆图谱。你的 AI 会记住你的偏好、项目、过往讨论——并随时间推移变得更智能。 → 跳转到用户设置

🔧 我在构建 AI 产品

通过单一 API 为你的智能体和应用添加记忆、RAG、用户画像和连接器。无需向量数据库配置。无需嵌入管道。无需分块策略。 → 跳转到开发者快速入门

为你的 AI 赋予记忆

Supermemory 应用、浏览器扩展、插件和 MCP 服务器为任何兼容的 AI 助手提供持久记忆。一次安装，你的 AI 就能记住你。

应用

你可以无需编写任何代码，通过面向消费者的免费应用使用 Supermemory。从 https://app.supermemory.ai 开始它还内置了一个名为 Nova 的智能体。

Supermemory 插件

Supermemory 内置了针对 Claude Code、OpenCode、OpenClaw 和 Hermes 的插件。这些插件是 Supermemory API 的实现，并且是开源的！你可以在这里找到它们：

Openclaw 插件：https://github.com/supermemoryai/openclaw-supermemory
Claude code 插件：https://github.com/supermemoryai/claude-supermemory
OpenCode 插件：https://github.com/supermemoryai/opencode-supermemory
Hermes 智能体（Supermemory 记忆提供者）：https://github.com/NousResearch/hermes-agent

MCP - 快速安装

npx -y install-mcp@latest https://mcp.supermemory.ai/mcp --client claude --oauth=yes

将 claude 替换为你的客户端：cursor、windsurf、vscode 等。在此处了解更多关于 MCP 的信息：https://supermemory.ai/docs/supermemory-mcp/mcp

你的 AI 获得什么

| 工具 | 功能 | |------|------| | memory | 保存或遗忘信息。当你分享值得记住的内容时，你的 AI 会自动调用此功能。 | | recall | 按查询搜索记忆。返回相关记忆 + 你的用户画像摘要。 | | context | 在对话开始时注入你的完整画像（偏好、近期活动）。在 Cursor 和 Claude Code 中，只需输入 /context。 |

工作原理

安装后，Supermemory 在后台运行：

你正常与 AI 对话。
分享偏好、提及项目、讨论问题。
Supermemory 提取并存储重要内容——事实、偏好、项目上下文——而不是噪音。
下一次对话时，你的 AI 已经了解你。它会回忆起你正在做什么、你喜欢什么、你之前讨论过什么。

记忆通过项目（容器标签）进行范围划分，因此你可以将工作与个人上下文分开，或按客户、仓库或其他任何内容进行组织。

支持的客户端

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

MCP 服务器是开源的——查看源代码。

手动配置

将以下内容添加到你的 MCP 客户端配置中：

{
  "mcpServers": {
    "supermemory": {
      "url": "https://mcp.supermemory.ai/mcp"
    }
  }
}

或者使用 API 密钥代替 OAuth：

{
  "mcpServers": {
    "supermemory": {
      "url": "https://mcp.supermemory.ai/mcp",
      "headers": {
        "Authorization": "Bearer sm_your_api_key_here"
      }
    }
  }
}

使用 Supermemory 构建（API）

如果你正在构建 AI 智能体或应用，Supermemory 通过一个 API 为你提供完整的上下文栈——记忆、RAG、用户画像、连接器和文件处理。

安装

npm install supermemory
# 或：
pip install supermemory

快速入门

import Supermemory from "supermemory";

const client = new Supermemory();

// 存储一段对话
await client.add({
  content: "User loves TypeScript and prefers functional patterns",
  containerTag: "user_123",
});

// 一次调用获取用户画像 + 相关记忆
const { profile, searchResults } = await client.profile({
  containerTag: "user_123",
  q: "What programming style does the user prefer?",
});

// profile.static → ["Loves TypeScript", "Prefers functional patterns"]
// profile.dynamic → ["Working on API integration"]
// searchResults → 按相似度排序的相关记忆

from supermemory import Supermemory

client = Supermemory()
client.add(
    content="User loves TypeScript and prefers functional patterns",
    container_tag="user_123"
)

result = client.profile(
    container_tag="user_123",
    q="programming style"
)
print(result.profile.static)  # 长期事实
print(result.profile.dynamic) # 近期上下文

Supermemory 自动提取记忆、构建用户画像并返回相关上下文。无需嵌入管道、无需向量数据库配置、无需分块策略。

框架集成

针对每个主流 AI 框架的即插即用封装：

// Vercel AI SDK
import { withSupermemory } from "@supermemory/tools/ai-sdk";

const model = withSupermemory(openai("gpt-4o"), {
  containerTag: "user_123",
  customId: "conv-1",
});

// Mastra
import { wi