Huobao Drama - AI 短剧生成平台
Huobao Drama - AI 短剧生成平台
整理时间： 2026-02-21
来源： 群聊消息
整理人： AI助手
摘要
Huobao Drama（火宝短剧）是一个基于 Go + Vue3 的全栈 AI 短剧自动化生产平台，实现从剧本生成、角色设计、分镜制作到视频合成的全流程自动化。平台采用 DDD 领域驱动设计，支持 Docker 部署，可以一键生成短剧视频。
一、项目概述
| 属性 | 说明 |
|---|---|
| 项目名称 | Huobao Drama（火宝短剧） |
| 技术栈 | Go + Vue3 |
| 定位 | AI 短剧自动化生产平台 |
| GitHub | https://github.com/chatfire-AI/huobao-drama |
| 官网 | https://drama.chatfire.site/shortvideo |
核心价值
- 🤖 AI 驱动：大语言模型解析剧本，提取角色、场景和分镜信息
- 🎨 智能创作：AI 绘图生成角色形象和场景背景
- 📹 视频生成：文生视频和图生视频模型自动生成分镜视频
- 🔄 工作流：完整的短剧制作工作流，从创意到成片一站式完成
二、技术架构
2.1 架构设计
采用 DDD 领域驱动设计，清晰分层：
├── API层 (Gin HTTP)
├── 应用服务层 (Business Logic)
├── 领域层 (Domain Models)
└── 基础设施层 (Database, External Services)
2.2 技术栈
后端技术
| 技术 | 说明 |
|---|---|
| Go | 1.23+ |
| Gin | Web 框架 |
| GORM | ORM |
| SQLite | 数据库 |
| Zap | 日志 |
| FFmpeg | 视频处理 |
前端技术
| 技术 | 说明 |
|---|---|
| Vue 3.4+ | 前端框架 |
| TypeScript 5+ | 开发语言 |
| Vite 5 | 构建工具 |
| Element Plus | UI 组件 |
| TailwindCSS | CSS 框架 |
| Pinia | 状态管理 |
三、功能特性
3.1 角色管理
- ✅ AI 生成角色形象
- ✅ 批量角色生成
- ✅ 角色图片上传和管理
3.2 分镜制作
- ✅ 自动生成分镜脚本
- ✅ 场景描述和镜头设计
- ✅ 分镜图片生成（文生图）
- ✅ 帧类型选择（首帧/关键帧/尾帧/分镜板）
3.3 视频生成
- ✅ 图生视频自动生成
- ✅ 视频合成和剪辑
- ✅ 转场效果
3.4 资源管理
- ✅ 素材库统一管理
- ✅ 本地存储支持
- ✅ 资源导入导出
- ✅ 任务进度追踪
3.5 v1.0.5 新功能
| 功能 | 说明 |
|---|---|
| 全局风格系统 | 项目级别风格选择，自动应用到所有 AI 生成内容 |
| 九宫格序列图裁剪 | 从动作序列图提取单个帧 |
四、快速开始
4.1 环境要求
| 软件 | 版本 | 说明 |
|---|---|---|
| Go | 1.23+ | 后端运行环境 |
| Node.js | 18+ | 前端构建环境 |
| npm | 9+ | 包管理工具 |
| FFmpeg | 4.0+ | 视频处理（必需） |
| SQLite | 3.x | 数据库（已内置） |
4.2 安装步骤
# 克隆项目
git clone https://github.com/chatfire-AI/huobao-drama.git
cd huobao-drama
# 安装 Go 依赖
go mod download
# 安装前端依赖
cd web
npm install
cd ..
4.3 配置文件
cp configs/config.example.yaml configs/config.yaml
vim configs/config.yaml
4.4 启动项目
开发模式（推荐）：
# 终端1：启动后端服务
go run main.go
# 终端2：启动前端开发服务器
cd web
npm run dev
- 前端地址：
http://localhost:3012 - 后端 API：
http://localhost:5678/api/v1
五、部署方式
5.1 Docker 部署（推荐）
# 方式一：Docker Compose（推荐）
docker compose up -d
# 方式二：Docker 命令
docker run -d \
--name huobao-drama \
-p 5678:5678 \
-v $(pwd)/data:/app/data \
huobao/huobao-drama:latest
5.2 传统部署
# 1. 构建前端
cd web
npm run build
cd ..
# 2. 编译后端
go build -o huobao-drama .
# 3. 配置 systemd 服务
sudo systemctl enable huobao-drama
sudo systemctl start huobao-drama
六、AI 服务配置
6.1 支持的| 类型 | 服务商 |
|------|--------|
| AI 服务
文本 | OpenAI、Gemini、火山引擎等 |
| 图像 | OpenAI 等 |
| 视频 | 抖音/火山等 |
6.2 配置方式
在 Web 界面中配置具体的 API Key，或通过配置文件设置：
ai:
default_text_provider: "openai"
default_image_provider: "openai"
default_video_provider: "doubao"
七、使用流程
7.1 完整工作流
剧本输入 → AI 解析 → 角色生成 → 分镜设计 → 图生视频 → 视频合成 → 成片输出
7.2 本地模型支持
支持通过 Ollama 使用本地模型：
# 宿主机启动 Ollama
export OLLAMA_HOST=0.0.0.0:11434 && ollama serve
# 前端配置
Base URL: http://host.docker.internal:11434/v1
Provider: openai
Model: qwen2.5:latest
八、相关资源
| 资源 | 地址 |
|---|---|
| GitHub | https://github.com/chatfire-AI/huobao-drama |
| 官网 | https://drama.chatfire.site/shortvideo |
| 商业版 | https://drama.chatfire.site/shortvideo |
| API 配置 | https://api.chatfire.site/models |
九、总结
9.1 核心优势
| 优势 | 说明 |
|---|---|
| 🔄 全流程自动化 | 剧本到成片一站式 |
| 🎬 多模型支持 | 文生图、图生视频 |
| 🐳 容器化部署 | Docker 一键启动 |
| 💻 本地运行 | 支持本地模型 |
| 🎭 角色管理 | AI 生成角色形象 |
9.2 一句话总结
输入剧本，AI 自动生成角色、分镜、视频——短剧创作从创意到成片一键完成。
整理备注
本文档基于 GitHub 项目 Huobao Drama 官方 README 整理，包含完整的技术架构、功能特性、部署指南及使用说明。