火宝短剧：一句话生成完整短剧的全栈 TypeScript 平台

项目地址：https://github.com/chatfire-AI/huobao-drama  协议：CC BY-NC-SA 4.0  Stars：15,266  更新：2026-09-17

一、产品深度介绍

（一）它是什么

火宝短剧是一个开源的 AI 短剧生产流水线。它把「一句话想法」到「完整短剧成片」的环节串成闭环：剧本改写 → 角色/场景/道具提取 → 分镜拆解 → 图片与视频生成 → 合成输出。四个内置 Mastra Agent 分别负责不同工序，用户只需在网页端或桌面端输入创意并点击执行。

官方仓库的自我定位非常直接：「一句话生成完整短剧，从剧本到成片全自动化」。这套定位决定了它不是一个单纯的视频模型调用工具，而是一个把创意管理、多 Agent 编排、素材生成、后期合成打包在一起的工程化平台。

（二）技术表现

• 全栈 TypeScript：后端 Hono + Drizzle ORM + better-sqlite3（WAL 模式），前端 Nuxt 3 + Vue 3 + TypeScript。
• 零数据库安装：默认 SQLite 单文件，无需 MySQL 服务器即可运行。
• 零 FFmpeg 安装：通过 ffmpeg-static / ffprobe-static 自带二进制。
• 多语言界面：中文、English、日本語、한국어。
• 多模型适配：支持 OpenAI、Gemini、火山引擎、阿里巴巴等图像与视频模型接口。
• 桌面端交付：Electron 打包，支持 macOS arm64 / Intel 与 Windows，内置自动更新。

小黑配图：一句话想法从漏斗式机器进入，经过剧本·分镜·图·视频的处理，最终输出成片短剧。

二、主要功能特点与应用场景

火宝短剧的核心能力可以归纳为「四 Agent + 三交付形态」。四个 Agent 把创作流程拆成可编排的工序，三种交付形态让用户可以根据环境选择最合适的部署方式。

• 剧本改写 Agent：把小说或 raw 剧本改写成格式化的拍摄剧本。
• 内容提取 Agent：从剧本中自动抽取角色、场景、道具，并做去重。
• 分镜拆解 Agent：把剧本切成故事板序列，明确每个镜头的画面与动作。
• 提示词生成 Agent：为角色/场景/道具生成图像提示词，并为故事板生成视频提示词。

适用场景包括：个人创作者快速验证短剧创意、小型工作室批量试片、开发者在此基础上二次开发 AI 内容平台，以及教学场景下演示 AI 多 Agent 工作流。

三、如何安装与使用

源码方式需要分别安装前后端依赖并启动：

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。首次部署后，在「Settings → Huobao Quick Setup」中粘贴 Huobao API Key，即可一键写入三套推荐配置。

如果你不想折腾源码，推荐直接使用桌面端：从 GitHub Releases 或国内 COS 镜像下载对应平台的 dmg/exe 安装包，双击安装后自带自动更新。Docker 用户可执行：

docker pull huobao/huobao-drama:4.0.0

四、官方地址与获取方式

• GitHub 仓库：https://github.com/chatfire-AI/huobao-drama
• 官方网站：https://www.chatfire.site
• 国内下载镜像：https://installer.chatfire.site（COS + CDN 加速）
• 社区交流：README 中提供微信群二维码

五、与同类方案对比

六、核心机制深度解析

火宝短剧用四个 Mastra Agent 把创作工序串成流水线。每个 Agent 都有独立的配置表，可以通过扩展 Skill 自定义行为。

这个设计的价值在于：创作者不需要分别调用剧本改写、Stable Diffusion、Runway、剪映等工具，再手动剪辑。火宝短剧把「输入创意」和「拿到成片」之间的所有工程步骤封装在可本地运行的服务里。

七、实用技巧

• 桌面端数据隔离：SQLite 数据库、生成媒体、Agent 技能都存放在 userData 目录，卸载应用不会丢失数据。
• 国内加速：README 中提供 Tencent COS 镜像与 CDN 域名 installer.chatfire.site，下载安装包和更新包时优先使用。
• 技能模板安全升级：首次启动会自动复制工作区技能模板，后续升级只填补新增项，不会覆盖已有自定义配置。
• 自定义 FFmpeg：可通过环境变量 FFMPEG_BIN / FFPROBE_BIN 指向系统级 FFmpeg，避免与自带二进制冲突。

八、最新更新动态

v4.0.0（2026-08）是近期最大版本：

• 发布 Electron 桌面端，支持 macOS arm64 / Intel 与 Windows。
• 数据库从 MySQL 迁移到 SQLite（better-sqlite3 + WAL），零数据库服务器即可运行。
• 后端通过 esbuild 打包为单文件，部署更简单。
• 新增国内 CDN 分发域名 installer.chatfire.site。

v2.0.0（2026-04）完成了全栈 TypeScript 重构：后端 Hono + Drizzle ORM，前端 Nuxt 3 + Vue 3，AI Agent 层迁移到 Mastra；同时新增剧集工作台 UI、Docker 部署支持、运行时 Skill 加载机制，以及 OpenAI / Gemini / 火山引擎 / 阿里等多厂商图像/视频模型适配。

九、常见问题 FAQ

十、总结

火宝短剧把 AI 短剧生产从「多个工具手动串联」变成「一句话自动出片」。它的真正价值不在于某个单一模型，而在于用 Mastra Agent 把剧本改写、角色提取、分镜、生图、生视频、合成剪辑串成一个可本地运行的工程化流水线，并且提供了桌面端、Docker、源码三种交付形态。对于想快速验证短剧创意的小团队或个人创作者，这是一个值得部署的完整方案。

在撰写本文的过程中，我主要参考了火宝短剧 GitHub 仓库（chatfire-AI/huobao-drama）的 README.md、README.zh-CN.md、LICENSE 与更新日志，以及官方网站 www.chatfire.site。文中数据以官方公开信息为准，可能随版本更新而变化。