# localminidrama **Repository Path**: elfbobo_admin_admin/localminidrama ## Basic Information - **Project Name**: localminidrama - **Description**: 🎬 开源本地 AI 短剧 & 漫剧生成工具 —— 从故事到成片一站式完成，数据不出本机，短剧工作流管理平台，高灵活度，AI真人剧，AI漫剧本地搞定。 Open-source local AI short drama maker: story → storyboard → video, fully offline, your data stays yours. - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 16 - **Created**: 2026-03-19 - **Last Updated**: 2026-04-16 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README
# 🎬 本地短剧助手 **本地 AI 短剧 & 漫剧生成工具 —— 下载即用，完全开源，数据不出本机** *LocalMiniDrama · AI-powered short drama creator* [![version](https://img.shields.io/badge/version-1.2.6-blue?style=flat-square)](../../releases) [![license](https://img.shields.io/badge/license-MIT-green?style=flat-square)](LICENSE) [![platform](https://img.shields.io/badge/platform-Windows-lightgrey?style=flat-square)](#) [![stack](https://img.shields.io/badge/Vue3%20%2B%20Node.js%20%2B%20Electron-informational?style=flat-square)](#) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen?style=flat-square)](../../pulls) **[English](docs/en.md) | 简体中文 | [作者故事](docs/story.md)** [![GitHub](https://img.shields.io/badge/GitHub-xuanyustudio%2FLocalMiniDrama-181717?logo=github&style=flat-square)](https://github.com/xuanyustudio/LocalMiniDrama) [![Gitee](https://img.shields.io/badge/Gitee-bi__shang__a%2Flocalminidrama-C71D23?logo=gitee&style=flat-square)](https://gitee.com/bi_shang_a/localminidrama)
--- 市面上 AI 短剧工具不少，但真正能**本地离线运行、开箱即用、素材不上云**的几乎没有。 本项目用纯 JavaScript 从零搭建，接入你自己的 AI API，打开即可生成完整 AI 短剧。 > ✅ 无订阅费 · ✅ 数据本地存储 · ✅ 支持多家 AI 服务商 · ✅ 完全开源可二次开发 --- ## 📸 界面预览
首页 · 项目列表
首页 · 项目卡片一览，亮色模式

剧集管理页
剧集管理 · 分集 + 资源库		 分镜编辑页
分镜制作 · 图片 + 视频一键生成
角色管理页
角色生成 · AI 自动提取并生成角色形象图		 专业分镜参数
分镜制作 · 专业视频参数（景别 / 运镜 / 灯光 / 景深）
本剧场景库
场景库 · 一键「加入本集」，复用已有场景素材
--- ## 🎬 AI 生成实拍效果 > 以下 3 段视频由**本软件自动工作流选择即梦 1.0**（字节旗下图生视频模型）生成，展示连续分镜下角色外貌一致性的保持效果。 > 三个分镜均来自同一剧集，主角形象、服装、整体风格全程稳定统一，充分验证本工具的分镜参考图传递机制。

分镜 1 · 角色出场，即梦 1.0 生成
分镜 2 · 连续镜头，角色服装保持一致
分镜 3 · 不同景别，人物外貌高度统一
> 💡 **即梦 1.0 仅为演示版本**，本工具同时支持火山引擎豆包 Seedance（含 **Seedance 2.0** 方舟多图参考）、通义万相、Vidu、可灵 Kling（含 Omni）等多家视频模型，更高版本模型效果更佳。 --- ## ✨ 核心功能 ### 🔄 完整创作流程 | 步骤 | 功能 | 说明 | |:----:|------|------| | 1 | **故事生成** | 输入梗概 + 风格，AI 自动生成多集剧本 | | 2 | **剧本编辑** | 分集管理，剧本文本可自由编辑 | | 3 | **角色生成** | AI 提取角色列表，逐个生成角色形象图 | | 4 | **场景生成** | 从剧本自动提取场景，生成场景背景图 | | 5 | **道具生成** | 从剧本提取/手动添加道具，生成道具图 | | 6 | **分镜生成** | 按集自动生成分镜脚本（含景别/运镜/台词） | | 7 | **图片/视频生成** | 逐镜生成静帧图与视频片段 | | 8 | **合成视频** | 所有分镜视频自动合成为完整剧集文件 | ### ⚡ 一键流水线 - **一键生成视频**：从角色图到最终合成视频，全程自动执行 - **补全并生成**：智能跳过已有内容，只补全缺失部分 - **失败自动重试**：每步最多重试 3 次，应对 429 限流等错误，不中断流程 - **实时进度展示**：执行过程中展示当前步骤与完整错误日志 ### 🗂 项目与资源管理 - **工程导出/导入**：完整打包工程为 ZIP（含图片、视频、文字、配置），换机或分享一包搞定 - **素材库**：全局角色/场景/道具库，跨项目复用；各项目资源严格隔离 - **画面比例**：新建项目时选定比例（16:9 / 9:16 / 1:1 等），后续生成全程适配 - **分集管理**：支持新增/删除分集，剧本预览 ### ✏️ 分镜精细编辑 - **经典分镜 / 全能模式**：分镜视图可一键切换。**经典模式**中间为分镜参考图；**全能模式**中间为**片段描述**（独立存库，与参考图并存），适合 **`volcengine_omni`（火山 Seedance 2.0 多图）** 或 **`kling_omni`（可灵 Omni）** 等全能生视频链路；经典字段保留，可随时切回 - **全能片段与 `@图片N`**：片段描述中可用 **`@图片1`、`@图片2`…** 对应参考图顺序（一般为场景 → 角色 → 物品 → 分镜主图）；支持「根据分镜生成提示词」自动生成含运镜、机位与 `@图片` 约束的文案；有内容时生视频**仅提交该段**，不拼接下方「视频提示词」 - **图片提示词**：查看并编辑每个分镜的图片生成提示词，修改后重新生成 - **视频提示词**：全文编辑 + 字段展开编辑（场景/时长/动作/氛围/运镜/景别），自动重新拼装 - **图片管理**：AI 生成、手动上传、拖拽上传，随时替换 ### 🤖 AI 配置 - 图片生成、视频生成、文本生成三类模型**独立配置** - 兼容 **阿里云 DashScope**、**火山引擎 Volcengine**、**本地部署模型** 及其他 OpenAI 兼容接口 - 可视化管理，保存即生效，支持**一键测试连接** - 内置「一键配置通义」「一键配置火山」快捷入口，含 API Key 申请引导 ### 🌓 界面体验 - 支持**亮色模式**（默认）与**暗色模式**切换，偏好持久保存 - 高级设置：支持**自定义 AI 提示词**（故事生成、分镜拆解、角色/场景/道具提取等 9 个），可随时一键恢复默认 - 三个主页面均可随时切换主题 --- ## 🚀 快速开始 ### 方式一：下载 exe（推荐普通用户） 前往 **[Releases](../../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 ```bash # 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 指南请见 → **[快速开始文档](docs/quickstart.md)** --- ## 🤖 AI 服务商支持 | 服务商 | 文本生成 | 图片生成 | 视频生成 | |--------|:--------:|:--------:|:--------:| | 阿里云 DashScope（通义） | ✅ | ✅ | ✅ | | 火山引擎 Volcengine（豆包） | ✅ | ✅ | ✅ | | 可灵 Kling AI | — | ✅ | ✅ | | Google Gemini（Imagen / Veo） | — | ✅ | ✅ | | Vidu 生数科技 | — | — | ✅ | | NanoBanana（含代理） | — | ✅ | — | | 本地部署（Ollama 等 OpenAI 兼容） | ✅ | — | — | | 其他 OpenAI 兼容接口 | ✅ | ✅ | — | 📖 各服务商 API Key 申请与配置详见 → **[AI 配置指南](docs/configuration.md)** --- ## 🏗 项目架构 ``` 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](docs/changelog.md)** **最新版 v1.2.6 亮点：** - 🆕 **Seedance 2.0 接入**：火山方舟多参考图视频链路；AI 配置视频中选接口规范 **`volcengine_omni`**，模型如 `doubao-seedance-2-0-260128` 等（以控制台为准）；后端对 Seedance **2.x** 时长 **4–15 秒**吸附、参考图 **`reference_image`** 组装 - 🆕 **分镜全能模式**：制作页分镜切换「全能模式」，中间编辑**片段描述**（`universal_segment_text`）；与可灵 **`kling_omni`** 或火山 **`volcengine_omni`** 配合，多素材参考图一键提交；**`@图片1`…** 编排与「根据分镜生成提示词」工作流 **v1.2.3 亮点：** - 🆕 **分镜解说旁白（narration）**：分镜生成可选「生成分镜时生成解说旁白」，AI 为每镜输出独立 `narration` 字段（与角色对白 `dialogue` 分离），便于后期 TTS 与成片旁轨 - 🆕 **导出解说 SRT**：按分镜顺序与单镜时长累计时间轴，一键导出字幕文件；支持「解说配音」走现有 TTS 接口 - 🔧 **首镜解说为空修复**：流式增量先入库的分镜在任务结束后会用**最终完整 JSON** 再 `UPDATE` 合并，避免第 1/2 镜解说因早写库而永久缺失 - 🔧 **解说模式提示词强化**：系统与用户提示中明确首镜开场解说、全镜非空等硬性要求，减少模型漏写 - 🎨 **解说相关 UI**：解说输入框与「导出解说 SRT」按钮在深浅色主题下对比度优化；导出按钮白字紫底易辨认 **v1.2.2 亮点：** - 🆕 **视频帧连贯性（连贯帧模式）**、**小说/长文导入**、**ffmpeg 自动解压** 等（详见 [CHANGELOG](CHANGELOG.md)） **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.js `http/https` 模块，支持重试与超时，解决 `fetch failed` 问题 **v1.1.14 亮点：** - 🆕 **官方仓库链接**：README 及后端文档新增 [GitHub](https://github.com/xuanyustudio/LocalMiniDrama) 与 [Gitee](https://gitee.com/bi_shang_a/localminidrama) 官方仓库徽章，方便提交 Issue 或 PR **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](https://github.com/toonflow)** | 开源 AI 漫画/短剧流程工具，流程设计对本项目有所启发 | | **[openoii / oiioii](https://github.com/oiioii)** | 开源，轻量化 AI 可视化创作，本项目在提示词设计上有所参考 | | **ChatFire** | AI 驱动剧情生成/对话体短剧，启发了本项目后端设计 | 本项目更聚焦于**本地离线、界面友好、方便二次开发**，欢迎 [Issue](../../issues) 推荐更多工具。 --- ## 🗺 后续计划 Roadmap 以下功能正在规划或开发中，欢迎参与讨论与贡献： | 计划 | 说明 | |------|------| | ✅ **即梦 2.0 / Seedance 2.0** | 已支持豆包 Seedream 4.5 图片；**v1.2.5** 起支持方舟 **Seedance 2.0** 视频多图参考 + 分镜**全能模式** | | ✅ **NanoBanana 图片模型接入** | 已支持，含官方 API 与代理模式（v1.1.8） | | 📎 **分镜参考图自由上传** | 分镜编辑支持自由上传任意图片作为参考图 | | 🎨 **参考图自由选择** | 生成分镜图时，可手动指定使用哪些角色/场景图片作为参考 | | 🔲 **宫格图生成视频** | 支持将多帧宫格合图作为输入生成视频片段（部分模型已支持） | > 有好想法或愿意认领某项开发？欢迎 [提 Issue](../../issues/new) 或直接提 PR！ --- ## 🤝 参与贡献 欢迎任何形式的贡献！ - 🐛 **报告 Bug** → [新建 Issue](../../issues/new) - 💡 **功能建议** → [新建 Issue](../../issues/new) - 🔧 **提交代码** → Fork → 修改 → Pull Request - ⭐ **给项目 Star** → 帮助更多人发现这个工具 --- ## 💬 联系 & 社区 一个游戏搬砖工，用自己熟悉的 JavaScript 做了这个开源项目，先做了再说。 想了解项目诞生的完整故事？👉 [作者故事 & 碎碎念](docs/story.md) 有任何建议、交流、合作，欢迎加微信，或扫码加入**用户交流群**：
作者微信
加作者微信 		微信交流群
扫码进群（二维码定期更新）
> 微信群二维码有效期约 7 天，过期请加作者微信拉入群。 --- ## 📄 License [MIT](LICENSE) ---
**如果这个项目对你有帮助，请点一下 ⭐ Star，这是对作者最大的鼓励！**