Huobao Drama 是一个基于 AI 的短剧自动化生产平台，实现从剧本生成、角色设计、分镜制作到视频合成的全流程自动化。

火宝短剧商业版地址：火宝短剧商业版 火宝小说生成：火宝小说生成

• 🤖 AI 驱动：使用大语言模型解析剧本，提取角色、场景和分镜信息
• 🎨 智能创作：AI 绘图生成角色形象和场景背景
• 📹 视频生成：基于文生视频和图生视频模型自动生成分镜视频
• 🔄 工作流：完整的短剧制作工作流，从创意到成片一站式完成

frontend/   — Nuxt 3 + Vue 3 + TypeScript (纯 CSS，无 UI 框架)
backend/    — Hono + Drizzle ORM + Mastra AI Agents + better-sqlite3
configs/    — config.yaml 配置文件
data/       — SQLite 数据库 + 生成资源文件
skills/     — Agent 技能定义 (SKILL.md)

体验 AI 短剧生成效果：

• ✅ AI 生成角色形象
• ✅ 批量角色生成
• ✅ 角色图片上传和管理
• ✅ 角色音色分配与试听

• ✅ AI 自动拆解分镜脚本
• ✅ 场景描述和镜头设计
• ✅ 分镜图片生成（文生图）
• ✅ 宫格图生成、切分与分配
• ✅ 帧类型选择（首帧/尾帧/分镜板）

• ✅ 图生视频自动生成
• ✅ TTS 配音生成
• ✅ FFmpeg 单镜头合成（视频 + 音频 + 字幕）
• ✅ 整集拼接导出

• ✅ 素材库统一管理
• ✅ 本地存储支持
• ✅ 任务进度追踪

内置 5 个 Mastra Agent，支持数据库配置和 Skill 扩展：

macOS:

brew install ffmpeg

Ubuntu/Debian:

sudo apt update && sudo apt install ffmpeg

Windows: 从 FFmpeg 官网 下载并配置环境变量

验证安装：

ffmpeg -version

复制并编辑配置文件：

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

配置文件格式（configs/config.yaml）：

app:
  name: "Huobao Drama API"
  version: "1.0.0"
  debug: true

server:
  port: 5679
  host: "0.0.0.0"
  cors_origins:
    - "http://localhost:3013"

database:
  type: "sqlite"
  path: "./data/huobao_drama.db"

storage:
  type: "local"
  local_path: "./data/storage"
  base_url: "http://localhost:5679/static"

ai:
  default_text_provider: "openai"
  default_image_provider: "openai"
  default_video_provider: "doubao"

说明：AI 服务的具体 API Key 和模型参数在 Web 界面的「设置」页面中配置。

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

# 安装后端依赖
cd backend && npm install

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

前后端分离，支持热重载：

# 终端1：启动后端
cd backend
npm run dev

# 终端2：启动前端
cd frontend
npm run dev

• 前端地址: http://localhost:3013
• 后端 API: http://localhost:5679/api/v1
• 前端自动代理 /api 和 /static 到后端

后端同时提供 API 和前端静态文件：

# 1. 构建前端
cd frontend && npm run generate

# 2. 启动后端
cd ../backend && npm start

访问: http://localhost:5679

数据库表在首次启动时自动创建，无需手动迁移。默认路径 data/huobao_drama.db，可通过环境变量覆盖：

DB_PATH=/path/to/your.db npm start

# 启动服务
docker compose up -d

# 查看日志
docker compose logs -f

# 停止服务
docker compose down

# 从 Docker Hub 运行
docker run -d \
  --name huobao-drama \
  -p 5679:5679 \
  -v $(pwd)/data:/app/data \
  -v $(pwd)/configs/config.yaml:/app/configs/config.yaml \
  --restart unless-stopped \
  huobao/huobao-drama:latest

# 查看日志
docker logs -f huobao-drama

注意：Linux 用户需添加 --add-host=host.docker.internal:host-gateway 以访问宿主机服务

本地构建（可选）：

docker build -t huobao-drama:latest .
docker run -d --name huobao-drama -p 5679:5679 \
  -v $(pwd)/data:/app/data \
  -v $(pwd)/configs/config.yaml:/app/configs/config.yaml \
  huobao-drama:latest

Docker 部署优势：

• ✅ 开箱即用，内置 FFmpeg 和默认配置
• ✅ 前后端合并为单镜像、单端口
• ✅ 环境一致性，避免依赖问题
• ✅ data/ 目录 volume 挂载，数据持久化

容器内可通过 http://host.docker.internal:端口号 访问宿主机服务。

配置步骤：

1. 宿主机启动服务（监听所有接口）：

   export OLLAMA_HOST=0.0.0.0:11434 && ollama serve

2. 在 Web 界面「设置 → AI 服务配置」中填写：

   • Base URL: http://host.docker.internal:11434/v1
   • Provider: openai
   • Model: qwen2.5:latest

# 1. 构建前端
cd frontend && npm run generate && cd ..

# 2. 启动后端
cd backend && npm start

需要上传到服务器的文件：

backend/          # 后端源码 + node_modules
frontend/dist/    # 前端构建产物
configs/config.yaml
data/             # 数据目录（首次运行自动创建）
skills/           # Agent 技能文件

server {
    listen 80;
    server_name your-domain.com;

    location / {
        proxy_pass http://localhost:5679;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

• 运行时: Node.js 20+
• Web 框架: Hono
• ORM: Drizzle ORM + better-sqlite3
• AI Agent: Mastra + AI SDK (OpenAI compatible)
• 视频处理: FFmpeg (fluent-ffmpeg)
• 图片处理: Sharp

• 框架: Nuxt 3 (SPA 模式)
• 语言: Vue 3 + TypeScript
• 路由: 文件路由 (Vue Router 4)
• 样式: 纯 CSS + CSS Variables (暗色主题)
• 图标: Lucide Vue

A: 使用 http://host.docker.internal:11434/v1 作为 Base URL。注意：

1. 宿主机 Ollama 需监听 0.0.0.0：export OLLAMA_HOST=0.0.0.0:11434 && ollama serve
2. Linux 用户使用 docker run 需添加：--add-host=host.docker.internal:host-gateway

A: 确保 FFmpeg 已安装并在 PATH 环境变量中。运行 ffmpeg -version 验证。Docker 部署已内置 FFmpeg。

A: 检查后端是否启动，端口是否正确。开发模式下前端代理配置在 frontend/nuxt.config.ts。

A: 后端会在首次启动时自动创建所有表，检查日志确认初始化是否成功。

• 项目全面迁移至 TypeScript 技术栈
  • 后端：Hono + Drizzle ORM + better-sqlite3
  • 前端：Nuxt 3 + Vue 3
  • AI Agent：Mastra 框架
• 重做单集工作台 UI 和生产流程
  • 更紧凑的控制台布局
  • 重做分镜编辑区
  • 重做配音、镜头图、视频、合成、导出界面
• 新增 Docker 部署支持，前后端合并为单镜像
• 增加运行时 Skill 加载机制
• 扩展多厂商媒体 Adapter
  • 图片：OpenAI、Gemini、MiniMax、火山引擎、阿里
  • 视频：MiniMax、火山引擎/Seedance、Vidu、阿里
  • TTS：MiniMax
• 增加宫格图生成、切分和重新分配流程
• 优化本地文件处理与参考图按需转码

• 引入本地存储策略，规避外部资源链接失效
• Base64 参考图嵌入式传输
• 修复镜头切换状态重置问题
• 添加场景迁移至章节

• SQLite 纯 Go 驱动，支持 CGO_ENABLED=0 跨平台编译
• 优化并发性能（WAL 模式）
• Docker 跨平台支持 host.docker.internal

• 修复视频生成 API 响应解析问题
• 添加 OpenAI Sora 视频端点配置
• 优化错误处理和日志输出

欢迎提交 Issue 和 Pull Request！

1. Fork 本项目
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交改动 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

常用检查命令：

cd backend && npm run typecheck
cd ../frontend && npm run build

2 分钟完成配置：API 聚合站点

AI 火宝 - AI 工作室创业中

• 🏠 位置: 中国南京
• 🚀 状态: 创业中
• 📧 Email: 18550175439@163.com
• 🐙 GitHub: https://github.com/chatfire-AI/huobao-drama

"让 AI 帮我们做更有创造力的事"

本项目已获得 LINUX DO 社区链接认可。

• LINUX DO — 真正的开源精神，共建共享的技术社区

• 提交 Issue
• 发送邮件至项目维护者