火宝短剧（Huobao Drama）

Huobao Drama 是一个基于 Go + Vue3 的全栈 AI 短剧生成平台，支持从剧本构思到成片输出的完整自动化流程。它将大语言模型、文生图、图生视频等能力整合进一套可操作的工作流中，让非专业用户也能快速生成结构完整的短剧内容。

整个系统围绕“创作-分镜-合成”三大环节构建，所有资源本地存储，支持私有部署，适用于内容创作者、独立开发者或小型工作室探索 AI 视频生产的可能性。

核心价值

• AI 驱动：通过大语言模型解析剧本，自动提取角色、场景、镜头等结构化信息。
• 智能创作：调用文生图模型生成角色形象与背景，支持批量创建。
• 视频生成：基于图生视频技术，将分镜图像自动转为动态片段，并加入转场效果。
• 一体化工作流：从创意输入到视频输出，全程在统一界面完成，无需切换工具。

主要功能模块

角色管理

• AI 自动生成角色形象（支持多风格）
• 批量创建多个角色
• 支持手动上传与编辑角色图片

分镜制作

• 自动将剧本拆解为分镜脚本
• 为每个镜头生成场景描述与构图建议
• 调用文生图模型生成分镜画面
• 支持指定帧类型：首帧、关键帧、尾帧、分镜板

视频生成

• 基于分镜图像自动生成短视频片段
• 自动拼接镜头并添加基础转场
• 支持导出 MP4 格式成片

资源管理

• 统一素材库：角色、场景、分镜、视频集中管理
• 本地存储：所有文件保存在服务器本地，无云端依赖
• 支持任务进度追踪与历史记录回溯
• 可导入/导出项目资源包，便于协作或迁移

快速上手

环境依赖

安装 FFmpeg

• macOS: brew install ffmpeg
• Ubuntu/Debian: sudo apt install ffmpeg
• Windows: 从 FFmpeg 官网 下载并配置 PATH

验证安装：

ffmpeg -version

配置说明

复制示例配置并编辑：

cp configs/config.example.yaml configs/config.yaml
vim configs/config.yaml

关键配置项包括：

• app.debug：开发模式开关
• server.port：服务端口（默认 5678）
• server.cors_origins：允许前端跨域地址（如 http://localhost:3012）
• database.path：SQLite 数据库存放路径
• storage.local_path：媒体文件存储目录
• ai.default_*_provider：AI 服务提供商（如 OpenAI、Doubao、Ollama）

注意：API Key 在 Web 界面中配置，不硬编码在配置文件中。

安装与启动

开发模式（推荐）

# 克隆项目
git clone https https://github.com/chatfire-AI/huobao-drama.git
cd huobao-drama

# 安装后端依赖
go mod download

# 安装前端依赖
cd web && npm install && cd ..

# 启动后端（终端1）
go run main.go

# 启动前端（终端2）
cd web && npm run dev

访问：

• 前端：http://localhost:3012
• API：http://localhost:5678/api/v1

前端已配置代理，自动转发请求至后端。

单服务模式（生产预览）

# 构建前端
cd web && npm run build && cd ..

# 启动服务
go run main.go

访问：http://localhost:5678

数据库表在首次启动时自动创建（基于 GORM AutoMigrate），无需手动初始化。

部署方案

Docker 部署（推荐）

使用 Docker Compose 一键启动：

docker-compose up -d

优势：

• 无需手动安装 Go、Node.js、FFmpeg
• 环境隔离，避免依赖冲突
• 自动处理文件权限与健康检查
• 支持访问宿主机 AI 服务（如 Ollama）

访问本地模型（如 Ollama）
在容器内使用 http://host.docker.internal:11434 即可连接宿主机服务。
宿主机需启动 Ollama 并监听所有接口：

export OLLAMA_HOST=0.0.0.0:11434 && ollama serve

传统部署（自定义服务器）

1. 构建项目

   # 前端
   cd web && npm run build && cd ..
   # 后端
   go build -o huobao-drama .
   

2. 上传文件至服务器
   • huobao-drama（可执行文件）
   • configs/config.yaml
   • data/（首次运行自动生成，建议提前创建）
3. 设置权限（关键！）

   sudo mkdir -p /opt/huobao-drama/data/storage
   sudo chown -R deploy:deploy /opt/huobao-drama/data  # 替换为实际用户
   sudo chmod -R 755 /opt/huobao-drama/data
   

4. 使用 systemd 管理服务
   创建 /etc/systemd/system/huobao-drama.service，配置 User 与数据目录所有者一致。
5. Nginx 反向代理（可选）

   server {
       listen 80;
       server_name your-domain.com;
   
       location / {
           proxy_pass http://localhost:5678;
       }
   
       location /static/ {
           alias /opt/huobao-drama/data/storage/;
       }
   }
   

⚠️ 常见问题：SQLite “readonly database” 错误
原因：SQLite 需要对数据库文件 及其所在目录 有写权限（用于生成 -wal、-journal 临时文件）。
解决：确保 systemd 中的 User 与 data/ 目录所有者一致。

适用场景

• 独立创作者快速生成剧情短视频
• 教学演示中的 AI 内容自动化
• 小型团队探索 AI 视频工作流
• 本地化部署，避免敏感内容上传云端

Huobao Drama 当前为开源项目，代码透明，支持自定义 AI 模型接入，适合希望掌控全流程、注重数据隐私的用户。