# ai-webtoon

**Repository Path**: ai-practical-lab/ai-webtoon

## Basic Information

- **Project Name**: ai-webtoon
- **Description**: AI 驱动的角色一致性漫剧创作平台，让文字起舞成画，让角色贯穿始终。先建立角色素材库，再创作系列视频，AI 严格保持形象一致性，告别 “变脸” 问题，打造专业级 AI 影视内容。支持从素材创建、剧本编写到封面制作的全流程，只需输入文字描述，即可自动生成专业级视频内容。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-09
- **Last Updated**: 2026-03-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI 短视频导影平台 (DaoYing)

这是一个基于 AI 的短视频创作平台，支持从一句话生成剧本、分镜、配音到最终视频合成的全流程创作。

## 技术栈

- **前端**: React, Vite, Tailwind CSS, Zustand
- **后端**: FastAPI, Celery, SQLAlchemy
- **数据库**: PostgreSQL (pgvector), Redis
- **存储**: MinIO
- **AI**: 阿里云百炼 (DeepSeek V3)

## 快速开始

### 1. 环境准备

- Docker & Docker Compose
- 阿里云百炼 API Key (DeepSeek)

### 2. 配置

复制环境变量示例文件并填入您的 API Key：

```bash
cp .env.example .env
# 编辑 .env 文件，设置 DASHSCOPE_API_KEY
```

### 3. 启动服务

使用 Docker Compose 一键启动所有服务：

```bash
docker-compose -f docker-compose.dev.yml up -d --build
```

### 4. 访问系统

- **前端页面**: http://localhost:3000
- **后端 API**: http://localhost:8001/docs
- **MinIO 控制台**: http://localhost:9003 (账号: admin / password123)
- **数据库**: PostgreSQL (端口: 5433)
- **Redis**: 端口 6380

## 系统架构

### 核心服务

| 服务 | 容器名称 | 端口 | 说明 |
|------|----------|------|------|
| 前端 | frontend | 3000 | React 前端应用 |
| 后端 | backend | 8001 | FastAPI 后端服务 |
| 数据库 | db | 5433 | PostgreSQL 数据库 |
| 缓存 | redis | 6380 | Redis 缓存 |
| 对象存储 | minio | 9002, 9003 | MinIO 存储服务 |
| 任务队列 | celery_worker | - | Celery 工作节点 |

## 核心功能

### 1. 用户管理
- **注册/登录**: 支持用户注册和登录
- **身份验证**: JWT token 认证，3小时滑动过期
- **管理员功能**: 用户管理、强制下线、密码修改

### 2. 项目管理
- **创建项目**: 输入项目名称和描述
- **项目列表**: 查看所有项目，支持筛选和搜索
- **项目详情**: 查看项目的完整信息

### 3. 剧本生成
- **AI 剧本生成**: 输入主题，AI 自动生成分镜脚本
- **剧本编辑**: 手动调整分镜内容和提示词
- **分镜管理**: 添加、删除、重排分镜

### 4. 素材管理
- **图片生成**: 基于分镜提示词生成场景图片
- **音频合成**: 为分镜生成配音
- **素材预览**: 查看生成的图片和音频

### 5. 视频合成
- **分镜合成**: 将分镜素材合成为最终视频
- **视频预览**: 预览合成的视频效果
- **视频下载**: 下载最终视频文件

### 6. 外部集成
- **外部登录**: 支持外部系统通过 AES 加密自动登录
- **API 接口**: 完整的 RESTful API

## 目录结构

```
├── backend/          # 后端 FastAPI 项目
│   ├── app/          # 应用核心代码
│   │   ├── api/       # API 路由
│   │   ├── services/  # 业务逻辑
│   │   ├── models/    # 数据库模型
│   │   ├── schemas/   # 数据校验
│   │   └── workers/   # Celery 任务
│   ├── Dockerfile     # 后端容器构建文件
│   └── requirements.txt # 依赖包
├── frontend/         # 前端 React 项目
│   ├── src/          # 源代码
│   │   ├── components/ # 组件
│   │   ├── services/  # API 服务
│   │   ├── store/     # 状态管理
│   │   └── pages/     # 页面
│   ├── Dockerfile     # 前端容器构建文件
│   └── package.json   # 依赖配置
├── docs/             # 开发文档
├── docker-compose.dev.yml # 开发环境配置
├── docker-compose.yml # 生产环境配置
└── .env              # 环境变量配置
```

## 用户指南

### 1. 注册账号
1. 访问 http://localhost:3000
2. 点击 "注册" 按钮
3. 输入用户名（仅限英文字母）和密码
4. 输入验证码，点击 "立即注册"
5. 注册成功后会自动登录

### 2. 登录系统
1. 访问 http://localhost:3000
2. 点击 "登录" 按钮
3. 输入用户名和密码
4. 输入验证码，点击 "登录"

### 3. 创建项目
1. 登录后，点击左侧导航栏的 "项目管理"
2. 点击 "创建项目" 按钮
3. 输入项目名称和描述
4. 点击 "创建" 按钮

### 4. 生成剧本
1. 进入项目详情页面
2. 点击 "生成剧本" 按钮
3. 输入视频主题（如："一个女孩在海边看日落"）
4. 点击 "生成" 按钮
5. 等待 AI 生成剧本（约 10-30 秒）

### 5. 编辑分镜
1. 剧本生成后，会显示分镜列表
2. 点击每个分镜可以编辑内容和提示词
3. 可以调整分镜顺序、添加或删除分镜

### 6. 生成素材
1. 编辑完分镜后，点击 "生成素材" 按钮
2. 系统会为每个分镜生成图片和配音
3. 等待素材生成完成（约 1-3 分钟）

### 7. 合成视频
1. 素材生成完成后，点击 "合成视频" 按钮
2. 等待视频合成（约 1-2 分钟）
3. 合成完成后可以预览和下载视频

## 管理员指南

### 1. 登录管理员账号
- 默认管理员账号：admin
- 默认密码：admin123

### 2. 用户管理
1. 登录后，点击左侧导航栏的 "用户管理"
2. 可以查看所有用户列表
3. 支持强制用户下线、修改用户密码

### 3. 操作监控
1. 点击左侧导航栏的 "操作监控"
2. 可以查看用户操作日志和系统任务状态

## 常见问题

### 1. 登录时提示 "登录已过期"
- 原因：系统设置了 3 小时的登录有效期
- 解决：重新登录即可

### 2. 素材生成失败
- 原因：AI 服务调用失败或提示词质量问题
- 解决：检查 API Key 配置，调整提示词后重试

### 3. 视频合成失败
- 原因：素材生成失败或合成服务异常
- 解决：确保所有素材都生成成功后再尝试合成

### 4. 服务启动失败
- 原因：端口冲突或配置错误
- 解决：检查 Docker 容器状态，确保端口未被占用

## 故障排除

### 1. 检查服务状态

```bash
docker-compose -f docker-compose.dev.yml ps
```

### 2. 查看服务日志

```bash
# 查看后端日志
docker-compose -f docker-compose.dev.yml logs backend

# 查看前端日志
docker-compose -f docker-compose.dev.yml logs frontend

# 查看数据库日志
docker-compose -f docker-compose.dev.yml logs db
```

### 3. 重启服务

```bash
docker-compose -f docker-compose.dev.yml restart
```

### 4. 重置数据库

```bash
docker-compose -f docker-compose.dev.yml down
docker volume rm creationplatform_postgres_data
docker-compose -f docker-compose.dev.yml up -d
```

## 开发注意事项

1. **API Key 安全**: 不要在代码中硬编码 API Key，使用环境变量
2. **性能优化**: 对于视频处理等耗时操作，使用 Celery 异步处理
3. **错误处理**: 实现完善的错误处理和日志记录
4. **安全措施**: 实现 CORS 保护、输入验证等安全措施

## 许可证

MIT License

## 联系方式

如有问题或建议，请联系开发团队。