# 数字我 / Digital Me — Backend

「有脸、有声音、有知识库的另一个你」的 API。个人 AI 数字分身平台后端。

## Quick start

```bash
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](../PLAN.md)（定位、差异化、路线图）与 [CLAUDE.md](./CLAUDE.md)。