ARTICLE · 1009906
本地 AI 短剧 & 漫剧生成工具LocalMiniDrama --下载即用,完全开源,数据不出本机
在本地无GPU的电脑上生成有情节、口型同步的短剧,目前是有完整开源方案可以实现的。关键在于选择合适的轻量化模型,并利用好CPU优化版本。
🎬 一站式短剧生成平台
对于希望快速上手的用户,以下开源平台可以直接使用,它们整合了从剧本到成片的完整工作流:
LocalMiniDrama:一个纯JavaScript项目,下载即用,数据完全保存在本地。它支持接入多家AI服务商(包括Agnes AI),能够一站式完成剧本、角色、分镜到视频合成的全部工作。
LocalMiniDrama尝试
一、直接下载 exe(推荐普通用户)
适合只想用软件、不写代码的人。
1. 下载
前往 GitHub Releases:
text
https://github.com/xuanyustudio/LocalMiniDrama/releases下载最新版本,通常有两个包:
| 文件 | 说明 |
|---|---|
本地短剧助手 x.x.x.exe | 标准版,含示例项目 |
本地短剧助手-Lite-x.x.x.exe | Lite 版,体积更小 |
2. 安装 / 运行
安装包:双击安装,可选安装目录。
便携版:双击直接运行,无需安装。
3. 首次启动数据目录
标准 exe:
%APPDATA%\LocalMiniDrama\backend\桌面版 userData:
%APPDATA%\localminidrama-desktop\
里面会自动生成:
text
backend/├── configs/config.yaml # 配置文件├── data/ # SQLite 数据库与图片/视频└── logs/ # 日志4. 配置 AI
启动后点击右上角 「AI 配置」:
可手动添加配置,也可点 「一键配置通义」/「一键配置火山」/「一键配置 Agnes」。
每条配置都要填入你自己的 API Key。
填完点 「测试」,成功后再保存。
5. 开始使用
回到首页:
点 「+ 新建短剧项目」 开始创作;
或点示例项目 「衣服设计天才302」 体验流程。
二、源码开发环境安装(开发者)
适合需要改代码、调试、二次开发的人。
1. 环境要求
| 依赖 | 版本 |
|---|---|
| Node.js | >= 18 |
| npm | 随 Node 安装 |
| Git | 任意版本 |
| Python 3 + VS C++ Build Tools | 仅 Electron / better-sqlite3 编译需要 |
2. 克隆项目
bash
git clone https://github.com/xuanyustudio/LocalMiniDrama.git
cd LocalMiniDrama
3. 启动后端
bash
cd backend-node
npm install# 如果 config.example.yaml 不存在,直接用已有 config.yaml
# 编辑 configs/config.yaml,填写必要配置npm run migrate # 首次运行,初始化数据库
npm start # 默认端口 5679
启动成功会看到:
text
Server starting {"port":5679,"host":"0.0.0.0"}Frontend: http://localhost:5679API: http://localhost:5679/api/v1Health: http://localhost:5679/health4. 启动前端
方式 A:生产构建,由后端托管
bash
cd frontweb
npm install
npm run build
构建后生成 frontweb/dist,后端启动时会自动托管,直接访问:
text
http://localhost:5679方式 B:开发模式,热更新
bash
cd frontweb
npm install
npm run dev
访问:
text
http://localhost:3013Vite 会代理 /api 和 /static 到后端 5679。
5. 数据库与存储
SQLite 数据库:
backend-node/data/drama_generator.db图片/视频存储:
backend-node/data/storage/迁移:
npm run migrate,启动时也会自动ensureColumns()补列。
6. ffmpeg 配置(视频合成 / 尾帧衔接需要)
优先级:
backend-node/tools/ffmpeg/ffmpeg.exe和ffprobe.exe环境变量
FFMPEG_PATH系统 PATH
打包后会自动解压到:
text
%APPDATA%\localminidrama-desktop\backend\tools\ffmpeg\7. Electron 桌面端开发
bash
cd desktop
npm install
npm start
开发模式会复制
backend-node到desktop/backend-app。需要 Python 3 和 VS C++ Build Tools 编译
better-sqlite3。
8. 打包 Windows exe
bash
cd desktopnpm run dist # 标准打包
npm run dist:cn # 国内镜像加速
产物在 desktop/release/。
三、AI 配置关键点
无论 exe 还是源码,生成功能都必须配置 AI:
| 类型 | 用途 |
|---|---|
| 文本 | 生成剧本、分镜、提取角色/场景/道具 |
| 图片 / 分镜图 | 角色图、场景图、分镜图 |
| 视频 | 分镜视频片段 |
| TTS | 对白配音 |
注意:
每条配置都要填 API Key。
模型名必须与平台实际提供的名称一致,否则会报
503 No available channel。接口规范要匹配:火山用
volcengine,通义用dashscope,Gemini 用gemini,OpenAI 兼容用openai。多图参考模型有上限,例如 Agnes 视频最多 2 张参考图,超了会报
400 image alias supports at most 2 items。部分平台参数会变,例如 Agnes 禁用
width/height,应改用aspect_ratio。
四、常见问题速查
| 现象 | 原因 | 处理 |
|---|---|---|
| 访问 5679 空白 | 未构建前端 | cd frontweb && npm run build |
| 页面能开但按钮报错 | 缺列/缺表 | npm run migrate,或手动 ALTER TABLE 补列 |
Cannot find module 'better-sqlite3' | 原生模块未编译 | 重新 npm install,装 Python3 + VS C++ Build Tools |
| 端口被占用 | 5679 被占 | 关闭占用进程,或改 config.yaml 的 server.port |
| AI 测试失败 | Key/模型/Base URL 不匹配 | 对照平台文档逐项检查 |
| 视频合成失败 | 缺 ffmpeg | 放置 ffmpeg.exe/ffprobe.exe 到 backend-node/tools/ffmpeg/ |
五、最短路径总结
普通用户:
下载 Release exe → 2. 双击运行 → 3. 打开「AI 配置」填 Key → 4. 新建项目开始生成。
开发者:
装 Node.js 18+ → git clone→ cd backend-node && npm install && npm run migrate && npm start → cd frontweb && npm install && npm run build
→ 访问 http://localhost:5679 → AI 配置填 Key → 开始创作。
如果需要打包成 exe,再进 desktop 执行 npm install && npm run dist。
六 以下是创作界面
访问 http://localhost:5679页面

AI 配置填 Key

开始创作(已有一个实例)













fork版本地址
https://github.com/austinnie/LocalMiniDrama.git
当然还有教怎么使用的指导视频,找到 LocalMiniDrama,打开index.html
file:///E:/SD_OpenVINO/ai-drama-stack/LocalMiniDrama/index.html