weixin-devtools-mcp 0.0.1

package/build/tools/input.js

@@ -0,0 +1,255 @@
+/**
+ * 输入交互工具
+ * 负责页面元素的点击、填写等交互操作
+ */
+import { z } from 'zod';
+import { defineTool } from './ToolDefinition.js';
+import { clickElement, inputText, getElementValue, setFormControl } from '../tools.js';
+/**
+ * 点击页面元素
+ */
+export const clickTool = defineTool({
+    name: 'click',
+    description: '点击指定uid的页面元素',
+    schema: z.object({
+        uid: z.string().describe('页面快照中元素的唯一标识符'),
+        dblClick: z.boolean().optional().default(false).describe('是否为双击，默认false'),
+    }),
+    annotations: {
+        audience: ['developers'],
+    },
+    handler: async (request, response, context) => {
+        const { uid, dblClick } = request.params;
+        if (!context.currentPage) {
+            throw new Error('请先获取当前页面');
+        }
+        try {
+            const options = { uid, dblClick };
+            await clickElement(context.currentPage, context.elementMap, options);
+            const action = dblClick ? '双击' : '点击';
+            response.appendResponseLine(`${action}元素成功`);
+            response.appendResponseLine(`UID: ${uid}`);
+            // 点击后可能页面发生变化，建议包含快照
+            response.setIncludeSnapshot(true);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            response.appendResponseLine(`点击元素失败: ${errorMessage}`);
+            throw error;
+        }
+    },
+});
+/**
+ * 向元素输入文本
+ */
+export const inputTextTool = defineTool({
+    name: 'input_text',
+    description: '向input/textarea元素输入文本',
+    schema: z.object({
+        uid: z.string().describe('页面快照中元素的唯一标识符'),
+        text: z.string().describe('要输入的文本内容'),
+        clear: z.boolean().optional().default(false).describe('是否先清空元素内容，默认false'),
+        append: z.boolean().optional().default(false).describe('是否追加到现有内容，默认false'),
+    }),
+    annotations: {
+        audience: ['developers'],
+    },
+    handler: async (request, response, context) => {
+        const { uid, text, clear, append } = request.params;
+        if (!context.currentPage) {
+            throw new Error('请先获取当前页面');
+        }
+        try {
+            const options = { uid, text, clear, append };
+            await inputText(context.currentPage, context.elementMap, options);
+            let action = '输入文本';
+            if (clear)
+                action = '清空并输入文本';
+            if (append)
+                action = '追加文本';
+            response.appendResponseLine(`${action}成功`);
+            response.appendResponseLine(`UID: ${uid}`);
+            response.appendResponseLine(`内容: ${text}`);
+            // 输入后页面可能发生变化
+            response.setIncludeSnapshot(true);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            response.appendResponseLine(`输入文本失败: ${errorMessage}`);
+            throw error;
+        }
+    },
+});
+/**
+ * 获取元素值
+ */
+export const getValueTool = defineTool({
+    name: 'get_value',
+    description: '获取元素的值或文本内容',
+    schema: z.object({
+        uid: z.string().describe('页面快照中元素的唯一标识符'),
+        attribute: z.string().optional().describe('要获取的属性名，不指定则获取value或text'),
+    }),
+    annotations: {
+        audience: ['developers'],
+    },
+    handler: async (request, response, context) => {
+        const { uid, attribute } = request.params;
+        if (!context.currentPage) {
+            throw new Error('请先获取当前页面');
+        }
+        try {
+            const options = { uid, attribute };
+            const value = await getElementValue(context.currentPage, context.elementMap, options);
+            response.appendResponseLine(`获取元素值成功`);
+            response.appendResponseLine(`UID: ${uid}`);
+            if (attribute) {
+                response.appendResponseLine(`属性: ${attribute}`);
+            }
+            response.appendResponseLine(`值: ${value}`);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            response.appendResponseLine(`获取元素值失败: ${errorMessage}`);
+            throw error;
+        }
+    },
+});
+/**
+ * 设置表单控件值
+ */
+export const setFormControlTool = defineTool({
+    name: 'set_form_control',
+    description: '设置表单控件的值（如picker、switch、slider等）',
+    schema: z.object({
+        uid: z.string().describe('页面快照中元素的唯一标识符'),
+        value: z.any().describe('要设置的值'),
+        trigger: z.string().optional().default('change').describe('触发的事件类型，默认为change'),
+    }),
+    annotations: {
+        audience: ['developers'],
+    },
+    handler: async (request, response, context) => {
+        const { uid, value, trigger } = request.params;
+        if (!context.currentPage) {
+            throw new Error('请先获取当前页面');
+        }
+        try {
+            const options = { uid, value, trigger };
+            await setFormControl(context.currentPage, context.elementMap, options);
+            response.appendResponseLine(`设置表单控件成功`);
+            response.appendResponseLine(`UID: ${uid}`);
+            response.appendResponseLine(`值: ${JSON.stringify(value)}`);
+            response.appendResponseLine(`事件: ${trigger}`);
+            // 设置后页面可能发生变化
+            response.setIncludeSnapshot(true);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            response.appendResponseLine(`设置表单控件失败: ${errorMessage}`);
+            throw error;
+        }
+    },
+});
+/**
+ * 选择器选择选项（picker专用）
+ */
+export const selectPickerTool = defineTool({
+    name: 'select_picker',
+    description: '选择picker控件的选项',
+    schema: z.object({
+        uid: z.string().describe('picker元素的唯一标识符'),
+        value: z.union([z.number(), z.string(), z.array(z.any())]).describe('选项值，可以是索引、文本或多选数组'),
+    }),
+    annotations: {
+        audience: ['developers'],
+    },
+    handler: async (request, response, context) => {
+        const { uid, value } = request.params;
+        if (!context.currentPage) {
+            throw new Error('请先获取当前页面');
+        }
+        try {
+            const options = { uid, value, trigger: 'change' };
+            await setFormControl(context.currentPage, context.elementMap, options);
+            response.appendResponseLine(`选择picker选项成功`);
+            response.appendResponseLine(`UID: ${uid}`);
+            response.appendResponseLine(`选项: ${JSON.stringify(value)}`);
+            // 选择后页面可能发生变化
+            response.setIncludeSnapshot(true);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            response.appendResponseLine(`选择picker选项失败: ${errorMessage}`);
+            throw error;
+        }
+    },
+});
+/**
+ * 切换开关状态（switch专用）
+ */
+export const toggleSwitchTool = defineTool({
+    name: 'toggle_switch',
+    description: '切换switch开关的状态',
+    schema: z.object({
+        uid: z.string().describe('switch元素的唯一标识符'),
+        checked: z.boolean().describe('开关状态，true为开启，false为关闭'),
+    }),
+    annotations: {
+        audience: ['developers'],
+    },
+    handler: async (request, response, context) => {
+        const { uid, checked } = request.params;
+        if (!context.currentPage) {
+            throw new Error('请先获取当前页面');
+        }
+        try {
+            const options = { uid, value: checked, trigger: 'change' };
+            await setFormControl(context.currentPage, context.elementMap, options);
+            response.appendResponseLine(`切换开关状态成功`);
+            response.appendResponseLine(`UID: ${uid}`);
+            response.appendResponseLine(`状态: ${checked ? '开启' : '关闭'}`);
+            // 切换后页面可能发生变化
+            response.setIncludeSnapshot(true);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            response.appendResponseLine(`切换开关状态失败: ${errorMessage}`);
+            throw error;
+        }
+    },
+});
+/**
+ * 设置滑块值（slider专用）
+ */
+export const setSliderTool = defineTool({
+    name: 'set_slider',
+    description: '设置slider滑块的值',
+    schema: z.object({
+        uid: z.string().describe('slider元素的唯一标识符'),
+        value: z.number().describe('滑块值'),
+    }),
+    annotations: {
+        audience: ['developers'],
+    },
+    handler: async (request, response, context) => {
+        const { uid, value } = request.params;
+        if (!context.currentPage) {
+            throw new Error('请先获取当前页面');
+        }
+        try {
+            const options = { uid, value, trigger: 'change' };
+            await setFormControl(context.currentPage, context.elementMap, options);
+            response.appendResponseLine(`设置滑块值成功`);
+            response.appendResponseLine(`UID: ${uid}`);
+            response.appendResponseLine(`值: ${value}`);
+            // 设置后页面可能发生变化
+            response.setIncludeSnapshot(true);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            response.appendResponseLine(`设置滑块值失败: ${errorMessage}`);
+            throw error;
+        }
+    },
+});

package/build/tools/navigate.js

@@ -0,0 +1,310 @@
+/**
+ * 页面导航工具
+ * 提供小程序页面跳转、返回、Tab切换等导航功能
+ */
+import { z } from 'zod';
+import { defineTool } from './ToolDefinition.js';
+import { navigateToPage, navigateBack, switchTab, getCurrentPageInfo, reLaunch } from '../tools.js';
+/**
+ * 跳转到指定页面
+ */
+export const navigateToTool = defineTool({
+    name: 'navigate_to',
+    description: '跳转到指定页面',
+    schema: z.object({
+        url: z.string().describe('目标页面路径'),
+        params: z.record(z.string(), z.any()).optional().describe('页面参数（查询参数）'),
+        waitForLoad: z.boolean().optional().default(true).describe('是否等待页面加载完成，默认true'),
+        timeout: z.number().optional().default(10000).describe('等待超时时间(毫秒)，默认10000ms'),
+    }),
+    annotations: {
+        audience: ['developers'],
+    },
+    handler: async (request, response, context) => {
+        const { url, params, waitForLoad, timeout } = request.params;
+        if (!context.miniProgram) {
+            throw new Error('请先连接到微信开发者工具');
+        }
+        try {
+            const options = {
+                url,
+                params,
+                waitForLoad,
+                timeout
+            };
+            await navigateToPage(context.miniProgram, options);
+            response.appendResponseLine(`页面跳转成功`);
+            response.appendResponseLine(`目标页面: ${url}`);
+            if (params && Object.keys(params).length > 0) {
+                response.appendResponseLine(`参数: ${JSON.stringify(params)}`);
+            }
+            // 页面跳转后，更新当前页面信息
+            try {
+                context.currentPage = await context.miniProgram.currentPage();
+                response.appendResponseLine(`当前页面已更新`);
+            }
+            catch (error) {
+                response.appendResponseLine(`警告: 无法更新当前页面信息`);
+            }
+            // 页面跳转后建议获取新快照
+            response.setIncludeSnapshot(true);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            response.appendResponseLine(`页面跳转失败: ${errorMessage}`);
+            throw error;
+        }
+    },
+});
+/**
+ * 返回上一页或指定层数
+ */
+export const navigateBackTool = defineTool({
+    name: 'navigate_back',
+    description: '返回上一页或指定层数',
+    schema: z.object({
+        delta: z.number().optional().default(1).describe('返回层数，默认1'),
+        waitForLoad: z.boolean().optional().default(true).describe('是否等待页面加载完成，默认true'),
+        timeout: z.number().optional().default(5000).describe('等待超时时间(毫秒)，默认5000ms'),
+    }),
+    annotations: {
+        audience: ['developers'],
+    },
+    handler: async (request, response, context) => {
+        const { delta, waitForLoad, timeout } = request.params;
+        if (!context.miniProgram) {
+            throw new Error('请先连接到微信开发者工具');
+        }
+        try {
+            const options = {
+                delta,
+                waitForLoad,
+                timeout
+            };
+            await navigateBack(context.miniProgram, options);
+            response.appendResponseLine(`页面返回成功`);
+            response.appendResponseLine(`返回层数: ${delta}`);
+            // 页面返回后，更新当前页面信息
+            try {
+                context.currentPage = await context.miniProgram.currentPage();
+                response.appendResponseLine(`当前页面已更新`);
+            }
+            catch (error) {
+                response.appendResponseLine(`警告: 无法更新当前页面信息`);
+            }
+            // 页面返回后建议获取新快照
+            response.setIncludeSnapshot(true);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            response.appendResponseLine(`页面返回失败: ${errorMessage}`);
+            throw error;
+        }
+    },
+});
+/**
+ * 切换到指定Tab页
+ */
+export const switchTabTool = defineTool({
+    name: 'switch_tab',
+    description: '切换到指定Tab页',
+    schema: z.object({
+        url: z.string().describe('Tab页路径'),
+        waitForLoad: z.boolean().optional().default(true).describe('是否等待页面加载完成，默认true'),
+        timeout: z.number().optional().default(5000).describe('等待超时时间(毫秒)，默认5000ms'),
+    }),
+    annotations: {
+        audience: ['developers'],
+    },
+    handler: async (request, response, context) => {
+        const { url, waitForLoad, timeout } = request.params;
+        if (!context.miniProgram) {
+            throw new Error('请先连接到微信开发者工具');
+        }
+        try {
+            const options = {
+                url,
+                waitForLoad,
+                timeout
+            };
+            await switchTab(context.miniProgram, options);
+            response.appendResponseLine(`Tab切换成功`);
+            response.appendResponseLine(`目标Tab: ${url}`);
+            // Tab切换后，更新当前页面信息
+            try {
+                context.currentPage = await context.miniProgram.currentPage();
+                response.appendResponseLine(`当前页面已更新`);
+            }
+            catch (error) {
+                response.appendResponseLine(`警告: 无法更新当前页面信息`);
+            }
+            // Tab切换后建议获取新快照
+            response.setIncludeSnapshot(true);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            response.appendResponseLine(`Tab切换失败: ${errorMessage}`);
+            throw error;
+        }
+    },
+});
+/**
+ * 重新启动到指定页面
+ */
+export const reLaunchTool = defineTool({
+    name: 'relaunch',
+    description: '重新启动小程序并跳转到指定页面',
+    schema: z.object({
+        url: z.string().describe('目标页面路径'),
+        params: z.record(z.string(), z.any()).optional().describe('页面参数（查询参数）'),
+        waitForLoad: z.boolean().optional().default(true).describe('是否等待页面加载完成，默认true'),
+        timeout: z.number().optional().default(10000).describe('等待超时时间(毫秒)，默认10000ms'),
+    }),
+    annotations: {
+        audience: ['developers'],
+    },
+    handler: async (request, response, context) => {
+        const { url, params, waitForLoad, timeout } = request.params;
+        if (!context.miniProgram) {
+            throw new Error('请先连接到微信开发者工具');
+        }
+        try {
+            const options = {
+                url,
+                params,
+                waitForLoad,
+                timeout
+            };
+            await reLaunch(context.miniProgram, options);
+            response.appendResponseLine(`重新启动成功`);
+            response.appendResponseLine(`目标页面: ${url}`);
+            if (params && Object.keys(params).length > 0) {
+                response.appendResponseLine(`参数: ${JSON.stringify(params)}`);
+            }
+            // 重新启动后，更新当前页面信息
+            try {
+                context.currentPage = await context.miniProgram.currentPage();
+                response.appendResponseLine(`当前页面已更新`);
+            }
+            catch (error) {
+                response.appendResponseLine(`警告: 无法更新当前页面信息`);
+            }
+            // 重新启动后建议获取新快照
+            response.setIncludeSnapshot(true);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            response.appendResponseLine(`重新启动失败: ${errorMessage}`);
+            throw error;
+        }
+    },
+});
+/**
+ * 获取当前页面信息
+ */
+export const getPageInfoTool = defineTool({
+    name: 'get_page_info',
+    description: '获取当前页面的详细信息',
+    schema: z.object({}),
+    annotations: {
+        audience: ['developers'],
+    },
+    handler: async (request, response, context) => {
+        if (!context.miniProgram) {
+            throw new Error('请先连接到微信开发者工具');
+        }
+        try {
+            const pageInfo = await getCurrentPageInfo(context.miniProgram);
+            response.appendResponseLine(`页面信息获取成功`);
+            response.appendResponseLine(`路径: ${pageInfo.path}`);
+            if (pageInfo.title) {
+                response.appendResponseLine(`标题: ${pageInfo.title}`);
+            }
+            if (pageInfo.query && Object.keys(pageInfo.query).length > 0) {
+                response.appendResponseLine(`查询参数: ${JSON.stringify(pageInfo.query)}`);
+            }
+            response.appendResponseLine('');
+            response.appendResponseLine('完整信息:');
+            response.appendResponseLine(JSON.stringify(pageInfo, null, 2));
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            response.appendResponseLine(`获取页面信息失败: ${errorMessage}`);
+            throw error;
+        }
+    },
+});
+/**
+ * 重定向到指定页面（替换当前页面）
+ */
+export const redirectToTool = defineTool({
+    name: 'redirect_to',
+    description: '重定向到指定页面（关闭当前页面并跳转）',
+    schema: z.object({
+        url: z.string().describe('目标页面路径'),
+        params: z.record(z.string(), z.any()).optional().describe('页面参数（查询参数）'),
+        waitForLoad: z.boolean().optional().default(true).describe('是否等待页面加载完成，默认true'),
+        timeout: z.number().optional().default(10000).describe('等待超时时间(毫秒)，默认10000ms'),
+    }),
+    annotations: {
+        audience: ['developers'],
+    },
+    handler: async (request, response, context) => {
+        const { url, params, waitForLoad, timeout } = request.params;
+        if (!context.miniProgram) {
+            throw new Error('请先连接到微信开发者工具');
+        }
+        try {
+            // 构建完整的URL
+            let fullUrl = url;
+            if (params && Object.keys(params).length > 0) {
+                const queryString = Object.entries(params)
+                    .map(([key, value]) => `${key}=${encodeURIComponent(String(value))}`)
+                    .join('&');
+                fullUrl += (url.includes('?') ? '&' : '?') + queryString;
+            }
+            // 执行重定向
+            await context.miniProgram.redirectTo(fullUrl);
+            // 等待页面加载完成
+            if (waitForLoad) {
+                const startTime = Date.now();
+                while (Date.now() - startTime < timeout) {
+                    try {
+                        const currentPage = await context.miniProgram.currentPage();
+                        if (currentPage) {
+                            const currentPath = await currentPage.path;
+                            // 检查是否已经重定向到目标页面
+                            if (currentPath.includes(url.split('?')[0])) {
+                                break;
+                            }
+                        }
+                    }
+                    catch (error) {
+                        // 继续等待
+                    }
+                    await new Promise(resolve => setTimeout(resolve, 100));
+                }
+            }
+            response.appendResponseLine(`页面重定向成功`);
+            response.appendResponseLine(`目标页面: ${url}`);
+            if (params && Object.keys(params).length > 0) {
+                response.appendResponseLine(`参数: ${JSON.stringify(params)}`);
+            }
+            // 重定向后，更新当前页面信息
+            try {
+                context.currentPage = await context.miniProgram.currentPage();
+                response.appendResponseLine(`当前页面已更新`);
+            }
+            catch (error) {
+                response.appendResponseLine(`警告: 无法更新当前页面信息`);
+            }
+            // 重定向后建议获取新快照
+            response.setIncludeSnapshot(true);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            response.appendResponseLine(`页面重定向失败: ${errorMessage}`);
+            throw error;
+        }
+    },
+});