weapp-ide-cli 5.2.4 → 5.2.5

package/dist/{cli-CfovXw-V.js → cli-D7gUmbTG.js}

@@ -1,14 +1,23 @@
-import { $ as readCustomConfig, B as getConfiguredLocale, C as configureLocaleFromArgv, G as operatingSystemName, I as bootstrapWechatDevtoolsSettings, J as createAutoBootstrapDevtoolsConfig, K as colors, Q as overwriteCustomConfig, R as resolveCliPath, T as validateLocaleOption, V as resolveDevtoolsAutomationDefaults, W as isOperatingSystemSupported, X as createCustomConfig, Y as createAutoTrustProjectConfig, Z as createLocaleConfig, a as navigateBack, c as pageStack, d as remote, et as removeCustomConfigKey, f as scrollTo, g as tap, i as input, l as reLaunch, m as systemInfo, n as captureScreenshotBuffer, nt as defaultCustomConfigFilePath, o as navigateTo, p as switchTab, q as logger_default, r as currentPage, rt as resolvePath, s as pageData, t as audit, u as redirectTo, w as i18nText, y as connectMiniProgram } from "./commands-XD_wemcg.js";
+import { $ as readCustomConfig, B as getConfiguredLocale, C as configureLocaleFromArgv, G as operatingSystemName, I as bootstrapWechatDevtoolsSettings, J as createAutoBootstrapDevtoolsConfig, K as colors, L as detectWechatDevtoolsServicePort, Q as overwriteCustomConfig, R as resolveCliPath, S as withMiniProgram, T as validateLocaleOption, V as resolveDevtoolsAutomationDefaults, W as isOperatingSystemSupported, X as createCustomConfig, Y as createAutoTrustProjectConfig, Z as createLocaleConfig, a as navigateBack, c as pageStack, d as remote, et as removeCustomConfigKey, f as scrollTo, g as tap, i as input, l as reLaunch, m as systemInfo, n as captureScreenshotBuffer, nt as defaultCustomConfigFilePath, o as navigateTo, p as switchTab, q as logger_default, r as currentPage, rt as resolvePath, s as pageData, t as audit, u as redirectTo, w as i18nText, y as connectMiniProgram } from "./commands-XD_wemcg.js";
 import fs from "node:fs/promises";
+import path from "node:path";
 import { fs as fs$1 } from "@weapp-core/shared/fs";
 import process, { stdin, stdout } from "node:process";
 import { PNG } from "pngjs";
 import pixelmatch from "pixelmatch";
 import { createInterface } from "node:readline/promises";
-import { inspect } from "node:util";
 import { emitKeypressEvents } from "node:readline";
+import { inspect } from "node:util";
 import { cac } from "cac";
 //#region src/cli/automator-argv.ts
+function parsePositiveInt(raw) {
+	const value = Number.parseInt(raw, 10);
+	if (!Number.isFinite(value) || value <= 0) return;
+	return value;
+}
+function takesValue(optionName) {
+	return optionName === "-p" || optionName === "--project" || optionName === "-t" || optionName === "--timeout" || optionName === "-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";
+}
 /**
 * @description 解析 automator 命令通用参数与位置参数。
 */
@@ -65,19 +74,44 @@ function parseAutomatorArgs(argv) {
 	};
 }
 /**
-* @description 读取选项值，支持 --option value 与 --option=value。
+* @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();
+function readOptionValue(argv, ...optionNames) {
+	for (const optionName of optionNames) {
+		const optionWithEqual = `${optionName}=`;
+		for (let index = 0; index < argv.length; index += 1) {
+			const token = argv[index];
+			if (!token) continue;
+			if (token === optionName) {
+				const value = argv[index + 1];
+				if (typeof value !== "string") return;
+				return value.trim();
+			}
+			if (token.startsWith(optionWithEqual)) return token.slice(optionWithEqual.length).trim();
+		}
+	}
+}
+/**
+* @description 读取布尔选项，支持裸 flag、--flag=true/false 与 --flag true/false。
+*/
+function readBooleanOption(argv, ...optionNames) {
+	for (const optionName of optionNames) {
+		const optionWithEqual = `${optionName}=`;
+		for (let index = 0; index < argv.length; index += 1) {
+			const token = argv[index];
+			if (!token) continue;
+			if (token === optionName) {
+				const nextToken = argv[index + 1];
+				if (nextToken === "true") return true;
+				if (nextToken === "false") return false;
+				return true;
+			}
+			if (token.startsWith(optionWithEqual)) {
+				const rawValue = token.slice(optionWithEqual.length).trim().toLowerCase();
+				if (rawValue === "true") return true;
+				if (rawValue === "false") return false;
+			}
 		}
-		if (token.startsWith(optionWithEqual)) return token.slice(optionWithEqual.length).trim();
 	}
 }
 /**
@@ -99,14 +133,6 @@ function removeOption(argv, optionName) {
 	}
 	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/imageDiff.ts
 function readPng(buffer, label) {
@@ -783,39 +809,186 @@ function isWeappIdeTopLevelCommand(command) {
 	return Boolean(command && WEAPP_IDE_TOP_LEVEL_COMMAND_SET.has(command));
 }
 //#endregion
+//#region src/cli/inputCoordinator.ts
+const sharedSessions = /* @__PURE__ */ new Set();
+const exclusiveKeypressStack = [];
+const EXCLUSIVE_KEYPRESS_CARRYOVER_GUARD_MS = 500;
+let initialized = false;
+let rawModeEnabled = false;
+let dataListenerAttached = false;
+let keypressListenerAttached = false;
+let lastExclusiveResolvedKeypress;
+function hasInteractiveStdin() {
+	return Boolean(process.stdin?.isTTY);
+}
+function canSetRawMode() {
+	return typeof process.stdin?.setRawMode === "function";
+}
+function updateTerminalState() {
+	const shouldKeepInputActive = Array.from(sharedSessions).some((session) => !session.closed && !session.suspended) || exclusiveKeypressStack.length > 0;
+	if (canSetRawMode() && rawModeEnabled !== shouldKeepInputActive) {
+		process.stdin.setRawMode(shouldKeepInputActive);
+		rawModeEnabled = shouldKeepInputActive;
+	}
+	if (shouldKeepInputActive) {
+		process.stdin.resume();
+		return;
+	}
+	process.stdin.pause();
+}
+function handleData(chunk) {
+	if (exclusiveKeypressStack.length > 0) return;
+	for (const session of sharedSessions) {
+		if (session.closed || session.suspended || !session.options.onData) continue;
+		session.options.onData(chunk);
+	}
+}
+function handleKeypress(str, key) {
+	const activeExclusive = exclusiveKeypressStack.at(-1);
+	if (activeExclusive) {
+		const now = Date.now();
+		const signature = `${key?.ctrl ? "ctrl+" : ""}${key?.name ?? str}`;
+		if (lastExclusiveResolvedKeypress && lastExclusiveResolvedKeypress.signature === signature && now - lastExclusiveResolvedKeypress.timestamp <= EXCLUSIVE_KEYPRESS_CARRYOVER_GUARD_MS) {
+			lastExclusiveResolvedKeypress.timestamp = now;
+			return;
+		}
+		if (now < activeExclusive.ignoreUntil) return;
+		const nextValue = activeExclusive.onKeypress(str, key);
+		if (nextValue !== void 0) {
+			clearTimeout(activeExclusive.timeout);
+			exclusiveKeypressStack.pop();
+			lastExclusiveResolvedKeypress = {
+				signature,
+				timestamp: now
+			};
+			updateTerminalState();
+			activeExclusive.resolve(nextValue);
+		}
+		return;
+	}
+	for (const session of sharedSessions) {
+		if (session.closed || session.suspended || !session.options.onKeypress) continue;
+		session.options.onKeypress(str, key);
+	}
+}
+function ensureCoordinatorInitialized() {
+	if (initialized || !hasInteractiveStdin()) return;
+	emitKeypressEvents(process.stdin);
+	if (!dataListenerAttached) {
+		process.stdin.on("data", handleData);
+		dataListenerAttached = true;
+	}
+	if (!keypressListenerAttached) {
+		process.stdin.on("keypress", handleKeypress);
+		keypressListenerAttached = true;
+	}
+	initialized = true;
+}
+function createSharedInputSession(options) {
+	if (!hasInteractiveStdin()) return;
+	ensureCoordinatorInitialized();
+	const session = {
+		closed: false,
+		options,
+		suspended: false
+	};
+	sharedSessions.add(session);
+	updateTerminalState();
+	return {
+		close() {
+			if (session.closed) return;
+			session.closed = true;
+			sharedSessions.delete(session);
+			updateTerminalState();
+		},
+		resume() {
+			if (session.closed) return;
+			session.suspended = false;
+			updateTerminalState();
+		},
+		suspend() {
+			if (session.closed) return;
+			session.suspended = true;
+			updateTerminalState();
+		}
+	};
+}
+async function waitForExclusiveKeypress(options) {
+	if (!hasInteractiveStdin()) return "timeout";
+	ensureCoordinatorInitialized();
+	return await new Promise((resolve) => {
+		const normalizedTimeoutMs = Number.isFinite(options.timeoutMs) && options.timeoutMs && options.timeoutMs > 0 ? options.timeoutMs : 3e4;
+		const normalizedIgnoreInitialMs = Number.isFinite(options.ignoreInitialMs) && options.ignoreInitialMs && options.ignoreInitialMs > 0 ? options.ignoreInitialMs : 0;
+		const record = {
+			ignoreUntil: Date.now() + normalizedIgnoreInitialMs,
+			onKeypress: options.onKeypress,
+			resolve,
+			timeout: setTimeout(() => {
+				const index = exclusiveKeypressStack.lastIndexOf(record);
+				if (index >= 0) exclusiveKeypressStack.splice(index, 1);
+				updateTerminalState();
+				resolve("timeout");
+			}, normalizedTimeoutMs)
+		};
+		exclusiveKeypressStack.push(record);
+		updateTerminalState();
+	});
+}
+async function runWithSuspendedSharedInput(runner) {
+	const previousStates = /* @__PURE__ */ new Map();
+	for (const session of sharedSessions) {
+		if (session.closed) continue;
+		previousStates.set(session, session.suspended);
+		session.suspended = true;
+	}
+	if (canSetRawMode() && rawModeEnabled) {
+		process.stdin.setRawMode(false);
+		rawModeEnabled = false;
+	}
+	process.stdin.resume();
+	try {
+		return await runner();
+	} finally {
+		for (const [session, suspended] of previousStates) if (!session.closed) session.suspended = suspended;
+		updateTerminalState();
+	}
+}
+//#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;
-		}
+	return await runWithSuspendedSharedInput(async () => {
+		const rl = createInterface({
+			input: stdin,
+			output: stdout
+		});
 		try {
-			const normalizedPath = await createCustomConfig({ cliPath });
-			logger_default.info(`全局配置存储位置：${colors.green(defaultCustomConfigFilePath)}`);
-			if (!await fs$1.pathExists(normalizedPath)) logger_default.warn("在当前路径未找到微信web开发者命令行工具，请确认路径是否正确。");
-			return normalizedPath;
-		} catch (error) {
-			const reason = error instanceof Error ? error.message : String(error);
-			logger_default.error(`保存配置失败：${reason}`);
-			return null;
+			logger_default.info(`请设置 ${colors.bold("微信web开发者工具 CLI")} 的路径`);
+			logger_default.info("提示：命令行工具默认所在位置：");
+			logger_default.info(`- MacOS: ${colors.green("<安装路径>/Contents/MacOS/cli")}`);
+			logger_default.info(`- Windows: ${colors.green("<安装路径>/cli.bat")}`);
+			logger_default.info(`- Linux: ${colors.green("<安装路径>/files/bin/bin/wechat-devtools-cli")}`);
+			const cliPath = (await rl.question("请输入微信web开发者工具 CLI 路径：")).trim();
+			if (!cliPath) {
+				logger_default.error("路径不能为空，已取消本次配置。");
+				return null;
+			}
+			try {
+				const normalizedPath = await createCustomConfig({ cliPath });
+				logger_default.info(`全局配置存储位置：${colors.green(defaultCustomConfigFilePath)}`);
+				if (!await fs$1.pathExists(normalizedPath)) logger_default.warn("在当前路径未找到微信web开发者命令行工具，请确认路径是否正确。");
+				return normalizedPath;
+			} catch (error) {
+				const reason = error instanceof Error ? error.message : String(error);
+				logger_default.error(`保存配置失败：${reason}`);
+				return null;
+			}
+		} finally {
+			rl.close();
 		}
-	} finally {
-		rl.close();
-	}
+	});
 }
 //#endregion
 //#region src/cli/config-command.ts
@@ -960,6 +1133,173 @@ 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/http.ts
+const DEFAULT_WECHAT_DEVTOOLS_HTTP_PORT = 9420;
+const ENGINE_BUILD_NOT_START = "NOT_START";
+const ENGINE_BUILD_OPEN_PROJECT = "OPEN_PROJECT";
+const ENGINE_BUILD_BUILDING = "BUILDING";
+const ENGINE_BUILD_END = "END";
+const ENGINE_BUILD_ERROR = "ERROR";
+function createWechatDevtoolsHttpError(message, code) {
+	const error = new Error(message);
+	error.code = code;
+	return error;
+}
+async function resolveWechatDevtoolsHttpPort(port) {
+	if (typeof port === "number" && Number.isInteger(port) && port > 0) return port;
+	const detected = await detectWechatDevtoolsServicePort();
+	if (detected.servicePortEnabled === false) throw createWechatDevtoolsHttpError("WECHAT_DEVTOOLS_SERVICE_PORT_DISABLED", "WECHAT_DEVTOOLS_SERVICE_PORT_DISABLED");
+	return detected.servicePort ?? DEFAULT_WECHAT_DEVTOOLS_HTTP_PORT;
+}
+function createWechatDevtoolsHttpUrl(port, pathname, query) {
+	const url = new URL(`http://127.0.0.1:${port}${pathname}`);
+	for (const [key, value] of Object.entries(query)) url.searchParams.set(key, value);
+	return url;
+}
+function parseWechatDevtoolsEngineBuildResult(body) {
+	try {
+		return JSON.parse(body);
+	} catch {
+		return {};
+	}
+}
+async function requestWechatDevtoolsHttp(pathname, query, options = {}) {
+	const url = createWechatDevtoolsHttpUrl(await resolveWechatDevtoolsHttpPort(options.port), pathname, query);
+	const controller = new AbortController();
+	const timeout = setTimeout(() => {
+		controller.abort();
+	}, options.timeoutMs ?? 1e4);
+	try {
+		const response = await fetch(url, {
+			method: "GET",
+			signal: controller.signal
+		});
+		const body = await response.text();
+		if (!response.ok) throw createWechatDevtoolsHttpError(body || `HTTP ${response.status}`, "WECHAT_DEVTOOLS_HTTP_REQUEST_FAILED");
+		return body;
+	} catch (error) {
+		if (error instanceof Error && error.name === "AbortError") throw createWechatDevtoolsHttpError("WECHAT_DEVTOOLS_HTTP_TIMEOUT", "WECHAT_DEVTOOLS_HTTP_TIMEOUT");
+		throw error;
+	} finally {
+		clearTimeout(timeout);
+	}
+}
+/**
+* @description 通过微信开发者工具 HTTP 服务端口重新打开项目；若项目已打开，开发者工具会刷新当前项目。
+*/
+async function openWechatIdeProjectByHttp(projectPath, options = {}) {
+	return await requestWechatDevtoolsHttp("/open", { projectpath: path.resolve(projectPath) }, options);
+}
+/**
+* @description 通过微信开发者工具 HTTP 服务端口重置当前项目的 fileutils 状态。
+*/
+async function resetWechatIdeFileUtilsByHttp(projectPath, options = {}) {
+	return await requestWechatDevtoolsHttp("/v2/resetfileutils", { project: path.resolve(projectPath) }, options);
+}
+/**
+* @description 通过微信开发者工具 HTTP 服务端口触发 engine build。
+*/
+async function startWechatIdeEngineBuildByHttp(projectPath, options = {}) {
+	return { body: await requestWechatDevtoolsHttp("/engine/build", { projectpath: path.resolve(projectPath) }, options) };
+}
+/**
+* @description 轮询微信开发者工具 engine build 状态。
+*/
+async function pollWechatIdeEngineBuildResultByHttp(options = {}) {
+	const body = await requestWechatDevtoolsHttp("/engine/buildResult/", {}, options);
+	const parsed = parseWechatDevtoolsEngineBuildResult(body);
+	const status = parsed.status;
+	return {
+		body,
+		done: status === ENGINE_BUILD_END,
+		failed: status === ENGINE_BUILD_ERROR,
+		msg: parsed.msg,
+		status
+	};
+}
+const WECHAT_DEVTOOLS_ENGINE_BUILD_STATUSES = {
+	BUILDING: ENGINE_BUILD_BUILDING,
+	END: ENGINE_BUILD_END,
+	ERROR: ENGINE_BUILD_ERROR,
+	NOT_START: ENGINE_BUILD_NOT_START,
+	OPEN_PROJECT: ENGINE_BUILD_OPEN_PROJECT
+};
+//#endregion
+//#region src/cli/engine.ts
+function createEngineBuildError(message, code) {
+	const error = new Error(message);
+	error.code = code;
+	return error;
+}
+function sleep(ms) {
+	return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function createEngineBuildLogFilename() {
+	const now = /* @__PURE__ */ new Date();
+	return `${[
+		now.getFullYear(),
+		now.getMonth() + 1,
+		now.getDate(),
+		now.getHours(),
+		now.getMinutes(),
+		now.getSeconds()
+	].join("-")}.json`;
+}
+async function resolveEngineBuildLogFilePath(logPath) {
+	const resolvedLogPath = path.resolve(logPath);
+	try {
+		if ((await fs.stat(resolvedLogPath)).isDirectory()) return path.join(resolvedLogPath, createEngineBuildLogFilename());
+		await fs.rm(resolvedLogPath, { force: true });
+	} catch {}
+	await fs.mkdir(path.dirname(resolvedLogPath), { recursive: true });
+	return resolvedLogPath;
+}
+async function writeEngineBuildLog(logPath, content) {
+	if (!logPath) return;
+	const filePath = await resolveEngineBuildLogFilePath(logPath);
+	await fs.writeFile(filePath, content, "utf8");
+}
+/**
+* @description 通过开发者工具 HTTP 服务端口执行 engine build，并轮询直到构建结束。
+*/
+async function runWechatIdeEngineBuildByHttp(projectPath, options = {}) {
+	await startWechatIdeEngineBuildByHttp(projectPath, options);
+	const startedAt = Date.now();
+	while (true) {
+		if (Date.now() - startedAt > (options.overallTimeoutMs ?? 12e4)) throw createEngineBuildError("WECHAT_DEVTOOLS_ENGINE_BUILD_TIMEOUT", "WECHAT_DEVTOOLS_ENGINE_BUILD_TIMEOUT");
+		const result = await pollWechatIdeEngineBuildResultByHttp(options);
+		options.onProgress?.(result);
+		if (result.failed) throw createEngineBuildError(result.msg || result.body || "WECHAT_DEVTOOLS_ENGINE_BUILD_FAILED", "WECHAT_DEVTOOLS_ENGINE_BUILD_FAILED");
+		if (result.done) return result;
+		await sleep(options.pollIntervalMs ?? 1e3);
+	}
+}
+/**
+* @description 以更接近官方 CLI 的方式执行 engine build，并支持将构建日志写入文件。
+*/
+async function runWechatIdeEngineBuild(projectPath, options = {}) {
+	const logs = [];
+	let lastLoggedMessage;
+	try {
+		const result = await runWechatIdeEngineBuildByHttp(projectPath, {
+			...options,
+			onProgress: (progress) => {
+				if (progress.msg && progress.msg !== lastLoggedMessage) {
+					lastLoggedMessage = progress.msg;
+					logs.push(progress.msg);
+				}
+				options.onProgress?.(progress);
+			}
+		});
+		await writeEngineBuildLog(options.logPath, logs.join("\n"));
+		return result;
+	} catch (error) {
+		logs.push(error instanceof Error ? error.message : String(error));
+		await writeEngineBuildLog(options.logPath, logs.join("\n"));
+		throw error;
+	}
+}
+//#endregion
 //#region src/cli/forwardConsole.ts
 const DEFAULT_FORWARD_CONSOLE_LEVELS = [
 	"log",
@@ -1154,6 +1494,13 @@ async function runMinidev(argv) {
 }
 //#endregion
 //#region src/cli/retry.ts
+const RETRY_PROMPT_INITIAL_IGNORE_MS = 300;
+const RETRY_CONFIRM_KEYS = ["y"];
+const RETRY_CANCEL_KEYS = [
+	"q",
+	"Esc",
+	"Ctrl+C"
+];
 const LOGIN_REQUIRED_PATTERNS = [
 	/code\s*[:=]\s*10/i,
 	/需要重新登录/,
@@ -1161,14 +1508,6 @@ const LOGIN_REQUIRED_PATTERNS = [
 	/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) {
@@ -1183,6 +1522,23 @@ function extractExecutionErrorText(error) {
 	]) if (typeof field === "string" && field.trim()) parts.push(field);
 	return parts.join("\n");
 }
+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 判断是否为微信开发者工具登录失效错误。
+*/
+function isWechatIdeLoginRequiredError(error) {
+	const text = extractExecutionErrorText(error);
+	if (!text) return false;
+	return LOGIN_REQUIRED_PATTERNS.some((pattern) => pattern.test(text));
+}
 /**
 * @description 将登录失效错误格式化为更易读的摘要。
 */
@@ -1208,114 +1564,69 @@ function createWechatIdeLoginRequiredExitError(error, reason) {
 	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 取消。
+* @description 交互等待用户按 y 重试，按 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 timeout = setTimeout(() => {
-			done("timeout");
-		}, Number.isFinite(timeoutMs) && timeoutMs > 0 ? timeoutMs : 3e4);
-		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) => {
+	return await waitForExclusiveKeypress({
+		ignoreInitialMs: 300,
+		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);
+			if (key.ctrl && key.name === "c") return "cancel";
+			if (key.name === "y") return "retry";
+			if (key.name === "q" || key.name === "escape") return "cancel";
+		},
+		timeoutMs
 	});
 }
+function highlightHotkey(key) {
+	return colors.bold(colors.green(key));
+}
 /**
 * @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).`);
+	const confirmKeys = RETRY_CONFIRM_KEYS.map(highlight).join(" / ");
+	const cancelKeys = RETRY_CANCEL_KEYS.map(highlight).join(" / ");
+	return i18nText(`按 ${confirmKeys} 重试，按 ${cancelKeys} 退出（${timeoutSeconds}s 内无输入将自动失败）。`, `Press ${confirmKeys} to retry, ${cancelKeys} to cancel (auto fail in ${timeoutSeconds}s).`);
 }
-function highlightHotkey(key) {
-	return colors.bold(colors.green(key));
+/**
+* @description 输出重试热键提示，并独占等待当前提示对应的按键输入。
+*/
+async function promptRetryKeypress(options) {
+	const { logger, timeoutMs = 3e4 } = options;
+	logger.info(formatRetryHotkeyPrompt(timeoutMs));
+	return await waitForRetryKeypress({ timeoutMs });
 }
-//#endregion
-//#region src/cli/run-login.ts
 /**
-* @description 运行微信开发者工具 CLI，并在登录失效时允许按键重试。
+* @description 统一处理微信开发者工具登录失效场景下的提示与重试交互。
 */
-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);
+async function promptWechatIdeLoginRetry(options) {
+	const { allowRetry = true, cancelLevel = "info", error, logger, promptOpenIdeLogin = false, retryTimeoutMs = 3e4 } = options;
+	logger.error(i18nText("检测到微信开发者工具登录状态失效，请先登录后重试。", "Wechat DevTools login has expired. Please login and retry."));
+	if (promptOpenIdeLogin) logger.warn(i18nText("请先打开微信开发者工具完成登录。", "Please open Wechat DevTools and complete login first."));
+	logger.warn(formatWechatIdeLoginRequiredError(error));
+	if (!allowRetry) return "cancel";
+	const action = await promptRetryKeypress({
+		logger,
+		timeoutMs: retryTimeoutMs
+	});
+	if (action === "timeout") {
+		logger.error(i18nText(`等待登录重试输入超时（${retryTimeoutMs}ms），已自动取消。`, `Retry prompt timed out (${retryTimeoutMs}ms), canceled automatically.`));
+		return "cancel";
 	}
+	if (action !== "retry") {
+		logger[cancelLevel](i18nText("已取消重试。完成登录后请重新执行当前命令。", "Retry canceled. Please run the command again after login."));
+		return "cancel";
+	}
+	return "retry";
 }
-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"))
-	};
-}
+//#endregion
+//#region src/cli/run-login-config.ts
 function normalizeLoginRetryMode(value, nonInteractive) {
 	if (value && value !== "never" && value !== "once" && value !== "always") throw new Error(i18nText(`不支持的 --login-retry 值: ${value}（仅支持 never/once/always）`, `Invalid --login-retry value: ${value} (supported: never/once/always)`));
 	if (value === "never" || value === "once" || value === "always") return value;
@@ -1336,30 +1647,70 @@ function stripLoginRetryControlFlags(argv) {
 	next = removeOption(next, "--non-interactive");
 	return next;
 }
+/**
+* @description 解析登录重试相关控制参数，并产出实际执行微信 CLI 所需的运行时参数。
+*/
+function resolveLoginRetryConfig(argv) {
+	const nonInteractiveFlag = argv.includes("--non-interactive");
+	const ciMode = process.env.CI === "true";
+	const nonTtyStdin = !isStdinInteractive();
+	const nonInteractive = nonInteractiveFlag || ciMode || nonTtyStdin;
+	const retryModeRaw = readOptionValue(argv, "--login-retry")?.toLowerCase();
+	return {
+		nonInteractive,
+		retryMode: normalizeLoginRetryMode(retryModeRaw, nonInteractive),
+		retryTimeoutMs: normalizeLoginRetryTimeout(readOptionValue(argv, "--login-retry-timeout")),
+		runtimeArgv: stripLoginRetryControlFlags(argv)
+	};
+}
+//#endregion
+//#region src/cli/run-login-executor.ts
+/**
+* @description 执行可重试命令循环，并将“是否可重试”与“如何提示重试”交给调用方定义。
+*/
+async function runRetryableCommand(options) {
+	const { createCancelError, execute, isRetryableResult, onCancel, onRetry, promptRetry, shouldRetry } = options;
+	let retryCount = 0;
+	while (true) {
+		const result = await execute();
+		if (!isRetryableResult(result)) return result;
+		if (shouldRetry(await promptRetry(result, retryCount))) {
+			retryCount += 1;
+			onRetry?.();
+			continue;
+		}
+		onCancel?.(result);
+		throw createCancelError(result);
+	}
+}
+//#endregion
+//#region src/cli/run-login.ts
+function unwrapWechatCliExecutionError(result) {
+	return result.kind === "retryable" ? result.error : result.value;
+}
 async function promptLoginRetry(errorLike, options, retryCount) {
 	const { nonInteractive, retryMode, retryTimeoutMs } = options;
-	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)) {
+		await promptWechatIdeLoginRetry({
+			allowRetry: false,
+			error: errorLike,
+			logger: logger_default,
+			promptOpenIdeLogin: true,
+			retryTimeoutMs
+		});
 		logger_default.info(i18nText("当前重试策略不允许继续重试。", "Current retry policy does not allow further retries."));
 		return "cancel";
 	}
-	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";
+	return await promptWechatIdeLoginRetry({
+		error: errorLike,
+		logger: logger_default,
+		promptOpenIdeLogin: true,
+		retryTimeoutMs
+	});
 }
 function flushExecutionOutput(result) {
 	if (!result || typeof result !== "object") return;
@@ -1367,6 +1718,92 @@ function flushExecutionOutput(result) {
 	if (typeof candidate.stdout === "string" && candidate.stdout) process.stdout.write(candidate.stdout);
 	if (typeof candidate.stderr === "string" && candidate.stderr) process.stderr.write(candidate.stderr);
 }
+/**
+* @description 运行微信开发者工具 CLI，并在登录失效时允许按键重试。
+*/
+async function runWechatCliWithRetry(cliPath, argv) {
+	const loginRetryOptions = resolveLoginRetryConfig(argv);
+	const result = await runWithSuspendedSharedInput(async () => {
+		return await runRetryableCommand({
+			createCancelError: (result) => createWechatIdeLoginRequiredExitError(unwrapWechatCliExecutionError(result)),
+			execute: async () => {
+				try {
+					return {
+						kind: "result",
+						value: await execute(cliPath, loginRetryOptions.runtimeArgv, {
+							pipeStdout: false,
+							pipeStderr: false
+						})
+					};
+				} catch (error) {
+					if (!isWechatIdeLoginRequiredError(error)) throw error;
+					return {
+						error,
+						kind: "retryable"
+					};
+				}
+			},
+			isRetryableResult: (result) => result.kind === "retryable" || isWechatIdeLoginRequiredError(result.value),
+			onRetry: () => {
+				logger_default.info(i18nText("正在重试连接微信开发者工具...", "Retrying to connect Wechat DevTools..."));
+			},
+			promptRetry: async (result, retryCount) => {
+				return await promptLoginRetry(unwrapWechatCliExecutionError(result), loginRetryOptions, retryCount);
+			},
+			shouldRetry: (action) => action === "retry"
+		});
+	});
+	if (result.kind === "retryable") throw createWechatIdeLoginRequiredExitError(result.error);
+	if (isWechatIdeLoginRequiredError(result.value)) throw createWechatIdeLoginRequiredExitError(result.value);
+	flushExecutionOutput(result.value);
+}
+//#endregion
+//#region src/cli/run-wechat-cli.ts
+function shouldBootstrapWechatDevtools(command) {
+	return command === "open" || command === "auto" || command === "auto-preview";
+}
+function resolveBooleanCliOption(argv, optionName) {
+	if (argv.includes(optionName)) return true;
+	const rawValue = readOptionValue(argv, optionName);
+	if (rawValue === void 0) return;
+	const normalized = rawValue.trim().toLowerCase();
+	if (normalized === "" || normalized === "true" || normalized === "1" || normalized === "on") return true;
+	if (normalized === "false" || normalized === "0" || normalized === "off") return false;
+	return true;
+}
+async function handleMissingCliPath(source) {
+	const message = source === "custom" ? i18nText("在当前自定义路径中未找到微信web开发者命令行工具，请重新指定路径。", "Cannot find Wechat Web DevTools CLI in custom path, please reconfigure it.") : i18nText(`未检测到微信web开发者命令行工具，请执行 ${colors.bold(colors.green("weapp-ide-cli config"))} 指定路径。`, `Wechat Web DevTools CLI not found, please run ${colors.bold(colors.green("weapp-ide-cli config"))} to configure it.`);
+	logger_default.warn(message);
+	await promptForCliPath();
+}
+async function maybeBootstrapWechatDevtoolsSettings(argv) {
+	const command = argv[0];
+	if (!shouldBootstrapWechatDevtools(command)) return;
+	const config = await readCustomConfig();
+	if (config.autoBootstrapDevtools === false) return;
+	const projectPath = readOptionValue(argv, "--project");
+	const trustProjectOption = resolveBooleanCliOption(argv, "--trust-project");
+	await bootstrapWechatDevtoolsSettings({
+		projectPath,
+		trustProject: trustProjectOption === void 0 ? config.autoTrustProject ?? false : trustProjectOption
+	});
+}
+/**
+* @description 执行微信开发者工具 CLI 阶段，包括环境检查、路径解析、bootstrap 与登录重试。
+*/
+async function runWechatCliCommand(argv) {
+	if (!isOperatingSystemSupported(operatingSystemName)) {
+		logger_default.warn(i18nText(`微信web开发者工具不支持当前平台：${operatingSystemName} !`, `Wechat Web DevTools CLI is not supported on current platform: ${operatingSystemName}!`));
+		return;
+	}
+	const { cliPath, source } = await resolveCliPath();
+	if (!cliPath) {
+		await handleMissingCliPath(source);
+		return;
+	}
+	await maybeBootstrapWechatDevtoolsSettings(argv);
+	await runWechatCliWithRetry(cliPath, argv);
+}
 //#endregion
 //#region src/cli/wechat-command-schema.ts
 const CACHE_CLEAN_TYPES = [
@@ -1378,6 +1815,11 @@ const CACHE_CLEAN_TYPES = [
 	"session",
 	"all"
 ];
+const QR_FORMAT_TYPES = [
+	"terminal",
+	"image",
+	"base64"
+];
 function isNonEmptyText(value) {
 	return typeof value === "string" && value.trim().length > 0;
 }
@@ -1388,14 +1830,14 @@ function validatePortOption(argv) {
 	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 projectPath = readOptionValue(argv, "--project", "-p");
 	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, "--project", "-p"))) return;
 	if (isNonEmptyText(readOptionValue(argv, "--appid"))) return;
 	throw new Error(i18nText("--ext-appid 需要和 --appid 一起使用（当未提供 --project 时）", "--ext-appid requires --appid when --project is not provided"));
 }
@@ -1408,26 +1850,480 @@ function validateWechatCliCommandArgs(argv) {
 	validatePortOption(argv);
 	validateExtAppidDependency(argv);
 	if (command === "upload") {
-		const version = readOptionValue(argv, "--version") || readOptionValue(argv, "-v");
-		const desc = readOptionValue(argv, "--desc") || readOptionValue(argv, "-d");
+		const version = readOptionValue(argv, "--version", "-v");
+		const desc = readOptionValue(argv, "--desc", "-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");
+		const qrFormat = readOptionValue(argv, "--qr-format", "-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 (!QR_FORMAT_TYPES.includes(qrFormat.toLowerCase())) throw new Error(i18nText(`preview 命令的二维码格式无效: ${qrFormat}（仅支持 ${QR_FORMAT_TYPES.join("/")}）`, `Invalid preview qr format: ${qrFormat} (supported: ${QR_FORMAT_TYPES.join("/")})`));
+	}
+	if (command === "login") {
+		const qrFormat = readOptionValue(argv, "--qr-format", "-f");
+		if (qrFormat && !QR_FORMAT_TYPES.includes(qrFormat.toLowerCase())) throw new Error(i18nText(`login 命令的二维码格式无效: ${qrFormat}（仅支持 ${QR_FORMAT_TYPES.join("/")}）`, `Invalid login qr format: ${qrFormat} (supported: ${QR_FORMAT_TYPES.join("/")})`));
 	}
 	if (command === "cache") {
-		const cleanType = readOptionValue(argv, "--clean") || readOptionValue(argv, "-c");
+		const cleanType = readOptionValue(argv, "--clean", "-c");
 		if (!isNonEmptyText(cleanType)) throw new Error(i18nText("cache 命令缺少必填参数：--clean/-c", "cache command requires --clean/-c"));
 		if (!CACHE_CLEAN_TYPES.includes(cleanType)) throw new Error(i18nText(`cache 命令的清理类型无效: ${cleanType}（仅支持 ${CACHE_CLEAN_TYPES.join("/")}）`, `Invalid cache clean type: ${cleanType} (supported: ${CACHE_CLEAN_TYPES.join("/")})`));
 	}
-	if (command === "upload" || command === "auto" || command === "auto-preview") validateProjectLocator(command, argv);
+	if (command === "upload" || command === "auto" || command === "auto-replay" || command === "auto-preview" || command === "reset-fileutils") validateProjectLocator(command, argv);
+	if (command === "build-npm") {
+		const compileType = readOptionValue(argv, "--compile-type");
+		if (compileType !== void 0 && !isNonEmptyText(compileType)) throw new Error(i18nText("build-npm 命令的 --compile-type 不能为空字符串", "build-npm command requires a non-empty --compile-type value"));
+	}
+	if (command === "build-apk") {
+		const output = readOptionValue(argv, "--output", "-o");
+		const keyStore = readOptionValue(argv, "--key-store", "--keyStore", "-ks");
+		const keyAlias = readOptionValue(argv, "--key-alias", "--keyAlias", "-ka");
+		const keyPass = readOptionValue(argv, "--key-pass", "--keyPass", "-kp");
+		const storePass = readOptionValue(argv, "--store-pass", "--storePass", "-sp");
+		if (!isNonEmptyText(output) || !isNonEmptyText(keyStore) || !isNonEmptyText(keyAlias) || !isNonEmptyText(keyPass) || !isNonEmptyText(storePass)) throw new Error(i18nText("build-apk 命令缺少必填参数：--output/-o、--key-store/-ks、--key-alias/-ka、--key-pass/-kp、--store-pass/-sp", "build-apk command requires --output/-o, --key-store/-ks, --key-alias/-ka, --key-pass/-kp, and --store-pass/-sp"));
+	}
+	if (command === "build-ipa") {
+		const output = readOptionValue(argv, "--output", "-o");
+		const isDistribute = readBooleanOption(argv, "--isDistribute");
+		if (!isNonEmptyText(output) || isDistribute === void 0) throw new Error(i18nText("build-ipa 命令缺少必填参数：--output/-o 和 --isDistribute", "build-ipa command requires both --output/-o and --isDistribute"));
+	}
+}
+//#endregion
+//#region src/cli/wechat-commands.ts
+function appendProjectLocatorArgv(argv, options) {
+	if (options.projectPath) argv.push("--project", path.resolve(options.projectPath));
+	if (options.appid) argv.push("--appid", options.appid);
+	if (options.extAppid) argv.push("--ext-appid", options.extAppid);
+}
+/**
+* @description 调用微信开发者工具 open 命令。
+*/
+async function openWechatIde(options = {}) {
+	const argv = ["open"];
+	appendProjectLocatorArgv(argv, options);
+	if (options.platform) argv.push("--platform", options.platform);
+	if (options.trustProject) argv.push("--trust-project");
+	await runWechatCliCommand(argv);
+}
+/**
+* @description 调用微信开发者工具 login 命令。
+*/
+async function loginWechatIde(options = {}) {
+	const argv = ["login"];
+	if (options.qrFormat) argv.push("--qr-format", options.qrFormat);
+	if (options.qrOutput) argv.push("--qr-output", path.resolve(options.qrOutput));
+	if (options.qrSize) argv.push("--qr-size", options.qrSize);
+	if (options.resultOutput) argv.push("--result-output", path.resolve(options.resultOutput));
+	await runWechatCliCommand(argv);
+}
+/**
+* @description 调用微信开发者工具 islogin 命令。
+*/
+async function isWechatIdeLoggedIn() {
+	await runWechatCliCommand(["islogin"]);
+}
+/**
+* @description 调用微信开发者工具 build-npm 命令。
+*/
+async function buildWechatIdeNpm(options = {}) {
+	const argv = [
+		"build-npm",
+		"--project",
+		path.resolve(options.projectPath ?? process.cwd())
+	];
+	if (options.compileType) argv.push("--compile-type", options.compileType);
+	await runWechatCliCommand(argv);
+}
+/**
+* @description 调用微信开发者工具 preview 命令。
+*/
+async function previewWechatIde(options = {}) {
+	const argv = ["preview"];
+	appendProjectLocatorArgv(argv, options);
+	if (options.qrFormat) argv.push("--qr-format", options.qrFormat);
+	if (options.qrOutput) argv.push("--qr-output", path.resolve(options.qrOutput));
+	if (options.qrSize) argv.push("--qr-size", options.qrSize);
+	if (options.infoOutput) argv.push("--info-output", path.resolve(options.infoOutput));
+	if (options.compileCondition) argv.push("--compile-condition", options.compileCondition);
+	await runWechatCliCommand(argv);
+}
+/**
+* @description 调用微信开发者工具 auto-preview 命令。
+*/
+async function autoPreviewWechatIde(options = {}) {
+	const argv = ["auto-preview"];
+	appendProjectLocatorArgv(argv, options);
+	if (options.infoOutput) argv.push("--info-output", path.resolve(options.infoOutput));
+	if (options.compileCondition) argv.push("--compile-condition", options.compileCondition);
+	await runWechatCliCommand(argv);
+}
+/**
+* @description 调用微信开发者工具 auto 命令。
+*/
+async function autoWechatIde(options = {}) {
+	const argv = ["auto"];
+	appendProjectLocatorArgv(argv, options);
+	if (options.port) argv.push("--auto-port", options.port);
+	if (options.account) argv.push("--auto-account", options.account);
+	if (options.testTicket) argv.push("--test-ticket", options.testTicket);
+	if (options.ticket) argv.push("--ticket", options.ticket);
+	if (options.trustProject) argv.push("--trust-project");
+	await runWechatCliCommand(argv);
+}
+/**
+* @description 调用微信开发者工具 auto-replay 命令。
+*/
+async function autoReplayWechatIde(options = {}) {
+	const argv = ["auto-replay"];
+	appendProjectLocatorArgv(argv, options);
+	if (options.port) argv.push("--auto-port", options.port);
+	if (options.account) argv.push("--auto-account", options.account);
+	if (options.replayAll) argv.push("--replay-all");
+	if (options.replayConfigPath) argv.push("--replay-config-path", path.resolve(options.replayConfigPath));
+	if (options.testTicket) argv.push("--test-ticket", options.testTicket);
+	if (options.ticket) argv.push("--ticket", options.ticket);
+	if (options.trustProject) argv.push("--trust-project");
+	await runWechatCliCommand(argv);
+}
+/**
+* @description 调用微信开发者工具 upload 命令。
+*/
+async function uploadWechatIde(options) {
+	const argv = ["upload"];
+	appendProjectLocatorArgv(argv, options);
+	argv.push("--version", options.version, "--desc", options.desc);
+	if (options.infoOutput) argv.push("--info-output", path.resolve(options.infoOutput));
+	await runWechatCliCommand(argv);
+}
+/**
+* @description 调用微信开发者工具 close 命令。
+*/
+async function closeWechatIdeProject() {
+	await runWechatCliCommand(["close"]);
+}
+/**
+* @description 调用微信开发者工具 quit 命令。
+*/
+async function quitWechatIde() {
+	await runWechatCliCommand(["quit"]);
+}
+/**
+* @description 调用微信开发者工具 cache 命令。
+*/
+async function clearWechatIdeCache(options) {
+	await runWechatCliCommand([
+		"cache",
+		"--clean",
+		options.clean
+	]);
+}
+/**
+* @description 调用微信开发者工具 open-other 命令。
+*/
+async function openWechatIdeOtherProject(_options = {}) {
+	await runWechatCliCommand(["open-other"]);
+}
+/**
+* @description 通过微信开发者工具 HTTP 服务端口重置指定项目的 fileutils 状态。
+*/
+async function resetWechatIdeFileUtils(options) {
+	await resetWechatIdeFileUtilsByHttp(path.resolve(options.projectPath));
+}
+function createAutomatorSessionOptions(options) {
+	return {
+		preferOpenedSession: options.preferOpenedSession ?? true,
+		projectPath: path.resolve(options.projectPath),
+		sharedSession: options.sharedSession ?? true,
+		timeout: options.timeout
+	};
+}
+/**
+* @description 通过已打开或新建的 automator 会话获取开发者工具基础信息。
+*/
+async function getWechatIdeToolInfo(options) {
+	return await withMiniProgram(createAutomatorSessionOptions(options), async (miniProgram) => {
+		return await miniProgram.toolInfo();
+	});
+}
+/**
+* @description 通过已打开或新建的 automator 会话执行项目编译。
+*/
+async function compileWechatIdeByAutomator(options) {
+	return await withMiniProgram(createAutomatorSessionOptions(options), async (miniProgram) => {
+		return await miniProgram.compile({ force: options.force });
+	});
+}
+/**
+* @description 通过已打开或新建的 automator 会话清理开发者工具缓存。
+*/
+async function clearWechatIdeCacheByAutomator(options) {
+	return await withMiniProgram(createAutomatorSessionOptions(options), async (miniProgram) => {
+		return await miniProgram.clearCache({ clean: options.clean });
+	});
+}
+/**
+* @description 通过已打开或新建的 automator 会话获取当前 ticket。
+*/
+async function getWechatIdeTicket(options) {
+	return await withMiniProgram(createAutomatorSessionOptions(options), async (miniProgram) => {
+		return await miniProgram.getTicket();
+	});
+}
+/**
+* @description 通过已打开或新建的 automator 会话设置 ticket。
+*/
+async function setWechatIdeTicket(options) {
+	return await withMiniProgram(createAutomatorSessionOptions(options), async (miniProgram) => {
+		await miniProgram.setTicket(options.ticket);
+	});
+}
+/**
+* @description 通过已打开或新建的 automator 会话刷新 ticket。
+*/
+async function refreshWechatIdeTicket(options) {
+	return await withMiniProgram(createAutomatorSessionOptions(options), async (miniProgram) => {
+		await miniProgram.refreshTicket();
+	});
+}
+/**
+* @description 通过已打开或新建的 automator 会话获取测试账号列表。
+*/
+async function getWechatIdeTestAccounts(options) {
+	return await withMiniProgram(createAutomatorSessionOptions(options), async (miniProgram) => {
+		return await miniProgram.testAccounts();
+	});
+}
+/**
+* @description 调用微信开发者工具 build-apk 命令。
+*/
+async function buildWechatIdeApk(options) {
+	const argv = [
+		"build-apk",
+		"--key-store",
+		path.resolve(options.keyStore),
+		"--key-alias",
+		options.keyAlias,
+		"--key-pass",
+		options.keyPass,
+		"--store-pass",
+		options.storePass,
+		"--output",
+		path.resolve(options.output)
+	];
+	if (options.useAab !== void 0) argv.push("--use-aab", String(options.useAab));
+	if (options.desc) argv.push("--desc", options.desc);
+	if (options.isUploadResourceBundle) argv.push("--isUploadResourceBundle");
+	if (options.resourceBundleVersion) argv.push("--resourceBundleVersion", options.resourceBundleVersion);
+	if (options.resourceBundleDesc) argv.push("--resourceBundleDesc", options.resourceBundleDesc);
+	await runWechatCliCommand(argv);
+}
+/**
+* @description 调用微信开发者工具 build-ipa 命令。
+*/
+async function buildWechatIdeIpa(options) {
+	const argv = [
+		"build-ipa",
+		"--output",
+		path.resolve(options.output),
+		"--isDistribute",
+		String(options.isDistribute)
+	];
+	if (options.isRemoteBuild !== void 0) argv.push("--isRemoteBuild", String(options.isRemoteBuild));
+	if (options.profilePath) argv.push("--profilePath", path.resolve(options.profilePath));
+	if (options.certificateName) argv.push("--certificateName", options.certificateName);
+	if (options.p12Path) argv.push("--p12Path", path.resolve(options.p12Path));
+	if (options.p12Password) argv.push("--p12Password", options.p12Password);
+	if (options.tpnsProfilePath) argv.push("--tpnsProfilePath", path.resolve(options.tpnsProfilePath));
+	if (options.isUploadBeta !== void 0) argv.push("--isUploadBeta", String(options.isUploadBeta));
+	if (options.isUploadResourceBundle) argv.push("--isUploadResourceBundle");
+	if (options.resourceBundleVersion) argv.push("--resourceBundleVersion", options.resourceBundleVersion);
+	if (options.resourceBundleDesc) argv.push("--resourceBundleDesc", options.resourceBundleDesc);
+	if (options.versionName) argv.push("--versionName", options.versionName);
+	if (options.versionCode !== void 0) argv.push("--versionCode", String(options.versionCode));
+	if (options.versionDesc) argv.push("--versionDesc", options.versionDesc);
+	await runWechatCliCommand(argv);
+}
+//#endregion
+//#region src/cli/wechat-dispatch.ts
+function hasOption(argv, optionName) {
+	return argv.includes(optionName) || argv.some((token) => token.startsWith(`${optionName}=`));
+}
+/**
+* @description 优先将高频官方命令分发到 weapp-ide-cli 的稳定 helper，实现更清晰的程序化命令层。
+*/
+async function dispatchWechatCliCommand(argv) {
+	const command = argv[0];
+	if (!command) return false;
+	if (command === "login") {
+		await loginWechatIde({
+			qrFormat: readOptionValue(argv, "--qr-format", "-f"),
+			qrOutput: readOptionValue(argv, "--qr-output", "-o"),
+			qrSize: readOptionValue(argv, "--qr-size"),
+			resultOutput: readOptionValue(argv, "--result-output", "-r")
+		});
+		return true;
+	}
+	if (command === "open") {
+		await openWechatIde({
+			appid: readOptionValue(argv, "--appid"),
+			extAppid: readOptionValue(argv, "--ext-appid"),
+			platform: readOptionValue(argv, "--platform"),
+			projectPath: readOptionValue(argv, "--project", "-p"),
+			trustProject: hasOption(argv, "--trust-project")
+		});
+		return true;
+	}
+	if (command === "islogin") {
+		await isWechatIdeLoggedIn();
+		return true;
+	}
+	if (command === "build-npm") {
+		await buildWechatIdeNpm({
+			compileType: readOptionValue(argv, "--compile-type"),
+			projectPath: readOptionValue(argv, "--project")
+		});
+		return true;
+	}
+	if (command === "preview") {
+		await previewWechatIde({
+			appid: readOptionValue(argv, "--appid"),
+			compileCondition: readOptionValue(argv, "--compile-condition"),
+			extAppid: readOptionValue(argv, "--ext-appid"),
+			infoOutput: readOptionValue(argv, "--info-output", "-i"),
+			projectPath: readOptionValue(argv, "--project", "-p"),
+			qrFormat: readOptionValue(argv, "--qr-format", "-f"),
+			qrOutput: readOptionValue(argv, "--qr-output", "-o"),
+			qrSize: readOptionValue(argv, "--qr-size")
+		});
+		return true;
+	}
+	if (command === "auto-preview") {
+		await autoPreviewWechatIde({
+			appid: readOptionValue(argv, "--appid"),
+			compileCondition: readOptionValue(argv, "--compile-condition"),
+			extAppid: readOptionValue(argv, "--ext-appid"),
+			infoOutput: readOptionValue(argv, "--info-output", "-i"),
+			projectPath: readOptionValue(argv, "--project", "-p")
+		});
+		return true;
+	}
+	if (command === "auto") {
+		await autoWechatIde({
+			account: readOptionValue(argv, "--auto-account"),
+			appid: readOptionValue(argv, "--appid"),
+			extAppid: readOptionValue(argv, "--ext-appid"),
+			port: readOptionValue(argv, "--auto-port"),
+			projectPath: readOptionValue(argv, "--project", "-p"),
+			testTicket: readOptionValue(argv, "--test-ticket"),
+			ticket: readOptionValue(argv, "--ticket"),
+			trustProject: hasOption(argv, "--trust-project")
+		});
+		return true;
+	}
+	if (command === "auto-replay") {
+		await autoReplayWechatIde({
+			account: readOptionValue(argv, "--auto-account"),
+			appid: readOptionValue(argv, "--appid"),
+			extAppid: readOptionValue(argv, "--ext-appid"),
+			port: readOptionValue(argv, "--auto-port"),
+			projectPath: readOptionValue(argv, "--project", "-p"),
+			replayAll: hasOption(argv, "--replay-all"),
+			replayConfigPath: readOptionValue(argv, "--replay-config-path"),
+			testTicket: readOptionValue(argv, "--test-ticket"),
+			ticket: readOptionValue(argv, "--ticket"),
+			trustProject: hasOption(argv, "--trust-project")
+		});
+		return true;
+	}
+	if (command === "upload") {
+		const version = readOptionValue(argv, "--version", "-v");
+		const desc = readOptionValue(argv, "--desc", "-d");
+		if (!version || !desc) return false;
+		await uploadWechatIde({
+			appid: readOptionValue(argv, "--appid"),
+			desc,
+			extAppid: readOptionValue(argv, "--ext-appid"),
+			infoOutput: readOptionValue(argv, "--info-output", "-i"),
+			projectPath: readOptionValue(argv, "--project", "-p"),
+			version
+		});
+		return true;
+	}
+	if (command === "build-apk") {
+		const output = readOptionValue(argv, "--output", "-o");
+		const keyStore = readOptionValue(argv, "--key-store", "--keyStore", "-ks");
+		const keyAlias = readOptionValue(argv, "--key-alias", "--keyAlias", "-ka");
+		const keyPass = readOptionValue(argv, "--key-pass", "--keyPass", "-kp");
+		const storePass = readOptionValue(argv, "--store-pass", "--storePass", "-sp");
+		if (!output || !keyStore || !keyAlias || !keyPass || !storePass) return false;
+		await buildWechatIdeApk({
+			desc: readOptionValue(argv, "--desc", "-d"),
+			isUploadResourceBundle: hasOption(argv, "--isUploadResourceBundle"),
+			keyAlias,
+			keyPass,
+			keyStore,
+			output,
+			resourceBundleDesc: readOptionValue(argv, "--resourceBundleDesc"),
+			resourceBundleVersion: readOptionValue(argv, "--resourceBundleVersion"),
+			storePass,
+			useAab: readBooleanOption(argv, "--use-aab", "--useAab", "-u")
+		});
+		return true;
+	}
+	if (command === "build-ipa") {
+		const output = readOptionValue(argv, "--output", "-o");
+		const isDistribute = readBooleanOption(argv, "--isDistribute");
+		if (!output || isDistribute === void 0) return false;
+		await buildWechatIdeIpa({
+			certificateName: readOptionValue(argv, "--certificateName"),
+			isDistribute,
+			isRemoteBuild: readBooleanOption(argv, "--isRemoteBuild") ?? false,
+			isUploadBeta: readBooleanOption(argv, "--isUploadBeta") ?? false,
+			isUploadResourceBundle: hasOption(argv, "--isUploadResourceBundle"),
+			output,
+			p12Password: readOptionValue(argv, "--p12Password"),
+			p12Path: readOptionValue(argv, "--p12Path"),
+			profilePath: readOptionValue(argv, "--profilePath"),
+			resourceBundleDesc: readOptionValue(argv, "--resourceBundleDesc"),
+			resourceBundleVersion: readOptionValue(argv, "--resourceBundleVersion"),
+			tpnsProfilePath: readOptionValue(argv, "--tpnsProfilePath"),
+			versionCode: readOptionValue(argv, "--versionCode") ? Number(readOptionValue(argv, "--versionCode")) : void 0,
+			versionDesc: readOptionValue(argv, "--versionDesc"),
+			versionName: readOptionValue(argv, "--versionName")
+		});
+		return true;
+	}
+	if (command === "close") {
+		await closeWechatIdeProject();
+		return true;
+	}
+	if (command === "quit") {
+		await quitWechatIde();
+		return true;
+	}
+	if (command === "cache") {
+		const clean = readOptionValue(argv, "--clean", "-c");
+		if (!clean) return false;
+		await clearWechatIdeCache({ clean });
+		return true;
+	}
+	if (command === "open-other" && !hasOption(argv, "--project") && !hasOption(argv, "-p")) {
+		await openWechatIdeOtherProject();
+		return true;
+	}
+	if (command === "reset-fileutils") {
+		const projectPath = readOptionValue(argv, "--project", "-p");
+		if (!projectPath) return false;
+		await resetWechatIdeFileUtils({ projectPath });
+		return true;
+	}
+	if (command === "engine" && argv[1] === "build") {
+		const projectPath = argv[2];
+		if (!projectPath) return false;
+		await runWechatIdeEngineBuild(projectPath, { logPath: readOptionValue(argv, "--logPath", "-l") });
+		return true;
+	}
+	return false;
 }
 //#endregion
 //#region src/cli/run.ts
@@ -1480,11 +2376,6 @@ async function handleHelpCommand(args) {
 	}
 	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。
 */
@@ -1502,30 +2393,6 @@ function createMinidevOpenArgv(argv) {
 	nextArgv[0] = "ide";
 	return removeOption(nextArgv, "--platform");
 }
-function shouldBootstrapWechatDevtools(command) {
-	return command === "open" || command === "auto" || command === "auto-preview";
-}
-function resolveBooleanCliOption(argv, optionName) {
-	if (argv.includes(optionName)) return true;
-	const rawValue = readOptionValue(argv, optionName);
-	if (rawValue === void 0) return;
-	const normalized = rawValue.trim().toLowerCase();
-	if (normalized === "" || normalized === "true" || normalized === "1" || normalized === "on") return true;
-	if (normalized === "false" || normalized === "0" || normalized === "off") return false;
-	return true;
-}
-async function maybeBootstrapWechatDevtoolsSettings(argv) {
-	const command = argv[0];
-	if (!shouldBootstrapWechatDevtools(command)) return;
-	const config = await readCustomConfig();
-	if (config.autoBootstrapDevtools === false) return;
-	const projectPath = readOptionValue(argv, "--project");
-	const trustProjectOption = resolveBooleanCliOption(argv, "--trust-project");
-	await bootstrapWechatDevtoolsSettings({
-		projectPath,
-		trustProject: trustProjectOption === void 0 ? config.autoTrustProject ?? false : trustProjectOption
-	});
-}
 /**
 * @description CLI 入口解析与分发。
 */
@@ -1560,18 +2427,9 @@ async function parse(argv) {
 		await runMinidev(createMinidevOpenArgv(formattedArgv));
 		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) {
-		await handleMissingCliPath(source);
-		return;
-	}
-	await maybeBootstrapWechatDevtoolsSettings(formattedArgv);
-	await runWechatCliWithRetry(cliPath, formattedArgv);
+	if (await dispatchWechatCliCommand(formattedArgv)) return;
+	await runWechatCliCommand(formattedArgv);
 }
 //#endregion
-export { parseCompareArgs as A, isWeappIdeTopLevelCommand as C, runAutomatorCommand as D, isAutomatorCommand as E, parseAutomatorArgs as M, readOptionValue as N, parseScreenshotArgs as O, removeOption as P, 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, printCompareHelp 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 };
+export { resetWechatIdeFileUtilsByHttp as $, RETRY_CANCEL_KEYS as A, waitForRetryKeypress as B, refreshWechatIdeTicket as C, validateWechatCliCommandArgs as D, uploadWechatIde as E, formatRetryHotkeyPrompt as F, transformArgv as G, execute as H, formatWechatIdeLoginRequiredError as I, runWechatIdeEngineBuildByHttp as J, startForwardConsole as K, isWechatIdeLoginRequiredError as L, RETRY_PROMPT_INITIAL_IGNORE_MS as M, createWechatIdeLoginRequiredExitError as N, runWechatCliWithRetry as O, extractExecutionErrorText as P, requestWechatDevtoolsHttp as Q, promptRetryKeypress as R, quitWechatIde as S, removeOption as St, setWechatIdeTicket as T, createAlias as U, runMinidev as V, createPathCompat as W, openWechatIdeProjectByHttp as X, WECHAT_DEVTOOLS_ENGINE_BUILD_STATUSES as Y, pollWechatIdeEngineBuildResultByHttp as Z, isWechatIdeLoggedIn as _, parseCompareArgs as _t, autoReplayWechatIde as a, waitForExclusiveKeypress as at, openWechatIdeOtherProject as b, readBooleanOption as bt, buildWechatIdeIpa as c, WEAPP_IDE_TOP_LEVEL_COMMAND_NAMES as ct, clearWechatIdeCacheByAutomator as d, AUTOMATOR_COMMAND_NAMES as dt, startWechatIdeEngineBuildByHttp as et, closeWechatIdeProject as f, getAutomatorCommandHelp as ft, getWechatIdeToolInfo as g, printScreenshotHelp as gt, getWechatIdeTicket as h, parseScreenshotArgs as ht, autoPreviewWechatIde as i, runWithSuspendedSharedInput as it, RETRY_CONFIRM_KEYS as j, runRetryableCommand as k, buildWechatIdeNpm as l, WECHAT_CLI_COMMAND_NAMES as lt, getWechatIdeTestAccounts as m, runAutomatorCommand as mt, parse as n, promptForCliPath as nt, autoWechatIde as o, CONFIG_COMMAND_NAME as ot, compileWechatIdeByAutomator as p, isAutomatorCommand as pt, runWechatIdeEngineBuild as q, dispatchWechatCliCommand as r, createSharedInputSession as rt, buildWechatIdeApk as s, MINIDEV_NAMESPACE_COMMAND_NAMES as st, createCli as t, handleConfigCommand as tt, clearWechatIdeCache as u, isWeappIdeTopLevelCommand as ut, loginWechatIde as v, printCompareHelp as vt, resetWechatIdeFileUtils as w, previewWechatIde as x, readOptionValue as xt, openWechatIde as y, parseAutomatorArgs as yt, promptWechatIdeLoginRetry as z };