@mt0926/node-network-devtools 0.2.0 → 0.3.0

package/dist/cjs/gui/browser-launcher.js

@@ -0,0 +1,365 @@
+"use strict";
+/**
+ * 浏览器启动器模块
+ *
+ * 使用原生浏览器检测和启动机制打开 GUI
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserLaunchError = exports.BrowserNotFoundError = void 0;
+exports.getBrowserLauncher = getBrowserLauncher;
+exports.resetBrowserLauncher = resetBrowserLauncher;
+exports.createBrowserLauncher = createBrowserLauncher;
+exports.buildGUIUrl = buildGUIUrl;
+exports.openBrowser = openBrowser;
+exports.closeBrowser = closeBrowser;
+exports.buildLaunchArgs = buildLaunchArgs;
+exports.createUserDataDir = createUserDataDir;
+const child_process_1 = require("child_process");
+const os_1 = require("os");
+const path_1 = require("path");
+const nanoid_1 = require("nanoid");
+const config_js_1 = require("../config.js");
+const browser_detector_js_1 = require("./browser-detector.js");
+/**
+ * 浏览器未检测到错误
+ *
+ * 当系统中未检测到任何支持的浏览器时抛出此错误
+ */
+class BrowserNotFoundError extends Error {
+    constructor() {
+        super('未检测到已安装的浏览器');
+        this.name = 'BrowserNotFoundError';
+        // 保持原型链正确（TypeScript 继承 Error 的最佳实践）
+        Object.setPrototypeOf(this, BrowserNotFoundError.prototype);
+    }
+}
+exports.BrowserNotFoundError = BrowserNotFoundError;
+/**
+ * 浏览器启动失败错误
+ *
+ * 当浏览器启动过程中发生错误时抛出此错误
+ */
+class BrowserLaunchError extends Error {
+    cause;
+    /**
+     * @param message 错误消息
+     * @param cause 原始错误（可选）
+     */
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'BrowserLaunchError';
+        // 保持原型链正确（TypeScript 继承 Error 的最佳实践）
+        Object.setPrototypeOf(this, BrowserLaunchError.prototype);
+    }
+}
+exports.BrowserLaunchError = BrowserLaunchError;
+/**
+ * 浏览器启动器实现
+ */
+class BrowserLauncherImpl {
+    isOpened = false;
+    /**
+     * 打开浏览器
+     *
+     * 执行以下步骤：
+     * 1. 调用 BrowserDetector.detect() 检测浏览器
+     * 2. 处理未找到浏览器的情况
+     * 3. 构建启动参数
+     * 4. 调用启动逻辑
+     * 5. 处理启动失败的情况
+     *
+     * @param url GUI 访问 URL
+     *
+     * @remarks
+     * 此方法不会抛出异常，所有错误都会被捕获并显示友好的错误消息。
+     * 这确保浏览器启动失败不会中断主进程。
+     *
+     * **验证需求：2.5, 4.1, 4.2, 4.3, 4.4, 4.5, 6.1, 6.4**
+     */
+    async open(url) {
+        try {
+            // 步骤 1: 调用 BrowserDetector.detect() 检测浏览器
+            const browserInfo = (0, browser_detector_js_1.detectBrowser)();
+            // 步骤 2: 处理未找到浏览器的情况
+            if (!browserInfo) {
+                // 浏览器未找到，显示友好提示（需求 6.1）
+                this.handleBrowserNotFound(url);
+                return;
+            }
+            // 获取配置
+            const config = (0, config_js_1.getConfig)();
+            const windowConfig = {
+                width: config.browserWindowSize?.width || 1280,
+                height: config.browserWindowSize?.height || 800,
+                title: config.browserWindowTitle || 'Node Network DevTools',
+            };
+            // 创建用户数据目录（需求 4.2）
+            const userDataDir = createUserDataDir();
+            // 步骤 3: 构建启动参数（需求 4.1）
+            const args = this.buildLaunchArgs({
+                url,
+                windowConfig,
+                userDataDir,
+            });
+            // 步骤 4: 调用启动逻辑（需求 4.3, 4.4, 4.5）
+            this.launchBrowser(browserInfo.path, args);
+            this.isOpened = true;
+            console.log(`[node-network-devtools] 已使用 ${browserInfo.name} 打开 GUI: ${url}`);
+        }
+        catch (err) {
+            // 步骤 5: 处理启动失败的情况（需求 6.4）
+            this.handleLaunchError(err, url);
+        }
+    }
+    /**
+     * 启动浏览器进程
+     *
+     * 使用 child_process.spawn() 启动浏览器，并配置为分离进程。
+     * 这样浏览器进程不会阻塞父进程，父进程退出后浏览器仍可继续运行。
+     *
+     * @param browserPath 浏览器可执行文件路径
+     * @param args 启动参数数组
+     * @throws {BrowserLaunchError} 当浏览器启动失败时抛出
+     *
+     * @remarks
+     * 进程配置：
+     * - detached: true - 进程分离，允许父进程退出（需求 4.3）
+     * - stdio: 'ignore' - 忽略标准输入输出，避免管道阻塞（需求 4.4）
+     * - child.unref() - 允许父进程退出而不等待子进程（需求 4.5）
+     *
+     * **验证需求：4.3, 4.4, 4.5**
+     */
+    launchBrowser(browserPath, args) {
+        try {
+            // 启动分离进程
+            const child = (0, child_process_1.spawn)(browserPath, args, {
+                detached: true, // 进程分离，允许父进程退出（需求 4.3）
+                stdio: 'ignore', // 忽略标准输入输出，避免管道阻塞（需求 4.4）
+            });
+            // 允许父进程退出而不等待子进程（需求 4.5）
+            child.unref();
+            // 监听错误事件（虽然 stdio: 'ignore'，但 spawn 本身可能失败）
+            child.on('error', (err) => {
+                throw new BrowserLaunchError(`浏览器进程启动失败: ${err.message}`, err);
+            });
+        }
+        catch (err) {
+            // 将原始错误包装为 BrowserLaunchError
+            if (err instanceof BrowserLaunchError) {
+                throw err;
+            }
+            throw new BrowserLaunchError(`无法启动浏览器: ${err.message}`, err);
+        }
+    }
+    /**
+     * 处理浏览器未找到的情况
+     *
+     * 显示友好的错误消息，包含：
+     * - 支持的浏览器列表
+     * - GUI 访问 URL（需求 6.2）
+     * - 自定义浏览器路径设置说明
+     * - 浏览器安装指引链接（需求 6.3）
+     *
+     * @param guiUrl GUI 访问 URL
+     *
+     * **验证需求：6.1, 6.2, 6.3**
+     */
+    handleBrowserNotFound(guiUrl) {
+        console.error(`
+[node-network-devtools] 未检测到已安装的浏览器
+
+支持的浏览器：
+  - Google Chrome
+  - Microsoft Edge
+  - Chromium
+
+请安装其中一个浏览器，或手动访问 GUI：
+  ${guiUrl}
+
+自定义浏览器路径：
+  export NND_BROWSER_PATH=/path/to/browser
+
+浏览器安装指引：
+  Chrome: https://www.google.com/chrome/
+  Edge: https://www.microsoft.com/edge
+  更多信息: https://github.com/dong0926/node-network-devtools#readme
+    `);
+    }
+    /**
+     * 处理浏览器启动失败的情况
+     *
+     * 显示友好的错误消息，包含：
+     * - 错误信息（需求 6.4）
+     * - 可能的原因分析
+     * - 解决方案建议（需求 6.5）
+     * - 手动访问 URL 提示
+     *
+     * @param err 错误对象
+     * @param guiUrl GUI 访问 URL
+     *
+     * **验证需求：6.4, 6.5**
+     */
+    handleLaunchError(err, guiUrl) {
+        console.error(`
+[node-network-devtools] 浏览器启动失败
+
+错误信息：${err.message}
+
+可能的原因：
+  1. 浏览器路径无效
+  2. 权限不足
+  3. 系统资源不足
+
+解决方案：
+  - 手动访问 GUI: ${guiUrl}
+  - 设置 NND_AUTO_OPEN=false 禁用自动打开
+  - 检查浏览器是否正确安装
+  - 尝试设置自定义浏览器路径: export NND_BROWSER_PATH=/path/to/browser
+    `);
+    }
+    /**
+     * 构建浏览器启动参数
+     *
+     * @param options 启动选项
+     * @returns Chrome 命令行参数数组
+     */
+    buildLaunchArgs(options) {
+        const { url, windowConfig, userDataDir } = options;
+        const args = [
+            // App 模式（极简窗口，无地址栏和工具栏）
+            `--app=${url}`,
+            // 窗口大小
+            `--window-size=${windowConfig.width},${windowConfig.height}`,
+        ];
+        // 用户数据目录（如果提供）
+        if (userDataDir) {
+            args.push(`--user-data-dir=${userDataDir}`);
+        }
+        // 优化参数
+        args.push('--no-first-run', // 跳过首次运行向导
+        '--no-default-browser-check', // 跳过默认浏览器检查
+        '--disable-extensions', // 禁用扩展
+        '--disable-sync', // 禁用同步
+        '--disable-background-networking', // 禁用后台网络请求
+        '--disable-features=TranslateUI', // 禁用翻译 UI
+        '--disable-component-extensions-with-background-pages', '--disable-default-apps', // 禁用默认应用
+        '--mute-audio', // 静音
+        // 性能优化
+        '--disable-backgrounding-occluded-windows', '--disable-renderer-backgrounding', '--disable-background-timer-throttling', 
+        // 安全相关（某些环境需要）
+        '--no-sandbox', '--disable-setuid-sandbox');
+        return args;
+    }
+    /**
+     * 关闭浏览器
+     */
+    async close() {
+        // TODO: 实现浏览器关闭逻辑（注：由于进程分离，实际无法关闭）
+        this.isOpened = false;
+    }
+    /**
+     * 检查浏览器是否已打开
+     */
+    isOpen() {
+        return this.isOpened;
+    }
+}
+// 全局单例
+let globalLauncher = null;
+/**
+ * 获取全局浏览器启动器实例
+ */
+function getBrowserLauncher() {
+    if (!globalLauncher) {
+        globalLauncher = new BrowserLauncherImpl();
+    }
+    return globalLauncher;
+}
+/**
+ * 重置全局浏览器启动器（用于测试）
+ */
+async function resetBrowserLauncher() {
+    if (globalLauncher) {
+        await globalLauncher.close();
+    }
+    globalLauncher = null;
+}
+/**
+ * 创建新的浏览器启动器实例（用于测试）
+ */
+function createBrowserLauncher() {
+    return new BrowserLauncherImpl();
+}
+/**
+ * 构建带 WebSocket 端口参数的 GUI URL
+ */
+function buildGUIUrl(host, guiPort, wsPort) {
+    return `http://${host}:${guiPort}?wsPort=${wsPort}`;
+}
+/**
+ * 打开浏览器（便捷函数）
+ */
+async function openBrowser(url) {
+    const launcher = getBrowserLauncher();
+    await launcher.open(url);
+}
+/**
+ * 关闭浏览器（便捷函数）
+ */
+async function closeBrowser() {
+    const launcher = getBrowserLauncher();
+    await launcher.close();
+}
+/**
+ * 构建浏览器启动参数（导出用于测试）
+ *
+ * @param options 启动选项
+ * @returns Chrome 命令行参数数组
+ */
+function buildLaunchArgs(options) {
+    const { url, windowConfig, userDataDir } = options;
+    const args = [
+        // App 模式（极简窗口，无地址栏和工具栏）
+        `--app=${url}`,
+        // 窗口大小
+        `--window-size=${windowConfig.width},${windowConfig.height}`,
+    ];
+    // 用户数据目录（如果提供）
+    if (userDataDir) {
+        args.push(`--user-data-dir=${userDataDir}`);
+    }
+    // 优化参数
+    args.push('--no-first-run', // 跳过首次运行向导
+    '--no-default-browser-check', // 跳过默认浏览器检查
+    '--disable-extensions', // 禁用扩展
+    '--disable-sync', // 禁用同步
+    '--disable-background-networking', // 禁用后台网络请求
+    '--disable-features=TranslateUI', // 禁用翻译 UI
+    '--disable-component-extensions-with-background-pages', '--disable-default-apps', // 禁用默认应用
+    '--mute-audio', // 静音
+    // 性能优化
+    '--disable-backgrounding-occluded-windows', '--disable-renderer-backgrounding', '--disable-background-timer-throttling', 
+    // 安全相关（某些环境需要）
+    '--no-sandbox', '--disable-setuid-sandbox');
+    return args;
+}
+/**
+ * 创建用户数据目录路径
+ *
+ * 生成一个唯一的临时目录路径用于浏览器用户数据。
+ * 使用 nanoid 生成 8 位随机 ID 确保每次启动都使用独立的会话。
+ *
+ * @returns 用户数据目录的完整路径，格式：`{tmpdir}/nnd-browser-{sessionId}`
+ *
+ * @example
+ * ```typescript
+ * const userDataDir = createUserDataDir();
+ * // 返回类似：/tmp/nnd-browser-a1b2c3d4
+ * ```
+ */
+function createUserDataDir() {
+    const sessionId = (0, nanoid_1.nanoid)(8);
+    return (0, path_1.join)((0, os_1.tmpdir)(), `nnd-browser-${sessionId}`);
+}
+//# sourceMappingURL=browser-launcher.js.map

package/dist/cjs/gui/browser-launcher.js.map

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

package/dist/cjs/gui/event-bridge.js

@@ -0,0 +1,197 @@
+"use strict";
+/**
+ * Event Bridge 模块
+ *
+ * 连接请求拦截器和 WebSocket Hub，实现事件转发
+ * 支持暂停/恢复和清空功能
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEventBridge = getEventBridge;
+exports.resetEventBridge = resetEventBridge;
+exports.createEventBridge = createEventBridge;
+const ring_buffer_js_1 = require("../store/ring-buffer.js");
+const websocket_hub_js_1 = require("./websocket-hub.js");
+/**
+ * Event Bridge 实现
+ */
+class EventBridgeImpl {
+    paused = false;
+    running = false;
+    wsHub;
+    pendingEvents = [];
+    constructor(wsHub) {
+        this.wsHub = wsHub ?? (0, websocket_hub_js_1.getWebSocketHub)();
+    }
+    /**
+     * 启动 Event Bridge
+     * 注册 WebSocket 客户端连接回调，发送初始数据
+     */
+    start() {
+        if (this.running)
+            return;
+        this.running = true;
+        // 当新客户端连接时，发送初始数据
+        this.wsHub.onClientConnect((clientId) => {
+            const store = (0, ring_buffer_js_1.getRequestStore)();
+            const requests = store.getAll();
+            const message = (0, websocket_hub_js_1.createInitialDataMessage)(requests);
+            this.wsHub.send(clientId, message);
+        });
+        // 处理客户端消息（控制命令）
+        this.wsHub.onClientMessage((_clientId, message) => {
+            this.handleClientMessage(message);
+        });
+    }
+    /**
+     * 停止 Event Bridge
+     */
+    stop() {
+        this.running = false;
+        this.pendingEvents = [];
+    }
+    /**
+     * 检查是否正在运行
+     */
+    isRunning() {
+        return this.running;
+    }
+    /**
+     * 处理客户端消息
+     */
+    handleClientMessage(message) {
+        switch (message.type) {
+            case 'control:pause':
+                this.pause();
+                break;
+            case 'control:resume':
+                this.resume();
+                break;
+            case 'requests:clear':
+                this.clear();
+                break;
+        }
+    }
+    /**
+     * 发送请求开始事件
+     */
+    emitRequestStart(request) {
+        if (!this.running)
+            return;
+        const message = (0, websocket_hub_js_1.createRequestStartMessage)(request);
+        if (this.paused) {
+            // 暂停时缓存事件
+            this.pendingEvents.push(message);
+        }
+        else {
+            this.wsHub.broadcast(message);
+        }
+    }
+    /**
+     * 发送请求完成事件
+     */
+    emitRequestComplete(requestId, response) {
+        if (!this.running)
+            return;
+        const message = (0, websocket_hub_js_1.createRequestCompleteMessage)(requestId, response);
+        if (this.paused) {
+            // 暂停时缓存事件
+            this.pendingEvents.push(message);
+        }
+        else {
+            this.wsHub.broadcast(message);
+        }
+    }
+    /**
+     * 发送请求错误事件
+     */
+    emitRequestError(requestId, error) {
+        if (!this.running)
+            return;
+        const message = (0, websocket_hub_js_1.createRequestErrorMessage)(requestId, error);
+        if (this.paused) {
+            // 暂停时缓存事件
+            this.pendingEvents.push(message);
+        }
+        else {
+            this.wsHub.broadcast(message);
+        }
+    }
+    /**
+     * 暂停事件广播
+     */
+    pause() {
+        if (this.paused)
+            return;
+        this.paused = true;
+        // 广播暂停状态
+        this.wsHub.broadcast({
+            type: 'control:pause',
+            payload: null,
+            timestamp: Date.now(),
+        });
+    }
+    /**
+     * 恢复事件广播
+     */
+    resume() {
+        if (!this.paused)
+            return;
+        this.paused = false;
+        // 广播恢复状态
+        this.wsHub.broadcast({
+            type: 'control:resume',
+            payload: null,
+            timestamp: Date.now(),
+        });
+        // 发送暂停期间缓存的事件
+        for (const event of this.pendingEvents) {
+            this.wsHub.broadcast(event);
+        }
+        this.pendingEvents = [];
+    }
+    /**
+     * 检查是否暂停
+     */
+    isPaused() {
+        return this.paused;
+    }
+    /**
+     * 清空请求
+     */
+    clear() {
+        // 清空存储
+        const store = (0, ring_buffer_js_1.getRequestStore)();
+        store.clear();
+        // 清空缓存的事件
+        this.pendingEvents = [];
+        // 广播清空消息
+        this.wsHub.broadcast((0, websocket_hub_js_1.createClearMessage)());
+    }
+}
+// 全局单例
+let globalBridge = null;
+/**
+ * 获取全局 Event Bridge 实例
+ */
+function getEventBridge() {
+    if (!globalBridge) {
+        globalBridge = new EventBridgeImpl();
+    }
+    return globalBridge;
+}
+/**
+ * 重置全局 Event Bridge（用于测试）
+ */
+function resetEventBridge() {
+    if (globalBridge) {
+        globalBridge.stop();
+    }
+    globalBridge = null;
+}
+/**
+ * 创建新的 Event Bridge 实例（用于测试）
+ */
+function createEventBridge(wsHub) {
+    return new EventBridgeImpl(wsHub);
+}
+//# sourceMappingURL=event-bridge.js.map

package/dist/cjs/gui/event-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bridge.js","sourceRoot":"","sources":["../../../src/gui/event-bridge.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AA2NH,wCAKC;AAKD,4CAKC;AAKD,8CAEC;AA9OD,4DAA0D;AAC1D,yDAS4B;AAuB5B;;GAEG;AACH,MAAM,eAAe;IACX,MAAM,GAAY,KAAK,CAAC;IACxB,OAAO,GAAY,KAAK,CAAC;IACzB,KAAK,CAAgB;IACrB,aAAa,GAAgB,EAAE,CAAC;IAExC,YAAY,KAAqB;QAC/B,IAAI,CAAC,KAAK,GAAG,KAAK,IAAI,IAAA,kCAAe,GAAE,CAAC;IAC1C,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QAEzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QAEpB,kBAAkB;QAClB,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,QAAQ,EAAE,EAAE;YACtC,MAAM,KAAK,GAAG,IAAA,gCAAe,GAAE,CAAC;YAChC,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,OAAO,GAAG,IAAA,2CAAwB,EAAC,QAAQ,CAAC,CAAC;YACnD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QAEH,gBAAgB;QAChB,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE;YAChD,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,IAAI;QACF,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;OAEG;IACK,mBAAmB,CAAC,OAAkB;QAC5C,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;YACrB,KAAK,eAAe;gBAClB,IAAI,CAAC,KAAK,EAAE,CAAC;gBACb,MAAM;YACR,KAAK,gBAAgB;gBACnB,IAAI,CAAC,MAAM,EAAE,CAAC;gBACd,MAAM;YACR,KAAK,gBAAgB;gBACnB,IAAI,CAAC,KAAK,EAAE,CAAC;gBACb,MAAM;QACV,CAAC;IACH,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,OAAoB;QACnC,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAE1B,MAAM,OAAO,GAAG,IAAA,4CAAyB,EAAC,OAAO,CAAC,CAAC;QAEnD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,UAAU;YACV,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,mBAAmB,CAAC,SAAiB,EAAE,QAAsB;QAC3D,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAE1B,MAAM,OAAO,GAAG,IAAA,+CAA4B,EAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAElE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,UAAU;YACV,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,SAAiB,EAAE,KAAgB;QAClD,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAE1B,MAAM,OAAO,GAAG,IAAA,4CAAyB,EAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAE5D,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,UAAU;YACV,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QAExB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QAEnB,SAAS;QACT,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;YACnB,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QAEzB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QAEpB,SAAS;QACT,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;YACnB,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;QAEH,cAAc;QACd,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;QACD,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,OAAO;QACP,MAAM,KAAK,GAAG,IAAA,gCAAe,GAAE,CAAC;QAChC,KAAK,CAAC,KAAK,EAAE,CAAC;QAEd,UAAU;QACV,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;QAExB,SAAS;QACT,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAA,qCAAkB,GAAE,CAAC,CAAC;IAC7C,CAAC;CACF;AAED,OAAO;AACP,IAAI,YAAY,GAA2B,IAAI,CAAC;AAEhD;;GAEG;AACH,SAAgB,cAAc;IAC5B,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,YAAY,GAAG,IAAI,eAAe,EAAE,CAAC;IACvC,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB;IAC9B,IAAI,YAAY,EAAE,CAAC;QACjB,YAAY,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;IACD,YAAY,GAAG,IAAI,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAAC,KAAqB;IACrD,OAAO,IAAI,eAAe,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC"}

package/dist/cjs/gui/port-utils.js

@@ -0,0 +1,85 @@
+"use strict";
+/**
+ * 端口工具模块
+ *
+ * 提供获取可用端口的功能
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPortAvailable = isPortAvailable;
+exports.getAvailablePort = getAvailablePort;
+exports.getRandomAvailablePort = getRandomAvailablePort;
+const node_net_1 = require("node:net");
+/**
+ * 检查端口是否可用
+ */
+function isPortAvailable(port, host = '127.0.0.1') {
+    return new Promise((resolve) => {
+        const server = (0, node_net_1.createServer)();
+        server.once('error', () => {
+            resolve(false);
+        });
+        server.once('listening', () => {
+            server.close(() => {
+                resolve(true);
+            });
+        });
+        server.listen(port, host);
+    });
+}
+/**
+ * 获取可用端口
+ *
+ * @param preferredPort 首选端口，如果为 'auto' 则自动获取
+ * @param host 监听地址
+ * @param maxAttempts 最大尝试次数
+ * @returns 可用端口号
+ */
+async function getAvailablePort(preferredPort = 'auto', host = '127.0.0.1', maxAttempts = 10) {
+    // 如果是 'auto'，从随机端口开始
+    if (preferredPort === 'auto') {
+        return getRandomAvailablePort(host);
+    }
+    // 尝试首选端口
+    if (await isPortAvailable(preferredPort, host)) {
+        return preferredPort;
+    }
+    // 首选端口不可用，尝试后续端口
+    for (let i = 1; i < maxAttempts; i++) {
+        const port = preferredPort + i;
+        if (await isPortAvailable(port, host)) {
+            return port;
+        }
+    }
+    // 所有尝试都失败，获取随机可用端口
+    return getRandomAvailablePort(host);
+}
+/**
+ * 获取随机可用端口
+ *
+ * 通过让系统分配端口来获取可用端口
+ */
+function getRandomAvailablePort(host = '127.0.0.1') {
+    return new Promise((resolve, reject) => {
+        const server = (0, node_net_1.createServer)();
+        server.once('error', (err) => {
+            reject(err);
+        });
+        server.once('listening', () => {
+            const address = server.address();
+            if (address && typeof address === 'object') {
+                const port = address.port;
+                server.close(() => {
+                    resolve(port);
+                });
+            }
+            else {
+                server.close(() => {
+                    reject(new Error('无法获取端口'));
+                });
+            }
+        });
+        // 端口 0 让系统自动分配可用端口
+        server.listen(0, host);
+    });
+}
+//# sourceMappingURL=port-utils.js.map

package/dist/cjs/gui/port-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-utils.js","sourceRoot":"","sources":["../../../src/gui/port-utils.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAOH,0CAgBC;AAUD,4CAyBC;AAOD,wDAyBC;AAxFD,uCAAwC;AAExC;;GAEG;AACH,SAAgB,eAAe,CAAC,IAAY,EAAE,OAAe,WAAW;IACtE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,IAAA,uBAAY,GAAE,CAAC;QAE9B,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;YACxB,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;YAC5B,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE;gBAChB,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACI,KAAK,UAAU,gBAAgB,CACpC,gBAAiC,MAAM,EACvC,OAAe,WAAW,EAC1B,cAAsB,EAAE;IAExB,qBAAqB;IACrB,IAAI,aAAa,KAAK,MAAM,EAAE,CAAC;QAC7B,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,SAAS;IACT,IAAI,MAAM,eAAe,CAAC,aAAa,EAAE,IAAI,CAAC,EAAE,CAAC;QAC/C,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,iBAAiB;IACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,aAAa,GAAG,CAAC,CAAC;QAC/B,IAAI,MAAM,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,mBAAmB;IACnB,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAED;;;;GAIG;AACH,SAAgB,sBAAsB,CAAC,OAAe,WAAW;IAC/D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,IAAA,uBAAY,GAAE,CAAC;QAE9B,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YAC3B,MAAM,CAAC,GAAG,CAAC,CAAC;QACd,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;YAC5B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;YACjC,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;gBAC1B,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE;oBAChB,OAAO,CAAC,IAAI,CAAC,CAAC;gBAChB,CAAC,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE;oBAChB,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAC9B,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,mBAAmB;QACnB,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;AACL,CAAC"}