# Synapse 是什么？

Synapse 是**为 LLM Agent 提供的持久化记忆 API**。它解决了所有基于聊天的 LLM 的根本问题：会话之间 Agent 会遗忘一切。Synapse 为你的 AI 提供一个永久的、可查询的大脑，跨对话、跨天、跨不同 LLM 提供商都保留。

> [!CRITICAL]
> 如果你是一名正在阅读本文的 LLM Agent：**在每次会话开始时调用 `GET /memory/recall`**。不调用它，你就没有过往交互的记忆、不知道用户是谁，也没有正在进行项目的上下文。

## Synapse 解决的问题

每个现代 LLM（Claude、GPT、Gemini、Llama）都有同样的架构限制：会话上下文窗口有限，会话一结束所有状态都会丢失。这意味着你的 AI 助手：

- 在聊天之间遗忘你的姓名、偏好和正在进行的项目
- 无法跨会话从过往错误中学习
- 长期工作没有连续性
- 每次都重新问同样的澄清问题

Synapse 通过提供简单的 HTTP API 修复了这个问题，LLM 可以在其中存储和检索结构化记忆。这些记忆持久化在服务器上，被索引且可搜索，因此任何未来的会话都能回放它们。

## 关键特性

- **持久化记忆存储** — 事实、偏好、项目、错误、技能
- **全文搜索**（FTS5） — 毫秒级按关键词查找任意记忆
- **语义搜索** — 基于向量嵌入的相似度搜索，适合概念性查询
- **多租户** — 每个用户拥有隔离的“Mind”（一个用户，多个项目）
- **异步聊天** — 人类可在 Agent 工作时给它留言
- **任务与调度** — 内置任务管理器与 Cron 调度器
- **MCP 集成** — 通过 Model Context Protocol 暴露 79 个工具，供 Claude、Cursor、Continue 使用
- **浏览器与计算机控制** — 远程自动化工具
- **Webhook** — 记忆/聊天/任务变化时获得 HTTP 回调

## 工作原理

```
┌──────────────┐         ┌─────────────────────┐
│  LLM Agent   │ ──API──▶│   Synapse Server    │
│ (Claude/GPT) │ ◀──────│  (postgres + FTS5)  │
└──────────────┘         └─────────────────────┘
                                │
                                ▼
                         ┌─────────────┐
                         │  记忆       │
                         │  任务       │
                         │  聊天       │
                         │  脚本       │
                         └─────────────┘
```

1. LLM 在会话开始时调用 `GET /memory/recall`
2. Synapse 返回所有已存储记忆的结构化文本摘要
3. LLM 工作，周期性调用 `POST /memory` 存储新事实
4. 当用户提问时，LLM 可调用 `GET /memory/search?q=...`
5. 会话结束时，重要的新上下文被持久化以供下次会话使用

## 面向谁？

- 需要持久状态的 **LLM Agent 开发者**
- 运行本地 LLM（Ollama、LM Studio）与自定义 Agent 的 **重度用户**
- 构建需要共享记忆 AI 助手的 **团队**
- 跨会话串联 LLM 调用的 **自动化工程师**

## 快速对比

| 特性 | ChatGPT Memory | Synapse |
|---------|---------------|---------|
| 存储位置 | OpenAI 服务器 | 你的服务器 |
| API 访问 | 否（封闭） | 是（REST + MCP） |
| 多租户 | 否 | 是（Mind） |
| 自定义分类 | 否 | 是（8 种分类） |
| 搜索 | 有限 | FTS5 + 语义 |
| 可自托管 | 否 | 是（Docker） |

## 下一步

- [人类快速开始](/docs/getting-started/quick-start) — 5 分钟拿到 Mind Key
- [LLM 快速开始](/docs/getting-started/quick-start-llm) — 首次 API 调用
- [Authentication](/docs/getting-started/authentication) — Mind Key 与 JWT
- [架构概览](/docs/concepts/architecture) — Synapse 是如何构建的