diff --git a/.claude/settings.local.json b/.claude/settings.local.json
new file mode 100644
index 0000000..e9b7653
--- /dev/null
+++ b/.claude/settings.local.json
@@ -0,0 +1,15 @@
+{
+ "permissions": {
+ "allow": [
+ "Bash(dir:*)",
+ "Bash(\"build/extraResources/jre/bin/java.exe\" -version)",
+ "Bash(npm run build-frontend:*)",
+ "Bash(taskkill:*)",
+ "Bash(iconv:*)",
+ "Bash(powershell:*)",
+ "Bash(del:*)"
+ ],
+ "deny": [],
+ "ask": []
+ }
+}
diff --git a/build/NPQS9100.bat b/build/NPQS9100.bat
new file mode 100644
index 0000000..7ee6675
--- /dev/null
+++ b/build/NPQS9100.bat
@@ -0,0 +1,18 @@
+@echo off
+chcp 65001 >nul
+
+REM 获取当前批处理文件所在目录
+cd /d "%~dp0"
+
+REM 检查是否有管理员权限
+net session >nul 2>&1
+if %errorlevel% == 0 (
+ REM 已有管理员权限,直接启动
+ start "" "NPQS9100.exe"
+ exit
+) else (
+ REM 没有管理员权限,使用 PowerShell 以管理员身份启动(隐藏窗口)
+ powershell -WindowStyle Hidden -Command "Start-Process '%~dp0NPQS9100.exe' -Verb RunAs"
+ exit
+)
+
diff --git a/build/README-升级回滚.txt b/build/README-升级回滚.txt
new file mode 100644
index 0000000..c2dfac0
--- /dev/null
+++ b/build/README-升级回滚.txt
@@ -0,0 +1,46 @@
+========================================
+NPQS-9100 升级与回滚说明
+========================================
+
+一、升级步骤(超简单!)
+----------------------------------------
+1. 双击 upgrade.bat(首次会自动创建 upgrade 文件夹)
+2. 将升级文件放入 upgrade/ 目录:
+ - app.asar (前端升级包 - 文件)
+ - app.asar.unpacked\ (前端升级包 - 文件夹)
+ - entrance.jar (后端升级包)
+3. 再次双击 upgrade.bat 开始升级
+4. 等待完成后重启应用
+
+二、回滚步骤
+----------------------------------------
+如果升级后出现问题:
+1. 双击 rollback.bat
+2. 选择是否回滚数据库(谨慎!)
+3. 等待完成后重启应用
+
+三、重要提示
+----------------------------------------
+✓ 升级前会自动备份到 backup/ 目录
+✓ 数据库会自动备份到 mysql/data_backup/
+✓ 升级日志保存在 logs/upgrade.log
+✓ 多次升级时,backup/ 保存最后一次升级前的版本
+
+四、紧急情况
+----------------------------------------
+如果脚本无法运行,请手动操作:
+
+【恢复前端】
+copy /Y backup\app.asar resources\app.asar
+xcopy backup\app.asar.unpacked resources\app.asar.unpacked\ /E /I /Y
+
+【恢复后端】
+copy /Y backup\entrance.jar resources\extraResources\java\entrance.jar
+
+【恢复数据库】(慎用!)
+xcopy mysql\data_backup mysql\data\ /E /I /Y
+
+========================================
+详细文档请参考:doc/绿色包升级指南.md
+========================================
+
diff --git a/build/app.manifest b/build/app.manifest
new file mode 100644
index 0000000..d45cca9
--- /dev/null
+++ b/build/app.manifest
@@ -0,0 +1,29 @@
+
+
+
+ NPQS-9100自动检测平台
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/build/build.bat b/build/build.bat
new file mode 100644
index 0000000..3556ad8
--- /dev/null
+++ b/build/build.bat
@@ -0,0 +1,59 @@
+@echo off
+chcp 65001 >nul
+echo ========================================
+echo 清理并重新打包
+echo ========================================
+echo.
+
+echo [1/4] 删除 out 目录...
+cd /d "%~dp0.."
+if exist out (
+ rmdir /s /q out 2>nul
+ if exist out (
+ echo 删除失败,请手动删除 out 目录
+ pause
+ exit /b 1
+ ) else (
+ echo out 目录已删除
+ )
+) else (
+ echo out 目录不存在
+)
+echo.
+
+echo [2/4] 构建前端代码...
+call npm run build-frontend
+if %errorlevel% neq 0 (
+ echo 前端构建失败
+ pause
+ exit /b 1
+)
+echo 前端代码构建完成
+echo.
+
+echo [3/4] 构建 electron 代码...
+call npm run build-electron
+if %errorlevel% neq 0 (
+ echo electron 构建失败
+ pause
+ exit /b 1
+)
+echo electron 代码构建完成
+echo.
+
+echo [4/4] 打包 Windows 版本(包含代码加密)...
+call npm run build-w
+if %errorlevel% neq 0 (
+ echo 打包失败
+ pause
+ exit /b 1
+)
+echo.
+
+echo ========================================
+echo 打包完成!
+echo 输出目录: out\win-unpacked\
+echo ========================================
+echo.
+pause
+
diff --git a/build/diagnose-startup.bat b/build/diagnose-startup.bat
new file mode 100644
index 0000000..f02c786
--- /dev/null
+++ b/build/diagnose-startup.bat
@@ -0,0 +1,69 @@
+@echo off
+chcp 65001 >nul
+echo ========================================
+echo NPQS9100 启动诊断工具
+echo ========================================
+echo.
+
+echo [1] 检查运行中的进程...
+echo.
+echo NPQS9100 进程:
+tasklist | findstr /i "NPQS9100.exe"
+if %errorlevel% neq 0 echo 未找到
+echo.
+
+echo MySQL 进程:
+tasklist | findstr /i "mysqld.exe"
+if %errorlevel% neq 0 echo 未找到
+echo.
+
+echo Java 进程:
+tasklist | findstr /i "java.exe"
+if %errorlevel% neq 0 echo 未找到
+echo.
+
+echo [2] 检查端口占用...
+echo.
+echo 3306 端口:
+netstat -ano | findstr ":3306" | findstr "LISTENING"
+if %errorlevel% neq 0 echo 未占用
+echo.
+
+echo 18092 端口:
+netstat -ano | findstr ":18092" | findstr "LISTENING"
+if %errorlevel% neq 0 echo 未占用
+echo.
+
+echo 7777 端口:
+netstat -ano | findstr ":7777" | findstr "LISTENING"
+if %errorlevel% neq 0 echo 未占用
+echo.
+
+echo [3] 查看最新日志...
+echo.
+set LOGDIR=%APPDATA%\NQPS9100\logs
+echo 日志目录: %LOGDIR%
+if exist "%LOGDIR%" (
+ echo.
+ echo 最新日志文件:
+ dir /b /o-d "%LOGDIR%\*.log" 2>nul
+ echo.
+) else (
+ echo 日志目录不存在
+)
+echo.
+
+echo [4] 检查 MySQL 服务...
+sc query mysql9100 >nul 2>&1
+if %errorlevel% equ 0 (
+ echo MySQL 服务存在
+ sc query mysql9100 | findstr "STATE"
+) else (
+ echo MySQL 服务不存在
+)
+echo.
+
+echo ========================================
+echo 诊断完成
+echo ========================================
+pause
diff --git a/build/extraResources/mysql/README.txt b/build/extraResources/mysql/README.txt
index a1eaaeb..0bb5d53 100644
--- a/build/extraResources/mysql/README.txt
+++ b/build/extraResources/mysql/README.txt
@@ -1,85 +1,33 @@
==========================================
- NPQS9100 MySQL 免安装版使用说明
+ NPQS9100 MySQL 数据库
==========================================
-一、快速开始
+目录说明
----------------------------------------
-1. 启动 MySQL:
- 双击运行: startup.bat
- (注意:不要关闭窗口,关闭会停止MySQL)
-
-2. 首次使用,如需重置密码和权限:
- 双击运行: reset-root-password.bat
-
-3. 停止 MySQL:
- 双击运行: stop.bat
+bin/ - MySQL 可执行文件
+data/ - 数据库数据目录
+share/ - 共享资源文件
+my.ini - MySQL 配置文件
-二、连接信息
+服务管理
----------------------------------------
-主机: 127.0.0.1 (或 localhost)
+MySQL 服务由主应用自动管理:
+- 应用启动时自动启动
+- 应用关闭时自动停止
+- 默认端口:3306(如被占用会自动切换)
+
+
+连接信息
+----------------------------------------
+主机: 127.0.0.1
端口: 3306
用户: root
密码: njcnpqs
字符集: utf8mb4
-三、脚本说明
-----------------------------------------
-startup.bat - 启动 MySQL 服务
-stop.bat - 正常停止 MySQL 服务
-reset-root-password.bat - 重置root密码和权限(解决1130错误)
-kill-running-port.bat - 智能清理应用实际使用的端口(自动识别3306/3307/...)
-my.ini - MySQL 配置文件
-.running-port - 运行时端口记录(自动生成,勿删除)
-
-bin/ - MySQL 可执行文件
-data/ - 数据库数据目录
-share/ - 共享资源
-
-⚠️ 安全说明:
-- 应用自动停止MySQL时,只会停止应用自己启动的MySQL进程
-- 不会影响您电脑上安装的其他MySQL服务
-- kill-running-port.bat 会读取 .running-port 文件,精确清理实际使用的端口
-- 如果3306被占用,应用会自动使用3307,kill-running-port.bat 会智能识别
-
-⚙️ 停止机制:
-- 应用关闭时会自动使用 mysqladmin shutdown 优雅停止MySQL
-- 如果优雅停止失败,会自动尝试强制停止
-- 整个停止过程最多12秒,确保MySQL完全关闭
-
-⭐ 端口智能管理:
-- 应用启动时自动检测可用端口(3306 → 3307 → 3308...)
-- 启动成功后会记录实际端口到 .running-port 文件
-- 使用 kill-running-port.bat 可自动清理正确的端口
-
-
-四、注意事项
-----------------------------------------
-1. 启动后不要关闭命令行窗口,关闭窗口会停止 MySQL
-2. 正常停止请使用 stop.bat
-3. 如果出现 1130 或密码错误,运行 reset-root-password.bat
-4. 如果端口被占用无法启动,运行 kill-3306.bat
-5. 默认密码是 njcnpqs,不要随意修改
-
-
-五、常见问题
-----------------------------------------
-Q: 连接提示 1130 错误或密码错误?
-A: 运行 reset-root-password.bat 重置权限
-
-Q: 启动失败或端口被占用?
-A: 运行 kill-running-port.bat 清理端口(自动识别正确端口)
-
-Q: 如何重置密码?
-A: 运行 reset-root-password.bat(密码会重置为 njcnpqs)
-
-Q: 数据在哪里?
-A: 所有数据库数据在 data/ 目录下
-
-
==========================================
南京灿能电气自动化有限公司
2025
==========================================
-
diff --git a/build/extraResources/mysql/init_pwd.bat b/build/extraResources/mysql/init_pwd.bat
new file mode 100644
index 0000000..d20bbb4
--- /dev/null
+++ b/build/extraResources/mysql/init_pwd.bat
@@ -0,0 +1,34 @@
+@echo off
+chcp 65001 >nul
+cd /d %~dp0
+
+taskkill /F /IM mysqld.exe 2>nul
+timeout /t 2 /nobreak >nul
+
+rmdir /s /q data 2>nul
+mkdir data
+
+echo 初始化数据库...
+bin\mysqld.exe --defaults-file=my.ini --initialize-insecure --console
+
+echo 启动 MySQL...
+start /B bin\mysqld.exe --defaults-file=my.ini
+timeout /t 8 /nobreak >nul
+
+echo 设置密码...
+bin\mysql.exe -h 127.0.0.1 -P 3306 -u root -e "ALTER USER 'root'@'localhost' IDENTIFIED BY 'njcnpqs'; CREATE USER IF NOT EXISTS 'root'@'127.0.0.1' IDENTIFIED BY 'njcnpqs'; GRANT ALL PRIVILEGES ON *.* TO 'root'@'127.0.0.1' WITH GRANT OPTION; FLUSH PRIVILEGES;"
+
+if %errorlevel% NEQ 0 (
+ echo 第一次失败,重试...
+ timeout /t 3 /nobreak >nul
+ bin\mysql.exe -h localhost -P 3306 -u root -e "ALTER USER 'root'@'localhost' IDENTIFIED BY 'njcnpqs'; CREATE USER IF NOT EXISTS 'root'@'127.0.0.1' IDENTIFIED BY 'njcnpqs'; GRANT ALL PRIVILEGES ON *.* TO 'root'@'127.0.0.1' WITH GRANT OPTION; FLUSH PRIVILEGES;"
+)
+
+taskkill /F /IM mysqld.exe 2>nul
+
+echo.
+echo ==========================================
+echo 完成!密码: njcnpqs
+echo ==========================================
+pause
+
diff --git a/build/extraResources/mysql/kill-running-port.bat b/build/extraResources/mysql/kill-running-port.bat
deleted file mode 100644
index 25c70a3..0000000
--- a/build/extraResources/mysql/kill-running-port.bat
+++ /dev/null
@@ -1,115 +0,0 @@
-@echo off
-chcp 65001 >nul
-color 0C
-title 清理NPQS9100 MySQL端口占用
-cls
-echo ==========================================
-echo 清理 NPQS9100 MySQL 端口占用
-echo ==========================================
-echo.
-
-REM 获取MySQL目录(脚本所在目录)
-set MYSQL_HOME=%~dp0
-cd /d "%MYSQL_HOME%"
-
-REM 读取实际运行的端口
-set PORT_FILE=.running-port
-set MYSQL_PORT=
-
-if exist "%PORT_FILE%" (
- set /p MYSQL_PORT=<"%PORT_FILE%"
- echo [√] 检测到运行记录:端口 %MYSQL_PORT%
- echo.
-) else (
- echo [!] 未找到运行记录文件,使用默认端口 3306
- echo.
- set MYSQL_PORT=3306
-)
-
-echo [1] 检查端口 %MYSQL_PORT% 占用情况...
-echo.
-
-REM 查找占用该端口的连接
-netstat -ano | findstr ":%MYSQL_PORT%" > "%TEMP%\mysql_port.txt"
-
-if %errorlevel% equ 0 (
- echo 发现以下端口 %MYSQL_PORT% 连接:
- echo ----------------------------------------
- type "%TEMP%\mysql_port.txt"
- echo ----------------------------------------
- echo.
-
- echo [2] 提取进程ID并结束进程...
- echo.
-
- REM 提取所有LISTENING状态的PID
- for /f "tokens=5" %%a in ('netstat -ano ^| findstr ":%MYSQL_PORT%" ^| findstr "LISTENING"') do (
- if not "%%a"=="0" (
- echo 正在结束进程 PID: %%a
- taskkill /F /PID %%a 2>nul
- if errorlevel 1 (
- echo [失败] 无法结束进程 %%a
- ) else (
- echo [成功] 已结束进程 %%a
- )
- )
- )
-
- REM 如果还有其他状态的连接,也尝试结束
- for /f "tokens=5" %%a in ('netstat -ano ^| findstr ":%MYSQL_PORT%" ^| findstr /V "LISTENING"') do (
- if not "%%a"=="0" (
- echo 正在结束进程 PID: %%a
- taskkill /F /PID %%a 2>nul
- if errorlevel 1 (
- echo [已结束或无权限] 进程 %%a
- ) else (
- echo [成功] 已结束进程 %%a
- )
- )
- )
-
- echo.
- echo [3] 清理完成
-
- REM 等待2秒让进程完全释放
- timeout /t 2 /nobreak >nul
-
- echo.
- echo [4] 再次检查端口 %MYSQL_PORT%...
- netstat -ano | findstr ":%MYSQL_PORT%"
- if errorlevel 1 (
- echo [√] 端口 %MYSQL_PORT% 已完全释放
-
- REM 删除端口记录文件
- if exist "%PORT_FILE%" (
- del "%PORT_FILE%"
- echo [√] 已清理端口记录文件
- )
- ) else (
- echo [!] 仍有连接存在(可能是TIME_WAIT状态,会自动释放)
- )
-
-) else (
- echo [√] 没有发现占用端口 %MYSQL_PORT% 的进程
-
- REM 删除端口记录文件
- if exist "%PORT_FILE%" (
- del "%PORT_FILE%"
- echo [√] 已清理端口记录文件
- )
-)
-
-REM 清理临时文件
-if exist "%TEMP%\mysql_port.txt" del "%TEMP%\mysql_port.txt"
-
-echo.
-echo ==========================================
-echo 清理完成
-echo ==========================================
-echo.
-echo 说明:
-echo - 此脚本只清理 NPQS9100 应用使用的 MySQL 端口
-echo - 不会影响您电脑上的其他 MySQL 服务
-echo.
-pause
-
diff --git a/build/extraResources/mysql/reset-root-password.bat b/build/extraResources/mysql/reset-root-password.bat
deleted file mode 100644
index e36bdfe..0000000
--- a/build/extraResources/mysql/reset-root-password.bat
+++ /dev/null
@@ -1,66 +0,0 @@
-@echo off
-chcp 65001 >nul
-color 0B
-title Reset MySQL Root Password
-cls
-echo ==========================================
-echo Reset MySQL Root Password
-echo ==========================================
-echo.
-echo This script will reset root password and grant 127.0.0.1 access
-echo.
-echo IMPORTANT: Close any running MySQL windows first!
-echo.
-pause
-
-set MYSQL_HOME=%cd%
-set password=njcnpqs
-
-echo.
-echo [1] Stopping MySQL...
-taskkill /F /IM mysqld.exe >nul 2>&1
-timeout /t 2 >nul
-echo Done.
-
-echo.
-echo [2] Creating init file...
-(
-echo ALTER USER IF EXISTS 'root'@'localhost' IDENTIFIED BY '%password%';
-echo CREATE USER IF NOT EXISTS 'root'@'127.0.0.1' IDENTIFIED BY '%password%';
-echo GRANT ALL PRIVILEGES ON *.* TO 'root'@'127.0.0.1' WITH GRANT OPTION;
-echo CREATE USER IF NOT EXISTS 'root'@'%%' IDENTIFIED BY '%password%';
-echo GRANT ALL PRIVILEGES ON *.* TO 'root'@'%%' WITH GRANT OPTION;
-echo FLUSH PRIVILEGES;
-) > "%MYSQL_HOME%\reset-init.sql"
-echo Done.
-
-echo.
-echo [3] Starting MySQL with init-file...
-echo This will take about 30 seconds...
-echo.
-
-cd /d "%MYSQL_HOME%"
-"%MYSQL_HOME%\bin\mysqld.exe" --defaults-file="%MYSQL_HOME%\my.ini" --init-file="%MYSQL_HOME%\reset-init.sql" --console
-
-REM The above command runs in foreground and will exit when you press Ctrl+C
-
-echo.
-echo MySQL has stopped.
-echo.
-if exist "%MYSQL_HOME%\reset-init.sql" del "%MYSQL_HOME%\reset-init.sql"
-
-echo.
-echo ==========================================
-echo Password reset completed!
-echo ==========================================
-echo.
-echo Connection info:
-echo Host: 127.0.0.1
-echo Port: 3306
-echo User: root
-echo Password: %password%
-echo.
-echo Now you can run startup.bat to start MySQL normally
-echo.
-pause
-
diff --git a/build/icons/icon-original-backup.png b/build/icons/icon-original-backup.png
new file mode 100644
index 0000000..802a3e1
Binary files /dev/null and b/build/icons/icon-original-backup.png differ
diff --git a/build/icons/icon-square-256.png b/build/icons/icon-square-256.png
new file mode 100644
index 0000000..dd02cdb
Binary files /dev/null and b/build/icons/icon-square-256.png differ
diff --git a/build/icons/icon-square-512.png b/build/icons/icon-square-512.png
new file mode 100644
index 0000000..a9a59e4
Binary files /dev/null and b/build/icons/icon-square-512.png differ
diff --git a/build/remove-mysql-service.bat b/build/remove-mysql-service.bat
new file mode 100644
index 0000000..4775b5e
--- /dev/null
+++ b/build/remove-mysql-service.bat
@@ -0,0 +1,81 @@
+@echo off
+chcp 65001 >nul
+title 检查并清除 MySQL9100 服务
+color 0E
+
+echo ========================================
+echo 检查并清除 MySQL9100 服务
+echo ========================================
+echo.
+
+REM 检查是否有管理员权限
+net session >nul 2>&1
+if %errorlevel% neq 0 (
+ echo [错误] 需要管理员权限来操作 Windows 服务
+ echo.
+ echo 请右键点击此脚本,选择"以管理员身份运行"
+ echo.
+ pause
+ exit /b 1
+)
+
+echo [✓] 已具有管理员权限
+echo.
+
+REM 检查服务是否存在
+echo [1/4] 检查 mysql9100 服务是否存在...
+sc query mysql9100 >nul 2>&1
+if %errorlevel% equ 0 (
+ echo [✓] 发现 mysql9100 服务
+ echo.
+
+ REM 显示服务状态
+ echo [2/4] 服务状态信息:
+ sc query mysql9100
+ echo.
+
+ REM 停止服务
+ echo [3/4] 正在停止 mysql9100 服务...
+ sc stop mysql9100 >nul 2>&1
+ if %errorlevel% equ 0 (
+ echo [✓] 服务已停止
+ ) else (
+ echo [!] 服务可能已经停止或停止失败(继续删除)
+ )
+
+ REM 等待服务完全停止
+ timeout /t 2 /nobreak >nul
+ echo.
+
+ REM 删除服务
+ echo [4/4] 正在删除 mysql9100 服务...
+ sc delete mysql9100
+ if %errorlevel% equ 0 (
+ echo [✓] 服务已成功删除
+ echo.
+ echo ========================================
+ echo 清除完成!
+ echo ========================================
+ ) else (
+ echo [✗] 删除服务失败
+ echo.
+ echo 可能的原因:
+ echo 1. 服务仍在运行中(请重启电脑后重试)
+ echo 2. 权限不足
+ echo 3. 服务被其他程序锁定
+ echo.
+ pause
+ exit /b 1
+ )
+) else (
+ echo [!] 未发现 mysql9100 服务
+ echo.
+ echo 系统中没有名为 mysql9100 的服务,无需清除。
+)
+
+echo.
+echo 提示:如果需要完全清理,还可以:
+echo 1. 删除 MySQL 数据目录(mysql/data)
+echo 2. 删除 MySQL 配置文件(mysql/my.ini)
+echo.
+pause
diff --git a/build/rollback.bat b/build/rollback.bat
new file mode 100644
index 0000000..b164571
--- /dev/null
+++ b/build/rollback.bat
@@ -0,0 +1,143 @@
+@echo off
+chcp 65001 >nul
+echo ========================================
+echo NPQS9100 回滚工具
+echo ========================================
+echo.
+echo 【重要提示】
+echo 本工具用于回滚上次升级的内容
+echo 回滚后将恢复到升级前的状态
+echo.
+pause
+echo.
+
+echo [1/5] 停止 NPQS9100 进程...
+taskkill /F /IM NPQS9100.exe 2>nul
+if %errorlevel% equ 0 (
+ echo NPQS9100 已停止
+ timeout /t 2 /nobreak >nul
+) else (
+ echo NPQS9100 未运行
+)
+echo.
+
+echo [2/5] 检查备份文件...
+set hasBackup=0
+
+if exist backup\app.asar (
+ echo 发现前端备份(app.asar)
+ set hasBackup=1
+)
+
+if exist backup\app.asar.unpacked (
+ echo 发现前端备份(app.asar.unpacked)
+ set hasBackup=1
+)
+
+if exist backup\entrance.jar (
+ echo 发现后端备份
+ set hasBackup=1
+)
+
+if exist mysql\data_backup (
+ echo 发现数据库备份
+ set hasBackup=1
+)
+
+if %hasBackup%==0 (
+ echo 未发现任何备份文件!
+ echo 无法执行回滚操作
+ pause
+ exit /b 1
+)
+echo.
+
+echo [3/5] 回滚前端...
+set frontendRollback=0
+
+REM 回滚 app.asar
+if exist backup\app.asar (
+ echo 正在恢复 app.asar...
+ copy /Y backup\app.asar resources\app.asar >nul 2>&1
+ if %errorlevel% equ 0 (
+ echo app.asar 已回滚
+ set frontendRollback=1
+ ) else (
+ echo app.asar 回滚失败
+ pause
+ exit /b 1
+ )
+)
+
+REM 回滚 app.asar.unpacked
+if exist backup\app.asar.unpacked (
+ echo 正在恢复 app.asar.unpacked...
+ if exist resources\app.asar.unpacked (
+ rmdir /s /q resources\app.asar.unpacked 2>nul
+ )
+ xcopy backup\app.asar.unpacked resources\app.asar.unpacked\ /E /I /Y /Q >nul 2>&1
+ if %errorlevel% equ 0 (
+ echo app.asar.unpacked 已回滚
+ set frontendRollback=1
+ ) else (
+ echo app.asar.unpacked 回滚失败
+ pause
+ exit /b 1
+ )
+)
+
+if %frontendRollback%==0 (
+ echo 无前端备份,跳过
+)
+echo.
+
+echo [4/5] 回滚后端...
+if exist backup\entrance.jar (
+ echo 正在恢复 JAR 文件...
+ copy /Y backup\entrance.jar resources\extraResources\java\entrance.jar >nul 2>&1
+ if %errorlevel% equ 0 (
+ echo 后端已回滚
+ ) else (
+ echo 后端回滚失败
+ pause
+ exit /b 1
+ )
+) else (
+ echo 无后端备份,跳过
+)
+echo.
+
+echo [5/5] 回滚数据库...
+if exist mysql\data_backup (
+ echo 是否回滚数据库?(数据库回滚会丢失升级后的数据!)
+ echo [Y] 是 [N] 否
+ choice /C YN /N /M "请选择:"
+ if errorlevel 2 (
+ echo 已跳过数据库回滚
+ ) else (
+ echo 正在回滚数据库...
+ if exist mysql\data (
+ rmdir /s /q mysql\data 2>nul
+ )
+ xcopy mysql\data_backup mysql\data\ /E /I /Y /Q >nul 2>&1
+ if %errorlevel% equ 0 (
+ echo 数据库已回滚
+ ) else (
+ echo 数据库回滚失败
+ pause
+ exit /b 1
+ )
+ )
+) else (
+ echo 无数据库备份,跳过
+)
+echo.
+
+echo ========================================
+echo 回滚完成!
+echo ========================================
+echo.
+echo 您现在可以启动 NPQS9100 了
+echo.
+pause
+
diff --git a/build/upgrade.bat b/build/upgrade.bat
new file mode 100644
index 0000000..ebe79c4
--- /dev/null
+++ b/build/upgrade.bat
@@ -0,0 +1,227 @@
+@echo off
+chcp 65001 >nul
+echo ========================================
+echo NPQS9100 升级工具
+echo ========================================
+echo.
+
+REM 检查并创建 upgrade 目录
+if not exist upgrade (
+ mkdir upgrade
+ echo 【首次使用】已自动创建 upgrade 目录
+ echo.
+ echo 请将升级文件放入 upgrade 目录:
+ echo - app.asar (前端升级包 - 文件)
+ echo - app.asar.unpacked\ (前端升级包 - 文件夹)
+ echo - entrance.jar (后端升级包)
+ echo.
+ echo 放置完成后,重新运行本脚本即可升级
+ echo.
+ pause
+ exit /b 0
+)
+
+REM 检查是否有升级文件
+set hasUpgrade=0
+if exist upgrade\app.asar set hasUpgrade=1
+if exist upgrade\app.asar.unpacked set hasUpgrade=1
+if exist upgrade\entrance.jar set hasUpgrade=1
+
+if %hasUpgrade%==0 (
+ echo 【提示】upgrade 目录为空!
+ echo.
+ echo 请将升级文件放入 upgrade 目录:
+ echo - app.asar (前端升级包 - 文件)
+ echo - app.asar.unpacked\ (前端升级包 - 文件夹)
+ echo - entrance.jar (后端升级包)
+ echo.
+ echo 放置完成后,重新运行本脚本即可升级
+ echo.
+ pause
+ exit /b 0
+)
+
+echo 【检测到升级文件】
+if exist upgrade\app.asar echo - 前端升级(asar文件): upgrade\app.asar
+if exist upgrade\app.asar.unpacked echo - 前端升级(unpacked文件夹): upgrade\app.asar.unpacked\
+if exist upgrade\entrance.jar echo - 后端升级: upgrade\entrance.jar
+echo.
+echo 【重要提示】
+echo 1. 升级前会自动备份当前版本
+echo 2. 如升级失败可运行 rollback.bat 回滚
+echo 3. 数据库会自动备份到 mysql\data_backup\
+echo.
+pause
+echo.
+
+echo [1/6] 停止 NPQS9100 进程...
+taskkill /F /IM NPQS9100.exe 2>nul
+if %errorlevel% equ 0 (
+ echo NPQS9100 已停止
+ timeout /t 2 /nobreak >nul
+) else (
+ echo NPQS9100 未运行
+)
+echo.
+
+echo [2/6] 备份当前版本(用于回滚)...
+if not exist backup mkdir backup
+
+REM 备份前端(app.asar 和 app.asar.unpacked)
+if exist resources\app.asar (
+ echo 正在备份前端 app.asar...
+ if not exist backup mkdir backup
+ copy /Y resources\app.asar backup\app.asar >nul 2>&1
+ if %errorlevel% equ 0 (
+ echo app.asar 备份完成
+ ) else (
+ echo app.asar 备份失败
+ )
+)
+
+if exist resources\app.asar.unpacked (
+ echo 正在备份前端 app.asar.unpacked...
+ if exist backup\app.asar.unpacked (
+ rmdir /s /q backup\app.asar.unpacked 2>nul
+ )
+ xcopy resources\app.asar.unpacked backup\app.asar.unpacked\ /E /I /Y /Q >nul 2>&1
+ if %errorlevel% equ 0 (
+ echo app.asar.unpacked 备份完成
+ ) else (
+ echo app.asar.unpacked 备份失败
+ )
+)
+
+REM 备份后端
+if exist resources\extraResources\java\entrance.jar (
+ echo 正在备份后端...
+ copy /Y resources\extraResources\java\entrance.jar backup\entrance.jar >nul 2>&1
+ if %errorlevel% equ 0 (
+ echo 后端备份完成
+ ) else (
+ echo 后端备份失败
+ )
+)
+
+REM 备份数据库
+if exist mysql\data (
+ echo 正在备份数据库...
+ if exist mysql\data_backup (
+ rmdir /s /q mysql\data_backup 2>nul
+ )
+ xcopy mysql\data mysql\data_backup\ /E /I /Y /Q >nul 2>&1
+ if %errorlevel% equ 0 (
+ echo 数据库备份完成
+ ) else (
+ echo 数据库备份失败,请手动备份后继续
+ pause
+ exit /b 1
+ )
+)
+echo.
+
+echo [3/6] 记录版本信息...
+if not exist backup\version.txt (
+ echo 备份时间: %date% %time% > backup\version.txt
+ echo 升级前版本备份 >> backup\version.txt
+) else (
+ echo 上次备份时间: %date% %time% >> backup\version.txt
+)
+echo 版本信息已记录
+echo.
+
+echo [4/6] 升级前端...
+set frontendUpgraded=0
+
+REM 升级 app.asar
+if exist upgrade\app.asar (
+ echo 正在替换 app.asar...
+ copy /Y upgrade\app.asar resources\app.asar >nul 2>&1
+ if %errorlevel% equ 0 (
+ echo app.asar 升级完成
+ set frontendUpgraded=1
+ ) else (
+ echo app.asar 升级失败,正在回滚...
+ if exist backup\app.asar (
+ copy /Y backup\app.asar resources\app.asar >nul 2>&1
+ echo 已回滚到升级前版本
+ )
+ pause
+ exit /b 1
+ )
+)
+
+REM 升级 app.asar.unpacked
+if exist upgrade\app.asar.unpacked (
+ echo 正在替换 app.asar.unpacked...
+ if exist resources\app.asar.unpacked (
+ rmdir /s /q resources\app.asar.unpacked 2>nul
+ )
+ xcopy upgrade\app.asar.unpacked resources\app.asar.unpacked\ /E /I /Y /Q >nul 2>&1
+ if %errorlevel% equ 0 (
+ echo app.asar.unpacked 升级完成
+ set frontendUpgraded=1
+ ) else (
+ echo app.asar.unpacked 升级失败,正在回滚...
+ if exist backup\app.asar.unpacked (
+ rmdir /s /q resources\app.asar.unpacked 2>nul
+ xcopy backup\app.asar.unpacked resources\app.asar.unpacked\ /E /I /Y /Q >nul 2>&1
+ echo 已回滚到升级前版本
+ )
+ pause
+ exit /b 1
+ )
+)
+
+if %frontendUpgraded%==0 (
+ echo 无前端升级包,跳过
+)
+echo.
+
+echo [5/6] 升级后端...
+if exist upgrade\entrance.jar (
+ echo 正在替换 JAR 文件...
+ copy /Y upgrade\entrance.jar resources\extraResources\java\entrance.jar >nul 2>&1
+ if %errorlevel% equ 0 (
+ echo 后端升级完成
+ ) else (
+ echo 后端升级失败,正在回滚...
+ if exist backup\entrance.jar (
+ copy /Y backup\entrance.jar resources\extraResources\java\entrance.jar >nul 2>&1
+ echo 已回滚到升级前版本
+ )
+ pause
+ exit /b 1
+ )
+) else (
+ echo 无后端升级包,跳过
+)
+echo.
+
+echo [6/6] 记录升级日志...
+if not exist logs mkdir logs
+echo ========================================== >> logs\upgrade.log
+echo 升级时间: %date% %time% >> logs\upgrade.log
+if exist upgrade\dist (
+ echo 升级内容: 前端 >> logs\upgrade.log
+)
+if exist upgrade\entrance.jar (
+ echo 升级内容: 后端 >> logs\upgrade.log
+)
+echo ========================================== >> logs\upgrade.log
+echo 升级日志已记录
+echo.
+
+echo ========================================
+echo 升级完成!
+echo ========================================
+echo.
+echo 【提示】
+echo 1. 如需回滚,请运行 rollback.bat
+echo 2. 升级文件已使用,可删除 upgrade 目录
+echo.
+echo 您现在可以启动 NPQS9100 应用。
+echo.
+pause
+
+
diff --git a/doc/NPQS-9100绿色包完整指南.md b/doc/NPQS-9100绿色包完整指南.md
new file mode 100644
index 0000000..5a246ee
--- /dev/null
+++ b/doc/NPQS-9100绿色包完整指南.md
@@ -0,0 +1,874 @@
+# 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*
+*南京灿能电力自动化股份有限公司*
+
diff --git a/frontend/vite.config.ts.timestamp-1764211836744-b0e6c3d59bde5.mjs b/frontend/vite.config.ts.timestamp-1764211836744-b0e6c3d59bde5.mjs
new file mode 100644
index 0000000..a3460cf
--- /dev/null
+++ b/frontend/vite.config.ts.timestamp-1764211836744-b0e6c3d59bde5.mjs
@@ -0,0 +1,150 @@
+// vite.config.ts
+import { defineConfig, loadEnv } from "file:///C:/code/gitea/NPQS-9100/pqs-9100_client/frontend/node_modules/vite/dist/node/index.js";
+import { createSvgIconsPlugin } from "file:///C:/code/gitea/NPQS-9100/pqs-9100_client/frontend/node_modules/vite-plugin-svg-icons/dist/index.mjs";
+import vue from "file:///C:/code/gitea/NPQS-9100/pqs-9100_client/frontend/node_modules/@vitejs/plugin-vue/dist/index.mjs";
+import path from "path";
+
+// build/getEnv.ts
+function wrapperEnv(envConf) {
+ const ret = {};
+ for (const envName of Object.keys(envConf)) {
+ let realName = envConf[envName].replace(/\\n/g, "\n");
+ realName = realName === "true" ? true : realName === "false" ? false : realName;
+ if (envName === "VITE_PORT") realName = Number(realName);
+ if (envName === "VITE_PROXY") {
+ try {
+ realName = JSON.parse(realName);
+ } catch (error) {
+ }
+ }
+ ret[envName] = realName;
+ }
+ return ret;
+}
+
+// build/proxy.ts
+function createProxy(list = []) {
+ const ret = {};
+ for (const [prefix, target] of list) {
+ const httpsRE = /^https:\/\//;
+ const isHttps = httpsRE.test(target);
+ ret[prefix] = {
+ target,
+ changeOrigin: true,
+ ws: true,
+ rewrite: (path2) => path2.replace(new RegExp(`^${prefix}`), ""),
+ // https is require secure=false
+ ...isHttps ? { secure: false } : {}
+ };
+ }
+ return ret;
+}
+
+// vite.config.ts
+import vueJsx from "file:///C:/code/gitea/NPQS-9100/pqs-9100_client/frontend/node_modules/@vitejs/plugin-vue-jsx/dist/index.mjs";
+import AutoImport from "file:///C:/code/gitea/NPQS-9100/pqs-9100_client/frontend/node_modules/unplugin-auto-import/dist/vite.js";
+import Components from "file:///C:/code/gitea/NPQS-9100/pqs-9100_client/frontend/node_modules/unplugin-vue-components/dist/vite.js";
+import { ElementPlusResolver } from "file:///C:/code/gitea/NPQS-9100/pqs-9100_client/frontend/node_modules/unplugin-vue-components/dist/resolvers.js";
+import { nodePolyfills } from "file:///C:/code/gitea/NPQS-9100/pqs-9100_client/frontend/node_modules/vite-plugin-node-polyfills/dist/index.js";
+var __vite_injected_original_dirname = "C:\\code\\gitea\\NPQS-9100\\pqs-9100_client\\frontend";
+var vite_config_default = defineConfig(({ mode }) => {
+ const root = process.cwd();
+ const env = loadEnv(mode, root);
+ const viteEnv = wrapperEnv(env);
+ return {
+ plugins: [
+ vue(),
+ vueJsx(),
+ // svg图标配置,可以使用svg图标
+ createSvgIconsPlugin({
+ iconDirs: [path.resolve(process.cwd(), "src/assets/icons")],
+ symbolId: "icon-[dir]-[name]"
+ }),
+ AutoImport({
+ // 自动导入 Vue 相关函数,如:ref, reactive, toRef 等
+ imports: ["vue", "@vueuse/core", "pinia", "vue-router", "vue-i18n"],
+ resolvers: [
+ // 自动导入 Element Plus 相关函数,如:ElMessage, ElMessageBox... (带样式)
+ ElementPlusResolver({
+ importStyle: "sass"
+ })
+ ],
+ eslintrc: {
+ // 是否自动生成 eslint 规则,建议生成之后设置 false
+ enabled: false,
+ // 指定自动导入函数 eslint 规则的文件
+ filepath: "./.eslintrc-auto-import.json",
+ globalsPropValue: true
+ },
+ // 是否在 vue 模板中自动导入
+ vueTemplate: true,
+ // 指定自动导入函数TS类型声明文件路径 (false:关闭自动生成)
+ dts: false
+ // dts: "src/types/auto-imports.d.ts",
+ }),
+ Components({
+ resolvers: [
+ // 自动导入 Element Plus 组件
+ ElementPlusResolver({
+ importStyle: "sass"
+ })
+ ],
+ // 指定自定义组件位置(默认:src/components)
+ dirs: ["src/components", "src/**/components"],
+ // 指定自动导入组件TS类型声明文件路径 (false:关闭自动生成)
+ dts: false
+ // dts: "src/types/components.d.ts",
+ }),
+ nodePolyfills({
+ include: ["crypto"],
+ globals: {
+ crypto: true
+ }
+ })
+ ],
+ // 基础配置
+ base: viteEnv.VITE_PUBLIC_PATH,
+ root,
+ publicDir: "public",
+ resolve: {
+ alias: {
+ "@": path.resolve(__vite_injected_original_dirname, "src"),
+ "vue-i18n": "vue-i18n/dist/vue-i18n.cjs.js"
+ }
+ },
+ css: {
+ preprocessorOptions: {
+ scss: {
+ prependData: `@import "@/styles/var.scss";`,
+ api: "modern-compiler"
+ }
+ }
+ },
+ build: {
+ outDir: "dist",
+ assetsDir: "assets",
+ assetsInlineLimit: 4096,
+ cssCodeSplit: true,
+ sourcemap: false,
+ minify: "terser",
+ terserOptions: {
+ compress: {
+ // 生产环境去除console及debug
+ drop_console: false,
+ drop_debugger: true
+ }
+ }
+ },
+ server: {
+ host: "0.0.0.0",
+ port: viteEnv.VITE_PORT,
+ open: viteEnv.VITE_OPEN,
+ cors: true,
+ proxy: createProxy(viteEnv.VITE_PROXY)
+ }
+ };
+});
+export {
+ vite_config_default as default
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsidml0ZS5jb25maWcudHMiLCAiYnVpbGQvZ2V0RW52LnRzIiwgImJ1aWxkL3Byb3h5LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyJjb25zdCBfX3ZpdGVfaW5qZWN0ZWRfb3JpZ2luYWxfZGlybmFtZSA9IFwiQzpcXFxcY29kZVxcXFxnaXRlYVxcXFxOUFFTLTkxMDBcXFxccHFzLTkxMDBfY2xpZW50XFxcXGZyb250ZW5kXCI7Y29uc3QgX192aXRlX2luamVjdGVkX29yaWdpbmFsX2ZpbGVuYW1lID0gXCJDOlxcXFxjb2RlXFxcXGdpdGVhXFxcXE5QUVMtOTEwMFxcXFxwcXMtOTEwMF9jbGllbnRcXFxcZnJvbnRlbmRcXFxcdml0ZS5jb25maWcudHNcIjtjb25zdCBfX3ZpdGVfaW5qZWN0ZWRfb3JpZ2luYWxfaW1wb3J0X21ldGFfdXJsID0gXCJmaWxlOi8vL0M6L2NvZGUvZ2l0ZWEvTlBRUy05MTAwL3Bxcy05MTAwX2NsaWVudC9mcm9udGVuZC92aXRlLmNvbmZpZy50c1wiO2ltcG9ydCB7IENvbmZpZ0VudiwgZGVmaW5lQ29uZmlnLCBsb2FkRW52LCBVc2VyQ29uZmlnIH0gZnJvbSAndml0ZSdcclxuaW1wb3J0IHsgY3JlYXRlU3ZnSWNvbnNQbHVnaW4gfSBmcm9tICd2aXRlLXBsdWdpbi1zdmctaWNvbnMnXHJcbmltcG9ydCB2dWUgZnJvbSAnQHZpdGVqcy9wbHVnaW4tdnVlJ1xyXG5pbXBvcnQgcGF0aCBmcm9tICdwYXRoJ1xyXG4vLyBcdTU5MDRcdTc0MDZlbnZcdTczQUZcdTU4ODNcdTUzQzJcdTY1NzBcdThCRkJcdTUzRDZcclxuaW1wb3J0IHsgd3JhcHBlckVudiB9IGZyb20gJy4vYnVpbGQvZ2V0RW52J1xyXG5pbXBvcnQgeyBjcmVhdGVQcm94eSB9IGZyb20gJy4vYnVpbGQvcHJveHknXHJcbi8vIFx1NUJGQ1x1NTE2NVxyXG5pbXBvcnQgdnVlSnN4IGZyb20gJ0B2aXRlanMvcGx1Z2luLXZ1ZS1qc3gnXHJcbmltcG9ydCBBdXRvSW1wb3J0IGZyb20gJ3VucGx1Z2luLWF1dG8taW1wb3J0L3ZpdGUnXHJcbmltcG9ydCBDb21wb25lbnRzIGZyb20gJ3VucGx1Z2luLXZ1ZS1jb21wb25lbnRzL3ZpdGUnXHJcbmltcG9ydCB7IEVsZW1lbnRQbHVzUmVzb2x2ZXIgfSBmcm9tICd1bnBsdWdpbi12dWUtY29tcG9uZW50cy9yZXNvbHZlcnMnXHJcbmltcG9ydCB7IG5vZGVQb2x5ZmlsbHMgfSBmcm9tICd2aXRlLXBsdWdpbi1ub2RlLXBvbHlmaWxscydcclxuXHJcbmV4cG9ydCBkZWZhdWx0IGRlZmluZUNvbmZpZygoeyBtb2RlIH06IENvbmZpZ0Vudik6IFVzZXJDb25maWcgPT4ge1xyXG4gICAgY29uc3Qgcm9vdCA9IHByb2Nlc3MuY3dkKClcclxuICAgIGNvbnN0IGVudiA9IGxvYWRFbnYobW9kZSwgcm9vdClcclxuICAgIGNvbnN0IHZpdGVFbnYgPSB3cmFwcGVyRW52KGVudilcclxuICAgIHJldHVybiB7XHJcbiAgICAgICAgcGx1Z2luczogW1xyXG4gICAgICAgICAgICB2dWUoKSxcclxuICAgICAgICAgICAgdnVlSnN4KCksXHJcbiAgICAgICAgICAgIC8vIHN2Z1x1NTZGRVx1NjgwN1x1OTE0RFx1N0Y2RVx1RkYwQ1x1NTNFRlx1NEVFNVx1NEY3Rlx1NzUyOHN2Z1x1NTZGRVx1NjgwN1xyXG4gICAgICAgICAgICBjcmVhdGVTdmdJY29uc1BsdWdpbih7XHJcbiAgICAgICAgICAgICAgICBpY29uRGlyczogW3BhdGgucmVzb2x2ZShwcm9jZXNzLmN3ZCgpLCAnc3JjL2Fzc2V0cy9pY29ucycpXSxcclxuICAgICAgICAgICAgICAgIHN5bWJvbElkOiAnaWNvbi1bZGlyXS1bbmFtZV0nXHJcbiAgICAgICAgICAgIH0pLFxyXG4gICAgICAgICAgICBBdXRvSW1wb3J0KHtcclxuICAgICAgICAgICAgICAgIC8vIFx1ODFFQVx1NTJBOFx1NUJGQ1x1NTE2NSBWdWUgXHU3NkY4XHU1MTczXHU1MUZEXHU2NTcwXHVGRjBDXHU1OTgyXHVGRjFBcmVmLCByZWFjdGl2ZSwgdG9SZWYgXHU3QjQ5XHJcbiAgICAgICAgICAgICAgICBpbXBvcnRzOiBbJ3Z1ZScsICdAdnVldXNlL2NvcmUnLCAncGluaWEnLCAndnVlLXJvdXRlcicsICd2dWUtaTE4biddLFxyXG4gICAgICAgICAgICAgICAgcmVzb2x2ZXJzOiBbXHJcbiAgICAgICAgICAgICAgICAgICAgLy8gXHU4MUVBXHU1MkE4XHU1QkZDXHU1MTY1IEVsZW1lbnQgUGx1cyBcdTc2RjhcdTUxNzNcdTUxRkRcdTY1NzBcdUZGMENcdTU5ODJcdUZGMUFFbE1lc3NhZ2UsIEVsTWVzc2FnZUJveC4uLiAoXHU1RTI2XHU2ODM3XHU1RjBGKVxyXG4gICAgICAgICAgICAgICAgICAgIEVsZW1lbnRQbHVzUmVzb2x2ZXIoe1xyXG4gICAgICAgICAgICAgICAgICAgICAgICBpbXBvcnRTdHlsZTogJ3Nhc3MnXHJcbiAgICAgICAgICAgICAgICAgICAgfSlcclxuICAgICAgICAgICAgICAgIF0sXHJcbiAgICAgICAgICAgICAgICBlc2xpbnRyYzoge1xyXG4gICAgICAgICAgICAgICAgICAgIC8vIFx1NjYyRlx1NTQyNlx1ODFFQVx1NTJBOFx1NzUxRlx1NjIxMCBlc2xpbnQgXHU4OUM0XHU1MjE5XHVGRjBDXHU1RUZBXHU4QkFFXHU3NTFGXHU2MjEwXHU0RTRCXHU1NDBFXHU4QkJFXHU3RjZFIGZhbHNlXHJcbiAgICAgICAgICAgICAgICAgICAgZW5hYmxlZDogZmFsc2UsXHJcbiAgICAgICAgICAgICAgICAgICAgLy8gXHU2MzA3XHU1QjlBXHU4MUVBXHU1MkE4XHU1QkZDXHU1MTY1XHU1MUZEXHU2NTcwIGVzbGludCBcdTg5QzRcdTUyMTlcdTc2ODRcdTY1ODdcdTRFRjZcclxuICAgICAgICAgICAgICAgICAgICBmaWxlcGF0aDogJy4vLmVzbGludHJjLWF1dG8taW1wb3J0Lmpzb24nLFxyXG4gICAgICAgICAgICAgICAgICAgIGdsb2JhbHNQcm9wVmFsdWU6IHRydWVcclxuICAgICAgICAgICAgICAgIH0sXHJcbiAgICAgICAgICAgICAgICAvLyBcdTY2MkZcdTU0MjZcdTU3MjggdnVlIFx1NkEyMVx1Njc3Rlx1NEUyRFx1ODFFQVx1NTJBOFx1NUJGQ1x1NTE2NVxyXG4gICAgICAgICAgICAgICAgdnVlVGVtcGxhdGU6IHRydWUsXHJcbiAgICAgICAgICAgICAgICAvLyBcdTYzMDdcdTVCOUFcdTgxRUFcdTUyQThcdTVCRkNcdTUxNjVcdTUxRkRcdTY1NzBUU1x1N0M3Qlx1NTc4Qlx1NThGMFx1NjYwRVx1NjU4N1x1NEVGNlx1OERFRlx1NUY4NCAoZmFsc2U6XHU1MTczXHU5NUVEXHU4MUVBXHU1MkE4XHU3NTFGXHU2MjEwKVxyXG4gICAgICAgICAgICAgICAgZHRzOiBmYWxzZVxyXG4gICAgICAgICAgICAgICAgLy8gZHRzOiBcInNyYy90eXBlcy9hdXRvLWltcG9ydHMuZC50c1wiLFxyXG4gICAgICAgICAgICB9KSxcclxuICAgICAgICAgICAgQ29tcG9uZW50cyh7XHJcbiAgICAgICAgICAgICAgICByZXNvbHZlcnM6IFtcclxuICAgICAgICAgICAgICAgICAgICAvLyBcdTgxRUFcdTUyQThcdTVCRkNcdTUxNjUgRWxlbWVudCBQbHVzIFx1N0VDNFx1NEVGNlxyXG4gICAgICAgICAgICAgICAgICAgIEVsZW1lbnRQbHVzUmVzb2x2ZXIoe1xyXG4gICAgICAgICAgICAgICAgICAgICAgICBpbXBvcnRTdHlsZTogJ3Nhc3MnXHJcbiAgICAgICAgICAgICAgICAgICAgfSlcclxuICAgICAgICAgICAgICAgIF0sXHJcbiAgICAgICAgICAgICAgICAvLyBcdTYzMDdcdTVCOUFcdTgxRUFcdTVCOUFcdTRFNDlcdTdFQzRcdTRFRjZcdTRGNERcdTdGNkUoXHU5RUQ4XHU4QkE0OnNyYy9jb21wb25lbnRzKVxyXG4gICAgICAgICAgICAgICAgZGlyczogWydzcmMvY29tcG9uZW50cycsICdzcmMvKiovY29tcG9uZW50cyddLFxyXG4gICAgICAgICAgICAgICAgLy8gXHU2MzA3XHU1QjlBXHU4MUVBXHU1MkE4XHU1QkZDXHU1MTY1XHU3RUM0XHU0RUY2VFNcdTdDN0JcdTU3OEJcdTU4RjBcdTY2MEVcdTY1ODdcdTRFRjZcdThERUZcdTVGODQgKGZhbHNlOlx1NTE3M1x1OTVFRFx1ODFFQVx1NTJBOFx1NzUxRlx1NjIxMClcclxuICAgICAgICAgICAgICAgIGR0czogZmFsc2VcclxuICAgICAgICAgICAgICAgIC8vIGR0czogXCJzcmMvdHlwZXMvY29tcG9uZW50cy5kLnRzXCIsXHJcbiAgICAgICAgICAgIH0pLFxyXG4gICAgICAgICAgICBub2RlUG9seWZpbGxzKHtcclxuICAgICAgICAgICAgICAgIGluY2x1ZGU6IFsnY3J5cHRvJ10sXHJcbiAgICAgICAgICAgICAgICBnbG9iYWxzOiB7XHJcbiAgICAgICAgICAgICAgICAgICAgY3J5cHRvOiB0cnVlXHJcbiAgICAgICAgICAgICAgICB9XHJcbiAgICAgICAgICAgIH0pXHJcbiAgICAgICAgXSxcclxuICAgICAgICAvLyBcdTU3RkFcdTc4NDBcdTkxNERcdTdGNkVcclxuICAgICAgICBiYXNlOiB2aXRlRW52LlZJVEVfUFVCTElDX1BBVEgsXHJcbiAgICAgICAgcm9vdCxcclxuICAgICAgICBwdWJsaWNEaXI6ICdwdWJsaWMnLFxyXG4gICAgICAgIHJlc29sdmU6IHtcclxuICAgICAgICAgICAgYWxpYXM6IHtcclxuICAgICAgICAgICAgICAgICdAJzogcGF0aC5yZXNvbHZlKF9fZGlybmFtZSwgJ3NyYycpLFxyXG4gICAgICAgICAgICAgICAgJ3Z1ZS1pMThuJzogJ3Z1ZS1pMThuL2Rpc3QvdnVlLWkxOG4uY2pzLmpzJ1xyXG4gICAgICAgICAgICB9XHJcbiAgICAgICAgfSxcclxuICAgICAgICBjc3M6IHtcclxuICAgICAgICAgICAgcHJlcHJvY2Vzc29yT3B0aW9uczoge1xyXG4gICAgICAgICAgICAgICAgc2Nzczoge1xyXG4gICAgICAgICAgICAgICAgICAgIHByZXBlbmREYXRhOiBgQGltcG9ydCBcIkAvc3R5bGVzL3Zhci5zY3NzXCI7YCxcclxuICAgICAgICAgICAgICAgICAgICBhcGk6ICdtb2Rlcm4tY29tcGlsZXInXHJcbiAgICAgICAgICAgICAgICB9XHJcbiAgICAgICAgICAgIH1cclxuICAgICAgICB9LFxyXG4gICAgICAgIGJ1aWxkOiB7XHJcbiAgICAgICAgICAgIG91dERpcjogJ2Rpc3QnLFxyXG4gICAgICAgICAgICBhc3NldHNEaXI6ICdhc3NldHMnLFxyXG4gICAgICAgICAgICBhc3NldHNJbmxpbmVMaW1pdDogNDA5NixcclxuICAgICAgICAgICAgY3NzQ29kZVNwbGl0OiB0cnVlLFxyXG4gICAgICAgICAgICBzb3VyY2VtYXA6IGZhbHNlLFxyXG4gICAgICAgICAgICBtaW5pZnk6ICd0ZXJzZXInLFxyXG4gICAgICAgICAgICB0ZXJzZXJPcHRpb25zOiB7XHJcbiAgICAgICAgICAgICAgICBjb21wcmVzczoge1xyXG4gICAgICAgICAgICAgICAgICAgIC8vIFx1NzUxRlx1NEVBN1x1NzNBRlx1NTg4M1x1NTNCQlx1OTY2NGNvbnNvbGVcdTUzQ0FkZWJ1Z1xyXG4gICAgICAgICAgICAgICAgICAgIGRyb3BfY29uc29sZTogZmFsc2UsXHJcbiAgICAgICAgICAgICAgICAgICAgZHJvcF9kZWJ1Z2dlcjogdHJ1ZVxyXG4gICAgICAgICAgICAgICAgfVxyXG4gICAgICAgICAgICB9XHJcbiAgICAgICAgfSxcclxuICAgICAgICBzZXJ2ZXI6IHtcclxuICAgICAgICAgICAgaG9zdDogJzAuMC4wLjAnLFxyXG4gICAgICAgICAgICBwb3J0OiB2aXRlRW52LlZJVEVfUE9SVCxcclxuICAgICAgICAgICAgb3Blbjogdml0ZUVudi5WSVRFX09QRU4sXHJcbiAgICAgICAgICAgIGNvcnM6IHRydWUsXHJcbiAgICAgICAgICAgIHByb3h5OiBjcmVhdGVQcm94eSh2aXRlRW52LlZJVEVfUFJPWFkpXHJcbiAgICAgICAgfVxyXG4gICAgfVxyXG59KVxyXG4iLCAiY29uc3QgX192aXRlX2luamVjdGVkX29yaWdpbmFsX2Rpcm5hbWUgPSBcIkM6XFxcXGNvZGVcXFxcZ2l0ZWFcXFxcTlBRUy05MTAwXFxcXHBxcy05MTAwX2NsaWVudFxcXFxmcm9udGVuZFxcXFxidWlsZFwiO2NvbnN0IF9fdml0ZV9pbmplY3RlZF9vcmlnaW5hbF9maWxlbmFtZSA9IFwiQzpcXFxcY29kZVxcXFxnaXRlYVxcXFxOUFFTLTkxMDBcXFxccHFzLTkxMDBfY2xpZW50XFxcXGZyb250ZW5kXFxcXGJ1aWxkXFxcXGdldEVudi50c1wiO2NvbnN0IF9fdml0ZV9pbmplY3RlZF9vcmlnaW5hbF9pbXBvcnRfbWV0YV91cmwgPSBcImZpbGU6Ly8vQzovY29kZS9naXRlYS9OUFFTLTkxMDAvcHFzLTkxMDBfY2xpZW50L2Zyb250ZW5kL2J1aWxkL2dldEVudi50c1wiO2ltcG9ydCBwYXRoIGZyb20gXCJwYXRoXCI7XHJcblxyXG5leHBvcnQgZnVuY3Rpb24gaXNEZXZGbihtb2RlOiBzdHJpbmcpOiBib29sZWFuIHtcclxuICByZXR1cm4gbW9kZSA9PT0gXCJkZXZlbG9wbWVudFwiO1xyXG59XHJcblxyXG5leHBvcnQgZnVuY3Rpb24gaXNQcm9kRm4obW9kZTogc3RyaW5nKTogYm9vbGVhbiB7XHJcbiAgcmV0dXJuIG1vZGUgPT09IFwicHJvZHVjdGlvblwiO1xyXG59XHJcblxyXG5leHBvcnQgZnVuY3Rpb24gaXNUZXN0Rm4obW9kZTogc3RyaW5nKTogYm9vbGVhbiB7XHJcbiAgcmV0dXJuIG1vZGUgPT09IFwidGVzdFwiO1xyXG59XHJcblxyXG4vKipcclxuICogV2hldGhlciB0byBnZW5lcmF0ZSBwYWNrYWdlIHByZXZpZXdcclxuICovXHJcbmV4cG9ydCBmdW5jdGlvbiBpc1JlcG9ydE1vZGUoKTogYm9vbGVhbiB7XHJcbiAgcmV0dXJuIHByb2Nlc3MuZW52LlZJVEVfUkVQT1JUID09PSBcInRydWVcIjtcclxufVxyXG5cclxuLy8gUmVhZCBhbGwgZW52aXJvbm1lbnQgdmFyaWFibGUgY29uZmlndXJhdGlvbiBmaWxlcyB0byBwcm9jZXNzLmVudlxyXG5leHBvcnQgZnVuY3Rpb24gd3JhcHBlckVudihlbnZDb25mOiBSZWNvcmRhYmxlKTogVml0ZUVudiB7XHJcbiAgY29uc3QgcmV0OiBhbnkgPSB7fTtcclxuXHJcbiAgZm9yIChjb25zdCBlbnZOYW1lIG9mIE9iamVjdC5rZXlzKGVudkNvbmYpKSB7XHJcbiAgICBsZXQgcmVhbE5hbWUgPSBlbnZDb25mW2Vudk5hbWVdLnJlcGxhY2UoL1xcXFxuL2csIFwiXFxuXCIpO1xyXG4gICAgcmVhbE5hbWUgPSByZWFsTmFtZSA9PT0gXCJ0cnVlXCIgPyB0cnVlIDogcmVhbE5hbWUgPT09IFwiZmFsc2VcIiA/IGZhbHNlIDogcmVhbE5hbWU7XHJcbiAgICBpZiAoZW52TmFtZSA9PT0gXCJWSVRFX1BPUlRcIikgcmVhbE5hbWUgPSBOdW1iZXIocmVhbE5hbWUpO1xyXG4gICAgaWYgKGVudk5hbWUgPT09IFwiVklURV9QUk9YWVwiKSB7XHJcbiAgICAgIHRyeSB7XHJcbiAgICAgICAgcmVhbE5hbWUgPSBKU09OLnBhcnNlKHJlYWxOYW1lKTtcclxuICAgICAgfSBjYXRjaCAoZXJyb3IpIHt9XHJcbiAgICB9XHJcbiAgICByZXRbZW52TmFtZV0gPSByZWFsTmFtZTtcclxuICB9XHJcbiAgcmV0dXJuIHJldDtcclxufVxyXG5cclxuLyoqXHJcbiAqIEdldCB1c2VyIHJvb3QgZGlyZWN0b3J5XHJcbiAqIEBwYXJhbSBkaXIgZmlsZSBwYXRoXHJcbiAqL1xyXG5leHBvcnQgZnVuY3Rpb24gZ2V0Um9vdFBhdGgoLi4uZGlyOiBzdHJpbmdbXSkge1xyXG4gIHJldHVybiBwYXRoLnJlc29sdmUocHJvY2Vzcy5jd2QoKSwgLi4uZGlyKTtcclxufVxyXG4iLCAiY29uc3QgX192aXRlX2luamVjdGVkX29yaWdpbmFsX2Rpcm5hbWUgPSBcIkM6XFxcXGNvZGVcXFxcZ2l0ZWFcXFxcTlBRUy05MTAwXFxcXHBxcy05MTAwX2NsaWVudFxcXFxmcm9udGVuZFxcXFxidWlsZFwiO2NvbnN0IF9fdml0ZV9pbmplY3RlZF9vcmlnaW5hbF9maWxlbmFtZSA9IFwiQzpcXFxcY29kZVxcXFxnaXRlYVxcXFxOUFFTLTkxMDBcXFxccHFzLTkxMDBfY2xpZW50XFxcXGZyb250ZW5kXFxcXGJ1aWxkXFxcXHByb3h5LnRzXCI7Y29uc3QgX192aXRlX2luamVjdGVkX29yaWdpbmFsX2ltcG9ydF9tZXRhX3VybCA9IFwiZmlsZTovLy9DOi9jb2RlL2dpdGVhL05QUVMtOTEwMC9wcXMtOTEwMF9jbGllbnQvZnJvbnRlbmQvYnVpbGQvcHJveHkudHNcIjtpbXBvcnQgdHlwZSB7IFByb3h5T3B0aW9ucyB9IGZyb20gXCJ2aXRlXCI7XHJcblxyXG50eXBlIFByb3h5SXRlbSA9IFtzdHJpbmcsIHN0cmluZ107XHJcblxyXG50eXBlIFByb3h5TGlzdCA9IFByb3h5SXRlbVtdO1xyXG5cclxudHlwZSBQcm94eVRhcmdldExpc3QgPSBSZWNvcmQ8c3RyaW5nLCBQcm94eU9wdGlvbnM+O1xyXG5cclxuLyoqXHJcbiAqIFx1NTIxQlx1NUVGQVx1NEVFM1x1NzQwNlx1RkYwQ1x1NzUyOFx1NEU4RVx1ODlFM1x1Njc5MCAuZW52LmRldmVsb3BtZW50IFx1NEVFM1x1NzQwNlx1OTE0RFx1N0Y2RVxyXG4gKiBAcGFyYW0gbGlzdFxyXG4gKi9cclxuZXhwb3J0IGZ1bmN0aW9uIGNyZWF0ZVByb3h5KGxpc3Q6IFByb3h5TGlzdCA9IFtdKSB7XHJcbiAgY29uc3QgcmV0OiBQcm94eVRhcmdldExpc3QgPSB7fTtcclxuICBmb3IgKGNvbnN0IFtwcmVmaXgsIHRhcmdldF0gb2YgbGlzdCkge1xyXG4gICAgY29uc3QgaHR0cHNSRSA9IC9eaHR0cHM6XFwvXFwvLztcclxuICAgIGNvbnN0IGlzSHR0cHMgPSBodHRwc1JFLnRlc3QodGFyZ2V0KTtcclxuXHJcbiAgICAvLyBodHRwczovL2dpdGh1Yi5jb20vaHR0cC1wYXJ0eS9ub2RlLWh0dHAtcHJveHkjb3B0aW9uc1xyXG4gICAgcmV0W3ByZWZpeF0gPSB7XHJcbiAgICAgIHRhcmdldDogdGFyZ2V0LFxyXG4gICAgICBjaGFuZ2VPcmlnaW46IHRydWUsXHJcbiAgICAgIHdzOiB0cnVlLFxyXG4gICAgICByZXdyaXRlOiBwYXRoID0+IHBhdGgucmVwbGFjZShuZXcgUmVnRXhwKGBeJHtwcmVmaXh9YCksIFwiXCIpLFxyXG4gICAgICAvLyBodHRwcyBpcyByZXF1aXJlIHNlY3VyZT1mYWxzZVxyXG4gICAgICAuLi4oaXNIdHRwcyA/IHsgc2VjdXJlOiBmYWxzZSB9IDoge30pXHJcbiAgICB9O1xyXG4gIH1cclxuICByZXR1cm4gcmV0O1xyXG59XHJcbiJdLAogICJtYXBwaW5ncyI6ICI7QUFBOFUsU0FBb0IsY0FBYyxlQUEyQjtBQUMzWSxTQUFTLDRCQUE0QjtBQUNyQyxPQUFPLFNBQVM7QUFDaEIsT0FBTyxVQUFVOzs7QUNtQlYsU0FBUyxXQUFXLFNBQThCO0FBQ3ZELFFBQU0sTUFBVyxDQUFDO0FBRWxCLGFBQVcsV0FBVyxPQUFPLEtBQUssT0FBTyxHQUFHO0FBQzFDLFFBQUksV0FBVyxRQUFRLE9BQU8sRUFBRSxRQUFRLFFBQVEsSUFBSTtBQUNwRCxlQUFXLGFBQWEsU0FBUyxPQUFPLGFBQWEsVUFBVSxRQUFRO0FBQ3ZFLFFBQUksWUFBWSxZQUFhLFlBQVcsT0FBTyxRQUFRO0FBQ3ZELFFBQUksWUFBWSxjQUFjO0FBQzVCLFVBQUk7QUFDRixtQkFBVyxLQUFLLE1BQU0sUUFBUTtBQUFBLE1BQ2hDLFNBQVMsT0FBTztBQUFBLE1BQUM7QUFBQSxJQUNuQjtBQUNBLFFBQUksT0FBTyxJQUFJO0FBQUEsRUFDakI7QUFDQSxTQUFPO0FBQ1Q7OztBQ3pCTyxTQUFTLFlBQVksT0FBa0IsQ0FBQyxHQUFHO0FBQ2hELFFBQU0sTUFBdUIsQ0FBQztBQUM5QixhQUFXLENBQUMsUUFBUSxNQUFNLEtBQUssTUFBTTtBQUNuQyxVQUFNLFVBQVU7QUFDaEIsVUFBTSxVQUFVLFFBQVEsS0FBSyxNQUFNO0FBR25DLFFBQUksTUFBTSxJQUFJO0FBQUEsTUFDWjtBQUFBLE1BQ0EsY0FBYztBQUFBLE1BQ2QsSUFBSTtBQUFBLE1BQ0osU0FBUyxDQUFBQSxVQUFRQSxNQUFLLFFBQVEsSUFBSSxPQUFPLElBQUksTUFBTSxFQUFFLEdBQUcsRUFBRTtBQUFBO0FBQUEsTUFFMUQsR0FBSSxVQUFVLEVBQUUsUUFBUSxNQUFNLElBQUksQ0FBQztBQUFBLElBQ3JDO0FBQUEsRUFDRjtBQUNBLFNBQU87QUFDVDs7O0FGckJBLE9BQU8sWUFBWTtBQUNuQixPQUFPLGdCQUFnQjtBQUN2QixPQUFPLGdCQUFnQjtBQUN2QixTQUFTLDJCQUEyQjtBQUNwQyxTQUFTLHFCQUFxQjtBQVo5QixJQUFNLG1DQUFtQztBQWN6QyxJQUFPLHNCQUFRLGFBQWEsQ0FBQyxFQUFFLEtBQUssTUFBNkI7QUFDN0QsUUFBTSxPQUFPLFFBQVEsSUFBSTtBQUN6QixRQUFNLE1BQU0sUUFBUSxNQUFNLElBQUk7QUFDOUIsUUFBTSxVQUFVLFdBQVcsR0FBRztBQUM5QixTQUFPO0FBQUEsSUFDSCxTQUFTO0FBQUEsTUFDTCxJQUFJO0FBQUEsTUFDSixPQUFPO0FBQUE7QUFBQSxNQUVQLHFCQUFxQjtBQUFBLFFBQ2pCLFVBQVUsQ0FBQyxLQUFLLFFBQVEsUUFBUSxJQUFJLEdBQUcsa0JBQWtCLENBQUM7QUFBQSxRQUMxRCxVQUFVO0FBQUEsTUFDZCxDQUFDO0FBQUEsTUFDRCxXQUFXO0FBQUE7QUFBQSxRQUVQLFNBQVMsQ0FBQyxPQUFPLGdCQUFnQixTQUFTLGNBQWMsVUFBVTtBQUFBLFFBQ2xFLFdBQVc7QUFBQTtBQUFBLFVBRVAsb0JBQW9CO0FBQUEsWUFDaEIsYUFBYTtBQUFBLFVBQ2pCLENBQUM7QUFBQSxRQUNMO0FBQUEsUUFDQSxVQUFVO0FBQUE7QUFBQSxVQUVOLFNBQVM7QUFBQTtBQUFBLFVBRVQsVUFBVTtBQUFBLFVBQ1Ysa0JBQWtCO0FBQUEsUUFDdEI7QUFBQTtBQUFBLFFBRUEsYUFBYTtBQUFBO0FBQUEsUUFFYixLQUFLO0FBQUE7QUFBQSxNQUVULENBQUM7QUFBQSxNQUNELFdBQVc7QUFBQSxRQUNQLFdBQVc7QUFBQTtBQUFBLFVBRVAsb0JBQW9CO0FBQUEsWUFDaEIsYUFBYTtBQUFBLFVBQ2pCLENBQUM7QUFBQSxRQUNMO0FBQUE7QUFBQSxRQUVBLE1BQU0sQ0FBQyxrQkFBa0IsbUJBQW1CO0FBQUE7QUFBQSxRQUU1QyxLQUFLO0FBQUE7QUFBQSxNQUVULENBQUM7QUFBQSxNQUNELGNBQWM7QUFBQSxRQUNWLFNBQVMsQ0FBQyxRQUFRO0FBQUEsUUFDbEIsU0FBUztBQUFBLFVBQ0wsUUFBUTtBQUFBLFFBQ1o7QUFBQSxNQUNKLENBQUM7QUFBQSxJQUNMO0FBQUE7QUFBQSxJQUVBLE1BQU0sUUFBUTtBQUFBLElBQ2Q7QUFBQSxJQUNBLFdBQVc7QUFBQSxJQUNYLFNBQVM7QUFBQSxNQUNMLE9BQU87QUFBQSxRQUNILEtBQUssS0FBSyxRQUFRLGtDQUFXLEtBQUs7QUFBQSxRQUNsQyxZQUFZO0FBQUEsTUFDaEI7QUFBQSxJQUNKO0FBQUEsSUFDQSxLQUFLO0FBQUEsTUFDRCxxQkFBcUI7QUFBQSxRQUNqQixNQUFNO0FBQUEsVUFDRixhQUFhO0FBQUEsVUFDYixLQUFLO0FBQUEsUUFDVDtBQUFBLE1BQ0o7QUFBQSxJQUNKO0FBQUEsSUFDQSxPQUFPO0FBQUEsTUFDSCxRQUFRO0FBQUEsTUFDUixXQUFXO0FBQUEsTUFDWCxtQkFBbUI7QUFBQSxNQUNuQixjQUFjO0FBQUEsTUFDZCxXQUFXO0FBQUEsTUFDWCxRQUFRO0FBQUEsTUFDUixlQUFlO0FBQUEsUUFDWCxVQUFVO0FBQUE7QUFBQSxVQUVOLGNBQWM7QUFBQSxVQUNkLGVBQWU7QUFBQSxRQUNuQjtBQUFBLE1BQ0o7QUFBQSxJQUNKO0FBQUEsSUFDQSxRQUFRO0FBQUEsTUFDSixNQUFNO0FBQUEsTUFDTixNQUFNLFFBQVE7QUFBQSxNQUNkLE1BQU0sUUFBUTtBQUFBLE1BQ2QsTUFBTTtBQUFBLE1BQ04sT0FBTyxZQUFZLFFBQVEsVUFBVTtBQUFBLElBQ3pDO0FBQUEsRUFDSjtBQUNKLENBQUM7IiwKICAibmFtZXMiOiBbInBhdGgiXQp9Cg==
diff --git a/public/images/icon.png b/public/images/icon.png
new file mode 100644
index 0000000..dd02cdb
Binary files /dev/null and b/public/images/icon.png differ
diff --git a/scripts/mysql-service-manager.js b/scripts/mysql-service-manager.js
new file mode 100644
index 0000000..3d45fe3
--- /dev/null
+++ b/scripts/mysql-service-manager.js
@@ -0,0 +1,680 @@
+const { spawn, exec } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+/**
+ * MySQL Windows 服务管理器
+ * 将MySQL安装为Windows服务 mysql9100,持久运行
+ */
+class MySQLServiceManager {
+ constructor(logWindowManager = null) {
+ const isDev = !process.resourcesPath;
+ const baseDir = isDev
+ ? path.join(__dirname, '..')
+ : path.dirname(process.resourcesPath);
+
+ this.mysqlPath = path.join(baseDir, 'mysql');
+ this.binPath = path.join(this.mysqlPath, 'bin');
+ this.dataPath = path.join(this.mysqlPath, 'data');
+ this.serviceName = 'mysql9100';
+ this.configFile = path.join(this.mysqlPath, 'my.ini'); // 使用标准的 my.ini
+ this.logWindowManager = logWindowManager; // 用于输出日志到文件
+ }
+
+ // 睡眠函数
+ sleep(ms) {
+ return new Promise(resolve => setTimeout(resolve, ms));
+ }
+
+ // 日志输出辅助方法
+ log(type, message) {
+ console.log(`[MySQL Service] ${message}`);
+ if (this.logWindowManager) {
+ this.logWindowManager.addLog(type, `[MySQL] ${message}`);
+ }
+ }
+
+ /**
+ * 执行命令并返回Promise
+ */
+ execCommand(command) {
+ return new Promise((resolve, reject) => {
+ exec(command, { encoding: 'utf8' }, (error, stdout, stderr) => {
+ if (error) {
+ // 创建标准 Error 对象,确保有 message 属性
+ const err = new Error(error.message || stderr || stdout || 'Command execution failed');
+ err.code = error.code;
+ err.stdout = stdout;
+ err.stderr = stderr;
+ err.command = command;
+ err.originalError = error;
+ reject(err);
+ } else {
+ resolve({ stdout, stderr });
+ }
+ });
+ });
+ }
+
+ /**
+ * 检查服务是否存在
+ */
+ async checkServiceExists() {
+ try {
+ const { stdout } = await this.execCommand(`sc query ${this.serviceName}`);
+ return stdout.includes('SERVICE_NAME');
+ } catch (error) {
+ return false;
+ }
+ }
+
+ /**
+ * 获取服务状态
+ * @returns {string} 'RUNNING' | 'STOPPED' | 'NOT_EXISTS'
+ */
+ async getServiceStatus() {
+ try {
+ const { stdout } = await this.execCommand(`sc query ${this.serviceName}`);
+
+ if (stdout.includes('RUNNING')) {
+ return 'RUNNING';
+ } else if (stdout.includes('STOPPED')) {
+ return 'STOPPED';
+ } else {
+ return 'UNKNOWN';
+ }
+ } catch (error) {
+ return 'NOT_EXISTS';
+ }
+ }
+
+ /**
+ * 检查服务路径是否匹配当前环境
+ * @returns {Promise} true=路径匹配,false=路径不匹配
+ */
+ async checkServicePath() {
+ try {
+ const { stdout } = await this.execCommand(`sc qc ${this.serviceName}`);
+
+ // 从输出中提取 BINARY_PATH_NAME
+ const match = stdout.match(/BINARY_PATH_NAME\s*:\s*(.+)/i);
+ if (!match) {
+ return false;
+ }
+
+ const binaryPath = match[1].trim();
+ const expectedPath = path.join(this.binPath, 'mysqld.exe');
+
+ // 检查路径是否包含当前的 MySQL 目录
+ const pathMatches = binaryPath.toLowerCase().includes(this.mysqlPath.toLowerCase());
+
+ this.log('system', `服务路径检查:`);
+ this.log('system', ` 当前环境: ${this.mysqlPath}`);
+ this.log('system', ` 服务路径: ${binaryPath}`);
+ this.log('system', ` 路径匹配: ${pathMatches ? '是' : '否'}`);
+
+ return pathMatches;
+ } catch (error) {
+ this.log('warn', `检查服务路径失败: ${error.message}`);
+ return false;
+ }
+ }
+
+ /**
+ * 读取配置文件中的端口
+ */
+ readPortFromConfig() {
+ try {
+ if (fs.existsSync(this.configFile)) {
+ const content = fs.readFileSync(this.configFile, 'utf-8');
+ const match = content.match(/port\s*=\s*(\d+)/);
+ return match ? parseInt(match[1]) : 3306;
+ }
+ } catch (error) {
+ console.error('[MySQL Service] Failed to read port from config:', error);
+ }
+ return 3306;
+ }
+
+ /**
+ * 生成 my.ini 配置文件
+ */
+ generateMyIni(port) {
+ const basedir = this.mysqlPath.replace(/\\/g, '/');
+ const datadir = this.dataPath.replace(/\\/g, '/');
+
+ const config = `[mysqld]
+# 基础路径配置
+basedir=${basedir}
+datadir=${datadir}
+
+# 网络配置
+port=${port}
+bind-address=0.0.0.0
+
+# 字符集配置
+character-set-server=utf8mb4
+collation-server=utf8mb4_unicode_ci
+
+# 性能优化
+max_connections=200
+innodb_buffer_pool_size=128M
+innodb_log_file_size=64M
+
+# 日志配置
+log_error=${basedir}/mysql_error.log
+slow_query_log=1
+slow_query_log_file=${basedir}/mysql_slow.log
+long_query_time=2
+
+# 安全配置
+sql_mode=STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION
+
+[client]
+default-character-set=utf8mb4
+`;
+
+ fs.writeFileSync(this.configFile, config, 'utf-8');
+ console.log('[MySQL Service] Generated my.ini for port:', port);
+ }
+
+ /**
+ * 初始化数据库
+ */
+ async initializeDatabase() {
+ return new Promise((resolve, reject) => {
+ console.log('[MySQL Service] Initializing MySQL database...');
+
+ const mysqld = path.join(this.binPath, 'mysqld.exe');
+ const initProcess = spawn(mysqld, [
+ '--defaults-file=' + this.configFile,
+ '--initialize-insecure'
+ ], {
+ cwd: this.mysqlPath,
+ stdio: 'inherit'
+ });
+
+ initProcess.on('close', (code) => {
+ if (code === 0) {
+ console.log('[MySQL Service] Database initialized successfully');
+ resolve();
+ } else {
+ reject(new Error(`Database initialization failed with code ${code}`));
+ }
+ });
+ });
+ }
+
+ /**
+ * 安装MySQL服务
+ */
+ async installService() {
+ try {
+ const mysqld = path.join(this.binPath, 'mysqld.exe');
+
+ // 使用绝对路径和完整参数,避免环境变量干扰
+ // 关键:使用 --defaults-file 的绝对路径,确保不会读取系统 MySQL 的配置
+ const absoluteConfigPath = path.resolve(this.configFile);
+ const absoluteMysqldPath = path.resolve(mysqld);
+
+ // 构建完全隔离的安装命令
+ const command = `"${absoluteMysqldPath}" --install ${this.serviceName} --defaults-file="${absoluteConfigPath}"`;
+
+ this.log('system', `准备安装服务: ${this.serviceName}`);
+ this.log('system', `MySQL可执行文件: ${absoluteMysqldPath}`);
+ this.log('system', `配置文件: ${absoluteConfigPath}`);
+
+ // 检查文件是否存在
+ if (!fs.existsSync(mysqld)) {
+ throw new Error(`mysqld.exe not found at: ${mysqld}`);
+ }
+ if (!fs.existsSync(this.configFile)) {
+ throw new Error(`Config file not found at: ${this.configFile}`);
+ }
+
+ // 在安装前清理环境变量(避免继承系统 MySQL 的环境变量)
+ const cleanEnv = { ...process.env };
+ delete cleanEnv.MYSQL_HOME;
+ delete cleanEnv.MYSQL_TCP_PORT;
+
+ // 使用 spawn 代替 exec,更好地控制环境
+ const { spawn } = require('child_process');
+
+ await new Promise((resolve, reject) => {
+ const installProcess = spawn(absoluteMysqldPath, [
+ '--install',
+ this.serviceName,
+ `--defaults-file=${absoluteConfigPath}`
+ ], {
+ env: cleanEnv,
+ cwd: this.mysqlPath,
+ stdio: 'pipe'
+ });
+
+ let stdout = '';
+ let stderr = '';
+
+ if (installProcess.stdout) {
+ installProcess.stdout.on('data', (data) => {
+ stdout += data.toString();
+ });
+ }
+
+ if (installProcess.stderr) {
+ installProcess.stderr.on('data', (data) => {
+ stderr += data.toString();
+ });
+ }
+
+ installProcess.on('close', (code) => {
+ if (code === 0) {
+ this.log('system', '服务安装命令执行成功');
+ if (stdout) this.log('system', `输出: ${stdout}`);
+ resolve();
+ } else {
+ const errorMsg = stderr || stdout || `Exit code: ${code}`;
+ this.log('error', `安装命令失败: ${errorMsg}`);
+ reject(new Error(errorMsg));
+ }
+ });
+
+ installProcess.on('error', (err) => {
+ this.log('error', `进程启动失败: ${err.message}`);
+ reject(err);
+ });
+ });
+
+ return true;
+ } catch (error) {
+ console.error('[MySQL Service] Failed to install service:', error);
+ this.log('error', `服务安装失败: ${error.message}`);
+ throw new Error(`Failed to install MySQL service: ${error.message}. Please run as administrator.`);
+ }
+ }
+
+ /**
+ * 检查是否有其他MySQL服务
+ */
+ async checkOtherMySQLServices() {
+ try {
+ const { stdout } = await this.execCommand('sc query type= service state= all | findstr /i "mysql"');
+ const services = [];
+ const lines = stdout.split('\n');
+ for (const line of lines) {
+ const match = line.match(/SERVICE_NAME:\s*(\S+)/);
+ if (match && match[1] !== this.serviceName) {
+ services.push(match[1]);
+ }
+ }
+ return services;
+ } catch (error) {
+ // 如果没找到任何MySQL服务,命令会失败,这是正常的
+ return [];
+ }
+ }
+
+ /**
+ * 启动服务
+ */
+ async startService() {
+ try {
+ console.log('[MySQL Service] Starting service...');
+ await this.execCommand(`net start ${this.serviceName}`);
+ console.log('[MySQL Service] Service started successfully');
+
+ // 等待MySQL完全启动
+ await new Promise(resolve => setTimeout(resolve, 2000));
+ return true;
+ } catch (error) {
+ console.error('[MySQL Service] Failed to start service:', error);
+ console.error('[MySQL Service] This may be due to invalid service configuration');
+ throw error;
+ }
+ }
+
+ /**
+ * 停止服务
+ */
+ async stopService() {
+ try {
+ console.log('[MySQL Service] Stopping service...');
+ await this.execCommand(`net stop ${this.serviceName}`);
+ console.log('[MySQL Service] Service stopped successfully');
+ return true;
+ } catch (error) {
+ console.error('[MySQL Service] Failed to stop service:', error);
+ // 停止失败不抛异常,因为可能服务本来就是停止状态
+ return false;
+ }
+ }
+
+ /**
+ * 删除服务
+ */
+ async removeService() {
+ try {
+ // 先尝试停止服务(如果正在运行)
+ try {
+ await this.stopService();
+ } catch (e) {
+ // 服务可能已经停止,忽略错误
+ console.log('[MySQL Service] Service already stopped or not running');
+ }
+
+ // 删除服务
+ await this.execCommand(`sc delete ${this.serviceName}`);
+ console.log('[MySQL Service] Service removed successfully');
+
+ // 等待服务完全删除
+ await new Promise(resolve => setTimeout(resolve, 1000));
+ return true;
+ } catch (error) {
+ console.error('[MySQL Service] Failed to remove service:', error);
+ // 即使删除失败也返回 true,因为可能服务本来就不存在
+ return true;
+ }
+ }
+
+ /**
+ * 更新服务端口
+ * 需要停止服务、修改配置、重启服务
+ */
+ async updateServicePort(newPort) {
+ console.log('[MySQL Service] Updating service port to:', newPort);
+
+ // 1. 停止服务
+ await this.stopService();
+
+ // 2. 更新配置文件
+ this.generateMyIni(newPort);
+
+ // 3. 启动服务
+ await this.startService();
+
+ console.log('[MySQL Service] Port updated successfully');
+ }
+
+ /**
+ * 检查数据库是否已初始化
+ */
+ isDatabaseInitialized() {
+ return fs.existsSync(this.dataPath) && fs.readdirSync(this.dataPath).length > 0;
+ }
+
+ /**
+ * 清空数据库目录(重新初始化时使用)
+ */
+ clearDatabase() {
+ console.log('[MySQL Service] Clearing database directory...');
+ if (fs.existsSync(this.dataPath)) {
+ // 递归删除目录
+ const rimraf = (dir) => {
+ if (fs.existsSync(dir)) {
+ fs.readdirSync(dir).forEach((file) => {
+ const curPath = path.join(dir, file);
+ if (fs.lstatSync(curPath).isDirectory()) {
+ rimraf(curPath);
+ } else {
+ fs.unlinkSync(curPath);
+ }
+ });
+ fs.rmdirSync(dir);
+ }
+ };
+ rimraf(this.dataPath);
+ }
+ // 重新创建空目录
+ fs.mkdirSync(this.dataPath, { recursive: true });
+ console.log('[MySQL Service] Database directory cleared');
+ }
+
+ /**
+ * 主流程:确保MySQL服务运行
+ * @param {function} findAvailablePort - 查找可用端口的函数
+ * @param {function} waitForPort - 等待端口就绪的函数
+ * @returns {Promise} 返回MySQL运行的端口
+ */
+ async ensureServiceRunning(findAvailablePort, waitForPort) {
+ this.log('system', '开始MySQL服务检查流程');
+ this.log('system', `MySQL路径: ${this.mysqlPath}`);
+ this.log('system', `配置文件: ${this.configFile}`);
+
+ const serviceStatus = await this.getServiceStatus();
+ this.log('system', `服务状态: ${serviceStatus}`);
+
+ // 如果服务存在,检查路径是否匹配
+ if (serviceStatus !== 'NOT_EXISTS') {
+ const pathMatches = await this.checkServicePath();
+
+ if (!pathMatches) {
+ this.log('warn', '检测到服务路径与当前环境不匹配');
+ this.log('warn', '这可能是从其他环境(开发/打包)安装的旧服务');
+ this.log('system', '正在删除旧服务并重新安装...');
+
+ // 删除旧服务
+ await this.removeService();
+
+ // 重置状态,后续将按新安装流程处理
+ this.log('system', '旧服务已删除,准备重新安装');
+ // 继续执行下面的 NOT_EXISTS 流程
+ }
+ }
+
+ // 重新获取服务状态(如果删除了旧服务,状态会变为 NOT_EXISTS)
+ const currentStatus = await this.getServiceStatus();
+
+ if (currentStatus === 'NOT_EXISTS') {
+ // ========== 服务不存在,全新安装 ==========
+ this.log('system', '服务不存在,开始安装流程');
+
+ // 0. 检查是否有其他MySQL服务(仅作提示,不影响安装)
+ const otherServices = await this.checkOtherMySQLServices();
+ if (otherServices.length > 0) {
+ this.log('system', `检测到系统中有其他MySQL服务: ${otherServices.join(', ')}`);
+ this.log('system', 'mysql9100 将使用独立的配置和端口,不会冲突');
+ }
+
+ // 1. 查找可用端口
+ const port = await findAvailablePort(3306, 100);
+ this.log('system', `找到可用端口: ${port}`);
+
+ // 2. 检查数据库是否已初始化
+ if (!this.isDatabaseInitialized()) {
+ // 数据库未初始化,正常初始化流程
+ this.log('system', '数据库未初始化,开始初始化...');
+ this.generateMyIni(port);
+ await this.initializeDatabase();
+ } else {
+ // 数据库已存在(可能是从其他机器拷贝过来的)
+ this.log('system', '检测到已有数据库目录');
+
+ // 无论端口是什么,都使用现有数据库,只修改配置文件
+ if (port !== 3306) {
+ this.log('system', `端口3306被占用,将使用端口${port}`);
+ this.log('system', '保留现有数据库,仅更新端口配置');
+ } else {
+ this.log('system', '端口3306可用,使用现有数据库');
+ }
+
+ // 只生成新配置,不删除数据
+ this.generateMyIni(port);
+ }
+
+ // 3. 安装服务
+ this.log('system', '开始安装MySQL服务...');
+ await this.installService();
+
+ // 3.1 验证服务是否真的安装成功
+ await this.sleep(2000); // 等待2秒让服务注册完成
+ const verifyStatus = await this.getServiceStatus();
+ if (verifyStatus === 'NOT_EXISTS') {
+ this.log('error', '服务安装失败:服务未创建');
+ this.log('error', '可能的原因:');
+ this.log('error', '1. 权限不足(请确保以管理员身份运行)');
+ this.log('error', '2. MySQL可执行文件损坏');
+ this.log('error', '3. 配置文件路径有误');
+
+ // 检查是否有其他MySQL服务
+ const otherServices = await this.checkOtherMySQLServices();
+ if (otherServices.length > 0) {
+ this.log('system', `提示:系统中存在其他MySQL服务 ${otherServices.join(', ')}`);
+ this.log('system', '如果问题持续,请查看文档:doc/MySQL服务冲突处理方案.md');
+ }
+
+ throw new Error('MySQL服务安装失败,请检查管理员权限和日志');
+ }
+ this.log('success', '服务安装成功,已验证');
+
+ // 3.2 设置服务为开机自启
+ this.log('system', '正在配置服务为开机自启...');
+ try {
+ await this.execCommand(`sc config ${this.serviceName} start= auto`);
+ this.log('success', '服务已配置为开机自启');
+
+ // 验证配置是否生效
+ const { stdout: qcOutput } = await this.execCommand(`sc qc ${this.serviceName}`);
+ if (qcOutput.includes('AUTO_START')) {
+ this.log('success', '开机自启配置验证成功');
+ } else {
+ this.log('warn', '开机自启配置可能未生效,请手动检查');
+ }
+ } catch (error) {
+ this.log('warn', `设置开机自启失败: ${error.message}`);
+ this.log('warn', '服务已安装,但需要手动设置启动类型');
+ }
+
+ // 4. 启动服务
+ this.log('system', '开始启动MySQL服务...');
+ await this.startService();
+
+ const finalPort = this.readPortFromConfig();
+ this.log('success', `MySQL服务安装并启动成功,端口: ${finalPort}`);
+
+ // 4. 等待端口就绪
+ await waitForPort(finalPort, 30000);
+
+ return finalPort;
+ }
+ else if (currentStatus === 'STOPPED') {
+ // ========== 服务存在但停止,尝试启动 ==========
+ this.log('system', '服务已停止,尝试启动...');
+
+ try {
+ // 先读取配置端口
+ const configPort = this.readPortFromConfig();
+
+ // 重新生成配置文件,确保使用绝对路径(修复相对路径问题)
+ this.log('system', '更新配置文件,确保路径正确...');
+ this.generateMyIni(configPort);
+
+ // 尝试启动服务
+ await this.startService();
+
+ this.log('success', `服务启动成功,端口: ${configPort}`);
+
+ // 等待端口就绪
+ await waitForPort(configPort, 30000);
+
+ return configPort;
+ } catch (startError) {
+ // 启动失败,先诊断问题
+ this.log('error', '服务启动失败');
+ this.log('system', `失败原因: ${startError.message}`);
+
+ // 检查是否是端口被占用导致的启动失败
+ const configPort = this.readPortFromConfig();
+ this.log('system', `配置的端口: ${configPort}`);
+
+ // 检查端口是否被占用
+ const PortChecker = require('./port-checker');
+ const portAvailable = await PortChecker.findAvailablePort(configPort, 1) === configPort;
+
+ if (!portAvailable) {
+ // 端口被占用,需要更换端口并重新安装
+ this.log('warn', `端口${configPort}已被占用,尝试重新配置服务`);
+
+ // 1. 删除旧服务
+ this.log('system', '正在删除旧服务...');
+ await this.removeService();
+
+ // 2. 查找可用端口
+ const port = await findAvailablePort(3306, 100);
+ this.log('system', `找到可用端口: ${port}`);
+
+ // 3. 保留现有数据库,只更新配置
+ if (this.isDatabaseInitialized()) {
+ this.log('system', '保留现有数据库,更新端口配置');
+ this.generateMyIni(port);
+ } else {
+ this.log('system', '数据库未初始化,开始初始化...');
+ this.generateMyIni(port);
+ await this.initializeDatabase();
+ }
+
+ // 4. 重新安装服务
+ this.log('system', '开始重新安装MySQL服务...');
+ await this.installService();
+
+ // 4.1 设置开机自启
+ this.log('system', '正在配置服务为开机自启...');
+ try {
+ await this.execCommand(`sc config ${this.serviceName} start= auto`);
+ this.log('success', '服务已配置为开机自启');
+ } catch (error) {
+ this.log('warn', `设置开机自启失败: ${error.message}`);
+ }
+
+ // 5. 启动服务
+ this.log('system', '开始启动MySQL服务...');
+ await this.startService();
+
+ const finalPort = this.readPortFromConfig();
+ this.log('success', `MySQL服务重新安装并启动成功,端口: ${finalPort}`);
+
+ // 6. 等待端口就绪
+ await waitForPort(finalPort, 30000);
+
+ return finalPort;
+ } else {
+ // 端口没被占用,但服务启动失败,可能是配置问题或权限问题
+ this.log('error', '服务启动失败,但端口未被占用');
+ this.log('error', '可能的原因:');
+ this.log('error', '1. 配置文件路径错误或损坏');
+ this.log('error', '2. 数据库文件损坏');
+ this.log('error', '3. 权限不足');
+ this.log('error', '4. MySQL可执行文件问题');
+ this.log('system', '建议:检查日志文件 mysql/mysql_error.log');
+
+ throw new Error(`MySQL服务启动失败: ${startError.message}。请检查配置和日志。`);
+ }
+ }
+ }
+ else if (currentStatus === 'RUNNING') {
+ // ========== 服务正在运行 ==========
+ const configPort = this.readPortFromConfig();
+ this.log('success', `MySQL服务已在运行,端口: ${configPort}`);
+
+ // 验证端口是否真的在监听
+ const PortChecker = require('./port-checker');
+ const portReady = await PortChecker.checkPort(configPort);
+
+ if (!portReady) {
+ this.log('warn', '服务运行中但端口未就绪,重新启动...');
+
+ // 重新生成配置文件
+ this.generateMyIni(configPort);
+
+ await this.stopService();
+ await this.startService();
+ await waitForPort(configPort, 30000);
+ }
+
+ return configPort;
+ }
+
+ throw new Error('Unknown service status: ' + currentStatus);
+ }
+}
+
+module.exports = MySQLServiceManager;
+