🎬 Huobao Drama — AI 短剧生成平台 / AI Short Drama Generation Platform
基于 TypeScript 全栈的 AI 短剧自动化生产平台
A full-stack TypeScript platform for automated AI short-drama production
中英双语 / Bilingual | 简体中文 | English | 日本語 | 한국어
文本 · 图片 · 视频全部 AI 能力，一个 Key 即可开通
Text, image, and video AI capabilities — one key unlocks everything
部署完成后，在「设置 → 火宝快捷配置」粘贴 Key，一键写入三条推荐配置。
After deploying, paste the key in "Settings → Huobao Quick Setup" to write three recommended configs in one click.
📖 项目简介 / Overview
Huobao Drama 是一个基于 AI 的短剧自动化生产平台，实现从剧本生成、角色设计、分镜制作到视频合成的全流程自动化。
Huobao Drama is an AI-powered short-drama production platform that automates the entire pipeline: script generation, character design, storyboard breakdown, and video compositing.
🎯 核心价值 / Core Value
-
🤖 AI 驱动：使用大语言模型解析剧本，提取角色、场景和分镜信息
🤖 AI-Driven: LLMs parse scripts and extract characters, scenes, and storyboard information
-
🎨 智能创作：AI 绘图生成角色形象和场景背景
🎨 Intelligent Creation: AI image generation for character designs and scene backgrounds
-
📹 视频生成：基于文生视频和图生视频模型自动生成分镜视频
📹 Video Generation: Text-to-video and image-to-video models automatically produce storyboard clips
-
🔄 工作流：完整的短剧制作工作流，从创意到成片一站式完成
🔄 End-to-End Workflow: A complete pipeline from idea to finished episode
🛠️ 技术架构 / Architecture
frontend/ — Nuxt 3 + Vue 3 + TypeScript（纯 CSS，无 UI 框架 / pure CSS, no UI framework）
backend/ — Hono + Drizzle ORM + Mastra AI Agents + better-sqlite3
backend/workspace/skills/ — Agent 技能定义，支持界面在线编辑 / Agent skill definitions (SKILL.md), editable in the UI
desktop/ — Electron 桌面版 / Electron desktop app（主进程 + esbuild + electron-builder / main process + esbuild + electron-builder）
data/ — 生成资源文件与 SQLite 数据库 / Generated assets and the SQLite database
✨ 功能特性 / Features
🎭 角色管理 / Character Management
-
✅ AI 生成角色形象
✅ AI-generated character designs
-
✅ 批量角色生成
✅ Batch character generation
-
✅ 角色图片上传和管理
✅ Character image upload and management
🎬 视频任务 / Video Tasks
-
✅ AI 自动生成视频任务
✅ Automatic AI video-task generation
-
✅ 场景描述和视频提示词生成
✅ Scene descriptions and video prompt generation
-
✅ 按任务批量生成视频
✅ Batch video generation per task
🎥 视频生成 / Video Generation
-
✅ 文生视频自动生成
✅ Text-to-video generation
-
✅ FFmpeg 单镜头合成与字幕处理
✅ FFmpeg per-shot compositing and subtitle handling
-
✅ 整集拼接导出
✅ Full-episode stitching and export
📦 资源管理 / Asset Management
-
✅ 素材库统一管理
✅ Unified asset library
-
✅ 本地存储支持
✅ Local storage support
-
✅ 任务进度追踪
✅ Task progress tracking
🤖 AI Agents
内置 4 个 Mastra Agent，支持数据库配置和 Skill 扩展：
Four built-in Mastra agents with database-backed configuration and Skill extensions:
| Agent | 职责Role |
|---|
script_rewriter | 小说 → 格式化剧本改写Novel → formatted script rewriting |
extractor | 角色 / 场景 / 道具智能提取与去重Intelligent extraction and dedup of characters / scenes / props |
storyboard_breaker | 剧本 → 分镜序列拆解Script → storyboard sequence breakdown |
prompt_generator | 角色/场景/道具图片提示词 + 分镜视频提示词生成Image prompts for characters/scenes/props + storyboard video prompts |
🌐 多语言界面 / Multi-Language UI
界面内置 中文 / English / 日本語 / 한국어 四种语言，并可全局设置 AI 生成内容的语言。
The interface ships in 中文 / English / 日本語 / 한국어, with a global setting for AI-generated content language.
🔌 多厂商适配 / Multi-Provider Support
| 类型Type | 支持厂商Providers |
|---|
| 文本Text | OpenAI(兼容接口)、GeminiOpenAI (compatible APIs), Gemini |
| 图片Image | OpenAI、Gemini、火山引擎OpenAI, Gemini, Volcano Engine |
| 视频Video | 火山引擎 Seedance 2.0(标准 / Fast / Mini)、MiniMax H3、阿里云百炼 Wan 3.0 (Prime / 标准)Volcano Engine Seedance 2.0 (Standard / Fast / Mini), MiniMax H3, Alibaba Bailian Wan 3.0 (Prime / Standard) |
🚀 快速开始 / Quick Start
📋 环境要求 / Requirements
| 软件Software | 版本要求Version | 说明Notes |
|---|
| Node.js | 20+ | 前后端运行环境Runtime for frontend and backend |
| npm | 9+ | 包管理工具Package manager |
数据库零安装：内置 SQLite（单文件，随项目数据目录存放），无需安装任何数据库服务。
Zero-install database: Bundled SQLite (single file in the project data directory) — no database server required.
FFmpeg 无需安装：项目通过 ffmpeg-static / ffprobe-static npm 包内置二进制，开箱即用。
No FFmpeg install needed: Binaries ship via the ffmpeg-static / ffprobe-static npm packages — works out of the box.
⚙️ 环境变量 / Environment Variables
无需配置文件，通过环境变量设置（均有默认值，本地开发可零配置启动）：
No config files — everything is set via environment variables (all have defaults; local dev needs zero configuration):
This is the beginning of the README. Read the rest at the original. Read the full README ↗
