weapp-ide-cli 5.0.4 → 5.1.1

package/dist/cli-Dv5EAvYh.js

@@ -0,0 +1,1350 @@
+import { S as validateLocaleOption, a as navigateBack, b as configureLocaleFromArgv, c as pageStack, d as remote, f as scrollTo, g as tap, i as input, l as reLaunch, m as systemInfo, o as navigateTo, p as switchTab, r as currentPage, s as pageData, t as audit, u as redirectTo, v as colors, x as i18nText, y as logger_default } from "./commands-9F3ycbXU.js";
+import process, { stdin, stdout } from "node:process";
+import fs from "fs-extra";
+import path from "pathe";
+import os from "node:os";
+import { createInterface } from "node:readline/promises";
+import { emitKeypressEvents } from "node:readline";
+//#region src/cli/automator-argv.ts
+/**
+* @description 解析 automator 命令通用参数与位置参数。
+*/
+function parseAutomatorArgs(argv) {
+	const positionals = [];
+	let projectPath = process.cwd();
+	let timeout;
+	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 === "--json") {
+			json = true;
+			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,
+		json,
+		positionals
+	};
+}
+/**
+* @description 读取选项值，支持 --option value 与 --option=value。
+*/
+function readOptionValue(argv, optionName) {
+	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 删除参数中的指定选项（同时支持 --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;
+}
+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 === "-o" || optionName === "--output" || optionName === "--page" || optionName === "--login-retry" || optionName === "--login-retry-timeout" || optionName === "--lang" || optionName === "--platform" || optionName === "--qr-output" || optionName === "-r" || optionName === "--result-output" || optionName === "--info-output" || optionName === "-i";
+}
+//#endregion
+//#region src/cli/screenshot.ts
+/**
+* @description Print help for screenshot command
+*/
+function printScreenshotHelp() {
+	console.log(i18nText(`
+${colors.bold("Usage:")} weapp screenshot [options]
+
+${colors.bold("参数:")}
+  -p, --project <path>   项目路径（默认：当前目录）
+  -o, --output <path>    截图输出文件路径
+      --page <path>      截图前先跳转页面
+  -t, --timeout <ms>     连接超时时间（默认：30000）
+      --json             以 JSON 格式输出
+      --lang <lang>      语言切换：zh | en（默认：zh）
+  -h, --help             显示此帮助信息
+
+${colors.bold("示例:")}
+  # 输出 base64 到 stdout
+  weapp screenshot -p /path/to/project
+
+  # 保存到文件
+  weapp screenshot -p /path/to/project -o screenshot.png
+
+  # 先跳转页面再截图
+  weapp screenshot -p /path/to/project --page pages/index/index
+
+  # 以 JSON 输出便于脚本解析
+  weapp screenshot -p /path/to/project --json
+`, `
+${colors.bold("Usage:")} weapp screenshot [options]
+
+${colors.bold("Options:")}
+  -p, --project <path>   Project path (default: current directory)
+  -o, --output <path>    Output file path for screenshot
+      --page <path>      Navigate to page before taking screenshot
+  -t, --timeout <ms>     Connection timeout in milliseconds (default: 30000)
+      --json             Output as JSON format
+      --lang <lang>      Language: zh | en (default: zh)
+  -h, --help             Show this help message
+
+${colors.bold("Examples:")}
+  # Output base64 to stdout
+  weapp screenshot -p /path/to/project
+
+  # Save to file
+  weapp screenshot -p /path/to/project -o screenshot.png
+
+  # Navigate to page first
+  weapp screenshot -p /path/to/project --page pages/index/index
+
+  # JSON output for parsing
+  weapp screenshot -p /path/to/project --json
+`));
+}
+/**
+* @description Parse command line arguments for screenshot command
+*/
+function parseScreenshotArgs(argv) {
+	const parsed = parseAutomatorArgs(argv);
+	return {
+		projectPath: parsed.projectPath,
+		timeout: parsed.timeout,
+		outputPath: readOptionValue(argv, "-o") || readOptionValue(argv, "--output"),
+		page: readOptionValue(argv, "--page")
+	};
+}
+/**
+* @description 运行截图命令并处理输出格式。
+*/
+async function runScreenshot(argv) {
+	if (argv.includes("-h") || argv.includes("--help")) {
+		printScreenshotHelp();
+		return;
+	}
+	const options = parseScreenshotArgs(argv);
+	const isJsonOutput = argv.includes("--json");
+	const { takeScreenshot } = await import("./commands-9F3ycbXU.js").then((n) => n.n);
+	const result = await takeScreenshot(options);
+	if (isJsonOutput) {
+		console.log(JSON.stringify(result, null, 2));
+		return;
+	}
+	if (result.base64) console.log(result.base64);
+}
+//#endregion
+//#region src/cli/run-automator.ts
+const COMMON_ALLOWED_OPTIONS = new Set([
+	"-p",
+	"--project",
+	"-t",
+	"--timeout",
+	"--json",
+	"--lang",
+	"-h",
+	"--help"
+]);
+const COMMAND_DEFINITIONS = {
+	"navigate": createDefinition({
+		description: {
+			zh: "跳转到页面（保留当前页面栈）",
+			en: "Navigate to a page (keep current page in stack)"
+		},
+		usage: "weapp navigate <url> -p <project-path>",
+		handler: async ({ args }) => {
+			const url = requiredPositional(args.positionals[0], i18nText("navigate 命令缺少 URL 参数", "URL is required for 'navigate' command"));
+			await navigateTo({
+				...args,
+				url
+			});
+		}
+	}),
+	"redirect": createDefinition({
+		description: {
+			zh: "重定向到页面（关闭当前页面）",
+			en: "Redirect to a page (close current page)"
+		},
+		usage: "weapp redirect <url> -p <project-path>",
+		handler: async ({ args }) => {
+			const url = requiredPositional(args.positionals[0], i18nText("redirect 命令缺少 URL 参数", "URL is required for 'redirect' command"));
+			await redirectTo({
+				...args,
+				url
+			});
+		}
+	}),
+	"back": createDefinition({
+		description: {
+			zh: "返回上一页",
+			en: "Navigate back to previous page"
+		},
+		usage: "weapp back -p <project-path>",
+		handler: async ({ args }) => {
+			await navigateBack(args);
+		}
+	}),
+	"relaunch": createDefinition({
+		description: {
+			zh: "重启到页面（关闭全部页面）",
+			en: "Re-launch to a page (close all pages)"
+		},
+		usage: "weapp relaunch <url> -p <project-path>",
+		handler: async ({ args }) => {
+			const url = requiredPositional(args.positionals[0], i18nText("relaunch 命令缺少 URL 参数", "URL is required for 'relaunch' command"));
+			await reLaunch({
+				...args,
+				url
+			});
+		}
+	}),
+	"switch-tab": createDefinition({
+		description: {
+			zh: "切换到 tabBar 页面",
+			en: "Switch to a tab bar page"
+		},
+		usage: "weapp switch-tab <url> -p <project-path>",
+		handler: async ({ args }) => {
+			const url = requiredPositional(args.positionals[0], i18nText("switch-tab 命令缺少 URL 参数", "URL is required for 'switch-tab' command"));
+			await switchTab({
+				...args,
+				url
+			});
+		}
+	}),
+	"page-stack": createDefinition({
+		description: {
+			zh: "获取页面栈",
+			en: "Get the page stack"
+		},
+		usage: "weapp page-stack -p <project-path>",
+		handler: async ({ args }) => {
+			await pageStack(args);
+		}
+	}),
+	"current-page": createDefinition({
+		description: {
+			zh: "获取当前页面信息",
+			en: "Get current page info"
+		},
+		usage: "weapp current-page -p <project-path>",
+		handler: async ({ args }) => {
+			await currentPage(args);
+		}
+	}),
+	"system-info": createDefinition({
+		description: {
+			zh: "获取系统信息",
+			en: "Get system info"
+		},
+		usage: "weapp system-info -p <project-path>",
+		handler: async ({ args }) => {
+			await systemInfo(args);
+		}
+	}),
+	"page-data": createDefinition({
+		description: {
+			zh: "获取页面数据",
+			en: "Get page data"
+		},
+		usage: "weapp page-data [path] -p <project-path>",
+		handler: async ({ args }) => {
+			await pageData({
+				...args,
+				path: args.positionals[0]
+			});
+		}
+	}),
+	"tap": createDefinition({
+		description: {
+			zh: "点击元素",
+			en: "Tap an element"
+		},
+		usage: "weapp tap <selector> -p <project-path>",
+		handler: async ({ args }) => {
+			const selector = requiredPositional(args.positionals[0], i18nText("tap 命令缺少 selector 参数", "Selector is required for tap command"));
+			await tap({
+				...args,
+				selector
+			});
+		}
+	}),
+	"input": createDefinition({
+		description: {
+			zh: "向元素输入文本",
+			en: "Input text into an element"
+		},
+		usage: "weapp input <selector> <value> -p <project-path>",
+		handler: async ({ args }) => {
+			const errorMessage = i18nText("input 命令缺少 selector 或 value 参数", "Selector and value are required for input command");
+			const selector = requiredPositional(args.positionals[0], errorMessage);
+			const value = requiredPositional(args.positionals[1], errorMessage);
+			await input({
+				...args,
+				selector,
+				value
+			});
+		}
+	}),
+	"scroll": createDefinition({
+		description: {
+			zh: "滚动页面到指定位置",
+			en: "Scroll page to position"
+		},
+		usage: "weapp scroll <scrollTop> -p <project-path>",
+		handler: async ({ args }) => {
+			const rawScrollTop = requiredPositional(args.positionals[0], i18nText("scroll 命令缺少滚动位置参数", "Scroll position is required for scroll command"));
+			const scrollTop = Number.parseInt(rawScrollTop, 10);
+			if (!Number.isFinite(scrollTop)) throw new TypeError(i18nText(`无效的滚动位置: ${rawScrollTop}`, `Invalid scroll position: ${rawScrollTop}`));
+			await scrollTo({
+				...args,
+				scrollTop
+			});
+		}
+	}),
+	"audit": createDefinition({
+		description: {
+			zh: "执行体验评分审计",
+			en: "Run experience audit"
+		},
+		usage: "weapp audit -p <project-path>",
+		options: [{
+			flag: "-o, --output <path>",
+			description: {
+				zh: "审计报告输出文件路径",
+				en: "Output file path for report"
+			}
+		}],
+		allowedOptions: ["-o", "--output"],
+		handler: async ({ args, argv }) => {
+			const outputPath = readOptionValue(argv, "-o") || readOptionValue(argv, "--output");
+			await audit({
+				...args,
+				outputPath
+			});
+		}
+	}),
+	"remote": createDefinition({
+		description: {
+			zh: "开启/关闭远程调试",
+			en: "Enable/disable remote debugging"
+		},
+		usage: "weapp remote -p <project-path>",
+		options: [{
+			flag: "--disable",
+			description: {
+				zh: "关闭远程调试",
+				en: "Disable remote debugging"
+			}
+		}],
+		allowedOptions: ["--disable"],
+		handler: async ({ args, argv }) => {
+			await remote({
+				...args,
+				enable: !argv.includes("--disable")
+			});
+		}
+	})
+};
+const AUTOMATOR_COMMAND_NAMES = ["screenshot", ...Object.keys(COMMAND_DEFINITIONS)];
+const AUTOMATOR_COMMANDS = new Set(AUTOMATOR_COMMAND_NAMES);
+/**
+* @description 判断是否属于 automator 子命令。
+*/
+function isAutomatorCommand(command) {
+	return Boolean(command && AUTOMATOR_COMMANDS.has(command));
+}
+/**
+* @description 分发 automator 子命令。
+*/
+async function runAutomatorCommand(command, argv) {
+	if (command === "screenshot") {
+		await runScreenshot(argv);
+		return;
+	}
+	const definition = COMMAND_DEFINITIONS[command];
+	if (!definition) throw new Error(i18nText(`未知 automator 命令: ${command}`, `Unknown automator command: ${command}`));
+	if (argv.includes("-h") || argv.includes("--help")) {
+		printCommandHelp(command);
+		return;
+	}
+	validateUnsupportedOptions(command, argv, definition.allowedOptions);
+	const args = parseAutomatorArgs(argv);
+	await definition.handler({
+		argv,
+		args
+	});
+}
+/**
+* @description 获取 automator 命令帮助文本。
+*/
+function getAutomatorCommandHelp(command) {
+	const definition = COMMAND_DEFINITIONS[command];
+	if (!definition) return;
+	const optionLines = [
+		...definition.options,
+		{
+			flag: "-p, --project <path>",
+			description: {
+				zh: "项目路径（默认：当前目录）",
+				en: "Project path (default: current directory)"
+			}
+		},
+		{
+			flag: "-t, --timeout <ms>",
+			description: {
+				zh: "连接超时时间（默认：30000）",
+				en: "Connection timeout (default: 30000)"
+			}
+		},
+		{
+			flag: "--json",
+			description: {
+				zh: "支持时以 JSON 输出",
+				en: "Output as JSON when supported"
+			}
+		},
+		{
+			flag: "--lang <lang>",
+			description: {
+				zh: "语言切换：zh | en（默认：zh）",
+				en: "Language: zh | en (default: zh)"
+			}
+		},
+		{
+			flag: "-h, --help",
+			description: {
+				zh: "显示命令帮助",
+				en: "Show command help"
+			}
+		}
+	];
+	return [
+		i18nText(definition.description.zh, definition.description.en),
+		"",
+		`Usage: ${definition.usage}`,
+		"",
+		i18nText("参数：", "Options:"),
+		...optionLines.map((option) => `  ${option.flag.padEnd(24)} ${i18nText(option.description.zh, option.description.en)}`)
+	].join("\n");
+}
+function printCommandHelp(command) {
+	const help = getAutomatorCommandHelp(command);
+	if (help) {
+		console.log(help);
+		return;
+	}
+	logger_default.warn(i18nText(`命令 ${command} 暂无帮助信息`, `No help available for command: ${command}`));
+}
+function createDefinition(input) {
+	const options = input.options ?? [];
+	const allowedOptions = new Set([...COMMON_ALLOWED_OPTIONS, ...input.allowedOptions ?? []]);
+	return {
+		description: input.description,
+		usage: input.usage,
+		options,
+		allowedOptions,
+		handler: input.handler
+	};
+}
+function validateUnsupportedOptions(command, argv, allowedOptions) {
+	for (const token of argv) {
+		if (!token.startsWith("-")) continue;
+		const optionName = token.includes("=") ? token.slice(0, token.indexOf("=")) : token;
+		if (allowedOptions.has(optionName)) continue;
+		throw new Error(i18nText(`'${command}' 命令不支持参数 '${optionName}'`, `Unknown option '${optionName}' for '${command}' command`));
+	}
+}
+function requiredPositional(value, message) {
+	if (!value) throw new Error(message);
+	return value;
+}
+//#endregion
+//#region src/cli/command-catalog.ts
+const WECHAT_CLI_COMMAND_NAMES = [
+	"open",
+	"login",
+	"islogin",
+	"preview",
+	"auto-preview",
+	"upload",
+	"build-npm",
+	"auto",
+	"auto-replay",
+	"reset-fileutils",
+	"close",
+	"quit",
+	"cache",
+	"engine",
+	"open-other",
+	"build-ipa",
+	"build-apk",
+	"cloud"
+];
+const MINIDEV_NAMESPACE_COMMAND_NAMES = [
+	"alipay",
+	"ali",
+	"minidev"
+];
+const CONFIG_COMMAND_NAME = "config";
+const WEAPP_IDE_TOP_LEVEL_COMMAND_NAMES = [
+	...WECHAT_CLI_COMMAND_NAMES,
+	...AUTOMATOR_COMMAND_NAMES,
+	...MINIDEV_NAMESPACE_COMMAND_NAMES,
+	CONFIG_COMMAND_NAME
+];
+const WEAPP_IDE_TOP_LEVEL_COMMAND_SET = new Set(WEAPP_IDE_TOP_LEVEL_COMMAND_NAMES);
+/**
+* @description 判断是否为 weapp-ide-cli 支持的顶层命令。
+*/
+function isWeappIdeTopLevelCommand(command) {
+	return Boolean(command && WEAPP_IDE_TOP_LEVEL_COMMAND_SET.has(command));
+}
+//#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/cli/prompt.ts
+/**
+* @description 交互式提示并保存 CLI 路径
+*/
+async function promptForCliPath() {
+	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.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/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/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/config-command.ts
+/**
+* @description 处理 config 子命令。
+*/
+async function handleConfigCommand(argv) {
+	const action = argv[0];
+	if (!action) {
+		await promptForCliPath();
+		return;
+	}
+	if (action === "lang" || action === "set-lang") {
+		const nextLocale = argv[1];
+		if (nextLocale !== "zh" && nextLocale !== "en") throw new Error(i18nText("请使用 weapp config lang <zh|en> 切换语言", "Use weapp config lang <zh|en> to switch language"));
+		await createLocaleConfig(nextLocale);
+		logger_default.info(i18nText(`语言已切换为：${nextLocale === "zh" ? "中文" : "英文"}`, `Language switched to: ${nextLocale}`));
+		return;
+	}
+	if (action === "show") {
+		const config = await readCustomConfig();
+		logger_default.info(i18nText(`配置文件路径：${colors.green(defaultCustomConfigFilePath)}`, `Config file: ${colors.green(defaultCustomConfigFilePath)}`));
+		console.log(JSON.stringify(config, null, 2));
+		return;
+	}
+	if (action === "get") {
+		const key = argv[1];
+		if (key !== "cliPath" && key !== "locale") throw new Error(i18nText("仅支持读取配置项：cliPath | locale", "Supported keys: cliPath | locale"));
+		const value = (await readCustomConfig())[key];
+		if (typeof value === "string") {
+			console.log(value);
+			return;
+		}
+		console.log("");
+		return;
+	}
+	if (action === "set") {
+		const key = argv[1];
+		const value = argv.slice(2).join(" ").trim();
+		if (!value) throw new Error(i18nText("请提供配置值，例如：weapp config set locale en", "Please provide a value, e.g. weapp config set locale en"));
+		if (key === "cliPath") {
+			await createCustomConfig({ cliPath: value });
+			logger_default.info(i18nText("CLI 路径已更新。", "CLI path updated."));
+			return;
+		}
+		if (key === "locale") {
+			if (value !== "zh" && value !== "en") throw new Error(i18nText("locale 仅支持 zh 或 en", "locale only supports zh or en"));
+			await createLocaleConfig(value);
+			logger_default.info(i18nText(`语言已切换为：${value === "zh" ? "中文" : "英文"}`, `Language switched to: ${value}`));
+			return;
+		}
+		throw new Error(i18nText("仅支持设置配置项：cliPath | locale", "Supported keys for set: cliPath | locale"));
+	}
+	if (action === "unset") {
+		const key = argv[1];
+		if (key !== "cliPath" && key !== "locale") throw new Error(i18nText("仅支持清除配置项：cliPath | locale", "Supported keys for unset: cliPath | locale"));
+		await removeCustomConfigKey(key);
+		logger_default.info(i18nText(`已清除配置项：${key}`, `Config key cleared: ${key}`));
+		return;
+	}
+	if (action === "doctor") {
+		const rawConfig = await readCustomConfig();
+		const hasConfigFile = await fs.pathExists(defaultCustomConfigFilePath);
+		const resolvedCli = await resolveCliPath();
+		const hasCustomCli = typeof rawConfig.cliPath === "string" && rawConfig.cliPath.length > 0;
+		const hasValidCli = Boolean(resolvedCli.cliPath);
+		const locale = rawConfig.locale ?? "zh";
+		const report = {
+			configFile: defaultCustomConfigFilePath,
+			configFileExists: hasConfigFile,
+			cliPath: rawConfig.cliPath ?? null,
+			cliPathValid: hasValidCli,
+			locale,
+			source: resolvedCli.source
+		};
+		logger_default.info(i18nText("配置诊断结果：", "Configuration diagnostics:"));
+		console.log(JSON.stringify(report, null, 2));
+		if (!hasConfigFile) logger_default.warn(i18nText("未找到配置文件，可执行 weapp config 进行初始化。", "Config file not found. Run `weapp config` to initialize."));
+		if (hasCustomCli && !hasValidCli) logger_default.warn(i18nText("检测到配置的 cliPath 不可用，请执行 weapp config set cliPath <path> 修复。", "Configured cliPath is not available. Run `weapp config set cliPath <path>` to fix it."));
+		return;
+	}
+	if (action === "export") {
+		const outputPath = argv[1];
+		const config = await readCustomConfig();
+		if (outputPath) {
+			await fs.writeJSON(outputPath, config, {
+				spaces: 2,
+				encoding: "utf8"
+			});
+			logger_default.info(i18nText(`配置已导出到：${colors.green(outputPath)}`, `Config exported to: ${colors.green(outputPath)}`));
+			return;
+		}
+		console.log(JSON.stringify(config, null, 2));
+		return;
+	}
+	if (action === "import") {
+		const inputPath = argv[1];
+		if (!inputPath) throw new Error(i18nText("请提供导入文件路径，例如：weapp config import ./weapp-config.json", "Please provide import file path, e.g. weapp config import ./weapp-config.json"));
+		const imported = await fs.readJSON(inputPath);
+		if (!imported || typeof imported !== "object") throw new Error(i18nText("导入文件格式无效：应为 JSON 对象", "Invalid import file format: expected a JSON object"));
+		const candidate = imported;
+		await overwriteCustomConfig({
+			cliPath: typeof candidate.cliPath === "string" ? candidate.cliPath : void 0,
+			locale: candidate.locale === "zh" || candidate.locale === "en" ? candidate.locale : void 0
+		});
+		logger_default.info(i18nText(`配置已从 ${colors.green(inputPath)} 导入`, `Config imported from ${colors.green(inputPath)}`));
+		return;
+	}
+	throw new Error(i18nText("支持的 config 子命令：lang | set-lang | show | get | set | unset | doctor | import | export", "Supported config subcommands: lang | set-lang | show | get | set | unset | doctor | import | export"));
+}
+//#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/minidev.ts
+const MINIDEV_COMMAND = "minidev";
+function isCommandNotFound(error) {
+	return Boolean(error && typeof error === "object" && "code" in error && error.code === "ENOENT");
+}
+/**
+* @description 运行支付宝小程序 CLI（minidev）
+*/
+async function runMinidev(argv) {
+	try {
+		await execute(MINIDEV_COMMAND, [...argv]);
+	} catch (error) {
+		if (isCommandNotFound(error)) {
+			logger_default.error("未检测到支付宝小程序 CLI：minidev");
+			logger_default.warn("请先安装 minidev，可使用以下任一命令：");
+			logger_default.info(`- ${colors.green("pnpm add -g minidev")}`);
+			logger_default.info(`- ${colors.green("npm install -g minidev")}`);
+			logger_default.info(`- ${colors.green("yarn global add minidev")}`);
+			return;
+		}
+		throw error;
+	}
+}
+//#endregion
+//#region src/cli/retry.ts
+const LOGIN_REQUIRED_PATTERNS = [
+	/code\s*[:=]\s*10/i,
+	/需要重新登录/,
+	/need\s+re-?login/i,
+	/re-?login/i
+];
+/**
+* @description 判断是否为微信开发者工具登录失效错误。
+*/
+function isWechatIdeLoginRequiredError(error) {
+	const text = extractExecutionErrorText(error);
+	if (!text) return false;
+	return LOGIN_REQUIRED_PATTERNS.some((pattern) => pattern.test(text));
+}
+/**
+* @description 提取执行错误文本，便于统一匹配与提示。
+*/
+function extractExecutionErrorText(error) {
+	if (!error || typeof error !== "object") return "";
+	const parts = [];
+	const candidate = error;
+	for (const field of [
+		candidate.message,
+		candidate.shortMessage,
+		candidate.stderr,
+		candidate.stdout
+	]) if (typeof field === "string" && field.trim()) parts.push(field);
+	return parts.join("\n");
+}
+/**
+* @description 将登录失效错误格式化为更易读的摘要。
+*/
+function formatWechatIdeLoginRequiredError(error) {
+	const text = extractExecutionErrorText(error);
+	const code = text.match(/code\s*[:=]\s*(\d+)/i)?.[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 创建登录失效专用错误，并携带退出码语义。
+*/
+function createWechatIdeLoginRequiredExitError(error, reason) {
+	const summary = formatWechatIdeLoginRequiredError(error);
+	const message = reason ? `${reason}\n${summary}` : summary;
+	const loginError = new Error(message);
+	loginError.name = "WechatIdeLoginRequiredError";
+	loginError.code = 10;
+	loginError.exitCode = 10;
+	return loginError;
+}
+function extractLoginRequiredMessage(text) {
+	if (!text) return "";
+	if (/需要重新登录/.test(text)) return "需要重新登录";
+	const englishMatch = text.match(/need\s+re-?login|re-?login/i);
+	if (englishMatch?.[0]) return englishMatch[0].toLowerCase();
+	const firstLine = text.split(/\r?\n/).map((line) => line.trim()).find((line) => Boolean(line) && !line.startsWith("at "));
+	if (!firstLine) return "";
+	return firstLine.replace(/^\[error\]\s*/i, "").replace(/^error\s*:\s*/i, "").slice(0, 120);
+}
+/**
+* @description 交互等待用户按键重试，按 r 重试，按 q 或 Ctrl+C 取消。
+*/
+async function waitForRetryKeypress(options = {}) {
+	const { timeoutMs = 3e4 } = options;
+	if (!process.stdin.isTTY) return "cancel";
+	emitKeypressEvents(process.stdin);
+	const hasSetRawMode = typeof process.stdin.setRawMode === "function";
+	if (hasSetRawMode) process.stdin.setRawMode(true);
+	process.stdin.resume();
+	return new Promise((resolve) => {
+		let settled = false;
+		const normalizedTimeoutMs = Number.isFinite(timeoutMs) && timeoutMs > 0 ? timeoutMs : 3e4;
+		const timeout = setTimeout(() => {
+			done("timeout");
+		}, normalizedTimeoutMs);
+		const cleanup = () => {
+			clearTimeout(timeout);
+			process.stdin.off("keypress", onKeypress);
+			if (hasSetRawMode) process.stdin.setRawMode(false);
+			process.stdin.pause();
+		};
+		const done = (value) => {
+			if (settled) return;
+			settled = true;
+			cleanup();
+			resolve(value);
+		};
+		const onKeypress = (_str, key) => {
+			if (!key) return;
+			if (key.ctrl && key.name === "c") {
+				done("cancel");
+				return;
+			}
+			if (key.name === "r") {
+				done("retry");
+				return;
+			}
+			if (key.name === "q" || key.name === "escape") done("cancel");
+		};
+		process.stdin.on("keypress", onKeypress);
+	});
+}
+/**
+* @description 生成重试按键提示，并高亮关键热键。
+*/
+function formatRetryHotkeyPrompt(timeoutMs = 3e4) {
+	const highlight = (key) => highlightHotkey(key);
+	const timeoutSeconds = Math.max(1, Math.ceil(timeoutMs / 1e3));
+	return i18nText(`按 ${highlight("r")} 重试，按 ${highlight("q")} / ${highlight("Esc")} / ${highlight("Ctrl+C")} 退出（${timeoutSeconds}s 内无输入将自动失败）。`, `Press ${highlight("r")} to retry, ${highlight("q")} / ${highlight("Esc")} / ${highlight("Ctrl+C")} to cancel (auto fail in ${timeoutSeconds}s).`);
+}
+function highlightHotkey(key) {
+	return colors.bold(colors.green(key));
+}
+//#endregion
+//#region src/cli/run-login.ts
+/**
+* @description 运行微信开发者工具 CLI，并在登录失效时允许按键重试。
+*/
+async function runWechatCliWithRetry(cliPath, argv) {
+	const loginRetryOptions = resolveLoginRetryOptions(argv);
+	const runtimeArgv = stripLoginRetryControlFlags(argv);
+	let retryCount = 0;
+	while (true) try {
+		const result = await execute(cliPath, runtimeArgv, {
+			pipeStdout: false,
+			pipeStderr: false
+		});
+		if (!isWechatIdeLoginRequiredError(result)) {
+			flushExecutionOutput(result);
+			return;
+		}
+		if (await promptLoginRetry(result, loginRetryOptions, retryCount) === "retry") {
+			retryCount += 1;
+			logger_default.info(i18nText("正在重试连接微信开发者工具...", "Retrying to connect Wechat DevTools..."));
+			continue;
+		}
+		throw createWechatIdeLoginRequiredExitError(result);
+	} catch (error) {
+		if (!isWechatIdeLoginRequiredError(error)) throw error;
+		if (await promptLoginRetry(error, loginRetryOptions, retryCount) === "retry") {
+			retryCount += 1;
+			logger_default.info(i18nText("正在重试连接微信开发者工具...", "Retrying to connect Wechat DevTools..."));
+			continue;
+		}
+		throw createWechatIdeLoginRequiredExitError(error);
+	}
+}
+function resolveLoginRetryOptions(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"))
+	};
+}
+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;
+}
+async function promptLoginRetry(errorLike, options, retryCount) {
+	const { nonInteractive, retryMode, retryTimeoutMs } = options;
+	logger_default.error(i18nText("检测到微信开发者工具登录状态失效，请先登录后重试。", "Wechat DevTools login has expired. Please login and retry."));
+	logger_default.warn(i18nText("请先打开微信开发者工具完成登录。", "Please open Wechat DevTools and complete login first."));
+	logger_default.warn(formatWechatIdeLoginRequiredError(errorLike));
+	if (nonInteractive) {
+		logger_default.error(i18nText("当前为非交互模式，检测到登录失效后直接失败。", "Non-interactive mode enabled, failing immediately on login expiration."));
+		return "cancel";
+	}
+	if (!(retryMode === "always" || retryMode === "once" && retryCount < 1)) {
+		logger_default.info(i18nText("当前重试策略不允许继续重试。", "Current retry policy does not allow further retries."));
+		return "cancel";
+	}
+	logger_default.info(formatRetryHotkeyPrompt(retryTimeoutMs));
+	const action = await waitForRetryKeypress({ timeoutMs: retryTimeoutMs });
+	if (action === "timeout") {
+		logger_default.error(i18nText(`等待登录重试输入超时（${retryTimeoutMs}ms），已自动取消。`, `Retry prompt timed out (${retryTimeoutMs}ms), canceled automatically.`));
+		return "cancel";
+	}
+	if (action !== "retry") {
+		logger_default.info(i18nText("已取消重试。完成登录后请重新执行当前命令。", "Retry canceled. Please run the command again after login."));
+		return "cancel";
+	}
+	return "retry";
+}
+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);
+}
+//#endregion
+//#region src/cli/wechat-command-schema.ts
+/**
+* @description 在调用官方微信 CLI 前做轻量参数校验。
+*/
+function validateWechatCliCommandArgs(argv) {
+	const command = argv[0];
+	if (!command) return;
+	validatePortOption(argv);
+	validateExtAppidDependency(argv);
+	if (command === "upload") {
+		const version = readOptionValue(argv, "--version") || readOptionValue(argv, "-v");
+		const desc = readOptionValue(argv, "--desc") || readOptionValue(argv, "-d");
+		if (!isNonEmptyText(version) || !isNonEmptyText(desc)) throw new Error(i18nText("upload 命令缺少必填参数：--version/-v 和 --desc/-d", "upload command requires both --version/-v and --desc/-d"));
+	}
+	if (command === "preview") {
+		validateProjectLocator(command, argv);
+		const qrFormat = readOptionValue(argv, "--qr-format") || readOptionValue(argv, "-f");
+		if (!qrFormat) return;
+		if (![
+			"terminal",
+			"image",
+			"base64"
+		].includes(qrFormat.toLowerCase())) throw new Error(i18nText(`preview 命令的二维码格式无效: ${qrFormat}（仅支持 terminal/image/base64）`, `Invalid preview qr format: ${qrFormat} (supported: terminal/image/base64)`));
+	}
+	if (command === "upload" || command === "auto" || command === "auto-preview") validateProjectLocator(command, argv);
+}
+function validatePortOption(argv) {
+	const port = readOptionValue(argv, "--port");
+	if (!port) return;
+	const parsed = Number.parseInt(port, 10);
+	if (!Number.isFinite(parsed) || parsed <= 0) throw new Error(i18nText(`无效的 --port 值: ${port}（必须为正整数）`, `Invalid --port value: ${port} (must be a positive integer)`));
+}
+function validateProjectLocator(command, argv) {
+	const projectPath = readOptionValue(argv, "--project");
+	const appid = readOptionValue(argv, "--appid");
+	if (isNonEmptyText(projectPath) || isNonEmptyText(appid)) return;
+	throw new Error(i18nText(`${command} 命令需要提供 --project 或 --appid`, `${command} command requires --project or --appid`));
+}
+function validateExtAppidDependency(argv) {
+	if (!isNonEmptyText(readOptionValue(argv, "--ext-appid"))) return;
+	if (isNonEmptyText(readOptionValue(argv, "--project"))) return;
+	if (isNonEmptyText(readOptionValue(argv, "--appid"))) return;
+	throw new Error(i18nText("--ext-appid 需要和 --appid 一起使用（当未提供 --project 时）", "--ext-appid requires --appid when --project is not provided"));
+}
+function isNonEmptyText(value) {
+	return typeof value === "string" && value.trim().length > 0;
+}
+//#endregion
+//#region src/cli/run.ts
+const MINIDEV_NAMESPACE = new Set([
+	"alipay",
+	"ali",
+	"minidev"
+]);
+const ALIPAY_PLATFORM_ALIASES = new Set([
+	"alipay",
+	"ali",
+	"minidev"
+]);
+const ARG_TRANSFORMS = [
+	createAlias({
+		find: "-p",
+		replacement: "--project"
+	}),
+	createPathCompat("--result-output"),
+	createPathCompat("-r"),
+	createPathCompat("--qr-output"),
+	createPathCompat("-o"),
+	createPathCompat("--info-output"),
+	createPathCompat("-i")
+];
+/**
+* @description CLI 入口解析与分发。
+*/
+async function parse(argv) {
+	validateLocaleOption(argv);
+	configureLocaleFromArgv(argv, await getConfiguredLocale());
+	const command = argv[0];
+	if (command && MINIDEV_NAMESPACE.has(command)) {
+		await runMinidev(argv.slice(1));
+		return;
+	}
+	if (command && isAutomatorCommand(command)) {
+		await runAutomatorCommand(command, argv.slice(1));
+		return;
+	}
+	if (command === "help") {
+		const targetCommand = argv[1];
+		if (targetCommand === "screenshot") {
+			printScreenshotHelp();
+			return;
+		}
+		if (isAutomatorCommand(targetCommand)) {
+			await runAutomatorCommand(targetCommand, ["--help"]);
+			return;
+		}
+	}
+	const formattedArgv = transformArgv(argv, ARG_TRANSFORMS);
+	if (shouldDelegateOpenToMinidev(formattedArgv)) {
+		await runMinidev(createMinidevOpenArgv(formattedArgv));
+		return;
+	}
+	if (command === "config") {
+		await handleConfigCommand(argv.slice(1));
+		return;
+	}
+	if (!isOperatingSystemSupported(operatingSystemName)) {
+		logger_default.warn(i18nText(`微信web开发者工具不支持当前平台：${operatingSystemName} !`, `Wechat Web DevTools CLI is not supported on current platform: ${operatingSystemName}!`));
+		return;
+	}
+	validateWechatCliCommandArgs(formattedArgv);
+	const { cliPath, source } = await resolveCliPath();
+	if (!cliPath) {
+		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();
+		return;
+	}
+	await runWechatCliWithRetry(cliPath, formattedArgv);
+}
+/**
+* @description 判断 open 指令是否应分发到 minidev。
+*/
+function shouldDelegateOpenToMinidev(argv) {
+	if (argv[0] !== "open") return false;
+	const platform = readOptionValue(argv, "--platform");
+	if (!platform) return false;
+	return ALIPAY_PLATFORM_ALIASES.has(platform.toLowerCase());
+}
+/**
+* @description 将 open 命令参数转换为 minidev ide 参数。
+*/
+function createMinidevOpenArgv(argv) {
+	const nextArgv = [...argv];
+	nextArgv[0] = "ide";
+	return removeOption(nextArgv, "--platform");
+}
+//#endregion
+export { defaultCustomConfigFilePath as A, runAutomatorCommand as B, promptForCliPath as C, readCustomConfig as D, overwriteCustomConfig as E, WECHAT_CLI_COMMAND_NAMES as F, removeOption as G, printScreenshotHelp as H, isWeappIdeTopLevelCommand as I, AUTOMATOR_COMMAND_NAMES as L, CONFIG_COMMAND_NAME as M, MINIDEV_NAMESPACE_COMMAND_NAMES as N, removeCustomConfigKey as O, WEAPP_IDE_TOP_LEVEL_COMMAND_NAMES as P, getAutomatorCommandHelp as R, operatingSystemName as S, createLocaleConfig as T, parseAutomatorArgs as U, parseScreenshotArgs as V, readOptionValue as W, getConfig as _, extractExecutionErrorText as a, getDefaultCliPath as b, isWechatIdeLoginRequiredError as c, execute as d, createAlias as f, resolveCliPath as g, handleConfigCommand as h, createWechatIdeLoginRequiredExitError as i, resolvePath as j, defaultCustomConfigDirPath as k, waitForRetryKeypress as l, transformArgv as m, validateWechatCliCommandArgs as n, formatRetryHotkeyPrompt as o, createPathCompat as p, runWechatCliWithRetry as r, formatWechatIdeLoginRequiredError as s, parse as t, runMinidev as u, getConfiguredLocale as v, createCustomConfig as w, isOperatingSystemSupported as x, SupportedPlatformsMap as y, isAutomatorCommand as z };