{"title":"快速开始（人类）","slug":"quick-start","category":"getting-started","summary":"注册账户、创建你的第一个 Mind、存储第一条记忆 — 全部 5 分钟完成。","audience":["human"],"tags":["quickstart","human","register","mind-key"],"difficulty":"beginner","updated":"2026-06-27","word_count":197,"read_minutes":1,"lang":"zh","translated":true,"requested_lang":"zh","content_markdown":"\n# 快速开始（人类）\n\n本指南带你完成获取 Synapse 账户、第一个 Mind Key 并存储第一条记忆。总耗时：约 5 分钟。\n\n## 第 1 步：注册账户\n\n调用 Synapse API 创建账户：\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/register \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"email\": \"you@example.com\",\n \"password\": \"your-secure-password\"\n }'\n```\n\n响应：\n\n```json\n{\n \"jwt\": \"eyJhbGci...\",\n \"user\": { \"id\": \"u_abc123\", \"email\": \"you@example.com\" }\n}\n```\n\n> [!TIP]\n> 把 JWT 安全保存 — 创建 Mind 时会用到。JWT 7 天后过期；用同一端点重新登录即可刷新。\n\n## 第 2 步：创建你的第一个 Mind\n\n“Mind” 是一个隔离的记忆范围。大多数用户从一个 Mind 开始，但你可以有多个（例如 “work”、“personal”、“project-x”）。每个 Mind 都有自己唯一的 Mind Key。\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/minds \\\n -H \"Authorization: Bearer YOUR_JWT\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"name\": \"My First Mind\",\n \"description\": \"Personal assistant memory\"\n }'\n```\n\n响应：\n\n```json\n{\n \"id\": \"m_xyz789\",\n \"name\": \"My First Mind\",\n \"mind_key\": \"mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789\",\n \"created_at\": \"2026-06-27T...\"\n}\n```\n\n> [!CRITICAL]\n> **立即保存 `mind_key`。** 它只显示一次，之后无法找回。如果丢失，你需要创建新 Mind。\n\n## 第 3 步：存储第一条记忆\n\n现在用 Mind Key 存储一条记忆：\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/memory \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"category\": \"identity\",\n \"key\": \"user_name\",\n \"content\": \"My name is Michael\",\n \"tags\": [\"personal\", \"identity\"],\n \"priority\": \"critical\"\n }'\n```\n\n响应：\n\n```json\n{\n \"id\": \"mem_001\",\n \"status\": \"stored\",\n \"mind_id\": \"m_xyz789\"\n}\n```\n\n## 第 4 步：回放所有记忆\n\n检索你存储的全部内容：\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/recall\n```\n\n响应（纯文本，为 LLM 消费优化）：\n\n```\nMind: My First Mind\nMemories: 1 total (1 verified)\n\n[001] identity (CRITICAL)\n user_name\n My name is Michael\n Tags: personal, identity\n Stored: 2026-06-27\n```\n\n## 第 5 步：搜索记忆\n\n按关键词查找特定记忆：\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=michael\"\n```\n\n## 第 6 步：连接你的 LLM\n\n让 LLM 访问 Synapse 最简单的方式是通过 MCP：\n\n- [Claude Desktop 配置](/docs/mcp/claude-desktop) — 2 分钟配置\n- [Claude Code 配置](/docs/mcp/claude-code) — 终端集成\n- [Cursor 配置](/docs/mcp/cursor) — IDE 集成\n\n配置完成后，你的 LLM 会在每次会话开始时自动调用 `memory_recall`，并通过 `memory_store` 持久化新事实。\n\n## 记忆分类\n\nSynapse 支持 8 种分类 — 选择最具体的那一种：\n\n| 分类 | 用例 |\n|----------|----------|\n| `identity` | 用户名、角色、联系方式 |\n| `preference` | 喜好、厌恶、工作风格 |\n| `fact` | 可验证的事实（项目细节、日期） |\n| `project` | 项目状态、里程碑、待办 |\n| `skill` | 用户擅长的事情 |\n| `mistake` | 过去犯的错 — 避免重蹈覆辙 |\n| `context` | 与会话相关的上下文 |\n| `note` | 其他备注 |\n\n## 优先级\n\n- `low` — 知道就好\n- `normal` — 默认\n- `high` — 重要\n- `critical` — 绝不能忘（用户身份、法律信息）\n\n## 下一步\n\n- [Authentication 深入](/docs/getting-started/authentication)\n- [Mind Key 与 JWT](/docs/getting-started/mind-key-vs-jwt)\n- [Memory API 参考](/docs/api/memory)\n- [MCP 集成](/docs/mcp/what-is-mcp)\n","content_html":"

快速开始（人类）

\n

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

\n

第 1 步：注册账户

\n

调用 Synapse API 创建账户：

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

响应：

\n
{\n  "jwt": "eyJhbGci...",\n  "user": { "id": "u_abc123", "email": "you@example.com" }\n}
把 JWT 安全保存 — 创建 Mind 时会用到。JWT 7 天后过期；用同一端点重新登录即可刷新。

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

\n

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

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

响应：

\n
{\n  "id": "m_xyz789",\n  "name": "My First Mind",\n  "mind_key": "mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789",\n  "created_at": "2026-06-27T..."\n}
**立即保存 `mind_key`。** 它只显示一次，之后无法找回。如果丢失，你需要创建新 Mind。

第 3 步：存储第一条记忆

\n

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

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

响应：

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

第 4 步：回放所有记忆

\n

检索你存储的全部内容：

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

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

\n
Mind: My First Mind\nMemories: 1 total (1 verified)\n\n[001] identity (CRITICAL)\n  user_name\n  My name is Michael\n  Tags: personal, identity\n  Stored: 2026-06-27

第 5 步：搜索记忆

\n

按关键词查找特定记忆：

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

第 6 步：连接你的 LLM

\n

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

\n\n

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

\n

记忆分类

\n

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

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

优先级

\n\n

下一步

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