快速开始（人类）

本指南带你完成获取 Synapse 账户、第一个 Mind Key 并存储第一条记忆。总耗时：约 5 分钟。

第 1 步：注册账户

调用 Synapse API 创建账户：

curl -X POST https://synapse.schaefer.zone/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@example.com",
    "password": "your-secure-password"
  }'

响应：

{
  "jwt": "eyJhbGci...",
  "user": { "id": "u_abc123", "email": "you@example.com" }
}

第 2 步：创建你的第一个 Mind

“Mind” 是一个隔离的记忆范围。大多数用户从一个 Mind 开始，但你可以有多个（例如 “work”、“personal”、“project-x”）。每个 Mind 都有自己唯一的 Mind Key。

curl -X POST https://synapse.schaefer.zone/minds \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My First Mind",
    "description": "Personal assistant memory"
  }'

响应：

{
  "id": "m_xyz789",
  "name": "My First Mind",
  "mind_key": "mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789",
  "created_at": "2026-06-27T..."
}

第 3 步：存储第一条记忆

现在用 Mind Key 存储一条记忆：

curl -X POST https://synapse.schaefer.zone/memory \
  -H "Authorization: Bearer YOUR_MIND_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "category": "identity",
    "key": "user_name",
    "content": "My name is Michael",
    "tags": ["personal", "identity"],
    "priority": "critical"
  }'

响应：

{
  "id": "mem_001",
  "status": "stored",
  "mind_id": "m_xyz789"
}

第 4 步：回放所有记忆

检索你存储的全部内容：

curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/memory/recall

响应（纯文本，为 LLM 消费优化）：

Mind: My First Mind
Memories: 1 total (1 verified)

[001] identity (CRITICAL)
  user_name
  My name is Michael
  Tags: personal, identity
  Stored: 2026-06-27

第 5 步：搜索记忆

按关键词查找特定记忆：

curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     "https://synapse.schaefer.zone/memory/search?q=michael"

第 6 步：连接你的 LLM

让 LLM 访问 Synapse 最简单的方式是通过 MCP：

• Claude Desktop 配置 — 2 分钟配置
• Claude Code 配置 — 终端集成
• Cursor 配置 — IDE 集成

配置完成后，你的 LLM 会在每次会话开始时自动调用 memory_recall，并通过 memory_store 持久化新事实。

记忆分类

Synapse 支持 8 种分类 — 选择最具体的那一种：

优先级

• low — 知道就好
• normal — 默认
• high — 重要
• critical — 绝不能忘（用户身份、法律信息）

下一步

• Authentication 深入
• Mind Key 与 JWT
• Memory API 参考
• MCP 集成