LocalMiniDrama 桌面客户端

基于 Electron 的本地桌面应用，内嵌 backend-node 与 frontweb，打包为 Windows exe / macOS dmg 后可直接运行。当前版本：v1.2.7

主要功能（v1.2.7）

模块	功能
首页（项目列表）	创建/打开剧集项目；素材库（角色/场景/道具全局复用）；AI 配置；明暗主题切换
剧集管理页	管理剧集信息（标题/风格/比例）；分集列表（新增/删除/预览剧本）；本剧资源库（角色/场景/道具按剧过滤）；从素材库导入资源
制作页（分集）	剧本编辑、角色/场景/道具 AI 生成与图片管理；分镜脚本生成与逐镜编辑（图片提示词、视频提示词）
分镜全能模式	分镜可在经典与全能模式间切换；全能模式中间为片段描述（`@图片1`… 多图参考），配合 AI 配置中 `volcengine_omni`（Seedance 2.0）或 `kling_omni`（可灵 Omni）；生视频前校验模型匹配；支持「根据分镜生成提示词」
尾帧衔接 / 导出分镜表	尾帧衔接：提取本镜视频末帧设为下一镜首帧；导出分镜表：HTML 表格导出当前集全部镜头字段
生成任务进度	角色 / 场景 / 道具 / 分镜图 / 视频任务统一轮询与恢复（`generationTaskStore`）
分镜图生成	相机角度视角：仰视/俯视/侧面/背面角度自动影响背景透视；四宫格序列图：一键生成 2×2 四帧序列参考图，自动拆分面板，随时切换主分镜图
一键流水线	一键生成视频：全流程自动执行；补全并生成：仅生成缺失内容，自动跳过已有
图片/视频生成	支持 DashScope、Volcengine、Gemini 等多种 API；生成失败自动重试 3 次；错误信息持久显示
合成视频	将所有分镜视频合成为完整剧集
主题	支持暗色模式（默认）与浅色模式，偏好持久保存

开发运行

确保已构建前端（否则窗口内会显示「请先构建前端」提示）：
```
cd ../frontweb && npm install && npm run build
```
安装依赖并启动 Electron：
```
cd desktop
npm install
npm start
```

开发时后端工作目录为 backend-node/，配置与数据使用仓库内路径。

打包为 exe

在 desktop 目录下执行：

cd desktop
npm install
npm run dist

国内网络：若从 GitHub 下载 Electron 或 winCodeSign 超时，使用国内镜像：

npm run dist:cn

本目录下的 .npmrc 已配置 registry=https://registry.npmmirror.com，npm install 会使用国内源；dist:cn 脚本会将 Electron 与 electron-builder 的二进制下载也切换到 npmmirror 镜像。

产物在 desktop/release/ 下：

文件	说明
`LocalMiniDrama Setup x.x.x.exe`	NSIS 安装包（有安装引导，可选安装目录）
`LocalMiniDrama x.x.x.exe`	便携版（单文件，无需安装，双击即用）

首次运行时，会在用户数据目录（如 %APPDATA%/LocalMiniDrama）下生成 backend/，包含 configs/config.yaml（从 example 复制）和 data/（数据库与文件存储），按需修改配置即可。

脚本说明

脚本	说明
`npm start`	启动 Electron（开发模式）
`npm run build:front`	仅构建前端（frontweb）
`npm run copy-front`	将 frontweb/dist 复制到 desktop/frontweb-dist（打包前置步骤）
`npm run pack`	构建前端 + 复制 + 打出未压缩目录（便于检查打包内容）
`npm run dist`	构建前端 + 复制 + 打出 Windows 安装包与便携 exe
`npm run dist:cn`	同上，使用国内镜像（Electron、electron-builder 二进制）
`npm run prepare-backend`	将 backend-node 复制到 backend-app（打包前置步骤）
`bash dist-mac.sh`	macOS 一键打包（完整版 + 纯净版 DMG，含国内镜像加速）

打包后如何看日志 / 调试

1. 查看后端日志文件（推荐）

双击运行 exe 时，后端日志会自动写入：

%APPDATA%\LocalMiniDrama\backend\logs\app.log

用记事本或 VS Code 打开后，点击「AI 生成角色」等按钮，查看是否有对应请求行、报错信息，便于判断是请求未发出、AI 超时还是配置有误。

2. 从命令行运行（实时日志）

& "D:\path\to\release\LocalMiniDrama 1.2.7.exe"

日志会直接打印在终端，操作软件时可实时看到所有输出。

3. 打开前端开发者工具

$env:LOCALMINIDRAMA_DEVTOOLS=1
& "D:\path\to\release\LocalMiniDrama 1.2.7.exe"

在 Network 面板查看各 API 请求（如 POST /api/v1/generation/characters）是否正常发出和返回。

4. 确认配置与网络

配置文件位于：

%APPDATA%\LocalMiniDrama\backend\configs\config.yaml

AI 相关配置需在软件「AI 配置」弹窗中填写并保存（会写入上述 yaml 文件）；本机网络需能访问对应 API（如 dashscope、volcengine 等）。

依赖

Node.js >= 18
本仓库中的 backend-node（打包时通过 prepare-backend 复制到 backend-app）
前端需先在 frontweb 目录执行 npm run build，再打包或开发运行

5.3 KiB Raw Blame History Unescape Escape