BossAgents桌面版安装包生成指南
前置条件
``bash
确保已安装依赖
pnpm install
`
一、构建前端
`bash
npx vite build
`
- 产物输出到 dist/
目录 - 约 20 秒完成
二、打包安装包
`bash
npx electron-builder --win --config electron-builder.yml
`
- 产物输出到 release8/
目录 - 约 10-15 分钟完成
- 生成的安装包：release8/LRAgent-Setup-1.1.0-win-x64.exe
（约 173MB）
三、一键命令（构建+打包）
`bash
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 字段，然后重新打包。
仅打包不重新构建前端
`bash
npx electron-builder --win --config electron-builder.yml
`
打包其他平台
`bash
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降级，不影响打包运行 |
