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
+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/AppliTop issues
#154软件闪退呀4 comments · 2026-11-09#147有个bug,再手动模板里,点击新增后,先用鼠标选中已存在的内容:比如选中配置名称里的文字,然后再选中Base URL的文字,这个配置页面会闪退3 comments · 2026-10-26#123生成视频时,如何保持声音的一致性,当前无法把声音当作参考素材2 comments · 2026-09-20#136资产制作中角色生成中同时点击多个生成的时候,最后一个一直显示生成中没有图片生成1 comments · 2026-10-10#119Windows Electron 使用 Codex 制作闭环1 comments · 2026-09-14#110集成本地 Codex App Server 作为短剧制作总导演1 comments · 2026-09-14#109mac arm641 comments · 2026-09-11#107是否考虑推出官方CLI,类似LIBTV-CLI1 comments · 2026-09-10
Latest release
HuobaoDrama v4.0.11 v4.0.11 2026-11-05HuobaoDrama 4.0.11 - 安装包和自动更新源迁移到 installer.firemux.site。 - 更新检查优先使用国内 CDN,保留 GitHub Releases 备用更新源。 - 同步内置服务的版本检查地址。 提供 macOS Apple Silicon、macOS Intel 和 Windows x64 安装包,以及 macOS 应用内更新 ZIP。 安装包沿用项目现有未签名配置。校验值见 SHA256SUMS 文件。