weapp-ide-cli 5.1.2 → 5.1.4

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

@@ -1,9 +1,11 @@
-import net from "node:net";
-import automator from "miniprogram-automator";
-import process from "node:process";
+import { Launcher } from "@weapp-vite/miniprogram-automator";
+import fs from "fs-extra";
 import logger, { colors } from "@weapp-core/logger";
+import os from "node:os";
+import process from "node:process";
+import path from "pathe";
 import { Buffer as Buffer$1 } from "node:buffer";
-import fs from "node:fs/promises";
+import fs$1 from "node:fs/promises";
 //#region \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
 var __exportAll = (all, no_symbols) => {
@@ -16,7 +18,232 @@ var __exportAll = (all, no_symbols) => {
 	return target;
 };
 //#endregion
+//#region src/logger.ts
+var logger_default = logger;
+//#endregion
+//#region src/runtime/platform.ts
+/**
+* @description 官方微信开发者工具只支持 Windows、macOS，Linux 只有社区版
+* https://github.com/msojocs/wechat-web-devtools-linux
+*/
+const SupportedPlatformsMap = {
+	Windows_NT: "Windows_NT",
+	Darwin: "Darwin",
+	Linux: "Linux"
+};
+/**
+* @description 判断当前系统是否支持微信开发者工具
+*/
+function isOperatingSystemSupported(osName = os.type()) {
+	return osName === SupportedPlatformsMap.Windows_NT || osName === SupportedPlatformsMap.Darwin || osName === SupportedPlatformsMap.Linux;
+}
+/**
+* @description 当前系统名称
+*/
+const operatingSystemName = os.type();
+function createLinuxCliResolver() {
+	let resolvedPath;
+	let attempted = false;
+	let pending = null;
+	return async () => {
+		if (attempted) return resolvedPath;
+		if (!pending) pending = (async () => {
+			try {
+				const envPath = await getFirstBinaryPath("wechat-devtools-cli");
+				if (envPath) resolvedPath = envPath;
+			} catch (error) {
+				const reason = error instanceof Error ? error.message : String(error);
+				logger_default.warn(`获取 Linux wechat-devtools-cli 路径失败：${reason}`);
+			} finally {
+				attempted = true;
+			}
+			return resolvedPath;
+		})();
+		return pending;
+	};
+}
+const linuxCliResolver = createLinuxCliResolver();
+const WINDOWS_DEFAULT_CLI = "C:\\Program Files (x86)\\Tencent\\微信web开发者工具\\cli.bat";
+const DARWIN_DEFAULT_CLI = "/Applications/wechatwebdevtools.app/Contents/MacOS/cli";
+const cliPathResolvers = {
+	[SupportedPlatformsMap.Windows_NT]: async () => WINDOWS_DEFAULT_CLI,
+	[SupportedPlatformsMap.Darwin]: async () => DARWIN_DEFAULT_CLI,
+	[SupportedPlatformsMap.Linux]: linuxCliResolver
+};
+/**
+* @description 获取默认 CLI 路径（按系统）
+*/
+async function getDefaultCliPath(targetOs = operatingSystemName) {
+	if (!isOperatingSystemSupported(targetOs)) return;
+	const resolver = cliPathResolvers[targetOs];
+	return await resolver();
+}
+async function getFirstBinaryPath(command) {
+	const pathDirs = (process.env.PATH || "").split(path.delimiter);
+	for (const dir of pathDirs) {
+		const fullPath = path.join(dir, command);
+		try {
+			await fs.access(fullPath, fs.constants.X_OK);
+			return fullPath;
+		} catch {
+			continue;
+		}
+	}
+}
+//#endregion
+//#region src/utils/path.ts
+/**
+* @description 解析为绝对路径（基于当前工作目录）
+*/
+function resolvePath(filePath) {
+	if (path.isAbsolute(filePath)) return filePath;
+	return path.resolve(process.cwd(), filePath);
+}
+//#endregion
+//#region src/config/paths.ts
+const homedir = os.homedir();
+/**
+* @description 默认自定义配置目录
+*/
+const defaultCustomConfigDirPath = path.join(homedir, ".weapp-ide-cli");
+/**
+* @description 默认自定义配置文件路径
+*/
+const defaultCustomConfigFilePath = path.join(defaultCustomConfigDirPath, "config.json");
+//#endregion
+//#region src/config/custom.ts
+const JSON_OPTIONS = {
+	encoding: "utf8",
+	spaces: 2
+};
+/**
+* @description 写入自定义 CLI 路径配置
+*/
+async function createCustomConfig(params) {
+	const trimmedCliPath = params.cliPath.trim();
+	if (!trimmedCliPath) throw new Error("cliPath cannot be empty");
+	const normalizedCliPath = resolvePath(trimmedCliPath);
+	await writeCustomConfig({ cliPath: normalizedCliPath });
+	return normalizedCliPath;
+}
+/**
+* @description 写入语言配置（zh / en）。
+*/
+async function createLocaleConfig(locale) {
+	await writeCustomConfig({ locale });
+	return locale;
+}
+/**
+* @description 删除指定配置项。
+*/
+async function removeCustomConfigKey(key) {
+	const currentConfig = await readCustomConfig();
+	if (!(key in currentConfig)) return;
+	const nextConfig = { ...currentConfig };
+	delete nextConfig[key];
+	await writeCustomConfig(nextConfig, { replace: true });
+}
+/**
+* @description 覆盖写入配置内容（会替换原内容）。
+*/
+async function overwriteCustomConfig(config) {
+	const nextConfig = {};
+	if (typeof config.cliPath === "string" && config.cliPath.trim()) nextConfig.cliPath = resolvePath(config.cliPath.trim());
+	if (config.locale === "zh" || config.locale === "en") nextConfig.locale = config.locale;
+	await writeCustomConfig(nextConfig, { replace: true });
+}
+/**
+* @description 读取原始自定义配置。
+*/
+async function readCustomConfig() {
+	if (!await fs.pathExists(defaultCustomConfigFilePath)) return {};
+	try {
+		const config = await fs.readJSON(defaultCustomConfigFilePath);
+		if (!config || typeof config !== "object") return {};
+		const candidate = config;
+		const next = {};
+		if (typeof candidate.cliPath === "string" && candidate.cliPath.trim()) next.cliPath = candidate.cliPath.trim();
+		if (candidate.locale === "zh" || candidate.locale === "en") next.locale = candidate.locale;
+		return next;
+	} catch {
+		return {};
+	}
+}
+async function writeCustomConfig(patch, options = {}) {
+	const nextConfig = {
+		...options.replace ? {} : await readCustomConfig(),
+		...patch
+	};
+	await fs.ensureDir(defaultCustomConfigDirPath);
+	await fs.writeJSON(defaultCustomConfigFilePath, nextConfig, JSON_OPTIONS);
+}
+//#endregion
+//#region src/config/resolver.ts
+/**
+* @description 读取并解析 CLI 配置（自定义优先）
+*/
+async function getConfig() {
+	if (await fs.pathExists(defaultCustomConfigFilePath)) try {
+		const config = await fs.readJSON(defaultCustomConfigFilePath);
+		const cliPath = typeof config.cliPath === "string" ? config.cliPath.trim() : "";
+		const locale = config.locale === "zh" || config.locale === "en" ? config.locale : void 0;
+		if (cliPath) {
+			logger_default.info(`全局配置文件路径：${colors.green(defaultCustomConfigFilePath)}`);
+			logger_default.info(`自定义 CLI 路径：${colors.green(cliPath)}`);
+			return {
+				cliPath,
+				locale,
+				source: "custom"
+			};
+		}
+		logger_default.warn("自定义配置文件缺少有效的 CLI 路径，将尝试使用默认路径。");
+	} catch (error) {
+		const reason = error instanceof Error ? error.message : String(error);
+		logger_default.warn(`解析自定义配置失败，将尝试使用默认路径。原因：${reason}`);
+	}
+	const fallbackPath = await getDefaultCliPath();
+	if (fallbackPath) return {
+		cliPath: fallbackPath,
+		locale: void 0,
+		source: "default"
+	};
+	return {
+		cliPath: "",
+		locale: void 0,
+		source: "missing"
+	};
+}
+/**
+* @description 获取用户配置的语言偏好。
+*/
+async function getConfiguredLocale() {
+	return (await readCustomConfig()).locale;
+}
+//#endregion
+//#region src/cli/resolver.ts
+/**
+* @description 解析 CLI 路径并校验可用性
+*/
+async function resolveCliPath() {
+	const config = await getConfig();
+	if (!config.cliPath) return {
+		cliPath: null,
+		source: config.source
+	};
+	return {
+		cliPath: await fs.pathExists(config.cliPath) ? config.cliPath : null,
+		source: config.source
+	};
+}
+//#endregion
 //#region src/cli/automator.ts
+const ERROR_STACK_PREFIX_RE = /^at /;
+const ERROR_PREFIX_RE = /^\[error\]\s*/i;
+const ERROR_LABEL_PREFIX_RE = /^error\s*:\s*/i;
+const ERROR_LINE_SPLIT_RE = /\r?\n/;
+const LOGIN_REQUIRED_CN_RE = /需要重新登录/;
+const LOGIN_REQUIRED_EN_RE = /need\s+re-?login|re-?login/i;
+const LOGIN_REQUIRED_CODE_RE = /code\s*[:=]\s*(\d+)/i;
 const DEVTOOLS_HTTP_PORT_ERROR = "Failed to launch wechat web devTools, please make sure http port is open";
 const DEVTOOLS_INFRA_ERROR_PATTERNS = [
 	/listen EPERM/i,
@@ -31,57 +258,40 @@ const DEVTOOLS_LOGIN_REQUIRED_PATTERNS = [
 	/need\s+re-?login/i,
 	/re-?login/i
 ];
-let localhostListenPatched = false;
-function patchNetListenToLoopback() {
-	if (localhostListenPatched) return;
-	localhostListenPatched = true;
-	const rawListen = net.Server.prototype.listen;
-	net.Server.prototype.listen = function patchedListen(...args) {
-		const firstArg = args[0];
-		if (firstArg && typeof firstArg === "object" && !Array.isArray(firstArg)) {
-			if (!("host" in firstArg) || !firstArg.host) args[0] = {
-				...firstArg,
-				host: "127.0.0.1"
-			};
-			return rawListen.apply(this, args);
-		}
-		if ((typeof firstArg === "number" || typeof firstArg === "string") && typeof args[1] !== "string") args.splice(1, 0, "127.0.0.1");
-		return rawListen.apply(this, args);
-	};
-}
 /**
-* @description Extract error text from various error types
+* @description 从错误对象中提取可读文本。
 */
 function extractErrorText(error) {
 	if (!error || typeof error !== "object") return "";
-	const parts = [];
 	const candidate = error;
-	for (const field of [
+	return [
 		candidate.message,
 		candidate.shortMessage,
 		candidate.stderr,
 		candidate.stdout
-	]) if (typeof field === "string" && field.trim()) parts.push(field);
-	return parts.join("\n");
+	].filter((value) => typeof value === "string" && value.trim().length > 0).join("\n");
 }
+/**
+* @description 提取登录失效时最适合展示给用户的一行信息。
+*/
 function extractLoginRequiredMessage(text) {
 	if (!text) return "";
-	if (/需要重新登录/.test(text)) return "需要重新登录";
-	const englishMatch = text.match(/need\s+re-?login|re-?login/i);
+	if (LOGIN_REQUIRED_CN_RE.test(text)) return "需要重新登录";
+	const englishMatch = text.match(LOGIN_REQUIRED_EN_RE);
 	if (englishMatch?.[0]) return englishMatch[0].toLowerCase();
-	const firstLine = text.split(/\r?\n/).map((line) => line.trim()).find((line) => Boolean(line) && !line.startsWith("at "));
+	const firstLine = text.split(ERROR_LINE_SPLIT_RE).map((line) => line.trim()).find((line) => Boolean(line) && !ERROR_STACK_PREFIX_RE.test(line));
 	if (!firstLine) return "";
-	return firstLine.replace(/^\[error\]\s*/i, "").replace(/^error\s*:\s*/i, "").slice(0, 120);
+	return firstLine.replace(ERROR_PREFIX_RE, "").replace(ERROR_LABEL_PREFIX_RE, "").slice(0, 120);
 }
 /**
-* @description Check if error is a DevTools HTTP port error
+* @description 判断错误是否属于开发者工具服务端口不可用。
 */
 function isDevtoolsHttpPortError(error) {
 	const message = error instanceof Error ? error.message : String(error);
 	return message.includes(DEVTOOLS_HTTP_PORT_ERROR) || DEVTOOLS_INFRA_ERROR_PATTERNS.some((pattern) => pattern.test(message));
 }
 /**
-* @description Check if error is a login required error
+* @description 判断错误是否属于开发者工具登录失效。
 */
 function isAutomatorLoginError(error) {
 	const text = extractErrorText(error);
@@ -89,11 +299,11 @@ function isAutomatorLoginError(error) {
 	return DEVTOOLS_LOGIN_REQUIRED_PATTERNS.some((pattern) => pattern.test(text));
 }
 /**
-* @description Format login error for display
+* @description 格式化开发者工具登录失效错误，便于终端展示。
 */
 function formatAutomatorLoginError(error) {
 	const text = extractErrorText(error);
-	const code = text.match(/code\s*[:=]\s*(\d+)/i)?.[1];
+	const code = text.match(LOGIN_REQUIRED_CODE_RE)?.[1];
 	const message = extractLoginRequiredMessage(text);
 	const lines = ["微信开发者工具返回登录错误："];
 	if (code) lines.push(`- code: ${code}`);
@@ -102,12 +312,13 @@ function formatAutomatorLoginError(error) {
 	return lines.join("\n");
 }
 /**
-* @description Launch automator with default options
+* @description 基于当前配置解析 CLI 路径，并通过现代化 automator 入口启动会话。
 */
 async function launchAutomator(options) {
-	patchNetListenToLoopback();
-	const { projectPath, timeout = 3e4 } = options;
-	return automator.launch({
+	const { cliPath, projectPath, timeout = 3e4 } = options;
+	const resolvedCliPath = cliPath ?? (await resolveCliPath()).cliPath ?? void 0;
+	return await new Launcher().launch({
+		cliPath: resolvedCliPath,
 		projectPath,
 		timeout
 	});
@@ -178,10 +389,20 @@ function readLangOption(argv) {
 	}
 }
 //#endregion
-//#region src/logger.ts
-var logger_default = logger;
-//#endregion
 //#region src/cli/automator-session.ts
+function normalizeMiniProgramConnectionError(error) {
+	if (isAutomatorLoginError(error)) {
+		logger_default.error(i18nText("检测到微信开发者工具登录状态失效，请先登录后重试。", "Wechat DevTools login has expired. Please login and retry."));
+		logger_default.warn(formatAutomatorLoginError(error));
+		return /* @__PURE__ */ new Error("DEVTOOLS_LOGIN_REQUIRED");
+	}
+	if (isDevtoolsHttpPortError(error)) {
+		logger_default.error(i18nText("无法连接到微信开发者工具，请确保已开启 HTTP 服务端口。", "Cannot connect to Wechat DevTools. Please ensure HTTP service port is enabled."));
+		logger_default.warn(i18nText("请在微信开发者工具中：设置 -> 安全设置 -> 开启服务端口", "Please enable service port in Wechat DevTools: Settings -> Security -> Service Port"));
+		return /* @__PURE__ */ new Error("DEVTOOLS_HTTP_PORT_ERROR");
+	}
+	return error instanceof Error ? error : new Error(String(error));
+}
 /**
 * @description 建立 automator 会话，并统一处理常见连接错误提示。
 */
@@ -193,7 +414,7 @@ async function connectMiniProgram(options) {
 	}
 }
 /**
-* @description 统一管理 automator 会话生命周期与常见连接错误提示。
+* @description 统一管理 automator 会话生命周期。
 */
 async function withMiniProgram(options, runner) {
 	let miniProgram = null;
@@ -206,19 +427,6 @@ async function withMiniProgram(options, runner) {
 		if (miniProgram) await miniProgram.close();
 	}
 }
-function normalizeMiniProgramConnectionError(error) {
-	if (isAutomatorLoginError(error)) {
-		logger_default.error(i18nText("检测到微信开发者工具登录状态失效，请先登录后重试。", "Wechat DevTools login has expired. Please login and retry."));
-		logger_default.warn(formatAutomatorLoginError(error));
-		return /* @__PURE__ */ new Error("DEVTOOLS_LOGIN_REQUIRED");
-	}
-	if (isDevtoolsHttpPortError(error)) {
-		logger_default.error(i18nText("无法连接到微信开发者工具，请确保已开启 HTTP 服务端口。", "Cannot connect to Wechat DevTools. Please ensure HTTP service port is enabled."));
-		logger_default.warn(i18nText("请在微信开发者工具中：设置 -> 安全设置 -> 开启服务端口", "Please enable service port in Wechat DevTools: Settings -> Security -> Service Port"));
-		return /* @__PURE__ */ new Error("DEVTOOLS_HTTP_PORT_ERROR");
-	}
-	return error instanceof Error ? error : new Error(String(error));
-}
 //#endregion
 //#region src/cli/commands.ts
 var commands_exports = /* @__PURE__ */ __exportAll({
@@ -238,50 +446,106 @@ var commands_exports = /* @__PURE__ */ __exportAll({
 	takeScreenshot: () => takeScreenshot,
 	tap: () => tap
 });
+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 withMiniProgram(options, async (miniProgram) => {
+	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 withMiniProgram(options, async (miniProgram) => {
+	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 withMiniProgram(options, async (miniProgram) => {
-		const info = await miniProgram.systemInfo();
-		printStructuredResult(info, options.json, i18nText("系统信息：", "System info:"));
-		return info;
+	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 withMiniProgram(options, async (miniProgram) => {
-		const data = await (await miniProgram.currentPage()).data(options.path);
-		printStructuredResult(data, options.json, i18nText("页面数据：", "Page data:"));
-		return data;
+	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)}...`));
@@ -289,6 +553,9 @@ async function tap(options) {
 		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)}...`));
@@ -298,6 +565,9 @@ async function input(options) {
 		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))}...`));
@@ -305,12 +575,15 @@ async function scrollTo(options) {
 		logger_default.success(i18nText(`已滚动到位置 ${colors.cyan(String(options.scrollTop))}`, `Scrolled to position ${colors.cyan(String(options.scrollTop))}`));
 	});
 }
+/**
+* @description 执行体验评分审计。
+*/
 async function audit(options) {
-	return withMiniProgram(options, async (miniProgram) => {
+	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));
+			await fs$1.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;
 		}
@@ -318,8 +591,11 @@ async function audit(options) {
 		return result;
 	});
 }
+/**
+* @description 获取当前小程序截图。
+*/
 async function takeScreenshot(options) {
-	return withMiniProgram(options, async (miniProgram) => {
+	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) {
 			logger_default.info(i18nText(`正在跳转页面 ${colors.cyan(options.page)}...`, `Navigating to page ${colors.cyan(options.page)}...`));
@@ -330,13 +606,16 @@ async function takeScreenshot(options) {
 		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.writeFile(options.outputPath, Buffer$1.from(base64, "base64"));
+			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 };
 	});
 }
+/**
+* @description 开关远程调试。
+*/
 async function remote(options) {
 	const enable = options.enable ?? true;
 	await withMiniProgram(options, async (miniProgram) => {
@@ -345,31 +624,5 @@ async function remote(options) {
 		logger_default.success(enable ? i18nText("远程调试已开启", "Remote debugging enabled") : i18nText("远程调试已关闭", "Remote debugging disabled"));
 	});
 }
-async function runRouteCommand(options, startMessage, successMessage, run) {
-	await withMiniProgram(options, async (miniProgram) => {
-		logger_default.info(startMessage);
-		await run(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;
-}
 //#endregion
-export { validateLocaleOption as C, launchAutomator as D, isDevtoolsHttpPortError as E, i18nText as S, isAutomatorLoginError as T, connectMiniProgram as _, navigateBack as a, logger_default as b, pageStack as c, remote as d, scrollTo as f, tap as g, takeScreenshot as h, input as i, 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, formatAutomatorLoginError as w, configureLocaleFromArgv as x, colors as y };
+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 };