from supermemory import Supermemory

client = Supermemory()

client.add(
    content="用户喜欢 TypeScript，偏爱函数式编程",
    container_tag="user_123"
)

result = client.profile(
    container_tag="user_123",
    q="编程风格偏好"
)
print(result.profile.static)
print(result.profile.dynamic)
```textbash
npx -y install-mcp@latest https://mcp.supermemory.ai/mcp --client claude --oauth=yes
```texttypescript
// 混合搜索（默认）— RAG + Memory
const results = await client.search.memories({
    q: "部署偏好",
    containerTag: "user_123",
    searchMode: "hybrid"
});

// 仅记忆搜索
const results = await client.search.memories({
    q: "用户偏好",
    containerTag: "user_123",
    searchMode: "memories"
});
```texttypescript
const { profile } = await client.profile({
    containerTag: "user_123"
});

// profile.static → ["Acme 高级工程师", "喜欢深色模式", "使用 Vim"]
// profile.dynamic → ["正在做 auth 迁移项目", "调试 API rate limits"]
```texttypescript
const doc = await client.documents.uploadFile({
    file: "./report.pdf",
    containerTag: "project_abc"
});

const docs = await client.documents.list({
    containerTag: "project_abc",
    filter: { type: "pdf" }
});
```texttypescript
import { withSupermemory } from "@supermemory/tools/ai-sdk";
import { openai } from "ai-sdk";

const model = withSupermemory(
    openai("gpt-4o"),
    "user_123"
);
```texttypescript
import { withSupermemory } from "@supermemory/tools/mastra";

const agent = new Agent(
    withSupermemory(config, "user-123", {
        mode: "full"
    })
);
```text
┌─────────────────────────────────────┐
│         Your App / AI Tool           │
└─────────────────┬───────────────────┘
                  │
┌─────────────────▼───────────────────┐
│          Supermemory                 │
│  ┌────────────────────────────────┐ │
│  │     Memory Engine              │ │
│  │  · 事实提取                    │ │
│  │  · 时序变化追踪                │ │
│  │  · 矛盾消解                    │ │
│  │  · 自动遗忘                    │ │
│  └────────────────────────────────┘ │
│  ┌────────────────────────────────┐ │
│  │     User Profiles              │ │
│  │  · Static Facts（静态事实）    │ │
│  │  · Dynamic Context（动态上下文）│ │
│  └────────────────────────────────┘ │
│  ┌────────────────────────────────┐ │
│  │     Hybrid Search              │ │
│  │  · RAG（知识库检索）          │ │
│  │  · Memory（个性化记忆）        │ │
│  └────────────────────────────────┘ │
│  ┌────────────────────────────────┐ │
│  │     Connectors                 │ │
│  │  · Google Drive / Gmail       │ │
│  │  · Notion / OneDrive         │ │
│  │  · GitHub / Web Crawler      │ │
│  └────────────────────────────────┘ │
│  ┌────────────────────────────────┐ │
│  │     Multi-modal Extractors     │ │
│  │  · PDF / Images (OCR)         │ │
│  │  · Videos (Transcription)     │ │
│  │  · Code (AST-aware)          │ │
│  └────────────────────────────────┘ │
└─────────────────────────────────────┘
```text
用户：我最近在做一个电商平台的支付系统，后端用 Go
AI：了解了，支付系统 + Go 后端
```text
用户：帮我设计支付模块的 API 接口
```text
supermemory/
├── apps/
├── packages/
├── skills/
│   └── supermemory/
├── .github/workflows/
├── turbo.json
├── biome.json
├── bun.lock
└── package.json
```text
用户：我想取消订阅
AI：
  → Supermemory 检索用户历史
  → 发现：用户于 2025年3月 订阅了年费会员
  → 自动将订阅状态、购买历史注入上下文
  → 提供精准的取消帮助
```text
用户1：我在做一个新项目，是电商平台的支付系统
用户1：我偏好使用 Stripe 而不是 PayPal

[第二天]

用户1：帮我设计支付模块
AI：
  → Supermemory 检索"用户偏好 Stripe"
  → 检索"电商项目背景"
  → 直接基于 Stripe 设计，不提 PayPal
```text
新员工：我们的技术栈是什么？
AI：
  → Supermemory 检索公司知识库
  → 结合员工背景（前端工程师）
  → 返回：React/Next.js 后端，部署在 Vercel
```textbash
bun run src/index.ts run -p supermemory -b longmemeval -j gpt-4o -r my-run
```texttypescript
await client.add({
    content: "用户正在开发支付系统",
    containerTag: "work_project_abc"
});

await client.add({
    content: "用户在学 Rust",
    containerTag: "personal_learning"
});
```texttypescript
const { profile } = await client.profile({
    containerTag: "user_123"
});

const systemPrompt = `
用户信息：
- 长期背景：${profile.static.join(", ")}
- 当前上下文：${profile.dynamic.join(", ")}
`;
```textbash
git checkout -b feature/new-feature
# 遵循 CONTRIBUTING.md 规范提交 PR