# LocalMiniDrama **Repository Path**: wangjiucheng/LocalMiniDrama ## Basic Information - **Project Name**: LocalMiniDrama - **Description**: No description available - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-05-05 - **Last Updated**: 2026-05-05 ## 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,这是对作者最大的鼓励!**