weapp-ide-cli 5.2.11 → 5.3.1

package/dist/run-mcp-TnooVQe8.js

@@ -0,0 +1,434 @@
+import { o as withMiniProgram$1 } from "./automator-session-BZzODsJi.js";
+import { Buffer } from "node:buffer";
+import fs from "node:fs/promises";
+import path from "node:path";
+import process from "node:process";
+import { readDevtoolsElementSnapshot as readElementSnapshot, resolveDevtoolsProjectPath as resolveProjectPath, toDevtoolsSerializableValue as toSerializableValue } from "@weapp-vite/devtools-runtime";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+//#region src/mcp/server.ts
+function createResolvedProjectPath(workspaceRoot, projectPath) {
+	return path.isAbsolute(projectPath) ? path.normalize(projectPath) : path.resolve(workspaceRoot ?? process.cwd(), projectPath);
+}
+function createResolvedOutputPath(workspaceRoot, outputPath) {
+	return path.isAbsolute(outputPath) ? path.normalize(outputPath) : path.resolve(workspaceRoot ?? process.cwd(), outputPath);
+}
+async function withConnectedMiniProgram(runtimeHooks, workspaceRoot, input, runner) {
+	return await runtimeHooks.withMiniProgram({
+		preferOpenedSession: input.preferOpenedSession,
+		projectPath: createResolvedProjectPath(workspaceRoot, input.projectPath),
+		sharedSession: true,
+		timeout: input.timeout
+	}, runner);
+}
+async function withConnectedPage(runtimeHooks, workspaceRoot, input, runner) {
+	return await withConnectedMiniProgram(runtimeHooks, workspaceRoot, input, async (miniProgram) => {
+		return await runner(await miniProgram.currentPage(), miniProgram);
+	});
+}
+function defineConnectionSchema() {
+	return {
+		projectPath: z.string().trim().min(1).describe("小程序项目路径，支持 workspaceRoot 相对路径"),
+		timeout: z.number().int().positive().optional(),
+		preferOpenedSession: z.boolean().optional()
+	};
+}
+function defineElementSchema() {
+	return {
+		...defineConnectionSchema(),
+		selector: z.string().trim().min(1)
+	};
+}
+function definePageSchema() {
+	return {
+		...defineConnectionSchema(),
+		withData: z.boolean().optional()
+	};
+}
+function registerWeappIdeMcpTools(server, options) {
+	const workspaceRoot = options.workspaceRoot;
+	server.registerTool("weapp_devtools_connect", {
+		title: "Connect DevTools",
+		description: "连接当前项目的微信开发者工具并返回页面信息。",
+		inputSchema: defineConnectionSchema()
+	}, async (input) => {
+		try {
+			const result = await withConnectedMiniProgram(options.runtimeHooks, workspaceRoot, input, async (miniProgram) => {
+				const page = await miniProgram.currentPage().catch(() => null);
+				const systemInfo = await miniProgram.systemInfo().catch(() => null);
+				return {
+					connected: true,
+					currentPage: page ? {
+						path: page.path,
+						query: toSerializableValue(page.query)
+					} : null,
+					projectPath: input.projectPath,
+					systemInfo: toSerializableValue(systemInfo)
+				};
+			});
+			return {
+				content: [{
+					type: "text",
+					text: JSON.stringify(result, null, 2)
+				}],
+				structuredContent: { result }
+			};
+		} catch (error) {
+			return {
+				isError: true,
+				content: [{
+					type: "text",
+					text: error instanceof Error ? error.message : String(error)
+				}]
+			};
+		}
+	});
+	server.registerTool("weapp_devtools_active_page", {
+		title: "Current Page",
+		description: "读取当前页面路径、query、尺寸、滚动位置和页面 data。",
+		inputSchema: definePageSchema()
+	}, async (input) => {
+		try {
+			const result = await withConnectedPage(options.runtimeHooks, workspaceRoot, input, async (page) => {
+				const [size, scrollTop, data] = await Promise.all([
+					page.size().catch(() => null),
+					page.scrollTop().catch(() => null),
+					input.withData ? page.data().catch(() => null) : Promise.resolve(void 0)
+				]);
+				return {
+					data: toSerializableValue(data),
+					path: page.path,
+					query: toSerializableValue(page.query),
+					scrollTop: toSerializableValue(scrollTop),
+					size: toSerializableValue(size)
+				};
+			});
+			return {
+				content: [{
+					type: "text",
+					text: JSON.stringify(result, null, 2)
+				}],
+				structuredContent: { result }
+			};
+		} catch (error) {
+			return {
+				isError: true,
+				content: [{
+					type: "text",
+					text: error instanceof Error ? error.message : String(error)
+				}]
+			};
+		}
+	});
+	server.registerTool("weapp_devtools_page_stack", {
+		title: "Page Stack",
+		description: "读取当前小程序页面栈。",
+		inputSchema: defineConnectionSchema()
+	}, async (input) => {
+		try {
+			const result = await withConnectedMiniProgram(options.runtimeHooks, workspaceRoot, input, async (miniProgram) => {
+				return (await miniProgram.pageStack()).map((page) => ({
+					path: page.path,
+					query: toSerializableValue(page.query)
+				}));
+			});
+			return {
+				content: [{
+					type: "text",
+					text: JSON.stringify(result, null, 2)
+				}],
+				structuredContent: { result }
+			};
+		} catch (error) {
+			return {
+				isError: true,
+				content: [{
+					type: "text",
+					text: error instanceof Error ? error.message : String(error)
+				}]
+			};
+		}
+	});
+	server.registerTool("weapp_runtime_find_node", {
+		title: "Find Node",
+		description: "通过 selector 查找单个节点，并返回节点快照。",
+		inputSchema: {
+			...defineElementSchema(),
+			attributes: z.array(z.string().trim().min(1)).optional(),
+			styles: z.array(z.string().trim().min(1)).optional()
+		}
+	}, async (input) => {
+		try {
+			const result = await withConnectedPage(options.runtimeHooks, workspaceRoot, input, async (page) => {
+				const element = await page.$(input.selector);
+				if (!element) throw new Error(`Element not found: ${input.selector}`);
+				return await readElementSnapshot(element, input.selector, input.attributes ?? [], input.styles ?? []);
+			});
+			return {
+				content: [{
+					type: "text",
+					text: JSON.stringify(result, null, 2)
+				}],
+				structuredContent: { result }
+			};
+		} catch (error) {
+			return {
+				isError: true,
+				content: [{
+					type: "text",
+					text: error instanceof Error ? error.message : String(error)
+				}]
+			};
+		}
+	});
+	server.registerTool("weapp_runtime_find_nodes", {
+		title: "Find Nodes",
+		description: "通过 selector 查找多个节点，并返回节点快照列表。",
+		inputSchema: {
+			...defineElementSchema(),
+			limit: z.number().int().positive().max(100).optional()
+		}
+	}, async (input) => {
+		try {
+			const result = await withConnectedPage(options.runtimeHooks, workspaceRoot, input, async (page) => {
+				const elements = await page.$$(input.selector);
+				const limited = elements.slice(0, input.limit ?? elements.length);
+				return await Promise.all(limited.map(async (element) => await readElementSnapshot(element, input.selector)));
+			});
+			return {
+				content: [{
+					type: "text",
+					text: JSON.stringify(result, null, 2)
+				}],
+				structuredContent: { result }
+			};
+		} catch (error) {
+			return {
+				isError: true,
+				content: [{
+					type: "text",
+					text: error instanceof Error ? error.message : String(error)
+				}]
+			};
+		}
+	});
+	server.registerTool("weapp_runtime_tap_node", {
+		title: "Tap Node",
+		description: "点击指定节点。",
+		inputSchema: defineElementSchema()
+	}, async (input) => {
+		try {
+			const result = await withConnectedPage(options.runtimeHooks, workspaceRoot, input, async (page) => {
+				const element = await page.$(input.selector);
+				if (!element) throw new Error(`Element not found: ${input.selector}`);
+				await element.tap();
+				return {
+					tapped: true,
+					selector: input.selector
+				};
+			});
+			return {
+				content: [{
+					type: "text",
+					text: JSON.stringify(result, null, 2)
+				}],
+				structuredContent: { result }
+			};
+		} catch (error) {
+			return {
+				isError: true,
+				content: [{
+					type: "text",
+					text: error instanceof Error ? error.message : String(error)
+				}]
+			};
+		}
+	});
+	server.registerTool("weapp_runtime_input_node", {
+		title: "Input Node",
+		description: "向指定节点输入文本。",
+		inputSchema: {
+			...defineElementSchema(),
+			value: z.string()
+		}
+	}, async (input) => {
+		try {
+			const result = await withConnectedPage(options.runtimeHooks, workspaceRoot, input, async (page) => {
+				const element = await page.$(input.selector);
+				if (!element) throw new Error(`Element not found: ${input.selector}`);
+				const candidate = element;
+				if (typeof candidate.input !== "function") throw new TypeError(`Element does not support input: ${input.selector}`);
+				await candidate.input(input.value);
+				return {
+					selector: input.selector,
+					value: input.value,
+					updated: true
+				};
+			});
+			return {
+				content: [{
+					type: "text",
+					text: JSON.stringify(result, null, 2)
+				}],
+				structuredContent: { result }
+			};
+		} catch (error) {
+			return {
+				isError: true,
+				content: [{
+					type: "text",
+					text: error instanceof Error ? error.message : String(error)
+				}]
+			};
+		}
+	});
+	server.registerTool("weapp_devtools_capture", {
+		title: "Capture Screenshot",
+		description: "截取当前小程序视口并返回 base64，支持保存到文件。",
+		inputSchema: {
+			...defineConnectionSchema(),
+			outputPath: z.string().trim().min(1).optional()
+		}
+	}, async (input) => {
+		try {
+			const result = await withConnectedMiniProgram(options.runtimeHooks, workspaceRoot, input, async (miniProgram) => {
+				const screenshot = await miniProgram.screenshot();
+				const base64 = typeof screenshot === "string" ? screenshot : Buffer.from(screenshot).toString("base64");
+				const buffer = Buffer.from(base64, "base64");
+				if (input.outputPath) {
+					const resolvedOutputPath = createResolvedOutputPath(workspaceRoot, input.outputPath);
+					await fs.mkdir(path.dirname(resolvedOutputPath), { recursive: true });
+					await fs.writeFile(resolvedOutputPath, buffer);
+					return {
+						bytes: buffer.byteLength,
+						path: resolvedOutputPath
+					};
+				}
+				return {
+					base64,
+					bytes: buffer.byteLength
+				};
+			});
+			return {
+				content: [{
+					type: "text",
+					text: JSON.stringify(result, null, 2)
+				}],
+				structuredContent: { result }
+			};
+		} catch (error) {
+			return {
+				isError: true,
+				content: [{
+					type: "text",
+					text: error instanceof Error ? error.message : String(error)
+				}]
+			};
+		}
+	});
+	server.registerTool("weapp_devtools_host_api", {
+		title: "Call wx Method",
+		description: "调用小程序 wx API。",
+		inputSchema: {
+			...defineConnectionSchema(),
+			method: z.string().trim().min(1),
+			args: z.array(z.unknown()).optional()
+		}
+	}, async (input) => {
+		try {
+			const result = await withConnectedMiniProgram(options.runtimeHooks, workspaceRoot, input, async (miniProgram) => {
+				return {
+					args: toSerializableValue(input.args ?? []),
+					method: input.method,
+					result: toSerializableValue(await miniProgram.callWxMethod(input.method, ...input.args ?? []))
+				};
+			});
+			return {
+				content: [{
+					type: "text",
+					text: JSON.stringify(result, null, 2)
+				}],
+				structuredContent: { result }
+			};
+		} catch (error) {
+			return {
+				isError: true,
+				content: [{
+					type: "text",
+					text: error instanceof Error ? error.message : String(error)
+				}]
+			};
+		}
+	});
+}
+async function createWeappIdeMcpServer(options) {
+	const server = new McpServer({
+		name: "weapp-ide-cli",
+		version: "1.0.0"
+	});
+	registerWeappIdeMcpTools(server, options);
+	return {
+		close: async () => void 0,
+		server
+	};
+}
+//#endregion
+//#region src/mcp/runtime.ts
+async function startWeappIdeMcpServer(options = {}) {
+	const { server } = await createWeappIdeMcpServer({
+		runtimeHooks: { withMiniProgram: withMiniProgram$1 },
+		workspaceRoot: options.workspaceRoot
+	});
+	const transport = new StdioServerTransport();
+	await server.connect(transport);
+	return { close: async () => {
+		await transport.close();
+	} };
+}
+//#endregion
+//#region src/cli/run-mcp.ts
+function readOptionValue(argv, optionName) {
+	const optionWithEqual = `${optionName}=`;
+	for (let index = 0; index < argv.length; index += 1) {
+		const token = argv[index];
+		if (!token) continue;
+		if (token === optionName) {
+			const value = argv[index + 1];
+			return typeof value === "string" ? value : void 0;
+		}
+		if (token.startsWith(optionWithEqual)) return token.slice(optionWithEqual.length);
+	}
+}
+function shouldPrintHelp(argv) {
+	return argv.includes("-h") || argv.includes("--help");
+}
+function printMcpHelp() {
+	process.stdout.write(`Usage: weapp mcp [options]
+
+Start the weapp-ide-cli MCP server over stdio.
+
+Options:
+  --workspace-root <path>  Resolve relative project/output paths from this root
+  -h, --help              Show this help
+
+AI client stdio config:
+{
+  "mcpServers": {
+    "weapp-ide-cli": {
+      "command": "weapp",
+      "args": ["mcp", "--workspace-root", "<repo-root>"]
+    }
+  }
+}
+`);
+}
+async function runMcpCommand(argv) {
+	if (shouldPrintHelp(argv)) {
+		printMcpHelp();
+		return;
+	}
+	await startWeappIdeMcpServer({ workspaceRoot: readOptionValue(argv, "--workspace-root") });
+}
+//#endregion
+export { readElementSnapshot as a, registerWeappIdeMcpTools as i, startWeappIdeMcpServer as n, resolveProjectPath as o, createWeappIdeMcpServer as r, toSerializableValue as s, runMcpCommand as t };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "weapp-ide-cli",
   "type": "module",
-  "version": "5.2.11",
+  "version": "5.3.1",
   "description": "让微信开发者工具，用起来更加方便！",
   "author": "ice breaker <1324318532@qq.com>",
   "license": "MIT",
@@ -62,15 +62,17 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "cac": "^7.0.0",
     "execa": "9.6.1",
     "pathe": "^2.0.3",
     "pixelmatch": "^7.2.0",
     "pngjs": "^7.0.0",
+    "zod": "^4.4.3",
     "@weapp-core/logger": "3.1.1",
     "@weapp-core/shared": "3.0.4",
-    "@weapp-vite/devtools-runtime": "0.2.3",
-    "@weapp-vite/miniprogram-automator": "1.1.1"
+    "@weapp-vite/devtools-runtime": "0.3.1",
+    "@weapp-vite/miniprogram-automator": "1.1.2"
   },
   "scripts": {
     "dev": "tsdown -w --sourcemap",

package/dist/commands-DAN1Yl85.js

@@ -1,2 +0,0 @@
-import { h as takeScreenshot } from "./commands-5QkUqOoO.js";
-export { takeScreenshot };