weapp-ide-cli 5.1.4 → 5.2.0

package/README.md

@@ -37,6 +37,8 @@ weapp open --project ./dist/dev/mp-weixin
 # 执行预览、上传等官方支持的命令
 weapp preview
 weapp upload --project ./dist/build/mp-weixin
+weapp cache --clean compile
+weapp cache --clean all
 ```
 
 `weapp` 与 `weapp-ide-cli` 等价，选择任一前缀即可。
@@ -92,6 +94,35 @@ weapp open --platform alipay -p ./dist/dev/mp-alipay
 
 - <https://developers.weixin.qq.com/miniprogram/dev/devtools/cli.html>
 
+其中 `weapp cloud` 为云开发命令族入口，可继续透传官方子命令，例如：
+
+```bash
+weapp cloud env list
+weapp cloud functions list
+weapp cloud functions info --name hello
+weapp cloud functions deploy --name hello
+weapp cloud functions inc-deploy --name hello
+weapp cloud functions download --name hello
+```
+
+缓存清理示例：
+
+```bash
+weapp cache --clean compile
+weapp cache --clean network
+weapp cache --clean all
+```
+
+支持的缓存类型：
+
+- `storage`
+- `file`
+- `compile`
+- `auth`
+- `network`
+- `session`
+- `all`
+
 ### 2. automator 增强命令
 
 `weapp-ide-cli` 内置 automator 子命令：
@@ -99,6 +130,7 @@ weapp open --platform alipay -p ./dist/dev/mp-alipay
 | 命令                             | 说明                           |
 | -------------------------------- | ------------------------------ |
 | `weapp screenshot`               | 截图（支持 base64 / 文件输出） |
+| `weapp compare`                  | 截图对比（pixelmatch）         |
 | `weapp navigate <url>`           | 保留栈跳转页面                 |
 | `weapp redirect <url>`           | 重定向页面                     |
 | `weapp back`                     | 页面返回                       |

package/dist/{cli-BkQJ3Aww.js → cli-DXJCUYYI.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 { A as createCustomConfig, B as isOperatingSystemSupported, D as resolveCliPath, H as colors, I as defaultCustomConfigFilePath, L as resolvePath, M as overwriteCustomConfig, N as readCustomConfig, P as removeCustomConfigKey, S as validateLocaleOption, U as logger_default, V as operatingSystemName, _ as tap, a as input, b as configureLocaleFromArgv, c as pageData, d as redirectTo, f as remote, h as systemInfo, i as currentPage, j as createLocaleConfig, k as getConfiguredLocale, l as pageStack, m as switchTab, n as captureScreenshotBuffer, o as navigateBack, p as scrollTo, s as navigateTo, t as audit, u as reLaunch, v as connectMiniProgram, x as i18nText } from "./commands-BfdE1eYN.js";
+import { fs } from "@weapp-core/shared";
 import process, { stdin, stdout } from "node:process";
+import fs$1 from "node:fs/promises";
+import pixelmatch from "pixelmatch";
+import { PNG } from "pngjs";
 import { createInterface } from "node:readline/promises";
 import { inspect } from "node:util";
 import { emitKeypressEvents } from "node:readline";
@@ -105,6 +108,204 @@ 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$1.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$1.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$1.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>              对比前先跳转页面
+      --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 --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
+      --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 --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"),
+		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
@@ -182,7 +383,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-BfdE1eYN.js").then((n) => n.r);
 	const result = await takeScreenshot(options);
 	if (isJsonOutput) {
 		console.log(JSON.stringify(result, null, 2));
@@ -461,7 +662,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 +705,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")) {
@@ -1108,6 +1317,36 @@ function flushExecutionOutput(result) {
 }
 //#endregion
 //#region src/cli/wechat-command-schema.ts
+const CACHE_CLEAN_TYPES = [
+	"storage",
+	"file",
+	"compile",
+	"auth",
+	"network",
+	"session",
+	"all"
+];
+function isNonEmptyText(value) {
+	return typeof value === "string" && value.trim().length > 0;
+}
+function validatePortOption(argv) {
+	const port = readOptionValue(argv, "--port");
+	if (!port) return;
+	const parsed = Number.parseInt(port, 10);
+	if (!Number.isFinite(parsed) || parsed <= 0) throw new Error(i18nText(`无效的 --port 值: ${port}（必须为正整数）`, `Invalid --port value: ${port} (must be a positive integer)`));
+}
+function validateProjectLocator(command, argv) {
+	const projectPath = readOptionValue(argv, "--project");
+	const appid = readOptionValue(argv, "--appid");
+	if (isNonEmptyText(projectPath) || isNonEmptyText(appid)) return;
+	throw new Error(i18nText(`${command} 命令需要提供 --project 或 --appid`, `${command} command requires --project or --appid`));
+}
+function validateExtAppidDependency(argv) {
+	if (!isNonEmptyText(readOptionValue(argv, "--ext-appid"))) return;
+	if (isNonEmptyText(readOptionValue(argv, "--project"))) return;
+	if (isNonEmptyText(readOptionValue(argv, "--appid"))) return;
+	throw new Error(i18nText("--ext-appid 需要和 --appid 一起使用（当未提供 --project 时）", "--ext-appid requires --appid when --project is not provided"));
+}
 /**
 * @description 在调用官方微信 CLI 前做轻量参数校验。
 */
@@ -1131,29 +1370,13 @@ function validateWechatCliCommandArgs(argv) {
 			"base64"
 		].includes(qrFormat.toLowerCase())) throw new Error(i18nText(`preview 命令的二维码格式无效: ${qrFormat}（仅支持 terminal/image/base64）`, `Invalid preview qr format: ${qrFormat} (supported: terminal/image/base64)`));
 	}
+	if (command === "cache") {
+		const cleanType = readOptionValue(argv, "--clean") || readOptionValue(argv, "-c");
+		if (!isNonEmptyText(cleanType)) throw new Error(i18nText("cache 命令缺少必填参数：--clean/-c", "cache command requires --clean/-c"));
+		if (!CACHE_CLEAN_TYPES.includes(cleanType)) throw new Error(i18nText(`cache 命令的清理类型无效: ${cleanType}（仅支持 ${CACHE_CLEAN_TYPES.join("/")}）`, `Invalid cache clean type: ${cleanType} (supported: ${CACHE_CLEAN_TYPES.join("/")})`));
+	}
 	if (command === "upload" || command === "auto" || command === "auto-preview") validateProjectLocator(command, argv);
 }
-function validatePortOption(argv) {
-	const port = readOptionValue(argv, "--port");
-	if (!port) return;
-	const parsed = Number.parseInt(port, 10);
-	if (!Number.isFinite(parsed) || parsed <= 0) throw new Error(i18nText(`无效的 --port 值: ${port}（必须为正整数）`, `Invalid --port value: ${port} (must be a positive integer)`));
-}
-function validateProjectLocator(command, argv) {
-	const projectPath = readOptionValue(argv, "--project");
-	const appid = readOptionValue(argv, "--appid");
-	if (isNonEmptyText(projectPath) || isNonEmptyText(appid)) return;
-	throw new Error(i18nText(`${command} 命令需要提供 --project 或 --appid`, `${command} command requires --project or --appid`));
-}
-function validateExtAppidDependency(argv) {
-	if (!isNonEmptyText(readOptionValue(argv, "--ext-appid"))) return;
-	if (isNonEmptyText(readOptionValue(argv, "--project"))) return;
-	if (isNonEmptyText(readOptionValue(argv, "--appid"))) return;
-	throw new Error(i18nText("--ext-appid 需要和 --appid 一起使用（当未提供 --project 时）", "--ext-appid requires --appid when --project is not provided"));
-}
-function isNonEmptyText(value) {
-	return typeof value === "string" && value.trim().length > 0;
-}
 //#endregion
 //#region src/cli/run.ts
 const MINIDEV_NAMESPACE = new Set(MINIDEV_NAMESPACE_COMMAND_NAMES);
@@ -1179,23 +1402,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) {
@@ -1208,6 +1415,10 @@ async function handleHelpCommand(args) {
 		printScreenshotHelp();
 		return;
 	}
+	if (targetCommand === "compare") {
+		printCompareHelp();
+		return;
+	}
 	if (isAutomatorCommand(targetCommand)) {
 		const help = getAutomatorCommandHelp(targetCommand);
 		if (help) {
@@ -1286,4 +1497,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,5 +1,5 @@
-import { H as logger_default } from "./commands-CSbpftLN.js";
-import { n as parse } from "./cli-BkQJ3Aww.js";
+import { U as logger_default } from "./commands-BfdE1eYN.js";
+import { n as parse } from "./cli-DXJCUYYI.js";
 import process from "node:process";
 //#region src/cli.ts
 parse(process.argv.slice(2)).catch((err) => {

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

@@ -1,5 +1,5 @@
 import { Launcher } from "@weapp-vite/miniprogram-automator";
-import fs from "fs-extra";
+import { fs } from "@weapp-core/shared";
 import logger, { colors } from "@weapp-core/logger";
 import os from "node:os";
 import process from "node:process";
@@ -41,6 +41,18 @@ function isOperatingSystemSupported(osName = os.type()) {
 * @description 当前系统名称
 */
 const operatingSystemName = os.type();
+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;
+		}
+	}
+}
 function createLinuxCliResolver() {
 	let resolvedPath;
 	let attempted = false;
@@ -78,18 +90,6 @@ 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
 /**
@@ -116,6 +116,28 @@ const JSON_OPTIONS = {
 	encoding: "utf8",
 	spaces: 2
 };
+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);
+}
 /**
 * @description 写入自定义 CLI 路径配置
 */
@@ -152,31 +174,6 @@ 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
 /**
@@ -431,6 +428,7 @@ async function withMiniProgram(options, runner) {
 //#region src/cli/commands.ts
 var commands_exports = /* @__PURE__ */ __exportAll({
 	audit: () => audit,
+	captureScreenshotBuffer: () => captureScreenshotBuffer,
 	currentPage: () => currentPage,
 	input: () => input,
 	navigateBack: () => navigateBack,
@@ -592,9 +590,9 @@ 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)}...`));
 		if (options.page) {
@@ -603,17 +601,25 @@ async function takeScreenshot(options) {
 		}
 		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 };
-		}
-		return { base64 };
+		const buffer = typeof screenshot === "string" ? Buffer$1.from(screenshot, "base64") : Buffer$1.from(screenshot);
+		if (buffer.length === 0) throw new Error(i18nText("截图失败", "Failed to capture screenshot"));
+		return buffer;
 	});
 }
 /**
+* @description 获取当前小程序截图。
+*/
+async function takeScreenshot(options) {
+	const screenshotBuffer = await captureScreenshotBuffer(options);
+	const base64 = screenshotBuffer.toString("base64");
+	if (options.outputPath) {
+		await fs$1.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 +631,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 { createCustomConfig as A, isOperatingSystemSupported as B, formatAutomatorLoginError as C, resolveCliPath as D, launchAutomator as E, defaultCustomConfigDirPath as F, colors as H, defaultCustomConfigFilePath as I, resolvePath as L, overwriteCustomConfig as M, readCustomConfig as N, getConfig as O, removeCustomConfigKey as P, SupportedPlatformsMap as R, validateLocaleOption as S, isDevtoolsHttpPortError as T, logger_default as U, operatingSystemName as V, tap as _, input as a, configureLocaleFromArgv as b, pageData as c, redirectTo as d, remote as f, takeScreenshot as g, systemInfo as h, currentPage as i, createLocaleConfig as j, getConfiguredLocale as k, pageStack as l, switchTab as m, captureScreenshotBuffer as n, navigateBack as o, scrollTo as p, commands_exports as r, navigateTo as s, audit as t, reLaunch as u, connectMiniProgram as v, isAutomatorLoginError as w, i18nText as x, withMiniProgram as y, getDefaultCliPath as z };

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { Element, MiniProgram, Page } from "@weapp-vite/miniprogram-automator";
+import { Buffer } from "node:buffer";
 import * as cac$1 from "cac";
 import * as execa from "execa";
 
@@ -169,6 +170,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 +183,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 +361,7 @@ interface CustomConfigFile {
   cliPath?: string;
   locale?: 'zh' | 'en';
 }
+declare function readCustomConfig(): Promise<CustomConfigFile>;
 /**
  * @description 写入自定义 CLI 路径配置
  */
@@ -354,10 +378,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 +460,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, audit, captureScreenshotBuffer, 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, parseCompareArgs, parseScreenshotArgs, printCompareHelp, printScreenshotHelp, promptForCliPath, reLaunch, readCustomConfig, readOptionValue, redirectTo, 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-BkQJ3Aww.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 createCustomConfig, B as isOperatingSystemSupported, C as formatAutomatorLoginError, D as resolveCliPath, E as launchAutomator, F as defaultCustomConfigDirPath, I as defaultCustomConfigFilePath, L as resolvePath, M as overwriteCustomConfig, N as readCustomConfig, O as getConfig, P as removeCustomConfigKey, R as SupportedPlatformsMap, T as isDevtoolsHttpPortError, V as operatingSystemName, _ as tap, a as input, c as pageData, d as redirectTo, f as remote, g as takeScreenshot, h as systemInfo, i as currentPage, j as createLocaleConfig, k as getConfiguredLocale, l as pageStack, m as switchTab, n as captureScreenshotBuffer, o as navigateBack, p as scrollTo, s as navigateTo, t as audit, u as reLaunch, v as connectMiniProgram, w as isAutomatorLoginError, y as withMiniProgram, z as getDefaultCliPath } from "./commands-BfdE1eYN.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-DXJCUYYI.js";
+export { AUTOMATOR_COMMAND_NAMES, CONFIG_COMMAND_NAME, MINIDEV_NAMESPACE_COMMAND_NAMES, SupportedPlatformsMap, WEAPP_IDE_TOP_LEVEL_COMMAND_NAMES, WECHAT_CLI_COMMAND_NAMES, audit, captureScreenshotBuffer, 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, parseCompareArgs, parseScreenshotArgs, printCompareHelp, printScreenshotHelp, promptForCliPath, reLaunch, readCustomConfig, readOptionValue, redirectTo, 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.4",
+  "version": "5.2.0",
   "description": "让微信开发者工具，用起来更加方便！",
   "author": "ice breaker <1324318532@qq.com>",
   "license": "MIT",
@@ -64,9 +64,11 @@
   "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-core/shared": "^3.0.3",
     "@weapp-vite/miniprogram-automator": "1.0.1"
   },
   "scripts": {