LocalMiniDrama源码开发快速开始：Node.js+Vue3双端启动，run_dev一键运行完整教程

LocalMiniDrama源码开发快速开始Node.jsVue3双端启动run_dev一键运行完整教程【免费下载链接】LocalMiniDrama seedance2接入 开源本地 AI 短剧 漫剧生成工具 —— 从故事到成片一站式完成数据不出本机短剧工作流管理平台高灵活度AI真人剧AI漫剧本地搞定。 Open-source local AI short drama maker: story → storyboard → video, fully offline, your data stays yours. 纳米流水线项目地址: https://gitcode.com/gh_mirrors/lo/LocalMiniDramaLocalMiniDrama本地短剧助手是一款开源的本地 AI 短剧 漫剧生成工具数据不出本机从故事到成片一站式完成。本文是面向开发者的源码开发快速开始指南带你用 Node.js Vue3 双端架构完成 LocalMiniDrama 的完整启动并用 run_dev 脚本一键运行前后端。一、环境准备只需 Node.js 18 以上LocalMiniDrama 采用纯 JavaScript 技术栈开发环境要求非常轻量依赖版本要求说明Node.js≥ 18后端基于 Express前端基于 Vitenpm随 Node.js 附带用于安装依赖Git任意版本用于拉取源码# 检查 Node.js 版本 node -v 版本低于 18 时后端依赖better-sqlite3等模块可能报错请先升级 Node.js。二、获取源码三步克隆并认识目录结构克隆仓库后你会看到清晰的双端目录结构git clone https://gitcode.com/gh_mirrors/lo/LocalMiniDrama cd LocalMiniDrama项目架构一览详见 README.mdLocalMiniDrama/ ├── backend-node/ # Node.js 后端Express SQLite ├── frontweb/ # Vue 3 前端Vite Element Plus vue-flow ├── desktop/ # Electron 桌面打包 ├── docs/ # 开发文档与指南 ├── run_dev.bat # Windows 一键启动脚本 └── run_dev.ps1 # PowerShell 一键启动脚本启动成功后的 LocalMiniDrama 首页项目卡片一览三、启动后端5679 端口的 AI 短剧引擎后端代码位于 backend-node/核心配置见 backend-node/package.json。依次执行以下命令cd backend-node npm install # 首次运行初始化 SQLite 数据库 npm run migrate # 启动服务生产模式 npm start # 或开发模式--watch 热重载改代码自动重启 npm run dev启动成功后终端会输出类似Server starting (port 5679) API: http://localhost:5679/api/v1 Health: http://localhost:5679/health几个关键点端口后端默认监听5679可在 backend-node/configs/config.yaml 的server.port修改数据库migrate命令会按顺序执行 backend-node/migrations/ 下的全部 SQL 迁移脚本如 01_init.sql数据库文件位于backend-node/data/drama_generator.dbAI 密钥无需手写 YAML启动后在软件界面「AI 配置」页面填入即可四、启动前端Vue3 Vite 热更新开发新开一个终端窗口前端代码位于 frontweb/cd frontweb npm install npm run devVite 开发服务器默认跑在3013 端口并自动把/api请求代理到后端 5679代理规则定义在 frontweb/vite.config.jsserver: { port: 3013, proxy: { /api: { target: http://127.0.0.1:5679 }, /static: { target: http://127.0.0.1:5679 } } }浏览器打开http://localhost:3013即可看到 LocalMiniDrama 的完整界面——Vue 3 前端无需配置任何接口地址代理会自动完成「前端 3013 → 后端 5679」的转发。LocalMiniDrama 画布模式分镜流水线可视化编排五、run_dev 一键运行双端同时启动不想手动开两个终端项目根目录提供了一键启动脚本Windows双击 run_dev.batPowerShell运行 run_dev.ps1以run_dev.bat为例它的逻辑很简单完整内容仅 20 余行检查 5679 端口是否被旧进程占用占用则自动清理在独立窗口启动后端cd backend-node npm run dev在独立窗口启动前端cd frontweb npm run dev自动打开浏览器访问界面开发环境运行后的分镜制作页图片 视频一键生成六、启动遇到问题3 个高频排错方案现象原因解决方案后端报Cannot find module better-sqlite3依赖未装全进入backend-node重新执行npm install并确认 Node.js ≥ 18前端报Failed to fetch或 404后端未启动确认后端终端输出Server started on port 5679检查 frontweb/vite.config.js 的 proxy target端口 5679 被占用旧进程未退出直接双击run_dev.bat脚本会自动 kill 旧进程更多细节可参考官方 docs/quickstart.md 的 FAQ 章节与 docs/configuration.md 的 AI 配置指南。七、启动成功后你的 AI 短剧工作流打开http://localhost:3013在「AI 配置」页填入 API Key支持通义、火山 Seedance 2.0、可灵、Gemini 等多家服务商即可体验完整流水线故事生成 → 角色/场景/道具 → 分镜 → 图片视频生成 → 成片合成专业分镜参数景别 / 运镜 / 灯光 / 景深写在最后至此LocalMiniDrama 的源码开发环境已全部就绪后端 Node.js 服务5679 前端 Vue33013 run_dev 一键启动。日常开发只需记住一句话——# 改完代码不用重启npm run dev 热重载端口冲突就 run_dev生成的图片与视频默认保存在backend-node/data/storage/下升级前建议备份data/目录。祝你创作愉快【免费下载链接】LocalMiniDrama seedance2接入 开源本地 AI 短剧 漫剧生成工具 —— 从故事到成片一站式完成数据不出本机短剧工作流管理平台高灵活度AI真人剧AI漫剧本地搞定。 Open-source local AI short drama maker: story → storyboard → video, fully offline, your data stays yours. 纳米流水线项目地址: https://gitcode.com/gh_mirrors/lo/LocalMiniDrama创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考