AI漫剧

自动生成短剧剧本、漫剧视频，一键发布抖音

📖 项目简介

AI漫剧是一个面向抖音短剧创作者的自动化内容生产平台，核心功能包括：

1. AI剧本生成 - 根据主题/关键词自动生成短剧剧本
2. 漫剧视频生成 - 将剧本转化为漫画风格的视频内容
3. 一键发布 - 自动发布生成的视频到抖音平台

🛠️ 技术栈

前端

• Next.js 14+ (App Router)
• React 18+ / TypeScript
• TailwindCSS + Shadcn/ui
• Zustand (状态管理)

后端

• Python 3.11+ / FastAPI
• SQLAlchemy 2.0 + PostgreSQL
• Celery + Redis (异步任务)
• OpenAI API (剧本生成)

AI 服务

• OpenAI GPT-4 (剧本生成)
• Stable Diffusion API (图像生成)
• FFmpeg + MoviePy (视频合成)

🚀 快速开始

📖 小白用户请看：详细启动指南 - 一步步教你如何启动项目

前置要求

• Node.js 20+
• Python 3.11+
• Docker & Docker Compose
• OpenAI API Key

快速启动（4个终端窗口）

终端1 - 启动数据库：

cd AI漫剧
docker-compose up -d

终端2 - 启动后端：

cd AI漫剧/backend
python -m venv venv
.\venv\Scripts\activate          # Mac/Linux: source venv/bin/activate
pip install -r requirements.txt
alembic upgrade head
uvicorn app.main:app --reload

终端3 - 启动 Celery Worker：

cd AI漫剧/backend
.\venv\Scripts\activate
celery -A app.tasks.celery_app worker --loglevel=info --pool=solo

终端4 - 启动前端：

cd AI漫剧/frontend
npm install
npm run dev

✅ 访问 http://localhost:3000 开始使用！

📁 项目结构

AI漫剧/
├── frontend/                 # Next.js 前端
│   ├── src/
│   │   ├── app/             # App Router 页面
│   │   ├── components/      # UI 组件
│   │   ├── hooks/           # 自定义 Hooks
│   │   ├── lib/             # 工具函数
│   │   ├── stores/          # Zustand 状态
│   │   └── types/           # TypeScript 类型
│   └── public/              # 静态资源
│
├── backend/                  # FastAPI 后端
│   ├── app/
│   │   ├── api/             # API 路由
│   │   ├── core/            # 核心配置
│   │   ├── models/          # 数据模型
│   │   ├── schemas/         # Pydantic 模式
│   │   ├── services/        # 业务逻辑
│   │   └── tasks/           # Celery 任务
│   └── alembic/             # 数据库迁移
│
├── openspec/                 # OpenSpec 规范文档
├── docker-compose.yml        # Docker 配置
└── README.md

🔧 开发命令

后端

# 代码格式化
black app/
ruff check app/ --fix

# 运行测试
pytest

# 创建数据库迁移
alembic revision --autogenerate -m "description"

# 运行迁移
alembic upgrade head

# 启动 Celery Worker
celery -A app.tasks.celery_app worker --loglevel=info

前端

# 开发服务器
npm run dev

# 代码检查
npm run lint

# 构建生产版本
npm run build

🔌 API 文档

启动后端后，访问：

• Swagger UI: http://localhost:8000/docs
• ReDoc: http://localhost:8000/redoc

📋 OpenSpec 工作流

本项目使用 OpenSpec 进行规范驱动开发。

# 查看当前变更
npx openspec list

# 验证变更
npx openspec validate <change-id> --strict

# 查看规范详情
npx openspec show <spec-id>

详见 openspec/AGENTS.md

📄 License

MIT