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