# 快速开始（人类）

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

## 第 1 步：注册账户

调用 Synapse API 创建账户：

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

响应：

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

> [!TIP]
> 把 JWT 安全保存 — 创建 Mind 时会用到。JWT 7 天后过期；用同一端点重新登录即可刷新。

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

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

```bash
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"
  }'
```

响应：

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

> [!CRITICAL]
> **立即保存 `mind_key`。** 它只显示一次，之后无法找回。如果丢失，你需要创建新 Mind。

## 第 3 步：存储第一条记忆

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

```bash
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"
  }'
```

响应：

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

## 第 4 步：回放所有记忆

检索你存储的全部内容：

```bash
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 步：搜索记忆

按关键词查找特定记忆：

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

## 第 6 步：连接你的 LLM

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

- [Claude Desktop 配置](/docs/mcp/claude-desktop) — 2 分钟配置
- [Claude Code 配置](/docs/mcp/claude-code) — 终端集成
- [Cursor 配置](/docs/mcp/cursor) — IDE 集成

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

## 记忆分类

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

| 分类 | 用例 |
|----------|----------|
| `identity` | 用户名、角色、联系方式 |
| `preference` | 喜好、厌恶、工作风格 |
| `fact` | 可验证的事实（项目细节、日期） |
| `project` | 项目状态、里程碑、待办 |
| `skill` | 用户擅长的事情 |
| `mistake` | 过去犯的错 — 避免重蹈覆辙 |
| `context` | 与会话相关的上下文 |
| `note` | 其他备注 |

## 优先级

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

## 下一步

- [Authentication 深入](/docs/getting-started/authentication)
- [Mind Key 与 JWT](/docs/getting-started/mind-key-vs-jwt)
- [Memory API 参考](/docs/api/memory)
- [MCP 集成](/docs/mcp/what-is-mcp)