elite-longterm-memory — 最终AI智能记忆系统

AI 智能体的终极记忆系统。 将 6 种经过验证的方法结合成一个无懈可击的架构。

永不丢失上下文。永不忘记决策。永不重复错误。

架构概述

┌─────────────────────────────────────────────────────────────────┐
│                    ELITE LONGTERM MEMORY                        │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐             │
│  │   HOT RAM   │  │  WARM STORE │  │  COLD STORE │             │
│  │             │  │             │  │             │             │
│  │ SESSION-    │  │  LanceDB    │  │  Git-Notes  │             │
│  │ STATE.md    │  │  Vectors    │  │  Knowledge  │             │
│  │             │  │             │  │  Graph      │             │
│  │ (survives   │  │ (semantic   │  │ (permanent  │             │
│  │  compaction)│  │  search)    │  │  decisions) │             │
│  └─────────────┘  └─────────────┘  └─────────────┘             │
│         │                │                │                     │
│         └────────────────┼────────────────┘                     │
│                          ▼                                      │
│                  ┌─────────────┐                                │
│                  │  MEMORY.md  │  ← Curated long-term           │
│                  │  + daily/   │    (human-readable)            │
│                  └─────────────┘                                │
│                          │                                      │
│                          ▼                                      │
│                  ┌─────────────┐                                │
│                  │ SuperMemory │  ← Cloud backup (optional)     │
│                  │    API      │                                │
│                  └─────────────┘                                │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

5 层记忆架构

Layer 1: HOT RAM (SESSION-STATE.md)

活跃的工作内存，可在压缩后存活。Write-Ahead Log 协议。

# SESSION-STATE.md — Active Working Memory
Current Task
[我们现在正在处理的任务]
Key Context
用户偏好: ...
已做出的决策: ...
障碍: ...
Pending Actions
[ ] ...

规则: 在响应前写入。由用户输入触发，而非智能体记忆。

Layer 2: WARM STORE (LanceDB Vectors)

跨所有记忆的语义搜索。自动召回注入相关上下文。

# Auto-recall (自动发生)
memory_recall query="project status" limit=5
# Manual store
memory_store text="User prefers dark mode" category="preference" importance=0.9

Layer 3: COLD STORE (Git-Notes Knowledge Graph)

结构化决策、学习内容和上下文。支持分支感知。

# Store a decision (SILENT - never announce)
python3 memory.py -p $DIR remember '{"type":"decision","content":"Use React for frontend"}' -t tech -i h
# Retrieve context
python3 memory.py -p $DIR get "frontend"

Layer 4: CURATED ARCHIVE (MEMORY.md + daily/)

人类可读的长期记忆。每日日志 + 提炼的智慧。

workspace/
├── MEMORY.md              # Curated long-term (精华内容)
└── memory/
    ├── 2026-01-30.md      # Daily log
    ├── 2026-01-29.md
    └── topics/            # Topic-specific files

Layer 5: CLOUD BACKUP (SuperMemory) — 可选

跨设备同步。与您的知识库聊天。

export SUPERMEMORY_API_KEY="your-key"
supermemory add "Important context"
supermemory search "what did we decide about..."

Layer 6: AUTO-EXTRACTION (Mem0) — 推荐

Mem0 自动从对话中提取事实。减少 80% 令牌。

npm install mem0ai
export MEM0_API_KEY="your-key"

const { MemoryClient } = require('mem0ai');
const client = new MemoryClient({ apiKey: process.env.MEM0_API_KEY });
// Conversations auto-extract facts
await client.add(messages, { user_id: "user123" });
// Retrieve relevant memories
const memories = await client.search(query, { user_id: "user123" });

优势:

• 自动提取偏好、决策、事实
• 去重并更新现有记忆