绿色包保存

.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": []
+  }
+}

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
+)
+

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
+========================================
+

build/app.manifest

@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
+  <assemblyIdentity
+    version="1.0.0.0"
+    processorArchitecture="*"
+    name="NPQS9100"
+    type="win32"
+  />
+  <description>NPQS-9100自动检测平台</description>
+  <trustInfo xmlns="urn:schemas-microsoft-com:asm.v3">
+    <security>
+      <requestedPrivileges>
+        <requestedExecutionLevel level="requireAdministrator" uiAccess="false"/>
+      </requestedPrivileges>
+    </security>
+  </trustInfo>
+  <compatibility xmlns="urn:schemas-microsoft-com:compatibility.v1">
+    <application>
+      <!-- Windows 10 and Windows 11 -->
+      <supportedOS Id="{8e0f7a12-bfb3-4fe8-b9a5-48fd50a15a9a}"/>
+      <!-- Windows 8.1 -->
+      <supportedOS Id="{1f676c76-80e1-4239-95bb-83d0f6d0da78}"/>
+      <!-- Windows 8 -->
+      <supportedOS Id="{4a2f28e3-53b9-4441-ba9c-d69d4a4a6e38}"/>
+      <!-- Windows 7 -->
+      <supportedOS Id="{35138b9a-5d96-4fbd-8e2d-a2440225f93a}"/>
+    </application>
+  </compatibility>
+</assembly>

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
+

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

build/extraResources/mysql/README.txt

@@ -1,85 +1,33 @@
 ==========================================
-  NPQS9100 MySQL 免安装版使用说明
+  NPQS9100 MySQL 数据库
 ==========================================
 
-一、快速开始
+目录说明
 ----------------------------------------
-1. 启动 MySQL:
+bin/        - MySQL 可执行文件
-   双击运行: startup.bat
+data/       - 数据库数据目录
-   (注意：不要关闭窗口，关闭会停止MySQL)
+share/      - 共享资源文件
-
+my.ini      - MySQL 配置文件
-2. 首次使用，如需重置密码和权限:
-   双击运行: reset-root-password.bat
-
-3. 停止 MySQL:
-   双击运行: stop.bat
 
 
-二、连接信息
+服务管理
 ----------------------------------------
-主机: 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
 ==========================================
-

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
+

build/extraResources/mysql/kill-running-port.bat

@@ -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
-

build/extraResources/mysql/reset-root-password.bat

@@ -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
-

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

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
+

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
+
+

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*  
+*南京灿能电力自动化股份有限公司*
+

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<boolean>} 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<number>} 返回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;
+