weapp-ide-cli 6.1.9 → 6.3.0

package/dist/cli.js

@@ -1,12 +1,12 @@
-import { Z as logger_default } from "./automator-session-fbanL2eW.js";
-import { n as parse } from "./cli-2sY1sAVq.js";
+import { M as logger } from "./automatorProject-DjYLqMj6.js";
+import { n as parse } from "./cli-CFlqFpIw.js";
 import process from "node:process";
 //#region src/cli.ts
 const argv = process.argv.slice(2);
 try {
 	await parse(argv);
 } catch (err) {
-	logger_default.error(err);
+	logger.error(err);
 	if (typeof err?.exitCode === "number") process.exitCode = err.exitCode;
 	else if (typeof err?.code === "number") process.exitCode = err.code;
 	else process.exitCode = 1;

package/dist/commands-DmirGBy4.js

@@ -0,0 +1 @@
+export { h as takeScreenshot } from "./commands-mslf7-sP.js";

package/dist/commands-mslf7-sP.js

@@ -0,0 +1,529 @@
+import { M as logger, j as colors } from "./automatorProject-DjYLqMj6.js";
+import { M as i18nText } from "./automator-BOe32upt.js";
+import { l as withMiniProgram } from "./automator-session-VOB03glx.js";
+import path from "node:path";
+import fs from "node:fs/promises";
+import { Buffer } from "node:buffer";
+import { PNG } from "pngjs";
+//#region src/cli/fullPageScreenshot.ts
+const MAX_FULL_PAGE_CAPTURES = 200;
+const DEVTOOLS_INSPECTEE_REFERENCE_ERROR = /__inspectee__ is not defined|Can't find variable:\s*__inspectee__/i;
+function decodeScreenshotBuffer(raw) {
+	if (raw === void 0) throw new Error("Failed to capture screenshot");
+	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 isDevtoolsInspecteeReferenceError(error) {
+	const message = error instanceof Error ? error.message : String(error);
+	return DEVTOOLS_INSPECTEE_REFERENCE_ERROR.test(message);
+}
+async function captureViewportScreenshotBuffer(miniProgram, timeoutMs, runWithTimeout, screenshotTimeoutMessage) {
+	return decodeScreenshotBuffer(await runWithTimeout(miniProgram.screenshot({ timeout: timeoutMs }), timeoutMs, screenshotTimeoutMessage, "DEVTOOLS_SCREENSHOT_TIMEOUT"));
+}
+function resolveScale(pageWidth, viewportHeight, png) {
+	if (pageWidth && pageWidth > 0) return png.width / pageWidth;
+	return png.height / viewportHeight;
+}
+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;
+		cropped.data.set(source.data.subarray(sourceStart, sourceEnd), row * bytesPerRow);
+	}
+	return cropped;
+}
+function areRowsVisuallyEqual(first, second, firstRow, secondRow) {
+	const tolerance = 6;
+	const requiredEqualRatio = .98;
+	let equalPixels = 0;
+	for (let column = 0; column < first.width; column += 1) {
+		const firstIndex = (firstRow * first.width + column) * 4;
+		const secondIndex = (secondRow * second.width + column) * 4;
+		if (Math.abs(first.data[firstIndex] - second.data[secondIndex]) <= tolerance && Math.abs(first.data[firstIndex + 1] - second.data[secondIndex + 1]) <= tolerance && Math.abs(first.data[firstIndex + 2] - second.data[secondIndex + 2]) <= tolerance && Math.abs(first.data[firstIndex + 3] - second.data[secondIndex + 3]) <= tolerance) equalPixels += 1;
+	}
+	return equalPixels / first.width >= requiredEqualRatio;
+}
+function detectFixedBottomRows(first, second, scale) {
+	if (first.width !== second.width || first.height !== second.height) return 0;
+	const maxFixedRows = Math.floor(first.height * .45);
+	const minFixedRows = Math.max(8, Math.round(8 * scale));
+	let fixedRows = 0;
+	for (let offset = 0; offset < maxFixedRows; offset += 1) {
+		if (!areRowsVisuallyEqual(first, second, first.height - 1 - offset, second.height - 1 - offset)) break;
+		fixedRows += 1;
+	}
+	return fixedRows >= minFixedRows ? fixedRows : 0;
+}
+async function restoreScrollPosition(miniProgram, page, scrollTop) {
+	try {
+		await miniProgram.pageScrollTo(scrollTop);
+		await page.waitFor(150);
+	} catch (error) {
+		if (!isDevtoolsInspecteeReferenceError(error)) throw error;
+	}
+}
+async function readRuntimeViewportMetrics(miniProgram) {
+	if (typeof miniProgram.evaluate !== "function") return;
+	const metrics = await miniProgram.evaluate(() => {
+		const wxLike = typeof wx === "undefined" ? void 0 : wx;
+		const systemInfo = wxLike?.getWindowInfo?.() ?? wxLike?.getSystemInfoSync?.();
+		return new Promise((resolve) => {
+			if (!wxLike?.createSelectorQuery) {
+				resolve({
+					pageHeight: void 0,
+					pageWidth: systemInfo?.windowWidth,
+					scrollTop: void 0,
+					viewportHeight: systemInfo?.windowHeight
+				});
+				return;
+			}
+			wxLike.createSelectorQuery().selectViewport().scrollOffset((viewport) => {
+				resolve({
+					pageHeight: viewport?.scrollHeight,
+					pageWidth: viewport?.scrollWidth ?? systemInfo?.windowWidth,
+					scrollTop: viewport?.scrollTop,
+					viewportHeight: systemInfo?.windowHeight
+				});
+			}).exec();
+		});
+	}).catch(() => void 0);
+	if (!metrics || typeof metrics !== "object") return;
+	const raw = metrics;
+	return {
+		pageHeight: toPositiveNumber(raw.pageHeight),
+		pageWidth: toPositiveNumber(raw.pageWidth),
+		scrollTop: typeof raw.scrollTop === "number" && Number.isFinite(raw.scrollTop) ? Math.max(raw.scrollTop, 0) : void 0,
+		viewportHeight: toPositiveNumber(raw.viewportHeight)
+	};
+}
+async function readPageSize(page) {
+	return await page.size().catch(() => null);
+}
+async function readScrollTop(miniProgram, page) {
+	const runtimeMetrics = await readRuntimeViewportMetrics(miniProgram);
+	if (runtimeMetrics?.scrollTop !== void 0) return runtimeMetrics.scrollTop;
+	return typeof page.scrollTop === "function" ? toPositiveNumber(await page.scrollTop().catch(() => void 0)) ?? 0 : 0;
+}
+async function captureScrolledPng(miniProgram, page, scrollTop, timeoutMs, runWithTimeout, screenshotTimeoutMessage) {
+	await miniProgram.pageScrollTo(scrollTop);
+	await page.waitFor(150);
+	const rawScreenshot = await runWithTimeout(miniProgram.screenshot({ timeout: timeoutMs }), timeoutMs, screenshotTimeoutMessage, "DEVTOOLS_SCREENSHOT_TIMEOUT");
+	const runtimeMetrics = await readRuntimeViewportMetrics(miniProgram);
+	const actualScrollTop = runtimeMetrics?.scrollTop ?? (typeof page.scrollTop === "function" ? toPositiveNumber(await page.scrollTop().catch(() => void 0)) ?? scrollTop : scrollTop);
+	const pageSize = runtimeMetrics?.pageHeight ? void 0 : await readPageSize(page);
+	return {
+		pageHeight: runtimeMetrics?.pageHeight ?? toPositiveNumber(pageSize?.height),
+		png: PNG.sync.read(decodeScreenshotBuffer(rawScreenshot)),
+		scrollTop: actualScrollTop
+	};
+}
+/**
+* @description 通过多次滚动和拼接生成整页长截图。
+*/
+async function captureFullPageScreenshotBuffer(options) {
+	const { miniProgram, timeoutMs, runWithTimeout, screenshotTimeoutMessage } = options;
+	const page = await miniProgram.currentPage();
+	const runtimeMetrics = await readRuntimeViewportMetrics(miniProgram);
+	const pageSize = runtimeMetrics?.pageHeight && runtimeMetrics.pageWidth ? void 0 : await readPageSize(page);
+	const systemInfo = runtimeMetrics?.viewportHeight ? void 0 : await miniProgram.systemInfo().catch((error) => {
+		if (isDevtoolsInspecteeReferenceError(error)) return;
+		throw error;
+	});
+	const initialScrollTop = runtimeMetrics?.scrollTop ?? await readScrollTop(miniProgram, page);
+	const pageWidth = runtimeMetrics?.pageWidth ?? toPositiveNumber(pageSize?.width);
+	const pageHeight = runtimeMetrics?.pageHeight ?? toPositiveNumber(pageSize?.height);
+	const viewportHeight = runtimeMetrics?.viewportHeight ?? toPositiveNumber(systemInfo?.windowHeight);
+	if (!pageHeight || !viewportHeight) return await captureViewportScreenshotBuffer(miniProgram, timeoutMs, runWithTimeout, screenshotTimeoutMessage);
+	const segments = [];
+	const capturesByRequestedScrollTop = /* @__PURE__ */ new Map();
+	let coveredUntil = 0;
+	let scale = 1;
+	let fixedBottomRows = 0;
+	let contentViewportHeight = viewportHeight;
+	let latestPageHeight = pageHeight;
+	try {
+		const firstCapture = await captureScrolledPng(miniProgram, page, 0, timeoutMs, runWithTimeout, screenshotTimeoutMessage);
+		const firstPng = firstCapture.png;
+		capturesByRequestedScrollTop.set(0, firstCapture);
+		scale = resolveScale(pageWidth, viewportHeight, firstPng);
+		latestPageHeight = firstCapture.pageHeight ?? latestPageHeight;
+		if (pageHeight > viewportHeight) {
+			const probeScrollTop = Math.min(viewportHeight, Math.max(pageHeight - viewportHeight, 1));
+			const probeCapture = await captureScrolledPng(miniProgram, page, probeScrollTop, timeoutMs, runWithTimeout, screenshotTimeoutMessage);
+			const probePng = probeCapture.png;
+			capturesByRequestedScrollTop.set(probeScrollTop, probeCapture);
+			latestPageHeight = probeCapture.pageHeight ?? latestPageHeight;
+			fixedBottomRows = detectFixedBottomRows(firstPng, probePng, scale);
+			if (fixedBottomRows > 0) {
+				const screenshotCssHeight = firstPng.height / scale;
+				const fixedBottomCss = fixedBottomRows / scale;
+				const fixedRowsOutsideViewportCss = Math.max(screenshotCssHeight - viewportHeight, 0);
+				const fixedRowsInsideViewportCss = Math.max(fixedBottomCss - fixedRowsOutsideViewportCss, 0);
+				contentViewportHeight = Math.max(1, viewportHeight - fixedRowsInsideViewportCss);
+			}
+		}
+		let requestedScrollTop = 0;
+		for (let captureIndex = 0; captureIndex < MAX_FULL_PAGE_CAPTURES; captureIndex += 1) {
+			const capture = capturesByRequestedScrollTop.get(requestedScrollTop) ?? await captureScrolledPng(miniProgram, page, requestedScrollTop, timeoutMs, runWithTimeout, screenshotTimeoutMessage);
+			capturesByRequestedScrollTop.set(requestedScrollTop, capture);
+			const { png, scrollTop } = capture;
+			latestPageHeight = capture.pageHeight ?? latestPageHeight;
+			const visibleEnd = Math.min(scrollTop + contentViewportHeight, latestPageHeight);
+			const cropTopCss = Math.max(coveredUntil - scrollTop, 0);
+			const segmentHeightCss = Math.max(visibleEnd - scrollTop - cropTopCss, 0);
+			const isAtBottom = visibleEnd >= latestPageHeight - 1;
+			if (segmentHeightCss > 0) {
+				const contentRows = Math.max(png.height - fixedBottomRows, 1);
+				const cropTopRows = Math.min(Math.max(Math.round(cropTopCss * scale), 0), contentRows);
+				const segmentRows = Math.min(Math.max(Math.round(segmentHeightCss * scale), 1), contentRows - cropTopRows);
+				if (segmentRows > 0) segments.push(cropPngRows(png, cropTopRows, segmentRows));
+			}
+			coveredUntil = Math.max(coveredUntil, visibleEnd);
+			if (isAtBottom) {
+				if (fixedBottomRows > 0) segments.push(cropPngRows(png, png.height - fixedBottomRows, fixedBottomRows));
+				break;
+			}
+			if (visibleEnd <= scrollTop || coveredUntil <= requestedScrollTop) {
+				if (fixedBottomRows > 0) segments.push(cropPngRows(png, png.height - fixedBottomRows, fixedBottomRows));
+				break;
+			}
+			requestedScrollTop = coveredUntil;
+		}
+	} catch (error) {
+		if (!isDevtoolsInspecteeReferenceError(error)) throw error;
+		return await captureViewportScreenshotBuffer(miniProgram, timeoutMs, runWithTimeout, screenshotTimeoutMessage);
+	} finally {
+		await restoreScrollPosition(miniProgram, page, initialScrollTop);
+	}
+	if (segments.length === 0) throw new Error("Failed to capture screenshot");
+	const width = segments[0].width;
+	const height = segments.reduce((sum, segment) => sum + segment.height, 0);
+	const merged = new PNG({
+		width,
+		height
+	});
+	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;
+			merged.data.set(segment.data.subarray(sourceStart, sourceEnd), (offsetY + row) * bytesPerRow);
+		}
+		offsetY += segment.height;
+	}
+	return PNG.sync.write(merged);
+}
+//#endregion
+//#region src/cli/commands.ts
+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);
+		});
+	});
+}
+function createCurrentPageTimeoutMessage(commandTimeout) {
+	return i18nText(`当前页面请求在 ${commandTimeout}ms 内未收到 DevTools 回包，请确认当前打开的是目标项目；若之前跑过其他 e2e / screenshot 任务，关闭多余的微信开发者工具窗口，或结束残留的 \`wechatwebdevtools cli auto --project ...\` 进程后重试。`, `Current page request did not receive a DevTools response within ${commandTimeout}ms. Please confirm the current DevTools window is the target project. If you recently ran other e2e / screenshot tasks, close extra windows or stop stale \`wechatwebdevtools cli auto --project ...\` processes and retry.`);
+}
+function isDevtoolsProtocolTimeoutError(error) {
+	if (!(error instanceof Error)) return false;
+	return error.message === "DEVTOOLS_PROTOCOL_TIMEOUT" || error.message.includes("DevTools did not respond to protocol method") || Reflect.get(error, "code") === "DEVTOOLS_PROTOCOL_TIMEOUT";
+}
+function isPageStackStaleError(error) {
+	return error instanceof Error && error.message.includes("page is not on top of page stack");
+}
+function isScreenshotNavigationTimeoutError(error) {
+	return error instanceof Error && Reflect.get(error, "code") === "DEVTOOLS_SCREENSHOT_NAVIGATION_TIMEOUT";
+}
+function isScreenshotRequestTimeoutError(error) {
+	if (!(error instanceof Error)) return false;
+	return error.message === "DEVTOOLS_SCREENSHOT_TIMEOUT" || Reflect.get(error, "code") === "DEVTOOLS_SCREENSHOT_TIMEOUT";
+}
+function toScreenshotBuffer(screenshot) {
+	if (screenshot === void 0) return Buffer.alloc(0);
+	return typeof screenshot === "string" ? Buffer.from(screenshot, "base64") : Buffer.from(screenshot);
+}
+async function reLaunchForScreenshot(miniProgram, page) {
+	const routeOptions = { url: page };
+	if (typeof miniProgram.callWxMethod === "function") await miniProgram.callWxMethod("reLaunch", routeOptions);
+	else await miniProgram.reLaunch(page);
+}
+async function runRouteCommand(options, startMessage, successMessage, action) {
+	await withMiniProgram(options, async (miniProgram) => {
+		logger.info(startMessage);
+		await action(miniProgram);
+		logger.success(successMessage);
+	});
+}
+function toPageSnapshot(page) {
+	return {
+		path: page.path ?? "",
+		query: page.query
+	};
+}
+function printStructuredResult(result, json, title) {
+	if (json) {
+		console.log(JSON.stringify(result, null, 2));
+		return;
+	}
+	logger.info(title);
+	console.log(JSON.stringify(result, null, 2));
+}
+async function requireElement(page, selector, timeoutMs = 5e3) {
+	const startedAt = Date.now();
+	let lastError;
+	while (Date.now() - startedAt <= timeoutMs) {
+		try {
+			const element = await page.$(selector, { fallback: false });
+			if (element) return element;
+		} catch (error) {
+			lastError = error;
+		}
+		await sleep(160);
+	}
+	const reason = lastError instanceof Error ? ` ${lastError.message}` : "";
+	throw new Error(i18nText(`未找到元素: ${selector}${reason}`, `Element not found: ${selector}${reason}`));
+}
+/**
+* @description 执行保留栈页面跳转。
+*/
+async function navigateTo(options) {
+	await runRouteCommand(options, i18nText(`正在跳转到 ${colors.cyan(options.url)}...`, `Navigating to ${colors.cyan(options.url)}...`), i18nText(`已跳转到 ${colors.cyan(options.url)}`, `Navigated to ${colors.cyan(options.url)}`), (miniProgram) => miniProgram.navigateTo(options.url));
+}
+/**
+* @description 执行关闭当前页的重定向。
+*/
+async function redirectTo(options) {
+	await runRouteCommand(options, i18nText(`正在重定向到 ${colors.cyan(options.url)}...`, `Redirecting to ${colors.cyan(options.url)}...`), i18nText(`已重定向到 ${colors.cyan(options.url)}`, `Redirected to ${colors.cyan(options.url)}`), (miniProgram) => miniProgram.redirectTo(options.url));
+}
+/**
+* @description 返回上一页。
+*/
+async function navigateBack(options) {
+	await runRouteCommand(options, i18nText("正在返回上一页...", "Navigating back..."), i18nText("已返回上一页", "Navigated back"), (miniProgram) => miniProgram.navigateBack());
+}
+/**
+* @description 重启到指定页面。
+*/
+async function reLaunch(options) {
+	await runRouteCommand(options, i18nText(`正在重启到 ${colors.cyan(options.url)}...`, `Relaunching to ${colors.cyan(options.url)}...`), i18nText(`已重启到 ${colors.cyan(options.url)}`, `Relaunched to ${colors.cyan(options.url)}`), (miniProgram) => miniProgram.reLaunch(options.url));
+}
+/**
+* @description 切换到 tabBar 页面。
+*/
+async function switchTab(options) {
+	await runRouteCommand(options, i18nText(`正在切换 tab 到 ${colors.cyan(options.url)}...`, `Switching tab to ${colors.cyan(options.url)}...`), i18nText(`已切换 tab 到 ${colors.cyan(options.url)}`, `Switched tab to ${colors.cyan(options.url)}`), (miniProgram) => miniProgram.switchTab(options.url));
+}
+/**
+* @description 获取页面栈。
+*/
+async function pageStack(options) {
+	return await withMiniProgram(options, async (miniProgram) => {
+		const result = (await miniProgram.pageStack()).map(toPageSnapshot);
+		printStructuredResult(result, options.json, i18nText("页面栈：", "Page stack:"));
+		return result;
+	});
+}
+/**
+* @description 获取当前页面信息。
+*/
+async function currentPage(options) {
+	return await withMiniProgram(options, async (miniProgram) => {
+		const commandTimeout = options.timeout ?? 3e4;
+		const result = toPageSnapshot(await withCommandTimeout(miniProgram.currentPage(), commandTimeout, createCurrentPageTimeoutMessage(commandTimeout), "DEVTOOLS_PROTOCOL_TIMEOUT"));
+		if (options.json) console.log(JSON.stringify(result, null, 2));
+		else logger.info(i18nText(`当前页面: ${result.path}${result.query ? ` ${JSON.stringify(result.query)}` : ""}`, `Current page: ${result.path}${result.query ? ` ${JSON.stringify(result.query)}` : ""}`));
+		return result;
+	});
+}
+/**
+* @description 获取系统信息。
+*/
+async function systemInfo(options) {
+	return await withMiniProgram(options, async (miniProgram) => {
+		const result = await miniProgram.systemInfo();
+		printStructuredResult(result, options.json, i18nText("系统信息：", "System info:"));
+		return result;
+	});
+}
+/**
+* @description 获取当前页面数据。
+*/
+async function pageData(options) {
+	return await withMiniProgram(options, async (miniProgram) => {
+		const result = await (await miniProgram.currentPage()).data(options.path);
+		printStructuredResult(result, options.json, i18nText("页面数据：", "Page data:"));
+		return result;
+	});
+}
+/**
+* @description 点击页面元素。
+*/
+async function tap(options) {
+	await withMiniProgram(options, async (miniProgram) => {
+		logger.info(i18nText(`正在点击元素 ${colors.cyan(options.selector)}...`, `Tapping element ${colors.cyan(options.selector)}...`));
+		const commandTimeout = options.timeout ?? 3e4;
+		const tapCurrentPageElement = async () => {
+			await (await requireElement(await miniProgram.currentPage(), options.selector, commandTimeout)).tap();
+		};
+		try {
+			await tapCurrentPageElement();
+		} catch (error) {
+			if (!isPageStackStaleError(error)) throw error;
+			logger.info(i18nText("页面栈已切换，正在重新获取顶部页面并重试点击...", "Page stack changed. Refreshing the top page and retrying the tap..."));
+			await tapCurrentPageElement();
+		}
+		logger.success(i18nText(`已点击元素 ${colors.cyan(options.selector)}`, `Tapped element ${colors.cyan(options.selector)}`));
+	});
+}
+/**
+* @description 向页面元素输入文本。
+*/
+async function input(options) {
+	await withMiniProgram(options, async (miniProgram) => {
+		logger.info(i18nText(`正在向 ${colors.cyan(options.selector)} 输入 "${colors.cyan(options.value)}"...`, `Inputting "${colors.cyan(options.value)}" into ${colors.cyan(options.selector)}...`));
+		const commandTimeout = options.timeout ?? 3e4;
+		const element = await requireElement(await miniProgram.currentPage(), options.selector, commandTimeout);
+		if (typeof element.input !== "function") throw new TypeError(i18nText(`元素不支持输入: ${options.selector}`, `Element does not support input: ${options.selector}`));
+		await element.input(options.value);
+		logger.success(i18nText(`已向 ${colors.cyan(options.selector)} 输入 "${colors.cyan(options.value)}"`, `Inputted "${colors.cyan(options.value)}" into ${colors.cyan(options.selector)}`));
+	});
+}
+/**
+* @description 滚动页面到指定位置。
+*/
+async function scrollTo(options) {
+	await withMiniProgram(options, async (miniProgram) => {
+		logger.info(i18nText(`正在滚动到位置 ${colors.cyan(String(options.scrollTop))}...`, `Scrolling to position ${colors.cyan(String(options.scrollTop))}...`));
+		await miniProgram.pageScrollTo(options.scrollTop);
+		logger.success(i18nText(`已滚动到位置 ${colors.cyan(String(options.scrollTop))}`, `Scrolled to position ${colors.cyan(String(options.scrollTop))}`));
+	});
+}
+/**
+* @description 执行体验评分审计。
+*/
+async function audit(options) {
+	return await withMiniProgram(options, async (miniProgram) => {
+		logger.info(i18nText("正在执行体验审计...", "Running experience audit..."));
+		const result = await miniProgram.stopAudits();
+		if (options.outputPath) {
+			await fs.mkdir(path.dirname(options.outputPath), { recursive: true });
+			await fs.writeFile(options.outputPath, JSON.stringify(result, null, 2));
+			logger.success(i18nText(`审计报告已保存到 ${colors.cyan(options.outputPath)}`, `Audit report saved to ${colors.cyan(options.outputPath)}`));
+			return result;
+		}
+		console.log(JSON.stringify(result, null, 2));
+		return result;
+	});
+}
+/**
+* @description 捕获当前页面截图并返回二进制内容。
+*/
+async function captureScreenshotBuffer(options) {
+	return await withMiniProgram(options, async (miniProgram) => {
+		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.info(i18nText(`正在连接 DevTools：${colors.cyan(options.projectPath)}...`, `Connecting to DevTools at ${colors.cyan(options.projectPath)}...`));
+		if (options.page) {
+			const normalizedPage = normalizePagePath(options.page);
+			logger.info(i18nText(`正在跳转页面 ${colors.cyan(normalizedPage)}...`, `Navigating to page ${colors.cyan(normalizedPage)}...`));
+			try {
+				await reLaunchForScreenshot(miniProgram, normalizedPage);
+			} catch (error) {
+				if (!isDevtoolsProtocolTimeoutError(error)) throw error;
+				logger.warn(i18nText(`截图前跳转页面 ${normalizedPage} 超时，将重建会话后截取当前页面。`, `Timed out navigating to ${normalizedPage} before screenshot. Rebuilding the session and capturing the current page.`));
+				throw createTimeoutError(i18nText(`截图前跳转页面 ${normalizedPage} 超时`, `Timed out navigating to ${normalizedPage} before screenshot`), "DEVTOOLS_SCREENSHOT_NAVIGATION_TIMEOUT");
+			}
+			if (options.fullPage) await sleep(1e3);
+		}
+		if (options.fullPage) {
+			logger.info(i18nText("正在生成整页长截图...", "Capturing full-page screenshot..."));
+			return await captureFullPageScreenshotBuffer({
+				miniProgram,
+				timeoutMs: commandTimeout,
+				runWithTimeout: withCommandTimeout,
+				screenshotTimeoutMessage
+			});
+		}
+		logger.info(i18nText("正在截图...", "Taking screenshot..."));
+		const buffer = toScreenshotBuffer(await withCommandTimeout(miniProgram.screenshot({ timeout: commandTimeout }), commandTimeout, screenshotTimeoutMessage, "DEVTOOLS_SCREENSHOT_TIMEOUT"));
+		if (buffer.length === 0) throw new Error(i18nText("截图失败", "Failed to capture screenshot"));
+		return buffer;
+	});
+}
+/**
+* @description 获取当前小程序截图。
+*/
+async function takeScreenshot(options) {
+	let nextOptions = options;
+	let screenshotBuffer;
+	let hasRetriedWithFreshSession = false;
+	while (true) try {
+		screenshotBuffer = await captureScreenshotBuffer(nextOptions);
+		break;
+	} catch (error) {
+		const isProtocolTimeout = error instanceof Error && error.message === "DEVTOOLS_PROTOCOL_TIMEOUT";
+		const isNavigationTimeout = isScreenshotNavigationTimeoutError(error);
+		const isScreenshotTimeout = isScreenshotRequestTimeoutError(error);
+		if (!Boolean(nextOptions.retryWithFreshSession !== false && !nextOptions.miniProgram && (isProtocolTimeout || isNavigationTimeout || isScreenshotTimeout) && !hasRetriedWithFreshSession)) throw error;
+		hasRetriedWithFreshSession = true;
+		logger.warn(i18nText("当前 DevTools 会话截图超时，正在改用全新自动化会话重试一次...", "The current DevTools session timed out while capturing screenshot. Retrying once with a fresh automation session..."));
+		const { page: _page, ...optionsWithoutPage } = nextOptions;
+		nextOptions = {
+			...isNavigationTimeout ? optionsWithoutPage : nextOptions,
+			preferOpenedSession: false,
+			sharedSession: false
+		};
+	}
+	if (!screenshotBuffer) throw new Error(i18nText("截图失败", "Failed to capture screenshot"));
+	const base64 = screenshotBuffer.toString("base64");
+	if (options.outputPath) {
+		await fs.mkdir(path.dirname(options.outputPath), { recursive: true });
+		await fs.writeFile(options.outputPath, screenshotBuffer);
+		logger.success(i18nText(`截图已保存到 ${colors.cyan(options.outputPath)}`, `Screenshot saved to ${colors.cyan(options.outputPath)}`));
+		return { path: options.outputPath };
+	}
+	return { base64 };
+}
+/**
+* @description 开关远程调试。
+*/
+async function remote(options) {
+	const enable = options.enable ?? true;
+	await withMiniProgram(options, async (miniProgram) => {
+		logger.info(enable ? i18nText("正在开启远程调试...", "Enabling remote debugging...") : i18nText("正在关闭远程调试...", "Disabling remote debugging..."));
+		await miniProgram.remote(enable);
+		logger.success(enable ? i18nText("远程调试已开启", "Remote debugging enabled") : i18nText("远程调试已关闭", "Remote debugging disabled"));
+	});
+}
+//#endregion
+export { navigateBack as a, pageStack as c, remote as d, scrollTo as f, tap as g, takeScreenshot as h, input as i, reLaunch as l, systemInfo as m, captureScreenshotBuffer as n, navigateTo as o, switchTab as p, currentPage as r, pageData as s, audit as t, redirectTo as u };