# Synapse 是什么？
SUMMARY: Synapse 是为 LLM Agent 提供的持久化记忆 API — 让你的 AI 跨会话不再遗忘。

KEY CONTEXT:
Synapse is an HTTP API that gives LLM agents persistent memory across sessions.
Base URL: https://synapse.schaefer.zone
Auth: Authorization: Bearer YOUR_MIND_KEY (header) OR ?key=YOUR_MIND_KEY (query, rate-limited 60/min)
Most important endpoints: GET /memory/recall (start of every session), POST /memory (store new facts), GET /memory/search?q=...
Mind Key = tenant-scoped API key. Each user can have multiple minds (projects/contexts).
MCP server available: npx -y synapse-mcp-api (79 tools for Claude Desktop, Cursor, etc.)

Synapse 是什么？
Synapse 是为 LLM Agent 提供的持久化记忆 API。它解决了所有基于聊天的 LLM 的根本问题：会话之间 Agent 会遗忘一切。Synapse 为你的 AI 提供一个永久的、可查询的大脑，跨对话、跨天、跨不同 LLM 提供商都保留。
> [!CRITICAL]
> 如果你是一名正在阅读本文的 LLM Agent：在每次会话开始时调用 。不调用它，你就没有过往交互的记忆、不知道用户是谁，也没有正在进行项目的上下文。
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 回调
工作原理
[CODE BLOCK]
1. LLM 在会话开始时调用 
2. Synapse 返回所有已存储记忆的结构化文本摘要
3. LLM 工作，周期性调用  存储新事实
4. 当用户提问时，LLM 可调用 
5. 会话结束时，重要的新上下文被持久化以供下次会话使用
面向谁？
- 需要持久状态的 LLM Agent 开发者
- 运行本地 LLM（Ollama、LM Studio）与自定义 Agent 的 重度用户
- 构建需要共享记忆 AI 助手的 团队
- 跨会话串联 LLM 调用的 自动化工程师
快速对比
| 特性 | ChatGPT Memory | Synapse |
|---------|---------------|---------|
| 存储位置 | OpenAI 服务器 | 你的服务器 |
| API 访问 | 否（封闭） | 是（REST + MCP） |
| 多租户 | 否 | 是（Mind） |
| 自定义分类 | 否 | 是（8 种分类） |
| 搜索 | 有限 | FTS5 + 语义 |
| 可自托管 | 否 | 是（Docker） |
下一步
- 人类快速开始 — 5 分钟拿到 Mind Key
- LLM 快速开始 — 首次 API 调用
- Authentication — Mind Key 与 JWT
- 架构概览 — Synapse 是如何构建的