weapp-ide-cli 5.1.1 → 5.1.3

package/dist/cli.js

@@ -1,5 +1,5 @@
-import { y as logger_default } from "./commands-9F3ycbXU.js";
-import { t as parse } from "./cli-Dv5EAvYh.js";
+import { H as logger_default } from "./commands-CSbpftLN.js";
+import { n as parse } from "./cli-BkQJ3Aww.js";
 import process from "node:process";
 //#region src/cli.ts
 parse(process.argv.slice(2)).catch((err) => {

package/dist/commands-CSbpftLN.js

@@ -0,0 +1,628 @@
+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$1 from "node:fs/promises";
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
+//#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,
+	/operation not permitted 0\.0\.0\.0/i,
+	/EACCES/i,
+	/ECONNREFUSED/i,
+	/connect ECONNREFUSED/i
+];
+const DEVTOOLS_LOGIN_REQUIRED_PATTERNS = [
+	/code\s*[:=]\s*10/i,
+	/需要重新登录/,
+	/need\s+re-?login/i,
+	/re-?login/i
+];
+/**
+* @description 从错误对象中提取可读文本。
+*/
+function extractErrorText(error) {
+	if (!error || typeof error !== "object") return "";
+	const candidate = error;
+	return [
+		candidate.message,
+		candidate.shortMessage,
+		candidate.stderr,
+		candidate.stdout
+	].filter((value) => typeof value === "string" && value.trim().length > 0).join("\n");
+}
+/**
+* @description 提取登录失效时最适合展示给用户的一行信息。
+*/
+function extractLoginRequiredMessage(text) {
+	if (!text) return "";
+	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(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_PREFIX_RE, "").replace(ERROR_LABEL_PREFIX_RE, "").slice(0, 120);
+}
+/**
+* @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 判断错误是否属于开发者工具登录失效。
+*/
+function isAutomatorLoginError(error) {
+	const text = extractErrorText(error);
+	if (!text) return false;
+	return DEVTOOLS_LOGIN_REQUIRED_PATTERNS.some((pattern) => pattern.test(text));
+}
+/**
+* @description 格式化开发者工具登录失效错误，便于终端展示。
+*/
+function formatAutomatorLoginError(error) {
+	const text = extractErrorText(error);
+	const code = text.match(LOGIN_REQUIRED_CODE_RE)?.[1];
+	const message = extractLoginRequiredMessage(text);
+	const lines = ["微信开发者工具返回登录错误："];
+	if (code) lines.push(`- code: ${code}`);
+	if (message) lines.push(`- message: ${message}`);
+	if (!code && !message) lines.push("- message: 需要重新登录");
+	return lines.join("\n");
+}
+/**
+* @description 基于当前配置解析 CLI 路径，并通过现代化 automator 入口启动会话。
+*/
+async function launchAutomator(options) {
+	const { cliPath, projectPath, timeout = 3e4 } = options;
+	const resolvedCliPath = cliPath ?? (await resolveCliPath()).cliPath ?? void 0;
+	return await new Launcher().launch({
+		cliPath: resolvedCliPath,
+		projectPath,
+		timeout
+	});
+}
+//#endregion
+//#region src/i18n.ts
+let currentLocale = "zh";
+/**
+* @description 设置当前语言。
+*/
+function setLocale(locale) {
+	currentLocale = normalizeLocale(locale);
+}
+/**
+* @description 从 argv 和环境变量中解析语言并设置。
+*/
+function configureLocaleFromArgv(argv, fallbackLocale) {
+	const localeFromArgv = readLangOption(argv);
+	if (localeFromArgv) {
+		setLocale(localeFromArgv);
+		return currentLocale;
+	}
+	if (fallbackLocale) {
+		setLocale(fallbackLocale);
+		return currentLocale;
+	}
+	const localeFromEnv = process.env.WEAPP_IDE_CLI_LANG || process.env.LANG;
+	if (localeFromEnv) {
+		setLocale(localeFromEnv);
+		return currentLocale;
+	}
+	setLocale("zh");
+	return currentLocale;
+}
+/**
+* @description 根据当前语言选择文案。
+*/
+function i18nText(zh, en) {
+	return currentLocale === "en" ? en : zh;
+}
+/**
+* @description 校验 --lang 参数是否合法。
+*/
+function validateLocaleOption(argv) {
+	const localeFromArgv = readLangOption(argv);
+	if (!localeFromArgv) return;
+	if (!isLocaleTokenSupported(localeFromArgv)) throw new Error(`不支持的语言: ${localeFromArgv}，仅支持 zh 或 en`);
+}
+function normalizeLocale(raw) {
+	if (!raw) return "zh";
+	const normalized = raw.trim().toLowerCase();
+	if (normalized === "en" || normalized.startsWith("en_") || normalized.startsWith("en-")) return "en";
+	return "zh";
+}
+function isLocaleTokenSupported(raw) {
+	const normalized = raw.trim().toLowerCase();
+	return normalized === "zh" || normalized === "en" || normalized.startsWith("zh_") || normalized.startsWith("zh-") || normalized.startsWith("en_") || normalized.startsWith("en-");
+}
+function readLangOption(argv) {
+	for (let index = 0; index < argv.length; index += 1) {
+		const token = argv[index];
+		if (!token) continue;
+		if (token === "--lang") {
+			const value = argv[index + 1];
+			return typeof value === "string" ? value : void 0;
+		}
+		if (token.startsWith("--lang=")) return token.slice(7);
+	}
+}
+//#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 会话，并统一处理常见连接错误提示。
+*/
+async function connectMiniProgram(options) {
+	try {
+		return await launchAutomator(options);
+	} catch (error) {
+		throw normalizeMiniProgramConnectionError(error);
+	}
+}
+/**
+* @description 统一管理 automator 会话生命周期。
+*/
+async function withMiniProgram(options, runner) {
+	let miniProgram = null;
+	try {
+		miniProgram = await connectMiniProgram(options);
+		return await runner(miniProgram);
+	} catch (error) {
+		throw normalizeMiniProgramConnectionError(error);
+	} finally {
+		if (miniProgram) await miniProgram.close();
+	}
+}
+//#endregion
+//#region src/cli/commands.ts
+var commands_exports = /* @__PURE__ */ __exportAll({
+	audit: () => audit,
+	currentPage: () => currentPage,
+	input: () => input,
+	navigateBack: () => navigateBack,
+	navigateTo: () => navigateTo,
+	pageData: () => pageData,
+	pageStack: () => pageStack,
+	reLaunch: () => reLaunch,
+	redirectTo: () => redirectTo,
+	remote: () => remote,
+	scrollTo: () => scrollTo,
+	switchTab: () => switchTab,
+	systemInfo: () => systemInfo,
+	takeScreenshot: () => takeScreenshot,
+	tap: () => tap
+});
+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$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;
+		}
+		console.log(JSON.stringify(result, null, 2));
+		return result;
+	});
+}
+/**
+* @description 获取当前小程序截图。
+*/
+async function takeScreenshot(options) {
+	return await withMiniProgram(options, async (miniProgram) => {
+		logger_default.info(i18nText(`正在连接 DevTools：${colors.cyan(options.projectPath)}...`, `Connecting to DevTools at ${colors.cyan(options.projectPath)}...`));
+		if (options.page) {
+			logger_default.info(i18nText(`正在跳转页面 ${colors.cyan(options.page)}...`, `Navigating to page ${colors.cyan(options.page)}...`));
+			await miniProgram.reLaunch(options.page);
+		}
+		logger_default.info(i18nText("正在截图...", "Taking screenshot..."));
+		const screenshot = await miniProgram.screenshot();
+		const base64 = typeof screenshot === "string" ? screenshot : Buffer$1.from(screenshot).toString("base64");
+		if (!base64) throw new Error(i18nText("截图失败", "Failed to capture screenshot"));
+		if (options.outputPath) {
+			await fs$1.writeFile(options.outputPath, Buffer$1.from(base64, "base64"));
+			logger_default.success(i18nText(`截图已保存到 ${colors.cyan(options.outputPath)}`, `Screenshot saved to ${colors.cyan(options.outputPath)}`));
+			return { path: options.outputPath };
+		}
+		return { base64 };
+	});
+}
+/**
+* @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 { 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 };