本地 AI 短剧 & 漫剧生成工具 —— 下载即用，完全开源，数据不出本机
LocalMiniDrama · AI-powered short drama creator
市面上 AI 短剧工具不少，但真正能本地离线运行、开箱即用、素材不上云的几乎没有。
本项目用纯 JavaScript 从零搭建，接入你自己的 AI API，打开即可生成完整 AI 短剧。
✅ 无订阅费 · ✅ 数据本地存储 · ✅ 支持多家 AI 服务商 · ✅ 完全开源可二次开发
首页 · 项目卡片一览，亮色模式
 剧集管理 · 分集 + 资源库 |
 分镜制作 · 图片 + 视频一键生成 |
 角色生成 · AI 自动提取并生成角色形象图 |
 分镜制作 · 专业视频参数（景别 / 运镜 / 灯光 / 景深） |
 场景库 · 一键「加入本集」，复用已有场景素材 |
|
以下 3 段视频由本软件自动工作流选择即梦 1.0（字节旗下图生视频模型）生成，展示连续分镜下角色外貌一致性的保持效果。
三个分镜均来自同一剧集，主角形象、服装、整体风格全程稳定统一，充分验证本工具的分镜参考图传递机制。
|
分镜 1 · 角色出场，即梦 1.0 生成 |
分镜 2 · 连续镜头，角色服装保持一致 |
分镜 3 · 不同景别，人物外貌高度统一 |
💡 即梦 1.0 仅为演示版本，本工具同时支持火山引擎豆包 Seedance、通义万相、Vidu、可灵 Kling 等多家视频模型，更高版本模型效果更佳。
| 步骤 | 功能 | 说明 |
|---|---|---|
| 1 | 故事生成 | 输入梗概 + 风格，AI 自动生成多集剧本 |
| 2 | 剧本编辑 | 分集管理，剧本文本可自由编辑 |
| 3 | 角色生成 | AI 提取角色列表，逐个生成角色形象图 |
| 4 | 场景生成 | 从剧本自动提取场景，生成场景背景图 |
| 5 | 道具生成 | 从剧本提取/手动添加道具，生成道具图 |
| 6 | 分镜生成 | 按集自动生成分镜脚本（含景别/运镜/台词） |
| 7 | 图片/视频生成 | 逐镜生成静帧图与视频片段 |
| 8 | 合成视频 | 所有分镜视频自动合成为完整剧集文件 |
- 一键生成视频：从角色图到最终合成视频，全程自动执行
- 补全并生成：智能跳过已有内容，只补全缺失部分
- 失败自动重试：每步最多重试 3 次，应对 429 限流等错误，不中断流程
- 实时进度展示：执行过程中展示当前步骤与完整错误日志
- 工程导出/导入：完整打包工程为 ZIP（含图片、视频、文字、配置），换机或分享一包搞定
- 素材库：全局角色/场景/道具库，跨项目复用；各项目资源严格隔离
- 画面比例：新建项目时选定比例（16:9 / 9:16 / 1:1 等），后续生成全程适配
- 分集管理：支持新增/删除分集，剧本预览
- 图片提示词：查看并编辑每个分镜的图片生成提示词，修改后重新生成
- 视频提示词：全文编辑 + 字段展开编辑（场景/时长/动作/氛围/运镜/景别），自动重新拼装
- 图片管理：AI 生成、手动上传、拖拽上传，随时替换
- 图片生成、视频生成、文本生成三类模型独立配置
- 兼容 阿里云 DashScope、火山引擎 Volcengine、本地部署模型 及其他 OpenAI 兼容接口
- 可视化管理，保存即生效，支持一键测试连接
- 内置「一键配置通义」「一键配置火山」快捷入口，含 API Key 申请引导
- 支持亮色模式（默认）与暗色模式切换，偏好持久保存
- 高级设置：支持自定义 AI 提示词（故事生成、分镜拆解、角色/场景/道具提取等 9 个），可随时一键恢复默认
- 三个主页面均可随时切换主题
前往 Releases 下载最新版，每次发布提供两个版本：
| 文件名 | 说明 | 推荐人群 |
|---|
| 本地短剧助手 x.x.x.exe | 标准版免安装便携版 | 首次使用，含示例项目 |
| 本地短剧助手-Lite-x.x.x.exe | Lite 版免安装便携版 | 已熟悉使用，包体更小 |
标准版 vs Lite 版：标准版内置一个示例短剧项目，打开即可查看完整创作流程示例，适合新手上手参考；Lite 版不含示例数据，包体更小，适合已了解使用方式的用户。功能完全一致。
双击运行 → 在软件「AI 配置」页填入你的 API Key → 开始创作。
首次运行会在
%APPDATA%\LocalMiniDrama\backend\configs\config.yaml生成配置文件。
需要 Node.js >= 18
# 1. 克隆项目
git clone https://github.com/xuanyustudio/LocalMiniDrama.git
# 或 Gitee：git clone https://gitee.com/bi_shang_a/localminidrama.git
cd LocalMiniDrama
# 2. 启动后端（默认端口 5679）
cd backend-node
npm install
cp configs/config.example.yaml configs/config.yaml
# 编辑 config.yaml，填入 AI API 地址与密钥
npm run migrate # 首次运行：初始化数据库
npm start
# 3. 启动前端（新开终端，默认端口 3013）
cd frontweb
npm install
npm run dev浏览器访问 http://localhost:3013 即可。
也可双击根目录的 run_dev.bat 一键同时启动前端和后端。
📖 更详细的开发、打包、Docker 指南请见 → 快速开始文档
| 服务商 | 文本生成 | 图片生成 | 视频生成 |
|---|---|---|---|
| 阿里云 DashScope（通义） | ✅ | ✅ | ✅ |
| 火山引擎 Volcengine（豆包） | ✅ | ✅ | ✅ |
| 可灵 Kling AI | — | ✅ | ✅ |
| Google Gemini（Imagen / Veo） | — | ✅ | ✅ |
| Vidu 生数科技 | — | — | ✅ |
| NanoBanana（含代理） | — | ✅ | — |
| 本地部署（Ollama 等 OpenAI 兼容） | ✅ | — | — |
| 其他 OpenAI 兼容接口 | ✅ | ✅ | — |
📖 各服务商 API Key 申请与配置详见 → AI 配置指南
LocalMiniDrama/
├── backend-node/ # Node.js 后端（Express + SQLite）
│ ├── src/
│ │ ├── config/ # 配置加载（YAML）
│ │ ├── db/ # SQLite 连接与迁移
│ │ ├── services/ # 业务逻辑（生成服务、导出导入等）
│ │ └── routes/ # REST API 路由
│ └── configs/ # config.yaml 配置文件
├── frontweb/ # Vue 3 前端（Vite + Element Plus）
│ └── src/
│ ├── views/
│ │ ├── FilmList.vue # 首页：项目列表、素材库
│ │ ├── DramaDetail.vue # 剧集管理：信息/分集/资源库
│ │ └── FilmCreate.vue # 制作页：剧本/角色/分镜/生成
│ ├── api/ # 后端 API 封装
│ ├── stores/ # Pinia 状态管理
│ └── styles/ # 全局样式（主题变量）
├── desktop/ # Electron 桌面壳（打包 exe）
├── docs/ # 文档目录
└── README.md
技术栈：
| 层 | 技术 |
|---|---|
| 前端 | Vue 3 + Vite + Element Plus + Pinia + Axios |
| 后端 | Node.js + Express + SQLite (better-sqlite3) |
| 桌面 | Electron 28 + electron-builder |
| 语言 | 纯 JavaScript（无 TypeScript） |
查看完整更新记录 → CHANGELOG
最新版 v1.2.3 亮点：
- 🆕 分镜解说旁白（narration）：分镜生成可选「生成分镜时生成解说旁白」，AI 为每镜输出独立
narration字段（与角色对白dialogue分离），便于后期 TTS 与成片旁轨 - 🆕 导出解说 SRT：按分镜顺序与单镜时长累计时间轴，一键导出字幕文件；支持「解说配音」走现有 TTS 接口
- 🔧 首镜解说为空修复：流式增量先入库的分镜在任务结束后会用最终完整 JSON 再
UPDATE合并，避免第 1/2 镜解说因早写库而永久缺失 - 🔧 解说模式提示词强化：系统与用户提示中明确首镜开场解说、全镜非空等硬性要求，减少模型漏写
- 🎨 解说相关 UI：解说输入框与「导出解说 SRT」按钮在深浅色主题下对比度优化；导出按钮白字紫底易辨认
v1.2.2 亮点：
- 🆕 视频帧连贯性（连贯帧模式）、小说/长文导入、ffmpeg 自动解压 等（详见 CHANGELOG）
v1.2.1 亮点：
- 🆕 可灵 Kling AI 接入：新增可灵图片（kling-image / kling-omni-image）与视频（kling-video / kling-omni-video / kling-motion-control）协议支持，AI 配置页可直接选择
- 🆕 场景/道具"加入本集"：场景库与道具库新增"加入本集"按钮，与角色库体验一致，一键复用素材
- 🆕 视频历史记录与主视频选择：视频重新生成后自动保留历史版本，缩略图条带一览，点击切换主视频；合成视频时自动使用当前选定版本
- 🔧 合成视频主视频修复：修复合成视频时始终取最新生成记录、忽略用户已选定历史视频的问题
v1.1.15 亮点：
- 🆕 多集剧本生成：故事生成新增"生成集数"选项（1-6 集），AI 一次性输出多集完整剧本并自动保存，默认选中第 1 集
- 🆕 AI 并发生成：一键生成支持图片/视频并发（默认各 3 路），同时处理多个角色/场景/分镜任务，显示实时任务进度
- 🆕 可视化风格选择器：生成风格下拉框升级为带缩略图的图文选择器，直观预览各类画风
- 🆕 AI JSON 输出强化：分镜/角色/场景/道具提取全面启用 JSON 模式，并集成
jsonrepair自动修复 AI 畸形 JSON 输出 - 🔧 图片下载稳定性：打包 exe 环境下的图片下载从
fetch改为 Node.jshttp/https模块，支持重试与超时，解决fetch failed问题
v1.1.14 亮点：
v1.1.13 亮点：
- 🆕 分镜图相机角度视角修正：分镜
angle字段翻译为相机透视描述注入提示词，使 AI 生成画面视角与镜头设定一致 - 🆕 四宫格序列图模式（后端拆分）：开关开启后后端自动拼装四宫格提示词并用
sharp拆分为 4 张独立子图，主图选择持久化 - 🔧 分镜主图刷新后恢复：
dramaService补充返回image_url、local_path、main_panel_idx，前端可正确从后端恢复主图选中状态
v1.1.11 亮点：
- 🆕 批量生成分镜图 / 批量生成分镜视频：一键为所有缺图/缺视频分镜批量生成，含实时进度与随时停止
- 🆕 角色/场景影响分镜面板：资源卡片新增「↻ 重新生成分镜图」按钮，批量重新生成关联分镜
- 🔧 手动选择角色/场景持久化：
onStoryboardCharacterChange/onStoryboardSceneChange实现调用后端 update API
| 用户类型 | 场景 |
|---|---|
| 📹 内容创作者 | 快速批量生产 AI 短剧 / 漫剧 |
| 🔒 隐私敏感用户 | 素材不上传云端，数据完全自控 |
| 🛠 开发者 | 在此基础上二次开发、扩展 AI 服务商 |
| 🌱 入门探索者 | 低成本体验 AI 视频赛道 |
| 工具 | 特点 |
|---|---|
| Kino 视界 | 国内活跃的 AI 短剧平台，云端为主，非开源 |
| Filmaction AI | AI 自动生成剧情/分镜/配音，SaaS/Web 端，部分付费 |
| Toonflow | 开源 AI 漫画/短剧流程工具，流程设计对本项目有所启发 |
| openoii / oiioii | 开源，轻量化 AI 可视化创作，本项目在提示词设计上有所参考 |
| ChatFire | AI 驱动剧情生成/对话体短剧，启发了本项目后端设计 |
本项目更聚焦于本地离线、界面友好、方便二次开发，欢迎 Issue 推荐更多工具。
以下功能正在规划或开发中，欢迎参与讨论与贡献：
| 计划 | 说明 |
|---|---|
| ✅ 即梦 2.0 模型接入 | 已支持豆包 Seedream 4.5 图片生成 |
| ✅ NanoBanana 图片模型接入 | 已支持，含官方 API 与代理模式（v1.1.8） |
| 📎 分镜参考图自由上传 | 分镜编辑支持自由上传任意图片作为参考图 |
| 🎨 参考图自由选择 | 生成分镜图时，可手动指定使用哪些角色/场景图片作为参考 |
| 🔲 宫格图生成视频 | 支持将多帧宫格合图作为输入生成视频片段（部分模型已支持） |
有好想法或愿意认领某项开发？欢迎 提 Issue 或直接提 PR！
欢迎任何形式的贡献！
一个游戏搬砖工，用自己熟悉的 JavaScript 做了这个开源项目，先做了再说。
想了解项目诞生的完整故事？👉 作者故事 & 碎碎念
有任何建议、交流、合作，欢迎加微信，或扫码加入用户交流群：
 加作者微信 |
 扫码进群（二维码定期更新） |
微信群二维码有效期约 7 天，过期请加作者微信拉入群。
如果这个项目对你有帮助，请点一下 ⭐ Star，这是对作者最大的鼓励！