feat: 重构更新流程 — 无更新不抛异常、用户决定下载、更新详情展示（md文件中的）

【核心重构】 - getLatestVersion() 不再 throw Error，无更新时返回 { version: APP_VERSION } - checkForUpdates() 先自行预检 → 无更新直发 IPC，有更新才交 electron-updater - 移除 NO_UPDATE_MESSAGE 常量及所有字符串匹配拦截代码 - HeiXiuProvider 增加 500ms TTL 缓存，避免预检+electron-updater 重复请求 API 【用户体验】 - 检查到新版本后不再自动下载，展示更新内容供用户决定 - 新增"下载更新"按钮（与"安装更新"分离为两步操作） - 设置页新增"查看详情"弹窗，Markdown 格式化渲染更新日志 - available / downloading / downloaded 三个状态 UI 独立展示【Bug 修复】 - 测试服务器版本排序：字符串序 → 语义版本序（_version_key），0.0.10 正确 > 0.0.9 - 版本比较：!= → <（_version_key），防止高版本误判为有更新 - get_best_release fallback 同样改为语义版本排序 - Windows cmd set 命令尾部空格 → Invalid URL（.trim() 修复） - electron-updater 'error' 事件中拦截 NO_UPDATE_MESSAGE → UPDATE_NOT_AVAILABLE 【文档更新】 - CHANGELOG.md、PROJECT.md、UpdateA.md 同步更新架构图和流程说明
2026-06-04 18:31:52 +08:00
parent b55c2fdd2e
commit 6204c14b88
37 changed files with 1908 additions and 648 deletions
--- a/package-lock.json
+++ b/package-lock.json
@@ -10,6 +10,7 @@
         "dependencies": {
            "antd": "^6.4.3",
            "axios": "^1.16.1",
+            "electron-updater": "^6.8.3",
            "react": "^19.2.7",
            "react-dom": "^19.2.7",
            "react-router-dom": "^7.16.0"
@@ -3362,7 +3363,6 @@
         "version": "2.0.1",
         "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz",
         "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==",
-         "dev": true,
         "license": "Python-2.0"
      },
      "node_modules/assert-plus": {
@@ -3660,7 +3660,6 @@
         "version": "9.5.1",
         "resolved": "https://registry.npmjs.org/builder-util-runtime/-/builder-util-runtime-9.5.1.tgz",
         "integrity": "sha512-qt41tMfgHTllhResqM5DcnHyDIWNgzHvuY2jDcYP9iaGpkWxTUzV6GQjDeLnlR1/DtdlcsWQbA7sByMpmJFTLQ==",
-         "dev": true,
         "license": "MIT",
         "dependencies": {
            "debug": "^4.3.4",
@@ -4433,6 +4432,34 @@
         "dev": true,
         "license": "ISC"
      },
+      "node_modules/electron-updater": {
+         "version": "6.8.3",
+         "resolved": "https://registry.npmjs.org/electron-updater/-/electron-updater-6.8.3.tgz",
+         "integrity": "sha512-Z6sgw3jgbikWKXei1ENdqFOxBP0WlXg3TtKfz0rgw2vIZFJUyI4pD7ZN7jrkm7EoMK+tcm/qTnPUdqfZukBlBQ==",
+         "license": "MIT",
+         "dependencies": {
+            "builder-util-runtime": "9.5.1",
+            "fs-extra": "^10.1.0",
+            "js-yaml": "^4.1.0",
+            "lazy-val": "^1.0.5",
+            "lodash.escaperegexp": "^4.1.2",
+            "lodash.isequal": "^4.5.0",
+            "semver": "~7.7.3",
+            "tiny-typed-emitter": "^2.1.0"
+         }
+      },
+      "node_modules/electron-updater/node_modules/semver": {
+         "version": "7.7.4",
+         "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.4.tgz",
+         "integrity": "sha512-vFKC2IEtQnVhpT78h1Yp8wzwrf8CM+MzKMHGJZfBtzhZNycRFnXsHk6E5TxIkkMsgNS7mdX3AGB7x2QM2di4lA==",
+         "license": "ISC",
+         "bin": {
+            "semver": "bin/semver.js"
+         },
+         "engines": {
+            "node": ">=10"
+         }
+      },
      "node_modules/electron-winstaller": {
         "version": "5.4.0",
         "resolved": "https://registry.npmjs.org/electron-winstaller/-/electron-winstaller-5.4.0.tgz",
@@ -5090,7 +5117,6 @@
         "version": "10.1.0",
         "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-10.1.0.tgz",
         "integrity": "sha512-oRXApq54ETRj4eMiFzGnHWGy+zo5raudjuxN0b8H7s/RU2oW0Wvsx9O0ACRN/kRq9E8Vu/ReskGB5o3ji+FzHQ==",
-         "dev": true,
         "license": "MIT",
         "dependencies": {
            "graceful-fs": "^4.2.0",
@@ -5105,7 +5131,6 @@
         "version": "6.2.1",
         "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-6.2.1.tgz",
         "integrity": "sha512-zwOTdL3rFQ/lRdBnntKVOX6k5cKJwEc1HdilT71BWEu7J41gXIB2MRp+vxduPSwZJPWBxEzv4yH1wYLJGUHX4Q==",
-         "dev": true,
         "license": "MIT",
         "dependencies": {
            "universalify": "^2.0.0"
@@ -5118,7 +5143,6 @@
         "version": "2.0.1",
         "resolved": "https://registry.npmjs.org/universalify/-/universalify-2.0.1.tgz",
         "integrity": "sha512-gptHNQghINnc/vTGIk0SOFGFNXw7JVrlRUtConJRlvaw6DuX0wO5Jeko9sWrMBhh+PsYAZ7oXAiOnf/UKogyiw==",
-         "dev": true,
         "license": "MIT",
         "engines": {
            "node": ">= 10.0.0"
@@ -5379,7 +5403,6 @@
         "version": "4.2.11",
         "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz",
         "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==",
-         "dev": true,
         "license": "ISC"
      },
      "node_modules/has-flag": {
@@ -5781,7 +5804,6 @@
         "version": "4.2.0",
         "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.2.0.tgz",
         "integrity": "sha512-ePWsvanv0DWuDRsW8dnt+R4jQ31SCRCQ7hhNcPXZPsoBZiemuZNYGf7adZdqX2D86j6rvKp3RpCxVTSb8WQlOw==",
-         "dev": true,
         "funding": [
            {
               "type": "github",
@@ -5888,7 +5910,6 @@
         "version": "1.0.5",
         "resolved": "https://registry.npmjs.org/lazy-val/-/lazy-val-1.0.5.tgz",
         "integrity": "sha512-0/BnGCCfyUMkBpeDgWihanIAF9JmZhHBgUhEqzvf+adhNGLoP6TaiI5oF8oyb3I45P+PcnrqihSf01M0l0G5+Q==",
-         "dev": true,
         "license": "MIT"
      },
      "node_modules/levn": {
@@ -6219,6 +6240,19 @@
         "dev": true,
         "license": "MIT"
      },
+      "node_modules/lodash.escaperegexp": {
+         "version": "4.1.2",
+         "resolved": "https://registry.npmjs.org/lodash.escaperegexp/-/lodash.escaperegexp-4.1.2.tgz",
+         "integrity": "sha512-TM9YBvyC84ZxE3rgfefxUWiQKLilstD6k7PTGt6wfbtXF8ixIJLOL3VYyV/z+ZiPLsVxAsKAFVwWlWeb2Y8Yyw==",
+         "license": "MIT"
+      },
+      "node_modules/lodash.isequal": {
+         "version": "4.5.0",
+         "resolved": "https://registry.npmjs.org/lodash.isequal/-/lodash.isequal-4.5.0.tgz",
+         "integrity": "sha512-pDo3lu8Jhfjqls6GkMgpahsF9kCyayhgykjyLMNFTKWrpVdAQtYyB4muAMWozBB4ig/dtWAmsMxLEI8wuz+DYQ==",
+         "deprecated": "This package is deprecated. Use require('node:util').isDeepStrictEqual instead.",
+         "license": "MIT"
+      },
      "node_modules/lowercase-keys": {
         "version": "2.0.0",
         "resolved": "https://registry.npmjs.org/lowercase-keys/-/lowercase-keys-2.0.0.tgz",
@@ -7425,7 +7459,6 @@
         "version": "1.6.0",
         "resolved": "https://registry.npmjs.org/sax/-/sax-1.6.0.tgz",
         "integrity": "sha512-6R3J5M4AcbtLUdZmRv2SygeVaM7IhrLXu9BmnOGmmACak8fiUtOsYNWUS4uK7upbmHIBbLBeFeI//477BKLBzA==",
-         "dev": true,
         "license": "BlueOak-1.0.0",
         "engines": {
            "node": ">=11.0.0"
@@ -7808,6 +7841,12 @@
            "semver": "bin/semver"
         }
      },
+      "node_modules/tiny-typed-emitter": {
+         "version": "2.1.0",
+         "resolved": "https://registry.npmjs.org/tiny-typed-emitter/-/tiny-typed-emitter-2.1.0.tgz",
+         "integrity": "sha512-qVtvMxeXbVej0cQWKqVSSAHmKZEHAvxdF8HEUBFWts8h+xEo5m/lEiPakuyZ3BnCBjOD8i24kzNOiOLLgsSxhA==",
+         "license": "MIT"
+      },
      "node_modules/tinyglobby": {
         "version": "0.2.17",
         "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.17.tgz",