chatfire-AI /huobao-drama

🎬 火宝短剧 - 基于AI的一站式短剧生成平台 《一句话生成完整短剧,从剧本到成片全自动化》 Huobao Drama - An AI-Powered End-to-End Short Drama Generator "One Sentence to Complete Drama: Fully Automated from Script to Final Video"

★ 17,516⑂ 3,262👁 86⑃ 59● 96▤ 7
TypeScriptNOASSERTIONCreated 2026-01-05
下载:HuobaoDrama v4.0.11HuobaoDrama-4.0.11 ↓4.0.112026-11-05
+149
日增长
17,516
stars
3,262
forks
86
watchers
59
prs
96
issues
7
releases

README

🎬 Huobao Drama - AI 短剧生成平台



基于 TypeScript 全栈的 AI 短剧自动化生产平台






中英双语 | 简体中文 | English | 日本語 | 한국어

功能特性 • 快速开始 • 图文教程 • 桌面版 • 部署指南


  
    
  


登录即可体验小说转短剧、分镜制作、视频生成和剪辑。


  
    
  



  
    
  




---

 📖 项目简介

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

 🎯 核心价值

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

 🛠️ 技术架构


frontend/   — Nuxt 3 + Vue 3 + TypeScript (纯 CSS,无 UI 框架)
backend/    — Hono + Drizzle ORM + Mastra AI Agents + better-sqlite3
backend/workspace/skills/ — Agent 技能定义 (SKILL.md,支持界面在线编辑)
desktop/    — Electron 桌面版(主进程 + esbuild 打包 + electron-builder 出 dmg/exe)
data/       — 生成资源文件与 SQLite 数据库


---

 ✨ 功能特性

 🎭 角色管理

- ✅ AI 生成角色形象
- ✅ 批量角色生成
- ✅ 角色图片上传和管理

 🎬 视频任务

- ✅ AI 自动生成视频任务
- ✅ 场景描述和视频提示词生成
- ✅ 按任务批量生成视频

 🎥 视频生成

- ✅ 文生视频自动生成
- ✅ FFmpeg 单镜头合成与字幕处理
- ✅ 整集拼接导出

 📦 资源管理

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

 🤖 AI Agents

内置 4 个 Mastra Agent,支持数据库配置和 Skill 扩展:

| Agent | 职责 |
|---|---|
| script_rewriter | 小说 → 格式化剧本改写 |
| extractor | 角色 / 场景 / 道具智能提取与去重 |
| storyboard_breaker | 剧本 → 分镜序列拆解 |
| prompt_generator | 角色/场景/道具图片提示词 + 分镜视频提示词生成 |

 🌐 多语言界面

界面内置 中文 / English / 日本語 / 한국어 四种语言,并可全局设置 AI 生成内容的语言。

 🔌 多厂商适配

| 类型 | 支持厂商 |
|---|---|
| 文本 | OpenAI(兼容接口)、Gemini |
| 图片 | OpenAI、Gemini、火山引擎 |
| 视频 | 火山引擎 Seedance 2.0(标准 / Fast / Mini)、MiniMax H3、阿里云百炼 Wan 3.0 (Prime / 标准) |

---

 🚀 快速开始

 📋 环境要求

| 软件 | 版本要求 | 说明 |
|---|---|---|
| Node.js | 20+ | 前后端运行环境 |
| npm | 9+ | 包管理工具 |

 数据库零安装:内置 SQLite(单文件,随项目数据目录存放),无需安装任何数据库服务。
 FFmpeg 无需安装:项目通过 ffmpeg-static / ffprobe-static npm 包内置二进制,开箱即用。

 ⚙️ 环境变量

无需配置文件,通过环境变量设置(均有默认值,本地开发可零配置启动):

| 变量 | 默认值 | 说明 |
|---|---|---|
| SQLITE_PATH | /data/huobao.sqlite3 | SQLite 数据库文件位置 |
| PORT | 5679 | 后端服务端口 |
| STORAGE_PATH | /data/static | 生成文件存储目录 |
| HUOBAO_DATA_DIR | — | 桌面版由 Electron 主进程注入(userData 数据根) |
| WORKSPACE_PATH | backend/workspace | Agent 技能/提示词目录(桌面版指向 userData 可写副本) |
| FRONTEND_DIST | frontend/dist | 前端静态产物目录 |
| FFMPEG_BIN / FFPROBE_BIN | npm 内置二进制 | 自定义 ffmpeg/ffprobe 可执行文件路径 |
| PUBLIC_BASE_URL | — | Seedance 引用本地参考资源时所需的公网地址(服务器部署用) |

 说明:AI 服务的 API Key、Base URL 和模型参数全部在 Web 界面的「设置」页配置并入库,不在配置文件/环境变量中维护。

 📥 安装依赖

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

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

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


 🎯 启动项目

 方式一:开发模式(推荐)

前后端分离,支持热重载:

bash
 终端1:启动后端
cd backend
npm run dev

 终端2:启动前端
cd frontend
npm run dev


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

 方式二:单服务模式

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

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

 2. 复制构建产物到后端读取的目录(generate 产物在 .output/public,后端只读取 frontend/dist)
cp -r .output/public dist

 3. 启动后端
cd ../backend && npm start


访问: http://localhost:5679

 🗄️ 数据库

内置 SQLite(better-sqlite3 + WAL 模式),数据库表在首次启动时自动创建(幂等重放 DDL 与种子数据),默认文件位于 data/huobao.sqlite3,可通过 SQLITE_PATH 重定向。桌面版数据存放在用户数据目录(~/Library/Appli

Top issues

Latest release

HuobaoDrama v4.0.11 v4.0.11 2026-11-05
HuobaoDrama 4.0.11

- 安装包和自动更新源迁移到 installer.firemux.site。
- 更新检查优先使用国内 CDN,保留 GitHub Releases 备用更新源。
- 同步内置服务的版本检查地址。

提供 macOS Apple Silicon、macOS Intel 和 Windows x64 安装包,以及 macOS 应用内更新 ZIP。

安装包沿用项目现有未签名配置。校验值见 SHA256SUMS 文件。

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON