ClientApps/pqs-9100_client
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
cd331519203997d24be430decbd6ea045f0b5d6b
pqs-9100_client/doc/NPQS-9100绿色包完整指南.md

875 lines
22 KiB
Markdown
Raw Normal View History

绿色包保存
2025-11-27 20:50:59 +08:00
# NPQS-9100 绿色包完整指南
本指南包含绿色包的打包、使用、升级和维护的完整说明。
---
## 📋 目录
- [一、产品说明](#一产品说明)
- [七、用户关心的文件](#七用户关心的文件重要)⭐
- [二、打包指南](#二打包指南)
- [三、启动流程](#三启动流程)
- [四、升级指南](#四升级指南)
- [五、测试清单](#五测试清单)
- [六、常见问题](#六常见问题)
---
## 一、产品说明
### 📦 产品特性
绿色包是一个**免安装便携版**，包含：
- ✅ 应用本体（Electron + Vue 3）
- ✅ MySQL 数据库（免安装版，支持动态端口）
- ✅ Java 运行环境（JRE 8）
- ✅ Spring Boot 后端服务（entrance.jar）
- ✅ 智能启动流程（端口检测、Loading界面）
- ✅ **一键升级回滚机制** ⭐
**用户体验**：解压即用，双击启动，无需任何配置
---
### 🎯 核心功能
#### **1. 智能端口检测**
- MySQL 端口：从 3306 开始自动检测（最多 100 个）
- Java 端口：从 18092 开始自动检测（最多 100 个）
- 自动更新配置文件
#### **2. 盘符自动识别**
- 应用在 C 盘 → 数据目录：`C:\NPQS9100_Data\`
- 应用在 D 盘 → 数据目录：`D:\NPQS9100_Data\`
- 自动创建所有必要的子目录
#### **3. Loading 界面**
- 紫色渐变背景
- 流畅的进度条动画（0% → 100%）
- 实时状态文字更新
- 显示检测到的端口号和数据目录路径
#### **4. 热更新机制** ⭐
- 前端可独立升级
- 后端可独立升级
- 自动备份，支持一键回滚
- 数据库数据完全保留
#### **5. 简化配置管理**
- 基于环境变量的配置方案
- 需要修改配置时重新打包前端（upgrade.bat 升级）
- 保证稳定性和可靠性
---
### 📁 目录结构
```
win-unpacked/ # 绿色版目录（约 650-800 MB）
├── NPQS9100.exe # 主程序（双击运行）⭐
├── NPQS9100-启动器.bat # 管理员启动器（备用）
├── upgrade.bat # 升级工具 ⭐
├── rollback.bat # 回滚工具 ⭐
├── uninstall-mysql-service.bat # MySQL 服务卸载工具
├── 使用说明.txt # 使用手册
├── README-升级回滚.txt # 升级说明
├── upgrade/ # 升级包目录（首次使用自动创建）
├── backup/ # 自动备份目录
│ ├── dist/ # 前端备份
│ ├── entrance.jar # 后端备份
│ └── version.txt # 版本记录
├── resources/
│ ├── app.asar # Electron 主代码（加密）
│ ├── app.asar.unpacked/
│ │ └── public/
│ │ └── dist/ # 前端代码 ⭐ 可替换
│ └── extraResources/
│ ├── dll/
│ └── java/
│ ├── entrance.jar # 后端 JAR ⭐ 可替换
│ ├── application.yml.template
│ └── application.yml # 运行时生成
├── scripts/ # 启动管理脚本（⚠️ 不要修改）
│ ├── config-generator.js
│ ├── java-runner.js
│ ├── mysql-service-manager.js
│ ├── port-checker.js
│ └── startup-manager.js
├── mysql/ # MySQL 数据库
│ ├── bin/
│ ├── data/ # 数据库数据 ⚠️ 不要动
│ ├── data_backup/ # 自动备份
│ ├── my.ini # 运行时生成
│ └── README.txt
├── jre/ # Java 运行环境（⚠️ 不要修改）
│ ├── bin/
│ └── lib/
└── logs/ # 应用日志
├── startup-YYYYMMDD.log
└── upgrade.log
用户数据目录（首次运行自动创建）：
X:\NPQS9100_Data\ (X 是应用所在盘符)
├── logs/ # Spring Boot 日志
├── template/ # 报告模板
├── report/ # 生成的报告
└── data/ # 应用数据
```
---
## 七、用户关心的文件（重要！）⭐
### 📌 可以使用的工具
| 文件 | 功能 | 使用场景 |
|------|------|---------|
| **NPQS9100.exe** | 主程序 | 日常启动 |
| **NPQS9100-启动器.bat** | 管理员启动器 | 首次运行或权限问题时 |
| **upgrade.bat** | 升级工具 | 收到升级包时使用 |
| **rollback.bat** | 回滚工具 | 升级后出问题时使用 |
| **uninstall-mysql-service.bat** | MySQL 服务卸载 | 完全卸载应用时使用 |
| **使用说明.txt** | 使用手册 | 遇到问题时参考 |
| **README-升级回滚.txt** | 升级说明 | 升级前阅读 |
---
### ⚠️ 不要修改的文件/目录
| 路径 | 说明 | 误修改后果 |
|------|------|----------|
| **resources/** | 应用核心代码 | 应用无法启动 |
| **scripts/** | 启动管理脚本 | 启动流程失败 |
| **jre/** | Java 运行环境 | Java 服务无法启动 |
| **mysql/bin/** | MySQL 可执行文件 | 数据库无法启动 |
| **mysql/my.ini** | MySQL 配置 | 运行时自动生成，手动修改会被覆盖 |
---
### 📂 需要保护的数据
| 路径 | 说明 | 备份建议 |
|------|------|---------|
| **mysql/data/** | 数据库数据 | ⚠️ 定期备份！ |
| **backup/** | 升级备份 | 自动管理，无需手动操作 |
| **X:\NPQS9100_Data/** | 用户数据目录 | 包含日志、模板、报告 |
---
## 二、打包指南
### 🏗️ 打包步骤
#### **步骤 1：清理并打包**
```bash
cd build
clean-and-build.bat
```
**打包过程**：
1. 停止 NPQS9100 进程
2. 删除 out 目录
3. 构建前端代码（Vue 3）
4. 编译 Electron 主进程代码
5. 复制 MySQL、JRE、Java 资源
6. 生成 win-unpacked 绿色版目录
**等待时间**：约 5-15 分钟
---
#### **步骤 2：测试运行**
```bash
cd out\win-unpacked
NPQS9100.exe
```
**观察**：
- ✅ Loading 界面正常显示（不在任务栏显示）
- ✅ 启动进度正常更新（9个步骤）
- ✅ MySQL 自动启动
- ✅ Spring Boot 连接成功
- ✅ 顺利进入主界面
---
#### **步骤 3：压缩发布包**
```powershell
cd out
Compress-Archive -Path win-unpacked -DestinationPath "NPQS9100-v1.0.0-绿色版.zip" -Force
```
**压缩后大小**：约 350-450 MB
---
## 三、启动流程
### 🔄 完整启动流程
```
用户解压 zip 并双击 NPQS9100.exe
↓
显示 Loading 界面（不在任务栏显示）
↓
[0%] 正在初始化应用...
↓
[15%] 检测 MySQL 端口 (3306 → 3307 → ...)
├─ 找到可用端口（如 3307）
↓
[30%] 启动 MySQL 数据库（端口 3307）
├─ 首次运行：自动初始化数据库
├─ 自动设置 root 密码：njcnpqs
├─ 自动授权 127.0.0.1 访问
↓
[45%] 等待 MySQL 就绪
├─ 监听端口是否打开
├─ 超时时间：30 秒
↓
[60%] 检测 Java 端口 (18092 → 18093 → ...)
├─ 找到可用端口（如 18093）
↓
[70%] 检测应用所在盘符并生成配置文件
├─ MySQL 连接：localhost:3307
├─ MySQL 密码：njcnpqs ⭐ 自动写入
├─ Java 端口：18093
├─ 数据路径：C:\NPQS9100_Data\
├─ 创建所有必要目录（logs、template、report、data）
↓
[80%] 启动 Spring Boot 后端
├─ 使用内置 JRE 8
├─ 加载生成的配置文件
├─ 连接 MySQL 数据库
↓
[90%] 等待 Spring Boot 就绪
├─ 监听 18093 端口
├─ 超时时间：60 秒
↓
[100%] 启动完成！
├─ 等待 1.5 秒显示完成状态
↓
销毁 Loading 窗口（使用 destroy() 确保完全释放）
↓
显示主应用界面（任务栏只显示1个图标）
```
**预计启动时间**：
- 首次运行：30-45 秒（需初始化 MySQL）
- 后续启动：15-25 秒
---
### 🚪 关闭流程
```
用户关闭应用（点击X或托盘退出）
↓
显示退出确认对话框
↓
用户确认退出
↓
停止 Spring Boot 进程（通过PID和端口精确清理）
↓
停止 MySQL 服务（如果是服务模式）
↓
清理资源
↓
应用退出
```
---
## 四、升级指南
### 🎯 升级流程概览
#### **升级流程**
```
1. 双击 upgrade.bat（首次自动创建 upgrade/ 目录）
2. 将升级包放入 upgrade/ 目录
3. 再次运行 upgrade.bat（自动备份 + 升级）
4. 重启应用测试
```
#### **回滚流程**
```
1. 双击 rollback.bat
2. 自动从 backup/ 恢复旧版本
3. 重启应用
```
---
### 🔧 升级操作步骤
#### **方法 1：使用升级脚本（推荐）⭐**
**第 1 步：准备升级包**
1. 双击 `upgrade.bat`
2. 脚本自动创建 `upgrade/` 文件夹并提示
3. 将升级文件放入 `upgrade/` 目录：
- `dist/` - 前端升级包（可选）
- `entrance.jar` - 后端升级包（可选）
4. 再次双击 `upgrade.bat` 开始升级
**第 2 步：自动升级**
脚本会自动：
- ✅ 停止 NPQS9100 进程
- ✅ **自动备份当前版本到 `backup/` 目录**
- ✅ 备份数据库到 `mysql/data_backup/`
- ✅ 替换前端文件（如果有）
- ✅ 替换后端 JAR（如果有）
- ✅ 记录升级日志到 `logs/upgrade.log`
**第 3 步：重启应用**
升级完成后，双击 `NPQS9100.exe` 启动应用。
---
#### **方法 2：手动升级**
如果升级脚本失败，可以手动操作：
**升级前端**：
```batch
taskkill /F /IM NPQS9100.exe
rmdir /s /q resources\app.asar.unpacked\public\dist
xcopy upgrade\dist resources\app.asar.unpacked\public\dist\ /E /I /Y
```
**升级后端**：
```batch
taskkill /F /IM NPQS9100.exe
copy /Y upgrade\entrance.jar resources\extraResources\java\entrance.jar
```
---
### 🔄 回滚操作
#### **方法 1：使用回滚脚本（推荐）⭐**
如果升级后出现问题，直接双击 `rollback.bat`：
脚本会自动：
- ✅ 停止 NPQS9100
- ✅ 恢复前端（从 `backup/dist/`）
- ✅ 恢复后端（从 `backup/entrance.jar`）
- ✅ 询问是否恢复数据库（⚠️ 会丢失升级后的数据）
#### **方法 2：手动回滚**
```batch
# 恢复前端
rmdir /s /q resources\app.asar.unpacked\public\dist
xcopy backup\dist resources\app.asar.unpacked\public\dist\ /E /I /Y
# 恢复后端
copy /Y backup\entrance.jar resources\extraResources\java\entrance.jar
# 恢复数据库（⚠️ 谨慎！）
rmdir /s /q mysql\data
xcopy mysql\data_backup mysql\data\ /E /I /Y
```
---
### 📋 升级清单
| 升级类型 | 升级包来源 | 客户放置位置 | 最终替换位置 |
|---------|-----------|-------------|-------------|
| **前端** | `out/win-unpacked/resources/app.asar` + `app.asar.unpacked/` | `upgrade/app.asar` + `upgrade/app.asar.unpacked/` | `resources/app.asar` + `resources/app.asar.unpacked/` |
| **后端** | `out/win-unpacked/resources/extraResources/java/entrance.jar` | `upgrade/entrance.jar` | `resources/extraResources/java/entrance.jar` |
| **数据库** | ⚠️ **不升级，自动保留** | - | `mysql/data/` |
---
### 🛠️ 开发者升级流程（完整版）
#### **前端升级完整流程**
```bash
# ============================================
# 开发侧操作
# ============================================
# 1️⃣ 修改前端代码
# 编辑 frontend/src/ 下的任何文件
# 2️⃣ 如需修改配置（可选）
# 编辑 frontend/.env
VITE_API_URL=http://192.168.1.100:18092 # 修改 API 地址
# 3️⃣ 构建前端
npm run build-frontend
# 4️⃣ 打包应用
npm run build-w
# 输出: out/win-unpacked/
# 5️⃣ 准备升级包
# 从 out/win-unpacked/resources/ 复制以下文件：
# - app.asar （文件）
# - app.asar.unpacked/ （整个文件夹）
#
# 压缩成: NPQS9100-前端-v1.0.1.zip
# 6️⃣ 发给客户
# ============================================
# 客户侧操作
# ============================================
# 1️⃣ 解压升级包
# 解压 NPQS9100-前端-v1.0.1.zip
# 得到:
# - app.asar
# - app.asar.unpacked/
# 2️⃣ 复制到升级目录
# 将两个文件都放到：win-unpacked/upgrade/
# - upgrade/app.asar
# - upgrade/app.asar.unpacked/
# 3️⃣ 运行升级脚本
# 双击: upgrade.bat
# 4️⃣ 重启应用
# 双击: NPQS9100.exe
```
#### **后端升级完整流程**
```bash
# ============================================
# 开发侧操作
# ============================================
# 1️⃣ 获取新的 JAR 文件
# 从后端开发人员获取新版本的 entrance.jar
# 2️⃣ 替换 JAR 文件
# 将新的 entrance.jar 复制到:
# build/extraResources/java/entrance.jar
# 3️⃣ 打包升级包
# 直接压缩 entrance.jar 文件
# 重命名为: NPQS9100-后端-v1.0.1.zip
# 4️⃣ 发给客户
# 发送 NPQS9100-后端-v1.0.1.zip
# ============================================
# 客户侧操作
# ============================================
# 1️⃣ 解压升级包
# 解压 NPQS9100-后端-v1.0.1.zip
# 得到 entrance.jar 文件
# 2️⃣ 复制到升级目录
# 将 entrance.jar 复制到:
# win-unpacked/upgrade/entrance.jar
# 3️⃣ 运行升级脚本
# 双击: upgrade.bat
# 4️⃣ 重启应用
# 双击: NPQS9100.exe
```
#### **前后端同时升级**
```bash
# 开发侧：准备升级包
NPQS9100-升级-v1.1.0.zip
├── app.asar # 前端升级包（文件）
├── app.asar.unpacked/ # 前端升级包（文件夹）
└── entrance.jar # 后端升级包
# 客户侧：复制到
win-unpacked/upgrade/
├── app.asar
├── app.asar.unpacked/
└── entrance.jar
# 运行 upgrade.bat 即可一次性升级前后端
```
---
## 五、测试清单
### ✅ 打包验证
- [ ] `out/win-unpacked` 目录存在
- [ ] 目录大小约 650-800 MB
- [ ] NPQS9100.exe 存在
- [ ] NPQS9100-启动器.bat 存在
- [ ] upgrade.bat 存在
- [ ] rollback.bat 存在
- [ ] uninstall-mysql-service.bat 存在
- [ ] 使用说明.txt 存在
- [ ] README-升级回滚.txt 存在
- [ ] mysql/ 目录完整
- [ ] jre/ 目录完整
---
### ✅ 基础功能测试
- [ ] 双击 NPQS9100.exe 能正常启动
- [ ] Loading 界面正常显示
- [ ] **Loading 窗口不在任务栏显示** ⭐
- [ ] 进度条流畅更新（0% → 100%）
- [ ] 状态文字正确显示
- [ ] 主界面正常显示
- [ ] **任务栏只有1个窗口预览** ⭐
---
### ✅ 端口检测测试
- [ ] 手动占用 3306，应用自动使用 3307
- [ ] 手动占用 18092，应用自动使用 18093
- [ ] Loading 界面显示检测到的端口号
- [ ] 日志中显示正确的端口信息
---
### ✅ MySQL 测试
- [ ] MySQL 自动启动成功
- [ ] **首次运行自动初始化数据库** ⭐
- [ ] 可以用 Navicat 连接（密码：njcnpqs）
- [ ] 可以从 127.0.0.1 连接（不报 1130 错误）⭐
- [ ] 数据库操作正常
- [ ] 关闭应用后 MySQL 自动停止
---
### ✅ Spring Boot 测试
- [ ] 后端服务自动启动
- [ ] **能连接到 MySQL（不报密码错误）** ⭐
- [ ] 日志无错误："HikariPool-1 - Start completed"
- [ ] API 接口正常响应
- [ ] 关闭应用后 Java 进程停止
---
### ✅ 配置生成测试
- [ ] application.yml 自动生成
- [ ] **MySQL 密码正确写入（njcnpqs）** ⭐
- [ ] MySQL 端口正确
- [ ] Java 端口正确
- [ ] 数据路径正确（对应盘符）
---
### ✅ 数据目录测试
- [ ] 数据目录在正确的盘符下创建
- [ ] 所有子目录都自动创建
- [ ] 配置文件路径正确
- [ ] 日志文件正常写入
---
### ✅ 便携性测试
- [ ] 可以解压到任意目录运行
- [ ] 可以移动到其他目录运行
- [ ] 可以在不同电脑上运行
- [ ] 可以在不同盘符上运行（C/D/E...）
- [ ] 删除目录即可完全卸载
- [ ] **压缩成 zip 后用户可正常解压使用** ⭐
---
### ✅ 升级回滚测试
- [ ] upgrade.bat 首次运行自动创建 upgrade/ 目录
- [ ] upgrade.bat 检测到升级文件后正常升级
- [ ] 升级前自动备份到 backup/ 目录
- [ ] 升级后应用正常运行
- [ ] 升级后数据库数据保留
- [ ] rollback.bat 能正确回滚前端
- [ ] rollback.bat 能正确回滚后端
- [ ] 回滚后应用恢复正常
---
### ✅ 性能测试
- [ ] 首次启动 < 45 秒
- [ ] 后续启动 < 30 秒
- [ ] Loading 界面流畅无卡顿
- [ ] 内存占用合理（< 1GB）
- [ ] CPU 占用正常
---
### ✅ 错误处理测试
- [ ] 端口全部占用时显示友好错误
- [ ] MySQL 启动失败时显示错误信息
- [ ] Spring Boot 启动失败时不崩溃
- [ ] 升级失败时自动回滚
- [ ] 托盘图标显示正常
- [ ] 退出确认对话框正常工作
---
## 六、常见问题
### Q1: Loading 界面一直卡在某个步骤？
**A**: 查看日志定位问题：
```
C:\Users\[用户名]\AppData\Roaming\NQPS9100\logs\
├── 9100-YYYYMMDD.log # 应用日志
├── 9100-core-YYYYMMDD.log # 核心日志
└── 9100-error-YYYYMMDD.log # 错误日志
```
常见原因：
- MySQL 启动失败 → 检查端口是否可用
- Java 启动失败 → 检查 JRE 是否完整
- 配置生成失败 → 检查磁盘权限
---
### Q2: 显示"无法找到可用端口"错误？
**A**:
- 检查是否有大量端口被占用
- 尝试关闭其他占用端口的程序
- 或修改起始端口（见开发者指南）
---
### Q3: MySQL 连接失败或提示 1130 错误？
**A**:
- 确认 MySQL 已启动（任务管理器查看 mysqld.exe）
- 确认端口正确（看 Loading 界面显示的端口）
- 确认密码正确（njcnpqs，已自动配置）
- 检查是否有杀毒软件拦截
- 如有问题，重启应用即可（MySQL 会自动重新配置）
---
### Q4: 后端 API 无法访问？
**A**:
- 确认 Spring Boot 已启动
- 确认端口正确（看 Loading 界面）
- 检查防火墙设置
---
### Q5: 打包后体积太大？
**A**: 预期体积：
- **解压后**：650-800 MB
- **压缩后 (zip)**：350-450 MB
主要组成：
- 应用本体：~150 MB
- MySQL 8.0：~400 MB
- JRE 8：~100 MB
优化建议：
- 考虑使用 7z 格式（压缩率更高）
- 可以精简 MySQL 的不必要组件
---
### Q6: 任务栏显示2个窗口预览？
**A**: 已修复！现在 Loading 窗口使用 `skipTaskbar: true`，不会在任务栏显示。
---
### Q7: 升级后前端显示旧版本？
**A**: 清除浏览器缓存，或强制刷新（Ctrl + F5）
---
### Q8: 升级后数据丢失？
**A**: 检查 `mysql/data/` 目录是否完整，如有备份，从 `mysql/data_backup/` 恢复
---
### Q9: 升级脚本报错？
**A**：
1. 检查 `upgrade` 文件夹路径是否正确
2. 手动执行升级步骤
3. 查看 `logs/upgrade.log` 日志
---
### Q10: 回滚后还是有问题？
**A**：
1. 检查 `backup/` 目录是否有备份文件
2. 查看 `backup/version.txt` 确认备份版本
3. 手动执行回滚步骤（参考本文档）
---
### Q11: 多次升级后，backup 目录的内容是什么版本？
**A**: `backup/` 目录保存的是**最后一次升级前**的版本（每次升级都会覆盖）
---
### Q12: 点击 X 关闭后，Java 进程还在运行？
**A**: 已修复！现在使用精确的进程清理机制：
- 通过 PID 清理（如果有进程引用）
- 通过端口号清理（精确定位）
- **不会误杀 IDEA 等其他 Java 进程** ⭐
---
### Q13: 如何修改 API 或 WebSocket 地址？
**A**:
1. 修改 `frontend/.env` 文件中的 `VITE_API_URL`
2. 重新构建前端：`npm run build-frontend`
3. 将 `public/dist/` 打包为升级包
4. 使用 `upgrade.bat` 升级
**示例**：
```env
# frontend/.env
VITE_API_URL=http://192.168.1.100:18092
```
**注意**：
- 配置修改需要重新打包前端
- 使用升级机制保证数据安全
---
### Q14: MySQL 服务如何卸载？
**A**:
**方法 1：使用卸载脚本（推荐）**
```batch
双击: uninstall-mysql-service.bat
```
**方法 2：手动卸载**
```batch
# 停止服务
net stop mysql9100
# 删除服务
sc delete mysql9100
```
**注意**：
- 卸载服务不会删除数据库数据
- 数据保存在 `mysql/data/` 目录
- 下次启动应用会重新安装服务
---
## 📚 相关文档
**用户文档**（随应用发布）：
- `使用说明.txt` - 用户使用手册
- `README-升级回滚.txt` - 简明升级说明
**开发者文档**（doc/ 目录）：
- `doc/NPQS-9100绿色包完整指南.md` - 本文档（完整指南）
- `doc/打包前检查清单.md` - 逐项检查
- `doc/管理员权限说明.md` - 权限问题处理
- `doc/MySQL服务化方案说明.md` - MySQL 服务管理
---
## 📊 技术架构
### 核心模块
- `scripts/port-checker.js` - 端口检测工具
- `scripts/startup-manager.js` - 启动状态管理
- `scripts/config-generator.js` - 配置文件生成
- `scripts/mysql-service-manager.js` - MySQL 服务管理器
- `scripts/java-runner.js` - Java 运行器
- `scripts/log-window-manager.js` - 日志窗口管理
- `electron/preload/lifecycle.js` - 生命周期管理
- `public/html/loading.html` - Loading 界面
### 启动流程架构
```
lifecycle.js (入口)
↓ 创建
StartupManager (显示 Loading)
↓ 调用
PortChecker (检测端口)
↓ 调用
MySQLServiceManager (管理 MySQL 服务)
↓ 调用
ConfigGenerator (生成配置)
↓ 调用
JavaRunner (启动 Spring Boot)
```
---
## 🎉 最新改进
### 用户体验提升
- ✅ **任务栏只显示1个图标** - Loading 窗口不在任务栏显示
- ✅ **纯绿色版** - 只生成 win-unpacked 目录，压缩成 zip 即可发布
- ✅ **一键解压即用** - 用户解压后双击即可运行
- ✅ **热更新机制** - 前后端可独立升级，支持一键回滚
### 技术改进
- ✅ **MySQL 密码自动配置** - 配置生成器自动写入密码
- ✅ **权限自动授权** - 支持 localhost 和 127.0.0.1 访问
- ✅ **MySQL 服务化** - 使用 Windows 服务管理，开机自启
- ✅ **窗口管理优化** - 使用 destroy() 确保窗口完全释放
- ✅ **精确进程清理** - 不会误杀其他 Java 进程
- ✅ **自动备份机制** - 升级前自动备份，支持回滚
- ✅ **热更新机制** - 前后端独立升级，无需重装
### 文档完善
- ✅ **使用说明.txt** - 为用户提供详细的使用指南
- ✅ **README-升级回滚.txt** - 简明升级操作说明
- ✅ **完整指南** - 打包、启动、升级三合一文档
---
## 📞 技术支持
如遇问题，请联系技术支持并提供：
- 应用版本号
- 错误日志（`logs/` 目录）
- 操作步骤截图
---
*文档更新时间: 2025-10-23*
*南京灿能电力自动化股份有限公司*
Reference in New Issue Copy Permalink