夜雨聆风学习资料网

ARTICLE · 1009906

本地 AI 短剧 & 漫剧生成工具LocalMiniDrama --下载即用,完全开源,数据不出本机

本地 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.exeLite 版,体积更小

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:5679
API:       http://localhost:5679/api/v1
Health:    http://localhost:5679/health

4. 启动前端

方式 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:3013

Vite 会代理 /api 和 /static 到后端 5679

5. 数据库与存储

  • SQLite 数据库:backend-node/data/drama_generator.db

  • 图片/视频存储:backend-node/data/storage/

  • 迁移:npm run migrate,启动时也会自动 ensureColumns() 补列。

6. ffmpeg 配置(视频合成 / 尾帧衔接需要)

优先级:

  1. backend-node/tools/ffmpeg/ffmpeg.exe 和 ffprobe.exe

  2. 环境变量 FFMPEG_PATH

  3. 系统 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/

五、最短路径总结

普通用户:

  1. 下载 Release exe → 2. 双击运行 → 3. 打开「AI 配置」填 Key → 4. 新建项目开始生成。

开发者:

  1. 装 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

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

刚才都是网页,还是cmd的输出
把分镜视频合成最终视频
视频效果:
关注
重播 分享

fork版本地址

https://github.com/austinnie/LocalMiniDrama.git

这个是实例,自己从剧本开始创作,这个过程还没跑,需要继续摸索

当然还有教怎么使用的指导视频,找到 LocalMiniDrama,打开index.html

file:///E:/SD_OpenVINO/ai-drama-stack/LocalMiniDrama/index.html

相关学习资料

返回首页浏览学习资料