digital-me-history/digital-me-backend/README.md

数字我 / 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 隔离。

两个运行约束

1. AI 功能需 DASHSCOPE_API_KEY。
2. 捏脸 / 口播视频需 PUBLIC_URL 公网可达——DashScope 按 URL 回拉素材， localhost 会失败（对话/声音仍可用）。本地开发用内网穿透（如 cloudflared）。

详见 ../PLAN.md（定位、差异化、路线图）与 CLAUDE.md。