xuanyustudio / LocalMiniDrama

# 🎬 本地短剧助手
**本地 AI 短剧 & 漫剧生成工具 —— 下载即用，完全开源，数据不出本机**
*LocalMiniDrama · AI-powered short drama creator*
**English · 简体中文 · 作者故事**
**⬇️ 下载 Release** · **🚀 快速开始** · **📖 配置 AI** · **🗺 画布文档**
---
 🔒 本地优先 SQLite + 本地文件，素材不上云 
 🎬 全流程 剧本 → 角色/场景 → 分镜 → 视频合成 
 🤖 多模型 通义 / 火山 / 可灵 / Gemini 等 
 🗺 双视图 列表精细编辑 + 画布批量编排 
市面上 AI 短剧工具不少，但真正能**本地离线运行、开箱即用、素材不上云**的几乎没有。 
本项目用纯 JavaScript 从零搭建，接入你自己的 AI API，打开即可生成完整 AI 短剧。
> ✅ 无订阅费 · ✅ 数据本地存储 · ✅ 支持多家 AI 服务商 · ✅ 完全开源可二次开发
---
## 📌 最新动态（v1.2.9）
- 🆕 **剧内助手**：剧集页、制作页、画布页可对话操作当前短剧（剧本、角色、场景、分镜、出图）；删除需确认
- 🔧 **文本模型**：配置里存了多个模型时，助手使用默认的那一个，不再把整段名单当作模型名
- 🔧 **桌面运行时**：Electron 升到 44，以便在安装包内运行助手
完整记录 → **CHANGELOG.md**
---
## 目录
- 界面预览
- 核心功能
- 快速开始
- AI 服务商
- 项目架构
- 后续计划
- 参与贡献
- 联系社区
---
## 📸 界面预览
 首页 · 项目卡片一览，亮色模式 
 🆕 画布模式 · 分镜流水线可视化 · 节点内编辑/生成 · 工作流整组重跑 
 剧集管理 · 分集 + 资源库 
 分镜制作 · 图片 + 视频一键生成 
 角色生成 · AI 自动提取并生成角色形象图 
 分镜制作 · 专业视频参数（景别 / 运镜 / 灯光 / 景深） 
 场景库 · 一键「加入本集」，复用已有场景素材 
---
## 🎬 AI 生成实拍效果
> 以下 3 段视频由**本软件自动工作流选择即梦 1.0**生成，展示连续分镜下角色外貌一致性。
 分镜 1 · 即梦 1.0 
 分镜 2 · 服装一致 
 分镜 3 · 人物统一 
> 💡 同时支持火山 **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
 [code] 
浏览器打开 `http://localhost:3013`，或双击根目录 **`run_dev.bat`** 一键启动。
📖 详细开发/打包/Docker 指南 · AI 配置指南
---
## 🤖 AI 服务商支持
| 服务商 | 文本 | 图片 | 视频 |
|--------|:----:|:----:|:----:|
| 阿里云 DashScope（通义） | ✅ | ✅ | ✅ |
| 火山引擎 Volcengine（豆包 / Seedance 2.0） | ✅ | ✅ | ✅ |
| 可灵 Kling AI（含 Omni） | — | ✅ | ✅ |
| Agnes AI | ✅ | ✅ | ✅ |
| Google Gemini（Imagen / Veo） | — | ✅ | ✅ |
| Vidu 生数科技 | — | — | ✅ |
| NanoBanana（含代理） | — | ✅ | — |
| 本地 Ollama 等 OpenAI 兼容 | ✅ | — | — |
| 其他 OpenAI 兼容接口 | ✅ | ✅ | — |
---
## 🏗 项目架构
 [code]