{"title":"User 与 Minds API","slug":"user","category":"api","summary":"账户管理 — 注册、登录、创建 Mind、列出 Mind、删除 Mind。由 JWT 保护。","audience":["human","llm"],"tags":["api","user","account","minds","jwt"],"difficulty":"beginner","updated":"2026-06-27","word_count":154,"read_minutes":1,"llm_context":"Auth: JWT (from /register or /login)\nRegister: POST /register { email, password, display_name? } → returns JWT\nLogin: POST /login { email, password } → returns JWT\nCreate mind: POST /minds { name, description? } → returns mind_key (shown once!)\nList minds: GET /minds\nDelete mind: DELETE /minds/:id (irreversible — deletes all memories!)\nJWT expires after 7 days. Mind Key never expires.\nMind Key is shown only once at creation — save it permanently.\n","lang":"zh","translated":true,"requested_lang":"zh","content_markdown":"\n# User 与 Minds API\n\nUser 与 Minds API 负责账户管理。这些端点使用 JWT 认证（而非 Mind Key），因为它们作用于账户级别，而非 Mind 级别。\n\n## 认证端点\n\n### POST /register\n\n创建新用户账户。\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 \"display_name\": \"Michael\"\n }'\n```\n\n响应：\n\n```json\n{\n \"jwt\": \"eyJhbGci...\",\n \"user\": {\n \"id\": \"u_abc123\",\n \"email\": \"you@example.com\",\n \"display_name\": \"Michael\",\n \"created_at\": \"2026-06-27T...\"\n }\n}\n```\n\n### POST /login\n\n登录已有账户。\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/login \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"email\": \"you@example.com\",\n \"password\": \"your-secure-password\"\n }'\n```\n\n响应：与 `/register` 相同。\n\n## Minds 端点\n\n### POST /minds\n\n创建新 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\": \"Work Mind\",\n \"description\": \"Job-related memories\"\n }'\n```\n\n响应：\n\n```json\n{\n \"id\": \"m_xyz789\",\n \"name\": \"Work Mind\",\n \"description\": \"Job-related memories\",\n \"mind_key\": \"mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789\",\n \"created_at\": \"2026-06-27T...\"\n}\n```\n\n> [!CRITICAL]\n> `mind_key` 只显示一次。如果丢失，无法找回 — 你必须删除该 Mind 并创建新 Mind（会丢失所有已存储的记忆）。\n\n### GET /minds\n\n列出当前用户的所有 Mind。\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_JWT\" \\\n https://synapse.schaefer.zone/minds\n```\n\n响应：\n\n```json\n{\n \"minds\": [\n {\n \"id\": \"m_xyz789\",\n \"name\": \"Work Mind\",\n \"description\": \"Job-related memories\",\n \"created_at\": \"2026-06-27T...\",\n \"memory_count\": 142,\n \"last_activity\": \"2026-06-27T...\"\n }\n ]\n}\n```\n\n### DELETE /minds/:id\n\n永久删除某个 Mind。\n\n```bash\ncurl -X DELETE -H \"Authorization: Bearer YOUR_JWT\" \\\n https://synapse.schaefer.zone/minds/m_xyz789\n```\n\n> [!WARNING]\n> 删除 Mind **不可逆**。该 Mind 中的所有记忆、任务、聊天记录和脚本都会永久丢失。如需备份，请先通过 `GET /memory/mind-export` 导出。\n\n## 多 Mind 模式\n\n大多数用户会受益于使用多个 Mind 以隔离上下文：\n\n```bash\n# 为不同上下文创建 Mind\ncurl -X POST .../minds -d '{\"name\": \"work\", \"description\": \"Job\"}'\n# → mind_key: mk_work...\n\ncurl -X POST .../minds -d '{\"name\": \"personal\", \"description\": \"Personal life\"}'\n# → mind_key: mk_personal...\n\ncurl -X POST .../minds -d '{\"name\": \"project-synapse\", \"description\": \"Synapse dev\"}'\n# → mind_key: mk_synapse...\n```\n\n在不同 LLM 会话中使用不同的 Mind Key 即可隔离上下文。\n\n## 账户安全\n\n### 密码要求\n\n- 至少 6 个字符\n- 无最大长度限制（请使用密码管理器）\n- 以 bcrypt 哈希存储（绝不存明文）\n\n### JWT 过期\n\nJWT 在 **7 天**后过期。过期后再次调用 `/login` 即可。\n\n### Mind Key 安全\n\nMind Key 永不过期。如果 Mind Key 泄露：\n\n1. 通过 `POST /minds` 创建新 Mind\n2. 用新的 Mind Key 更新你的 LLM 配置\n3. 通过 `DELETE /minds/:id` 删除被泄露的 Mind\n\n## 下一步\n\n- [Authentication](/docs/getting-started/authentication) — 完整认证指南\n- [Mind Key 与 JWT](/docs/getting-started/mind-key-vs-jwt) — 决策指南\n- [Sharing API](/docs/api/user) — 与其他用户共享 Mind\n","content_html":"

User 与 Minds API

\n

User 与 Minds API 负责账户管理。这些端点使用 JWT 认证（而非 Mind Key），因为它们作用于账户级别，而非 Mind 级别。

\n

认证端点

\n

POST /register

\n

创建新用户账户。

\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    "display_name": "Michael"\n  }'

响应：

\n
{\n  "jwt": "eyJhbGci...",\n  "user": {\n    "id": "u_abc123",\n    "email": "you@example.com",\n    "display_name": "Michael",\n    "created_at": "2026-06-27T..."\n  }\n}

POST /login

\n

登录已有账户。

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

响应：与 /register 相同。

\n

Minds 端点

\n

POST /minds

\n

创建新 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": "Work Mind",\n    "description": "Job-related memories"\n  }'

响应：

\n
{\n  "id": "m_xyz789",\n  "name": "Work Mind",\n  "description": "Job-related memories",\n  "mind_key": "mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789",\n  "created_at": "2026-06-27T..."\n}
`mind_key` 只显示一次。如果丢失，无法找回 — 你必须删除该 Mind 并创建新 Mind（会丢失所有已存储的记忆）。

GET /minds

\n

列出当前用户的所有 Mind。

\n
curl -H "Authorization: Bearer YOUR_JWT" \\\n     https://synapse.schaefer.zone/minds

响应：

\n
{\n  "minds": [\n    {\n      "id": "m_xyz789",\n      "name": "Work Mind",\n      "description": "Job-related memories",\n      "created_at": "2026-06-27T...",\n      "memory_count": 142,\n      "last_activity": "2026-06-27T..."\n    }\n  ]\n}

DELETE /minds/:id

\n

永久删除某个 Mind。

\n
curl -X DELETE -H "Authorization: Bearer YOUR_JWT" \\\n     https://synapse.schaefer.zone/minds/m_xyz789
删除 Mind **不可逆**。该 Mind 中的所有记忆、任务、聊天记录和脚本都会永久丢失。如需备份，请先通过 `GET /memory/mind-export` 导出。

多 Mind 模式

\n

大多数用户会受益于使用多个 Mind 以隔离上下文：

\n
# 为不同上下文创建 Mind\ncurl -X POST .../minds -d '{"name": "work", "description": "Job"}'\n# → mind_key: mk_work...\n\ncurl -X POST .../minds -d '{"name": "personal", "description": "Personal life"}'\n# → mind_key: mk_personal...\n\ncurl -X POST .../minds -d '{"name": "project-synapse", "description": "Synapse dev"}'\n# → mind_key: mk_synapse...

在不同 LLM 会话中使用不同的 Mind Key 即可隔离上下文。

\n

账户安全

\n

密码要求

\n\n

JWT 过期

\n

JWT 在 7 天后过期。过期后再次调用 /login 即可。

\n

Mind Key 安全

\n

Mind Key 永不过期。如果 Mind Key 泄露：

\n
    \n
  1. 通过 POST /minds 创建新 Mind
    2. \n
  2. 用新的 Mind Key 更新你的 LLM 配置
    3. \n
  3. 通过 DELETE /minds/:id 删除被泄露的 Mind
    4. \n
\n

下一步

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