weapp-ide-cli 5.1.1 → 5.1.3

package/dist/{cli-Dv5EAvYh.js → cli-BkQJ3Aww.js}

@@ -1,10 +1,10 @@
-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 { A as createLocaleConfig, B as operatingSystemName, E as resolveCliPath, F as defaultCustomConfigFilePath, H as logger_default, I as resolvePath, M as readCustomConfig, N as removeCustomConfigKey, O as getConfiguredLocale, V as colors, _ as connectMiniProgram, a as navigateBack, b as i18nText, c as pageStack, d as remote, f as scrollTo, g as tap, i as input, j as overwriteCustomConfig, k as createCustomConfig, l as reLaunch, m as systemInfo, o as navigateTo, p as switchTab, r as currentPage, s as pageData, t as audit, u as redirectTo, x as validateLocaleOption, y as configureLocaleFromArgv, z as isOperatingSystemSupported } from "./commands-CSbpftLN.js";
 import fs from "fs-extra";
-import path from "pathe";
-import os from "node:os";
+import process, { stdin, stdout } from "node:process";
 import { createInterface } from "node:readline/promises";
+import { inspect } from "node:util";
 import { emitKeypressEvents } from "node:readline";
+import { cac } from "cac";
 //#region src/cli/automator-argv.ts
 /**
 * @description 解析 automator 命令通用参数与位置参数。
@@ -182,7 +182,7 @@ async function runScreenshot(argv) {
 	}
 	const options = parseScreenshotArgs(argv);
 	const isJsonOutput = argv.includes("--json");
-	const { takeScreenshot } = await import("./commands-9F3ycbXU.js").then((n) => n.n);
+	const { takeScreenshot } = await import("./commands-CSbpftLN.js").then((n) => n.n);
 	const result = await takeScreenshot(options);
 	if (isJsonOutput) {
 		console.log(JSON.stringify(result, null, 2));
@@ -192,6 +192,43 @@ async function runScreenshot(argv) {
 }
 //#endregion
 //#region src/cli/run-automator.ts
+const COMMON_OPTION_DEFINITIONS = [
+	{
+		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"
+		}
+	}
+];
 const COMMON_ALLOWED_OPTIONS = new Set([
 	"-p",
 	"--project",
@@ -202,6 +239,27 @@ const COMMON_ALLOWED_OPTIONS = new Set([
 	"-h",
 	"--help"
 ]);
+function createDefinition(input) {
+	return {
+		description: input.description,
+		usage: input.usage,
+		options: input.options ?? [],
+		allowedOptions: new Set([...COMMON_ALLOWED_OPTIONS, ...input.allowedOptions ?? []]),
+		handler: input.handler
+	};
+}
+function requiredPositional(value, errorMessage) {
+	if (!value) throw new Error(errorMessage);
+	return value;
+}
+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}'`, `Command '${command}' does not support option '${optionName}'`));
+	}
+}
 const COMMAND_DEFINITIONS = {
 	"navigate": createDefinition({
 		description: {
@@ -404,85 +462,26 @@ const COMMAND_DEFINITIONS = {
 	})
 };
 const AUTOMATOR_COMMAND_NAMES = ["screenshot", ...Object.keys(COMMAND_DEFINITIONS)];
-const AUTOMATOR_COMMANDS = new Set(AUTOMATOR_COMMAND_NAMES);
+const AUTOMATOR_COMMAND_SET = new Set(AUTOMATOR_COMMAND_NAMES);
 /**
 * @description 判断是否属于 automator 子命令。
 */
 function isAutomatorCommand(command) {
-	return Boolean(command && AUTOMATOR_COMMANDS.has(command));
+	return Boolean(command && AUTOMATOR_COMMAND_SET.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 命令帮助文本。
+* @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)}`)
+		...[...definition.options, ...COMMON_OPTION_DEFINITIONS].map((option) => `  ${option.flag.padEnd(24)} ${i18nText(option.description.zh, option.description.en)}`)
 	].join("\n");
 }
 function printCommandHelp(command) {
@@ -493,28 +492,26 @@ function printCommandHelp(command) {
 	}
 	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`));
+/**
+* @description 执行 automator 子命令。
+*/
+async function runAutomatorCommand(command, argv) {
+	if (command === "screenshot") {
+		await runScreenshot(argv);
+		return;
 	}
-}
-function requiredPositional(value, message) {
-	if (!value) throw new Error(message);
-	return value;
+	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
+	});
 }
 //#endregion
 //#region src/cli/command-catalog.ts
@@ -558,93 +555,6 @@ 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 路径
@@ -680,134 +590,6 @@ async function promptForCliPath() {
 	}
 }
 //#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 子命令。
@@ -917,6 +699,123 @@ async function handleConfigCommand(argv) {
 	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/cli/forwardConsole.ts
+const DEFAULT_FORWARD_CONSOLE_LEVELS = [
+	"log",
+	"info",
+	"warn",
+	"error"
+];
+/**
+* @description 启动小程序控制台日志转发，并保持 automator 会话常驻。
+*/
+async function startForwardConsole(options) {
+	const miniProgram = await connectMiniProgram(options);
+	const logLevels = new Set(options.logLevels?.length ? options.logLevels : DEFAULT_FORWARD_CONSOLE_LEVELS);
+	const logHandler = options.onLog ?? printForwardConsoleEvent;
+	const onConsole = (payload) => {
+		const event = normalizeConsoleEvent(payload);
+		if (!logLevels.has(event.level)) return;
+		logHandler(event);
+	};
+	const onException = (payload) => {
+		if (options.unhandledErrors === false) return;
+		logHandler(normalizeExceptionEvent(payload));
+	};
+	miniProgram.on("console", onConsole);
+	miniProgram.on("exception", onException);
+	options.onReady?.();
+	let closed = false;
+	return { async close() {
+		if (closed) return;
+		closed = true;
+		detachMiniProgramListener(miniProgram, "console", onConsole);
+		detachMiniProgramListener(miniProgram, "exception", onException);
+		await miniProgram.close();
+	} };
+}
+function detachMiniProgramListener(miniProgram, event, listener) {
+	if (typeof miniProgram.off === "function") miniProgram.off(event, listener);
+}
+function printForwardConsoleEvent(event) {
+	const line = `${colors.dim(`[mini:${event.level}]`)} ${event.message}`;
+	switch (event.level) {
+		case "error":
+			logger_default.error(line);
+			return;
+		case "warn":
+			logger_default.warn(line);
+			return;
+		case "info":
+			logger_default.info(line);
+			return;
+		default: logger_default.log(line);
+	}
+}
+function normalizeConsoleEvent(payload) {
+	const record = toPlainObject(payload);
+	return {
+		level: normalizeLogLevel(record.type ?? record.level ?? record.method),
+		message: resolveLogMessage(record, payload),
+		raw: payload
+	};
+}
+function normalizeExceptionEvent(payload) {
+	const record = toPlainObject(payload);
+	const error = toPlainObject(record.error);
+	return {
+		level: "error",
+		message: [getStringValue(error.message) ?? getStringValue(record.message), getStringValue(error.stack) ?? getStringValue(record.stack)].filter(Boolean).join("\n") || inspect(payload, {
+			depth: 4,
+			colors: false,
+			compact: true
+		}),
+		raw: payload
+	};
+}
+function normalizeLogLevel(value) {
+	const normalized = String(value ?? "log").toLowerCase();
+	if (normalized === "warning") return "warn";
+	if (normalized === "debug" || normalized === "info" || normalized === "warn" || normalized === "error") return normalized;
+	return "log";
+}
+function resolveLogMessage(record, payload) {
+	const text = getStringValue(record.text) ?? getStringValue(record.message);
+	if (text) return text;
+	if (Array.isArray(record.args) && record.args.length > 0) return record.args.map(formatConsoleArgument).join(" ");
+	if (typeof payload === "string") return payload;
+	return inspect(payload, {
+		depth: 4,
+		colors: false,
+		compact: true
+	});
+}
+function formatConsoleArgument(value) {
+	const record = toPlainObject(value);
+	const rawValue = record.value;
+	const description = getStringValue(record.description);
+	if (typeof rawValue === "string" || typeof rawValue === "number" || typeof rawValue === "boolean") return String(rawValue);
+	if (rawValue !== void 0) return inspect(rawValue, {
+		depth: 4,
+		colors: false,
+		compact: true
+	});
+	if (description) return description;
+	if (typeof value === "string") return value;
+	return inspect(value, {
+		depth: 4,
+		colors: false,
+		compact: true
+	});
+}
+function getStringValue(value) {
+	return typeof value === "string" && value.trim() ? value : void 0;
+}
+function toPlainObject(value) {
+	if (!value || typeof value !== "object") return {};
+	return value;
+}
+//#endregion
 //#region src/utils/argv.ts
 function ensurePathArgument(argv, optionIndex) {
 	const paramIdx = optionIndex + 1;
@@ -1069,10 +968,9 @@ async function waitForRetryKeypress(options = {}) {
 	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);
+		}, Number.isFinite(timeoutMs) && timeoutMs > 0 ? timeoutMs : 3e4);
 		const cleanup = () => {
 			clearTimeout(timeout);
 			process.stdin.off("keypress", onKeypress);
@@ -1258,16 +1156,8 @@ function isNonEmptyText(value) {
 }
 //#endregion
 //#region src/cli/run.ts
-const MINIDEV_NAMESPACE = new Set([
-	"alipay",
-	"ali",
-	"minidev"
-]);
-const ALIPAY_PLATFORM_ALIASES = new Set([
-	"alipay",
-	"ali",
-	"minidev"
-]);
+const MINIDEV_NAMESPACE = new Set(MINIDEV_NAMESPACE_COMMAND_NAMES);
+const ALIPAY_PLATFORM_ALIASES = new Set(MINIDEV_NAMESPACE_COMMAND_NAMES);
 const ARG_TRANSFORMS = [
 	createAlias({
 		find: "-p",
@@ -1281,40 +1171,108 @@ const ARG_TRANSFORMS = [
 	createPathCompat("-i")
 ];
 /**
+* @description 基于 cac 注册顶层命令，用于统一识别入口。
+*/
+function createCli() {
+	const cli = cac("weapp");
+	cli.command("help [command]", "显示命令帮助").allowUnknownOptions();
+	for (const command of WECHAT_CLI_COMMAND_NAMES) cli.command(command, "微信开发者工具官方命令透传").allowUnknownOptions();
+	for (const command of MINIDEV_NAMESPACE_COMMAND_NAMES) cli.command(`${command} [...args]`, "支付宝 minidev 命令透传").allowUnknownOptions();
+	cli.command(`${CONFIG_COMMAND_NAME} [...args]`, "配置 weapp-ide-cli").allowUnknownOptions();
+	for (const command of [
+		"screenshot",
+		"navigate",
+		"redirect",
+		"back",
+		"relaunch",
+		"switch-tab",
+		"page-stack",
+		"current-page",
+		"system-info",
+		"page-data",
+		"tap",
+		"input",
+		"scroll",
+		"audit",
+		"remote"
+	]) cli.command(`${command} [...args]`, "automator 增强命令").allowUnknownOptions();
+	return cli;
+}
+async function handleHelpCommand(args) {
+	const targetCommand = args[0];
+	if (!targetCommand) {
+		createCli().outputHelp();
+		return;
+	}
+	if (targetCommand === "screenshot") {
+		printScreenshotHelp();
+		return;
+	}
+	if (isAutomatorCommand(targetCommand)) {
+		const help = getAutomatorCommandHelp(targetCommand);
+		if (help) {
+			console.log(help);
+			return;
+		}
+	}
+	createCli().outputHelp();
+}
+async function handleMissingCliPath(source) {
+	const message = source === "custom" ? i18nText("在当前自定义路径中未找到微信web开发者命令行工具，请重新指定路径。", "Cannot find Wechat Web DevTools CLI in custom path, please reconfigure it.") : i18nText(`未检测到微信web开发者命令行工具，请执行 ${colors.bold(colors.green("weapp-ide-cli config"))} 指定路径。`, `Wechat Web DevTools CLI not found, please run ${colors.bold(colors.green("weapp-ide-cli config"))} to configure it.`);
+	logger_default.warn(message);
+	await promptForCliPath();
+}
+/**
+* @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");
+}
+/**
 * @description CLI 入口解析与分发。
 */
 async function parse(argv) {
 	validateLocaleOption(argv);
 	configureLocaleFromArgv(argv, await getConfiguredLocale());
-	const command = argv[0];
-	if (command && MINIDEV_NAMESPACE.has(command)) {
+	const cli = createCli();
+	cli.parse([
+		"node",
+		"weapp",
+		...argv
+	], { run: false });
+	const matchedCommand = cli.matchedCommandName;
+	if (matchedCommand === "help") {
+		await handleHelpCommand(cli.args);
+		return;
+	}
+	if (matchedCommand && MINIDEV_NAMESPACE.has(matchedCommand)) {
 		await runMinidev(argv.slice(1));
 		return;
 	}
-	if (command && isAutomatorCommand(command)) {
-		await runAutomatorCommand(command, argv.slice(1));
+	if (matchedCommand === "config") {
+		await handleConfigCommand(argv.slice(1));
 		return;
 	}
-	if (command === "help") {
-		const targetCommand = argv[1];
-		if (targetCommand === "screenshot") {
-			printScreenshotHelp();
-			return;
-		}
-		if (isAutomatorCommand(targetCommand)) {
-			await runAutomatorCommand(targetCommand, ["--help"]);
-			return;
-		}
+	if (matchedCommand && isAutomatorCommand(matchedCommand)) {
+		await runAutomatorCommand(matchedCommand, argv.slice(1));
+		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;
@@ -1322,29 +1280,10 @@ async function parse(argv) {
 	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();
+		await handleMissingCliPath(source);
 		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 };
+export { parseAutomatorArgs as A, isWeappIdeTopLevelCommand as C, runAutomatorCommand as D, isAutomatorCommand as E, removeOption as M, parseScreenshotArgs as O, WECHAT_CLI_COMMAND_NAMES as S, getAutomatorCommandHelp as T, handleConfigCommand as _, createWechatIdeLoginRequiredExitError as a, MINIDEV_NAMESPACE_COMMAND_NAMES as b, formatWechatIdeLoginRequiredError as c, runMinidev as d, execute as f, startForwardConsole as g, transformArgv as h, runWechatCliWithRetry as i, readOptionValue as j, printScreenshotHelp as k, isWechatIdeLoginRequiredError as l, createPathCompat as m, parse as n, extractExecutionErrorText as o, createAlias as p, validateWechatCliCommandArgs as r, formatRetryHotkeyPrompt as s, createCli as t, waitForRetryKeypress as u, promptForCliPath as v, AUTOMATOR_COMMAND_NAMES as w, WEAPP_IDE_TOP_LEVEL_COMMAND_NAMES as x, CONFIG_COMMAND_NAME as y };