[🔁 Chore] Auto upload release for workflow

[✨ Feat] {#21} Add AppBar window oper icons
1. [+] {#21} 增加了应用栏 (顶栏) 上的窗口操作按钮 2. [-] 删掉了几个调试时留下的 console.debug
2026-06-20 23:14:28 +08:00 · 2025-06-14 16:51:28 +08:00 · 2025-06-14 16:07:10 +08:00 · 2025-06-13 22:26:36 +08:00 · 2025-06-13 16:24:10 +08:00 · 2025-06-13 12:12:46 +08:00
24 changed files with 1077 additions and 195 deletions
--- a/.github/workflows/pack.yml
+++ b/.github/workflows/pack.yml
@@ -7,6 +7,8 @@ on:
    branches: [dev, stable, main, master]
  workflow_dispatch:

+permissions: write-all
+
 jobs:
  pack:
    name: Patch & Pack
@@ -123,6 +125,30 @@ jobs:
          echo "[DEBUG] Files in <Working DIR>/Artifacts directory:"
          ls -la Artifacts/

+      - name: Get short commit hash
+        run: |
+          cd ./HugoAura-Code
+          SHORT_HASH=$(git rev-parse --short=7 HEAD)
+          echo "SHORT_HASH=$SHORT_HASH" >> $GITHUB_ENV
+
+      - name: Create release content
+        run: |
+          cat > rel_msg.txt << EOF
+          ## 这是 HugoAura 的 CI 自动构建版本
+
+          ### 版本类型: 🔁 自动构建版
+
+          ### 版本号: `vAutoBuild-${{ env.SHORT_HASH }}`
+
+          ### 对应 Commit: [`${{ env.SHORT_HASH }}`](https://github.com/HugoAura/Seewo-HugoAura/commit/${{ env.GITHUB_SHA }})
+
+          ---
+
+          ### ⚠ 注意: CI 自动构建版本可能不稳定 / 存在较多 Bug, 更新时请留意
+
+          **🕘 构建时间: ${{ env.BUILDTIME }}**
+          EOF
+
      - name: Upload patched ASAR
        uses: actions/upload-artifact@v4
        with:
@@ -134,3 +160,16 @@ jobs:
        with:
          name: aura-code
          path: Artifacts/aura.zip
+
+      - name: Upload release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: vAutoBuild
+          name: "[CI] HugoAura Auto Build Release"
+          body_path: rel_msg.txt
+          prerelease: true
+          generate_release_notes: false
+          token: ${{ secrets.GITHUB_TOKEN }}
+          file: |
+            Artifacts/app-patched.asar
+            Artifacts/aura.zip
--- a/src/aura/init/main/ipcHandler.js
+++ b/src/aura/init/main/ipcHandler.js
@@ -64,15 +64,19 @@ const buildIpcMain = (electron) => {
    } else {
      const isWindowValid = global.__HUGO_AURA__.hookedWindows.has(windowKey);
      if (!isWindowValid) {
-        throw new Error(
-          `[HugoAura / Main / IPC / ERROR] Unknown windowKey: ${windowKey}`
+        console.warn(
+          `[HugoAura / Main / IPC / WARN] Unknown windowKey: ${windowKey}, window may not have started yet.`
        );
+        return {
+          success: false,
+        };
      }

      sendDataToWebContents(windowKey, channel, data);
    }
  };

+  const { applyBaseIpcHandler } = require("./ipcModules/baseIpcHandler");
  const { applyConfigIpcHandler } = require("./ipcModules/configIpcHandler");
  const { applyFsIpcHandler } = require("./ipcModules/fsIpcHandler");
  const { applyPlsIpcHandler } = require("./ipcModules/plsIpcHandler");
@@ -82,6 +86,7 @@ const buildIpcMain = (electron) => {
    app.exit(0);
  });

+  applyBaseIpcHandler(ipcMain);
  applyConfigIpcHandler(ipcMain);
  applyFsIpcHandler(ipcMain);
  applyPlsIpcHandler(ipcMain);
--- a/src/aura/init/main/ipcModules/baseIpcHandler.js
+++ b/src/aura/init/main/ipcModules/baseIpcHandler.js
@@ -0,0 +1,59 @@
+// @ts-check
+
+const { BrowserWindow } = require("electron");
+
+const composables = {
+  getBrowserWindowInstance: (windowKey) => {
+    if (!global.__HUGO_AURA__.hookedWindows) return null;
+    const hookedWindowIns = global.__HUGO_AURA__.hookedWindows.get(windowKey);
+    if (!hookedWindowIns) return undefined;
+    const browserWindowIns = BrowserWindow.fromWebContents(
+      hookedWindowIns.webContents
+    );
+    return browserWindowIns;
+  },
+};
+
+/**
+ *
+ * @param {import("electron").IpcMain} ipcMain
+ */
+const applyBaseIpcHandler = (ipcMain) => {
+  const methodBase = "$aura.base";
+
+  ipcMain.on(
+    `${methodBase}.minimizeWindow`,
+    /**
+     *
+     * @param {import("electron").IpcMainEvent} _event
+     * @param {{ targetWindowKey: string }} arg
+     */
+    (_event, arg) => {
+      const browserWindowIns = composables.getBrowserWindowInstance(
+        arg.targetWindowKey
+      );
+      if (!browserWindowIns) return;
+
+      browserWindowIns.minimize();
+    }
+  );
+
+  ipcMain.on(
+    `${methodBase}.closeWindow`,
+    /**
+     *
+     * @param {import("electron").IpcMainEvent} _event
+     * @param {{ targetWindowKey: string }} arg
+     */
+    (_event, arg) => {
+      const browserWindowIns = composables.getBrowserWindowInstance(
+        arg.targetWindowKey
+      );
+      if (!browserWindowIns) return;
+
+      browserWindowIns.close();
+    }
+  );
+};
+
+module.exports = { applyBaseIpcHandler };
--- a/src/aura/init/main/ipcModules/fsIpcHandler.js
+++ b/src/aura/init/main/ipcModules/fsIpcHandler.js
@@ -38,10 +38,13 @@ const composableFunctions = {
      progressCallback(failedTemplate);
      return false;
    }
-    if (!fs.existsSync(path.dirname(targetPath))) {
-      failedTemplate.message = "Path not exists";
-      progressCallback(failedTemplate);
+
+    const dirName = path.dirname(targetPath);
+
+    if (!fs.existsSync(dirName)) {
+      fs.mkdirSync(dirName, { recursive: true });
    }
+
    const httpModuleIns = url.startsWith("https") ? nodeHttps : nodeHttp;

    global.__HUGO_AURA__.fsTasks?.downloadTasks.set(taskId, {
@@ -49,6 +52,14 @@ const composableFunctions = {
      cancelReq: null,
    });

+    progressCallback({
+      id: taskId,
+      progress: 0,
+      status: "waiting",
+      dlUrl: url,
+      savePath: targetPath,
+    });
+
    const fsStream = fs.createWriteStream(targetPath);

    const dlReq = httpModuleIns.get(url, (response) => {
@@ -64,9 +75,12 @@ const composableFunctions = {
      const totalBytes = parseInt(contentLength, 10) || 0; // No error handling 😆
      let curRecvBytes = 0;

+      let hasCancelled = false;
+
      global.__HUGO_AURA__.fsTasks?.downloadTasks.set(taskId, {
        status: "progressing",
        cancelReq: () => {
+          hasCancelled = true;
          dlReq.destroy();
          fsStream.close();
          fs.unlink(targetPath, () => {});
@@ -102,6 +116,9 @@ const composableFunctions = {

      fsStream.on("finish", () => {
        fsStream.close();
+        if (hasCancelled) {
+          return;
+        }
        progressCallback({
          id: taskId,
          progress: (100).toFixed(2),
@@ -111,9 +128,9 @@ const composableFunctions = {
          dlUrl: url,
          savePath: targetPath,
        });
+        global.__HUGO_AURA__.fsTasks?.downloadTasks.delete(taskId);
      });

-      global.__HUGO_AURA__.fsTasks?.downloadTasks.delete(taskId);
      return true;
    });

@@ -123,6 +140,10 @@ const composableFunctions = {
      failedTemplate.message =
        "Request error: Unexpected error while downloading file";
      failedTemplate.errorObj = e;
+      console.error(
+        `[HugoAura / IPC / FS / ERROR] Error downloading file from ${url}, errorObj:`,
+        e
+      );
      progressCallback(failedTemplate);
      global.__HUGO_AURA__.fsTasks?.downloadTasks.delete(taskId);
      return false;
--- a/src/aura/init/main/ipcModules/plsIpcHandler.js
+++ b/src/aura/init/main/ipcModules/plsIpcHandler.js
@@ -71,34 +71,92 @@ const functions = {
  handlePLSDownload: async (channel, callbackFn, binPath) => {
    // TODO: Channel selection
    const apiInfo = global.__HUGO_AURA_API__;
-    let plsVersionInfo = {};

-    const getVerPromise = new Promise((resolve) => {
+    const getVerPromise = new Promise(async (resolveGetVerReq) => {
      // ↓ 目前 channel param 没有什么用处
-      nodeHttps
-        .get(
-          `${apiInfo.baseUrl}${apiInfo.plsUpdate}?channel=${channel}`,
-          (rep) => {
-            let dataChunk = "";
-            rep.on("data", (chunk) => {
-              dataChunk += chunk;
-            });
+      for (const apiDomain of apiInfo.domains) {
+        const reqPromise = new Promise((resolveHttpRequest) => {
+          nodeHttps
+            .get(
+              `${apiDomain}${apiInfo.plsUpdate}?channel=${channel}`,
+              (rep) => {
+                let dataChunk = "";
+                rep.on("data", (chunk) => {
+                  dataChunk += chunk;
+                });

-            rep.on("end", () => {
-              resolve({
-                success: true,
-                data: dataChunk,
+                rep.on("end", () => {
+                  let parsedData = {};
+                  try {
+                    parsedData = JSON.parse(dataChunk);
+                  } catch (e) {
+                    callbackFn({
+                      id: "",
+                      progress: 0,
+                      status: "struggling",
+                      dlUrl: null,
+                      savePath: null,
+                      message: `数据解析失败, 正在尝试 API 域名 ${
+                        apiInfo.domains[apiInfo.domains.indexOf(apiDomain) + 1]
+                      } ...`,
+                      errorObj: e,
+                    });
+
+                    setTimeout(() => {
+                      resolveHttpRequest({
+                        success: false,
+                        errorObj: e,
+                      });
+                    }, 1000);
+                    return;
+                  }
+
+                  resolveHttpRequest({
+                    success: true,
+                    data: parsedData,
+                  });
+                  return;
+                });
+              }
+            )
+            .on("error", (e) => {
+              callbackFn({
+                id: "",
+                progress: 0,
+                status: "struggling",
+                dlUrl: null,
+                savePath: null,
+                message: `连接失败, 正在尝试 API 域名 ${
+                  apiInfo.domains[apiInfo.domains.indexOf(apiDomain) + 1]
+                } ...`,
+                errorObj: e,
              });
+
+              setTimeout(() => {
+                resolveHttpRequest({
+                  success: false,
+                  errorObj: e,
+                });
+              }, 1000);
            });
-          }
-        )
-        .on("error", (e) => {
-          resolve({
-            success: false,
-            data: null,
-            errorObj: e,
-          });
        });
+
+        const requestResult = await reqPromise;
+        if (requestResult.success) {
+          resolveGetVerReq({
+            success: true,
+            data: requestResult.data,
+          });
+          break;
+        } else {
+          continue;
+        }
+      }
+
+      resolveGetVerReq({
+        success: false,
+        data: null,
+      });
    });

    const rawResInfo = await getVerPromise;
@@ -109,30 +167,12 @@ const functions = {
        status: "failed",
        dlUrl: null,
        savePath: null,
-        message: "未能获取 PLS 版本信息",
-        errorObj: rawResInfo.errorObj ? rawResInfo.errorObj : null,
+        message: "未能获取 PLS 版本信息, 所有 API 域名均无法连接",
      });
      return false;
    }

-    try {
-      plsVersionInfo = JSON.parse(rawResInfo.data);
-    } catch (e) {
-      callbackFn({
-        id: "",
-        progress: 0,
-        status: "failed",
-        dlUrl: null,
-        savePath: null,
-        message: "PLS 版本信息解析失败",
-        errorObj: e,
-      });
-      console.error(
-        "[HugoAura / IPC / PLS] Error querying PLS version info:",
-        e
-      );
-      return false;
-    }
+    const plsVersionInfo = rawResInfo.data;

    let deviceArch = process.env.PROCESSOR_ARCHITEW6432
      ? process.env.PROCESSOR_ARCHITEW6432
@@ -155,7 +195,16 @@ const functions = {
    fsComposables.downloadFile(
      plsVersionInfo.data.downloadUrl[deviceArch],
      binPath,
-      callbackFn
+      (...args) => {
+        if (args[0].status === "done") {
+          if (global.__HUGO_AURA__.plsStats) {
+            global.__HUGO_AURA__.plsStats.installed = true;
+            global.__HUGO_AURA__.plsStats.status = "dead";
+          }
+        }
+
+        callbackFn(...args);
+      }
    );
  },
 };
@@ -192,11 +241,18 @@ const applyPlsIpcHandler = (ipcMain) => {
    (_event, _arg) => {
      try {
        const result = fs.existsSync(PLS_BIN_PATH);
+
+        if (global.__HUGO_AURA__.plsStats?.status === "notInstalled") {
+          global.__HUGO_AURA__.plsStats.status = "dead";
+        }
+
        return {
          success: true,
          data: { isExists: result },
        };
      } catch (e) {
+        // @ts-expect-error
+        global.__HUGO_AURA__.plsStats.status = "notInstalled";
        return {
          success: false,
          data: { isExists: false },
@@ -227,7 +283,7 @@ const applyPlsIpcHandler = (ipcMain) => {
      }

      try {
-        fs.mkdirSync(PLS_INSTALL_DIR);
+        fs.mkdirSync(PLS_INSTALL_DIR, { recursive: true });
        return {
          success: true,
          data: {
@@ -427,10 +483,6 @@ const applyPlsIpcHandler = (ipcMain) => {
    async (_event, arg) => {
      const logHeader = "[HugoAura / IPC / PLS] <plsLifecycleControl>";

-      if (!global.__HUGO_AURA__.plsStats?.installed) {
-        return { success: false, errorObj: new Error("PLS not installed") };
-      }
-
      switch (arg.target) {
        case "instSvc":
          return await functions.execCommand(
@@ -452,6 +504,10 @@ const applyPlsIpcHandler = (ipcMain) => {
                  success: false,
                  errorObj: error,
                });
+                console.error(
+                  `${logHeader} Failed to remove PLS bin, error:`,
+                  error
+                );
                return false;
              }

--- a/src/aura/init/main/logger.js
+++ b/src/aura/init/main/logger.js
@@ -0,0 +1,111 @@
+const path = require("path");
+const fs = require("fs");
+const os = require("os");
+const util = require("util");
+
+/**
+ *
+ * @param {import("../aura/types/main/core").WindowName} windowName
+ */
+const initLogger = (windowName) => {
+  const logDir = path.join(os.homedir(), "Documents", "HugoAura", "logs");
+  if (!fs.existsSync(logDir)) {
+    fs.mkdirSync(logDir, { recursive: true });
+  }
+
+  cleanupOldLogs(logDir);
+  const logFile = getLogFileName(logDir);
+  const logStream = fs.createWriteStream(logFile, { flags: "a" });
+
+  const timestamp = new Date().toISOString();
+  const startupMsg = `\n=== [${timestamp}] HugoAura 窗口启动: ${windowName} ===\n\n`;
+  logStream.write(startupMsg);
+
+  const originalConsole = {
+    log: console.log,
+    error: console.error,
+    warn: console.warn,
+    info: console.info,
+    debug: console.debug,
+  };
+
+  console.log = function (...args) {
+    const msg = util.format(`[LOG] <${windowName}>`, ...args) + "\n";
+    logStream.write(msg);
+    originalConsole.log.apply(console, args);
+  };
+
+  console.error = function (...args) {
+    const msg = util.format(`[ERROR] <${windowName}>`, ...args) + "\n";
+    logStream.write(msg);
+    originalConsole.error.apply(console, args);
+  };
+
+  console.warn = function (...args) {
+    const msg = util.format(`[WARN] <${windowName}>`, ...args) + "\n";
+    logStream.write(msg);
+    originalConsole.warn.apply(console, args);
+  };
+
+  console.info = function (...args) {
+    const msg = util.format(`[INFO] <${windowName}>`, ...args) + "\n";
+    logStream.write(msg);
+    originalConsole.info.apply(console, args);
+  };
+
+  console.debug = function (...args) {
+    if (!process.argv.includes("--aura-debug")) return;
+    const msg = util.format(`[DEBUG] <${windowName}>`, ...args) + "\n";
+    logStream.write(msg);
+    originalConsole.debug.apply(console, args);
+  };
+
+  process.on("uncaughtException", (err) => {
+    console.error("[CRITICAL] UNCAUGHT EXCEPTION:", err);
+  });
+
+  console.log(
+    "[HugoAura / Logger] Logger initialized. Log file:",
+    logFile
+  );
+};
+
+const cleanupOldLogs = (logDir) => {
+  try {
+    const files = fs.readdirSync(logDir);
+    const now = new Date();
+    const sevenDaysAgo = new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000);
+
+    files.forEach((file) => {
+      if (file.endsWith(".log")) {
+        const filePath = path.join(logDir, file);
+        const stats = fs.statSync(filePath);
+
+        // 如果文件创建时间超过 30 天, 则删除
+        if (stats.birthtime < sevenDaysAgo) {
+          fs.unlinkSync(filePath);
+          console.log(
+            `[HugoAura / Logger / Cleanup] Cleaned log file: ${file}`
+          );
+        }
+      }
+    });
+  } catch (error) {
+    console.error("[HugoAura / Logger / Cleanup] Unexpected error occurred cleaning log file:", error);
+  }
+};
+
+/**
+ * 生成每日 Log 文件路径
+ * @param {string} logDir 日志目录路径
+ * @param {string} _windowName 窗口名称 (暂时无用)
+ * @returns {string} 日志文件路径
+ */
+const getLogFileName = (logDir, _windowName) => {
+  const today = new Date();
+  const dateStr = today.toISOString().split("T")[0]; // YYYY-MM-DD 格式
+  const logFileName = `HugoAura-SSA-${dateStr}.log`;
+  return path.join(logDir, logFileName);
+};
+
+module.exports = { initLogger };
--- a/src/aura/init/shared/default.json
+++ b/src/aura/init/shared/default.json
@@ -30,7 +30,14 @@
    "settingsPasswordEnabled": false,
    "settingsPasswordWithSalt": "32703D292460CC9A3B867494D6AD9A8E4A3ADF0FAA4D6867BC4D412CC3927D02E47C6D0B1763BB53E57B2241C6193433561CDA09D7C48CA03983072B876F0965",
    "encryptConfig": false,
-    "appearance": {}
+    "appearance": {},
+    "uiAccessMethod": {
+      "showEntryIcon": true,
+      "fallbackAccessMethods": {
+        "hotkey": false,
+        "touch": false
+      }
+    }
  },
  "devTools": false
 }
--- a/src/aura/types/main/ipc/fs.d.ts
+++ b/src/aura/types/main/ipc/fs.d.ts
@@ -1,5 +1,5 @@
 type DownloadTaskID = string;
-type DownloadTaskStatus = "waiting" | "progressing" | "done" | "failed" | "cancelled";
+type DownloadTaskStatus = "waiting" | "progressing" | "done" | "failed" | "cancelled" | "struggling";

 interface DownloadTask {
  id: DownloadTaskID;
--- a/src/aura/types/shared/global.d.ts
+++ b/src/aura/types/shared/global.d.ts
@@ -24,7 +24,7 @@ interface GlobalHugoAuraInfo {
 }

 interface GlobalHugoAuraApiInfo {
-  baseUrl: string;
+  domains: string[];
  plsUpdate: string;
  auraUpdate: string;
 }
--- a/src/aura/types/shared/pls/status.d.ts
+++ b/src/aura/types/shared/pls/status.d.ts
@@ -1,15 +1,28 @@
 import { RendererProcessOnlyVal } from "../global";

+type PLSStatusDesc =
+  | "dead"
+  | "running"
+  | "notReady"
+  | "downloading"
+  | "notInstalled";
+
 interface PLSStatus {
  installed: boolean;
  detached: boolean;
  connected: boolean;
  launched: boolean;
-  status: string;
+  status: PLSStatusDesc;
  version: string;
  authToken: string;
 }

 type PLSLifecycleType = "isDetached" | "isSvcInstalled" | "isSvcStart";

-type PLSLifecycleControlType = "instSvc" | "rmSvc" | "startSvc" | "stopSvc" | "rmBin" | "dlBin";
+type PLSLifecycleControlType =
+  | "instSvc"
+  | "rmSvc"
+  | "startSvc"
+  | "stopSvc"
+  | "rmBin"
+  | "dlBin";
--- a/src/aura/ui/composables/settingsRenderer.js
+++ b/src/aura/ui/composables/settingsRenderer.js
@@ -45,6 +45,28 @@ const showToast = (entry) => {
  */
 };

+const setDisableStatus = (el, isDisable, hint = null) => {
+  if (isDisable) {
+    el.classList.add("ase-operation-area-disabled");
+    if (hint) {
+      el.setAttribute("data-bs-toggle", "tooltip");
+      el.setAttribute("data-bs-placement", "top");
+      el.setAttribute("data-bs-title", hint);
+      const tooltipIns = bootstrap.Tooltip.getOrCreateInstance(el);
+      tooltipIns.enable();
+    }
+  } else {
+    el.setAttribute("data-bs-toggle", "tooltip");
+    el.setAttribute("data-bs-placement", "top");
+    el.setAttribute("data-bs-title", "None");
+    el.classList.remove("ase-operation-area-disabled");
+    const tooltipIns = bootstrap.Tooltip.getInstance(el);
+    if (tooltipIns) {
+      tooltipIns.dispose();
+    }
+  }
+};
+
 const insertOrRemoveEl = (parent, child, isInsert = true) => {
  if (Array.isArray(child)) {
    for (const perEl of child) {
@@ -71,7 +93,12 @@ const renderInputArea = (entry, operationArea, descriptionArea) => {
      switchEl.checked = elValue;
      switchEl.addEventListener("change", async (event) => {
        showToast(entry);
-        await entry.callbackFn(event.target.checked);
+        await entry.callbackFn(
+          event.target.checked,
+          switchEl,
+          operationArea,
+          descriptionArea
+        );
      });
      operationArea.classList.add("form-check", "form-switch");
      return switchEl;
@@ -92,7 +119,12 @@ const renderInputArea = (entry, operationArea, descriptionArea) => {
        radioEl.addEventListener("change", async (event) => {
          if (event.target.checked) {
            showToast(entry);
-            await entry.callbackFn(event.target.value);
+            await entry.callbackFn(
+              event.target.value,
+              radioEl,
+              operationArea,
+              descriptionArea
+            );
          }
        });
        inlineContainerEl.appendChild(radioEl);
@@ -114,7 +146,12 @@ const renderInputArea = (entry, operationArea, descriptionArea) => {
      inputEl.placeholder = entry.placeHolder;
      inputEl.id = entry.id;
      inputEl.addEventListener("change", async (event) => {
-        const result = await entry.callbackFn(event.target.value);
+        const result = await entry.callbackFn(
+          event.target.value,
+          inputEl,
+          operationArea,
+          descriptionArea
+        );
        const success = result.valid;
        if (success) {
          showToast(entry);
@@ -250,22 +287,6 @@ const renderNormalSettingsItem = (entry, formEl) => {
    // createOnLeaveEvtListener(channel, evtListener);
  }

-  const setDisableStatus = (el, isDisable, hint = null) => {
-    if (isDisable) {
-      el.classList.add("ase-operation-area-disabled");
-      if (hint) {
-        el.setAttribute("data-bs-toggle", "tooltip");
-        el.setAttribute("data-bs-placement", "top");
-        el.setAttribute("data-bs-title", hint);
-      }
-    } else {
-      el.setAttribute("data-bs-toggle", "");
-      el.setAttribute("data-bs-placement", "");
-      el.setAttribute("data-bs-title", "");
-      el.classList.remove("ase-operation-area-disabled");
-    }
-  };
-
  if (entry.PLSRequired) {
    if (!global.__HUGO_AURA__.plsStats.connected) {
      setDisableStatus(entryOperationArea, true, "连接至 PLS 以继续");
@@ -285,6 +306,19 @@ const renderNormalSettingsItem = (entry, formEl) => {
  const isShow = entry.auraIf();
  if (!isShow) entryContainerEl.classList.add("aura-settings-entry-hidden");

+  const updateDisableStatus = () => {
+    const isDisabledRet = entry.auraDisable();
+    setDisableStatus(
+      entryOperationArea,
+      isDisabledRet.value,
+      isDisabledRet.tooltip
+    );
+  };
+
+  if (entry.auraDisable) {
+    updateDisableStatus();
+  }
+
  if (entry.associateVal) {
    const evtListener = (event) => {
      if (!entry.associateVal.includes(event.detail.path.join("."))) return;
@@ -293,6 +327,10 @@ const renderNormalSettingsItem = (entry, formEl) => {
      isShow
        ? cls.remove("aura-settings-entry-hidden")
        : cls.add("aura-settings-entry-hidden");
+
+      if (entry.auraDisable) {
+        updateDisableStatus();
+      }
    };
    const channel = entry.PLSRequired
      ? "onPLSConfigUpdate"
@@ -378,7 +416,9 @@ const settingsRenderer = (pendingEl, settingsObj) => {
  }
  pendingEl.appendChild(formEl);

-  global.__HUGO_AURA_GLOBAL__.utils.refreshBsTooltip();
+  global.__HUGO_AURA_GLOBAL__.utils.refreshBsTooltip(
+    ".aura-settings-entry-property-icon"
+  );
 };

 module.exports = { settingsRenderer };
--- a/src/aura/ui/js/global.js
+++ b/src/aura/ui/js/global.js
@@ -4,16 +4,14 @@

  /* Util: BootStrap Tooltip Ctrl */
  let tooltipTriggerCache = null;
-  const refreshBsTooltip = () => {
+  const refreshBsTooltip = (selector = '[data-bs-toggle="tooltip"]') => {
    if (tooltipTriggerCache) {
      [...tooltipTriggerCache].map((el) =>
        bootstrap.Tooltip.getInstance(el).disable()
      );
    }

-    const tooltipTriggerList = document.querySelectorAll(
-      '[data-bs-toggle="tooltip"]'
-    );
+    const tooltipTriggerList = document.querySelectorAll(selector);
    tooltipTriggerCache = tooltipTriggerList;
    [...tooltipTriggerList].map(
      (tooltipTriggerEl) => new bootstrap.Tooltip(tooltipTriggerEl)
--- a/src/aura/ui/js/plsConnectionManager.js
+++ b/src/aura/ui/js/plsConnectionManager.js
@@ -6,7 +6,7 @@
      detached: false,
      connected: false,
      launched: false,
-      status: "unknown",
+      status: "dead",
      version: "未知",
      authToken: "",
    };
@@ -259,7 +259,10 @@
      `${IPC_METHOD_BASE}.getPlsStats`
    );
    let updatedPlsStats = {};
-    if (curPlsStats === null || !curPlsStats.success) {
+    if (
+      (curPlsStats === null || !curPlsStats.success) &&
+      curPlsStats.status !== "downloading"
+    ) {
      updatedPlsStats = {
        installed: false,
        launched: false,
@@ -277,7 +280,6 @@
      await global.ipcRenderer.invoke(`${IPC_METHOD_BASE}.getPlsBinExists`)
    ).data.isExists;
    updatedPlsStats.installed = isPlsFolderExists;
-
    // @ts-expect-error
    global.__HUGO_AURA__.plsStats = updatedPlsStats;
    console.debug(
@@ -326,5 +328,7 @@
    );
  };

-  onSetup();
+  setTimeout(() => {
+    onSetup();
+  }, 1500);
 })();
--- a/src/aura/ui/pages/config/config.html
+++ b/src/aura/ui/pages/config/config.html
@@ -7,11 +7,48 @@
    <div class="aura-config-page-app-bar" style="-webkit-app-region: drag">
      <div
        onclick="global.__HUGO_AURA_UI_FUNCTIONS__.config.handleNavBack()"
-        style="-webkit-app-region: no-drag; z-index: 2000"
+        style="-webkit-app-region: no-drag; z-index: 2000; margin-right: 0.1rem"
      >
        <i class="iconfont"></i>
+        <!-- Chevron Left Icon -->
      </div>
      <p>雨光之环</p>
+      <div class="aura-config-page-app-bar-hr-vertical"></div>
+      <div
+        onclick="global.__HUGO_AURA_UI_FUNCTIONS__.config.handleNavHome()"
+        style="-webkit-app-region: no-drag; z-index: 2000; margin-left: 6px"
+      >
+        <svg
+          xmlns="http://www.w3.org/2000/svg"
+          width="21"
+          height="21"
+          viewBox="0 0 24 24"
+          class="iconfont"
+          style="margin-top: -1.5px"
+        >
+          <path
+            fill="currentColor"
+            d="M6 19h3.692v-5.884h4.616V19H18v-9l-6-4.538L6 10zm-1 1V9.5l7-5.288L19 9.5V20h-5.692v-5.884h-2.616V20zm7-7.77"
+            stroke-width="0.5"
+            stroke="currentColor"
+          />
+        </svg>
+      </div>
+      <div class="aura-config-page-app-bar-spacer"></div>
+      <div
+        onclick="global.__HUGO_AURA_UI_FUNCTIONS__.config.minimizeWindow()"
+        style="-webkit-app-region: no-drag; z-index: 2000"
+      >
+        <i class="iconfont"></i>
+        <!-- Minimize Icon -->
+      </div>
+      <div
+        onclick="global.__HUGO_AURA_UI_FUNCTIONS__.config.closeWindow()"
+        style="-webkit-app-region: no-drag; z-index: 2000; margin-left: 0.5rem"
+      >
+        <i class="iconfont"></i>
+        <!-- Failed / Cancel Icon -->
+      </div>
    </div>
  </div>

--- a/src/aura/ui/pages/config/config.js
+++ b/src/aura/ui/pages/config/config.js
@@ -6,6 +6,22 @@ global.__HUGO_AURA_UI_REACTIVES__.config = {
 };

 global.__HUGO_AURA_UI_FUNCTIONS__.config = {
+  closeWindow: async () => {
+    if (global.__HUGO_AURA_UI_REACTIVES__.config.isConfigPendingWrite) {
+      await global.__HUGO_AURA_UI_FUNCTIONS__.config.handleSaveConfig();
+    }
+
+    global.ipcRenderer.send("$aura.base.closeWindow", {
+      targetWindowKey: "assistant",
+    });
+  },
+
+  minimizeWindow: () => {
+    global.ipcRenderer.send("$aura.base.minimizeWindow", {
+      targetWindowKey: "assistant",
+    });
+  },
+
  handleNavBack: () => {
    if (global.__HUGO_AURA_UI_REACTIVES__.config.isInSubPage) {
      const acsDialogAreaEl = document.getElementsByClassName(
@@ -30,6 +46,19 @@ global.__HUGO_AURA_UI_FUNCTIONS__.config = {
    }
  },

+  handleNavHome: async () => {
+    if (global.__HUGO_AURA_UI_REACTIVES__.config.isConfigPendingWrite) {
+      global.__HUGO_AURA_UI_FUNCTIONS__.config.handleSaveConfig();
+    }
+
+    global.__HUGO_AURA_UI_FUNCTIONS__.config.hideConfigPage();
+
+    setTimeout(() => {
+      const onLeaveEvent = new CustomEvent("onCurConfigPageLeave");
+      document.dispatchEvent(onLeaveEvent);
+    }, 500);
+  },
+
  hideConfigPage: async () => {
    const defaultHeader = document.getElementsByClassName(
      "index__header__16DmR2a5"
--- a/src/aura/ui/pages/config/css/header.css
+++ b/src/aura/ui/pages/config/css/header.css
@@ -19,6 +19,11 @@
  color: rgba(0, 0, 0, 0.8);
 }

+.aura-config-page-header-area.color-reverse
+  .aura-config-page-app-bar-hr-vertical {
+  background: rgba(0, 0, 0, 0.5);
+}
+
 .aura-config-page-header-area .iconfont {
  font-size: 24px;
 }
@@ -33,7 +38,7 @@
 }

 .aura-config-page-header-area p {
-  margin-top: -1px;
+  margin-top: -2px;
 }

 .aura-config-page-header-area.header-collapsed {
@@ -48,3 +53,16 @@
  align-items: center;
  width: 100%;
 }
+
+.aura-config-page-app-bar-spacer {
+  flex-grow: 1;
+}
+
+.aura-config-page-app-bar-hr-vertical {
+  position: relative;
+  margin-left: 8px;
+  width: 1px;
+  background: rgba(255, 255, 255, 0.5);
+  height: 12px;
+  transition: background 0.5s;
+}
--- a/src/aura/ui/pages/configSubPages/behaviourCtrl/plsStatus.css
+++ b/src/aura/ui/pages/configSubPages/behaviourCtrl/plsStatus.css
@@ -33,6 +33,10 @@
  margin-bottom: 1rem;
 }

+.acs-bc-psp-operations-container.acs-bc-psp-oper-ctnr-hidden {
+  display: none;
+}
+
 .acs-bc-psp-operation-btn {
  --svg-color: rgb(17, 140, 255);

@@ -85,6 +89,50 @@
  opacity: 0.3;
 }

+.acs-bc-psp-download-progress-area {
+  display: flex;
+  flex-direction: column;
+  width: 80%;
+  justify-content: center;
+  align-items: center;
+}
+
+.acs-bc-psp-download-progress-area.acs-bc-psp-dl-pbar-hidden {
+  display: none;
+}
+
+.acs-bc-psp-download-progress-area .progress {
+  height: 2px;
+  width: 80%;
+  margin-bottom: 0.6rem;
+}
+
+.acs-bc-psp-download-progress-area .progress-bar {
+  transition: all 0.15s;
+}
+
+.acs-bc-psp-download-progress-area #acsBcPspDownloadPbarDesc {
+  opacity: 0.6;
+  margin-bottom: 0.25rem;
+}
+
+.acs-bc-psp-download-progress-info-area {
+  display: flex;
+}
+
+.acs-bc-psp-download-progress-info-area .acs-bc-psp-operation-btn {
+  margin-left: 1rem;
+  margin-bottom: 0.25rem;
+}
+
+.acs-bc-psp-download-progress-info-area .acs-bc-psp-operation-btn.hidden {
+  display: none;
+}
+
+.acs-bc-psp-download-progress-info-area .acs-bc-psp-operation-btn svg {
+  margin-top: 1px;
+}
+
 .acs-bc-pls-status-page-status-el {
  display: flex;
  align-items: center;
--- a/src/aura/ui/pages/configSubPages/behaviourCtrl/plsStatus.html
+++ b/src/aura/ui/pages/configSubPages/behaviourCtrl/plsStatus.html
@@ -124,6 +124,37 @@
    </div>
  </div>

+  <div class="acs-bc-psp-download-progress-area acs-bc-psp-dl-pbar-hidden">
+    <div class="progress" role="progressbar">
+      <div class="progress-bar" id="acsBcPspDownloadPbarEl"></div>
+    </div>
+    <div class="acs-bc-psp-download-progress-info-area">
+      <p id="acsBcPspDownloadPbarDesc">等待中...</p>
+      <div
+        class="acs-bc-psp-operation-btn hidden"
+        id="acsBcPspDownloadPbarCancelBtn"
+        onclick="global.__HUGO_AURA_UI_FUNCTIONS__.subConfig.plsStatus.cancelDownloadTask()"
+      >
+        <svg
+          xmlns="http://www.w3.org/2000/svg"
+          width="32"
+          height="32"
+          viewBox="0 0 32 32"
+        >
+          <path
+            fill="var(--svg-color)"
+            d="M9 10.555L10.555 9L23 21.444L21.444 23z"
+          />
+          <path
+            fill="var(--svg-color)"
+            d="M16 2A13.914 13.914 0 0 0 2 16a13.914 13.914 0 0 0 14 14a13.914 13.914 0 0 0 14-14A13.914 13.914 0 0 0 16 2m0 26a12 12 0 1 1 12-12a12.035 12.035 0 0 1-12 12"
+          />
+        </svg>
+        <p>取消操作</p>
+      </div>
+    </div>
+  </div>
+
  <div class="acs-bc-pls-status-page-status-el">
    <p>安装状态</p>
    <div
@@ -165,7 +196,11 @@
  </div>

  <div class="toast-container position-fixed bottom-0 end-0 p-3">
-    <div id="plsStatusNotifyToast" class="acs-bc-psp-toast toast" data-bs-autohide="false">
+    <div
+      id="plsStatusNotifyToast"
+      class="acs-bc-psp-toast toast"
+      data-bs-autohide="false"
+    >
      <div class="toast-header">
        <strong class="me-auto" id="plsStatusNotifyToastTitle"></strong>
        <button
--- a/src/aura/ui/pages/configSubPages/behaviourCtrl/plsStatus.js
+++ b/src/aura/ui/pages/configSubPages/behaviourCtrl/plsStatus.js
@@ -17,6 +17,7 @@ if (!global.__HUGO_AURA_UI_REACTIVES__.subConfig)

  global.__HUGO_AURA_UI_REACTIVES__.subConfig.plsStatus = {
    toastAutoHideTimeout: null,
+    curDlTaskId: null,
  };

  global.__HUGO_AURA_UI_FUNCTIONS__.subConfig.plsStatus = {
@@ -135,7 +136,7 @@ if (!global.__HUGO_AURA_UI_REACTIVES__.subConfig)
                global.__HUGO_AURA_UI_FUNCTIONS__.subConfig.plsStatus.updateToast(
                  "error",
                  "服务安装失败",
-                  "<p>检查日志以获取详细信息</p>",
+                  `<p>${ret.errorObj}</p>`,
                  true,
                  false,
                  null
@@ -166,6 +167,13 @@ if (!global.__HUGO_AURA_UI_REACTIVES__.subConfig)
                if (ret.success) {
                  lifecycleStatus.installed = false;
                  lifecycleStatus.svcInstalled = false;
+                  global.__HUGO_AURA__.plsStats.installed = false;
+                  global.__HUGO_AURA__.plsStats.connected = false;
+                  global.__HUGO_AURA__.plsStats.launched = false;
+                  ipcRenderer.invoke(
+                    `${IPC_METHOD_BASE}.updatePlsStats`,
+                    global.__HUGO_AURA__.plsStats
+                  );
                  global.__HUGO_AURA_UI_FUNCTIONS__.subConfig.plsStatus.updateToast(
                    "success",
                    "内核已删除",
@@ -178,7 +186,9 @@ if (!global.__HUGO_AURA_UI_REACTIVES__.subConfig)
                  global.__HUGO_AURA_UI_FUNCTIONS__.subConfig.plsStatus.updateToast(
                    "error",
                    "内核删除失败",
-                    "<p>检查日志以获取详细信息</p>",
+                    `<p>
+                      ${ret.errorObj ? ret.errorObj : "检查日志以获取详细信息"}
+                    </p>`,
                    true,
                    false,
                    null
@@ -211,7 +221,14 @@ if (!global.__HUGO_AURA_UI_REACTIVES__.subConfig)
                    global.__HUGO_AURA_UI_FUNCTIONS__.subConfig.plsStatus.updateToast(
                      "error",
                      "服务卸载失败: 无法停止服务",
-                      "<p>检查日志以获取详细信息</p><p>您可以尝试手动停止 PLS 服务</p>",
+                      `<p>${
+                        stopRet.errorObj
+                          ? stopRet.errorObj
+                          : "检查日志以获取详细信息"
+                      }</p>
+                      <p>
+                        您可以尝试手动停止 PLS 服务
+                      </p>`,
                      true,
                      false,
                      null
@@ -345,6 +362,10 @@ if (!global.__HUGO_AURA_UI_REACTIVES__.subConfig)
    updateStatusContent: async () => {
      const curPlsStats = await updatePlsStatusFromLocal();

+      if (curPlsStats.status === "downloading") {
+        GLOBAL_FUNCTIONS.downloadPLSBin(true);
+      }
+
      const acIdInst = "acs-bc-psp-installStatus-container";
      const atIdInst = "acs-bc-psp-installStatus-text";
      switch (lifecycleStatus.installed) {
@@ -435,8 +456,18 @@ if (!global.__HUGO_AURA_UI_REACTIVES__.subConfig)
      );
      if (binExistsRet.success && binExistsRet.data.isExists) {
        lifecycleStatus.installed = true;
+        global.__HUGO_AURA__.plsStats.installed = true;
+        ipcRenderer.invoke(
+          `${IPC_METHOD_BASE}.updatePlsStats`,
+          global.__HUGO_AURA__.plsStats
+        );
      } else {
        lifecycleStatus.installed = false;
+        global.__HUGO_AURA__.plsStats.installed = false;
+        ipcRenderer.invoke(
+          `${IPC_METHOD_BASE}.updatePlsStats`,
+          global.__HUGO_AURA__.plsStats
+        );
        global.__HUGO_AURA_UI_FUNCTIONS__.subConfig.plsStatus.updateToast(
          "error",
          "请下载 PLS 内核以继续",
@@ -523,22 +554,101 @@ if (!global.__HUGO_AURA_UI_REACTIVES__.subConfig)
      }
    },

-    downloadPLSBin: async () => {
+    /**
+     *
+     * @param {boolean} isShow
+     */
+    switchPBarShowStatus: (isShow) => {
+      const operAreaEl = document.getElementsByClassName(
+        "acs-bc-psp-operations-container"
+      )[0];
+      const pBarAreaEl = document.getElementsByClassName(
+        "acs-bc-psp-download-progress-area"
+      )[0];
+      const pBarDescEl = document.getElementById("acsBcPspDownloadPbarDesc");
+      const pBarSelfEl = document.getElementById("acsBcPspDownloadPbarEl");
+
+      if (isShow) {
+        pBarAreaEl.classList.remove("acs-bc-psp-dl-pbar-hidden");
+        operAreaEl.classList.add("acs-bc-psp-oper-ctnr-hidden");
+        pBarDescEl.textContent = "等待中...";
+        pBarSelfEl.style["width"] = "0";
+      } else {
+        pBarAreaEl.classList.add("acs-bc-psp-dl-pbar-hidden");
+        operAreaEl.classList.remove("acs-bc-psp-oper-ctnr-hidden");
+      }
+
+      return true;
+    },
+
+    updatePBarStatus: async (
+      progress = null,
+      desc = null,
+      type = null,
+      isCancelShown = null
+    ) => {
+      const pBarDescEl = document.getElementById("acsBcPspDownloadPbarDesc");
+      const pBarSelfEl = document.getElementById("acsBcPspDownloadPbarEl");
+      const pBarBtnEl = document.getElementById(
+        "acsBcPspDownloadPbarCancelBtn"
+      );
+      if (progress) {
+        pBarSelfEl.style["width"] = `${progress}%`;
+      }
+
+      if (type) {
+        pBarSelfEl.classList.remove("bg-success");
+        pBarSelfEl.classList.remove("bg-warning");
+        pBarSelfEl.classList.remove("bg-danger");
+        if (type !== "normal") {
+          pBarSelfEl.classList.add(`bg-${type}`);
+        }
+      }
+
+      if (desc) {
+        pBarDescEl.innerHTML = desc;
+      }
+
+      if (isCancelShown !== null) {
+        if (isCancelShown) {
+          pBarBtnEl.classList.remove("hidden");
+        } else {
+          pBarBtnEl.classList.add("hidden");
+        }
+      }
+    },
+
+    downloadPLSBin: async (retrieveMode = false) => {
      const GLOBAL_FUNCTIONS =
        global.__HUGO_AURA_UI_FUNCTIONS__.subConfig.plsStatus;
-      GLOBAL_FUNCTIONS.updateOperationBtnStatus("Download", true, "正在检查");
-      GLOBAL_FUNCTIONS.updateOperationBtnStatus("Refresh", true);
      const CUR_CHANNEL = `${IPC_METHOD_BASE}.post.reportPlsDownloadStatus`;
-      await ipcRenderer.invoke(`${IPC_METHOD_BASE}.ensurePlsInstallDir`);
-      GLOBAL_FUNCTIONS.updateToast(
-        "info",
-        "准备开始下载...",
-        null,
-        true,
-        true,
-        2000
-      );
-      GLOBAL_FUNCTIONS.updateOperationBtnStatus("Download", true, "等待下载");
+
+      if (!retrieveMode) {
+        GLOBAL_FUNCTIONS.updateOperationBtnStatus("Download", true, "正在检查");
+        GLOBAL_FUNCTIONS.updateOperationBtnStatus("Refresh", true);
+        await ipcRenderer.invoke(`${IPC_METHOD_BASE}.ensurePlsInstallDir`);
+        GLOBAL_FUNCTIONS.updateToast(
+          "info",
+          "准备开始下载...",
+          null,
+          true,
+          true,
+          2000
+        );
+        GLOBAL_FUNCTIONS.updateOperationBtnStatus("Download", true);
+      } else {
+        GLOBAL_FUNCTIONS.updateToast(
+          "info",
+          "正在恢复下载状态",
+          null,
+          true,
+          true,
+          2000
+        );
+      }
+
+      GLOBAL_FUNCTIONS.switchPBarShowStatus(true);
+      GLOBAL_FUNCTIONS.updatePBarStatus(0, "等待中...", "normal", false);

      const callbackFn = (_evt, info) => {
        switch (info.status) {
@@ -548,13 +658,31 @@ if (!global.__HUGO_AURA_UI_REACTIVES__.subConfig)
              "下载失败",
              `<p>${
                info.message ? info.message : "检查日志以获取错误信息"
-              }</p>`,
+              }</p><p>
+              ${info.errorObj ? info.errorObj : ""}
+              </p>`,
              true,
              true,
              5000
            );
+
+            GLOBAL_FUNCTIONS.updatePBarStatus(
+              100,
+              "下载时发生错误",
+              "danger",
+              false
+            );
+            setTimeout(() => {
+              GLOBAL_FUNCTIONS.switchPBarShowStatus(false);
+            }, 1000);
+
            ipcRenderer.off(CUR_CHANNEL, callbackFn);
            GLOBAL_FUNCTIONS.updateOperationBtnStatus("Refresh", false);
+            GLOBAL_FUNCTIONS.updateOperationBtnStatus(
+              "Download",
+              false,
+              "下载内核"
+            );
            break;
          case "done":
            GLOBAL_FUNCTIONS.updateToast(
@@ -565,6 +693,17 @@ if (!global.__HUGO_AURA_UI_REACTIVES__.subConfig)
              true,
              2500
            );
+
+            GLOBAL_FUNCTIONS.updatePBarStatus(
+              100,
+              "下载成功",
+              "success",
+              false
+            );
+            setTimeout(() => {
+              GLOBAL_FUNCTIONS.switchPBarShowStatus(false);
+            }, 1000);
+
            ipcRenderer.off(CUR_CHANNEL, callbackFn);
            GLOBAL_FUNCTIONS.updateOperationBtnStatus("Refresh", false);
            GLOBAL_FUNCTIONS.updateOperationBtnStatus(
@@ -573,20 +712,49 @@ if (!global.__HUGO_AURA_UI_REACTIVES__.subConfig)
              "下载内核"
            );
            lifecycleStatus.installed = true;
+            global.__HUGO_AURA__.plsStats.installed = true;
+            ipcRenderer.invoke(
+              `${IPC_METHOD_BASE}.updatePlsStats`,
+              global.__HUGO_AURA__.plsStats
+            );
            GLOBAL_FUNCTIONS.updateStatusContent();
            break;
          case "waiting":
-            GLOBAL_FUNCTIONS.updateOperationBtnStatus(
-              "Download",
-              true,
-              "等待中..."
-            );
+            GLOBAL_FUNCTIONS.updatePBarStatus(0, "正在连接", "normal");
+            if (
+              !global.__HUGO_AURA_UI_REACTIVES__.subConfig.plsStatus
+                .curDlTaskId ||
+              global.__HUGO_AURA_UI_REACTIVES__.subConfig.plsStatus
+                .curDlTaskId !== info.id
+            ) {
+              global.__HUGO_AURA_UI_REACTIVES__.subConfig.plsStatus.curDlTaskId =
+                info.id;
+            }
            break;
          case "progressing":
+            const roundProgress = Math.round(info.progress);
+            GLOBAL_FUNCTIONS.updatePBarStatus(
+              roundProgress,
+              `正在下载中... ${roundProgress}% (${(
+                info.curBytes /
+                1024 /
+                1024
+              ).toFixed(2)}MB / ${(info.totalBytes / 1024 / 1024).toFixed(
+                2
+              )}MB)`, // POWERED BY PRETTIER
+              "normal",
+              true
+            );
+            break;
+          case "struggling":
+            GLOBAL_FUNCTIONS.updatePBarStatus(100, info.message, "warning");
+            break;
+          case "cancelled":
+            GLOBAL_FUNCTIONS.updateOperationBtnStatus("Refresh", false);
            GLOBAL_FUNCTIONS.updateOperationBtnStatus(
              "Download",
-              true,
-              `下载 ${Math.round(info.progress)}%`
+              false,
+              "下载内核"
            );
            break;
        }
@@ -594,11 +762,56 @@ if (!global.__HUGO_AURA_UI_REACTIVES__.subConfig)

      ipcRenderer.on(CUR_CHANNEL, callbackFn);

-      ipcRenderer.invoke(`$aura.pls.downloadPls`, {
+      ipcRenderer.invoke(`${IPC_METHOD_BASE}.downloadPls`, {
        channel: "stable",
        reportTo: "assistant",
      });
    },
+
+    cancelDownloadTask: async () => {
+      const taskId =
+        global.__HUGO_AURA_UI_REACTIVES__.subConfig.plsStatus.curDlTaskId;
+
+      if (!taskId) {
+        GLOBAL_FUNCTIONS.updateToast(
+          "error",
+          "操作取消失败",
+          "<p>未能获取当前的下载任务 ID</p>",
+          true,
+          true,
+          3000
+        );
+        return false;
+      }
+
+      const result = await ipcRenderer.invoke(
+        "$aura.fs.dl.cancelDownloadTask",
+        { targetTaskId: taskId }
+      );
+
+      if (result.success) {
+        GLOBAL_FUNCTIONS.updateToast(
+          "success",
+          "操作取消成功",
+          null,
+          true,
+          true,
+          2000
+        );
+        GLOBAL_FUNCTIONS.switchPBarShowStatus(false);
+        return true;
+      } else {
+        GLOBAL_FUNCTIONS.updateToast(
+          "error",
+          "操作取消失败",
+          `<p>错误代码: ${result.error}</p>`,
+          true,
+          true,
+          3000
+        );
+        return false;
+      }
+    },
  };

  const GLOBAL_FUNCTIONS =
--- a/src/aura/ui/pages/configSubPages/behaviourCtrl/settings/previews/freezeOverridePreview/freezeOverridePreview.js
+++ b/src/aura/ui/pages/configSubPages/behaviourCtrl/settings/previews/freezeOverridePreview/freezeOverridePreview.js
@@ -32,6 +32,14 @@
          }
        )
          .then(async (response) => {
+            if (response.status !== 200) {
+              resolve({
+                success: true,
+                data: null,
+                status: response.status
+              })
+            }
+
            const parsedData = await response.json();

            resolve({
--- a/src/aura/ui/pages/configSubPages/preferences/settings/aura.js
+++ b/src/aura/ui/pages/configSubPages/preferences/settings/aura.js
@@ -96,12 +96,9 @@ const functions = {

    const handleExit = async () => {
      const result = await awaitCompletePromise;
-      console.debug(result);
      if (result) {
-        console.debug("ret true");
        return { valid: true };
      } else {
-        console.debug("ret false");
        const inputEl = document.getElementById("auraSettingsPasswd");
        // @ts-expect-error
        inputEl.value = "";
@@ -155,6 +152,27 @@ const functions = {

    return await handleExit();
  },
+
+  getCurAccessMethodCount: () => {
+    const fallbackMethods =
+      global.__HUGO_AURA_CONFIG__.auraSettings.uiAccessMethod
+        .fallbackAccessMethods;
+    const fallbackMethodsKeys = Object.keys(fallbackMethods);
+
+    let enabledCount = 0;
+
+    for (const method of fallbackMethodsKeys) {
+      if (fallbackMethods[method]) {
+        enabledCount += 1;
+      }
+    }
+
+    if (global.__HUGO_AURA_CONFIG__.auraSettings.uiAccessMethod.showEntryIcon) {
+      enabledCount += 1;
+    }
+
+    return enabledCount;
+  },
 };

 const auraSettings = [
@@ -170,8 +188,6 @@ const auraSettings = [
        description: "启用后, Aura 设置 UI 需要输入密码才可访问",
        restart: false,
        reload: false,
-        tip: true,
-        tipTitle: "启用访问密码将自动加密配置文件",
        associateVal: null,
        auraIf: () => true,
        defaultValue: false,
@@ -288,8 +304,142 @@ const auraSettings = [
  },
  {
    id: 1,
-    categoryName: "外观",
-    child: [],
+    categoryName: "访问方式",
+    child: [
+      {
+        index: 0,
+        id: "showEntryIcon",
+        type: "switch",
+        name: "显示 HugoAura 设置图标",
+        description: "控制 HugoAura 设置入口图标在管家首页的显示状态",
+        restart: false,
+        reload: true,
+        tip: true,
+        tipTitle: "禁用后, HugoAura 图标将不会出现在主页右上角",
+        associateVal: [
+          "auraSettings.uiAccessMethod.fallbackAccessMethods.hotkey",
+          "auraSettings.uiAccessMethod.fallbackAccessMethods.touch",
+        ],
+        auraIf: () => {
+          return true;
+        },
+        auraDisable: () => {
+          const fallbackMethods =
+            global.__HUGO_AURA_CONFIG__.auraSettings.uiAccessMethod
+              .fallbackAccessMethods;
+          const fallbackMethodsKeys = Object.keys(fallbackMethods);
+          let anyEnabled = false;
+
+          for (const method of fallbackMethodsKeys) {
+            if (fallbackMethods[method]) {
+              anyEnabled = true;
+              break;
+            }
+          }
+
+          return {
+            value: !anyEnabled,
+            tooltip: !anyEnabled ? "至少启用一个备选访问方式" : "",
+          };
+        },
+        defaultValue: false,
+        valueGetter: () => {
+          return global.__HUGO_AURA_CONFIG__.auraSettings.uiAccessMethod
+            .showEntryIcon;
+        },
+        callbackFn: async (newVal) => {
+          if (typeof newVal !== "boolean") return;
+          global.__HUGO_AURA_CONFIG__.auraSettings.uiAccessMethod.showEntryIcon =
+            newVal;
+        },
+      },
+      {
+        index: 1,
+        id: "allowHotkeyAccess",
+        type: "switch",
+        name: "使用快捷键打开 HugoAura 设置 UI",
+        description:
+          "启用后, 在管家首页按下 Ctrl + Shift + A 以打开 HugoAura 设置",
+        restart: false,
+        reload: true,
+        associateVal: [
+          "auraSettings.uiAccessMethod.showEntryIcon",
+          "auraSettings.uiAccessMethod.fallbackAccessMethods.hotkey",
+          "auraSettings.uiAccessMethod.fallbackAccessMethods.touch",
+        ],
+        auraIf: () => {
+          return true;
+        },
+        auraDisable: () => {
+          const enableCount = functions.getCurAccessMethodCount();
+          if (
+            enableCount < 2 &&
+            !global.__HUGO_AURA_CONFIG__.auraSettings.uiAccessMethod
+              .showEntryIcon &&
+            global.__HUGO_AURA_CONFIG__.auraSettings.uiAccessMethod
+              .fallbackAccessMethods.hotkey
+          ) {
+            return { value: true, tooltip: "无法禁用所有访问方式" };
+          } else {
+            return { value: false };
+          }
+        },
+        defaultValue: false,
+        valueGetter: () => {
+          return global.__HUGO_AURA_CONFIG__.auraSettings.uiAccessMethod
+            .fallbackAccessMethods.hotkey;
+        },
+        callbackFn: async (newVal) => {
+          if (typeof newVal !== "boolean") return;
+          global.__HUGO_AURA_CONFIG__.auraSettings.uiAccessMethod.fallbackAccessMethods.hotkey =
+            newVal;
+        },
+      },
+      {
+        index: 2,
+        id: "allowTouchAccess",
+        type: "switch",
+        name: "使用触摸手势打开 HugoAura 设置 UI",
+        description:
+          "启用后, 在管家首页连击 7 次右上角信息栏 ( i ) 中的版本号区域以打开 HugoAura 设置",
+        restart: false,
+        reload: true,
+        tip: true,
+        tipTitle: "请在 10 秒钟内完成连击操作, 否则计时器将被重置",
+        associateVal: [
+          "auraSettings.uiAccessMethod.showEntryIcon",
+          "auraSettings.uiAccessMethod.fallbackAccessMethods.hotkey",
+          "auraSettings.uiAccessMethod.fallbackAccessMethods.touch",
+        ],
+        auraIf: () => {
+          return true;
+        },
+        auraDisable: () => {
+          const enableCount = functions.getCurAccessMethodCount();
+          if (
+            enableCount < 2 &&
+            !global.__HUGO_AURA_CONFIG__.auraSettings.uiAccessMethod
+              .showEntryIcon &&
+            global.__HUGO_AURA_CONFIG__.auraSettings.uiAccessMethod
+              .fallbackAccessMethods.touch
+          ) {
+            return { value: true, tooltip: "无法禁用所有访问方式" };
+          } else {
+            return { value: false };
+          }
+        },
+        defaultValue: false,
+        valueGetter: () => {
+          return global.__HUGO_AURA_CONFIG__.auraSettings.uiAccessMethod
+            .fallbackAccessMethods.touch;
+        },
+        callbackFn: async (newVal) => {
+          if (typeof newVal !== "boolean") return;
+          global.__HUGO_AURA_CONFIG__.auraSettings.uiAccessMethod.fallbackAccessMethods.touch =
+            newVal;
+        },
+      },
+    ],
  },
 ];

--- a/src/aura/ui/pages/headerIcon/headerIcon.css
+++ b/src/aura/ui/pages/headerIcon/headerIcon.css
@@ -7,6 +7,10 @@
  transition: opacity 0.25s;
 }

+.aura-header-icon.aura-header-icon-hidden {
+  display: none;
+}
+
 .aura-header-icon:hover {
  opacity: 0.75;
 }
--- a/src/aura/ui/pages/headerIcon/headerIcon.js
+++ b/src/aura/ui/pages/headerIcon/headerIcon.js
@@ -1,5 +1,54 @@
 global.__HUGO_AURA_UI_FUNCTIONS__.headerIcon = {
  showAuraConfig: () => {
-    window.__HUGO_AURA_LOADER__["Aura.UI.Assistant.Config"].active = true;
+    if (global.__HUGO_AURA_LOADER__["Aura.UI.Assistant.Config"].active) return;
+    global.__HUGO_AURA_LOADER__["Aura.UI.Assistant.Config"].active = true;
  },
 };
+
+(() => {
+  let clickCounter = 0;
+  let clickTimeout = null;
+
+  const onMounted = () => {
+    if (!global.__HUGO_AURA_CONFIG__.auraSettings.uiAccessMethod.showEntryIcon) {
+      const iconEl = document.getElementsByClassName("aura-header-icon")[0];
+      iconEl.classList.add("aura-header-icon-hidden");
+    }
+
+    if (
+      global.__HUGO_AURA_CONFIG__.auraSettings.uiAccessMethod
+        .fallbackAccessMethods.hotkey
+    ) {
+      document.addEventListener("keydown", (event) => {
+        if (event.ctrlKey && event.shiftKey && event.key === "A") {
+          global.__HUGO_AURA_UI_FUNCTIONS__.headerIcon.showAuraConfig();
+        }
+      });
+    }
+
+    if (
+      global.__HUGO_AURA_CONFIG__.auraSettings.uiAccessMethod
+        .fallbackAccessMethods.touch
+    ) {
+      const mesModelEl = document.getElementsByClassName(
+        "index__mes-modal__2hRouc6M"
+      )[0];
+      const verEl = mesModelEl.children[0];
+      verEl.onclick = () => {
+        clickCounter += 1;
+        if (clickCounter >= 7) {
+          global.__HUGO_AURA_UI_FUNCTIONS__.headerIcon.showAuraConfig();
+          clickCounter = 0;
+          if (clickTimeout) {
+            clearTimeout(clickTimeout);
+          }
+        }
+        clickTimeout = setTimeout(() => {
+          clickCounter = 0;
+        }, 10000);
+      };
+    }
+  };
+
+  onMounted();
+})();
--- a/src/core/hook.js
+++ b/src/core/hook.js
@@ -19,9 +19,15 @@ if (!global.__HUGO_AURA__) {
 if (!global.__HUGO_AURA_API__) {
  /** @type {import("../aura/types/shared/global").GlobalHugoAuraApiInfo} */
  const __HUGO_AURA_API__ = {
-    baseUrl: "https://api-aura.xwx.li",
-    plsUpdate: "/api/v1/getPLSLatestVersion",
-    auraUpdate: "/api/v1/getAuraLatestVersion",
+    domains: [
+      "https://api-aura-projekts.delta.ooo",
+      "https://api-aura.asaka.site",
+      "https://api.hugoaura.dpdns.org",
+      "https://api-aura-projekts.minorice.moe",
+      "https://api.aura.vim.moe"
+    ],
+    plsUpdate: "/api/getPLSLatestVersion",
+    auraUpdate: "/api/getAuraLatestVersion",
  };
  global.__HUGO_AURA_API__ = __HUGO_AURA_API__;
 }
@@ -30,11 +36,6 @@ if (!global.__HUGO_AURA_CONFIG__) {
  global.__HUGO_AURA_CONFIG__ = {};
 }

-const fs = require("fs");
-const util = require("util");
-const path = require("path");
-const os = require("os");
-
 const MainProcessHooksManager = require("../aura/init/main/windowHooksManager");
 const RendererHooksManager = require("../aura/init/rendererHook/uiHooksManager");
 const EventBus = require("../aura/utils/eventBus");
@@ -42,70 +43,7 @@ const NetworkHook = require("../aura/init/rendererHook/networkHook");
 const ConfigManager = require("../aura/init/shared/configManager");
 const { buildIpcMain } = require("../aura/init/main/ipcHandler");

-/**
- *
- * @param {import("../aura/types/main/core").WindowName} windowName
- */
-const initLogger = (windowName) => {
-  const logDir = path.join(os.homedir(), "Documents", "HugoAura", "logs");
-  if (!fs.existsSync(logDir)) {
-    fs.mkdirSync(logDir, { recursive: true });
-  }
-
-  const logFile = path.join(
-    logDir,
-    `main-${windowName}-${new Date().toISOString().replace(/:/g, "-")}.log`
-  );
-  const logStream = fs.createWriteStream(logFile, { flags: "a" });
-
-  const originalConsole = {
-    log: console.log,
-    error: console.error,
-    warn: console.warn,
-    info: console.info,
-    debug: console.debug,
-  };
-
-  console.log = function (...args) {
-    const msg = util.format("[LOG] ", ...args) + "\n";
-    logStream.write(msg);
-    originalConsole.log.apply(console, args);
-  };
-
-  console.error = function (...args) {
-    const msg = util.format("[ERROR] ", ...args) + "\n";
-    logStream.write(msg);
-    originalConsole.error.apply(console, args);
-  };
-
-  console.warn = function (...args) {
-    const msg = util.format("[WARN] ", ...args) + "\n";
-    logStream.write(msg);
-    originalConsole.warn.apply(console, args);
-  };
-
-  console.info = function (...args) {
-    const msg = util.format("[INFO] ", ...args) + "\n";
-    logStream.write(msg);
-    originalConsole.info.apply(console, args);
-  };
-
-  console.debug = function (...args) {
-    if (!process.argv.includes("--aura-debug")) return;
-    const msg = util.format("[DEBUG] ", ...args) + "\n";
-    logStream.write(msg);
-    originalConsole.debug.apply(console, args);
-  };
-
-  process.on("uncaughtException", (err) => {
-    console.error("UNCAUGHT EXCEPTION:", err);
-  });
-
-  console.log(
-    "[HugoAura / Init / Logger] Logger initialized. Log file:",
-    logFile
-  );
-};
+const { initLogger } = require("../aura/init/main/logger");

 /**
 *
Author	SHA1	Message	Date
Minoricew	ef0e39dd8c	[🔁 Chore] Auto upload release for workflow	2025-06-14 16:51:28 +08:00
Minoricew	9a2a335742	[✨ Feat] {#21} Add AppBar window oper icons 1. [+] {#21} 增加了应用栏 (顶栏) 上的窗口操作按钮 2. [-] 删掉了几个调试时留下的 console.debug	2025-06-14 16:07:10 +08:00
Minoricew	e63c989d88	[🚧 Fix] Infrastructure logic errors 1. [/] 修复了 Header Icon 默认样式为 Hidden, 导致 UI Loader 尝试 Revive 后 Header Icon 消失的异常。 2. [/] 修正了一个 PLS 连接逻辑错误 (未正确处理更新 `installed` 参数的时机)。 3. [/] 修正了冰点上报拦截预览视图中, 未正确判断状态码导致的异常。	2025-06-13 22:26:36 +08:00
Minoricew	70ffa3f581	[✨ Feat] <Settings UI> Support custom access methods 1. [/] 修复了 PLS 下载时, 目录未递归创建导致的 ENOENT 错误。 2. [+] 现在可以通过多种方式访问 Aura 设置 UI 了, 更多详细信息, 请参见 #18。 3. [↑] 优化了 Tooltip 的渲染逻辑。	2025-06-13 16:24:10 +08:00
Minoricew	c0249693a8	[🚧 Fix] <Settings> Invalid (outdated) tip msg in pref/aura 1. [-] 删除了来自旧版本的 Tip (现在配置文件已经可以手动启 / 禁用加密了)	2025-06-13 12:12:46 +08:00
Minoricew	ca5d94ebd8	[🚧 Fix] <PLS & FS> Improve PLS download logic & UX 1. [+] 增加了 PLS 下载操作的取消功能 2. [/] 修复了 FS IPC 中 `downloadFile` 时, 过早地从 downloadTasks 中删除任务的逻辑错误。 3. [↑] 改进了 PLS IPC 中 `handlePLSDownload` 获取版本信息时的逻辑, 现在该函数会从全局 API 信息中逐个尝试 API 域名。减少了极端网络环境下, 版本信息获取失败的可能性。 4. [/] 修复了下载失败后, 下载按钮依然保持灰显的问题。 5. [+] 为 PLS 下载增加了进度条显示。 6. [/] 优化了 `plsConnectionManager` 中一些不必要的 IPC 状态同步 (有些时候还会导致逻辑错误)。	2025-06-13 11:49:22 +08:00
Minoricew	a9d3772b51	[Fix] <PLS> More verbose logging & Change API domain	2025-06-12 20:30:13 +08:00
Minoricew	9e63a9374f	[Feat] Log file auto cleanup (#15 ) & Improve logger experience Co-authored-by: TianMiao <tianmiao.work@foxmail.com>	2025-06-11 17:59:57 +08:00
Minoricew	c3a70ece88	[Fix] IPC plsStats not sync	2025-06-11 17:29:28 +08:00