推荐一个AI 短剧生成开源项目
- 2026-10-08 14:49:14
【目录】 一、项目简介 二、核心价值 三、核心功能 1. 角色管理 2. 视频任务与分镜制作 3. 视频生成与合成 4. 资源管理 5. 四大内置 AI Agent 6. 多语言界面 & 多厂商适配 四、使用指南 第 1 步 · 创建项目 第 2 步 · 配置 AI 服务（首次） 第 3 步 · 剧本阶段 第 4 步 · 资产制作 第 5 步 · 分镜与视频 第 6 步 · 拼接导出 五、技术栈 后端（backend/） 前端（frontend/） 桌面端（desktop/） 部署/基础设施 六、本地快速部署启动 环境要求 方式一：开发者模式（推荐，支持热重载） 方式二：单服务模式（后端同时托管前端） 方式三：桌面客户端（最简单，下载即用） 七、完整创作流程（6 步走） 八、项目亮点总结 九、项目代码仓库地址
推荐一个AI 短剧生成开源项目
一、项目简介
推荐一个AI 短剧生成开源项目，它把大语言模型（剧本创作）、AI 绘图（角色/场景形象）、文生视频/图生视频（分镜动效）、FFmpeg（合成剪辑） 整合进一条可视化工作流中——用户只需输入一段故事创意或小说文本，系统就能自动走完「剧本改写 → 角色设计 → 场景提取 → 分镜拆解 → 图片/视频生成 → 拼接导出」全流程，让独立创作者不需要专业影视团队、不需要演员场地，几小时就能产出一部完整短剧。
项目是由 chatfire-AI 团队开源的一个基于 AI 的短剧自动化生产全栈平台，核心口号是「一句话生成完整短剧，从剧本到成片全自动化」。
二、核心价值
三、核心功能
1. 角色管理
AI 生成角色形象：根据剧本中的人物描述自动生成符合设定的肖像图 批量角色生成：一次性处理剧里所有角色 角色图片上传与管理：支持上传自有图片，统一素材库管理 角色一致性：生成的角色图会作为后续视频生成的参考素材，保证同一人物画风统一
2. 视频任务与分镜制作
AI 自动拆分分镜：将整集剧本按镜头节奏切分为 8-15 秒的分镜序列 场景描述 & 视频提示词生成：每个分镜自动生成景别、运镜、动作、画面描述、视频提示词 按任务批量生成视频：支持批量发起、一键重试失败任务 分辨率/时长档位选择：顶栏可切换视频模型、分辨率（480p/720p/1080p/2K）、时长。
3. 视频生成与合成
文生视频 / 图生视频：支持以角色图作为参考图驱动视频生成 FFmpeg 单镜头合成 & 字幕处理：项目内置 FFmpeg 二进制，开箱即用 整集拼接导出：勾选镜头后自动合成为 MP4 成片，支持在线播放与下载 封面/缩略图优化：自动生成 400px WebP 缩略图与视频海报帧，加快列表加载
4. 资源管理
素材库统一管理：角色/场景/道具/分镜/视频分类归档 本地存储：所有生成文件存放于本地 data/static/目录任务进度追踪：工作台展示流水线各环节状态、任务列表抽屉 资源导入导出：支持素材复用、历史剧集续作
5. 四大内置 AI Agent
基于 Mastra AI Agents 框架，职责清晰分工：
script_rewriter | |
extractor | |
storyboard_breaker | |
prompt_generator |
Agent 的技能文件以 SKILL.md 形式存放在 backend/workspace/skills/，支持在设置页在线编辑提示词，可自定义创作风格。
6. 多语言界面 & 多厂商适配
UI 四语言：中文 / English / 日本語 / 한국어，可全局设置 AI 生成内容的语言 多模型厂商接入：
火宝快捷配置：一个 Huobao API Key 即可一键写入文本/图片/视频三套推荐配置，开箱即用
四、使用指南
从小说到成片的完整制作流程。左侧进度栏始终标示当前所处阶段，跟着走即可。
第 1 步 · 创建项目
首页点「新建项目」，填写剧名并选择画面比例（横屏 16:9 / 竖屏 9:16，创建后不可改）与画面风格（3D / 真实感等，影响全局生图提示词）。
项目卡片即项目列表，随时点入续作：
第 2 步 · 配置 AI 服务（首次）
设置页「火宝快捷配置」粘贴 API Key 一键写入三条推荐配置；或用「手动模板」按厂商自选模型（顶栏可随时切换当前模型，见第 5 步）。
第 3 步 · 剧本阶段
进入剧集工作台，先粘贴原始内容（小说文本），再点「AI 改写」生成拍摄剧本——按集拆分、标注场景与角色，改写时可换文本模型、调语气。满意后「保存并进入制作」。
第 4 步 · 资产制作
对剧本执行提取，自动获得角色 / 场景 / 道具清单；逐个点「生成形象」产出一致性参考图（也可批量）。生成的资产图会在后续生视频时作为参考素材注入。
第 5 步 · 分镜与视频
「视频制作」页先拆分分镜（AI 按镜头节奏切分并生成视频提示词），然后：
顶栏选择本次使用的视频模型（Seedance / Wan 3.0 / MiniMax…），分辨率与时长档位随之联动 右侧检查 / 微调每个分镜的提示词（ @角色名自动映射参考图）点「批量生成视频」发起任务，失败任务可一键「重试失败」
第 6 步 · 拼接导出
勾选镜头（悬停可预览单个镜头视频），点「开始拼接」，FFmpeg 自动合成为完整剧集成片，支持在线播放与下载。完成后点「标记完成」，左侧进度栏点亮。
剧集列表随时展示各集制作状态，点「进入制作」继续未完成的集：
五、技术栈
项目是一套纯 TypeScript 全栈应用，代码结构清晰：
后端（backend/）
运行时：Node.js 20+ Web 框架：Hono（轻量高性能） ORM：Drizzle ORM + better-sqlite3（WAL 模式，单文件 SQLite） AI Agent：Mastra + AI SDK（OpenAI 兼容接口） 视频处理：fluent-ffmpeg + ffmpeg-static/ffprobe-static（内置二进制，无需系统安装） 图片处理：Sharp（缩略图、海报帧自动生成）
前端（frontend/）
框架：Nuxt 3（SPA 模式）+ Vue 3 + TypeScript 路由：文件路由（Vue Router 4） 样式：纯 CSS + CSS Variables（无 UI 框架，高度定制化） 图标：Lucide Vue 国际化：vue-i18n（中/英/日/韩）
桌面端（desktop/）
壳：Electron 37.x（utilityProcess 承载后端，BrowserWindow 同源加载） 打包：esbuild（后端单文件 bundle）+ electron-builder 输出：macOS dmg（arm64 + Intel 双架构）、Windows NSIS 安装器（win-x64，支持 macOS 交叉打包） 更新：内置应用内更新器（sha256 校验，国内 CDN 源优先）
部署/基础设施
数据库：SQLite（单文件，零安装；从 v4.0.0 起 MySQL 已迁移到 SQLite，提供自动迁移脚本） 容器化：Docker 多架构镜像（linux/amd64 + linux/arm64），支持 Watchtower 自动更新 目录结构： frontend/ — Nuxt3 + Vue3 + TypeScript
backend/ — Hono + Drizzle ORM + MastraAgents + better-sqlite3
desktop/ — Electron 桌面端
docker/ — Docker 配置
configs/ — 配置文件
data/ — 生成资源与 SQLite 数据库
六、本地快速部署启动
火宝短剧在本地开发几乎零配置即可启动——数据库和 FFmpeg 都内置了，无需额外安装服务。
环境要求
✅ 数据库零安装：内置 SQLite 单文件，首次启动自动建表
✅ FFmpeg 零安装：通过ffmpeg-staticnpm 包内置二进制
方式一：开发者模式（推荐，支持热重载）
1. 克隆项目
git clone https://github.com/chatfire-AI/huobao-drama.git
cd huobao-drama
2. 安装后端依赖
cd backend && npm install
3. 安装前端依赖
cd ../frontend && npm install
4. 终端 1：启动后端
cd backend
npm run dev
5. 终端 2：启动前端
cd frontend
npm run dev
启动后访问：
🌐 前端界面：http://localhost:3013 🔌 后端 API：http://localhost:5679/api/v1（前端自动代理 /api和/static）
方式二：单服务模式（后端同时托管前端）
1. 构建前端
cd frontend && npm run generate
cp -r .output/public dist
2. 启动后端（同时提供 API 和静态页面）
cd ../backend && npm start
访问：http://localhost:5679
方式三：桌面客户端（最简单，下载即用）
最推荐普通用户使用，无需 Node.js、无需命令行：
HuobaoDrama-4.0.0-arm64.dmg | |
HuobaoDrama-4.0.0.dmg | |
HuobaoDrama.Setup.4.0.0.exe |
下载地址：
国内镜像（腾讯云，推荐）：installer.chatfire.site GitHub Releases：https://github.com/chatfire-AI/huobao-drama/releases
双击安装即可，数据存放在 ~/Library/Application Support/HuobaoDrama/，卸载不丢数据。
方式四：🐳 Docker 一键部署（服务器推荐）
拉取官方多架构镜像（免构建）
docker pull huobao/huobao-drama:4.0.0
运行
docker run -d \
--name huobao-drama \
-p 5679:5679 \
-v huobao-data:/app/data \
--restart unless-stopped \
huobao/huobao-drama:4.0.0
访问：http://localhost:5679，数据持久化在 huobao-data 命名卷。
或者用 docker compose（含 Watchtower 自动更新）：
cp .env.example .env 修改 WATCHTOWER_TOKEN
HUOBAO_VERSION=4.0.0 docker compose up -d --build
首次使用必做：配置 AI 服务
启动后页面顶部会有横幅提示「尚未配置模型」：
打开「设置」页 获取 Huobao API Key（https://api.firemux.com），在「火宝快捷配置」粘贴后一键写入文本/图片/视频三套推荐配置 或使用「手动模板」按 OpenAI/Gemini/火山/阿里等厂商逐个添加，支持连通性测试 三类配置（文本/图片/视频）全部启用后，横幅自动消失，即可开始创作！
七、完整创作流程（6 步走）
创建项目：填写剧名，选择画面比例（横屏 16:9 / 竖屏 9:16）与视觉风格（3D/写实等） 配置 AI 服务（首次使用）：粘贴 API Key 一键配置模型 剧本阶段：粘贴原始小说/创意文本，点「AI 改写」生成格式化拍摄剧本 资产制作：一键提取角色/场景/道具，逐个「生成形象」产出参考图 分镜与视频：AI 拆分分镜 → 选择视频模型 → 微调提示词 → 批量生成视频 拼接导出：勾选镜头 → FFmpeg 自动合成整集成片 → 在线播放/下载
八、项目亮点总结
真正的全流程自动化：不是某个单点工具，而是把"剧本→角色→分镜→视频→合成"整条链路串起来，AI Agent 接力完成 工程质量扎实：TypeScript 全栈、DDD 架构清晰、从 MySQL 平滑迁移到 SQLite、桌面/服务器/Docker 三种形态齐全 开箱即用体验：内置 SQLite 和 FFmpeg 二进制、一键 Key 配置、零配置即可本地启动 国际化 & 多模型支持：四语言 UI、文本/图片/视频三大类多家厂商接入，不绑定单一服务商 桌面端体验好：Electron 打包、应用内自更新、用户数据隔离，普通用户不用懂技术就能用 可扩展性强：Agent Skill 使用 SKILL.md 定义，可在线编辑提示词自定义创作风格；Drizzle ORM 让数据库切换无痛 支持主流视频大模型：火山 Seedance 2.0、阿里万相 Wan 3.0、MiniMax H3 等一线视频生成模型，紧跟技术前沿
如果你是独立创作者、短剧爱好者、AI 视频探索者，或者想学习TypeScript 全栈 + AI Agent 工程化的最佳实践，这个项目都非常值得一试！
九、项目代码仓库地址
项目代码仓库地址:
https://github.com/chatfire-AI/huobao-drama
【推荐阅读】
1. 我们正处在一个技能快速贬值的时代，如何看待智能时代的价值重构？
2. 换多了工作后才知道，为什么 HR 看了你的简历觉得不合适，还要你来面试？
3. 当代很多女性: 上嫁没机会，下嫁怕吃亏,平嫁不甘心，不嫁又怕催,慕强而不自强，寄生而不共生，平庸而不自知,利益面前成熟，责任面前幼稚
4. 金融“剩女”是“工伤” 大家以为金融女性难嫁人，其实是被动剩下来了
5. AI技术迭代发展迅猛，技术日新月异，当前的AI热潮成为现代人的集体技能焦虑
6. 未来十年，有80%的家庭，将面临4大难题，要及早做准备
8. 所有人都要做好5年内彻底失业的准备，岗位正在被重新定义：消失的是机械重复，崛起的是人机协作
