weapp-ide-cli 5.4.0 → 5.4.2

package/dist/commands-Js_IjVxE.js

@@ -0,0 +1,1142 @@
+import { $ as readCustomConfig, G as operatingSystemName, I as bootstrapWechatDevtoolsSettings, K as colors, L as detectWechatDevtoolsServicePort, R as resolveCliPath, W as isOperatingSystemSupported, X as createCustomConfig, d as createWechatIdeLoginRequiredExitError, h as isWechatIdeLoginRequiredError, n as closeSharedMiniProgram, nt as defaultCustomConfigFilePath, o as withMiniProgram, q as logger_default, rt as resolvePath, s as runRetryableCommand, v as promptWechatIdeLoginRetry, w as i18nText, x as runWithSuspendedSharedInput } from "./automator-session-CvStbY9I.js";
+import { Buffer } from "node:buffer";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { fs as fs$1 } from "@weapp-core/shared/fs";
+import process, { stdin, stdout } from "node:process";
+import { PNG } from "pngjs";
+import { createInterface } from "node:readline/promises";
+//#region src/cli/automator-argv.ts
+function parsePositiveInt(raw) {
+	const value = Number.parseInt(raw, 10);
+	if (!Number.isFinite(value) || value <= 0) return;
+	return value;
+}
+function takesValue(optionName) {
+	return optionName === "-p" || optionName === "--project" || optionName === "-t" || optionName === "--timeout" || optionName === "--port" || optionName === "--session-id" || optionName === "-o" || optionName === "--output" || optionName === "--page" || optionName === "--login-retry" || optionName === "--login-retry-timeout" || optionName === "--lang" || optionName === "--platform" || optionName === "--runtime-url" || optionName === "--qr-output" || optionName === "-r" || optionName === "--result-output" || optionName === "--info-output" || optionName === "-i";
+}
+/**
+* @description 解析 automator 命令通用参数与位置参数。
+*/
+function parseAutomatorArgs(argv) {
+	const positionals = [];
+	let projectPath = process.cwd();
+	let timeout;
+	let port;
+	let sessionId;
+	let preferOpenedSession;
+	let json = false;
+	for (let index = 0; index < argv.length; index += 1) {
+		const token = argv[index];
+		if (!token) continue;
+		if (token === "-p" || token === "--project") {
+			const value = argv[index + 1];
+			if (typeof value === "string" && !value.startsWith("-")) {
+				projectPath = value;
+				index += 1;
+			} else projectPath = process.cwd();
+			continue;
+		}
+		if (token.startsWith("--project=")) {
+			projectPath = token.slice(10) || process.cwd();
+			continue;
+		}
+		if (token === "-t" || token === "--timeout") {
+			const value = argv[index + 1];
+			if (typeof value === "string") {
+				timeout = parsePositiveInt(value);
+				index += 1;
+			}
+			continue;
+		}
+		if (token.startsWith("--timeout=")) {
+			timeout = parsePositiveInt(token.slice(10));
+			continue;
+		}
+		if (token === "--port") {
+			const value = argv[index + 1];
+			if (typeof value === "string") {
+				port = parsePositiveInt(value);
+				index += 1;
+			}
+			continue;
+		}
+		if (token.startsWith("--port=")) {
+			port = parsePositiveInt(token.slice(7));
+			continue;
+		}
+		if (token === "--session-id") {
+			const value = argv[index + 1];
+			if (typeof value === "string" && !value.startsWith("-")) {
+				sessionId = value.trim() || void 0;
+				index += 1;
+			}
+			continue;
+		}
+		if (token.startsWith("--session-id=")) {
+			sessionId = token.slice(13).trim() || void 0;
+			continue;
+		}
+		if (token === "--json") {
+			json = true;
+			continue;
+		}
+		if (token === "--no-runtime-service") {
+			preferOpenedSession = false;
+			continue;
+		}
+		if (token.startsWith("-")) {
+			if (takesValue(token.includes("=") ? token.slice(0, token.indexOf("=")) : token) && !token.includes("=")) {
+				const value = argv[index + 1];
+				if (typeof value === "string" && !value.startsWith("-")) index += 1;
+			}
+			continue;
+		}
+		positionals.push(token);
+	}
+	return {
+		projectPath,
+		...timeout ? { timeout } : {},
+		...port ? { port } : {},
+		...sessionId ? { sessionId } : {},
+		...preferOpenedSession === false ? { preferOpenedSession } : {},
+		json,
+		positionals
+	};
+}
+/**
+* @description 读取选项值，支持多个别名，以及 --option value 与 --option=value。
+*/
+function readOptionValue(argv, ...optionNames) {
+	for (const optionName of optionNames) {
+		const optionWithEqual = `${optionName}=`;
+		for (let index = 0; index < argv.length; index += 1) {
+			const token = argv[index];
+			if (!token) continue;
+			if (token === optionName) {
+				const value = argv[index + 1];
+				if (typeof value !== "string") return;
+				return value.trim();
+			}
+			if (token.startsWith(optionWithEqual)) return token.slice(optionWithEqual.length).trim();
+		}
+	}
+}
+/**
+* @description 读取布尔选项，支持裸 flag、--flag=true/false 与 --flag true/false。
+*/
+function readBooleanOption(argv, ...optionNames) {
+	for (const optionName of optionNames) {
+		const optionWithEqual = `${optionName}=`;
+		for (let index = 0; index < argv.length; index += 1) {
+			const token = argv[index];
+			if (!token) continue;
+			if (token === optionName) {
+				const nextToken = argv[index + 1];
+				if (nextToken === "true") return true;
+				if (nextToken === "false") return false;
+				return true;
+			}
+			if (token.startsWith(optionWithEqual)) {
+				const rawValue = token.slice(optionWithEqual.length).trim().toLowerCase();
+				if (rawValue === "true") return true;
+				if (rawValue === "false") return false;
+			}
+		}
+	}
+}
+/**
+* @description 删除参数中的指定选项（同时支持 --opt value 与 --opt=value）。
+*/
+function removeOption(argv, optionName) {
+	const optionWithEqual = `${optionName}=`;
+	const nextArgv = [];
+	for (let index = 0; index < argv.length; index += 1) {
+		const token = argv[index];
+		if (!token) continue;
+		if (token === optionName) {
+			const nextToken = argv[index + 1];
+			if (takesValue(optionName) && typeof nextToken === "string" && !nextToken.startsWith("-")) index += 1;
+			continue;
+		}
+		if (token.startsWith(optionWithEqual)) continue;
+		nextArgv.push(token);
+	}
+	return nextArgv;
+}
+//#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[positions.length - 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;
+		cropped.data.set(source.data.subarray(sourceStart, sourceEnd), row * bytesPerRow);
+	}
+	return cropped;
+}
+async function restoreScrollPosition(miniProgram, page, scrollTop) {
+	await miniProgram.pageScrollTo(scrollTop);
+	await page.waitFor(150);
+}
+/**
+* @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 initialScrollTop = typeof page.scrollTop === "function" ? await page.scrollTop() : 0;
+	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;
+	try {
+		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;
+		}
+	} finally {
+		await restoreScrollPosition(miniProgram, page, initialScrollTop);
+	}
+	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;
+			merged.data.set(segment.data.subarray(sourceStart, sourceEnd), (offsetY + row) * bytesPerRow);
+		}
+		offsetY += segment.height;
+	}
+	return PNG.sync.write(merged);
+}
+//#endregion
+//#region src/cli/http.ts
+const DEFAULT_WECHAT_DEVTOOLS_HTTP_PORT = 9420;
+const ENGINE_BUILD_NOT_START = "NOT_START";
+const ENGINE_BUILD_OPEN_PROJECT = "OPEN_PROJECT";
+const ENGINE_BUILD_BUILDING = "BUILDING";
+const ENGINE_BUILD_END = "END";
+const ENGINE_BUILD_ERROR = "ERROR";
+function createWechatDevtoolsHttpError(message, code) {
+	const error = new Error(message);
+	error.code = code;
+	return error;
+}
+async function resolveWechatDevtoolsHttpPort(port) {
+	if (typeof port === "number" && Number.isInteger(port) && port > 0) return port;
+	const detected = await detectWechatDevtoolsServicePort();
+	if (detected.servicePortEnabled === false) throw createWechatDevtoolsHttpError("WECHAT_DEVTOOLS_SERVICE_PORT_DISABLED", "WECHAT_DEVTOOLS_SERVICE_PORT_DISABLED");
+	return detected.servicePort ?? DEFAULT_WECHAT_DEVTOOLS_HTTP_PORT;
+}
+function createWechatDevtoolsHttpUrl(port, pathname, query) {
+	const url = new URL(`http://127.0.0.1:${port}${pathname}`);
+	for (const [key, value] of Object.entries(query)) url.searchParams.set(key, value);
+	return url;
+}
+function parseWechatDevtoolsEngineBuildResult(body) {
+	try {
+		return JSON.parse(body);
+	} catch {
+		return {};
+	}
+}
+async function requestWechatDevtoolsHttp(pathname, query, options = {}) {
+	const url = createWechatDevtoolsHttpUrl(await resolveWechatDevtoolsHttpPort(options.port), pathname, query);
+	const controller = new AbortController();
+	const timeout = setTimeout(() => {
+		controller.abort();
+	}, options.timeoutMs ?? 1e4);
+	try {
+		const response = await fetch(url, {
+			method: "GET",
+			signal: controller.signal
+		});
+		const body = await response.text();
+		if (!response.ok) throw createWechatDevtoolsHttpError(body || `HTTP ${response.status}`, "WECHAT_DEVTOOLS_HTTP_REQUEST_FAILED");
+		return body;
+	} catch (error) {
+		if (error instanceof Error && error.name === "AbortError") throw createWechatDevtoolsHttpError("WECHAT_DEVTOOLS_HTTP_TIMEOUT", "WECHAT_DEVTOOLS_HTTP_TIMEOUT");
+		throw error;
+	} finally {
+		clearTimeout(timeout);
+	}
+}
+/**
+* @description 通过微信开发者工具 HTTP 服务端口重新打开项目；若项目已打开，开发者工具会刷新当前项目。
+*/
+async function openWechatIdeProjectByHttp(projectPath, options = {}) {
+	return await requestWechatDevtoolsHttp("/open", { projectpath: path.resolve(projectPath) }, options);
+}
+/**
+* @description 通过微信开发者工具 HTTP 服务端口重置当前项目的 fileutils 状态。
+*/
+async function resetWechatIdeFileUtilsByHttp(projectPath, options = {}) {
+	return await requestWechatDevtoolsHttp("/v2/resetfileutils", { project: path.resolve(projectPath) }, options);
+}
+/**
+* @description 通过微信开发者工具 HTTP 服务端口触发 engine build。
+*/
+async function startWechatIdeEngineBuildByHttp(projectPath, options = {}) {
+	return { body: await requestWechatDevtoolsHttp("/engine/build", { projectpath: path.resolve(projectPath) }, options) };
+}
+/**
+* @description 轮询微信开发者工具 engine build 状态。
+*/
+async function pollWechatIdeEngineBuildResultByHttp(options = {}) {
+	const body = await requestWechatDevtoolsHttp("/engine/buildResult/", {}, options);
+	const parsed = parseWechatDevtoolsEngineBuildResult(body);
+	const status = parsed.status;
+	return {
+		body,
+		done: status === ENGINE_BUILD_END,
+		failed: status === ENGINE_BUILD_ERROR,
+		msg: parsed.msg,
+		status
+	};
+}
+const WECHAT_DEVTOOLS_ENGINE_BUILD_STATUSES = {
+	BUILDING: ENGINE_BUILD_BUILDING,
+	END: ENGINE_BUILD_END,
+	ERROR: ENGINE_BUILD_ERROR,
+	NOT_START: ENGINE_BUILD_NOT_START,
+	OPEN_PROJECT: ENGINE_BUILD_OPEN_PROJECT
+};
+//#endregion
+//#region src/cli/prompt.ts
+/**
+* @description 交互式提示并保存 CLI 路径
+*/
+async function promptForCliPath() {
+	return await runWithSuspendedSharedInput(async () => {
+		const rl = createInterface({
+			input: stdin,
+			output: stdout
+		});
+		try {
+			logger_default.info(`请设置 ${colors.bold("微信web开发者工具 CLI")} 的路径`);
+			logger_default.info("提示：命令行工具默认所在位置：");
+			logger_default.info(`- MacOS: ${colors.green("<安装路径>/Contents/MacOS/cli")}`);
+			logger_default.info(`- Windows: ${colors.green("<安装路径>/cli.bat")}`);
+			logger_default.info(`- Linux: ${colors.green("<安装路径>/files/bin/bin/wechat-devtools-cli")}`);
+			const cliPath = (await rl.question("请输入微信web开发者工具 CLI 路径：")).trim();
+			if (!cliPath) {
+				logger_default.error("路径不能为空，已取消本次配置。");
+				return null;
+			}
+			try {
+				const normalizedPath = await createCustomConfig({ cliPath });
+				logger_default.info(`全局配置存储位置：${colors.green(defaultCustomConfigFilePath)}`);
+				if (!await fs$1.pathExists(normalizedPath)) logger_default.warn("在当前路径未找到微信web开发者命令行工具，请确认路径是否正确。");
+				return normalizedPath;
+			} catch (error) {
+				const reason = error instanceof Error ? error.message : String(error);
+				logger_default.error(`保存配置失败：${reason}`);
+				return null;
+			}
+		} finally {
+			rl.close();
+		}
+	});
+}
+//#endregion
+//#region src/utils/argv.ts
+function ensurePathArgument(argv, optionIndex) {
+	const paramIdx = optionIndex + 1;
+	const param = argv[paramIdx];
+	if (param && !param.startsWith("-")) argv[paramIdx] = resolvePath(param);
+	else argv.splice(paramIdx, 0, process.cwd());
+	return argv;
+}
+/**
+* @description 依次应用 argv 处理函数（不修改原始 argv）
+*/
+function transformArgv(argv, transforms) {
+	return transforms.reduce((current, transform) => transform(current), [...argv]);
+}
+/**
+* @description 创建参数别名转换器
+*/
+function createAlias(entry) {
+	return (input) => {
+		const argv = [...input];
+		let optionIndex = argv.indexOf(entry.find);
+		if (optionIndex > -1) argv.splice(optionIndex, 1, entry.replacement);
+		else optionIndex = argv.indexOf(entry.replacement);
+		if (optionIndex === -1) return argv;
+		return ensurePathArgument(argv, optionIndex);
+	};
+}
+/**
+* @description 创建路径参数兼容转换器（补全或规范化路径）
+*/
+function createPathCompat(option) {
+	return (input) => {
+		const argv = [...input];
+		const optionIndex = argv.indexOf(option);
+		if (optionIndex === -1) return argv;
+		return ensurePathArgument(argv, optionIndex);
+	};
+}
+//#endregion
+//#region src/utils/exec.ts
+/**
+* @description 执行 CLI 命令并透传输出
+*/
+async function execute(cliPath, argv, options = {}) {
+	const { pipeStdout = true, pipeStderr = true } = options;
+	const { execa } = await import("execa");
+	const task = execa(cliPath, argv);
+	if (pipeStdout) task?.stdout?.pipe(process.stdout);
+	if (pipeStderr) task?.stderr?.pipe(process.stderr);
+	return await task;
+}
+//#endregion
+//#region src/cli/run-login-config.ts
+function normalizeLoginRetryMode(value, nonInteractive) {
+	if (value && value !== "never" && value !== "once" && value !== "always") throw new Error(i18nText(`不支持的 --login-retry 值: ${value}（仅支持 never/once/always）`, `Invalid --login-retry value: ${value} (supported: never/once/always)`));
+	if (value === "never" || value === "once" || value === "always") return value;
+	return nonInteractive ? "never" : "always";
+}
+function normalizeLoginRetryTimeout(value) {
+	if (!value) return 3e4;
+	const parsed = Number.parseInt(value, 10);
+	if (!Number.isFinite(parsed) || parsed <= 0) throw new Error(i18nText(`无效的 --login-retry-timeout 值: ${value}（必须为正整数）`, `Invalid --login-retry-timeout value: ${value} (must be a positive integer)`));
+	return parsed;
+}
+function isStdinInteractive() {
+	return Boolean(process.stdin && process.stdin.isTTY);
+}
+function stripLoginRetryControlFlags(argv) {
+	let next = removeOption(argv, "--login-retry");
+	next = removeOption(next, "--login-retry-timeout");
+	next = removeOption(next, "--non-interactive");
+	return next;
+}
+/**
+* @description 解析登录重试相关控制参数，并产出实际执行微信 CLI 所需的运行时参数。
+*/
+function resolveLoginRetryConfig(argv) {
+	const nonInteractiveFlag = argv.includes("--non-interactive");
+	const ciMode = process.env.CI === "true";
+	const nonTtyStdin = !isStdinInteractive();
+	const nonInteractive = nonInteractiveFlag || ciMode || nonTtyStdin;
+	const retryModeRaw = readOptionValue(argv, "--login-retry")?.toLowerCase();
+	return {
+		nonInteractive,
+		retryMode: normalizeLoginRetryMode(retryModeRaw, nonInteractive),
+		retryTimeoutMs: normalizeLoginRetryTimeout(readOptionValue(argv, "--login-retry-timeout")),
+		runtimeArgv: stripLoginRetryControlFlags(argv)
+	};
+}
+//#endregion
+//#region src/cli/run-login.ts
+function unwrapWechatCliExecutionError(result) {
+	return result.kind === "retryable" ? result.error : result.value;
+}
+async function promptLoginRetry(errorLike, options, retryCount) {
+	const { nonInteractive, retryMode, retryTimeoutMs } = options;
+	if (nonInteractive) {
+		logger_default.error(i18nText("当前为非交互模式，检测到登录失效后直接失败。", "Non-interactive mode enabled, failing immediately on login expiration."));
+		return "cancel";
+	}
+	if (!(retryMode === "always" || retryMode === "once" && retryCount < 1)) {
+		await promptWechatIdeLoginRetry({
+			allowRetry: false,
+			error: errorLike,
+			logger: logger_default,
+			promptOpenIdeLogin: true,
+			retryTimeoutMs
+		});
+		logger_default.info(i18nText("当前重试策略不允许继续重试。", "Current retry policy does not allow further retries."));
+		return "cancel";
+	}
+	return await promptWechatIdeLoginRetry({
+		error: errorLike,
+		logger: logger_default,
+		promptOpenIdeLogin: true,
+		retryTimeoutMs
+	});
+}
+function flushExecutionOutput(result) {
+	if (!result || typeof result !== "object") return;
+	const candidate = result;
+	if (typeof candidate.stdout === "string" && candidate.stdout) process.stdout.write(candidate.stdout);
+	if (typeof candidate.stderr === "string" && candidate.stderr) process.stderr.write(candidate.stderr);
+}
+/**
+* @description 运行微信开发者工具 CLI，并在登录失效时允许按键重试。
+*/
+async function runWechatCliWithRetry(cliPath, argv) {
+	const loginRetryOptions = resolveLoginRetryConfig(argv);
+	const result = await runWithSuspendedSharedInput(async () => {
+		return await runRetryableCommand({
+			createCancelError: (result) => createWechatIdeLoginRequiredExitError(unwrapWechatCliExecutionError(result)),
+			execute: async () => {
+				try {
+					return {
+						kind: "result",
+						value: await execute(cliPath, loginRetryOptions.runtimeArgv, {
+							pipeStdout: false,
+							pipeStderr: false
+						})
+					};
+				} catch (error) {
+					if (!isWechatIdeLoginRequiredError(error)) throw error;
+					return {
+						error,
+						kind: "retryable"
+					};
+				}
+			},
+			isRetryableResult: (result) => result.kind === "retryable" || isWechatIdeLoginRequiredError(result.value),
+			onRetry: () => {
+				logger_default.info(i18nText("正在重试连接微信开发者工具...", "Retrying to connect Wechat DevTools..."));
+			},
+			promptRetry: async (result, retryCount) => {
+				return await promptLoginRetry(unwrapWechatCliExecutionError(result), loginRetryOptions, retryCount);
+			},
+			shouldRetry: (action) => action === "retry"
+		});
+	});
+	if (result.kind === "retryable") throw createWechatIdeLoginRequiredExitError(result.error);
+	if (isWechatIdeLoginRequiredError(result.value)) throw createWechatIdeLoginRequiredExitError(result.value);
+	flushExecutionOutput(result.value);
+}
+//#endregion
+//#region src/cli/run-wechat-cli.ts
+function shouldBootstrapWechatDevtools(command) {
+	return command === "open" || command === "auto" || command === "auto-preview";
+}
+function appendOptionValue(argv, sourceArgv, optionName) {
+	const value = readOptionValue(sourceArgv, optionName);
+	if (value !== void 0) argv.push(optionName, value);
+}
+function createAutoPreviewWakeArgv(argv, trustProject) {
+	if (argv[0] !== "auto-preview") return;
+	const projectPath = readOptionValue(argv, "--project");
+	const appid = readOptionValue(argv, "--appid");
+	if (!projectPath && !appid) return;
+	const wakeArgv = ["open"];
+	appendOptionValue(wakeArgv, argv, "--project");
+	appendOptionValue(wakeArgv, argv, "--appid");
+	appendOptionValue(wakeArgv, argv, "--ext-appid");
+	if (trustProject === true) wakeArgv.push("--trust-project");
+	return wakeArgv;
+}
+function resolveBooleanCliOption(argv, optionName) {
+	if (argv.includes(optionName)) return true;
+	const rawValue = readOptionValue(argv, optionName);
+	if (rawValue === void 0) return;
+	const normalized = rawValue.trim().toLowerCase();
+	if (normalized === "" || normalized === "true" || normalized === "1" || normalized === "on") return true;
+	if (normalized === "false" || normalized === "0" || normalized === "off") return false;
+	return true;
+}
+async function handleMissingCliPath(source) {
+	const message = source === "custom" ? i18nText("在当前自定义路径中未找到微信web开发者命令行工具，请重新指定路径。", "Cannot find Wechat Web DevTools CLI in custom path, please reconfigure it.") : i18nText(`未检测到微信web开发者命令行工具，请执行 ${colors.bold(colors.green("weapp-ide-cli config"))} 指定路径。`, `Wechat Web DevTools CLI not found, please run ${colors.bold(colors.green("weapp-ide-cli config"))} to configure it.`);
+	logger_default.warn(message);
+	await promptForCliPath();
+}
+async function maybeBootstrapWechatDevtoolsSettings(argv) {
+	const command = argv[0];
+	if (!shouldBootstrapWechatDevtools(command)) return;
+	const config = await readCustomConfig();
+	if (config.autoBootstrapDevtools === false) return;
+	const projectPath = readOptionValue(argv, "--project");
+	const trustProjectOption = resolveBooleanCliOption(argv, "--trust-project");
+	const trustProject = trustProjectOption === void 0 ? config.autoTrustProject ?? false : trustProjectOption;
+	await bootstrapWechatDevtoolsSettings({
+		projectPath,
+		trustProject
+	});
+	return { trustProject };
+}
+/**
+* @description 执行微信开发者工具 CLI 阶段，包括环境检查、路径解析、bootstrap 与登录重试。
+*/
+async function runWechatCliCommand(argv) {
+	if (!isOperatingSystemSupported(operatingSystemName)) {
+		logger_default.warn(i18nText(`微信web开发者工具不支持当前平台：${operatingSystemName} !`, `Wechat Web DevTools CLI is not supported on current platform: ${operatingSystemName}!`));
+		return;
+	}
+	const { cliPath, source } = await resolveCliPath();
+	if (!cliPath) {
+		await handleMissingCliPath(source);
+		return;
+	}
+	const wakeArgv = createAutoPreviewWakeArgv(argv, (await maybeBootstrapWechatDevtoolsSettings(argv))?.trustProject);
+	if (wakeArgv) await runWechatCliWithRetry(cliPath, wakeArgv);
+	await runWechatCliWithRetry(cliPath, argv);
+}
+//#endregion
+//#region src/cli/wechat-commands.ts
+function appendProjectLocatorArgv(argv, options) {
+	if (options.projectPath) argv.push("--project", path.resolve(options.projectPath));
+	if (options.appid) argv.push("--appid", options.appid);
+	if (options.extAppid) argv.push("--ext-appid", options.extAppid);
+}
+/**
+* @description 调用微信开发者工具 open 命令。
+*/
+async function openWechatIde(options = {}) {
+	const argv = ["open"];
+	appendProjectLocatorArgv(argv, options);
+	if (options.platform) argv.push("--platform", options.platform);
+	if (options.trustProject) argv.push("--trust-project");
+	await runWechatCliCommand(argv);
+}
+/**
+* @description 调用微信开发者工具 login 命令。
+*/
+async function loginWechatIde(options = {}) {
+	const argv = ["login"];
+	if (options.qrFormat) argv.push("--qr-format", options.qrFormat);
+	if (options.qrOutput) argv.push("--qr-output", path.resolve(options.qrOutput));
+	if (options.qrSize) argv.push("--qr-size", options.qrSize);
+	if (options.resultOutput) argv.push("--result-output", path.resolve(options.resultOutput));
+	await runWechatCliCommand(argv);
+}
+/**
+* @description 调用微信开发者工具 islogin 命令。
+*/
+async function isWechatIdeLoggedIn() {
+	await runWechatCliCommand(["islogin"]);
+}
+/**
+* @description 调用微信开发者工具 build-npm 命令。
+*/
+async function buildWechatIdeNpm(options = {}) {
+	const argv = [
+		"build-npm",
+		"--project",
+		path.resolve(options.projectPath ?? process.cwd())
+	];
+	if (options.compileType) argv.push("--compile-type", options.compileType);
+	await runWechatCliCommand(argv);
+}
+/**
+* @description 调用微信开发者工具 preview 命令。
+*/
+async function previewWechatIde(options = {}) {
+	const argv = ["preview"];
+	appendProjectLocatorArgv(argv, options);
+	if (options.qrFormat) argv.push("--qr-format", options.qrFormat);
+	if (options.qrOutput) argv.push("--qr-output", path.resolve(options.qrOutput));
+	if (options.qrSize) argv.push("--qr-size", options.qrSize);
+	if (options.infoOutput) argv.push("--info-output", path.resolve(options.infoOutput));
+	if (options.compileCondition) argv.push("--compile-condition", options.compileCondition);
+	await runWechatCliCommand(argv);
+}
+/**
+* @description 调用微信开发者工具 auto-preview 命令。
+*/
+async function autoPreviewWechatIde(options = {}) {
+	const argv = ["auto-preview"];
+	appendProjectLocatorArgv(argv, options);
+	if (options.infoOutput) argv.push("--info-output", path.resolve(options.infoOutput));
+	if (options.compileCondition) argv.push("--compile-condition", options.compileCondition);
+	await runWechatCliCommand(argv);
+}
+/**
+* @description 调用微信开发者工具 auto 命令。
+*/
+async function autoWechatIde(options = {}) {
+	const argv = ["auto"];
+	appendProjectLocatorArgv(argv, options);
+	if (options.port) argv.push("--auto-port", options.port);
+	if (options.account) argv.push("--auto-account", options.account);
+	if (options.testTicket) argv.push("--test-ticket", options.testTicket);
+	if (options.ticket) argv.push("--ticket", options.ticket);
+	if (options.trustProject) argv.push("--trust-project");
+	await runWechatCliCommand(argv);
+}
+/**
+* @description 调用微信开发者工具 auto-replay 命令。
+*/
+async function autoReplayWechatIde(options = {}) {
+	const argv = ["auto-replay"];
+	appendProjectLocatorArgv(argv, options);
+	if (options.port) argv.push("--auto-port", options.port);
+	if (options.account) argv.push("--auto-account", options.account);
+	if (options.replayAll) argv.push("--replay-all");
+	if (options.replayConfigPath) argv.push("--replay-config-path", path.resolve(options.replayConfigPath));
+	if (options.testTicket) argv.push("--test-ticket", options.testTicket);
+	if (options.ticket) argv.push("--ticket", options.ticket);
+	if (options.trustProject) argv.push("--trust-project");
+	await runWechatCliCommand(argv);
+}
+/**
+* @description 调用微信开发者工具 upload 命令。
+*/
+async function uploadWechatIde(options) {
+	const argv = ["upload"];
+	appendProjectLocatorArgv(argv, options);
+	argv.push("--version", options.version, "--desc", options.desc);
+	if (options.infoOutput) argv.push("--info-output", path.resolve(options.infoOutput));
+	await runWechatCliCommand(argv);
+}
+/**
+* @description 调用微信开发者工具 close 命令。
+*/
+async function closeWechatIdeProject() {
+	await runWechatCliCommand(["close"]);
+}
+/**
+* @description 调用微信开发者工具 quit 命令。
+*/
+async function quitWechatIde() {
+	await runWechatCliCommand(["quit"]);
+}
+/**
+* @description 调用微信开发者工具 cache 命令。
+*/
+async function clearWechatIdeCache(options) {
+	await runWechatCliCommand([
+		"cache",
+		"--clean",
+		options.clean
+	]);
+}
+/**
+* @description 调用微信开发者工具 open-other 命令。
+*/
+async function openWechatIdeOtherProject(_options = {}) {
+	await runWechatCliCommand(["open-other"]);
+}
+/**
+* @description 通过微信开发者工具 HTTP 服务端口重置指定项目的 fileutils 状态。
+*/
+async function resetWechatIdeFileUtils(options) {
+	await resetWechatIdeFileUtilsByHttp(path.resolve(options.projectPath));
+}
+function createAutomatorSessionOptions(options) {
+	return {
+		...options.port ? { port: options.port } : {},
+		preferOpenedSession: options.preferOpenedSession ?? true,
+		projectPath: path.resolve(options.projectPath),
+		...options.sessionId ? { sessionId: options.sessionId } : {},
+		sharedSession: options.sharedSession ?? true,
+		timeout: options.timeout
+	};
+}
+/**
+* @description 通过已打开或新建的 automator 会话获取开发者工具基础信息。
+*/
+async function getWechatIdeToolInfo(options) {
+	return await withMiniProgram(createAutomatorSessionOptions(options), async (miniProgram) => {
+		return await miniProgram.toolInfo();
+	});
+}
+/**
+* @description 通过已打开或新建的 automator 会话执行项目编译。
+*/
+async function compileWechatIdeByAutomator(options) {
+	return await withMiniProgram(createAutomatorSessionOptions(options), async (miniProgram) => {
+		return await miniProgram.compile({ force: options.force });
+	});
+}
+/**
+* @description 通过已打开或新建的 automator 会话清理开发者工具缓存。
+*/
+async function clearWechatIdeCacheByAutomator(options) {
+	return await withMiniProgram(createAutomatorSessionOptions(options), async (miniProgram) => {
+		return await miniProgram.clearCache({ clean: options.clean });
+	});
+}
+/**
+* @description 通过已打开或新建的 automator 会话获取当前 ticket。
+*/
+async function getWechatIdeTicket(options) {
+	return await withMiniProgram(createAutomatorSessionOptions(options), async (miniProgram) => {
+		return await miniProgram.getTicket();
+	});
+}
+/**
+* @description 通过已打开或新建的 automator 会话设置 ticket。
+*/
+async function setWechatIdeTicket(options) {
+	return await withMiniProgram(createAutomatorSessionOptions(options), async (miniProgram) => {
+		await miniProgram.setTicket(options.ticket);
+	});
+}
+/**
+* @description 通过已打开或新建的 automator 会话刷新 ticket。
+*/
+async function refreshWechatIdeTicket(options) {
+	return await withMiniProgram(createAutomatorSessionOptions(options), async (miniProgram) => {
+		await miniProgram.refreshTicket();
+	});
+}
+/**
+* @description 通过已打开或新建的 automator 会话获取测试账号列表。
+*/
+async function getWechatIdeTestAccounts(options) {
+	return await withMiniProgram(createAutomatorSessionOptions(options), async (miniProgram) => {
+		return await miniProgram.testAccounts();
+	});
+}
+/**
+* @description 调用微信开发者工具 build-apk 命令。
+*/
+async function buildWechatIdeApk(options) {
+	const argv = [
+		"build-apk",
+		"--key-store",
+		path.resolve(options.keyStore),
+		"--key-alias",
+		options.keyAlias,
+		"--key-pass",
+		options.keyPass,
+		"--store-pass",
+		options.storePass,
+		"--output",
+		path.resolve(options.output)
+	];
+	if (options.useAab !== void 0) argv.push("--use-aab", String(options.useAab));
+	if (options.desc) argv.push("--desc", options.desc);
+	if (options.isUploadResourceBundle) argv.push("--isUploadResourceBundle");
+	if (options.resourceBundleVersion) argv.push("--resourceBundleVersion", options.resourceBundleVersion);
+	if (options.resourceBundleDesc) argv.push("--resourceBundleDesc", options.resourceBundleDesc);
+	await runWechatCliCommand(argv);
+}
+/**
+* @description 调用微信开发者工具 build-ipa 命令。
+*/
+async function buildWechatIdeIpa(options) {
+	const argv = [
+		"build-ipa",
+		"--output",
+		path.resolve(options.output),
+		"--isDistribute",
+		String(options.isDistribute)
+	];
+	if (options.isRemoteBuild !== void 0) argv.push("--isRemoteBuild", String(options.isRemoteBuild));
+	if (options.profilePath) argv.push("--profilePath", path.resolve(options.profilePath));
+	if (options.certificateName) argv.push("--certificateName", options.certificateName);
+	if (options.p12Path) argv.push("--p12Path", path.resolve(options.p12Path));
+	if (options.p12Password) argv.push("--p12Password", options.p12Password);
+	if (options.tpnsProfilePath) argv.push("--tpnsProfilePath", path.resolve(options.tpnsProfilePath));
+	if (options.isUploadBeta !== void 0) argv.push("--isUploadBeta", String(options.isUploadBeta));
+	if (options.isUploadResourceBundle) argv.push("--isUploadResourceBundle");
+	if (options.resourceBundleVersion) argv.push("--resourceBundleVersion", options.resourceBundleVersion);
+	if (options.resourceBundleDesc) argv.push("--resourceBundleDesc", options.resourceBundleDesc);
+	if (options.versionName) argv.push("--versionName", options.versionName);
+	if (options.versionCode !== void 0) argv.push("--versionCode", String(options.versionCode));
+	if (options.versionDesc) argv.push("--versionDesc", options.versionDesc);
+	await runWechatCliCommand(argv);
+}
+//#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 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 isScreenshotNavigationTimeoutError(error) {
+	return error instanceof Error && Reflect.get(error, "code") === "DEVTOOLS_SCREENSHOT_NAVIGATION_TIMEOUT";
+}
+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_default.info(startMessage);
+		await action(miniProgram);
+		logger_default.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_default.info(title);
+	console.log(JSON.stringify(result, null, 2));
+}
+async function requireElement(page, selector) {
+	const element = await page.$(selector);
+	if (!element) throw new Error(i18nText(`未找到元素: ${selector}`, `Element not found: ${selector}`));
+	return element;
+}
+/**
+* @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 result = toPageSnapshot(await miniProgram.currentPage());
+		if (options.json) console.log(JSON.stringify(result, null, 2));
+		else logger_default.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_default.info(i18nText(`正在点击元素 ${colors.cyan(options.selector)}...`, `Tapping element ${colors.cyan(options.selector)}...`));
+		await (await requireElement(await miniProgram.currentPage(), options.selector)).tap();
+		logger_default.success(i18nText(`已点击元素 ${colors.cyan(options.selector)}`, `Tapped element ${colors.cyan(options.selector)}`));
+	});
+}
+/**
+* @description 向页面元素输入文本。
+*/
+async function input(options) {
+	await withMiniProgram(options, async (miniProgram) => {
+		logger_default.info(i18nText(`正在向 ${colors.cyan(options.selector)} 输入 "${colors.cyan(options.value)}"...`, `Inputting "${colors.cyan(options.value)}" into ${colors.cyan(options.selector)}...`));
+		const element = await requireElement(await miniProgram.currentPage(), options.selector);
+		if (typeof element.input !== "function") throw new TypeError(i18nText(`元素不支持输入: ${options.selector}`, `Element does not support input: ${options.selector}`));
+		await element.input(options.value);
+		logger_default.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_default.info(i18nText(`正在滚动到位置 ${colors.cyan(String(options.scrollTop))}...`, `Scrolling to position ${colors.cyan(String(options.scrollTop))}...`));
+		await miniProgram.pageScrollTo(options.scrollTop);
+		logger_default.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_default.info(i18nText("正在执行体验审计...", "Running experience audit..."));
+		const result = await miniProgram.stopAudits();
+		if (options.outputPath) {
+			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;
+		}
+		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_default.info(i18nText(`正在连接 DevTools：${colors.cyan(options.projectPath)}...`, `Connecting to DevTools at ${colors.cyan(options.projectPath)}...`));
+		if (options.page) {
+			const normalizedPage = normalizePagePath(options.page);
+			logger_default.info(i18nText(`正在跳转页面 ${colors.cyan(normalizedPage)}...`, `Navigating to page ${colors.cyan(normalizedPage)}...`));
+			try {
+				await reLaunchForScreenshot(miniProgram, normalizedPage);
+			} catch (error) {
+				if (!isDevtoolsProtocolTimeoutError(error)) throw error;
+				logger_default.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_default.info(i18nText("正在生成整页长截图...", "Capturing full-page screenshot..."));
+			return await captureFullPageScreenshotBuffer({
+				miniProgram,
+				timeoutMs: commandTimeout,
+				runWithTimeout: withCommandTimeout,
+				screenshotTimeoutMessage
+			});
+		}
+		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 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);
+		if (!Boolean(!nextOptions.miniProgram && (isProtocolTimeout || isNavigationTimeout) && !hasRetriedWithFreshSession)) throw error;
+		hasRetriedWithFreshSession = true;
+		await closeWechatIdeProject().catch((closeError) => {
+			logger_default.warn(i18nText(`关闭当前微信开发者工具项目窗口失败：${closeError instanceof Error ? closeError.message : String(closeError)}，仍将继续尝试重建自动化会话。`, `Failed to close the current Wechat DevTools project window: ${closeError instanceof Error ? closeError.message : String(closeError)}. Continuing to rebuild the automation session.`));
+		});
+		const sessionIdOrPort = nextOptions.sessionId || nextOptions.port;
+		if (sessionIdOrPort) await closeSharedMiniProgram(nextOptions.projectPath, sessionIdOrPort);
+		else await closeSharedMiniProgram(nextOptions.projectPath);
+		logger_default.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.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) {
+	const enable = options.enable ?? true;
+	await withMiniProgram(options, async (miniProgram) => {
+		logger_default.info(enable ? i18nText("正在开启远程调试...", "Enabling remote debugging...") : i18nText("正在关闭远程调试...", "Disabling remote debugging..."));
+		await miniProgram.remote(enable);
+		logger_default.success(enable ? i18nText("远程调试已开启", "Remote debugging enabled") : i18nText("远程调试已关闭", "Remote debugging disabled"));
+	});
+}
+//#endregion
+export { parseAutomatorArgs as $, isWechatIdeLoggedIn as A, runWechatCliCommand as B, clearWechatIdeCache as C, getWechatIdeTestAccounts as D, compileWechatIdeByAutomator as E, quitWechatIde as F, transformArgv as G, execute as H, refreshWechatIdeTicket as I, openWechatIdeProjectByHttp as J, promptForCliPath as K, resetWechatIdeFileUtils as L, openWechatIde as M, openWechatIdeOtherProject as N, getWechatIdeTicket as O, previewWechatIde as P, startWechatIdeEngineBuildByHttp as Q, setWechatIdeTicket as R, buildWechatIdeNpm as S, closeWechatIdeProject as T, createAlias as U, runWechatCliWithRetry as V, createPathCompat as W, requestWechatDevtoolsHttp as X, pollWechatIdeEngineBuildResultByHttp as Y, resetWechatIdeFileUtilsByHttp as Z, autoPreviewWechatIde as _, navigateBack as a, buildWechatIdeApk as b, pageStack as c, remote as d, readBooleanOption as et, scrollTo as f, tap as g, takeScreenshot as h, input as i, loginWechatIde as j, getWechatIdeToolInfo as k, reLaunch as l, systemInfo as m, captureScreenshotBuffer as n, removeOption as nt, navigateTo as o, switchTab as p, WECHAT_DEVTOOLS_ENGINE_BUILD_STATUSES as q, currentPage as r, pageData as s, audit as t, readOptionValue as tt, redirectTo as u, autoReplayWechatIde as v, clearWechatIdeCacheByAutomator as w, buildWechatIdeIpa as x, autoWechatIde as y, uploadWechatIde as z };