桌面版安装包生成指南

前置条件

# 确保已安装依赖
pnpm install

一、构建前端

npx vite build

• 产物输出到 dist/ 目录
• 约 20 秒完成

二、打包安装包

npx electron-builder --win --config electron-builder.yml

• 产物输出到 release8/ 目录
• 约 10-15 分钟完成
• 生成的安装包：release8/LRAgent-Setup-1.1.0-win-x64.exe（约 173MB）

三、一键命令（构建+打包）

npx vite build && npx electron-builder --win --config electron-builder.yml

关键配置文件

| 文件 | 作用 |

|------|------|

| electron-builder.yml | 打包配置（应用ID、输出目录、包含文件、NSIS设置） |

| electron-app/main.js | Electron主进程入口（启动内嵌Node服务+加载前端窗口） |

| package.json | 版本号（version字段，当前1.1.0） |

目录结构

bossagents/
├── dist/                  # 前端构建产物（vite build输出）
├── electron-app/main.js   # Electron主进程
├── electron-builder.yml   # 打包配置
├── server/                # 后端服务（打包时包含）
├── release8/              # 安装包输出目录（.gitignore排除）
│   └── LRAgent-Setup-1.1.0-win-x64.exe
└── package.json           # 版本号

修改版本号

编辑 package.json 和 electron-builder.yml 中的 version 字段，然后重新打包。

仅打包不重新构建前端

npx electron-builder --win --config electron-builder.yml

打包其他平台

# macOS
npx electron-builder --mac --config electron-builder.yml

# Linux
npx electron-builder --linux --config electron-builder.yml

常见问题

| 问题 | 解决方案 |

|------|---------|

| 打包超时 | 增加超时时间，NSIS压缩173MB应用需要10-15分钟 |

| file source doesn't exist 警告 | 部分DB文件不存在，不影响打包，可忽略 |

| better-sqlite3绑定缺失 | 已用node:sqlite降级，不影响打包运行 |