🎬 本地短剧助手
本地 AI 短剧 & 漫剧生成工具 —— 下载即用，完全开源，数据不出本机
LocalMiniDrama · AI-powered short drama creator
⬇️ 下载 Release · 🚀 快速开始 · 📖 配置 AI · 🗺 画布文档
市面上 AI 短剧工具不少，但真正能本地离线运行、开箱即用、素材不上云的几乎没有。
本项目用纯 JavaScript 从零搭建，接入你自己的 AI API，打开即可生成完整 AI 短剧。
✅ 无订阅费 · ✅ 数据本地存储 · ✅ 支持多家 AI 服务商 · ✅ 完全开源可二次开发
📌 最新动态（v1.2.8）
- 🆕 Agnes AI 接入：文本 / 图片 / 视频一键配置，一个 Key 覆盖全流程
- 🆕 画布模式增强：剧本节点、右键菜单、浮动工具栏、画布内新建/删除/整集生成
- 🆕 ModelArk 私有资产库：SD2 角色认证对接火山方舟资产组，AK/SK 与 Bearer 双鉴权
- 🔧 图床可配置：
upload_url/ 超时（默认 180s）/ 重试次数写入config.yaml；缓存 URL 失效自动重传 - 🔧 提示词优化 · 分镜图片数量上限修复
完整记录 → CHANGELOG.md
目录
📸 界面预览
🎬 AI 生成实拍效果
以下 3 段视频由本软件自动工作流选择即梦 1.0生成，展示连续分镜下角色外貌一致性。
💡 同时支持火山 Seedance 2.0、通义万相、Vidu、可灵 Kling（含 Omni）等，模型越新效果通常越好。
✨ 核心功能
| 步骤 | 功能 | 说明 |
|---|---|---|
| 1 | 故事生成 | 输入梗概 + 风格，AI 自动生成多集剧本 |
| 2 | 剧本编辑 | 分集管理，剧本文本可自由编辑 |
| 3 | 角色生成 | AI 提取角色列表，逐个生成角色形象图 |
| 4 | 场景生成 | 从剧本自动提取场景，生成场景背景图 |
| 5 | 道具生成 | 从剧本提取/手动添加道具，生成道具图 |
| 6 | 分镜生成 | 按集自动生成分镜脚本（含景别/运镜/台词） |
| 7 | 图片/视频生成 | 逐镜生成静帧图与视频片段 |
| 8 | 合成视频 | 所有分镜视频自动合成为完整剧集文件 |
- 一键生成 / 补全并生成：从角色到合成视频全自动；智能跳过已有内容
- 失败自动重试：每步最多 3 次，应对限流；实时进度与错误日志
- 工程 ZIP 导出/导入 · 全局素材库 · 16:9 / 9:16 / 1:1 画幅
- 经典 / 全能分镜 ·
@图片N多图参考 · 尾帧衔接 · 导出分镜表 HTML - 图片/视频提示词全文编辑 · 手动上传/拖拽替换参考图
🗺 画布工作流（LibTV 式）
制作页 / 剧集详情 → 画布模式（/film/:id/canvas），与列表模式同源数据：
| 能力 | 说明 |
|---|---|
| 竖排流水线 | 每镜一行：经典「文本→首帧/尾帧→视频」；全能「全能分镜词→视频」 |
| 剧本节点 | 画布起点直接编辑剧本、AI 生成故事、提取角色/场景/道具 |
| 节点操作面板 | 单击节点下方编辑/生成，无需频繁切列表 |
| 右键 / 工具栏 | 新建分镜、集、角色、场景、道具；框选创建工作流 |
| 工作流组 | 框选分镜 → 创建工作流 → 整组重跑（生图/视频/配音可勾选） |
| 布局持久化 | 拖动保存坐标；曲线连线；左键框选、中键/右键平移 |
🤖 AI 配置 · 🌓 亮/暗主题 · 自定义提示词
三类模型独立配置（图/视频/文本）；一键配置通义/火山；9 类提示词可自定义覆盖。
🚀 快速开始
方式一：下载 exe（推荐）
前往 Releases 下载页：
| 版本 | 说明 | 适合 |
|---|---|---|
本地短剧助手 x.x.x.exe |
标准版，含示例项目 | 新手入门 |
本地短剧助手-Lite-x.x.x.exe |
Lite 版，体积更小 | 熟悉流程后 |
双击运行 → 「AI 配置」填入 API Key → 开始创作。
首次运行配置：
%APPDATA%\LocalMiniDrama\backend\configs\config.yaml
方式二：源码开发
Node.js ≥ 18
git clone https://github.com/xuanyustudio/LocalMiniDrama.git
cd LocalMiniDrama
# 后端（端口 5679）
cd backend-node && npm install
cp configs/config.example.yaml configs/config.yaml # 填入 API Key
npm run migrate && npm start
# 前端（端口 3013，新终端）
cd frontweb && npm install && npm run dev
浏览器打开 http://localhost:3013，或双击根目录 run_dev.bat 一键启动。
🤖 AI 服务商支持
| 服务商 | 文本 | 图片 | 视频 |
|---|---|---|---|
| 阿里云 DashScope（通义） | ✅ | ✅ | ✅ |
| 火山引擎 Volcengine（豆包 / Seedance 2.0） | ✅ | ✅ | ✅ |
| 可灵 Kling AI（含 Omni） | — | ✅ | ✅ |
| Agnes AI | ✅ | ✅ | ✅ |
| Google Gemini（Imagen / Veo） | — | ✅ | ✅ |
| Vidu 生数科技 | — | — | ✅ |
| NanoBanana（含代理） | — | ✅ | — |
| 本地 Ollama 等 OpenAI 兼容 | ✅ | — | — |
| 其他 OpenAI 兼容接口 | ✅ | ✅ | — |
🏗 项目架构
LocalMiniDrama/
├── backend-node/ # Express + SQLite，生成/合成/导入导出
├── frontweb/ # Vue 3 + Element Plus + @vue-flow/core
│ └── views/ # FilmList · DramaDetail · FilmCreate · DramaCanvas
├── desktop/ # Electron 打包 exe
└── docs/ # 文档与计划
| 层 | 技术 |
|---|---|
| 前端 | Vue 3 · Vite · Element Plus · Pinia · @vue-flow/core |
| 后端 | Node.js · Express · SQLite (better-sqlite3) |
| 桌面 | Electron 28 · electron-builder |
🗺 后续计划 Roadmap
| 状态 | 计划 | 说明 |
|---|---|---|
| ✅ | Seedance 2.0 + 全能模式 | 多图 @图片N · universal_segment_text |
| ✅ | 画布工作流 | 列表/画布双视图 · 整组重跑 · 节点面板 |
| 📋 | 场景图 → 全景图 | 由场景参考图 AI 扩展超宽/360° 全景，供大景别运镜与场景库 |
| 📋 | 分镜参考图自由上传 | 任意图片作为分镜参考 |
| 📋 | 参考图自由选择 | 生图时手动指定角色/场景参考 |
| 📋 | 宫格图生成视频 | 多帧合图作为视频输入（部分模型已支持） |
认领功能或提建议 → New Issue
- v1.2.3 分镜解说旁白 · 导出解说 SRT
- v1.2.2 连贯帧模式 · 小说/长文导入 · ffmpeg 自动解压
- v1.2.1 可灵 Kling · 视频历史版本 · 场景/道具「加入本集」
- v1.1.x 多集剧本 · AI 并发 · 四宫格 · 批量生图/视频 …
详见 CHANGELOG.md
🎯 适合谁
| 用户 | 场景 |
|---|---|
| 📹 内容创作者 | 批量生产 AI 短剧 / 漫剧 |
| 🔒 隐私敏感 | 素材与剧本完全留在本机 |
| 🛠 开发者 | 二次开发、接入新 AI 服务商 |
| 🌱 入门探索 | 低成本体验 AI 视频全流程 |
🤝 参与贡献
GitHub 仓库建议 Topics（在仓库 Settings → Topics 添加，便于搜索）：
ai-video short-drama storyboard vue3 electron local-first seedance comic-drama
项目完全开源、无订阅。若对你有帮助，欢迎随缘打赏（自愿，不影响 Issue/PR 处理）：
💬 联系 & 社区
作者故事 & 碎碎念 · 微信交流 / 用户群（二维码见仓库 项目截图/ 目录）
群二维码约 7 天有效，过期请加作者微信拉群。
📄 License
如果这个项目对你有帮助，请点 ⭐ Star —— 这是对作者最大的鼓励！