# GUI 安装包构建工具

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

## 目录结构

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

## 使用方法

### 方法一：使用批处理脚本（推荐）
```bash
# 在 GUI_main 目录下运行
build_installer.bat
```

### 方法二：直接运行Python脚本
```bash
# 在 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` 中的以下配置：

```python
# 应用程序信息
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 版本信息
- 文件复制状态
- 编译过程输出
- 最终安装包信息

## 进一步优化

可以考虑添加以下功能：
- 数字签名支持
- 多语言支持
- 自定义安装选项
- 更新检查机制 