@e-xi/xion 0.0.6

package/dist/main/app/index.js

@@ -0,0 +1,1226 @@
+import {
+  TrayManager
+} from "../../chunk-files/chunk-D5ZV4VMI.js";
+import {
+  UpdaterManager
+} from "../../chunk-files/chunk-LFHJJQW3.js";
+import {
+  WindowManager
+} from "../../chunk-files/chunk-DRMV3M5V.js";
+import {
+  WindowUtil
+} from "../../chunk-files/chunk-YZOJOLFL.js";
+import {
+  MenuManager
+} from "../../chunk-files/chunk-UFYEZIUE.js";
+import "../../chunk-files/chunk-GUOSVDXA.js";
+import "../../chunk-files/chunk-EQTU45UO.js";
+import {
+  ProtocolManager
+} from "../../chunk-files/chunk-IMGYTSWY.js";
+import {
+  RemoteServiceManager
+} from "../../chunk-files/chunk-DD6WZ4NY.js";
+import {
+  RendererProtocolManager
+} from "../../chunk-files/chunk-UCMR6V67.js";
+import "../../chunk-files/chunk-WOJ2UKI7.js";
+import {
+  ShortcutManager
+} from "../../chunk-files/chunk-BJOPQNB2.js";
+import "../../chunk-files/chunk-Q7LCZIQP.js";
+import "../../chunk-files/chunk-GROGDGEL.js";
+import {
+  AppStore
+} from "../../chunk-files/chunk-4HEDNQUP.js";
+import {
+  ThemeManager
+} from "../../chunk-files/chunk-3XB4IEWO.js";
+import "../../chunk-files/chunk-SVTZ4T6S.js";
+import {
+  JwtAuthManager
+} from "../../chunk-files/chunk-MJ6Q3TIX.js";
+import "../../chunk-files/chunk-J34MOWJP.js";
+import "../../chunk-files/chunk-B7DTBTWQ.js";
+import {
+  BannerManager
+} from "../../chunk-files/chunk-5PKWVAQP.js";
+import "../../chunk-files/chunk-YLZRRUY7.js";
+import {
+  defineAppConfig,
+  defineRemoteServiceConfig,
+  defineUpdaterConfig
+} from "../../chunk-files/chunk-34OODP7M.js";
+import "../../chunk-files/chunk-Q7YMMN7J.js";
+import "../../chunk-files/chunk-F7YTK2MY.js";
+import "../../chunk-files/chunk-3S5OTD47.js";
+import "../../chunk-files/chunk-DEODEAKM.js";
+import "../../chunk-files/chunk-6X74EPRM.js";
+import {
+  FileAssociationManager
+} from "../../chunk-files/chunk-IH3R2NDR.js";
+import {
+  FileAssociationUtil
+} from "../../chunk-files/chunk-VGDNICVG.js";
+import {
+  IpcManager
+} from "../../chunk-files/chunk-4SSGMLEE.js";
+import "../../chunk-files/chunk-W2I3I7U7.js";
+import "../../chunk-files/chunk-BPTFUGTP.js";
+import {
+  MainWindowIdentity
+} from "../../chunk-files/chunk-KFV4GXVE.js";
+import "../../chunk-files/chunk-RAVPJRBA.js";
+import "../../chunk-files/chunk-LQ67F6EY.js";
+import "../../chunk-files/chunk-BFD2LHLK.js";
+import {
+  SettingWindowIdentity
+} from "../../chunk-files/chunk-PVWRRUOK.js";
+import "../../chunk-files/chunk-OUFO3LM4.js";
+import "../../chunk-files/chunk-6FDO72PN.js";
+import "../../chunk-files/chunk-U4XEWVBH.js";
+import "../../chunk-files/chunk-BMOLIJ3W.js";
+import "../../chunk-files/chunk-RN7AI33H.js";
+import "../../chunk-files/chunk-6BOPFOZD.js";
+import "../../chunk-files/chunk-WKVLVI6N.js";
+import "../../chunk-files/chunk-Y3OEXVQ2.js";
+import "../../chunk-files/chunk-UIJUY7QZ.js";
+import "../../chunk-files/chunk-T3QCAOCO.js";
+import "../../chunk-files/chunk-ID3YDA2K.js";
+import {
+  ProtocolUtil
+} from "../../chunk-files/chunk-KFK47PDH.js";
+import {
+  XoLogger
+} from "../../chunk-files/chunk-YXAEUJKJ.js";
+import "../../chunk-files/chunk-P4CX6I4J.js";
+import "../../chunk-files/chunk-3KBZWBNP.js";
+import "../../chunk-files/chunk-FPN7JYR4.js";
+import "../../chunk-files/chunk-RODB64YF.js";
+import "../../chunk-files/chunk-GN2FNR3Z.js";
+import "../../chunk-files/chunk-3RVKOFMP.js";
+import "../../chunk-files/chunk-FMQTZ3QV.js";
+
+// src/main/app/app-lifecycle-abstract.ts
+import { app, BrowserWindow, dialog, globalShortcut } from "electron";
+var AppLifecycleAbstract = class {
+  /**
+   * XionApp
+   * @type {XoAppAbstract}
+   * @protected
+   */
+  xoApp;
+  /**
+   * 构造函数
+   */
+  constructor(xoApp) {
+    this.xoApp = xoApp;
+  }
+  /**
+   * XionApp 启动前
+   * <p>此阶段通常用于应用启动前的准备工作，如校验配置、注册全局处理器等。</p>
+   * @returns {Promise<void>}
+   */
+  async xoAppBeforeStart() {
+  }
+  /**
+   * XionApp 启动后
+   * <p>此阶段通常用于应用启动完成后的补充工作，如主动检查更新、输出启动日志等。</p>
+   * @returns {Promise<void>}
+   */
+  async xoAppAfterStart() {
+  }
+  /**
+   * Electron 就绪
+   * <p>对应 app.whenReady() 阶段，此时可以安全地创建窗口、初始化菜单等。</p>
+   * @returns {Promise<void>}
+   */
+  async whenReady() {
+    const silentLaunchMode = this.xoApp.isSilentLaunchMode();
+    const appConfig = this.xoApp.getAppConfig();
+    if (!appConfig?.eletronAppConfig?.appId) {
+      await this.dialogAndExit("\u7F3A\u5C11\u914D\u7F6E appConfig.eletronAppConfig.appId");
+    }
+    if (!appConfig?.eletronAppConfig?.productName) {
+      await this.dialogAndExit("\u7F3A\u5C11\u914D\u7F6E appConfig.eletronAppConfig.productName");
+    }
+    this.setAppUserModelId(appConfig?.eletronAppConfig?.appId);
+    this.setAppName(appConfig?.eletronAppConfig?.productName);
+    this.setLaunchOnStartup();
+    this.xoApp.getProtocolManager().registerClients();
+    const protocolManager = this.xoApp.getProtocolManager();
+    const fileAssociationManager = this.xoApp.getFileAssociationManager();
+    await protocolManager.handleArgv(process.argv);
+    await protocolManager.setReady();
+    await fileAssociationManager.handleArgv(process.argv);
+    await fileAssociationManager.setReady();
+    silentLaunchMode && this.xoApp.getTrayManager().setBlur();
+    if (BrowserWindow.getAllWindows().length === 0) {
+      await this.xoApp.createMainWindow();
+    }
+    this.hideAllWindowsIfSilentLaunchMode(silentLaunchMode);
+  }
+  /**
+   * 浏览器窗口创建后
+   * <p>对应 app.on('browser-window-created') 事件。</p>
+   * @param {Electron.Event}         event  事件对象
+   * @param {Electron.BrowserWindow} window 窗口
+   * @returns {Promise<void>}
+   */
+  async onBrowserWindowCreated(event, window) {
+  }
+  /**
+   * 浏览器窗口获得焦点
+   * <p>对应 app.on('browser-window-focus') 事件。</p>
+   * @param {Electron.Event}         event  事件对象
+   * @param {Electron.BrowserWindow} window 窗口
+   * @returns {Promise<void>}
+   */
+  async onBrowserWindowFocus(event, window) {
+  }
+  /**
+   * 浏览器窗口失去焦点
+   * <p>对应 app.on('browser-window-blur') 事件。</p>
+   * @param {Electron.Event}         event  事件对象
+   * @param {Electron.BrowserWindow} window 窗口
+   * @returns {Promise<void>}
+   */
+  async onBrowserWindowBlur(event, window) {
+  }
+  /**
+   * 应用激活
+   * <p>对应 app.on('activate') 事件，常用于 macOS 下在无窗口时重新创建主窗口。</p>
+   * @param {Electron.Event} event             事件对象
+   * @param {boolean}        hasVisibleWindows 是否存在可见窗口
+   * @returns {Promise<void>}
+   */
+  async onActivate(event, hasVisibleWindows) {
+    if (BrowserWindow.getAllWindows().length === 0) {
+      await this.xoApp.showMainWindow();
+    }
+  }
+  /**
+   * 第二个实例启动
+   * <p>对应 app.on('second-instance') 事件，常用于单实例应用聚焦主窗口。</p>
+   * @param {Electron.Event} event            事件对象
+   * @param {string[]}       argv             第二个实例的命令行参数
+   * @param {string}         workingDirectory 第二个实例工作目录
+   * @param {unknown}        additionalData   第二个实例附加数据
+   * @returns {Promise<void>}
+   */
+  async onSecondInstance(event, argv, workingDirectory, additionalData) {
+    const protocolHandled = await this.xoApp.getProtocolManager().handleArgv(argv);
+    const fileAssociationHandled = await this.xoApp.getFileAssociationManager().handleArgv(argv);
+    if (!protocolHandled && !fileAssociationHandled) {
+      const mainWindow = await this.xoApp.getMainWindow();
+      this.xoApp.getWindowManager().showByWindow(mainWindow);
+    }
+  }
+  /**
+   * 所有窗口关闭
+   * <p>对应 app.on('window-all-closed') 事件，常用于非 macOS 平台退出应用。</p>
+   * @returns {Promise<void>}
+   */
+  async onWindowAllClosed() {
+    this.xoApp.appLog.info("\u6240\u6709\u7A97\u53E3\u5DF2\u5173\u95ED");
+    if (process.platform !== "darwin") {
+      app.quit();
+    }
+  }
+  /**
+   * 应用退出前
+   * <p>对应 app.on('before-quit') 事件，适合做退出前的收尾工作。</p>
+   * @param {Electron.Event} event 事件对象
+   * @returns {Promise<void>}
+   */
+  async onBeforeQuit(event) {
+  }
+  /**
+   * 应用即将退出
+   * <p>对应 app.on('will-quit') 事件，适合做最终清理工作。</p>
+   * @param {Electron.Event} event 事件对象
+   * @returns {Promise<void>}
+   */
+  async onWillQuit(event) {
+    globalShortcut.unregisterAll();
+  }
+  /**
+   * 应用打开文件
+   * <p>对应 app.on('open-file') 事件，主要用于 macOS 文件关联场景。</p>
+   * @param {Electron.Event} event 事件对象
+   * @param {string}         path  文件路径
+   * @returns {Promise<void>}
+   */
+  async onOpenFile(event, path) {
+    event.preventDefault();
+    await this.xoApp.getFileAssociationManager().handleFile(path);
+  }
+  /**
+   * 应用打开 URL
+   * <p>对应 app.on('open-url') 事件，主要用于 macOS 协议唤起场景。</p>
+   * @param {Electron.Event} event 事件对象
+   * @param {string}         url   URL 地址
+   * @returns {Promise<void>}
+   */
+  async onOpenUrl(event, url) {
+    event.preventDefault();
+    await this.xoApp.getProtocolManager().handleUrl(url);
+  }
+  /**
+   * WebContents 创建后
+   * <p>对应 app.on('web-contents-created') 事件。</p>
+   * @param {Electron.Event}       event       事件对象
+   * @param {Electron.WebContents} webContents WebContents
+   * @returns {Promise<void>}
+   */
+  async onWebContentsCreated(event, webContents) {
+  }
+  /**
+   * Electron Session 创建后
+   * <p>对应 app.on('session-created') 事件。</p>
+   * @param {Electron.Session} session Session
+   * @returns {Promise<void>}
+   */
+  async onSessionCreated(session) {
+  }
+  /**
+   * 子进程退出
+   * <p>对应 app.on('child-process-gone') 事件。</p>
+   * @param {Electron.Event}   event   事件对象
+   * @param {Electron.Details} details 子进程退出详情
+   * @returns {Promise<void>}
+   */
+  async onChildProcessGone(event, details) {
+    this.xoApp.appLog.error("\u5B50\u8FDB\u7A0B\u5DF2\u9000\u51FA", details);
+  }
+  /**
+   * GPU 信息更新
+   * <p>对应 app.on('gpu-info-update') 事件。</p>
+   * @returns {Promise<void>}
+   */
+  async onGpuInfoUpdate() {
+  }
+  /**
+   * 渲染进程崩溃
+   * <p>对应 app.on('render-process-gone') 事件。</p>
+   * @param {Electron.Event}                    event       事件对象
+   * @param {Electron.WebContents}              webContents WebContents
+   * @param {Electron.RenderProcessGoneDetails} details     渲染进程崩溃详情
+   * @returns {Promise<void>}
+   */
+  async onRenderProcessGone(event, webContents, details) {
+    this.xoApp.appLog.error("\u6E32\u67D3\u8FDB\u7A0B\u5DF2\u9000\u51FA", details);
+  }
+  /**
+   * XionApp 运行错误
+   * <p>统一处理启动流程中的错误。对于 uncaughtException、unhandledRejection 这类更底层的 Node 事件，
+   * 建议在具体实现中按需注册后仍汇总到此方法处理，而不是在生命周期抽象中额外拆出独立钩子。</p>
+   * @param {unknown}       error 错误对象
+   * @returns {Promise<void>}
+   */
+  async onError(error) {
+    this.xoApp.appLog.error("[Lifecycle]", { source: error.source }, error.error);
+  }
+  //<editor-fold desc="内部方法">
+  /**
+   * 设置应用名称
+   * @param {string} productName 应用名称
+   * @private
+   */
+  setAppName(productName) {
+    productName && app.setName(productName);
+  }
+  /**
+   * 设置 APPID
+   * @param {string} appId APPID
+   * @private
+   */
+  setAppUserModelId(appId) {
+    if (process.platform !== "win32") return;
+    appId && app.setAppUserModelId(appId);
+  }
+  /**
+   * 如果是静默启动模式，则隐藏所有窗口
+   * @param {boolean} silentStartupMode 是否静默启动模式
+   * @private
+   */
+  hideAllWindowsIfSilentLaunchMode(silentStartupMode) {
+    silentStartupMode && this.xoApp.getWindowManager().hideAll();
+  }
+  /**
+   * 设置开机启动
+   * @private
+   */
+  setLaunchOnStartup() {
+    const isLaunchOnStartup = this.xoApp.isLaunchOnStartup();
+    app.setLoginItemSettings({ openAtLogin: isLaunchOnStartup });
+  }
+  //</editor-fold>
+  /**
+   * 提示并退出
+   * @param {string} message 消息
+   * @returns {Promise<void>}
+   * @private
+   */
+  async dialogAndExit(message) {
+    await dialog.showMessageBox({
+      type: "error",
+      title: "\u9519\u8BEF",
+      message: "\u5E94\u7528\u542F\u52A8\u5931\u8D25",
+      detail: message,
+      buttons: ["\u9000\u51FA"],
+      defaultId: 0,
+      noLink: true
+    });
+    this.xoApp.appLog.error("\u5E94\u7528\u542F\u52A8\u5931\u8D25", message);
+    app.exit(1);
+  }
+};
+
+// src/main/app/app-lifecycle.ts
+var AppLifecycle = class extends AppLifecycleAbstract {
+};
+
+// src/main/app/xo-app-abstract.ts
+import { app as app2, BrowserWindow as BrowserWindow2 } from "electron";
+var XoAppAbstract = class {
+  //<editor-fold desc="内部属性">
+  /**
+   * Banner 管理器
+   * @type {BannerAbstract}
+   * @protected
+   */
+  bannerManager;
+  /**
+   * XionApp 配置
+   * @type {XoApp.Config}
+   * @protected
+   */
+  appConfig;
+  /**
+   * 更新器配置
+   * @type {XoUpdater.Config}
+   * @protected
+   */
+  updaterConfig;
+  /**
+   * 远程服务配置
+   * @type {XoRemoteService.Config}
+   * @protected
+   */
+  remoteServiceConfig;
+  /**
+   * 生命周期
+   * @type {AppLifecycleAbstract}
+   * @protected
+   */
+  lifecycle;
+  /**
+   * 主窗口
+   * @type {Electron.BrowserWindow}
+   * @protected
+   */
+  mainWindow;
+  /**
+   * 设置窗口
+   * @type {Electron.BrowserWindow}
+   * @protected
+   */
+  settingWindow;
+  /**
+   * 设置窗口创建任务
+   * @type {Promise<Electron.BrowserWindow>}
+   * @protected
+   */
+  settingWindowPromise;
+  /**
+   * 窗口管理器
+   * @type {WindowManager}
+   * @protected
+   */
+  windowManager;
+  /**
+   * 托盘管理器
+   * @type {TrayManager}
+   * @protected
+   */
+  trayManager;
+  /**
+   * IPC 管理器
+   * @type {IpcManagerAbstract}
+   * @protected
+   */
+  ipcManager;
+  /**
+   * 菜单管理器
+   * @type {MenuManager}
+   * @protected
+   */
+  menuManager;
+  /**
+   * 协议管理器
+   * @type {ProtocolManagerAbstract}
+   * @protected
+   */
+  protocolManager;
+  /**
+   * 渲染进程协议管理器
+   * @type {RendererProtocolManagerAbstract}
+   * @protected
+   */
+  rendererProtocolManager;
+  /**
+   * 文件关联管理器
+   * @type {FileAssociationManagerAbstract}
+   * @protected
+   */
+  fileAssociationManager;
+  /**
+   * 主题管理器
+   * @type {ThemeManagerAbstract}
+   * @protected
+   */
+  themeManager;
+  /**
+   * 更新器管理器
+   * @type {UpdaterManagerAbstract}
+   * @protected
+   */
+  updaterManager;
+  /**
+   * 远程服务管理器
+   * @type {RemoteServiceManagerAbstract}
+   * @protected
+   */
+  remoteServiceManager;
+  /**
+   * JWT 认证管理器
+   * @type {JwtAuthManager}
+   * @protected
+   */
+  authManager;
+  /**
+   * 快捷键管理器
+   * @type {ShortcutManagerAbstract}
+   * @protected
+   */
+  shortcutManager;
+  /**
+   * App 设置存储
+   * @type {AppStore}
+   * @protected
+   */
+  appStore;
+  /**
+   * 主进程日志管理器
+   * @type {XoLogger}
+   * @protected
+   */
+  mainLogger;
+  /**
+   * 预加载日志管理器
+   * @type {XoLogger}
+   * @protected
+   */
+  preloadLogger;
+  /**
+   * 渲染进程日志管理器
+   * @type {XoLogger}
+   * @protected
+   */
+  rendererLogger;
+  /**
+   * XionApp 是否已启动
+   * @private
+   */
+  started = false;
+  /**
+   * App 是否正在退出
+   * @private
+   */
+  quitting = false;
+  //</editor-fold>
+  //<editor-fold desc="构造函数">
+  /**
+   * 构造函数
+   * @param {XoApp.ConstructorOptions} options 构造选项
+   * @protected
+   */
+  constructor(options) {
+    this.appConfig = defineAppConfig(options?.appConfig);
+    this.updaterConfig = defineUpdaterConfig(options?.updaterConfig);
+    this.remoteServiceConfig = defineRemoteServiceConfig(options?.remoteServiceConfig);
+    this.mainLogger = new XoLogger("main", options?.loggerConfig);
+    this.preloadLogger = new XoLogger("preload", options?.loggerConfig);
+    this.rendererLogger = new XoLogger("renderer", options?.loggerConfig);
+    this.disableConsoleLogsForAppPackaged([
+      this.mainLogger,
+      this.preloadLogger,
+      this.rendererLogger
+    ]);
+    this.appStore = new AppStore();
+    this.applyLogLevel(this.appStore.getLogLevel());
+    this.lifecycle = new (options?.lifecycle ?? AppLifecycle)(this);
+    this.bannerManager = new (options?.bannerManager ?? BannerManager)(this);
+    this.menuManager = new (options?.menuManager ?? MenuManager)(this);
+    this.protocolManager = new (options?.protocolManager ?? ProtocolManager)(this);
+    this.rendererProtocolManager = new (options?.rendererProtocolManager ?? RendererProtocolManager)(this);
+    this.fileAssociationManager = new (options?.fileAssociationManager ?? FileAssociationManager)(this);
+    this.themeManager = new (options?.themeManager ?? ThemeManager)(this);
+    this.updaterManager = new (options?.updaterManager ?? UpdaterManager)(this);
+    this.remoteServiceManager = new (options?.remoteServiceManager ?? RemoteServiceManager)(this);
+    this.authManager = new JwtAuthManager(this, options?.jwtAuthProvider ? new options.jwtAuthProvider() : void 0);
+    this.shortcutManager = new (options?.shortcutManager ?? ShortcutManager)(this);
+    this.ipcManager = new (options?.ipcManager ?? IpcManager)(this);
+    this.windowManager = new WindowManager(this, options?.windowTypes);
+    this.trayManager = new TrayManager(this, options?.trayConfig);
+  }
+  /**
+   * 生产环境时关闭控制台日志，文件日志保持不变
+   * @param {readonly XoLogger[]} loggers 日志管理器数组
+   * @returns {void}
+   * @private
+   */
+  disableConsoleLogsForAppPackaged(loggers) {
+    if (!app2.isPackaged) {
+      return;
+    }
+    for (const logger of loggers) {
+      const consoleTransport = logger.log.transports.console;
+      if (consoleTransport) {
+        consoleTransport.level = false;
+      }
+    }
+  }
+  //</editor-fold>
+  //<editor-fold desc="日志 Getter">
+  /**
+   * 主进程日志（无 scope）
+   * @returns {Logger}
+   */
+  get mainLog() {
+    return this.mainLogger.log;
+  }
+  /**
+   * 主进程 App 日志
+   * @returns {LogFunctions}
+   */
+  get appLog() {
+    return this.mainLogger.log.scope("App");
+  }
+  /**
+   * 主进程 更新器 日志
+   * @returns {LogFunctions}
+   */
+  get updaterLog() {
+    return this.mainLogger.log.scope("Updater");
+  }
+  /**
+   * 主进程 远程服务 日志
+   * @returns {LogFunctions}
+   */
+  get remoteServiceLog() {
+    return this.mainLogger.log.scope("RemoteService");
+  }
+  /**
+   * 主进程 JWT 认证日志
+   * @returns {LogFunctions}
+   */
+  get authLog() {
+    return this.mainLogger.log.scope("Auth");
+  }
+  /**
+   * 主进程 窗口 日志
+   * @returns {LogFunctions}
+   */
+  get windowLog() {
+    return this.mainLogger.log.scope("Window");
+  }
+  /**
+   * 主进程 托盘 日志
+   * @returns {LogFunctions}
+   */
+  get trayLog() {
+    return this.mainLogger.log.scope("Tray");
+  }
+  /**
+   * 预加载日志（无 scope）
+   * @returns {Logger}
+   */
+  get preloadLog() {
+    return this.preloadLogger.log.scope("Preload");
+  }
+  /**
+   * 渲染进程日志（无 scope）
+   * @returns {Logger}
+   */
+  get rendererLog() {
+    return this.rendererLogger.log.scope("Renderer");
+  }
+  /**
+   * 获取日志等级
+   * @returns {XoLogger.Level}
+   */
+  getLogLevel() {
+    return this.appStore.getLogLevel();
+  }
+  /**
+   * 设置并存储日志等级
+   * @param {XoLogger.Level} logLevel 日志等级
+   * @returns {void}
+   */
+  setLogLevel(logLevel) {
+    logLevel ??= "info";
+    this.appStore.setLogLevel(logLevel);
+    this.applyLogLevel(logLevel);
+  }
+  /**
+   * 应用日志等级
+   * @param {XoLogger.Level} logLevel 日志等级
+   * @returns {void}
+   * @private
+   */
+  applyLogLevel(logLevel) {
+    if (!logLevel) return;
+    for (const logger of [this.mainLogger, this.preloadLogger, this.rendererLogger]) {
+      logger.setLevel(logLevel);
+    }
+  }
+  //</editor-fold>
+  //<editor-fold desc="配置 Getter">
+  /**
+   * 获取 App 配置
+   * @returns {XoApp.Config | undefined}
+   */
+  getAppConfig() {
+    return this.appConfig;
+  }
+  /**
+   * 获取更新器配置
+   * @returns {XoUpdater.Config | undefined}
+   */
+  getUpdaterConfig() {
+    return this.updaterConfig;
+  }
+  /**
+   * 获取远程服务配置
+   * @returns {XoRemoteService.Config | undefined}
+   */
+  getRemoteServiceConfig() {
+    return this.remoteServiceConfig;
+  }
+  //</editor-fold>
+  //<editor-fold desc="获取管理器">
+  /**
+   * 获取托盘管理器
+   * @returns {TrayManager}
+   */
+  getTrayManager() {
+    return this.trayManager;
+  }
+  /**
+   * 获取 IPC 管理器
+   * @returns {IpcManagerAbstract}
+   */
+  getIpcManager() {
+    return this.ipcManager;
+  }
+  /**
+   * 获取菜单管理器
+   * @returns {MenuManager}
+   */
+  getMenuManager() {
+    return this.menuManager;
+  }
+  /**
+   * 获取协议管理器
+   * @returns {ProtocolManagerAbstract}
+   */
+  getProtocolManager() {
+    return this.protocolManager;
+  }
+  /**
+   * 获取渲染进程协议管理器
+   * @returns {RendererProtocolManagerAbstract}
+   */
+  getRendererProtocolManager() {
+    return this.rendererProtocolManager;
+  }
+  /**
+   * 获取文件关联管理器
+   * @returns {FileAssociationManagerAbstract}
+   */
+  getFileAssociationManager() {
+    return this.fileAssociationManager;
+  }
+  /**
+   * 获取主题管理器
+   * @returns {ThemeManagerAbstract}
+   */
+  getThemeManager() {
+    return this.themeManager;
+  }
+  /**
+   * 获取更新器管理器
+   * @returns {UpdaterManagerAbstract}
+   */
+  getUpdaterManager() {
+    return this.updaterManager;
+  }
+  /**
+   * 获取远程服务管理器
+   * @returns {RemoteServiceManagerAbstract}
+   */
+  getRemoteServiceManager() {
+    return this.remoteServiceManager;
+  }
+  /**
+   * 获取 JWT 认证管理器
+   * @returns {JwtAuthManager}
+   */
+  getAuthManager() {
+    return this.authManager;
+  }
+  /**
+   * 获取快捷键管理器
+   * @returns {ShortcutManagerAbstract}
+   */
+  getShortcutManager() {
+    return this.shortcutManager;
+  }
+  //</editor-fold>
+  //<editor-fold desc="应用存储器">
+  /**
+   * 获取 App 设置存储
+   * @returns {AppStore}
+   */
+  getAppStore() {
+    return this.appStore;
+  }
+  /**
+   * 是否窗口启动模式
+   * @returns {boolean}
+   */
+  isWindowLaunchMode() {
+    return this.appStore.getAppLaunchMode() === "window";
+  }
+  /**
+   * 是否静默启动模式
+   * @returns {boolean}
+   */
+  isSilentLaunchMode() {
+    return this.appStore.getAppLaunchMode() === "silent";
+  }
+  /**
+   * 是否外部触发启动模式
+   * @returns {boolean}
+   * @private
+   */
+  isExternalLaunchMode() {
+    const appConfig = this.getAppConfig();
+    return ProtocolUtil.hasProtocolUrl(process.argv, appConfig?.eletronAppConfig?.protocols) || FileAssociationUtil.hasAssociatedFile(process.argv, appConfig?.eletronAppConfig?.fileAssociationExtensions);
+  }
+  /**
+   * 是否开机启动
+   * @returns {boolean}
+   */
+  isLaunchOnStartup() {
+    return this.appStore.getLaunchOnStartup();
+  }
+  //</editor-fold>
+  //<editor-fold desc="主窗口 管理">
+  /**
+   * 创建主窗口
+   * <p>框架统一在此方法中串联主窗口创建前后的生命周期。</p>
+   * @returns {Promise<Electron.BrowserWindow>}
+   */
+  async createMainWindow() {
+    this.mainWindow = await this.windowManager.reuseOrCreate(MainWindowIdentity);
+    return this.mainWindow;
+  }
+  /**
+   * 获取窗口管理器
+   * @returns {WindowManager}
+   */
+  getWindowManager() {
+    return this.windowManager;
+  }
+  /**
+   * 获取或创建主窗口
+   * @returns {Promise<Electron.BrowserWindow | undefined>}
+   */
+  async getMainWindow() {
+    if (!this.mainWindow || this.mainWindow.isDestroyed()) {
+      this.mainWindow = await this.createMainWindow();
+    }
+    return this.mainWindow;
+  }
+  /**
+   * 显示主窗口
+   * @returns {Promise<void>}
+   */
+  async showMainWindow() {
+    let window = await this.getMainWindow();
+    if (!window || window.isDestroyed()) {
+      window = await this.createMainWindow();
+    }
+    this.getWindowManager().showByWindow(window);
+  }
+  /**
+   * 隐藏主窗口
+   * @returns {Promise<void>}
+   */
+  async hideMainWindow() {
+    this.getWindowManager().hideByWindow(await this.getMainWindow());
+  }
+  /**
+   * 关闭主窗口
+   * @returns {Promise<void>}
+   */
+  async closeMainWindow() {
+    this.getWindowManager().closeByWindow(await this.getMainWindow());
+  }
+  /**
+   * 切换主窗口显示状态
+   * @returns {Promise<void>}
+   */
+  async toggleMainWindowVisible() {
+    const window = await this.getMainWindow();
+    if (!window || window?.isDestroyed()) {
+      await this.showMainWindow();
+      return;
+    }
+    if (window.isVisible() && !window.isMinimized()) {
+      window.hide();
+      return;
+    }
+    await this.showMainWindow();
+  }
+  //</editor-fold>
+  //<editor-fold desc="所有窗口">
+  /**
+   * 切换所有窗口显示状态
+   * @returns {Promise<void>}
+   */
+  async toggleAllWindowVisible() {
+    const wins = BrowserWindow2.getAllWindows();
+    if (this.mainWindow?.isVisible()) {
+      wins.forEach((win) => win.hide());
+    } else {
+      await this.showMainWindow();
+    }
+  }
+  //</editor-fold>
+  //<editor-fold desc="设置窗口 管理">
+  /**
+   * 创建设置窗口
+   * <p>窗口幂等创建与并发创建任务复用</p>
+   * @returns {Promise<Electron.BrowserWindow>}
+   */
+  async createSettingWindow() {
+    if (this.settingWindow && !this.settingWindow.isDestroyed()) {
+      return this.settingWindow;
+    }
+    if (!this.settingWindowPromise) {
+      this.settingWindowPromise = this.windowManager.reuseOrCreate(SettingWindowIdentity).then((window) => {
+        this.settingWindow = window;
+        return window;
+      });
+    }
+    const promise = this.settingWindowPromise;
+    try {
+      return await promise;
+    } finally {
+      if (this.settingWindowPromise === promise) {
+        this.settingWindowPromise = void 0;
+      }
+    }
+  }
+  /**
+   * 获取或创建设置窗口
+   * @returns {Promise<Electron.BrowserWindow | undefined>}
+   */
+  async getSettingWindow() {
+    if (!this.settingWindow || this.settingWindow.isDestroyed()) {
+      this.settingWindow = await this.createSettingWindow();
+    }
+    return this.settingWindow;
+  }
+  /**
+   * 显示设置窗口
+   * @returns {Promise<void>}
+   */
+  async showSettingWindow() {
+    let window = await this.getSettingWindow();
+    if (!window || window.isDestroyed()) {
+      window = await this.createSettingWindow();
+    }
+    const mainWindow = await this.getMainWindow();
+    if (mainWindow?.isAlwaysOnTop()) {
+      window.setAlwaysOnTop(true);
+    }
+    this.getWindowManager().ensureWindowRectangleVisible(window, mainWindow);
+    this.getWindowManager().showByWindow(window);
+  }
+  /**
+   * 隐藏设置窗口
+   * @returns {Promise<void>}
+   */
+  async hideSettingWindow() {
+    let window = await this.getSettingWindow();
+    this.getWindowManager().hideByWindow(window);
+  }
+  /**
+   * 关闭设置窗口
+   * @returns {Promise<void>}
+   */
+  async closeSettingWindow() {
+    let window = await this.getSettingWindow();
+    this.getWindowManager().closeByWindow(window);
+  }
+  /**
+   * 切换设置窗口显示状态
+   * @returns {Promise<void>}
+   */
+  async toggleSettingWindow() {
+    const window = await this.getSettingWindow();
+    if (!window || window?.isDestroyed()) {
+      return;
+    }
+    if (window.isVisible() && !window.isMinimized()) {
+      window.hide();
+      return;
+    }
+    await this.showSettingWindow();
+  }
+  //</editor-fold>
+  //<editor-fold desc="应用管理">
+  /**
+   * 启动应用
+   * @returns {Promise<void>}
+   */
+  async run() {
+    if (this.started) {
+      return;
+    }
+    this.started = true;
+    try {
+      if (!this.singleInstance()) return;
+      this.bannerManager?.printBannerLines(this.appLog.info);
+      this.appLog.info("\u7A0B\u5E8F\u542F\u52A8...");
+      await this.bindElectronLifecycle();
+      this.appLog.info("Electron \u751F\u547D\u5468\u671F\u7ED1\u5B9A\u5B8C\u6210");
+      await this.lifecycle?.xoAppBeforeStart();
+      this.appLog.debug("[\u542F\u52A8\u524D]\u751F\u547D\u5468\u671F\u52A0\u8F7D\u5B8C\u6210");
+      await app2.whenReady();
+      if (this.protocolManager.initialize()) {
+        this.appLog.info("\u534F\u8BAE\u6A21\u5757\u52A0\u8F7D\u5B8C\u6210");
+      }
+      if (this.rendererProtocolManager.initialize()) {
+        this.appLog.info("\u6E32\u67D3\u8FDB\u7A0B\u534F\u8BAE\u6A21\u5757\u52A0\u8F7D\u5B8C\u6210");
+      }
+      if (this.fileAssociationManager.initialize()) {
+        this.appLog.info("\u6587\u4EF6\u5173\u8054\u6A21\u5757\u52A0\u8F7D\u5B8C\u6210");
+      }
+      if (this.themeManager.initialize()) {
+        this.appLog.info("\u4E3B\u9898\u6A21\u5757\u52A0\u8F7D\u5B8C\u6210");
+      }
+      if (this.updaterManager.initialize()) {
+        this.appLog.info("\u66F4\u65B0\u5668\u6A21\u5757\u52A0\u8F7D\u5B8C\u6210");
+      }
+      if (this.remoteServiceManager.initialize()) {
+        this.appLog.info("\u8FDC\u7A0B\u670D\u52A1\u6A21\u5757\u52A0\u8F7D\u5B8C\u6210");
+      }
+      if (this.authManager.initialize()) {
+        this.appLog.info("JWT \u8BA4\u8BC1\u6A21\u5757\u52A0\u8F7D\u5B8C\u6210");
+      }
+      this.shortcutManager.initialize();
+      this.appLog.info("\u5FEB\u6377\u952E\u6A21\u5757\u52A0\u8F7D\u5B8C\u6210");
+      this.ipcManager.register();
+      this.appLog.info("IPC \u6A21\u5757\u52A0\u8F7D\u5B8C\u6210");
+      await this.lifecycle?.whenReady();
+      this.appLog.info("Electron \u51C6\u5907\u5C31\u7EEA");
+      this.menuManager.installAppMenu();
+      this.appLog.info("\u5E94\u7528\u83DC\u5355\u52A0\u8F7D\u5B8C\u6210");
+      await this.trayManager.create();
+      this.appLog.info("\u6258\u76D8\u52A0\u8F7D\u5B8C\u6210");
+      await this.lifecycle?.xoAppAfterStart();
+      this.appLog.debug("[\u542F\u52A8\u540E]\u751F\u547D\u5468\u671F\u52A0\u8F7D\u5B8C\u6210");
+      this.appLog.info("\u7A0B\u5E8F\u542F\u52A8\u5B8C\u6210");
+    } catch (error) {
+      await this.lifecycle?.onError({ source: "XionApp.run()", error });
+      throw error;
+    }
+  }
+  /**
+   * 控制单例模式
+   * @returns {boolean}
+   * @private
+   */
+  singleInstance() {
+    if (this.appConfig?.singleInstance && !app2.requestSingleInstanceLock()) {
+      if (!this.isExternalLaunchMode()) {
+        this.appLog.warn("\u5355\u5B9E\u4F8B\u9501\u5B9A\u5931\u8D25\uFF0C\u5E94\u7528\u7A0B\u5E8F\u5C06\u9000\u51FA");
+      }
+      app2.quit();
+      return false;
+    }
+    return true;
+  }
+  /**
+   * 退出应用
+   */
+  quit() {
+    this.quitting = true;
+    app2.quit();
+  }
+  /**
+   * 重启应用
+   */
+  restart() {
+    app2.relaunch();
+    this.quit();
+  }
+  /**
+   * App 是否正在退出
+   * @returns {boolean}
+   */
+  isQuitting() {
+    return this.quitting;
+  }
+  //</editor-fold>
+  //<editor-fold desc="生命周期">
+  /**
+   * 绑定 Electron 生命周期
+   * @private
+   */
+  async bindElectronLifecycle() {
+    app2.on("browser-window-created", (event, window) => {
+      this.appLog.debug("on:browser-window-created", { browserWindowID: window.id });
+      this.catcher("on:browser-window-created", () => this.lifecycle?.onBrowserWindowCreated(event, window));
+    });
+    app2.on("browser-window-focus", (event, window) => {
+      this.appLog.debug("on:browser-window-focus", WindowUtil.windowToUID(this.windowManager, window));
+      this.catcher("on:browser-window-focus", () => this.lifecycle?.onBrowserWindowFocus(event, window));
+    });
+    app2.on("browser-window-blur", (event, window) => {
+      this.appLog.debug("on:browser-window-blur", WindowUtil.windowToUID(this.windowManager, window));
+      this.catcher("on:browser-window-blur", () => this.lifecycle?.onBrowserWindowBlur(event, window));
+    });
+    app2.on("activate", (event, hasVisibleWindows) => {
+      this.appLog.debug("on:activate");
+      this.catcher("on:activate", () => this.lifecycle?.onActivate(event, hasVisibleWindows));
+    });
+    app2.on("second-instance", (event, argv, workingDirectory, additionalData) => {
+      this.appLog.debug("on:second-instance");
+      this.catcher("on:second-instance", () => this.lifecycle?.onSecondInstance(event, argv, workingDirectory, additionalData));
+    });
+    app2.on("window-all-closed", () => {
+      this.appLog.debug("on:window-all-closed");
+      this.catcher("on:window-all-closed", () => this.lifecycle?.onWindowAllClosed());
+    });
+    app2.on("before-quit", (event) => {
+      this.quitting = true;
+      this.trayManager.destroy();
+      this.appLog.debug("on:before-quit");
+      this.catcher("on:before-quit", () => this.lifecycle?.onBeforeQuit(event));
+    });
+    app2.on("will-quit", (event) => {
+      this.appLog.debug("on:will-quit");
+      this.catcher("on:will-quit", () => this.lifecycle?.onWillQuit(event));
+    });
+    app2.on("open-file", (event, path) => {
+      this.appLog.debug("on:open-file", { path });
+      this.catcher("on:open-file", () => this.lifecycle?.onOpenFile(event, path));
+    });
+    app2.on("open-url", (event, url) => {
+      this.appLog.debug("on:open-url", { url });
+      this.catcher("on:open-url", () => this.lifecycle?.onOpenUrl(event, url));
+    });
+    app2.on("web-contents-created", (event, webContents) => {
+      this.appLog.debug("on:web-contents-created", { webContentsID: webContents.id });
+      this.catcher("on:web-contents-created", () => this.lifecycle?.onWebContentsCreated(event, webContents));
+    });
+    app2.on("session-created", (session) => {
+      this.appLog.debug("on:session-created");
+      this.catcher("on:session-created", async () => {
+        this.rendererProtocolManager.initializeSession(session);
+        await this.lifecycle?.onSessionCreated(session);
+      });
+    });
+    app2.on("child-process-gone", (event, details) => {
+      this.appLog.debug("on:child-process-gone", { details });
+      this.catcher("on:child-process-gone", () => this.lifecycle?.onChildProcessGone(event, details));
+    });
+    app2.on("gpu-info-update", () => {
+      this.appLog.debug("on:gpu-info-update");
+      this.catcher("on:gpu-info-update", () => this.lifecycle?.onGpuInfoUpdate());
+    });
+    app2.on("render-process-gone", (event, webContents, details) => {
+      this.appLog.debug("on:render-process-gone", { webContents, details });
+      this.catcher("on:render-process-gone", () => this.lifecycle?.onRenderProcessGone(event, webContents, details));
+    });
+  }
+  //</editor-fold>
+  //<editor-fold desc="错误管理">
+  /**
+   * 事件错误捕捉器
+   * <p>用于兜底 Electron 事件回调中的同步异常和异步异常，并统一转发给 onError。</p>
+   * @param {string}                     name   生命周期名称
+   * @param {() => Promise<void> | void} runner 生命周期执行函数
+   * @private
+   */
+  catcher(name, runner) {
+    try {
+      void Promise.resolve(runner()).catch((error) => {
+        void this.lifecycle?.onError({ source: name, error });
+      });
+    } catch (error) {
+      void this.lifecycle?.onError({ source: name, error });
+    }
+  }
+  /**
+   * 分发错误到 App 日志
+   * @param {XoApp.LifecycleError} error 错误信息
+   * @returns {Promise<void>}
+   */
+  async dispatchAppError(error) {
+    await this.lifecycle?.onError(error);
+  }
+  //</editor-fold>
+};
+
+// src/main/app/xo-app.ts
+var XoApp = class _XoApp extends XoAppAbstract {
+  /**
+   * XionApp 单例
+   * @private
+   */
+  static singleInstance;
+  /**
+   * 构造函数
+   * @param {XoApp.ConstructorOptions} options 选项
+   */
+  constructor(options) {
+    super(options);
+  }
+  /**
+   * 启动应用
+   * @param {XoApp.ConstructorOptions} options 选项
+   * @returns {Promise<void>}
+   */
+  static async start(options) {
+    if (this.singleInstance !== void 0) {
+      this.singleInstance.appLog.warn("XionApp \u4EC5\u652F\u6301\u5355\u5B9E\u4F8B");
+      return;
+    }
+    this.singleInstance = new _XoApp(options);
+    await this.singleInstance?.run();
+  }
+};
+export {
+  AppLifecycle,
+  AppLifecycleAbstract,
+  XoApp,
+  XoAppAbstract
+};