shuidrop_gui/installer/README.md

GUI 安装包构建工具

这个目录包含了使用 NSIS 构建 Windows 安装包的完整解决方案。

目录结构

installer/
├── build_installer.py    # 主要的构建脚本
├── installer.nsi         # 自动生成的 NSIS 脚本
├── assets/               # 安装包资源文件
│   ├── icon.png         # 应用程序图标
│   └── license.txt      # 软件许可协议
└── output/              # 生成的安装包输出目录

使用方法

方法一：使用批处理脚本（推荐）

# 在 GUI_main 目录下运行
build_installer.bat

方法二：直接运行Python脚本

# 在 GUI_main/installer 目录下运行
python build_installer.py

前提条件

1. NSIS 安装

   • 下载地址：https://nsis.sourceforge.io/Download
   • 安装后确保 makensis 命令在 PATH 中

2. 应用程序构建

   • 必须先运行 build_production.py 构建应用程序
   • 确保 dist/MultiPlatformGUI/ 目录存在

构建流程

1. 环境检查：验证 NSIS 安装和应用程序构建
2. 准备资源：复制图标文件和创建许可证
3. 生成脚本：自动生成 NSIS 安装脚本
4. 编译安装包：使用 makensis 编译最终的安装程序

输出结果

安装包将生成在 installer/output/ 目录下，文件名格式：

ShuiDi_AI_Assistant_Setup_1.0.0_YYYYMMDD_HHMMSS.exe

安装包功能

• ✅ 完整的中文界面
• ✅ 自动创建开始菜单快捷方式
• ✅ 自动创建桌面快捷方式
• ✅ 注册表集成
• ✅ 完整的卸载功能
• ✅ 版本信息显示

自定义配置

可以修改 build_installer.py 中的以下配置：

# 应用程序信息
self.app_name = "水滴AI客服智能助手"
self.app_name_en = "ShuiDi AI Assistant"
self.app_version = "1.0.0"
self.app_publisher = "水滴科技"
self.app_url = "https://www.shuidi.tech"

故障排除

常见问题

1. 找不到 makensis 命令

   • 确保 NSIS 已正确安装
   • 将 NSIS 安装目录添加到 PATH 环境变量

2. 找不到 dist 目录

   • 先运行 build_production.py 构建应用程序

3. 图标文件问题

   • 确保 static/ 目录下有图标文件
   • 建议准备 ICO 格式的图标文件

日志和调试

构建过程中的详细信息会在控制台显示，包括：

• NSIS 版本信息
• 文件复制状态
• 编译过程输出
• 最终安装包信息

进一步优化

可以考虑添加以下功能：

• 数字签名支持
• 多语言支持
• 自定义安装选项
• 更新检查机制