weapp-ide-cli 5.1.5 → 5.2.1

package/README.md

@@ -130,6 +130,7 @@ weapp cache --clean all
 | 命令                             | 说明                           |
 | -------------------------------- | ------------------------------ |
 | `weapp screenshot`               | 截图（支持 base64 / 文件输出） |
+| `weapp compare`                  | 截图对比（pixelmatch）         |
 | `weapp navigate <url>`           | 保留栈跳转页面                 |
 | `weapp redirect <url>`           | 重定向页面                     |
 | `weapp back`                     | 页面返回                       |

package/dist/{cli-BZKq6t2k.js → cli-DKrUhSmB.js}

@@ -1,6 +1,9 @@
-import { A as createLocaleConfig, B as operatingSystemName, E as resolveCliPath, F as defaultCustomConfigFilePath, H as logger_default, I as resolvePath, M as readCustomConfig, N as removeCustomConfigKey, O as getConfiguredLocale, V as colors, _ as connectMiniProgram, a as navigateBack, b as i18nText, c as pageStack, d as remote, f as scrollTo, g as tap, i as input, j as overwriteCustomConfig, k as createCustomConfig, l as reLaunch, m as systemInfo, o as navigateTo, p as switchTab, r as currentPage, s as pageData, t as audit, u as redirectTo, x as validateLocaleOption, y as configureLocaleFromArgv, z as isOperatingSystemSupported } from "./commands-CSbpftLN.js";
-import fs from "fs-extra";
+import { B as createLocaleConfig, C as configureLocaleFromArgv, G as defaultCustomConfigFilePath, H as readCustomConfig, I as resolveCliPath, K as resolvePath, Q as logger_default, R as getConfiguredLocale, T as validateLocaleOption, U as removeCustomConfigKey, V as overwriteCustomConfig, X as operatingSystemName, Y as isOperatingSystemSupported, Z as colors, a as navigateBack, c as pageStack, d as remote, f as scrollTo, g as tap, i as input, l as reLaunch, m as systemInfo, n as captureScreenshotBuffer, o as navigateTo, p as switchTab, r as currentPage, s as pageData, t as audit, u as redirectTo, w as i18nText, y as connectMiniProgram, z as createCustomConfig } from "./commands--vppy2pX.js";
+import fs from "node:fs/promises";
+import { fs as fs$1 } from "@weapp-core/shared";
 import process, { stdin, stdout } from "node:process";
+import { PNG } from "pngjs";
+import pixelmatch from "pixelmatch";
 import { createInterface } from "node:readline/promises";
 import { inspect } from "node:util";
 import { emitKeypressEvents } from "node:readline";
@@ -105,6 +108,211 @@ function takesValue(optionName) {
 	return optionName === "-p" || optionName === "--project" || optionName === "-t" || optionName === "--timeout" || optionName === "-o" || optionName === "--output" || optionName === "--page" || optionName === "--login-retry" || optionName === "--login-retry-timeout" || optionName === "--lang" || optionName === "--platform" || optionName === "--qr-output" || optionName === "-r" || optionName === "--result-output" || optionName === "--info-output" || optionName === "-i";
 }
 //#endregion
+//#region src/cli/imageDiff.ts
+function readPng(buffer, label) {
+	try {
+		return PNG.sync.read(buffer);
+	} catch (error) {
+		throw new Error(i18nText(`${label} 不是有效的 PNG 文件`, `${label} is not a valid PNG file`), { cause: error });
+	}
+}
+/**
+* @description 将当前截图与基准图做像素对比，并按需输出当前图与 diff 图。
+*/
+async function comparePngWithBaseline(options) {
+	let baselineBuffer;
+	try {
+		baselineBuffer = await fs.readFile(options.baselinePath);
+	} catch (error) {
+		throw new Error(i18nText(`无法读取基准图: ${options.baselinePath}`, `Failed to read baseline image: ${options.baselinePath}`), { cause: error });
+	}
+	const baselinePng = readPng(baselineBuffer, i18nText("基准图", "Baseline image"));
+	const currentPng = readPng(options.currentPngBuffer, i18nText("当前截图", "Current screenshot"));
+	if (baselinePng.width !== currentPng.width || baselinePng.height !== currentPng.height) throw new Error(i18nText("基准图与当前截图尺寸不一致", "Baseline image size does not match current screenshot"));
+	if (options.currentOutputPath) await fs.writeFile(options.currentOutputPath, options.currentPngBuffer);
+	const diffPng = new PNG({
+		width: currentPng.width,
+		height: currentPng.height
+	});
+	const diffPixels = pixelmatch(baselinePng.data, currentPng.data, diffPng.data, currentPng.width, currentPng.height, { threshold: options.threshold });
+	if (options.diffOutputPath) await fs.writeFile(options.diffOutputPath, PNG.sync.write(diffPng));
+	return {
+		baselinePath: options.baselinePath,
+		currentPath: options.currentOutputPath,
+		diffPath: options.diffOutputPath,
+		width: currentPng.width,
+		height: currentPng.height,
+		diffPixels,
+		diffRatio: diffPixels / (currentPng.width * currentPng.height)
+	};
+}
+//#endregion
+//#region src/cli/compare.ts
+function createCliError(message, exitCode, cause) {
+	const error = new Error(message, cause ? { cause } : void 0);
+	error.exitCode = exitCode;
+	return error;
+}
+function parseNonNegativeInteger(rawValue, optionName) {
+	if (rawValue == null) return;
+	const value = Number(rawValue);
+	if (!Number.isInteger(value) || value < 0) throw createCliError(i18nText(`${optionName} 必须是大于等于 0 的整数`, `${optionName} must be an integer greater than or equal to 0`), 2);
+	return value;
+}
+function parseRatio(rawValue, optionName) {
+	if (rawValue == null) return;
+	const value = Number(rawValue);
+	if (!Number.isFinite(value) || value < 0 || value > 1) throw createCliError(i18nText(`${optionName} 必须是 0 到 1 之间的数字`, `${optionName} must be a number between 0 and 1`), 2);
+	return value;
+}
+/**
+* @description 输出 compare 命令帮助信息。
+*/
+function printCompareHelp() {
+	console.log(i18nText(`
+${colors.bold("Usage:")} weapp compare [options]
+
+${colors.bold("参数:")}
+  -p, --project <path>           项目路径（默认：当前目录）
+      --baseline <path>          基准图路径（必填）
+      --current-output <path>    当前截图输出路径
+      --diff-output <path>       diff 图片输出路径
+      --page <path>              对比前先跳转页面
+      --full-page                对比时使用整页长截图
+      --threshold <number>       pixelmatch threshold（默认：0.1）
+      --max-diff-pixels <count>  最大允许差异像素数
+      --max-diff-ratio <number>  最大允许差异占比（0-1）
+  -t, --timeout <ms>             连接超时时间（默认：30000）
+      --json                     以 JSON 格式输出
+      --lang <lang>              语言切换：zh | en（默认：zh）
+  -h, --help                     显示此帮助信息
+
+${colors.bold("规则:")}
+  - 必须提供 --baseline
+  - 必须至少提供 --max-diff-pixels 或 --max-diff-ratio 之一
+  - baseline 与当前截图尺寸不一致时直接失败
+
+${colors.bold("示例:")}
+  weapp compare -p ./dist/build/mp-weixin --page pages/index/index --full-page --baseline .screenshots/baseline/index.full.png --current-output .screenshots/current/index.full.png --diff-output .screenshots/diff/index.full.diff.png --max-diff-pixels 100 --json
+
+  weapp compare -p ./dist/build/mp-weixin --page pages/index/index --baseline .screenshots/baseline/index.png --current-output .screenshots/current/index.png --diff-output .screenshots/diff/index.diff.png --max-diff-pixels 100 --json
+
+  weapp compare -p ./dist/build/mp-weixin --baseline .screenshots/baseline/index.png --max-diff-ratio 0.001
+`, `
+${colors.bold("Usage:")} weapp compare [options]
+
+${colors.bold("Options:")}
+  -p, --project <path>           Project path (default: current directory)
+      --baseline <path>          Baseline image path (required)
+      --current-output <path>    Output file path for current screenshot
+      --diff-output <path>       Output file path for diff image
+      --page <path>              Navigate to page before comparison
+      --full-page                Use stitched full-page screenshots for comparison
+      --threshold <number>       Pixelmatch threshold (default: 0.1)
+      --max-diff-pixels <count>  Maximum allowed diff pixels
+      --max-diff-ratio <number>  Maximum allowed diff ratio (0-1)
+  -t, --timeout <ms>             Connection timeout in milliseconds (default: 30000)
+      --json                     Output as JSON format
+      --lang <lang>              Language: zh | en (default: zh)
+  -h, --help                     Show this help message
+
+${colors.bold("Rules:")}
+  - --baseline is required
+  - At least one of --max-diff-pixels or --max-diff-ratio is required
+  - Baseline and current screenshot must have identical dimensions
+
+${colors.bold("Examples:")}
+  weapp compare -p ./dist/build/mp-weixin --page pages/index/index --full-page --baseline .screenshots/baseline/index.full.png --current-output .screenshots/current/index.full.png --diff-output .screenshots/diff/index.full.diff.png --max-diff-pixels 100 --json
+
+  weapp compare -p ./dist/build/mp-weixin --page pages/index/index --baseline .screenshots/baseline/index.png --current-output .screenshots/current/index.png --diff-output .screenshots/diff/index.diff.png --max-diff-pixels 100 --json
+
+  weapp compare -p ./dist/build/mp-weixin --baseline .screenshots/baseline/index.png --max-diff-ratio 0.001
+`));
+}
+/**
+* @description 解析 compare 命令参数。
+*/
+function parseCompareArgs(argv) {
+	const parsed = parseAutomatorArgs(argv);
+	const baselinePath = readOptionValue(argv, "--baseline");
+	if (!baselinePath) throw createCliError(i18nText("compare 命令缺少 --baseline 参数", "Missing --baseline option for compare command"), 2);
+	const threshold = parseRatio(readOptionValue(argv, "--threshold"), "--threshold") ?? .1;
+	const maxDiffPixels = parseNonNegativeInteger(readOptionValue(argv, "--max-diff-pixels"), "--max-diff-pixels");
+	const maxDiffRatio = parseRatio(readOptionValue(argv, "--max-diff-ratio"), "--max-diff-ratio");
+	if (maxDiffPixels == null && maxDiffRatio == null) throw createCliError(i18nText("compare 命令至少需要提供 --max-diff-pixels 或 --max-diff-ratio 之一", "compare command requires at least one of --max-diff-pixels or --max-diff-ratio"), 2);
+	return {
+		projectPath: parsed.projectPath,
+		timeout: parsed.timeout,
+		page: readOptionValue(argv, "--page"),
+		fullPage: argv.includes("--full-page"),
+		baselinePath,
+		currentOutputPath: readOptionValue(argv, "--current-output"),
+		diffOutputPath: readOptionValue(argv, "--diff-output"),
+		threshold,
+		maxDiffPixels,
+		maxDiffRatio
+	};
+}
+function resolveComparePassed(diff, options) {
+	if (options.maxDiffPixels != null && diff.diffPixels > options.maxDiffPixels) return false;
+	if (options.maxDiffRatio != null && diff.diffRatio > options.maxDiffRatio) return false;
+	return true;
+}
+function printCompareSummary(result) {
+	const summary = result.passed ? i18nText(`compare passed: diffPixels=${result.diffPixels} diffRatio=${result.diffRatio}`, `compare passed: diffPixels=${result.diffPixels} diffRatio=${result.diffRatio}`) : i18nText(`compare failed: diffPixels=${result.diffPixels} diffRatio=${result.diffRatio}`, `compare failed: diffPixels=${result.diffPixels} diffRatio=${result.diffRatio}`);
+	console.log(summary);
+	const pathSummary = [
+		`baseline=${result.baselinePath}`,
+		result.currentPath ? `current=${result.currentPath}` : void 0,
+		result.diffPath ? `diff=${result.diffPath}` : void 0
+	].filter(Boolean).join(" ");
+	if (pathSummary) console.log(pathSummary);
+}
+/**
+* @description 运行 compare 命令并输出对比结果。
+*/
+async function runCompare(argv) {
+	if (argv.includes("-h") || argv.includes("--help")) {
+		printCompareHelp();
+		return;
+	}
+	const options = parseCompareArgs(argv);
+	let currentPngBuffer;
+	try {
+		currentPngBuffer = await captureScreenshotBuffer(options);
+	} catch (error) {
+		throw createCliError(error instanceof Error ? error.message : i18nText("截图失败", "Failed to capture screenshot"), 3, error);
+	}
+	let diff;
+	try {
+		diff = await comparePngWithBaseline({
+			baselinePath: options.baselinePath,
+			currentPngBuffer,
+			currentOutputPath: options.currentOutputPath,
+			diffOutputPath: options.diffOutputPath,
+			threshold: options.threshold
+		});
+	} catch (error) {
+		throw createCliError(error instanceof Error ? error.message : i18nText("截图对比失败", "Screenshot comparison failed"), 3, error);
+	}
+	const result = {
+		passed: resolveComparePassed(diff, options),
+		baselinePath: options.baselinePath,
+		currentPath: diff.currentPath,
+		diffPath: diff.diffPath,
+		width: diff.width,
+		height: diff.height,
+		diffPixels: diff.diffPixels,
+		diffRatio: diff.diffRatio,
+		threshold: options.threshold,
+		maxDiffPixels: options.maxDiffPixels,
+		maxDiffRatio: options.maxDiffRatio
+	};
+	if (argv.includes("--json")) console.log(JSON.stringify(result, null, 2));
+	else printCompareSummary(result);
+	if (!result.passed) process.exitCode = 1;
+}
+//#endregion
 //#region src/cli/screenshot.ts
 /**
 * @description Print help for screenshot command
@@ -117,6 +325,7 @@ ${colors.bold("参数:")}
   -p, --project <path>   项目路径（默认：当前目录）
   -o, --output <path>    截图输出文件路径
       --page <path>      截图前先跳转页面
+      --full-page        输出整页长截图
   -t, --timeout <ms>     连接超时时间（默认：30000）
       --json             以 JSON 格式输出
       --lang <lang>      语言切换：zh | en（默认：zh）
@@ -132,6 +341,9 @@ ${colors.bold("示例:")}
   # 先跳转页面再截图
   weapp screenshot -p /path/to/project --page pages/index/index
 
+  # 输出整页长截图
+  weapp screenshot -p /path/to/project --page pages/index/index --full-page -o full.png
+
   # 以 JSON 输出便于脚本解析
   weapp screenshot -p /path/to/project --json
 `, `
@@ -141,6 +353,7 @@ ${colors.bold("Options:")}
   -p, --project <path>   Project path (default: current directory)
   -o, --output <path>    Output file path for screenshot
       --page <path>      Navigate to page before taking screenshot
+      --full-page        Capture a stitched full-page screenshot
   -t, --timeout <ms>     Connection timeout in milliseconds (default: 30000)
       --json             Output as JSON format
       --lang <lang>      Language: zh | en (default: zh)
@@ -156,6 +369,9 @@ ${colors.bold("Examples:")}
   # Navigate to page first
   weapp screenshot -p /path/to/project --page pages/index/index
 
+  # Capture a stitched full-page screenshot
+  weapp screenshot -p /path/to/project --page pages/index/index --full-page -o full.png
+
   # JSON output for parsing
   weapp screenshot -p /path/to/project --json
 `));
@@ -165,11 +381,15 @@ ${colors.bold("Examples:")}
 */
 function parseScreenshotArgs(argv) {
 	const parsed = parseAutomatorArgs(argv);
+	const outputPath = readOptionValue(argv, "-o") || readOptionValue(argv, "--output");
+	const page = readOptionValue(argv, "--page");
+	const fullPage = argv.includes("--full-page");
 	return {
 		projectPath: parsed.projectPath,
-		timeout: parsed.timeout,
-		outputPath: readOptionValue(argv, "-o") || readOptionValue(argv, "--output"),
-		page: readOptionValue(argv, "--page")
+		...parsed.timeout ? { timeout: parsed.timeout } : {},
+		...outputPath ? { outputPath } : {},
+		...page ? { page } : {},
+		...fullPage ? { fullPage: true } : {}
 	};
 }
 /**
@@ -182,7 +402,7 @@ async function runScreenshot(argv) {
 	}
 	const options = parseScreenshotArgs(argv);
 	const isJsonOutput = argv.includes("--json");
-	const { takeScreenshot } = await import("./commands-CSbpftLN.js").then((n) => n.n);
+	const { takeScreenshot } = await import("./commands-Bg8hQbPE.js");
 	const result = await takeScreenshot(options);
 	if (isJsonOutput) {
 		console.log(JSON.stringify(result, null, 2));
@@ -461,7 +681,11 @@ const COMMAND_DEFINITIONS = {
 		}
 	})
 };
-const AUTOMATOR_COMMAND_NAMES = ["screenshot", ...Object.keys(COMMAND_DEFINITIONS)];
+const AUTOMATOR_COMMAND_NAMES = [
+	"screenshot",
+	"compare",
+	...Object.keys(COMMAND_DEFINITIONS)
+];
 const AUTOMATOR_COMMAND_SET = new Set(AUTOMATOR_COMMAND_NAMES);
 /**
 * @description 判断是否属于 automator 子命令。
@@ -500,6 +724,10 @@ async function runAutomatorCommand(command, argv) {
 		await runScreenshot(argv);
 		return;
 	}
+	if (command === "compare") {
+		await runCompare(argv);
+		return;
+	}
 	const definition = COMMAND_DEFINITIONS[command];
 	if (!definition) throw new Error(i18nText(`未知 automator 命令: ${command}`, `Unknown automator command: ${command}`));
 	if (argv.includes("-h") || argv.includes("--help")) {
@@ -578,7 +806,7 @@ async function promptForCliPath() {
 		try {
 			const normalizedPath = await createCustomConfig({ cliPath });
 			logger_default.info(`全局配置存储位置：${colors.green(defaultCustomConfigFilePath)}`);
-			if (!await fs.pathExists(normalizedPath)) logger_default.warn("在当前路径未找到微信web开发者命令行工具，请确认路径是否正确。");
+			if (!await fs$1.pathExists(normalizedPath)) logger_default.warn("在当前路径未找到微信web开发者命令行工具，请确认路径是否正确。");
 			return normalizedPath;
 		} catch (error) {
 			const reason = error instanceof Error ? error.message : String(error);
@@ -650,7 +878,7 @@ async function handleConfigCommand(argv) {
 	}
 	if (action === "doctor") {
 		const rawConfig = await readCustomConfig();
-		const hasConfigFile = await fs.pathExists(defaultCustomConfigFilePath);
+		const hasConfigFile = await fs$1.pathExists(defaultCustomConfigFilePath);
 		const resolvedCli = await resolveCliPath();
 		const hasCustomCli = typeof rawConfig.cliPath === "string" && rawConfig.cliPath.length > 0;
 		const hasValidCli = Boolean(resolvedCli.cliPath);
@@ -673,7 +901,7 @@ async function handleConfigCommand(argv) {
 		const outputPath = argv[1];
 		const config = await readCustomConfig();
 		if (outputPath) {
-			await fs.writeJSON(outputPath, config, {
+			await fs$1.writeJSON(outputPath, config, {
 				spaces: 2,
 				encoding: "utf8"
 			});
@@ -686,7 +914,7 @@ async function handleConfigCommand(argv) {
 	if (action === "import") {
 		const inputPath = argv[1];
 		if (!inputPath) throw new Error(i18nText("请提供导入文件路径，例如：weapp config import ./weapp-config.json", "Please provide import file path, e.g. weapp config import ./weapp-config.json"));
-		const imported = await fs.readJSON(inputPath);
+		const imported = await fs$1.readJSON(inputPath);
 		if (!imported || typeof imported !== "object") throw new Error(i18nText("导入文件格式无效：应为 JSON 对象", "Invalid import file format: expected a JSON object"));
 		const candidate = imported;
 		await overwriteCustomConfig({
@@ -1193,23 +1421,7 @@ function createCli() {
 	for (const command of WECHAT_CLI_COMMAND_NAMES) cli.command(command, "微信开发者工具官方命令透传").allowUnknownOptions();
 	for (const command of MINIDEV_NAMESPACE_COMMAND_NAMES) cli.command(`${command} [...args]`, "支付宝 minidev 命令透传").allowUnknownOptions();
 	cli.command(`${CONFIG_COMMAND_NAME} [...args]`, "配置 weapp-ide-cli").allowUnknownOptions();
-	for (const command of [
-		"screenshot",
-		"navigate",
-		"redirect",
-		"back",
-		"relaunch",
-		"switch-tab",
-		"page-stack",
-		"current-page",
-		"system-info",
-		"page-data",
-		"tap",
-		"input",
-		"scroll",
-		"audit",
-		"remote"
-	]) cli.command(`${command} [...args]`, "automator 增强命令").allowUnknownOptions();
+	for (const command of AUTOMATOR_COMMAND_NAMES) cli.command(`${command} [...args]`, "automator 增强命令").allowUnknownOptions();
 	return cli;
 }
 async function handleHelpCommand(args) {
@@ -1222,6 +1434,10 @@ async function handleHelpCommand(args) {
 		printScreenshotHelp();
 		return;
 	}
+	if (targetCommand === "compare") {
+		printCompareHelp();
+		return;
+	}
 	if (isAutomatorCommand(targetCommand)) {
 		const help = getAutomatorCommandHelp(targetCommand);
 		if (help) {
@@ -1300,4 +1516,4 @@ async function parse(argv) {
 	await runWechatCliWithRetry(cliPath, formattedArgv);
 }
 //#endregion
-export { parseAutomatorArgs as A, isWeappIdeTopLevelCommand as C, runAutomatorCommand as D, isAutomatorCommand as E, removeOption as M, parseScreenshotArgs as O, WECHAT_CLI_COMMAND_NAMES as S, getAutomatorCommandHelp as T, handleConfigCommand as _, createWechatIdeLoginRequiredExitError as a, MINIDEV_NAMESPACE_COMMAND_NAMES as b, formatWechatIdeLoginRequiredError as c, runMinidev as d, execute as f, startForwardConsole as g, transformArgv as h, runWechatCliWithRetry as i, readOptionValue as j, printScreenshotHelp as k, isWechatIdeLoginRequiredError as l, createPathCompat as m, parse as n, extractExecutionErrorText as o, createAlias as p, validateWechatCliCommandArgs as r, formatRetryHotkeyPrompt as s, createCli as t, waitForRetryKeypress as u, promptForCliPath as v, AUTOMATOR_COMMAND_NAMES as w, WEAPP_IDE_TOP_LEVEL_COMMAND_NAMES as x, CONFIG_COMMAND_NAME as y };
+export { parseCompareArgs as A, isWeappIdeTopLevelCommand as C, runAutomatorCommand as D, isAutomatorCommand as E, parseAutomatorArgs as M, readOptionValue as N, parseScreenshotArgs as O, removeOption as P, WECHAT_CLI_COMMAND_NAMES as S, getAutomatorCommandHelp as T, handleConfigCommand as _, createWechatIdeLoginRequiredExitError as a, MINIDEV_NAMESPACE_COMMAND_NAMES as b, formatWechatIdeLoginRequiredError as c, runMinidev as d, execute as f, startForwardConsole as g, transformArgv as h, runWechatCliWithRetry as i, printCompareHelp as j, printScreenshotHelp as k, isWechatIdeLoginRequiredError as l, createPathCompat as m, parse as n, extractExecutionErrorText as o, createAlias as p, validateWechatCliCommandArgs as r, formatRetryHotkeyPrompt as s, createCli as t, waitForRetryKeypress as u, promptForCliPath as v, AUTOMATOR_COMMAND_NAMES as w, WEAPP_IDE_TOP_LEVEL_COMMAND_NAMES as x, CONFIG_COMMAND_NAME as y };

package/dist/cli.js

@@ -1,18 +1,15 @@
-import { H as logger_default } from "./commands-CSbpftLN.js";
-import { n as parse } from "./cli-BZKq6t2k.js";
+import { Q as logger_default } from "./commands--vppy2pX.js";
+import { n as parse } from "./cli-DKrUhSmB.js";
 import process from "node:process";
 //#region src/cli.ts
-parse(process.argv.slice(2)).catch((err) => {
+const argv = process.argv.slice(2);
+try {
+	await parse(argv);
+} catch (err) {
 	logger_default.error(err);
-	if (typeof err?.exitCode === "number") {
-		process.exitCode = err.exitCode;
-		return;
-	}
-	if (typeof err?.code === "number") {
-		process.exitCode = err.code;
-		return;
-	}
-	process.exitCode = 1;
-});
+	if (typeof err?.exitCode === "number") process.exitCode = err.exitCode;
+	else if (typeof err?.code === "number") process.exitCode = err.code;
+	else process.exitCode = 1;
+}
 //#endregion
 export {};

package/dist/{commands-CSbpftLN.js → commands--vppy2pX.js}

@@ -1,23 +1,13 @@
+import { Buffer } from "node:buffer";
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
 import { Launcher } from "@weapp-vite/miniprogram-automator";
-import fs from "fs-extra";
+import { fs as fs$1 } from "@weapp-core/shared";
 import logger, { colors } from "@weapp-core/logger";
-import os from "node:os";
 import process from "node:process";
-import path from "pathe";
-import { Buffer as Buffer$1 } from "node:buffer";
-import fs$1 from "node:fs/promises";
-//#region \0rolldown/runtime.js
-var __defProp = Object.defineProperty;
-var __exportAll = (all, no_symbols) => {
-	let target = {};
-	for (var name in all) __defProp(target, name, {
-		get: all[name],
-		enumerable: true
-	});
-	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
-	return target;
-};
-//#endregion
+import path$1 from "pathe";
+import { PNG } from "pngjs";
 //#region src/logger.ts
 var logger_default = logger;
 //#endregion
@@ -41,6 +31,18 @@ function isOperatingSystemSupported(osName = os.type()) {
 * @description 当前系统名称
 */
 const operatingSystemName = os.type();
+async function getFirstBinaryPath(command) {
+	const pathDirs = (process.env.PATH || "").split(path$1.delimiter);
+	for (const dir of pathDirs) {
+		const fullPath = path$1.join(dir, command);
+		try {
+			await fs$1.access(fullPath, fs$1.constants.X_OK);
+			return fullPath;
+		} catch {
+			continue;
+		}
+	}
+}
 function createLinuxCliResolver() {
 	let resolvedPath;
 	let attempted = false;
@@ -78,26 +80,14 @@ async function getDefaultCliPath(targetOs = operatingSystemName) {
 	const resolver = cliPathResolvers[targetOs];
 	return await resolver();
 }
-async function getFirstBinaryPath(command) {
-	const pathDirs = (process.env.PATH || "").split(path.delimiter);
-	for (const dir of pathDirs) {
-		const fullPath = path.join(dir, command);
-		try {
-			await fs.access(fullPath, fs.constants.X_OK);
-			return fullPath;
-		} catch {
-			continue;
-		}
-	}
-}
 //#endregion
 //#region src/utils/path.ts
 /**
 * @description 解析为绝对路径（基于当前工作目录）
 */
 function resolvePath(filePath) {
-	if (path.isAbsolute(filePath)) return filePath;
-	return path.resolve(process.cwd(), filePath);
+	if (path$1.isAbsolute(filePath)) return filePath;
+	return path$1.resolve(process.cwd(), filePath);
 }
 //#endregion
 //#region src/config/paths.ts
@@ -105,17 +95,39 @@ const homedir = os.homedir();
 /**
 * @description 默认自定义配置目录
 */
-const defaultCustomConfigDirPath = path.join(homedir, ".weapp-ide-cli");
+const defaultCustomConfigDirPath = path$1.join(homedir, ".weapp-ide-cli");
 /**
 * @description 默认自定义配置文件路径
 */
-const defaultCustomConfigFilePath = path.join(defaultCustomConfigDirPath, "config.json");
+const defaultCustomConfigFilePath = path$1.join(defaultCustomConfigDirPath, "config.json");
 //#endregion
 //#region src/config/custom.ts
 const JSON_OPTIONS = {
 	encoding: "utf8",
 	spaces: 2
 };
+async function readCustomConfig() {
+	if (!await fs$1.pathExists(defaultCustomConfigFilePath)) return {};
+	try {
+		const config = await fs$1.readJSON(defaultCustomConfigFilePath);
+		if (!config || typeof config !== "object") return {};
+		const candidate = config;
+		const next = {};
+		if (typeof candidate.cliPath === "string" && candidate.cliPath.trim()) next.cliPath = candidate.cliPath.trim();
+		if (candidate.locale === "zh" || candidate.locale === "en") next.locale = candidate.locale;
+		return next;
+	} catch {
+		return {};
+	}
+}
+async function writeCustomConfig(patch, options = {}) {
+	const nextConfig = {
+		...options.replace ? {} : await readCustomConfig(),
+		...patch
+	};
+	await fs$1.ensureDir(defaultCustomConfigDirPath);
+	await fs$1.writeJSON(defaultCustomConfigFilePath, nextConfig, JSON_OPTIONS);
+}
 /**
 * @description 写入自定义 CLI 路径配置
 */
@@ -152,39 +164,14 @@ async function overwriteCustomConfig(config) {
 	if (config.locale === "zh" || config.locale === "en") nextConfig.locale = config.locale;
 	await writeCustomConfig(nextConfig, { replace: true });
 }
-/**
-* @description 读取原始自定义配置。
-*/
-async function readCustomConfig() {
-	if (!await fs.pathExists(defaultCustomConfigFilePath)) return {};
-	try {
-		const config = await fs.readJSON(defaultCustomConfigFilePath);
-		if (!config || typeof config !== "object") return {};
-		const candidate = config;
-		const next = {};
-		if (typeof candidate.cliPath === "string" && candidate.cliPath.trim()) next.cliPath = candidate.cliPath.trim();
-		if (candidate.locale === "zh" || candidate.locale === "en") next.locale = candidate.locale;
-		return next;
-	} catch {
-		return {};
-	}
-}
-async function writeCustomConfig(patch, options = {}) {
-	const nextConfig = {
-		...options.replace ? {} : await readCustomConfig(),
-		...patch
-	};
-	await fs.ensureDir(defaultCustomConfigDirPath);
-	await fs.writeJSON(defaultCustomConfigFilePath, nextConfig, JSON_OPTIONS);
-}
 //#endregion
 //#region src/config/resolver.ts
 /**
 * @description 读取并解析 CLI 配置（自定义优先）
 */
 async function getConfig() {
-	if (await fs.pathExists(defaultCustomConfigFilePath)) try {
-		const config = await fs.readJSON(defaultCustomConfigFilePath);
+	if (await fs$1.pathExists(defaultCustomConfigFilePath)) try {
+		const config = await fs$1.readJSON(defaultCustomConfigFilePath);
 		const cliPath = typeof config.cliPath === "string" ? config.cliPath.trim() : "";
 		const locale = config.locale === "zh" || config.locale === "en" ? config.locale : void 0;
 		if (cliPath) {
@@ -231,7 +218,7 @@ async function resolveCliPath() {
 		source: config.source
 	};
 	return {
-		cliPath: await fs.pathExists(config.cliPath) ? config.cliPath : null,
+		cliPath: await fs$1.pathExists(config.cliPath) ? config.cliPath : null,
 		source: config.source
 	};
 }
@@ -245,6 +232,10 @@ const LOGIN_REQUIRED_CN_RE = /需要重新登录/;
 const LOGIN_REQUIRED_EN_RE = /need\s+re-?login|re-?login/i;
 const LOGIN_REQUIRED_CODE_RE = /code\s*[:=]\s*(\d+)/i;
 const DEVTOOLS_HTTP_PORT_ERROR = "Failed to launch wechat web devTools, please make sure http port is open";
+const DEVTOOLS_EXTENSION_CONTEXT_INVALIDATED_RE = /Extension context invalidated/i;
+const AUTOMATOR_LAUNCH_TIMEOUT_RE = /Wait timed out after \d+ ms/i;
+const AUTOMATOR_WS_CONNECT_RE = /Failed connecting to ws:\/\/127\.0\.0\.1:\d+/i;
+const DEVTOOLS_PROTOCOL_TIMEOUT_RE = /DevTools did not respond to protocol method (\S+) within \d+ms/i;
 const DEVTOOLS_INFRA_ERROR_PATTERNS = [
 	/listen EPERM/i,
 	/operation not permitted 0\.0\.0\.0/i,
@@ -252,6 +243,8 @@ const DEVTOOLS_INFRA_ERROR_PATTERNS = [
 	/ECONNREFUSED/i,
 	/connect ECONNREFUSED/i
 ];
+const DEFAULT_WECHAT_DEVTOOLS_WS_ENDPOINT = "ws://127.0.0.1:9420";
+const AUTOMATOR_SESSION_DIR = path.join(os.tmpdir(), "weapp-vite-automator-sessions");
 const DEVTOOLS_LOGIN_REQUIRED_PATTERNS = [
 	/code\s*[:=]\s*10/i,
 	/需要重新登录/,
@@ -271,6 +264,38 @@ function extractErrorText(error) {
 		candidate.stdout
 	].filter((value) => typeof value === "string" && value.trim().length > 0).join("\n");
 }
+function resolveAutomatorSessionFilePath(projectPath) {
+	const normalizedProjectPath = path.resolve(projectPath);
+	const encodedProjectPath = Buffer.from(normalizedProjectPath).toString("base64url");
+	return path.join(AUTOMATOR_SESSION_DIR, `${encodedProjectPath}.json`);
+}
+async function persistAutomatorSession(projectPath, wsEndpoint) {
+	const filePath = resolveAutomatorSessionFilePath(projectPath);
+	const payload = {
+		projectPath: path.resolve(projectPath),
+		updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+		wsEndpoint
+	};
+	await fs.mkdir(path.dirname(filePath), { recursive: true });
+	await fs.writeFile(filePath, JSON.stringify(payload, null, 2), "utf8");
+}
+async function readPersistedAutomatorSession(projectPath) {
+	const filePath = resolveAutomatorSessionFilePath(projectPath);
+	try {
+		const raw = await fs.readFile(filePath, "utf8");
+		const payload = JSON.parse(raw);
+		if (payload.projectPath !== path.resolve(projectPath) || typeof payload.wsEndpoint !== "string" || !payload.wsEndpoint.trim()) return null;
+		return payload;
+	} catch {
+		return null;
+	}
+}
+async function removePersistedAutomatorSession(projectPath) {
+	const filePath = resolveAutomatorSessionFilePath(projectPath);
+	try {
+		await fs.rm(filePath, { force: true });
+	} catch {}
+}
 /**
 * @description 提取登录失效时最适合展示给用户的一行信息。
 */
@@ -291,6 +316,40 @@ function isDevtoolsHttpPortError(error) {
 	return message.includes(DEVTOOLS_HTTP_PORT_ERROR) || DEVTOOLS_INFRA_ERROR_PATTERNS.some((pattern) => pattern.test(message));
 }
 /**
+* @description 判断错误是否属于开发者工具 automator 扩展上下文尚未就绪。
+*/
+function isDevtoolsExtensionContextInvalidatedError(error) {
+	const message = error instanceof Error ? error.message : String(error);
+	return DEVTOOLS_EXTENSION_CONTEXT_INVALIDATED_RE.test(message);
+}
+/**
+* @description 判断错误是否属于可重试的 automator 启动抖动。
+*/
+function isRetryableAutomatorLaunchError(error) {
+	const message = error instanceof Error ? error.message : String(error);
+	return DEVTOOLS_EXTENSION_CONTEXT_INVALIDATED_RE.test(message) || AUTOMATOR_LAUNCH_TIMEOUT_RE.test(message) || AUTOMATOR_WS_CONNECT_RE.test(message);
+}
+/**
+* @description 判断错误是否属于开发者工具 websocket 连接失败。
+*/
+function isAutomatorWsConnectError(error) {
+	const message = error instanceof Error ? error.message : String(error);
+	return AUTOMATOR_WS_CONNECT_RE.test(message);
+}
+/**
+* @description 判断错误是否属于开发者工具协议调用超时。
+*/
+function isAutomatorProtocolTimeoutError(error) {
+	const message = error instanceof Error ? error.message : String(error);
+	return DEVTOOLS_PROTOCOL_TIMEOUT_RE.test(message);
+}
+/**
+* @description 提取协议超时的方法名。
+*/
+function getAutomatorProtocolTimeoutMethod(error) {
+	return (error instanceof Error ? error.message : String(error)).match(DEVTOOLS_PROTOCOL_TIMEOUT_RE)?.[1];
+}
+/**
 * @description 判断错误是否属于开发者工具登录失效。
 */
 function isAutomatorLoginError(error) {
@@ -315,13 +374,40 @@ function formatAutomatorLoginError(error) {
 * @description 基于当前配置解析 CLI 路径，并通过现代化 automator 入口启动会话。
 */
 async function launchAutomator(options) {
-	const { cliPath, projectPath, timeout = 3e4 } = options;
+	const { cliPath, projectPath, timeout = 3e4, trustProject = false } = options;
 	const resolvedCliPath = cliPath ?? (await resolveCliPath()).cliPath ?? void 0;
-	return await new Launcher().launch({
-		cliPath: resolvedCliPath,
-		projectPath,
-		timeout
-	});
+	const launcher = new Launcher();
+	let lastError = null;
+	for (let attempt = 0; attempt < 2; attempt += 1) try {
+		const miniProgram = await launcher.launch({
+			cliPath: resolvedCliPath,
+			projectPath,
+			timeout,
+			trustProject
+		});
+		const sessionMetadata = Reflect.get(miniProgram, "__WEAPP_VITE_SESSION_METADATA");
+		if (typeof sessionMetadata?.wsEndpoint === "string" && sessionMetadata.wsEndpoint) await persistAutomatorSession(projectPath, sessionMetadata.wsEndpoint);
+		return miniProgram;
+	} catch (error) {
+		lastError = error;
+		if (!isRetryableAutomatorLaunchError(error) || attempt === 1) throw error;
+	}
+	throw lastError instanceof Error ? lastError : new Error(String(lastError));
+}
+/**
+* @description 连接当前项目已打开的开发者工具自动化会话，不触发新的 IDE 拉起。
+*/
+async function connectOpenedAutomator(options) {
+	const { projectPath } = options;
+	const launcher = new Launcher();
+	const persistedSession = await readPersistedAutomatorSession(projectPath);
+	const wsEndpoint = persistedSession?.wsEndpoint ?? DEFAULT_WECHAT_DEVTOOLS_WS_ENDPOINT;
+	try {
+		return await launcher.connect({ wsEndpoint });
+	} catch (error) {
+		if (persistedSession) await removePersistedAutomatorSession(projectPath);
+		throw error;
+	}
 }
 //#endregion
 //#region src/i18n.ts
@@ -390,6 +476,7 @@ function readLangOption(argv) {
 }
 //#endregion
 //#region src/cli/automator-session.ts
+const sharedMiniProgramSessions = /* @__PURE__ */ new Map();
 function normalizeMiniProgramConnectionError(error) {
 	if (isAutomatorLoginError(error)) {
 		logger_default.error(i18nText("检测到微信开发者工具登录状态失效，请先登录后重试。", "Wechat DevTools login has expired. Please login and retry."));
@@ -401,22 +488,106 @@ function normalizeMiniProgramConnectionError(error) {
 		logger_default.warn(i18nText("请在微信开发者工具中：设置 -> 安全设置 -> 开启服务端口", "Please enable service port in Wechat DevTools: Settings -> Security -> Service Port"));
 		return /* @__PURE__ */ new Error("DEVTOOLS_HTTP_PORT_ERROR");
 	}
+	if (isDevtoolsExtensionContextInvalidatedError(error)) {
+		logger_default.error(i18nText("微信开发者工具自动化上下文尚未就绪，通常是刚启动或正在重载。", "Wechat DevTools automation context is not ready yet, usually because the IDE has just started or is still reloading."));
+		logger_default.warn(i18nText("请稍后重试；若持续失败，关闭多余的开发者工具窗口后重试。", "Please retry shortly. If it keeps failing, close extra DevTools windows and try again."));
+		return /* @__PURE__ */ new Error("DEVTOOLS_EXTENSION_CONTEXT_INVALIDATED");
+	}
+	if (isAutomatorWsConnectError(error)) {
+		logger_default.error(i18nText("无法连接到当前项目的微信开发者工具自动化 websocket。", "Cannot connect to the Wechat DevTools automation websocket for the current project."));
+		logger_default.warn(i18nText("请确认当前打开的是目标项目；若之前跑过其他 e2e / screenshot 任务，关闭多余的微信开发者工具窗口，或结束残留的 `wechatwebdevtools cli auto --project ...` 进程后重试。", "Please confirm the current DevTools window is the target project. If you recently ran other e2e or screenshot tasks, close extra DevTools windows or stop stale `wechatwebdevtools cli auto --project ...` processes and retry."));
+		return /* @__PURE__ */ new Error("DEVTOOLS_WS_CONNECT_ERROR");
+	}
+	if (isAutomatorProtocolTimeoutError(error)) {
+		const method = getAutomatorProtocolTimeoutMethod(error) ?? "unknown";
+		logger_default.error(i18nText(`微信开发者工具在协议调用 ${method} 上超时，未按预期返回结果。`, `Wechat DevTools timed out while executing protocol method ${method} and did not return a result.`));
+		logger_default.warn(i18nText("这通常表示当前 DevTools 自动化会话已卡住、窗口不在目标项目、或当前 DevTools 版本对该协议调用无响应。请重开目标项目窗口后重试；若仍复现，优先记录当前 DevTools 版本与协议方法名继续排查。", "This usually means the current DevTools automation session is stuck, the window is not on the target project, or the current DevTools version is not responding to that protocol method. Reopen the target project window and retry. If it still reproduces, record the current DevTools version and protocol method name for follow-up debugging."));
+		return /* @__PURE__ */ new Error("DEVTOOLS_PROTOCOL_TIMEOUT");
+	}
 	return error instanceof Error ? error : new Error(String(error));
 }
 /**
 * @description 建立 automator 会话，并统一处理常见连接错误提示。
 */
 async function connectMiniProgram(options) {
-	try {
+	if (options.preferOpenedSession === false) try {
 		return await launchAutomator(options);
 	} catch (error) {
 		throw normalizeMiniProgramConnectionError(error);
 	}
+	try {
+		return await connectOpenedAutomator(options);
+	} catch (error) {
+		const normalizedOpenSessionError = normalizeMiniProgramConnectionError(error);
+		if (normalizedOpenSessionError instanceof Error && normalizedOpenSessionError.message === "DEVTOOLS_PROTOCOL_TIMEOUT") throw normalizedOpenSessionError;
+		try {
+			return await launchAutomator(options);
+		} catch (launchError) {
+			throw normalizeMiniProgramConnectionError(launchError);
+		}
+	}
+}
+/**
+* @description 获取指定项目的共享 automator 会话；若不存在则自动创建。
+*/
+async function acquireSharedMiniProgram(options) {
+	const existing = sharedMiniProgramSessions.get(options.projectPath);
+	if (existing) {
+		existing.refs += 1;
+		return await existing.session;
+	}
+	const session = connectMiniProgram(options);
+	const entry = {
+		refs: 1,
+		session
+	};
+	sharedMiniProgramSessions.set(options.projectPath, entry);
+	try {
+		return await session;
+	} catch (error) {
+		sharedMiniProgramSessions.delete(options.projectPath);
+		throw error;
+	}
+}
+/**
+* @description 释放指定项目的共享会话引用；会话对象会继续缓存，直到显式关闭或重置。
+*/
+function releaseSharedMiniProgram(projectPath) {
+	const entry = sharedMiniProgramSessions.get(projectPath);
+	if (!entry) return;
+	entry.refs = Math.max(0, entry.refs - 1);
+}
+/**
+* @description 关闭并移除指定项目的共享 automator 会话。
+*/
+async function closeSharedMiniProgram(projectPath) {
+	const entry = sharedMiniProgramSessions.get(projectPath);
+	if (!entry) return;
+	sharedMiniProgramSessions.delete(projectPath);
+	(await entry.session.catch(() => null))?.disconnect();
+}
+/**
+* @description 获取当前共享会话数量，供测试断言使用。
+*/
+function getSharedMiniProgramSessionCount() {
+	return sharedMiniProgramSessions.size;
 }
 /**
 * @description 统一管理 automator 会话生命周期。
 */
 async function withMiniProgram(options, runner) {
+	if (options.miniProgram) return await runner(options.miniProgram);
+	if (options.sharedSession) {
+		const miniProgram = await acquireSharedMiniProgram(options);
+		try {
+			return await runner(miniProgram);
+		} catch (error) {
+			await closeSharedMiniProgram(options.projectPath);
+			throw normalizeMiniProgramConnectionError(error);
+		} finally {
+			releaseSharedMiniProgram(options.projectPath);
+		}
+	}
 	let miniProgram = null;
 	try {
 		miniProgram = await connectMiniProgram(options);
@@ -428,24 +599,112 @@ async function withMiniProgram(options, runner) {
 	}
 }
 //#endregion
+//#region src/cli/fullPageScreenshot.ts
+function decodeScreenshotBuffer(raw) {
+	const buffer = typeof raw === "string" ? Buffer.from(raw, "base64") : Buffer.from(raw);
+	if (buffer.length === 0) throw new Error("Failed to capture screenshot");
+	return buffer;
+}
+function toPositiveNumber(value) {
+	return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : void 0;
+}
+function createScrollPositions(totalHeight, viewportHeight) {
+	if (totalHeight <= viewportHeight) return [0];
+	const positions = [];
+	const lastStart = Math.max(totalHeight - viewportHeight, 0);
+	for (let scrollTop = 0; scrollTop < lastStart; scrollTop += viewportHeight) positions.push(scrollTop);
+	if (positions.at(-1) !== lastStart) positions.push(lastStart);
+	return positions;
+}
+function cropPngRows(source, startRow, rowCount) {
+	const cropped = new PNG({
+		width: source.width,
+		height: rowCount
+	});
+	const bytesPerRow = source.width * 4;
+	for (let row = 0; row < rowCount; row += 1) {
+		const sourceStart = (startRow + row) * bytesPerRow;
+		const sourceEnd = sourceStart + bytesPerRow;
+		source.data.copy(cropped.data, row * bytesPerRow, sourceStart, sourceEnd);
+	}
+	return cropped;
+}
+/**
+* @description 通过多次滚动和拼接生成整页长截图。
+*/
+async function captureFullPageScreenshotBuffer(options) {
+	const { miniProgram, timeoutMs, runWithTimeout, screenshotTimeoutMessage } = options;
+	const page = await miniProgram.currentPage();
+	const pageSize = await page.size();
+	const systemInfo = await miniProgram.systemInfo();
+	const pageHeight = toPositiveNumber(pageSize.height);
+	const viewportHeight = toPositiveNumber(systemInfo.windowHeight);
+	if (!pageHeight || !viewportHeight) return decodeScreenshotBuffer(await runWithTimeout(miniProgram.screenshot(), timeoutMs, screenshotTimeoutMessage, "DEVTOOLS_SCREENSHOT_TIMEOUT"));
+	const segments = [];
+	const positions = createScrollPositions(pageHeight, viewportHeight);
+	let coveredUntil = 0;
+	let scale = 1;
+	for (const scrollTop of positions) {
+		await miniProgram.pageScrollTo(scrollTop);
+		await page.waitFor(150);
+		const rawScreenshot = await runWithTimeout(miniProgram.screenshot(), timeoutMs, screenshotTimeoutMessage, "DEVTOOLS_SCREENSHOT_TIMEOUT");
+		const png = PNG.sync.read(decodeScreenshotBuffer(rawScreenshot));
+		if (viewportHeight > 0) scale = png.height / viewportHeight;
+		const visibleEnd = Math.min(scrollTop + viewportHeight, pageHeight);
+		const cropTopCss = Math.max(coveredUntil - scrollTop, 0);
+		const segmentHeightCss = Math.max(visibleEnd - scrollTop - cropTopCss, 0);
+		if (segmentHeightCss <= 0) continue;
+		const cropTopRows = Math.min(Math.max(Math.round(cropTopCss * scale), 0), png.height);
+		const segmentRows = Math.min(Math.max(Math.round(segmentHeightCss * scale), 1), png.height - cropTopRows);
+		segments.push(cropPngRows(png, cropTopRows, segmentRows));
+		coveredUntil = visibleEnd;
+	}
+	if (segments.length === 0) throw new Error("Failed to capture screenshot");
+	const width = segments[0].width;
+	const merged = new PNG({
+		width,
+		height: segments.reduce((sum, segment) => sum + segment.height, 0)
+	});
+	const bytesPerRow = width * 4;
+	let offsetY = 0;
+	for (const segment of segments) {
+		if (segment.width !== width) throw new Error("Full-page screenshots have inconsistent widths");
+		for (let row = 0; row < segment.height; row += 1) {
+			const sourceStart = row * bytesPerRow;
+			const sourceEnd = sourceStart + bytesPerRow;
+			segment.data.copy(merged.data, (offsetY + row) * bytesPerRow, sourceStart, sourceEnd);
+		}
+		offsetY += segment.height;
+	}
+	return PNG.sync.write(merged);
+}
+//#endregion
 //#region src/cli/commands.ts
-var commands_exports = /* @__PURE__ */ __exportAll({
-	audit: () => audit,
-	currentPage: () => currentPage,
-	input: () => input,
-	navigateBack: () => navigateBack,
-	navigateTo: () => navigateTo,
-	pageData: () => pageData,
-	pageStack: () => pageStack,
-	reLaunch: () => reLaunch,
-	redirectTo: () => redirectTo,
-	remote: () => remote,
-	scrollTo: () => scrollTo,
-	switchTab: () => switchTab,
-	systemInfo: () => systemInfo,
-	takeScreenshot: () => takeScreenshot,
-	tap: () => tap
-});
+function createTimeoutError(message, code) {
+	const error = new Error(message);
+	error.code = code;
+	return error;
+}
+function normalizePagePath(page) {
+	return page.startsWith("/") ? page : `/${page}`;
+}
+function sleep(ms) {
+	return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function withCommandTimeout(task, timeoutMs, message, code) {
+	return new Promise((resolve, reject) => {
+		const timeout = setTimeout(() => {
+			reject(createTimeoutError(message, code));
+		}, timeoutMs);
+		task.then((value) => {
+			clearTimeout(timeout);
+			resolve(value);
+		}).catch((error) => {
+			clearTimeout(timeout);
+			reject(error);
+		});
+	});
+}
 async function runRouteCommand(options, startMessage, successMessage, action) {
 	await withMiniProgram(options, async (miniProgram) => {
 		logger_default.info(startMessage);
@@ -583,7 +842,7 @@ async function audit(options) {
 		logger_default.info(i18nText("正在执行体验审计...", "Running experience audit..."));
 		const result = await miniProgram.stopAudits();
 		if (options.outputPath) {
-			await fs$1.writeFile(options.outputPath, JSON.stringify(result, null, 2));
+			await fs.writeFile(options.outputPath, JSON.stringify(result, null, 2));
 			logger_default.success(i18nText(`审计报告已保存到 ${colors.cyan(options.outputPath)}`, `Audit report saved to ${colors.cyan(options.outputPath)}`));
 			return result;
 		}
@@ -592,28 +851,62 @@ async function audit(options) {
 	});
 }
 /**
-* @description 获取当前小程序截图。
+* @description 捕获当前页面截图并返回二进制内容。
 */
-async function takeScreenshot(options) {
+async function captureScreenshotBuffer(options) {
 	return await withMiniProgram(options, async (miniProgram) => {
-		logger_default.info(i18nText(`正在连接 DevTools：${colors.cyan(options.projectPath)}...`, `Connecting to DevTools at ${colors.cyan(options.projectPath)}...`));
+		const commandTimeout = options.timeout ?? 3e4;
+		const screenshotTimeoutMessage = i18nText(`截图请求在 ${commandTimeout}ms 内未收到 DevTools 回包，请检查当前微信开发者工具是否仍停留在目标项目；若近期执行过其他 e2e / screenshot 任务，关闭多余窗口并清理残留 automator 会话后重试。`, `Screenshot request did not receive a DevTools response within ${commandTimeout}ms. Check that the current Wechat DevTools window is still the target project. If you recently ran other e2e or screenshot tasks, close extra windows and clean up stale automator sessions before retrying.`);
+		if (!options.miniProgram) logger_default.info(i18nText(`正在连接 DevTools：${colors.cyan(options.projectPath)}...`, `Connecting to DevTools at ${colors.cyan(options.projectPath)}...`));
 		if (options.page) {
-			logger_default.info(i18nText(`正在跳转页面 ${colors.cyan(options.page)}...`, `Navigating to page ${colors.cyan(options.page)}...`));
-			await miniProgram.reLaunch(options.page);
+			const normalizedPage = normalizePagePath(options.page);
+			logger_default.info(i18nText(`正在跳转页面 ${colors.cyan(normalizedPage)}...`, `Navigating to page ${colors.cyan(normalizedPage)}...`));
+			await miniProgram.reLaunch(normalizedPage);
+			if (options.fullPage) await sleep(1e3);
 		}
-		logger_default.info(i18nText("正在截图...", "Taking screenshot..."));
-		const screenshot = await miniProgram.screenshot();
-		const base64 = typeof screenshot === "string" ? screenshot : Buffer$1.from(screenshot).toString("base64");
-		if (!base64) throw new Error(i18nText("截图失败", "Failed to capture screenshot"));
-		if (options.outputPath) {
-			await fs$1.writeFile(options.outputPath, Buffer$1.from(base64, "base64"));
-			logger_default.success(i18nText(`截图已保存到 ${colors.cyan(options.outputPath)}`, `Screenshot saved to ${colors.cyan(options.outputPath)}`));
-			return { path: options.outputPath };
+		if (options.fullPage) {
+			logger_default.info(i18nText("正在生成整页长截图...", "Capturing full-page screenshot..."));
+			return await captureFullPageScreenshotBuffer({
+				miniProgram,
+				timeoutMs: commandTimeout,
+				runWithTimeout: withCommandTimeout,
+				screenshotTimeoutMessage
+			});
 		}
-		return { base64 };
+		logger_default.info(i18nText("正在截图...", "Taking screenshot..."));
+		const screenshot = await withCommandTimeout(miniProgram.screenshot(), commandTimeout, screenshotTimeoutMessage, "DEVTOOLS_SCREENSHOT_TIMEOUT");
+		const buffer = typeof screenshot === "string" ? Buffer.from(screenshot, "base64") : Buffer.from(screenshot);
+		if (buffer.length === 0) throw new Error(i18nText("截图失败", "Failed to capture screenshot"));
+		return buffer;
 	});
 }
 /**
+* @description 获取当前小程序截图。
+*/
+async function takeScreenshot(options) {
+	let screenshotBuffer;
+	try {
+		screenshotBuffer = await captureScreenshotBuffer(options);
+	} catch (error) {
+		const isProtocolTimeout = error instanceof Error && error.message === "DEVTOOLS_PROTOCOL_TIMEOUT";
+		if (!Boolean(options.sharedSession && !options.miniProgram && isProtocolTimeout)) throw error;
+		await closeSharedMiniProgram(options.projectPath);
+		logger_default.warn(i18nText("当前共享 DevTools 会话截图超时，正在改用全新自动化会话重试一次...", "The current shared DevTools session timed out while capturing screenshot. Retrying once with a fresh automation session..."));
+		screenshotBuffer = await captureScreenshotBuffer({
+			...options,
+			preferOpenedSession: false,
+			sharedSession: false
+		});
+	}
+	const base64 = screenshotBuffer.toString("base64");
+	if (options.outputPath) {
+		await fs.writeFile(options.outputPath, screenshotBuffer);
+		logger_default.success(i18nText(`截图已保存到 ${colors.cyan(options.outputPath)}`, `Screenshot saved to ${colors.cyan(options.outputPath)}`));
+		return { path: options.outputPath };
+	}
+	return { base64 };
+}
+/**
 * @description 开关远程调试。
 */
 async function remote(options) {
@@ -625,4 +918,4 @@ async function remote(options) {
 	});
 }
 //#endregion
-export { createLocaleConfig as A, operatingSystemName as B, isAutomatorLoginError as C, getConfig as D, resolveCliPath as E, defaultCustomConfigFilePath as F, logger_default as H, resolvePath as I, SupportedPlatformsMap as L, readCustomConfig as M, removeCustomConfigKey as N, getConfiguredLocale as O, defaultCustomConfigDirPath as P, getDefaultCliPath as R, formatAutomatorLoginError as S, launchAutomator as T, colors as V, connectMiniProgram as _, navigateBack as a, i18nText as b, pageStack as c, remote as d, scrollTo as f, tap as g, takeScreenshot as h, input as i, overwriteCustomConfig as j, createCustomConfig as k, reLaunch as l, systemInfo as m, commands_exports as n, navigateTo as o, switchTab as p, currentPage as r, pageData as s, audit as t, redirectTo as u, withMiniProgram as v, isDevtoolsHttpPortError as w, validateLocaleOption as x, configureLocaleFromArgv as y, isOperatingSystemSupported as z };
+export { isAutomatorProtocolTimeoutError as A, createLocaleConfig as B, configureLocaleFromArgv as C, formatAutomatorLoginError as D, connectOpenedAutomator as E, launchAutomator as F, defaultCustomConfigFilePath as G, readCustomConfig as H, resolveCliPath as I, getDefaultCliPath as J, resolvePath as K, getConfig as L, isDevtoolsExtensionContextInvalidatedError as M, isDevtoolsHttpPortError as N, getAutomatorProtocolTimeoutMethod as O, isRetryableAutomatorLaunchError as P, logger_default as Q, getConfiguredLocale as R, withMiniProgram as S, validateLocaleOption as T, removeCustomConfigKey as U, overwriteCustomConfig as V, defaultCustomConfigDirPath as W, operatingSystemName as X, isOperatingSystemSupported as Y, colors as Z, acquireSharedMiniProgram as _, navigateBack as a, getSharedMiniProgramSessionCount as b, pageStack as c, remote as d, scrollTo as f, tap as g, takeScreenshot as h, input as i, isAutomatorWsConnectError as j, isAutomatorLoginError as k, reLaunch as l, systemInfo as m, captureScreenshotBuffer as n, navigateTo as o, switchTab as p, SupportedPlatformsMap as q, currentPage as r, pageData as s, audit as t, redirectTo as u, closeSharedMiniProgram as v, i18nText as w, releaseSharedMiniProgram as x, connectMiniProgram as y, createCustomConfig as z };

package/dist/commands-Bg8hQbPE.js

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

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import { Buffer } from "node:buffer";
+import * as _weapp_vite_miniprogram_automator0 from "@weapp-vite/miniprogram-automator";
 import { Element, MiniProgram, Page } from "@weapp-vite/miniprogram-automator";
 import * as cac$1 from "cac";
 import * as execa from "execa";
@@ -7,11 +9,33 @@ interface AutomatorOptions {
   projectPath: string;
   timeout?: number;
   cliPath?: string;
+  trustProject?: boolean;
+  preferOpenedSession?: boolean;
 }
 /**
  * @description 判断错误是否属于开发者工具服务端口不可用。
  */
 declare function isDevtoolsHttpPortError(error: unknown): boolean;
+/**
+ * @description 判断错误是否属于开发者工具 automator 扩展上下文尚未就绪。
+ */
+declare function isDevtoolsExtensionContextInvalidatedError(error: unknown): boolean;
+/**
+ * @description 判断错误是否属于可重试的 automator 启动抖动。
+ */
+declare function isRetryableAutomatorLaunchError(error: unknown): boolean;
+/**
+ * @description 判断错误是否属于开发者工具 websocket 连接失败。
+ */
+declare function isAutomatorWsConnectError(error: unknown): boolean;
+/**
+ * @description 判断错误是否属于开发者工具协议调用超时。
+ */
+declare function isAutomatorProtocolTimeoutError(error: unknown): boolean;
+/**
+ * @description 提取协议超时的方法名。
+ */
+declare function getAutomatorProtocolTimeoutMethod(error: unknown): string | undefined;
 /**
  * @description 判断错误是否属于开发者工具登录失效。
  */
@@ -24,6 +48,10 @@ declare function formatAutomatorLoginError(error: unknown): string;
  * @description 基于当前配置解析 CLI 路径，并通过现代化 automator 入口启动会话。
  */
 declare function launchAutomator(options: AutomatorOptions): Promise<any>;
+/**
+ * @description 连接当前项目已打开的开发者工具自动化会话，不触发新的 IDE 拉起。
+ */
+declare function connectOpenedAutomator(options: AutomatorOptions): Promise<_weapp_vite_miniprogram_automator0.MiniProgram>;
 //#endregion
 //#region src/cli/automator-argv.d.ts
 interface ParsedAutomatorArgs {
@@ -46,10 +74,6 @@ declare function readOptionValue(argv: readonly string[], optionName: string): s
 declare function removeOption(argv: readonly string[], optionName: string): string[];
 //#endregion
 //#region src/cli/automator-session.d.ts
-interface AutomatorSessionOptions {
-  projectPath: string;
-  timeout?: number;
-}
 interface MiniProgramEventMap {
   console: (payload: unknown) => void;
   exception: (payload: unknown) => void;
@@ -59,10 +83,33 @@ type MiniProgramPage = InstanceType<typeof Page>;
 type MiniProgramElement = InstanceType<typeof Element> & {
   input?: (value: string) => Promise<void>;
 };
+interface AutomatorSessionOptions {
+  miniProgram?: MiniProgramLike;
+  preferOpenedSession?: boolean;
+  projectPath: string;
+  sharedSession?: boolean;
+  timeout?: number;
+}
 /**
  * @description 建立 automator 会话，并统一处理常见连接错误提示。
  */
 declare function connectMiniProgram(options: AutomatorSessionOptions): Promise<MiniProgramLike>;
+/**
+ * @description 获取指定项目的共享 automator 会话；若不存在则自动创建。
+ */
+declare function acquireSharedMiniProgram(options: AutomatorSessionOptions): Promise<MiniProgramLike>;
+/**
+ * @description 释放指定项目的共享会话引用；会话对象会继续缓存，直到显式关闭或重置。
+ */
+declare function releaseSharedMiniProgram(projectPath: string): void;
+/**
+ * @description 关闭并移除指定项目的共享 automator 会话。
+ */
+declare function closeSharedMiniProgram(projectPath: string): Promise<void>;
+/**
+ * @description 获取当前共享会话数量，供测试断言使用。
+ */
+declare function getSharedMiniProgramSessionCount(): number;
 /**
  * @description 统一管理 automator 会话生命周期。
  */
@@ -105,6 +152,7 @@ interface AuditOptions extends AutomatorCommandOptions {
 interface ScreenshotOptions extends AutomatorCommandOptions {
   outputPath?: string;
   page?: string;
+  fullPage?: boolean;
 }
 interface ScreenshotResult {
   base64?: string;
@@ -169,6 +217,10 @@ declare function scrollTo(options: ScrollOptions): Promise<void>;
  * @description 执行体验评分审计。
  */
 declare function audit(options: AuditOptions): Promise<any>;
+/**
+ * @description 捕获当前页面截图并返回二进制内容。
+ */
+declare function captureScreenshotBuffer(options: ScreenshotOptions): Promise<Buffer>;
 /**
  * @description 获取当前小程序截图。
  */
@@ -178,6 +230,24 @@ declare function takeScreenshot(options: ScreenshotOptions): Promise<ScreenshotR
  */
 declare function remote(options: RemoteOptions): Promise<void>;
 //#endregion
+//#region src/cli/compare.d.ts
+interface CompareOptions extends ScreenshotOptions {
+  baselinePath: string;
+  currentOutputPath?: string;
+  diffOutputPath?: string;
+  threshold: number;
+  maxDiffPixels?: number;
+  maxDiffRatio?: number;
+}
+/**
+ * @description 输出 compare 命令帮助信息。
+ */
+declare function printCompareHelp(): void;
+/**
+ * @description 解析 compare 命令参数。
+ */
+declare function parseCompareArgs(argv: string[]): CompareOptions;
+//#endregion
 //#region src/cli/config-command.d.ts
 /**
  * @description 处理 config 子命令。
@@ -338,6 +408,7 @@ interface CustomConfigFile {
   cliPath?: string;
   locale?: 'zh' | 'en';
 }
+declare function readCustomConfig(): Promise<CustomConfigFile>;
 /**
  * @description 写入自定义 CLI 路径配置
  */
@@ -354,10 +425,6 @@ declare function removeCustomConfigKey(key: keyof CustomConfigFile): Promise<voi
  * @description 覆盖写入配置内容（会替换原内容）。
  */
 declare function overwriteCustomConfig(config: CustomConfigFile): Promise<void>;
-/**
- * @description 读取原始自定义配置。
- */
-declare function readCustomConfig(): Promise<CustomConfigFile>;
 //#endregion
 //#region src/config/paths.d.ts
 /**
@@ -440,4 +507,4 @@ declare function execute(cliPath: string, argv: string[], options?: ExecuteOptio
  */
 declare function resolvePath(filePath: string): string;
 //#endregion
-export { AUTOMATOR_COMMAND_NAMES, ArgvTransform, AuditOptions, AutomatorCommandOptions, AutomatorOptions, AutomatorSessionOptions, type BaseConfig, CONFIG_COMMAND_NAME, type ConfigSource, ForwardConsoleEvent, ForwardConsoleLogLevel, ForwardConsoleOptions, ForwardConsoleSession, InputOptions, LoginRetryMode, MINIDEV_NAMESPACE_COMMAND_NAMES, MiniProgramElement, MiniProgramEventMap, MiniProgramLike, MiniProgramPage, NavigateOptions, PageDataOptions, PageInfoOptions, ParsedAutomatorArgs, RemoteOptions, type ResolvedConfig, RetryKeypressOptions, RetryPromptResult, type ScreenshotOptions, type ScreenshotResult, ScrollOptions, SelectorOptions, SupportedPlatform, SupportedPlatformsMap, TapOptions, WEAPP_IDE_TOP_LEVEL_COMMAND_NAMES, WECHAT_CLI_COMMAND_NAMES, audit, connectMiniProgram, createAlias, createCli, createCustomConfig, createLocaleConfig, createPathCompat, createWechatIdeLoginRequiredExitError, currentPage, defaultCustomConfigDirPath, defaultCustomConfigFilePath, execute, extractExecutionErrorText, formatAutomatorLoginError, formatRetryHotkeyPrompt, formatWechatIdeLoginRequiredError, getAutomatorCommandHelp, getConfig, getConfiguredLocale, getDefaultCliPath, handleConfigCommand, input, isAutomatorCommand, isAutomatorLoginError, isDevtoolsHttpPortError, isOperatingSystemSupported, isWeappIdeTopLevelCommand, isWechatIdeLoginRequiredError, launchAutomator, navigateBack, navigateTo, operatingSystemName, overwriteCustomConfig, pageData, pageStack, parse, parseAutomatorArgs, parseScreenshotArgs, printScreenshotHelp, promptForCliPath, reLaunch, readCustomConfig, readOptionValue, redirectTo, remote, removeCustomConfigKey, removeOption, resolveCliPath, resolvePath, runAutomatorCommand, runMinidev, runWechatCliWithRetry, scrollTo, startForwardConsole, switchTab, systemInfo, takeScreenshot, tap, transformArgv, validateWechatCliCommandArgs, waitForRetryKeypress, withMiniProgram };
+export { AUTOMATOR_COMMAND_NAMES, ArgvTransform, AuditOptions, AutomatorCommandOptions, AutomatorOptions, AutomatorSessionOptions, type BaseConfig, CONFIG_COMMAND_NAME, type ConfigSource, ForwardConsoleEvent, ForwardConsoleLogLevel, ForwardConsoleOptions, ForwardConsoleSession, InputOptions, LoginRetryMode, MINIDEV_NAMESPACE_COMMAND_NAMES, MiniProgramElement, MiniProgramEventMap, MiniProgramLike, MiniProgramPage, NavigateOptions, PageDataOptions, PageInfoOptions, ParsedAutomatorArgs, RemoteOptions, type ResolvedConfig, RetryKeypressOptions, RetryPromptResult, type ScreenshotOptions, type ScreenshotResult, ScrollOptions, SelectorOptions, SupportedPlatform, SupportedPlatformsMap, TapOptions, WEAPP_IDE_TOP_LEVEL_COMMAND_NAMES, WECHAT_CLI_COMMAND_NAMES, acquireSharedMiniProgram, audit, captureScreenshotBuffer, closeSharedMiniProgram, connectMiniProgram, connectOpenedAutomator, createAlias, createCli, createCustomConfig, createLocaleConfig, createPathCompat, createWechatIdeLoginRequiredExitError, currentPage, defaultCustomConfigDirPath, defaultCustomConfigFilePath, execute, extractExecutionErrorText, formatAutomatorLoginError, formatRetryHotkeyPrompt, formatWechatIdeLoginRequiredError, getAutomatorCommandHelp, getAutomatorProtocolTimeoutMethod, getConfig, getConfiguredLocale, getDefaultCliPath, getSharedMiniProgramSessionCount, handleConfigCommand, input, isAutomatorCommand, isAutomatorLoginError, isAutomatorProtocolTimeoutError, isAutomatorWsConnectError, isDevtoolsExtensionContextInvalidatedError, isDevtoolsHttpPortError, isOperatingSystemSupported, isRetryableAutomatorLaunchError, isWeappIdeTopLevelCommand, isWechatIdeLoginRequiredError, launchAutomator, navigateBack, navigateTo, operatingSystemName, overwriteCustomConfig, pageData, pageStack, parse, parseAutomatorArgs, parseCompareArgs, parseScreenshotArgs, printCompareHelp, printScreenshotHelp, promptForCliPath, reLaunch, readCustomConfig, readOptionValue, redirectTo, releaseSharedMiniProgram, remote, removeCustomConfigKey, removeOption, resolveCliPath, resolvePath, runAutomatorCommand, runMinidev, runWechatCliWithRetry, scrollTo, startForwardConsole, switchTab, systemInfo, takeScreenshot, tap, transformArgv, validateWechatCliCommandArgs, waitForRetryKeypress, withMiniProgram };

package/dist/index.js

@@ -1,3 +1,3 @@
-import { A as createLocaleConfig, B as operatingSystemName, C as isAutomatorLoginError, D as getConfig, E as resolveCliPath, F as defaultCustomConfigFilePath, I as resolvePath, L as SupportedPlatformsMap, M as readCustomConfig, N as removeCustomConfigKey, O as getConfiguredLocale, P as defaultCustomConfigDirPath, R as getDefaultCliPath, S as formatAutomatorLoginError, T as launchAutomator, _ as connectMiniProgram, a as navigateBack, c as pageStack, d as remote, f as scrollTo, g as tap, h as takeScreenshot, i as input, j as overwriteCustomConfig, k as createCustomConfig, l as reLaunch, m as systemInfo, o as navigateTo, p as switchTab, r as currentPage, s as pageData, t as audit, u as redirectTo, v as withMiniProgram, w as isDevtoolsHttpPortError, z as isOperatingSystemSupported } from "./commands-CSbpftLN.js";
-import { A as parseAutomatorArgs, C as isWeappIdeTopLevelCommand, D as runAutomatorCommand, E as isAutomatorCommand, M as removeOption, O as parseScreenshotArgs, S as WECHAT_CLI_COMMAND_NAMES, T as getAutomatorCommandHelp, _ as handleConfigCommand, a as createWechatIdeLoginRequiredExitError, b as MINIDEV_NAMESPACE_COMMAND_NAMES, c as formatWechatIdeLoginRequiredError, d as runMinidev, f as execute, g as startForwardConsole, h as transformArgv, i as runWechatCliWithRetry, j as readOptionValue, k as printScreenshotHelp, l as isWechatIdeLoginRequiredError, m as createPathCompat, n as parse, o as extractExecutionErrorText, p as createAlias, r as validateWechatCliCommandArgs, s as formatRetryHotkeyPrompt, t as createCli, u as waitForRetryKeypress, v as promptForCliPath, w as AUTOMATOR_COMMAND_NAMES, x as WEAPP_IDE_TOP_LEVEL_COMMAND_NAMES, y as CONFIG_COMMAND_NAME } from "./cli-BZKq6t2k.js";
-export { AUTOMATOR_COMMAND_NAMES, CONFIG_COMMAND_NAME, MINIDEV_NAMESPACE_COMMAND_NAMES, SupportedPlatformsMap, WEAPP_IDE_TOP_LEVEL_COMMAND_NAMES, WECHAT_CLI_COMMAND_NAMES, audit, connectMiniProgram, createAlias, createCli, createCustomConfig, createLocaleConfig, createPathCompat, createWechatIdeLoginRequiredExitError, currentPage, defaultCustomConfigDirPath, defaultCustomConfigFilePath, execute, extractExecutionErrorText, formatAutomatorLoginError, formatRetryHotkeyPrompt, formatWechatIdeLoginRequiredError, getAutomatorCommandHelp, getConfig, getConfiguredLocale, getDefaultCliPath, handleConfigCommand, input, isAutomatorCommand, isAutomatorLoginError, isDevtoolsHttpPortError, isOperatingSystemSupported, isWeappIdeTopLevelCommand, isWechatIdeLoginRequiredError, launchAutomator, navigateBack, navigateTo, operatingSystemName, overwriteCustomConfig, pageData, pageStack, parse, parseAutomatorArgs, parseScreenshotArgs, printScreenshotHelp, promptForCliPath, reLaunch, readCustomConfig, readOptionValue, redirectTo, remote, removeCustomConfigKey, removeOption, resolveCliPath, resolvePath, runAutomatorCommand, runMinidev, runWechatCliWithRetry, scrollTo, startForwardConsole, switchTab, systemInfo, takeScreenshot, tap, transformArgv, validateWechatCliCommandArgs, waitForRetryKeypress, withMiniProgram };
+import { A as isAutomatorProtocolTimeoutError, B as createLocaleConfig, D as formatAutomatorLoginError, E as connectOpenedAutomator, F as launchAutomator, G as defaultCustomConfigFilePath, H as readCustomConfig, I as resolveCliPath, J as getDefaultCliPath, K as resolvePath, L as getConfig, M as isDevtoolsExtensionContextInvalidatedError, N as isDevtoolsHttpPortError, O as getAutomatorProtocolTimeoutMethod, P as isRetryableAutomatorLaunchError, R as getConfiguredLocale, S as withMiniProgram, U as removeCustomConfigKey, V as overwriteCustomConfig, W as defaultCustomConfigDirPath, X as operatingSystemName, Y as isOperatingSystemSupported, _ as acquireSharedMiniProgram, a as navigateBack, b as getSharedMiniProgramSessionCount, c as pageStack, d as remote, f as scrollTo, g as tap, h as takeScreenshot, i as input, j as isAutomatorWsConnectError, k as isAutomatorLoginError, l as reLaunch, m as systemInfo, n as captureScreenshotBuffer, o as navigateTo, p as switchTab, q as SupportedPlatformsMap, r as currentPage, s as pageData, t as audit, u as redirectTo, v as closeSharedMiniProgram, x as releaseSharedMiniProgram, y as connectMiniProgram, z as createCustomConfig } from "./commands--vppy2pX.js";
+import { A as parseCompareArgs, C as isWeappIdeTopLevelCommand, D as runAutomatorCommand, E as isAutomatorCommand, M as parseAutomatorArgs, N as readOptionValue, O as parseScreenshotArgs, P as removeOption, S as WECHAT_CLI_COMMAND_NAMES, T as getAutomatorCommandHelp, _ as handleConfigCommand, a as createWechatIdeLoginRequiredExitError, b as MINIDEV_NAMESPACE_COMMAND_NAMES, c as formatWechatIdeLoginRequiredError, d as runMinidev, f as execute, g as startForwardConsole, h as transformArgv, i as runWechatCliWithRetry, j as printCompareHelp, k as printScreenshotHelp, l as isWechatIdeLoginRequiredError, m as createPathCompat, n as parse, o as extractExecutionErrorText, p as createAlias, r as validateWechatCliCommandArgs, s as formatRetryHotkeyPrompt, t as createCli, u as waitForRetryKeypress, v as promptForCliPath, w as AUTOMATOR_COMMAND_NAMES, x as WEAPP_IDE_TOP_LEVEL_COMMAND_NAMES, y as CONFIG_COMMAND_NAME } from "./cli-DKrUhSmB.js";
+export { AUTOMATOR_COMMAND_NAMES, CONFIG_COMMAND_NAME, MINIDEV_NAMESPACE_COMMAND_NAMES, SupportedPlatformsMap, WEAPP_IDE_TOP_LEVEL_COMMAND_NAMES, WECHAT_CLI_COMMAND_NAMES, acquireSharedMiniProgram, audit, captureScreenshotBuffer, closeSharedMiniProgram, connectMiniProgram, connectOpenedAutomator, createAlias, createCli, createCustomConfig, createLocaleConfig, createPathCompat, createWechatIdeLoginRequiredExitError, currentPage, defaultCustomConfigDirPath, defaultCustomConfigFilePath, execute, extractExecutionErrorText, formatAutomatorLoginError, formatRetryHotkeyPrompt, formatWechatIdeLoginRequiredError, getAutomatorCommandHelp, getAutomatorProtocolTimeoutMethod, getConfig, getConfiguredLocale, getDefaultCliPath, getSharedMiniProgramSessionCount, handleConfigCommand, input, isAutomatorCommand, isAutomatorLoginError, isAutomatorProtocolTimeoutError, isAutomatorWsConnectError, isDevtoolsExtensionContextInvalidatedError, isDevtoolsHttpPortError, isOperatingSystemSupported, isRetryableAutomatorLaunchError, isWeappIdeTopLevelCommand, isWechatIdeLoginRequiredError, launchAutomator, navigateBack, navigateTo, operatingSystemName, overwriteCustomConfig, pageData, pageStack, parse, parseAutomatorArgs, parseCompareArgs, parseScreenshotArgs, printCompareHelp, printScreenshotHelp, promptForCliPath, reLaunch, readCustomConfig, readOptionValue, redirectTo, releaseSharedMiniProgram, remote, removeCustomConfigKey, removeOption, resolveCliPath, resolvePath, runAutomatorCommand, runMinidev, runWechatCliWithRetry, scrollTo, startForwardConsole, switchTab, systemInfo, takeScreenshot, tap, transformArgv, validateWechatCliCommandArgs, waitForRetryKeypress, withMiniProgram };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "weapp-ide-cli",
   "type": "module",
-  "version": "5.1.5",
+  "version": "5.2.1",
   "description": "让微信开发者工具，用起来更加方便！",
   "author": "ice breaker <1324318532@qq.com>",
   "license": "MIT",
@@ -64,10 +64,12 @@
   "dependencies": {
     "cac": "^7.0.0",
     "execa": "9.6.1",
-    "fs-extra": "^11.3.4",
     "pathe": "^2.0.3",
+    "pixelmatch": "^7.1.0",
+    "pngjs": "^7.0.0",
     "@weapp-core/logger": "^3.1.1",
-    "@weapp-vite/miniprogram-automator": "1.0.1"
+    "@weapp-core/shared": "^3.0.3",
+    "@weapp-vite/miniprogram-automator": "1.0.2"
   },
   "scripts": {
     "dev": "tsdown -w --sourcemap",