41 lines
1.9 KiB
Markdown
41 lines
1.9 KiB
Markdown
# 数字我 / 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)。
|