@mt0926/node-network-devtools 0.1.0

package/dist/esm/context/context-manager.js

@@ -0,0 +1,126 @@
+/**
+ * 上下文管理器
+ *
+ * 使用 AsyncLocalStorage 实现请求追踪上下文
+ * 支持跨异步边界传递 TraceID
+ */
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { nanoid } from 'nanoid';
+// AsyncLocalStorage 实例
+const asyncLocalStorage = new AsyncLocalStorage();
+/**
+ * 生成唯一的 TraceID
+ */
+export function generateTraceId() {
+    return `trace_${nanoid(16)}`;
+}
+/**
+ * 获取当前追踪上下文
+ */
+export function getCurrentContext() {
+    return asyncLocalStorage.getStore();
+}
+/**
+ * 获取当前 TraceID
+ */
+export function getCurrentTraceId() {
+    return asyncLocalStorage.getStore()?.traceId;
+}
+/**
+ * 开始新的追踪
+ *
+ * @param traceId 可选的 TraceID，不提供则自动生成
+ * @param metadata 可选的元数据
+ * @returns 新的追踪上下文
+ */
+export function startTrace(traceId, metadata) {
+    const currentContext = getCurrentContext();
+    const context = {
+        traceId: traceId || generateTraceId(),
+        parentTraceId: currentContext?.traceId,
+        startTime: Date.now(),
+        metadata,
+    };
+    return context;
+}
+/**
+ * 在追踪上下文中运行函数
+ *
+ * @param context 追踪上下文
+ * @param fn 要运行的函数
+ * @returns 函数的返回值
+ */
+export function runWithContext(context, fn) {
+    return asyncLocalStorage.run(context, fn);
+}
+/**
+ * 在新的追踪上下文中运行函数
+ *
+ * @param fn 要运行的函数
+ * @param traceId 可选的 TraceID
+ * @param metadata 可选的元数据
+ * @returns 函数的返回值
+ */
+export function runWithTrace(fn, traceId, metadata) {
+    const context = startTrace(traceId, metadata);
+    return runWithContext(context, fn);
+}
+/**
+ * 在新的追踪上下文中运行异步函数
+ *
+ * @param fn 要运行的异步函数
+ * @param traceId 可选的 TraceID
+ * @param metadata 可选的元数据
+ * @returns Promise
+ */
+export async function runWithTraceAsync(fn, traceId, metadata) {
+    const context = startTrace(traceId, metadata);
+    return asyncLocalStorage.run(context, fn);
+}
+/**
+ * 更新当前上下文的元数据
+ *
+ * @param metadata 要合并的元数据
+ */
+export function updateContextMetadata(metadata) {
+    const context = getCurrentContext();
+    if (context) {
+        context.metadata = {
+            ...context.metadata,
+            ...metadata,
+        };
+    }
+}
+/**
+ * 获取追踪持续时间（毫秒）
+ */
+export function getTraceDuration() {
+    const context = getCurrentContext();
+    if (context) {
+        return Date.now() - context.startTime;
+    }
+    return undefined;
+}
+/**
+ * 创建获取当前 TraceID 的回调函数
+ * 用于传递给拦截器
+ */
+export function createTraceIdGetter() {
+    return getCurrentTraceId;
+}
+/**
+ * ContextManager 对象
+ */
+export const ContextManager = {
+    generateTraceId,
+    getCurrentContext,
+    getCurrentTraceId,
+    startTrace,
+    runWithContext,
+    runWithTrace,
+    runWithTraceAsync,
+    updateContextMetadata,
+    getTraceDuration,
+    createTraceIdGetter,
+};
+//# sourceMappingURL=context-manager.js.map

package/dist/esm/context/context-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-manager.js","sourceRoot":"","sources":["../../../src/context/context-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAgBhC,uBAAuB;AACvB,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,EAAgB,CAAC;AAEhE;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,SAAS,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,iBAAiB,CAAC,QAAQ,EAAE,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,iBAAiB,CAAC,QAAQ,EAAE,EAAE,OAAO,CAAC;AAC/C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,OAAgB,EAAE,QAAkC;IAC7E,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAC;IAE3C,MAAM,OAAO,GAAiB;QAC5B,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE;QACrC,aAAa,EAAE,cAAc,EAAE,OAAO;QACtC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,QAAQ;KACT,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAI,OAAqB,EAAE,EAAW;IAClE,OAAO,iBAAiB,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAC1B,EAAW,EACX,OAAgB,EAChB,QAAkC;IAElC,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC9C,OAAO,cAAc,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AACrC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,EAAoB,EACpB,OAAgB,EAChB,QAAkC;IAElC,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC9C,OAAO,iBAAiB,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAiC;IACrE,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;IACpC,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CAAC,QAAQ,GAAG;YACjB,GAAG,OAAO,CAAC,QAAQ;YACnB,GAAG,QAAQ;SACZ,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;IACpC,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC;IACxC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,eAAe;IACf,iBAAiB;IACjB,iBAAiB;IACjB,UAAU;IACV,cAAc;IACd,YAAY;IACZ,iBAAiB;IACjB,qBAAqB;IACrB,gBAAgB;IAChB,mBAAmB;CACpB,CAAC"}

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

@@ -0,0 +1,165 @@
+/**
+ * 浏览器启动器模块
+ *
+ * 支持使用系统默认浏览器或 Puppeteer 打开 GUI
+ */
+import { getConfig } from '../config.js';
+/**
+ * 浏览器启动器实现
+ */
+class BrowserLauncherImpl {
+    puppeteerBrowser = null;
+    puppeteerPage = null;
+    isOpened = false;
+    /**
+     * 打开浏览器
+     */
+    async open(url) {
+        const config = getConfig();
+        if (config.usePuppeteer) {
+            await this.openWithPuppeteer(url);
+        }
+        else {
+            await this.openWithDefaultBrowser(url);
+        }
+        this.isOpened = true;
+    }
+    /**
+     * 使用系统默认浏览器打开
+     */
+    async openWithDefaultBrowser(url) {
+        try {
+            // 动态导入 open 包
+            const openModule = await import('open');
+            const open = openModule.default;
+            await open(url);
+            console.log(`[node-network-devtools] 已在默认浏览器中打开: ${url}`);
+        }
+        catch (err) {
+            console.error('[node-network-devtools] 无法打开默认浏览器:', err);
+            throw err;
+        }
+    }
+    /**
+     * 使用 Puppeteer 打开
+     */
+    async openWithPuppeteer(url) {
+        try {
+            // 动态导入 puppeteer（可选依赖）
+            const puppeteer = await import('puppeteer');
+            // 启动浏览器
+            this.puppeteerBrowser = await puppeteer.default.launch({
+                headless: false,
+                defaultViewport: null,
+                args: [
+                    '--no-sandbox',
+                    '--disable-setuid-sandbox',
+                    `--window-size=1200,800`,
+                ],
+            });
+            // 创建新页面
+            const browser = this.puppeteerBrowser;
+            this.puppeteerPage = await browser.newPage();
+            // 导航到 URL
+            const page = this.puppeteerPage;
+            await page.goto(url);
+            console.log(`[node-network-devtools] 已使用 Puppeteer 打开: ${url}`);
+        }
+        catch (err) {
+            if (err.code === 'MODULE_NOT_FOUND') {
+                console.error('[node-network-devtools] Puppeteer 未安装，请运行: pnpm add puppeteer');
+                // 回退到默认浏览器
+                console.log('[node-network-devtools] 回退到默认浏览器...');
+                await this.openWithDefaultBrowser(url);
+            }
+            else {
+                console.error('[node-network-devtools] Puppeteer 启动失败:', err);
+                throw err;
+            }
+        }
+    }
+    /**
+     * 关闭浏览器
+     */
+    async close() {
+        if (this.puppeteerBrowser) {
+            try {
+                const browser = this.puppeteerBrowser;
+                await browser.close();
+            }
+            catch {
+                // 忽略关闭错误
+            }
+            this.puppeteerBrowser = null;
+            this.puppeteerPage = null;
+        }
+        this.isOpened = false;
+    }
+    /**
+     * 检查浏览器是否已打开
+     */
+    isOpen() {
+        return this.isOpened;
+    }
+}
+// 全局单例
+let globalLauncher = null;
+/**
+ * 获取全局浏览器启动器实例
+ */
+export function getBrowserLauncher() {
+    if (!globalLauncher) {
+        globalLauncher = new BrowserLauncherImpl();
+    }
+    return globalLauncher;
+}
+/**
+ * 重置全局浏览器启动器（用于测试）
+ */
+export async function resetBrowserLauncher() {
+    if (globalLauncher) {
+        await globalLauncher.close();
+    }
+    globalLauncher = null;
+}
+/**
+ * 创建新的浏览器启动器实例（用于测试）
+ */
+export function createBrowserLauncher() {
+    return new BrowserLauncherImpl();
+}
+/**
+ * 构建带 WebSocket 端口参数的 GUI URL
+ */
+export function buildGUIUrl(host, guiPort, wsPort) {
+    return `http://${host}:${guiPort}?wsPort=${wsPort}`;
+}
+/**
+ * 打开浏览器（便捷函数）
+ */
+export async function openBrowser(url, options) {
+    const launcher = getBrowserLauncher();
+    // 如果指定了 usePuppeteer，临时修改配置
+    if (options?.usePuppeteer !== undefined) {
+        const { setConfig, getConfig } = await import('../config.js');
+        const originalConfig = getConfig();
+        setConfig({ usePuppeteer: options.usePuppeteer });
+        try {
+            await launcher.open(url);
+        }
+        finally {
+            setConfig({ usePuppeteer: originalConfig.usePuppeteer });
+        }
+    }
+    else {
+        await launcher.open(url);
+    }
+}
+/**
+ * 关闭浏览器（便捷函数）
+ */
+export async function closeBrowser() {
+    const launcher = getBrowserLauncher();
+    await launcher.close();
+}
+//# sourceMappingURL=browser-launcher.js.map

package/dist/esm/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/esm/gui/event-bridge.js

@@ -0,0 +1,192 @@
+/**
+ * Event Bridge 模块
+ *
+ * 连接请求拦截器和 WebSocket Hub，实现事件转发
+ * 支持暂停/恢复和清空功能
+ */
+import { getRequestStore } from '../store/ring-buffer.js';
+import { getWebSocketHub, createRequestStartMessage, createRequestCompleteMessage, createRequestErrorMessage, createInitialDataMessage, createClearMessage, } from './websocket-hub.js';
+/**
+ * Event Bridge 实现
+ */
+class EventBridgeImpl {
+    paused = false;
+    running = false;
+    wsHub;
+    pendingEvents = [];
+    constructor(wsHub) {
+        this.wsHub = wsHub ?? getWebSocketHub();
+    }
+    /**
+     * 启动 Event Bridge
+     * 注册 WebSocket 客户端连接回调，发送初始数据
+     */
+    start() {
+        if (this.running)
+            return;
+        this.running = true;
+        // 当新客户端连接时，发送初始数据
+        this.wsHub.onClientConnect((clientId) => {
+            const store = getRequestStore();
+            const requests = store.getAll();
+            const message = 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 = createRequestStartMessage(request);
+        if (this.paused) {
+            // 暂停时缓存事件
+            this.pendingEvents.push(message);
+        }
+        else {
+            this.wsHub.broadcast(message);
+        }
+    }
+    /**
+     * 发送请求完成事件
+     */
+    emitRequestComplete(requestId, response) {
+        if (!this.running)
+            return;
+        const message = createRequestCompleteMessage(requestId, response);
+        if (this.paused) {
+            // 暂停时缓存事件
+            this.pendingEvents.push(message);
+        }
+        else {
+            this.wsHub.broadcast(message);
+        }
+    }
+    /**
+     * 发送请求错误事件
+     */
+    emitRequestError(requestId, error) {
+        if (!this.running)
+            return;
+        const message = 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 = getRequestStore();
+        store.clear();
+        // 清空缓存的事件
+        this.pendingEvents = [];
+        // 广播清空消息
+        this.wsHub.broadcast(createClearMessage());
+    }
+}
+// 全局单例
+let globalBridge = null;
+/**
+ * 获取全局 Event Bridge 实例
+ */
+export function getEventBridge() {
+    if (!globalBridge) {
+        globalBridge = new EventBridgeImpl();
+    }
+    return globalBridge;
+}
+/**
+ * 重置全局 Event Bridge（用于测试）
+ */
+export function resetEventBridge() {
+    if (globalBridge) {
+        globalBridge.stop();
+    }
+    globalBridge = null;
+}
+/**
+ * 创建新的 Event Bridge 实例（用于测试）
+ */
+export function createEventBridge(wsHub) {
+    return new EventBridgeImpl(wsHub);
+}
+//# sourceMappingURL=event-bridge.js.map

package/dist/esm/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;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EACL,eAAe,EACf,yBAAyB,EACzB,4BAA4B,EAC5B,yBAAyB,EACzB,wBAAwB,EACxB,kBAAkB,GAGnB,MAAM,oBAAoB,CAAC;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,eAAe,EAAE,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,eAAe,EAAE,CAAC;YAChC,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,OAAO,GAAG,wBAAwB,CAAC,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,yBAAyB,CAAC,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,4BAA4B,CAAC,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,yBAAyB,CAAC,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,eAAe,EAAE,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,kBAAkB,EAAE,CAAC,CAAC;IAC7C,CAAC;CACF;AAED,OAAO;AACP,IAAI,YAAY,GAA2B,IAAI,CAAC;AAEhD;;GAEG;AACH,MAAM,UAAU,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,MAAM,UAAU,gBAAgB;IAC9B,IAAI,YAAY,EAAE,CAAC;QACjB,YAAY,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;IACD,YAAY,GAAG,IAAI,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAqB;IACrD,OAAO,IAAI,eAAe,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC"}

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

@@ -0,0 +1,80 @@
+/**
+ * 端口工具模块
+ *
+ * 提供获取可用端口的功能
+ */
+import { createServer } from 'node:net';
+/**
+ * 检查端口是否可用
+ */
+export function isPortAvailable(port, host = '127.0.0.1') {
+    return new Promise((resolve) => {
+        const server = 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 可用端口号
+ */
+export 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);
+}
+/**
+ * 获取随机可用端口
+ *
+ * 通过让系统分配端口来获取可用端口
+ */
+export function getRandomAvailablePort(host = '127.0.0.1') {
+    return new Promise((resolve, reject) => {
+        const server = 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/esm/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;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,OAAe,WAAW;IACtE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,YAAY,EAAE,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;AACH,MAAM,CAAC,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,MAAM,UAAU,sBAAsB,CAAC,OAAe,WAAW;IAC/D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,YAAY,EAAE,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"}