Base：NEXT_PUBLIC_API_URL（本地 http://localhost:8000）。
鉴权：Authorization: Bearer <token>（登录 JWT 或设置页 sv_ 密钥）。
登录
POST /v1/auth/login
Content-Type: application/json
{ "email": "<邮箱>", "password": "<密码>" }
成功：200
{
"access_token": "<jwt>",
"token_type": "bearer",
"user": { "id": "<user-uuid>", "email": "<邮箱>" }
}
后续请求头：Authorization: Bearer <access_token>。对接 MCP / 论文也可用设置页创建的 sv_… 密钥，用法相同。
失败：401（邮箱或密码错误）。
相关接口
| 文档 | 内容 |
|---|---|
| 空间（创建 / 列表 / 详情） | 创建、列表、详情、用量、更新 |
| 上传文件 | TUS、笔记 |
| 文档（列表 / 读写） | 列表、正文、元数据、compile |
| 删除文档 / 空间 | 单篇 / 批量 / 整库 |
常见错误
错误响应一般为 JSON，例如 { "detail": "…" }（字符串或校验错误数组）。
| 码 | 含义 |
|---|---|
400 | 参数错误 |
401 | 未登录 / Token 无效 |
403 | 无权 |
404 | 不存在 |
409 | TUS 偏移冲突 |
413 | 超过 100 MB |
501 | 能力未配置（如存储） |
503 | 服务不可用（如未配置整理/千问密钥） |