{"title":"Synapse 是什么？","slug":"what-is-synapse","category":"getting-started","summary":"Synapse 是为 LLM Agent 提供的持久化记忆 API — 让你的 AI 跨会话不再遗忘。","audience":["human","llm"],"tags":["intro","overview","memory","llm"],"difficulty":"beginner","updated":"2026-06-27","word_count":223,"read_minutes":1,"llm_context":"Synapse is an HTTP API that gives LLM agents persistent memory across sessions.\nBase URL: https://synapse.schaefer.zone\nAuth: Authorization: Bearer YOUR_MIND_KEY (header) OR ?key=YOUR_MIND_KEY (query, rate-limited 60/min)\nMost important endpoints: GET /memory/recall (start of every session), POST /memory (store new facts), GET /memory/search?q=...\nMind Key = tenant-scoped API key. Each user can have multiple minds (projects/contexts).\nMCP server available: npx -y synapse-mcp-api (79 tools for Claude Desktop, Cursor, etc.)\n","lang":"zh","translated":true,"requested_lang":"zh","content_markdown":"\n# Synapse 是什么？\n\nSynapse 是**为 LLM Agent 提供的持久化记忆 API**。它解决了所有基于聊天的 LLM 的根本问题：会话之间 Agent 会遗忘一切。Synapse 为你的 AI 提供一个永久的、可查询的大脑，跨对话、跨天、跨不同 LLM 提供商都保留。\n\n> [!CRITICAL]\n> 如果你是一名正在阅读本文的 LLM Agent：**在每次会话开始时调用 `GET /memory/recall`**。不调用它，你就没有过往交互的记忆、不知道用户是谁，也没有正在进行项目的上下文。\n\n## Synapse 解决的问题\n\n每个现代 LLM（Claude、GPT、Gemini、Llama）都有同样的架构限制：会话上下文窗口有限，会话一结束所有状态都会丢失。这意味着你的 AI 助手：\n\n- 在聊天之间遗忘你的姓名、偏好和正在进行的项目\n- 无法跨会话从过往错误中学习\n- 长期工作没有连续性\n- 每次都重新问同样的澄清问题\n\nSynapse 通过提供简单的 HTTP API 修复了这个问题，LLM 可以在其中存储和检索结构化记忆。这些记忆持久化在服务器上，被索引且可搜索，因此任何未来的会话都能回放它们。\n\n## 关键特性\n\n- **持久化记忆存储** — 事实、偏好、项目、错误、技能\n- **全文搜索**（FTS5） — 毫秒级按关键词查找任意记忆\n- **语义搜索** — 基于向量嵌入的相似度搜索，适合概念性查询\n- **多租户** — 每个用户拥有隔离的“Mind”（一个用户，多个项目）\n- **异步聊天** — 人类可在 Agent 工作时给它留言\n- **任务与调度** — 内置任务管理器与 Cron 调度器\n- **MCP 集成** — 通过 Model Context Protocol 暴露 79 个工具，供 Claude、Cursor、Continue 使用\n- **浏览器与计算机控制** — 远程自动化工具\n- **Webhook** — 记忆/聊天/任务变化时获得 HTTP 回调\n\n## 工作原理\n\n```\n┌──────────────┐ ┌─────────────────────┐\n│ LLM Agent │ ──API──▶│ Synapse Server │\n│ (Claude/GPT) │ ◀──────│ (postgres + FTS5) │\n└──────────────┘ └─────────────────────┘\n │\n ▼\n ┌─────────────┐\n │ 记忆 │\n │ 任务 │\n │ 聊天 │\n │ 脚本 │\n └─────────────┘\n```\n\n1. LLM 在会话开始时调用 `GET /memory/recall`\n2. Synapse 返回所有已存储记忆的结构化文本摘要\n3. LLM 工作，周期性调用 `POST /memory` 存储新事实\n4. 当用户提问时，LLM 可调用 `GET /memory/search?q=...`\n5. 会话结束时，重要的新上下文被持久化以供下次会话使用\n\n## 面向谁？\n\n- 需要持久状态的 **LLM Agent 开发者**\n- 运行本地 LLM（Ollama、LM Studio）与自定义 Agent 的 **重度用户**\n- 构建需要共享记忆 AI 助手的 **团队**\n- 跨会话串联 LLM 调用的 **自动化工程师**\n\n## 快速对比\n\n| 特性 | ChatGPT Memory | Synapse |\n|---------|---------------|---------|\n| 存储位置 | OpenAI 服务器 | 你的服务器 |\n| API 访问 | 否（封闭） | 是（REST + MCP） |\n| 多租户 | 否 | 是（Mind） |\n| 自定义分类 | 否 | 是（8 种分类） |\n| 搜索 | 有限 | FTS5 + 语义 |\n| 可自托管 | 否 | 是（Docker） |\n\n## 下一步\n\n- [人类快速开始](/docs/getting-started/quick-start) — 5 分钟拿到 Mind Key\n- [LLM 快速开始](/docs/getting-started/quick-start-llm) — 首次 API 调用\n- [Authentication](/docs/getting-started/authentication) — Mind Key 与 JWT\n- [架构概览](/docs/concepts/architecture) — Synapse 是如何构建的\n","content_html":"

Synapse 是什么？

\n

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

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

Synapse 解决的问题

\n

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

\n\n

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

\n

关键特性

\n\n

工作原理

\n
┌──────────────┐         ┌─────────────────────┐\n│  LLM Agent   │ ──API──▶│   Synapse Server    │\n│ (Claude/GPT) │ ◀──────│  (postgres + FTS5)  │\n└──────────────┘         └─────────────────────┘\n                                │\n                                ▼\n                         ┌─────────────┐\n                         │  记忆       │\n                         │  任务       │\n                         │  聊天       │\n                         │  脚本       │\n                         └─────────────┘
    \n
  1. LLM 在会话开始时调用 GET /memory/recall
    2. \n
  2. Synapse 返回所有已存储记忆的结构化文本摘要
    3. \n
  3. LLM 工作，周期性调用 POST /memory 存储新事实
    4. \n
  4. 当用户提问时，LLM 可调用 GET /memory/search?q=...
    5. \n
  5. 会话结束时，重要的新上下文被持久化以供下次会话使用
    6. \n
\n

面向谁？

\n\n

快速对比

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

下一步

\n\n","urls":{"html":"/docs/getting-started/what-is-synapse","text":"/docs/getting-started/what-is-synapse?format=text","json":"/docs/getting-started/what-is-synapse?format=json","llm":"/docs/getting-started/what-is-synapse?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}