weixin-devtools-mcp 0.0.1 → 0.1.1

package/build/tools/connection.js

@@ -1,644 +1,369 @@
 /**
  * 连接管理工具
- * 负责微信开发者工具的连接和断开
+ * 提供 connect / reconnect / disconnect / status 能力
  */
+/* eslint-disable @typescript-eslint/ban-ts-comment -- wx 运行时对象在 evaluate 上下文中动态注入，需保持现有注释抑制。 */
 import { z } from 'zod';
-import { defineTool } from './ToolDefinition.js';
-import { connectDevtools, connectDevtoolsEnhanced, DevToolsConnectionError } from '../tools.js';
-/**
- * 创建请求拦截器函数
- * 从 network.ts 复制，用于自动启动网络监听
- */
-function createRequestInterceptor() {
-    return function (options) {
-        // @ts-ignore - wx is available in WeChat miniprogram environment
-        const wxObj = (typeof wx !== 'undefined' ? wx : null);
-        if (!wxObj) {
-            return this.origin(options);
-        }
-        if (!wxObj.__networkLogs) {
-            wxObj.__networkLogs = [];
-        }
-        const requestId = 'req_' + Date.now() + '_' + Math.random().toString(36).substring(2, 9);
-        const startTime = Date.now();
-        const originalSuccess = options.success;
-        options.success = function (res) {
-            wxObj.__networkLogs.push({
-                id: requestId,
-                type: 'request',
-                url: options.url,
-                method: options.method || 'GET',
-                headers: options.header,
-                data: options.data,
-                statusCode: res.statusCode,
-                response: res.data,
-                duration: Date.now() - startTime,
-                timestamp: new Date().toISOString(),
-                success: true
-            });
-            if (originalSuccess)
-                originalSuccess(res);
-        };
-        const originalFail = options.fail;
-        options.fail = function (err) {
-            wxObj.__networkLogs.push({
-                id: requestId,
-                type: 'request',
-                url: options.url,
-                method: options.method || 'GET',
-                headers: options.header,
-                data: options.data,
-                error: err.errMsg || String(err),
-                duration: Date.now() - startTime,
-                timestamp: new Date().toISOString(),
-                success: false
-            });
-            if (originalFail)
-                originalFail(err);
-        };
-        return this.origin(options);
+import { defineTool, ToolCategory } from './ToolDefinition.js';
+const strategyEnum = z.enum(['auto', 'launch', 'connect', 'wsEndpoint', 'browserUrl', 'discover']);
+const connectSchema = z.object({
+    strategy: strategyEnum.optional().default('auto')
+        .describe('连接策略: auto/launch/connect/wsEndpoint/browserUrl/discover'),
+    projectPath: z.string().optional().describe('小程序项目的绝对路径'),
+    cliPath: z.string().optional().describe('微信开发者工具 CLI 绝对路径（可选）'),
+    autoPort: z.number().optional().describe('自动化监听端口（可选）'),
+    browserUrl: z.string().optional().describe('已运行实例的 HTTP 调试地址，如 http://127.0.0.1:9222'),
+    wsEndpoint: z.string().optional().describe('已运行实例的 WS 地址，如 ws://127.0.0.1:9420'),
+    wsHeaders: z.record(z.string()).optional().describe('WS 自定义请求头'),
+    timeoutMs: z.number().optional().default(45000).describe('连接超时时间（毫秒）'),
+    fallback: z.array(strategyEnum).optional().describe('连接失败时的回退策略序列'),
+    healthCheck: z.boolean().optional().default(true).describe('是否执行连接健康检查'),
+    autoDiscover: z.boolean().optional().default(true).describe('auto 策略下是否优先尝试自动发现端点'),
+    verbose: z.boolean().optional().default(false).describe('是否输出详细日志'),
+    autoAudits: z.boolean().optional().describe('launch/connect 策略下是否启用体验评分'),
+});
+const reconnectSchema = z.object({
+    strategy: strategyEnum.optional().describe('可选，覆盖上次连接策略'),
+    projectPath: z.string().optional().describe('可选，覆盖上次项目路径'),
+    cliPath: z.string().optional(),
+    autoPort: z.number().optional(),
+    browserUrl: z.string().optional(),
+    wsEndpoint: z.string().optional(),
+    wsHeaders: z.record(z.string()).optional(),
+    timeoutMs: z.number().optional(),
+    fallback: z.array(strategyEnum).optional(),
+    healthCheck: z.boolean().optional(),
+    autoDiscover: z.boolean().optional(),
+    verbose: z.boolean().optional(),
+    autoAudits: z.boolean().optional(),
+});
+const statusSchema = z.object({
+    refreshHealth: z.boolean().optional().default(true).describe('是否刷新健康检查状态'),
+});
+function toConnectionRequest(params) {
+    return {
+        strategy: params.strategy,
+        projectPath: params.projectPath,
+        cliPath: params.cliPath,
+        autoPort: params.autoPort,
+        browserUrl: params.browserUrl,
+        wsEndpoint: params.wsEndpoint,
+        wsHeaders: params.wsHeaders,
+        timeoutMs: params.timeoutMs,
+        fallback: params.fallback,
+        healthCheck: params.healthCheck,
+        autoDiscover: params.autoDiscover,
+        verbose: params.verbose,
+        autoAudits: params.autoAudits,
     };
 }
-/**
- * 创建 uploadFile 拦截器函数
- */
-function createUploadFileInterceptor() {
-    return function (options) {
-        // @ts-ignore - wx is available in WeChat miniprogram environment
-        const wxObj = (typeof wx !== 'undefined' ? wx : null);
-        if (!wxObj) {
-            return this.origin(options);
-        }
-        if (!wxObj.__networkLogs) {
-            wxObj.__networkLogs = [];
-        }
-        const requestId = 'req_' + Date.now() + '_' + Math.random().toString(36).substring(2, 9);
-        const startTime = Date.now();
-        const originalSuccess = options.success;
-        options.success = function (res) {
-            wxObj.__networkLogs.push({
-                id: requestId,
-                type: 'uploadFile',
-                url: options.url,
-                headers: options.header,
-                data: {
-                    filePath: options.filePath,
-                    name: options.name,
-                    formData: options.formData
-                },
-                statusCode: res.statusCode,
-                response: res.data,
-                duration: Date.now() - startTime,
+function formatHealthSummary(health) {
+    if (!health) {
+        return 'unknown';
+    }
+    return `${health.level} (${health.checks.length} checks)`;
+}
+function updateConsoleStorage(context, updater) {
+    const storage = context.consoleStorage;
+    updater(storage);
+    context.consoleStorage = storage;
+}
+function updateNetworkStorage(context, updater) {
+    const storage = context.networkStorage;
+    updater(storage);
+    context.networkStorage = storage;
+}
+async function startAutomaticMonitoring(miniProgram, context, response) {
+    try {
+        const consoleHandler = (msg) => {
+            const consoleMessage = {
+                type: msg.type || 'log',
+                args: msg.args || [],
                 timestamp: new Date().toISOString(),
-                success: true
+                source: 'miniprogram',
+            };
+            updateConsoleStorage(context, storage => {
+                const currentSession = storage.navigations[0];
+                if (!currentSession) {
+                    return;
+                }
+                if (storage.idGenerator) {
+                    consoleMessage.msgid = storage.idGenerator();
+                    if (consoleMessage.msgid !== undefined) {
+                        storage.messageIdMap.set(consoleMessage.msgid, consoleMessage);
+                    }
+                }
+                currentSession.messages.push(consoleMessage);
             });
-            if (originalSuccess)
-                originalSuccess(res);
         };
-        const originalFail = options.fail;
-        options.fail = function (err) {
-            wxObj.__networkLogs.push({
-                id: requestId,
-                type: 'uploadFile',
-                url: options.url,
-                headers: options.header,
-                data: {
-                    filePath: options.filePath,
-                    name: options.name,
-                    formData: options.formData
-                },
-                error: err.errMsg || String(err),
-                duration: Date.now() - startTime,
+        const exceptionHandler = (err) => {
+            const exceptionMessage = {
+                message: err.message || 'Unknown exception',
+                stack: err.stack,
                 timestamp: new Date().toISOString(),
-                success: false
+                source: 'miniprogram',
+            };
+            updateConsoleStorage(context, storage => {
+                const currentSession = storage.navigations[0];
+                if (!currentSession) {
+                    return;
+                }
+                if (storage.idGenerator) {
+                    exceptionMessage.msgid = storage.idGenerator();
+                    if (exceptionMessage.msgid !== undefined) {
+                        storage.messageIdMap.set(exceptionMessage.msgid, exceptionMessage);
+                    }
+                }
+                currentSession.exceptions.push(exceptionMessage);
             });
-            if (originalFail)
-                originalFail(err);
         };
-        return this.origin(options);
-    };
-}
-/**
- * 创建 downloadFile 拦截器函数
- */
-function createDownloadFileInterceptor() {
-    return function (options) {
-        // @ts-ignore - wx is available in WeChat miniprogram environment
-        const wxObj = (typeof wx !== 'undefined' ? wx : null);
-        if (!wxObj) {
-            return this.origin(options);
+        if (typeof context.bindConsoleAndExceptionListeners === 'function') {
+            context.bindConsoleAndExceptionListeners({
+                consoleHandler,
+                exceptionHandler,
+            });
         }
-        if (!wxObj.__networkLogs) {
-            wxObj.__networkLogs = [];
+        else {
+            miniProgram.off('console', consoleHandler);
+            miniProgram.off('exception', exceptionHandler);
+            miniProgram.on('console', consoleHandler);
+            miniProgram.on('exception', exceptionHandler);
         }
-        const requestId = 'req_' + Date.now() + '_' + Math.random().toString(36).substring(2, 9);
-        const startTime = Date.now();
-        const originalSuccess = options.success;
-        options.success = function (res) {
-            wxObj.__networkLogs.push({
-                id: requestId,
-                type: 'downloadFile',
-                url: options.url,
-                headers: options.header,
-                statusCode: res.statusCode,
-                response: {
-                    tempFilePath: res.tempFilePath,
-                    filePath: res.filePath
-                },
-                duration: Date.now() - startTime,
-                timestamp: new Date().toISOString(),
-                success: true
+        updateConsoleStorage(context, storage => {
+            storage.isMonitoring = true;
+            storage.startTime = new Date().toISOString();
+        });
+        response.appendResponseLine('Console监听已自动启动');
+    }
+    catch (error) {
+        response.appendResponseLine(`警告: Console监听启动失败 - ${error instanceof Error ? error.message : String(error)}`);
+    }
+    try {
+        if (!context.networkStorage.isMonitoring) {
+            await miniProgram.evaluate(function () {
+                // @ts-ignore
+                if (typeof wx === 'undefined' || wx.__networkInterceptorsInstalled)
+                    return;
+                // @ts-ignore
+                wx.__networkLogs = wx.__networkLogs || [];
+                // @ts-ignore
+                wx.__networkLogsLimit = 1000;
+                // @ts-ignore
+                wx.__networkInterceptorsDisabled = false;
+                // @ts-ignore
+                wx.__pushNetworkLog = function (log) {
+                    // @ts-ignore
+                    if (wx.__networkInterceptorsDisabled)
+                        return;
+                    // @ts-ignore
+                    wx.__networkLogs.push(log);
+                    // @ts-ignore
+                    while (wx.__networkLogs.length > wx.__networkLogsLimit) {
+                        // @ts-ignore
+                        wx.__networkLogs.shift();
+                    }
+                };
+                // @ts-ignore
+                const _originalRequest = wx.request;
+                // @ts-ignore
+                const _originalUploadFile = wx.uploadFile;
+                // @ts-ignore
+                const _originalDownloadFile = wx.downloadFile;
+                // @ts-ignore
+                delete wx.request;
+                // @ts-ignore
+                Object.defineProperty(wx, 'request', {
+                    configurable: true,
+                    value: function (options) {
+                        // @ts-ignore
+                        if (wx.__networkInterceptorsDisabled)
+                            return _originalRequest.call(this, options);
+                        const id = 'req_' + Date.now() + '_' + Math.random().toString(36).substring(2, 9);
+                        const start = Date.now();
+                        const origSuccess = options.success;
+                        const origFail = options.fail;
+                        options.success = function (res) {
+                            // @ts-ignore
+                            wx.__pushNetworkLog({ id, type: 'request', url: options.url, method: options.method || 'GET',
+                                headers: options.header, data: options.data, statusCode: res.statusCode,
+                                response: res.data, duration: Date.now() - start, timestamp: new Date().toISOString(), success: true });
+                            if (origSuccess)
+                                origSuccess.call(this, res);
+                        };
+                        options.fail = function (err) {
+                            // @ts-ignore
+                            wx.__pushNetworkLog({ id, type: 'request', url: options.url, method: options.method || 'GET',
+                                headers: options.header, data: options.data, error: err.errMsg || String(err),
+                                duration: Date.now() - start, timestamp: new Date().toISOString(), success: false });
+                            if (origFail)
+                                origFail.call(this, err);
+                        };
+                        return _originalRequest.call(this, options);
+                    }
+                });
+                // @ts-ignore
+                delete wx.uploadFile;
+                // @ts-ignore
+                Object.defineProperty(wx, 'uploadFile', {
+                    configurable: true,
+                    value: function (options) {
+                        // @ts-ignore
+                        if (wx.__networkInterceptorsDisabled)
+                            return _originalUploadFile.call(this, options);
+                        const id = 'req_' + Date.now() + '_' + Math.random().toString(36).substring(2, 9);
+                        const start = Date.now();
+                        const origSuccess = options.success;
+                        const origFail = options.fail;
+                        options.success = function (res) {
+                            // @ts-ignore
+                            wx.__pushNetworkLog({ id, type: 'uploadFile', url: options.url, headers: options.header,
+                                data: { filePath: options.filePath, name: options.name, formData: options.formData },
+                                statusCode: res.statusCode, response: res.data, duration: Date.now() - start,
+                                timestamp: new Date().toISOString(), success: true });
+                            if (origSuccess)
+                                origSuccess.call(this, res);
+                        };
+                        options.fail = function (err) {
+                            // @ts-ignore
+                            wx.__pushNetworkLog({ id, type: 'uploadFile', url: options.url, headers: options.header,
+                                data: { filePath: options.filePath, name: options.name, formData: options.formData },
+                                error: err.errMsg || String(err), duration: Date.now() - start,
+                                timestamp: new Date().toISOString(), success: false });
+                            if (origFail)
+                                origFail.call(this, err);
+                        };
+                        return _originalUploadFile.call(this, options);
+                    }
+                });
+                // @ts-ignore
+                delete wx.downloadFile;
+                // @ts-ignore
+                Object.defineProperty(wx, 'downloadFile', {
+                    configurable: true,
+                    value: function (options) {
+                        // @ts-ignore
+                        if (wx.__networkInterceptorsDisabled)
+                            return _originalDownloadFile.call(this, options);
+                        const id = 'req_' + Date.now() + '_' + Math.random().toString(36).substring(2, 9);
+                        const start = Date.now();
+                        const origSuccess = options.success;
+                        const origFail = options.fail;
+                        options.success = function (res) {
+                            // @ts-ignore
+                            wx.__pushNetworkLog({ id, type: 'downloadFile', url: options.url, headers: options.header,
+                                statusCode: res.statusCode, response: { tempFilePath: res.tempFilePath, filePath: res.filePath },
+                                duration: Date.now() - start, timestamp: new Date().toISOString(), success: true });
+                            if (origSuccess)
+                                origSuccess.call(this, res);
+                        };
+                        options.fail = function (err) {
+                            // @ts-ignore
+                            wx.__pushNetworkLog({ id, type: 'downloadFile', url: options.url, headers: options.header,
+                                error: err.errMsg || String(err), duration: Date.now() - start,
+                                timestamp: new Date().toISOString(), success: false });
+                            if (origFail)
+                                origFail.call(this, err);
+                        };
+                        return _originalDownloadFile.call(this, options);
+                    }
+                });
+                // @ts-ignore
+                wx.__networkInterceptorsInstalled = true;
             });
-            if (originalSuccess)
-                originalSuccess(res);
-        };
-        const originalFail = options.fail;
-        options.fail = function (err) {
-            wxObj.__networkLogs.push({
-                id: requestId,
-                type: 'downloadFile',
-                url: options.url,
-                headers: options.header,
-                error: err.errMsg || String(err),
-                duration: Date.now() - startTime,
-                timestamp: new Date().toISOString(),
-                success: false
+            updateNetworkStorage(context, storage => {
+                storage.isMonitoring = true;
+                storage.startTime = new Date().toISOString();
             });
-            if (originalFail)
-                originalFail(err);
-        };
-        return this.origin(options);
-    };
+        }
+        response.appendResponseLine('网络监听已自动启动（增强型拦截）');
+    }
+    catch (error) {
+        response.appendResponseLine(`警告: 网络监听启动失败 - ${error instanceof Error ? error.message : String(error)}`);
+    }
 }
-/**
- * 连接到微信开发者工具（传统版）
- */
 export const connectDevtoolsTool = defineTool({
     name: 'connect_devtools',
-    description: '连接到微信开发者工具（传统模式，兼容性）',
-    schema: z.object({
-        projectPath: z.string().describe('小程序项目的绝对路径'),
-        cliPath: z.string().optional().describe('微信开发者工具CLI的绝对路径（可选，默认会自动查找）'),
-        port: z.number().optional().describe('WebSocket端口号（可选，默认自动分配）'),
-    }),
+    description: '连接微信开发者工具，支持多入口策略和自动回退',
+    schema: connectSchema,
     annotations: {
+        category: ToolCategory.CORE,
         audience: ['developers'],
     },
     handler: async (request, response, context) => {
-        const { projectPath, cliPath, port } = request.params;
-        // 检查是否已有活跃连接
-        if (context.miniProgram) {
-            try {
-                // 验证连接是否仍然有效
-                const currentPage = await context.miniProgram.currentPage();
-                const pagePath = await currentPage.path;
-                // 连接有效，复用现有连接
-                response.appendResponseLine(`✅ 检测到已有活跃连接，复用现有连接`);
-                response.appendResponseLine(`项目路径: ${projectPath}`);
-                response.appendResponseLine(`当前页面: ${pagePath}`);
-                response.appendResponseLine(`说明: 跳过重新连接，使用已建立的连接`);
-                return;
-            }
-            catch (error) {
-                // 连接已失效，清空并继续新建连接
-                context.miniProgram = null;
-                context.currentPage = null;
-            }
-        }
-        try {
-            const options = { projectPath };
-            if (cliPath)
-                options.cliPath = cliPath;
-            if (port)
-                options.port = port;
-            const result = await connectDevtools(options);
-            // 更新上下文
-            context.miniProgram = result.miniProgram;
-            context.currentPage = result.currentPage;
-            context.elementMap.clear();
-            // 自动启动console监听
-            try {
-                // 清除之前的监听器（如果有的话）
-                context.miniProgram.removeAllListeners('console');
-                context.miniProgram.removeAllListeners('exception');
-                // 启动console监听
-                context.consoleStorage.isMonitoring = true;
-                context.consoleStorage.startTime = new Date().toISOString();
-                context.miniProgram.on('console', (msg) => {
-                    const consoleMessage = {
-                        type: msg.type || 'log',
-                        args: msg.args || [],
-                        timestamp: new Date().toISOString(),
-                        source: 'miniprogram'
-                    };
-                    context.consoleStorage.consoleMessages.push(consoleMessage);
-                    console.log(`[Console ${msg.type}]:`, msg.args);
-                });
-                context.miniProgram.on('exception', (err) => {
-                    const exceptionMessage = {
-                        message: err.message || String(err),
-                        stack: err.stack,
-                        timestamp: new Date().toISOString(),
-                        source: 'miniprogram'
-                    };
-                    context.consoleStorage.exceptionMessages.push(exceptionMessage);
-                    console.log(`[Exception]:`, err.message, err.stack);
-                });
-                response.appendResponseLine(`Console监听已自动启动`);
-            }
-            catch (consoleError) {
-                response.appendResponseLine(`警告: Console监听启动失败 - ${consoleError instanceof Error ? consoleError.message : String(consoleError)}`);
-            }
-            // 自动启动网络监听（使用evaluate()方式绕过框架限制）
-            try {
-                if (!context.networkStorage.isMonitoring) {
-                    // 使用与network.ts相同的evaluate()注入方式，增加Mpx框架支持
-                    await context.miniProgram.evaluate(function () {
-                        // @ts-ignore
-                        if (typeof wx === 'undefined' || wx.__networkInterceptorsInstalled) {
-                            return;
-                        }
-                        // @ts-ignore
-                        wx.__networkLogs = wx.__networkLogs || [];
-                        // Mpx 拦截器已在 tools.ts 的 connectDevtools() 中统一注入
-                        // 此处仅保留 wx.request 回退拦截器（用于非 Mpx 框架或直接调用 wx API 的场景）
-                        // 保存原始方法（通过getter获取）
-                        // @ts-ignore
-                        const _originalRequest = wx.request;
-                        // @ts-ignore
-                        const _originalUploadFile = wx.uploadFile;
-                        // @ts-ignore
-                        const _originalDownloadFile = wx.downloadFile;
-                        // 拦截wx.request - 先删除getter
-                        // @ts-ignore
-                        delete wx.request;
-                        // @ts-ignore
-                        Object.defineProperty(wx, 'request', {
-                            configurable: true,
-                            value: function (options) {
-                                const id = 'req_' + Date.now() + '_' + Math.random().toString(36).substring(2, 9);
-                                const start = Date.now();
-                                const origSuccess = options.success;
-                                const origFail = options.fail;
-                                options.success = function (res) {
-                                    // @ts-ignore
-                                    wx.__networkLogs.push({
-                                        id, type: 'request', url: options.url, method: options.method || 'GET',
-                                        headers: options.header, data: options.data, statusCode: res.statusCode,
-                                        response: res.data, duration: Date.now() - start,
-                                        timestamp: new Date().toISOString(), success: true
-                                    });
-                                    if (origSuccess)
-                                        origSuccess.call(this, res);
-                                };
-                                options.fail = function (err) {
-                                    // @ts-ignore
-                                    wx.__networkLogs.push({
-                                        id, type: 'request', url: options.url, method: options.method || 'GET',
-                                        headers: options.header, data: options.data, error: err.errMsg || String(err),
-                                        duration: Date.now() - start, timestamp: new Date().toISOString(), success: false
-                                    });
-                                    if (origFail)
-                                        origFail.call(this, err);
-                                };
-                                return _originalRequest.call(this, options);
-                            }
-                        });
-                        // 拦截wx.uploadFile - 先删除getter
-                        // @ts-ignore
-                        delete wx.uploadFile;
-                        // @ts-ignore
-                        Object.defineProperty(wx, 'uploadFile', {
-                            configurable: true,
-                            value: function (options) {
-                                const id = 'req_' + Date.now() + '_' + Math.random().toString(36).substring(2, 9);
-                                const start = Date.now();
-                                const origSuccess = options.success;
-                                const origFail = options.fail;
-                                options.success = function (res) {
-                                    // @ts-ignore
-                                    wx.__networkLogs.push({
-                                        id, type: 'uploadFile', url: options.url, headers: options.header,
-                                        data: { filePath: options.filePath, name: options.name, formData: options.formData },
-                                        statusCode: res.statusCode, response: res.data, duration: Date.now() - start,
-                                        timestamp: new Date().toISOString(), success: true
-                                    });
-                                    if (origSuccess)
-                                        origSuccess.call(this, res);
-                                };
-                                options.fail = function (err) {
-                                    // @ts-ignore
-                                    wx.__networkLogs.push({
-                                        id, type: 'uploadFile', url: options.url, headers: options.header,
-                                        data: { filePath: options.filePath, name: options.name, formData: options.formData },
-                                        error: err.errMsg || String(err), duration: Date.now() - start,
-                                        timestamp: new Date().toISOString(), success: false
-                                    });
-                                    if (origFail)
-                                        origFail.call(this, err);
-                                };
-                                return _originalUploadFile.call(this, options);
-                            }
-                        });
-                        // 拦截wx.downloadFile - 先删除getter
-                        // @ts-ignore
-                        delete wx.downloadFile;
-                        // @ts-ignore
-                        Object.defineProperty(wx, 'downloadFile', {
-                            configurable: true,
-                            value: function (options) {
-                                const id = 'req_' + Date.now() + '_' + Math.random().toString(36).substring(2, 9);
-                                const start = Date.now();
-                                const origSuccess = options.success;
-                                const origFail = options.fail;
-                                options.success = function (res) {
-                                    // @ts-ignore
-                                    wx.__networkLogs.push({
-                                        id, type: 'downloadFile', url: options.url, headers: options.header,
-                                        statusCode: res.statusCode, response: { tempFilePath: res.tempFilePath, filePath: res.filePath },
-                                        duration: Date.now() - start, timestamp: new Date().toISOString(), success: true
-                                    });
-                                    if (origSuccess)
-                                        origSuccess.call(this, res);
-                                };
-                                options.fail = function (err) {
-                                    // @ts-ignore
-                                    wx.__networkLogs.push({
-                                        id, type: 'downloadFile', url: options.url, headers: options.header,
-                                        error: err.errMsg || String(err), duration: Date.now() - start,
-                                        timestamp: new Date().toISOString(), success: false
-                                    });
-                                    if (origFail)
-                                        origFail.call(this, err);
-                                };
-                                return _originalDownloadFile.call(this, options);
-                            }
-                        });
-                        // @ts-ignore
-                        wx.__networkInterceptorsInstalled = true;
-                    });
-                    context.networkStorage.isMonitoring = true;
-                    context.networkStorage.startTime = new Date().toISOString();
-                }
-                response.appendResponseLine(`网络监听已自动启动（增强型拦截）`);
-            }
-            catch (networkError) {
-                response.appendResponseLine(`警告: 网络监听启动失败 - ${networkError instanceof Error ? networkError.message : String(networkError)}`);
-            }
-            response.appendResponseLine(`成功连接到微信开发者工具 (传统模式)`);
-            response.appendResponseLine(`项目路径: ${projectPath}`);
-            response.appendResponseLine(`当前页面: ${result.pagePath}`);
+        const result = await context.connectDevtools(toConnectionRequest(request.params));
+        await startAutomaticMonitoring(result.miniProgram, context, response);
+        response.appendResponseLine('✅ 连接成功');
+        response.appendResponseLine(`连接ID: ${result.connectionId}`);
+        response.appendResponseLine(`策略: ${result.strategyUsed}`);
+        response.appendResponseLine(`连接状态: ${result.status}`);
+        response.appendResponseLine(`健康检查: ${formatHealthSummary(result.health)}`);
+        response.appendResponseLine(`当前页面: ${result.pagePath}`);
+        if (result.endpoint) {
+            response.appendResponseLine(`端点: ${result.endpoint}`);
         }
-        catch (error) {
-            const errorMessage = error instanceof Error ? error.message : String(error);
-            response.appendResponseLine(`连接失败: ${errorMessage}`);
-            throw error;
+        response.appendResponseLine(`耗时: total=${result.timing.totalMs}ms, connect=${result.timing.connectMs}ms, health=${result.timing.healthMs}ms`);
+        if (result.warnings.length > 0) {
+            response.appendResponseLine(`回退告警: ${result.warnings.join(' | ')}`);
         }
     },
 });
-/**
- * 智能连接到微信开发者工具（增强版）
- */
-export const connectDevtoolsEnhancedTool = defineTool({
-    name: 'connect_devtools_enhanced',
-    description: '智能连接到微信开发者工具，支持多种模式和自动回退（推荐）',
-    schema: z.object({
-        projectPath: z.string().describe('小程序项目的绝对路径'),
-        mode: z.enum(['auto', 'launch', 'connect']).optional().default('auto')
-            .describe('连接模式: auto(智能), launch(传统), connect(两阶段)'),
-        cliPath: z.string().optional().describe('微信开发者工具CLI的绝对路径（可选）'),
-        autoPort: z.number().optional().describe('自动化监听端口（可选，默认自动检测）'),
-        autoAccount: z.string().optional().describe('指定用户openid（--auto-account）'),
-        timeout: z.number().optional().default(45000).describe('连接超时时间（毫秒）'),
-        fallbackMode: z.boolean().optional().default(true).describe('允许模式回退'),
-        healthCheck: z.boolean().optional().default(true).describe('执行健康检查'),
-        verbose: z.boolean().optional().default(false).describe('详细日志输出'),
-    }),
+export const reconnectDevtoolsTool = defineTool({
+    name: 'reconnect_devtools',
+    description: '重新连接微信开发者工具，可复用上一次连接参数',
+    schema: reconnectSchema,
     annotations: {
+        category: ToolCategory.CORE,
         audience: ['developers'],
     },
     handler: async (request, response, context) => {
-        const { projectPath, mode, cliPath, autoPort, autoAccount, timeout, fallbackMode, healthCheck, verbose } = request.params;
-        // 检查是否已有活跃连接
-        if (context.miniProgram) {
-            try {
-                // 验证连接是否仍然有效
-                const currentPage = await context.miniProgram.currentPage();
-                const pagePath = await currentPage.path;
-                // 连接有效，复用现有连接
-                response.appendResponseLine(`✅ 检测到已有活跃连接，复用现有连接`);
-                response.appendResponseLine(`项目路径: ${projectPath}`);
-                response.appendResponseLine(`当前页面: ${pagePath}`);
-                response.appendResponseLine(`说明: 跳过重新连接，使用已建立的连接`);
-                if (verbose) {
-                    response.appendResponseLine(`提示: 如需强制重新连接，请先关闭微信开发者工具`);
-                }
-                return;
-            }
-            catch (error) {
-                // 连接已失效，清空并继续新建连接
-                if (verbose) {
-                    response.appendResponseLine(`检测到已有连接但已失效，准备重新连接...`);
-                }
-                context.miniProgram = null;
-                context.currentPage = null;
-            }
-        }
-        try {
-            const options = {
-                projectPath,
-                mode,
-                cliPath,
-                autoPort,
-                autoAccount,
-                timeout,
-                fallbackMode,
-                healthCheck,
-                verbose
-            };
-            const result = await connectDevtoolsEnhanced(options);
-            // 更新上下文
-            context.miniProgram = result.miniProgram;
-            context.currentPage = result.currentPage;
-            context.elementMap.clear();
-            // 自动启动console监听
-            try {
-                // 清除之前的监听器（如果有的话）
-                context.miniProgram.removeAllListeners('console');
-                context.miniProgram.removeAllListeners('exception');
-                // 启动console监听
-                context.consoleStorage.isMonitoring = true;
-                context.consoleStorage.startTime = new Date().toISOString();
-                context.miniProgram.on('console', (msg) => {
-                    const consoleMessage = {
-                        type: msg.type || 'log',
-                        args: msg.args || [],
-                        timestamp: new Date().toISOString(),
-                        source: 'miniprogram'
-                    };
-                    context.consoleStorage.consoleMessages.push(consoleMessage);
-                    console.log(`[Console ${msg.type}]:`, msg.args);
-                });
-                context.miniProgram.on('exception', (err) => {
-                    const exceptionMessage = {
-                        message: err.message || String(err),
-                        stack: err.stack,
-                        timestamp: new Date().toISOString(),
-                        source: 'miniprogram'
-                    };
-                    context.consoleStorage.exceptionMessages.push(exceptionMessage);
-                    console.log(`[Exception]:`, err.message, err.stack);
-                });
-                response.appendResponseLine(`Console监听已自动启动`);
-            }
-            catch (consoleError) {
-                response.appendResponseLine(`警告: Console监听启动失败 - ${consoleError instanceof Error ? consoleError.message : String(consoleError)}`);
-            }
-            // 自动启动网络监听（使用evaluate()方式绕过框架限制）
-            try {
-                if (!context.networkStorage.isMonitoring) {
-                    // 使用evaluate()注入拦截器（与第一个工具相同的逻辑）
-                    await context.miniProgram.evaluate(function () {
-                        // @ts-ignore
-                        if (typeof wx === 'undefined' || wx.__networkInterceptorsInstalled)
-                            return;
-                        // @ts-ignore
-                        wx.__networkLogs = wx.__networkLogs || [];
-                        // Mpx 拦截器已在 tools.ts 的 connectDevtools() 中统一注入
-                        // 此处仅保留 wx.request 回退拦截器（用于非 Mpx 框架或直接调用 wx API 的场景）
-                        // @ts-ignore - 保存原始方法（通过getter获取）
-                        const _originalRequest = wx.request;
-                        // @ts-ignore
-                        const _originalUploadFile = wx.uploadFile;
-                        // @ts-ignore
-                        const _originalDownloadFile = wx.downloadFile;
-                        // @ts-ignore - 先删除getter
-                        delete wx.request;
-                        // @ts-ignore
-                        Object.defineProperty(wx, 'request', {
-                            configurable: true,
-                            value: function (options) {
-                                const id = 'req_' + Date.now() + '_' + Math.random().toString(36).substring(2, 9);
-                                const start = Date.now();
-                                const origSuccess = options.success;
-                                const origFail = options.fail;
-                                options.success = function (res) {
-                                    // @ts-ignore
-                                    wx.__networkLogs.push({ id, type: 'request', url: options.url, method: options.method || 'GET',
-                                        headers: options.header, data: options.data, statusCode: res.statusCode,
-                                        response: res.data, duration: Date.now() - start, timestamp: new Date().toISOString(), success: true });
-                                    if (origSuccess)
-                                        origSuccess.call(this, res);
-                                };
-                                options.fail = function (err) {
-                                    // @ts-ignore
-                                    wx.__networkLogs.push({ id, type: 'request', url: options.url, method: options.method || 'GET',
-                                        headers: options.header, data: options.data, error: err.errMsg || String(err),
-                                        duration: Date.now() - start, timestamp: new Date().toISOString(), success: false });
-                                    if (origFail)
-                                        origFail.call(this, err);
-                                };
-                                return _originalRequest.call(this, options);
-                            }
-                        });
-                        // @ts-ignore - 先删除getter
-                        delete wx.uploadFile;
-                        // @ts-ignore
-                        Object.defineProperty(wx, 'uploadFile', {
-                            configurable: true,
-                            value: function (options) {
-                                const id = 'req_' + Date.now() + '_' + Math.random().toString(36).substring(2, 9);
-                                const start = Date.now();
-                                const origSuccess = options.success;
-                                const origFail = options.fail;
-                                options.success = function (res) {
-                                    // @ts-ignore
-                                    wx.__networkLogs.push({ id, type: 'uploadFile', url: options.url, headers: options.header,
-                                        data: { filePath: options.filePath, name: options.name, formData: options.formData },
-                                        statusCode: res.statusCode, response: res.data, duration: Date.now() - start,
-                                        timestamp: new Date().toISOString(), success: true });
-                                    if (origSuccess)
-                                        origSuccess.call(this, res);
-                                };
-                                options.fail = function (err) {
-                                    // @ts-ignore
-                                    wx.__networkLogs.push({ id, type: 'uploadFile', url: options.url, headers: options.header,
-                                        data: { filePath: options.filePath, name: options.name, formData: options.formData },
-                                        error: err.errMsg || String(err), duration: Date.now() - start,
-                                        timestamp: new Date().toISOString(), success: false });
-                                    if (origFail)
-                                        origFail.call(this, err);
-                                };
-                                return _originalUploadFile.call(this, options);
-                            }
-                        });
-                        // @ts-ignore - 先删除getter
-                        delete wx.downloadFile;
-                        // @ts-ignore
-                        Object.defineProperty(wx, 'downloadFile', {
-                            configurable: true,
-                            value: function (options) {
-                                const id = 'req_' + Date.now() + '_' + Math.random().toString(36).substring(2, 9);
-                                const start = Date.now();
-                                const origSuccess = options.success;
-                                const origFail = options.fail;
-                                options.success = function (res) {
-                                    // @ts-ignore
-                                    wx.__networkLogs.push({ id, type: 'downloadFile', url: options.url, headers: options.header,
-                                        statusCode: res.statusCode, response: { tempFilePath: res.tempFilePath, filePath: res.filePath },
-                                        duration: Date.now() - start, timestamp: new Date().toISOString(), success: true });
-                                    if (origSuccess)
-                                        origSuccess.call(this, res);
-                                };
-                                options.fail = function (err) {
-                                    // @ts-ignore
-                                    wx.__networkLogs.push({ id, type: 'downloadFile', url: options.url, headers: options.header,
-                                        error: err.errMsg || String(err), duration: Date.now() - start,
-                                        timestamp: new Date().toISOString(), success: false });
-                                    if (origFail)
-                                        origFail.call(this, err);
-                                };
-                                return _originalDownloadFile.call(this, options);
-                            }
-                        });
-                        // @ts-ignore
-                        wx.__networkInterceptorsInstalled = true;
-                    });
-                    context.networkStorage.isMonitoring = true;
-                    context.networkStorage.startTime = new Date().toISOString();
-                }
-                response.appendResponseLine(`网络监听已自动启动（增强型拦截）`);
-            }
-            catch (networkError) {
-                response.appendResponseLine(`警告: 网络监听启动失败 - ${networkError instanceof Error ? networkError.message : String(networkError)}`);
-            }
-            // 根据结果显示详细信息
-            response.appendResponseLine(`✅ 智能连接成功`);
-            response.appendResponseLine(`项目路径: ${projectPath}`);
-            response.appendResponseLine(`当前页面: ${result.pagePath}`);
-            response.appendResponseLine(`连接模式: ${result.connectionMode}`);
-            response.appendResponseLine(`启动耗时: ${result.startupTime}ms`);
-            response.appendResponseLine(`健康状态: ${result.healthStatus}`);
-            if (result.processInfo) {
-                response.appendResponseLine(`进程信息: PID=${result.processInfo.pid}, Port=${result.processInfo.port}`);
-            }
-        }
-        catch (error) {
-            // 处理增强错误信息
-            if (error instanceof DevToolsConnectionError) {
-                response.appendResponseLine(`❗ ${error.phase}阶段失败: ${error.message}`);
-                if (error.originalError) {
-                    response.appendResponseLine(`原始错误: ${error.originalError.message}`);
-                }
-                if (error.details && verbose) {
-                    response.appendResponseLine(`详细信息: ${JSON.stringify(error.details, null, 2)}`);
-                }
-            }
-            else {
-                const errorMessage = error instanceof Error ? error.message : String(error);
-                response.appendResponseLine(`连接失败: ${errorMessage}`);
-            }
-            throw error;
+        const params = toConnectionRequest(request.params);
+        const hasOverride = Object.values(params).some(value => value !== undefined);
+        const result = hasOverride
+            ? await context.reconnectDevtools(params)
+            : await context.reconnectDevtools();
+        await startAutomaticMonitoring(result.miniProgram, context, response);
+        response.appendResponseLine('✅ 重连成功');
+        response.appendResponseLine(`连接ID: ${result.connectionId}`);
+        response.appendResponseLine(`策略: ${result.strategyUsed}`);
+        response.appendResponseLine(`连接状态: ${result.status}`);
+        response.appendResponseLine(`健康检查: ${formatHealthSummary(result.health)}`);
+        response.appendResponseLine(`当前页面: ${result.pagePath}`);
+    },
+});
+export const disconnectDevtoolsTool = defineTool({
+    name: 'disconnect_devtools',
+    description: '断开与微信开发者工具的连接并清理上下文状态',
+    schema: z.object({}),
+    annotations: {
+        category: ToolCategory.CORE,
+        audience: ['developers'],
+    },
+    handler: async (_request, response, context) => {
+        const status = await context.disconnectDevtools();
+        response.appendResponseLine('✅ 已断开连接');
+        response.appendResponseLine(`当前状态: ${status.state}`);
+    },
+});
+export const getConnectionStatusTool = defineTool({
+    name: 'get_connection_status',
+    description: '获取当前连接状态（可选刷新健康检查）',
+    schema: statusSchema,
+    annotations: {
+        category: ToolCategory.CORE,
+        audience: ['developers'],
+    },
+    handler: async (request, response, context) => {
+        const params = request.params;
+        const status = await context.getConnectionStatus({
+            refreshHealth: params.refreshHealth,
+        });
+        response.appendResponseLine(`连接状态: ${status.state}`);
+        response.appendResponseLine(`已连接: ${status.connected ? '是' : '否'}`);
+        response.appendResponseLine(`策略: ${status.strategyUsed ?? 'N/A'}`);
+        response.appendResponseLine(`页面: ${status.pagePath ?? 'N/A'}`);
+        response.appendResponseLine(`健康检查: ${formatHealthSummary(status.health)}`);
+        if (status.lastError) {
+            response.appendResponseLine(`最近错误: [${status.lastError.code}] ${status.lastError.message}`);
         }
     },
 });
@@ -650,9 +375,10 @@ export const getCurrentPageTool = defineTool({
     description: '获取当前页面信息并设置为活动页面',
     schema: z.object({}),
     annotations: {
+        category: ToolCategory.CORE,
         audience: ['developers'],
     },
-    handler: async (request, response, context) => {
+    handler: async (_request, response, context) => {
         if (!context.miniProgram) {
             throw new Error('请先连接到微信开发者工具');
         }
@@ -668,3 +394,4 @@ export const getCurrentPageTool = defineTool({
         }
     },
 });
+//# sourceMappingURL=connection.js.map