# ComicDrama

**Repository Path**: codemaners/comic-drama

## Basic Information

- **Project Name**: ComicDrama
- **Description**: AI 漫剧流程
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-07-31
- **Last Updated**: 2026-08-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ComicDrama — AI 漫剧（红果风 3D 国漫）

小说文本 → 角色设定 → 分镜脚本 → **3D 国漫静帧** → 配音 → 推拉成片（mp4）。

定位：AIGC 竖屏漫剧（类红果短剧），默认画风 `donghua-3d`。  
口型 LivePortrait **不是**主路径；下一阶段接百炼万相图生视频。

## 快速开始

```bash
cd comicdrama
pnpm install
cp .env.example .env   # 已有 .env 可跳过
pnpm dev
```

打开 http://localhost:3000

推荐路径：新建项目（默认 3D国漫）→ 样例正文 → 抽角色 → 分镜 → 定妆 → 出图配音 → 生成片段 → 合成。

## Provider 配置

| 变量 | 可选值 | 说明 |
|------|--------|------|
| `LLM_PROVIDER` | `mock` / `openai` | 兼容 DeepSeek、百炼兼容模式、OpenAI |
| `IMAGE_PROVIDER` | `mock` / `aliyun` / `gemini` | 定妆与分镜图 |
| `IMAGE_BASE_URL` | 可选 | 图片代理/MaaS；**勿**与视频/口型官方地址混用 |
| `TTS_PROVIDER` | `mock` / `edge` / `aliyun` | `edge` 免费；短剧建议后续接 CosyVoice |
| `VIDEO_PROVIDER` | `mock` / `aliyun` | `aliyun` = 万相图生视频 wan2.7 |
| `LIPSYNC_PROVIDER` | `mock` / `aliyun` | 3D 漫剧保持 `mock` |

**配音要不要模型？** 已接 CosyVoice。默认 `TTS_PROVIDER=aliyun` + `COSYVOICE_MODEL=cosyvoice-v3-flash`。  
控制台里的「pro」对应 API 名「plus」（`cosyvoice-v3-plus` / `cosyvoice-v3.5-plus`）。  
`v3.5` 系列更适合声音设计/复刻；系统音色优先用 `v3-flash` / `v3-plus`。

接真模型最少填：`LLM_API_KEY` + `DASHSCOPE_API_KEY`（出图）。

## 路线图

**Phase 1**  
3D 国漫静帧 + Edge TTS + 字幕。

**Phase 2（当前）**  
`VIDEO_PROVIDER=aliyun` → 百炼万相 **wan2.7-i2v**（首帧 + 可选 `driving_audio`）。  
i2v 免费额度耗尽时自动回退 **wan2.7-r2v**（首帧+参考图）→ **wan2.7-t2v**（纯文生，一致性较弱）。  
短于 2 秒的配音会自动垫静音；失败回退 Ken Burns 推拉。  
`VIDEO_BASE_URL` 建议与图片 MaaS 工作空间相同。

LivePortrait 口型对 3D 脸无效，保持 `LIPSYNC_PROVIDER=mock`。

## 目录结构

```text
app/                 页面与 API
lib/
  providers/         LLM / Image / TTS / LipSync（Video 预留）
  pipeline/          切章、角色、分镜、出图、配音、片段、合成
  prompt/styles.ts   画风预设（默认 donghua-3d）
data/projects/<id>/  素材与 project.json
```

## 端到端自测

```bash
pnpm e2e                                          # mock 全链路
pnpm exec tsx scripts/demo-donghua3d.ts           # 真 Key：3D 国漫示例成片
```

## 注意事项

- 8G 显卡不够跑本地 SD/Comfy，MVP 只用云 API / mock。
- FFmpeg 由 `@ffmpeg-installer/*` 自带。
- 角色一致性：定妆照 + 外貌 prompt + seed；同框 ≤2 人。
- LivePortrait 对 3D/二次元脸几乎无效；真人实验项目可单独开 `LIPSYNC_PROVIDER=aliyun`。