ee-core 5.0.0-beta.2 → 5.0.0-beta.6

package/dist/cjs/electron/app/index.js

@@ -35,6 +35,16 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.electronApp = void 0;
 exports.createElectron = createElectron;
+/**
+ * @module electron/app
+ * @description Electron application lifecycle management. Responsible for creating application instances,
+ * registering system events, managing single instance locks, and handling cleanup on window close and app exit.
+ *
+ * Lifecycle:
+ * 1. createElectron() — Check single instance lock → app.whenReady() → Create main window → Load page
+ * 2. window-all-closed — Quit app on non-macOS platforms
+ * 3. before-quit — Clean up cross-process services and child tasks
+ */
 const electron_1 = require("electron");
 Object.defineProperty(exports, "electronApp", { enumerable: true, get: function () { return electron_1.app; } });
 const index_js_1 = require("../../log/index.js");
@@ -43,33 +53,47 @@ const index_js_2 = require("../../cross/index.js");
 const index_js_3 = require("../window/index.js");
 const events_js_1 = require("../../app/events.js");
 const index_js_4 = require("../../config/index.js");
+const registry_js_1 = require("../../jobs/registry.js");
 /**
- * 创建electron应用
+ * Create and start Electron application
+ *
+ * Execution flow:
+ * 1. Check single instance lock (when singleLock=true is configured, prevents running multiple instances simultaneously)
+ * 2. Wait for app.whenReady() to complete
+ * 3. Create main window, emit Preload event, load service page, emit ElectronAppReady event
+ * 4. Register system event listeners: window-all-closed, before-quit
  */
 function createElectron() {
     const { singleLock } = (0, index_js_4.getConfig)();
-    // 允许多个实例
+    // Request single instance lock
     const gotTheLock = electron_1.app.requestSingleInstanceLock();
     if (singleLock && !gotTheLock) {
+        // Another instance is already running, quit current instance
         electron_1.app.quit();
         return;
     }
+    // After Electron app is ready, create window and load page
     electron_1.app.whenReady().then(() => {
         (0, index_js_3.createMainWindow)();
         events_js_1.eventBus.emitLifecycle(events_js_1.Preload);
         (0, index_js_3.loadServer)();
+        events_js_1.eventBus.emitLifecycle(events_js_1.ElectronAppReady);
     });
+    // Quit app when all windows are closed (except on macOS, where apps typically stay running)
     electron_1.app.on('window-all-closed', () => {
         if (!is.macOS()) {
             index_js_1.coreLogger.info('[lib/eeApp] window-all-closed quit');
             electron_1.app.quit();
         }
     });
+    // Clean up resources before app quits
     electron_1.app.on('before-quit', () => {
         (0, index_js_3.setCloseAndQuit)(true);
         events_js_1.eventBus.emitLifecycle(events_js_1.BeforeClose);
+        // Terminate all cross-process services (Go/Python backends, etc.)
         index_js_2.cross.killAll();
+        // Terminate all child task processes
+        (0, registry_js_1.killAllJobs)();
     });
-    events_js_1.eventBus.emitLifecycle(events_js_1.ElectronAppReady);
 }
 //# sourceMappingURL=index.js.map

package/dist/cjs/electron/app/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/electron/app/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAaA,wCA6BC;AA1CD,uCAA8C;AAQrC,4FARO,cAAW,OAQP;AAPpB,iDAAgD;AAChD,sDAAwC;AACxC,mDAA6C;AAC7C,iDAAmF;AACnF,mDAAuF;AACvF,oDAAkD;AAIlD;;GAEG;AACH,SAAgB,cAAc;IAC5B,MAAM,EAAE,UAAU,EAAE,GAAG,IAAA,oBAAS,GAA6B,CAAC;IAC9D,SAAS;IACT,MAAM,UAAU,GAAG,cAAW,CAAC,yBAAyB,EAAE,CAAC;IAC3D,IAAI,UAAU,IAAI,CAAC,UAAU,EAAE,CAAC;QAC9B,cAAW,CAAC,IAAI,EAAE,CAAC;QACnB,OAAO;IACT,CAAC;IAED,cAAW,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;QAChC,IAAA,2BAAgB,GAAE,CAAC;QACnB,oBAAQ,CAAC,aAAa,CAAC,mBAAO,CAAC,CAAC;QAChC,IAAA,qBAAU,GAAE,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,cAAW,CAAC,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;QACvC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC;YAChB,qBAAU,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;YACtD,cAAW,CAAC,IAAI,EAAE,CAAC;QACrB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,cAAW,CAAC,EAAE,CAAC,aAAa,EAAE,GAAG,EAAE;QACjC,IAAA,0BAAe,EAAC,IAAI,CAAC,CAAC;QACtB,oBAAQ,CAAC,aAAa,CAAC,uBAAW,CAAC,CAAC;QACpC,gBAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,oBAAQ,CAAC,aAAa,CAAC,4BAAgB,CAAC,CAAC;AAC3C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/electron/app/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BA,wCAmCC;AAjED;;;;;;;;;GASG;AACH,uCAA8C;AASrC,4FATO,cAAW,OASP;AARpB,iDAAgD;AAChD,sDAAwC;AACxC,mDAA6C;AAC7C,iDAAmF;AACnF,mDAAuF;AACvF,oDAAkD;AAClD,wDAAqD;AAIrD;;;;;;;;GAQG;AACH,SAAgB,cAAc;IAC5B,MAAM,EAAE,UAAU,EAAE,GAAG,IAAA,oBAAS,GAA6B,CAAC;IAC9D,+BAA+B;IAC/B,MAAM,UAAU,GAAG,cAAW,CAAC,yBAAyB,EAAE,CAAC;IAC3D,IAAI,UAAU,IAAI,CAAC,UAAU,EAAE,CAAC;QAC9B,6DAA6D;QAC7D,cAAW,CAAC,IAAI,EAAE,CAAC;QACnB,OAAO;IACT,CAAC;IAED,2DAA2D;IAC3D,cAAW,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;QAChC,IAAA,2BAAgB,GAAE,CAAC;QACnB,oBAAQ,CAAC,aAAa,CAAC,mBAAO,CAAC,CAAC;QAChC,IAAA,qBAAU,GAAE,CAAC;QACb,oBAAQ,CAAC,aAAa,CAAC,4BAAgB,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,4FAA4F;IAC5F,cAAW,CAAC,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;QACvC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC;YAChB,qBAAU,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;YACtD,cAAW,CAAC,IAAI,EAAE,CAAC;QACrB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,sCAAsC;IACtC,cAAW,CAAC,EAAE,CAAC,aAAa,EAAE,GAAG,EAAE;QACjC,IAAA,0BAAe,EAAC,IAAI,CAAC,CAAC;QACtB,oBAAQ,CAAC,aAAa,CAAC,uBAAW,CAAC,CAAC;QACpC,kEAAkE;QAClE,gBAAK,CAAC,OAAO,EAAE,CAAC;QAChB,qCAAqC;QACrC,IAAA,yBAAW,GAAE,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/cjs/electron/index.d.ts

@@ -1,4 +1,10 @@
 export { electronApp, createElectron } from './app/index.js';
 export { getMainWindow, createMainWindow, restoreMainWindow, setCloseAndQuit, getCloseAndQuit, loadServer } from './window/index.js';
+/**
+ * Load Electron main process functionality
+ *
+ * Calls createElectron() to create the application and register system events.
+ * Called last by Application.run() in the framework startup flow.
+ */
 export declare function loadElectron(): void;
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/electron/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/electron/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGrI,wBAAgB,YAAY,IAAI,IAAI,CAEnC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/electron/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAErI;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAEnC"}

package/dist/cjs/electron/index.js

@@ -2,6 +2,16 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadServer = exports.getCloseAndQuit = exports.setCloseAndQuit = exports.restoreMainWindow = exports.createMainWindow = exports.getMainWindow = exports.createElectron = exports.electronApp = void 0;
 exports.loadElectron = loadElectron;
+/**
+ * @module electron
+ * @description Electron main process functionality module entry point. Provides application lifecycle management and window management features.
+ *
+ * Core features:
+ * - createElectron(): Create Electron application, register system events
+ * - createMainWindow(): Create main window
+ * - loadServer(): Load page content based on environment
+ * - getMainWindow(): Get main window instance
+ */
 const index_js_1 = require("./app/index.js");
 var index_js_2 = require("./app/index.js");
 Object.defineProperty(exports, "electronApp", { enumerable: true, get: function () { return index_js_2.electronApp; } });
@@ -13,7 +23,12 @@ Object.defineProperty(exports, "restoreMainWindow", { enumerable: true, get: fun
 Object.defineProperty(exports, "setCloseAndQuit", { enumerable: true, get: function () { return index_js_3.setCloseAndQuit; } });
 Object.defineProperty(exports, "getCloseAndQuit", { enumerable: true, get: function () { return index_js_3.getCloseAndQuit; } });
 Object.defineProperty(exports, "loadServer", { enumerable: true, get: function () { return index_js_3.loadServer; } });
-// load socket server
+/**
+ * Load Electron main process functionality
+ *
+ * Calls createElectron() to create the application and register system events.
+ * Called last by Application.run() in the framework startup flow.
+ */
 function loadElectron() {
     (0, index_js_1.createElectron)();
 }

package/dist/cjs/electron/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/electron/index.ts"],"names":[],"mappings":";;;AAMA,oCAEC;AARD,6CAAgD;AAEhD,2CAA6D;AAApD,uGAAA,WAAW,OAAA;AAAE,0GAAA,cAAc,OAAA;AACpC,8CAAqI;AAA5H,yGAAA,aAAa,OAAA;AAAE,4GAAA,gBAAgB,OAAA;AAAE,6GAAA,iBAAiB,OAAA;AAAE,2GAAA,eAAe,OAAA;AAAE,2GAAA,eAAe,OAAA;AAAE,sGAAA,UAAU,OAAA;AAEzG,qBAAqB;AACrB,SAAgB,YAAY;IAC1B,IAAA,yBAAc,GAAE,CAAC;AACnB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/electron/index.ts"],"names":[],"mappings":";;;AAqBA,oCAEC;AAvBD;;;;;;;;;GASG;AACH,6CAAgD;AAEhD,2CAA6D;AAApD,uGAAA,WAAW,OAAA;AAAE,0GAAA,cAAc,OAAA;AACpC,8CAAqI;AAA5H,yGAAA,aAAa,OAAA;AAAE,4GAAA,gBAAgB,OAAA;AAAE,6GAAA,iBAAiB,OAAA;AAAE,2GAAA,eAAe,OAAA;AAAE,2GAAA,eAAe,OAAA;AAAE,sGAAA,UAAU,OAAA;AAEzG;;;;;GAKG;AACH,SAAgB,YAAY;IAC1B,IAAA,yBAAc,GAAE,CAAC;AACnB,CAAC"}

package/dist/cjs/electron/window/index.d.ts

@@ -1,8 +1,45 @@
 import { BrowserWindow } from 'electron';
+/**
+ * Get main window instance
+ *
+ * @returns BrowserWindow instance, or null if not created
+ */
 export declare function getMainWindow(): BrowserWindow | null;
+/**
+ * Create main application window
+ *
+ * Creates BrowserWindow using config.windowsOption configuration.
+ * When openDevTools=true in config, automatically opens developer tools.
+ * After window creation, emits WindowReady lifecycle event.
+ *
+ * @returns BrowserWindow instance
+ */
 export declare function createMainWindow(): BrowserWindow;
+/**
+ * Restore main window
+ *
+ * If window is minimized, restores it, then shows and focuses it.
+ * Used when a second instance starts to activate the existing instance's window.
+ */
 export declare function restoreMainWindow(): void;
+/**
+ * Set close and quit flag
+ *
+ * @param flag - true means the application will quit after window closes
+ */
 export declare function setCloseAndQuit(flag: boolean): void;
+/**
+ * Get close and quit flag
+ */
 export declare function getCloseAndQuit(): boolean;
+/**
+ * Load service page
+ *
+ * Selects page loading strategy based on configuration and environment:
+ * 1. Remote mode (remote.enable=true) → Load remote URL
+ * 2. Development environment → Load frontend dev server (wait for ready), show startup page first
+ * 3. Production environment + cross takeover → Wait for cross-process service to be ready then load
+ * 4. Production environment (default) → Load locally packaged file
+ */
 export declare function loadServer(): Promise<void>;
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/electron/window/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/electron/window/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAuBzC,wBAAgB,aAAa,IAAI,aAAa,GAAG,IAAI,CAEpD;AAGD,wBAAgB,gBAAgB,IAAI,aAAa,CAiBhD;AAGD,wBAAgB,iBAAiB,IAAI,IAAI,CAQxC;AAGD,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAEnD;AAED,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAID,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAmGhD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/electron/window/index.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AA2DzC;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,aAAa,GAAG,IAAI,CAEpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAShD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAQxC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAEnD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED;;;;;;;;GAQG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CA6EhD"}

package/dist/cjs/electron/window/index.js

@@ -9,6 +9,17 @@ exports.restoreMainWindow = restoreMainWindow;
 exports.setCloseAndQuit = setCloseAndQuit;
 exports.getCloseAndQuit = getCloseAndQuit;
 exports.loadServer = loadServer;
+/**
+ * @module electron/window
+ * @description Main window management module. Responsible for creating BrowserWindow, loading page content,
+ * and handling page loading logic in development/production environments.
+ *
+ * Page loading strategy:
+ * - Remote mode (remote.enable=true): Load remote URL
+ * - Development mode: Load frontend dev server (http://localhost:8080), wait for service to be ready
+ * - Production mode + cross takeover: Wait for cross-process service to be ready then load its URL
+ * - Production mode (default): Load locally packaged HTML file
+ */
 const debug_1 = __importDefault(require("debug"));
 const type_check_js_1 = require("../../utils/type_check.js");
 const path_1 = __importDefault(require("path"));
@@ -20,35 +31,81 @@ const index_js_2 = require("../../ps/index.js");
 const index_js_3 = require("../../log/index.js");
 const index_js_4 = require("../../loader/index.js");
 const index_js_5 = require("../../utils/index.js");
-const index_js_6 = require("../../html/index.js");
 const helper_js_1 = require("../../utils/helper.js");
 const extend_js_1 = require("../../utils/extend.js");
-const index_js_7 = require("../../cross/index.js");
+const index_js_6 = require("../../cross/index.js");
+const index_js_7 = require("../../html/index.js");
 const debugLog = (0, debug_1.default)('ee-core:electron:window');
+/**
+ * Wait for URL to be reachable
+ *
+ * Polls via HTTP GET request to check if service is ready.
+ * Used to wait for frontend dev server or cross-process service to finish starting.
+ *
+ * @param url - URL to check
+ * @param options - Polling options
+ * @param options.retries - Maximum number of retries
+ * @param options.intervalMs - Retry interval (milliseconds)
+ * @param options.timeoutMs - Single request timeout (milliseconds)
+ * @returns Whether the URL is reachable within the retry count
+ */
+async function waitForUrl(url, options) {
+    let count = 0;
+    let ready = false;
+    while (!ready && count < options.retries) {
+        await (0, helper_js_1.sleep)(options.intervalMs);
+        try {
+            await (0, axios_1.default)({
+                method: 'get',
+                url,
+                timeout: options.timeoutMs,
+                proxy: false,
+                headers: { 'Accept': 'text/html, application/json, text/plain, */*' },
+            });
+            ready = true;
+        }
+        catch {
+            // Service not ready, continue retrying
+        }
+        count++;
+    }
+    return ready;
+}
+/** Main window instance and exit flag */
 const Instance = {
     mainWindow: null,
     closeAndQuit: true,
 };
-// getMainWindow
+/**
+ * Get main window instance
+ *
+ * @returns BrowserWindow instance, or null if not created
+ */
 function getMainWindow() {
     return Instance.mainWindow;
 }
-// Create the main application window
+/**
+ * Create main application window
+ *
+ * Creates BrowserWindow using config.windowsOption configuration.
+ * When openDevTools=true in config, automatically opens developer tools.
+ * After window creation, emits WindowReady lifecycle event.
+ *
+ * @returns BrowserWindow instance
+ */
 function createMainWindow() {
-    const { openDevTools, windowsOption } = (0, index_js_1.getConfig)();
+    const { windowsOption } = (0, index_js_1.getConfig)();
     const win = new electron_1.BrowserWindow(windowsOption);
     Instance.mainWindow = win;
-    // DevTools
-    if ((0, type_check_js_1.isObject)(openDevTools)) {
-        win.webContents.openDevTools(openDevTools);
-    }
-    else if (openDevTools === true) {
-        win.webContents.openDevTools({ mode: 'bottom' });
-    }
     events_js_1.eventBus.emitLifecycle(events_js_1.WindowReady);
     return win;
 }
-// restored window
+/**
+ * Restore main window
+ *
+ * If window is minimized, restores it, then shows and focuses it.
+ * Used when a second instance starts to activate the existing instance's window.
+ */
 function restoreMainWindow() {
     if (Instance.mainWindow) {
         if (Instance.mainWindow.isMinimized()) {
@@ -58,26 +115,40 @@ function restoreMainWindow() {
         Instance.mainWindow.focus();
     }
 }
-// Set the flag for exiting after close all windows
+/**
+ * Set close and quit flag
+ *
+ * @param flag - true means the application will quit after window closes
+ */
 function setCloseAndQuit(flag) {
     Instance.closeAndQuit = flag;
 }
+/**
+ * Get close and quit flag
+ */
 function getCloseAndQuit() {
     return Instance.closeAndQuit;
 }
-// load server
-// type: remote | single
+/**
+ * Load service page
+ *
+ * Selects page loading strategy based on configuration and environment:
+ * 1. Remote mode (remote.enable=true) → Load remote URL
+ * 2. Development environment → Load frontend dev server (wait for ready), show startup page first
+ * 3. Production environment + cross takeover → Wait for cross-process service to be ready then load
+ * 4. Production environment (default) → Load locally packaged file
+ */
 async function loadServer() {
     const { remote, mainServer } = (0, index_js_1.getConfig)();
     const win = getMainWindow();
     if (!win)
         return;
-    // remote model
+    // Remote mode: load remote URL directly
     if (remote.enable) {
         loadMainUrl('remote', remote.url);
         return;
     }
-    // 开发环境
+    // Development environment
     if ((0, index_js_2.isDev)()) {
         const binFile = path_1.default.join((0, index_js_2.getBaseDir)(), './cmd/bin.js');
         const binConfig = (0, index_js_4.loadFile)(binFile);
@@ -89,49 +160,27 @@ async function loadServer() {
             indexPath: 'index.html',
             directory: 'frontend/dist',
         }, dev.frontend || {});
-        const electronConf = (0, extend_js_1.extend)(true, {
-            loadingPage: '/public/html/loading.html',
-        }, dev.electron || {});
+        const electronConf = (dev.electron || {});
         let url = frontendConf.protocol + frontendConf.hostname + ':' + frontendConf.port;
         let load = 'url';
+        // file:// protocol loads local file directly
         if ((0, index_js_5.isFileProtocol)(frontendConf.protocol)) {
             url = path_1.default.join((0, index_js_2.getBaseDir)(), frontendConf.directory, frontendConf.indexPath);
             load = 'file';
         }
-        // Check if UI serve is started, load a boot page first
+        // HTTP mode: show startup page first, wait for frontend dev server to be ready
         if (load === 'url') {
-            // loading page
-            let lp = (0, index_js_6.getHtmlFilepath)('boot.html');
+            // Load loading page
             if (electronConf.loadingPage) {
-                lp = path_1.default.join((0, index_js_2.getBaseDir)(), electronConf.loadingPage);
+                _loadingPage(path_1.default.join((0, index_js_2.getBaseDir)(), electronConf.loadingPage));
             }
-            _loadingPage(lp);
-            // check frontend is ready
+            // Poll to check if frontend dev server is ready
             const retryTimes = frontendConf.force === true ? 3 : 60;
-            let count = 0;
-            let frontendReady = false;
-            while (!frontendReady && count < retryTimes) {
-                await (0, helper_js_1.sleep)(1 * 1000);
-                try {
-                    await (0, axios_1.default)({
-                        method: 'get',
-                        url,
-                        timeout: 1000,
-                        proxy: false,
-                        headers: {
-                            'Accept': 'text/html, application/json, text/plain, */*',
-                        },
-                    });
-                    frontendReady = true;
-                }
-                catch (err) {
-                    // ignore
-                }
-                count++;
-            }
-            debugLog('it takes %d seconds to start the frontend', count);
+            const frontendReady = await waitForUrl(url, { retries: retryTimes, intervalMs: 1000, timeoutMs: 1000 });
+            debugLog('frontend ready: %s', frontendReady);
             if (frontendReady === false && frontendConf.force !== true) {
-                const bootFailurePage = (0, index_js_6.getHtmlFilepath)('failure.html');
+                // Frontend service not ready, show failure page
+                const bootFailurePage = (0, index_js_7.getHtmlFilepath)('failure.html');
                 const win = getMainWindow();
                 if (win) {
                     win.loadFile(bootFailurePage);
@@ -143,13 +192,12 @@ async function loadServer() {
         loadMainUrl('spa', url, load);
         return;
     }
-    // 生产环境
-    // cross takeover web
+    // Production environment: cross takeover mode
     if (mainServer.takeover && mainServer.takeover.length > 0) {
         await crossTakeover();
         return;
     }
-    // 主进程
+    // Production environment: load local file
     const indexPath = mainServer.indexPath;
     let prodUrl = path_1.default.join((0, index_js_2.getBaseDir)(), indexPath);
     if (!(0, index_js_5.isFileProtocol)(mainServer.protocol)) {
@@ -158,33 +206,51 @@ async function loadServer() {
     loadMainUrl('spa', prodUrl, 'file');
 }
 /**
- * 主服务
- * @params load <string> value: "url" 、 "file"
+ * Load main page URL or file
+ *
+ * @param type - Load type (remote / spa)
+ * @param url - URL or file path
+ * @param load - Load method: 'url' uses loadURL, 'file' uses loadFile
  */
 function loadMainUrl(type, url, load = 'url') {
-    const { mainServer } = (0, index_js_1.getConfig)();
+    const { openDevTools, mainServer } = (0, index_js_1.getConfig)();
     const win = getMainWindow();
     if (!win)
         return;
     index_js_3.coreLogger.info('Env: %s, Type: %s', (0, index_js_2.env)(), type);
     index_js_3.coreLogger.info('App running at: %s', url);
     debugLog('[loadMainUrl] type:%s, url:%s', type, url);
+    // Open DevTools after the final page finishes loading, avoiding disconnection during page transitions
+    win.webContents.once('did-finish-load', () => {
+        if ((0, type_check_js_1.isObject)(openDevTools)) {
+            win.webContents.openDevTools(openDevTools);
+        }
+        else if (openDevTools === true) {
+            win.webContents.openDevTools({ mode: 'bottom' });
+        }
+    });
     if (load === 'file') {
         win.loadFile(url, mainServer.options)
-            .then()
             .catch((err) => {
             index_js_3.coreLogger.error(`Please check the ${url} !`, err);
+            throw err;
         });
     }
     else {
         win.loadURL(url, mainServer.options)
-            .then()
             .catch((err) => {
             index_js_3.coreLogger.error(`Please check the ${url} !`, err);
+            throw err;
         });
     }
 }
-// loading page
+/**
+ * Load startup page
+ *
+ * Displayed while waiting for frontend service to be ready, avoiding blank screen.
+ *
+ * @param filepath - Startup page HTML file path
+ */
 function _loadingPage(filepath) {
     const win = getMainWindow();
     if (!win)
@@ -194,55 +260,45 @@ function _loadingPage(filepath) {
     }
 }
 /**
- * cross takeover web
+ * Cross-process service takeover page loading
+ *
+ * Waits for the specified cross-process service (e.g., Go/Python backend) to be ready, then loads the URL it provides.
+ * Flow:
+ * 1. Show loading page (if loadingPage is configured)
+ * 2. Check if cross-process service configuration is correct
+ * 3. Poll and wait for service URL to be reachable
+ * 4. Load service URL when ready, show failure page on timeout
  */
 async function crossTakeover() {
     const crossConf = (0, index_js_1.getConfig)().cross;
     const mainConf = (0, index_js_1.getConfig)().mainServer;
-    // loading page
+    // Show loading page
     if (mainConf.loadingPage && mainConf.loadingPage.length > 0) {
         const lp = path_1.default.join((0, index_js_2.getBaseDir)(), mainConf.loadingPage);
         _loadingPage(lp);
     }
-    // cross service url
+    // Get the URL of the cross-process service
     const service = mainConf.takeover;
     if (!Object.prototype.hasOwnProperty.call(crossConf, service)) {
         throw new Error(`[ee-core] Please Check the value of mainServer.takeover in the config file !`);
     }
     const serviceConf = crossConf[service];
-    // check service
     if (!serviceConf || serviceConf.enable !== true) {
         throw new Error(`[ee-core] Please Check the value of cross.${service} enable is true !`);
     }
     const entityName = serviceConf.name || service;
-    const url = index_js_7.cross.getUrl(entityName);
-    // 循环检查
-    let count = 0;
-    let serviceReady = false;
+    const url = index_js_6.cross.getUrl(entityName);
+    if (!url) {
+        throw new Error(`[ee-core] Cannot get URL for cross service [${service}], process may not be running`);
+    }
+    // Poll and wait for service to be ready
     const times = (0, index_js_2.isDev)() ? 20 : 100;
     const sleeptime = (0, index_js_2.isDev)() ? 1000 : 200;
-    while (!serviceReady && count < times) {
-        await (0, helper_js_1.sleep)(sleeptime);
-        try {
-            await (0, axios_1.default)({
-                method: 'get',
-                url,
-                timeout: 100,
-                proxy: false,
-                headers: {
-                    'Accept': 'text/html, application/json, text/plain, */*',
-                },
-            });
-            serviceReady = true;
-        }
-        catch {
-            // ignore
-        }
-        count++;
-    }
-    debugLog('it takes %d seconds to start the cross service', count * sleeptime);
+    const serviceReady = await waitForUrl(url, { retries: times, intervalMs: sleeptime, timeoutMs: 100 });
+    debugLog('cross service ready: %s', serviceReady);
     if (!serviceReady) {
-        const bootFailurePage = (0, index_js_6.getHtmlFilepath)('cross-failure.html');
+        // Service not ready, show failure page
+        const bootFailurePage = (0, index_js_7.getHtmlFilepath)('cross-failure.html');
         const mainWindow = getMainWindow();
         if (mainWindow) {
             mainWindow.loadFile(bootFailurePage);

package/dist/cjs/electron/window/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/electron/window/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/electron/window/index.ts"],"names":[],"mappings":"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"}

package/dist/cjs/exception/index.d.ts

@@ -1,3 +1,15 @@
+/**
+ * Load exception handlers
+ *
+ * Registers global uncaughtException and unhandledRejection listeners.
+ * Should be called at the earliest stage of application startup.
+ */
 export declare function loadException(): void;
+/**
+ * Uncaught exception monitor
+ *
+ * Unlike uncaughtException, this handler is triggered before the exception is caught,
+ * and can be used for exception monitoring and reporting without affecting the subsequent exception handling flow.
+ */
 export declare function uncaughtExceptionMonitorHandler(): void;
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/exception/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/exception/index.ts"],"names":[],"mappings":"AAMA,wBAAgB,aAAa,IAAI,IAAI,CAGpC;AAkBD,wBAAgB,+BAA+B,IAAI,IAAI,CAKtD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/exception/index.ts"],"names":[],"mappings":"AAYA;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAGpC;AA6BD;;;;;GAKG;AACH,wBAAgB,+BAA+B,IAAI,IAAI,CAKtD"}