数字我 / Digital Me — Backend
「有脸、有声音、有知识库的另一个你」的 API。个人 AI 数字分身平台后端。
Quick start
cp .env.example .env # 填入 DASHSCOPE_API_KEY；本地 MongoDB 即可
npm install
npm run dev # → http://localhost:3701 (GET /health)
需要本机或远程 MongoDB（默认 mongodb://localhost:27017，DB digital_me）。
MVP scope（第一阶段：个人 IP 分身）
复刻「你自己」→ 一键生成「你」讲某主题的口播视频 + 可嵌入的「和我分身聊天」。
| 能力 | 接口 |
|---|---|
| 注册 / 登录 | POST /api/auth/register · POST /api/auth/login · GET /api/auth/me |
| 创建你的分身 | POST /api/twins { displayName, persona?, characterPrompt?, lang? } |
| 上传照片建形象 | POST /api/twins/:id/avatar (multipart photo) |
| 录音克隆声音 | POST /api/twins/:id/voice (multipart sample) |
| 喂知识（转 RAG） | POST /api/twins/:id/knowledge (file 或 { text, title }) |
| 文字/语音对话 | POST /api/twins/:id/ask { question, speak?, lang? } |
| 单独朗读 | POST /api/twins/:id/speak { text } |
| 一键口播视频 | POST /api/twins/:id/talk-video → { jobId }，轮询 GET …/talk-video/:jobId |
| 发布为可分享分身 | PUT /api/twins/:id/publish { isPublic, slug?, tagline? } |
| 公开嵌入对话 | GET /api/embed/:slug · POST /api/embed/:slug/ask（无需登录，不入历史） |
所有 /api/twins/* 需 Authorization: Bearer <token>，并按 ownerId 隔离。
两个运行约束
- AI 功能需
DASHSCOPE_API_KEY。 - 捏脸 / 口播视频需
PUBLIC_URL公网可达——DashScope 按 URL 回拉素材，localhost会失败（对话/声音仍可用）。本地开发用内网穿透（如 cloudflared）。
详见 ../PLAN.md（定位、差异化、路线图）与 CLAUDE.md。