329 lines
12 KiB
Markdown
329 lines
12 KiB
Markdown
<div align="center">
|
||
|
||
# 🎬 本地短剧助手
|
||
|
||
**本地 AI 短剧 & 漫剧生成工具 —— 下载即用，完全开源，数据不出本机**
|
||
|
||
*LocalMiniDrama · AI-powered short drama creator*
|
||
|
||
[](https://github.com/xuanyustudio/LocalMiniDrama/releases)
|
||
[](LICENSE)
|
||
[](#-快速开始)
|
||
[](#-项目架构)
|
||
[](https://github.com/xuanyustudio/LocalMiniDrama/pulls)
|
||
|
||
**[English](docs/en.md) · 简体中文 · [作者故事](docs/story.md)**
|
||
|
||
[](https://github.com/xuanyustudio/LocalMiniDrama)
|
||
[](https://gitee.com/bi_shang_a/localminidrama)
|
||
|
||
[**⬇️ 下载 Release**](https://github.com/xuanyustudio/LocalMiniDrama/releases) · [**🚀 快速开始**](#-快速开始) · [**📖 配置 AI**](docs/configuration.md) · [**🗺 画布文档**](docs/plans/2026-06-15-drama-canvas-workflow-plan.md)
|
||
|
||
</div>
|
||
|
||
---
|
||
|
||
<table>
|
||
<tr>
|
||
<td width="25%" align="center"><b>🔒 本地优先</b><br/>SQLite + 本地文件，素材不上云</td>
|
||
<td width="25%" align="center"><b>🎬 全流程</b><br/>剧本 → 角色/场景 → 分镜 → 视频合成</td>
|
||
<td width="25%" align="center"><b>🤖 多模型</b><br/>通义 / 火山 / 可灵 / Gemini 等</td>
|
||
<td width="25%" align="center"><b>🗺 双视图</b><br/>列表精细编辑 + 画布批量编排</td>
|
||
</tr>
|
||
</table>
|
||
|
||
市面上 AI 短剧工具不少，但真正能**本地离线运行、开箱即用、素材不上云**的几乎没有。
|
||
本项目用纯 JavaScript 从零搭建，接入你自己的 AI API，打开即可生成完整 AI 短剧。
|
||
|
||
> ✅ 无订阅费 · ✅ 数据本地存储 · ✅ 支持多家 AI 服务商 · ✅ 完全开源可二次开发
|
||
|
||
---
|
||
|
||
## 📌 最新动态（v1.2.7）
|
||
|
||
- 🆕 **画布工作流**：无限画布总览分镜流水线，节点内编辑/生成，工作流整组重跑 → [文档](docs/plans/2026-06-15-drama-canvas-workflow-plan.md)
|
||
- 🆕 **Seedance 2.0 全能模式**：`@图片N` 多图参考 + `universal_segment_text` 片段描述
|
||
- 🆕 **尾帧衔接** · **导出分镜表** · **统一任务进度**（刷新可恢复）
|
||
|
||
完整记录 → **[CHANGELOG.md](CHANGELOG.md)**
|
||
|
||
---
|
||
|
||
## 目录
|
||
|
||
- [界面预览](#-界面预览)
|
||
- [核心功能](#-核心功能)
|
||
- [快速开始](#-快速开始)
|
||
- [AI 服务商](#-ai-服务商支持)
|
||
- [项目架构](#-项目架构)
|
||
- [后续计划](#-后续计划-roadmap)
|
||
- [参与贡献](#-参与贡献)
|
||
- [联系社区](#-联系--社区)
|
||
|
||
---
|
||
|
||
## 📸 界面预览
|
||
|
||
<div align="center">
|
||
<img src="项目截图/首页截图.png" alt="首页 · 项目列表" width="960"/><br/>
|
||
<sub>首页 · 项目卡片一览，亮色模式</sub>
|
||
</div>
|
||
|
||
<br/>
|
||
|
||
<div align="center">
|
||
<img src="项目截图/画布模式.png" alt="画布工作流 · 分镜流水线" width="960"/><br/>
|
||
<sub>🆕 画布模式 · 分镜流水线可视化 · 节点内编辑/生成 · 工作流整组重跑</sub>
|
||
</div>
|
||
|
||
<br/>
|
||
|
||
<table>
|
||
<tr>
|
||
<td align="center"><img src="项目截图/武侠.png" alt="剧集管理页" width="480"/><br/><sub>剧集管理 · 分集 + 资源库</sub></td>
|
||
<td align="center"><img src="项目截图/武侠分镜.png" alt="分镜编辑页" width="480"/><br/><sub>分镜制作 · 图片 + 视频一键生成</sub></td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center"><img src="项目截图/新版本4宫格分镜.png" alt="角色管理页" width="480"/><br/><sub>角色生成 · AI 自动提取并生成角色形象图</sub></td>
|
||
<td align="center"><img src="项目截图/专业分镜.png" alt="专业分镜参数" width="480"/><br/><sub>分镜制作 · 专业视频参数（景别 / 运镜 / 灯光 / 景深）</sub></td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center" colspan="2"><img src="项目截图/本剧场景库.png" alt="本剧场景库" width="720"/><br/><sub>场景库 · 一键「加入本集」，复用已有场景素材</sub></td>
|
||
</tr>
|
||
</table>
|
||
|
||
---
|
||
|
||
## 🎬 AI 生成实拍效果
|
||
|
||
> 以下 3 段视频由**本软件自动工作流选择即梦 1.0**生成，展示连续分镜下角色外貌一致性。
|
||
|
||
<table>
|
||
<tr>
|
||
<td align="center">
|
||
<video src="项目截图/1.mp4" controls width="300"></video><br/>
|
||
<sub>分镜 1 · 即梦 1.0</sub>
|
||
</td>
|
||
<td align="center">
|
||
<video src="项目截图/2.mp4" controls width="300"></video><br/>
|
||
<sub>分镜 2 · 服装一致</sub>
|
||
</td>
|
||
<td align="center">
|
||
<video src="项目截图/3.mp4" controls width="300"></video><br/>
|
||
<sub>分镜 3 · 人物统一</sub>
|
||
</td>
|
||
</tr>
|
||
</table>
|
||
|
||
> 💡 同时支持火山 **Seedance 2.0**、通义万相、Vidu、可灵 Kling（含 Omni）等，模型越新效果通常越好。
|
||
|
||
---
|
||
|
||
## ✨ 核心功能
|
||
|
||
<details open>
|
||
<summary><b>🔄 完整创作流程（点击展开/收起）</b></summary>
|
||
|
||
| 步骤 | 功能 | 说明 |
|
||
|:----:|------|------|
|
||
| 1 | **故事生成** | 输入梗概 + 风格，AI 自动生成多集剧本 |
|
||
| 2 | **剧本编辑** | 分集管理，剧本文本可自由编辑 |
|
||
| 3 | **角色生成** | AI 提取角色列表，逐个生成角色形象图 |
|
||
| 4 | **场景生成** | 从剧本自动提取场景，生成场景背景图 |
|
||
| 5 | **道具生成** | 从剧本提取/手动添加道具，生成道具图 |
|
||
| 6 | **分镜生成** | 按集自动生成分镜脚本（含景别/运镜/台词） |
|
||
| 7 | **图片/视频生成** | 逐镜生成静帧图与视频片段 |
|
||
| 8 | **合成视频** | 所有分镜视频自动合成为完整剧集文件 |
|
||
|
||
</details>
|
||
|
||
<details>
|
||
<summary><b>⚡ 一键流水线 · 项目管理 · 分镜编辑</b></summary>
|
||
|
||
- **一键生成 / 补全并生成**：从角色到合成视频全自动；智能跳过已有内容
|
||
- **失败自动重试**：每步最多 3 次，应对限流；实时进度与错误日志
|
||
- **工程 ZIP 导出/导入** · **全局素材库** · **16:9 / 9:16 / 1:1 画幅**
|
||
- **经典 / 全能分镜** · **`@图片N` 多图参考** · **尾帧衔接** · **导出分镜表 HTML**
|
||
- **图片/视频提示词**全文编辑 · 手动上传/拖拽替换参考图
|
||
|
||
</details>
|
||
|
||
### 🗺 画布工作流（LibTV 式）
|
||
|
||
制作页 / 剧集详情 → **画布模式**（`/film/:id/canvas`），与列表模式**同源数据**：
|
||
|
||
| 能力 | 说明 |
|
||
|------|------|
|
||
| 竖排流水线 | 每镜一行：经典「文本→首帧/尾帧→视频」；全能「全能分镜词→视频」 |
|
||
| 节点操作面板 | 单击节点下方编辑/生成，无需频繁切列表 |
|
||
| 工作流组 | 框选分镜 → 创建工作流 → **整组重跑**（生图/视频/配音可勾选） |
|
||
| 布局持久化 | 拖动保存坐标；曲线连线；左键框选、中键/右键平移 |
|
||
|
||
界面预览见 [上方截图](#-界面预览) · 📖 [画布工作流完整文档](docs/plans/2026-06-15-drama-canvas-workflow-plan.md)
|
||
|
||
### 🤖 AI 配置 · 🌓 亮/暗主题 · 自定义提示词
|
||
|
||
三类模型独立配置（图/视频/文本）；一键配置通义/火山；9 类提示词可自定义覆盖。
|
||
|
||
---
|
||
|
||
## 🚀 快速开始
|
||
|
||
### 方式一：下载 exe（推荐）
|
||
|
||
前往 **[Releases 下载页](https://github.com/xuanyustudio/LocalMiniDrama/releases)**：
|
||
|
||
| 版本 | 说明 | 适合 |
|
||
|------|------|------|
|
||
| `本地短剧助手 x.x.x.exe` | 标准版，**含示例项目** | 新手入门 |
|
||
| `本地短剧助手-Lite-x.x.x.exe` | Lite 版，体积更小 | 熟悉流程后 |
|
||
|
||
双击运行 → 「AI 配置」填入 API Key → 开始创作。
|
||
|
||
> 首次运行配置：`%APPDATA%\LocalMiniDrama\backend\configs\config.yaml`
|
||
|
||
### 方式二：源码开发
|
||
|
||
> Node.js ≥ 18
|
||
|
||
```bash
|
||
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`** 一键启动。
|
||
|
||
📖 [详细开发/打包/Docker 指南](docs/quickstart.md) · [AI 配置指南](docs/configuration.md)
|
||
|
||
---
|
||
|
||
## 🤖 AI 服务商支持
|
||
|
||
| 服务商 | 文本 | 图片 | 视频 |
|
||
|--------|:----:|:----:|:----:|
|
||
| 阿里云 DashScope（通义） | ✅ | ✅ | ✅ |
|
||
| 火山引擎 Volcengine（豆包 / Seedance 2.0） | ✅ | ✅ | ✅ |
|
||
| 可灵 Kling AI（含 Omni） | — | ✅ | ✅ |
|
||
| 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](https://github.com/xuanyustudio/LocalMiniDrama/issues/new)
|
||
|
||
<details>
|
||
<summary><b>📋 更多历史版本亮点（v1.2.3 及更早）</b></summary>
|
||
|
||
- **v1.2.3** 分镜解说旁白 · 导出解说 SRT
|
||
- **v1.2.2** 连贯帧模式 · 小说/长文导入 · ffmpeg 自动解压
|
||
- **v1.2.1** 可灵 Kling · 视频历史版本 · 场景/道具「加入本集」
|
||
- **v1.1.x** 多集剧本 · AI 并发 · 四宫格 · 批量生图/视频 …
|
||
|
||
详见 **[CHANGELOG.md](CHANGELOG.md)**
|
||
|
||
</details>
|
||
|
||
---
|
||
|
||
## 🎯 适合谁
|
||
|
||
| 用户 | 场景 |
|
||
|------|------|
|
||
| 📹 内容创作者 | 批量生产 AI 短剧 / 漫剧 |
|
||
| 🔒 隐私敏感 | 素材与剧本完全留在本机 |
|
||
| 🛠 开发者 | 二次开发、接入新 AI 服务商 |
|
||
| 🌱 入门探索 | 低成本体验 AI 视频全流程 |
|
||
|
||
---
|
||
|
||
## 🤝 参与贡献
|
||
|
||
- 🐛 [报告 Bug](https://github.com/xuanyustudio/LocalMiniDrama/issues/new)
|
||
- 💡 [功能建议](https://github.com/xuanyustudio/LocalMiniDrama/issues/new)
|
||
- 🔧 Fork → PR
|
||
- ⭐ **Star** 帮助更多人发现本项目
|
||
|
||
**GitHub 仓库建议 Topics**（在仓库 Settings → Topics 添加，便于搜索）：
|
||
`ai-video` `short-drama` `storyboard` `vue3` `electron` `local-first` `seedance` `comic-drama`
|
||
|
||
---
|
||
|
||
<details>
|
||
<summary><b>☕ 一杯咖啡的鼓励</b></summary>
|
||
|
||
项目完全开源、无订阅。若对你有帮助，欢迎随缘打赏（自愿，不影响 Issue/PR 处理）：
|
||
|
||
<table>
|
||
<tr>
|
||
<td align="center"><img src="项目截图/weixinpay.jpg" alt="微信赞赏码" width="200"/><br/><sub>微信支付</sub></td>
|
||
<td align="center"><img src="项目截图/ali.jpg" alt="支付宝收款码" width="200"/><br/><sub>支付宝</sub></td>
|
||
</tr>
|
||
</table>
|
||
|
||
</details>
|
||
|
||
---
|
||
|
||
## 💬 联系 & 社区
|
||
|
||
[作者故事 & 碎碎念](docs/story.md) · 微信交流 / 用户群（二维码见仓库 `项目截图/` 目录）
|
||
|
||
> 群二维码约 7 天有效，过期请加作者微信拉群。
|
||
|
||
---
|
||
|
||
## 📄 License
|
||
|
||
[MIT](LICENSE)
|
||
|
||
---
|
||
|
||
<div align="center">
|
||
|
||
**如果这个项目对你有帮助，请点 ⭐ Star —— 这是对作者最大的鼓励！**
|
||
|
||
[⬇️ 立即下载](https://github.com/xuanyustudio/LocalMiniDrama/releases) · [📖 快速开始文档](docs/quickstart.md) · [🗺 画布文档](docs/plans/2026-06-15-drama-canvas-workflow-plan.md)
|
||
|
||
</div>
|