weapp-ide-cli 6.2.0 → 6.3.0

package/dist/{cli-ChMQqi5w.js → cli-CFlqFpIw.js}

@@ -1,9 +1,9 @@
-import { D as logger, E as colors, T as operatingSystemName, _ as readCustomConfig, a as assertWechatDevtoolsPort, b as defaultCustomConfigFilePath, d as resolveDevtoolsAutomationDefaults, f as createAutoBootstrapDevtoolsConfig, g as overwriteCustomConfig, h as createLocaleConfig, i as assertWechatDevtoolsHost, l as getConfig, m as createCustomConfig, p as createAutoTrustProjectConfig, r as resolveWechatDevtoolsTarget, u as getConfiguredLocale, v as removeCustomConfigKey, w as isOperatingSystemSupported, x as resolvePath } from "./sessionStore-zdzy2UFM.js";
-import { a as readManagedRecord, c as withManagedJournalLock, f as assertManagedInstallation, l as writeManagedRecord, m as sameManagedProcess, o as readManagedWechatProjectRecords, p as inspectManagedProjectHost, s as resolveManagedJournal } from "./devtoolsProjectOwnership-yDD6h0dO.js";
-import { _ as parseAutomatorPort, a as bootstrapWechatDevtoolsSettings, g as resolveAutomatorSessionOptions, o as detectWechatDevtoolsServicePort } from "./automator-CRpB6_pA.js";
-import { C as runWithSuspendedSharedInput, D as validateLocaleOption, E as i18nText, T as configureLocaleFromArgv, _ as isWechatIdeLoginRequiredError, b as promptWechatIdeLoginRetry, c as withMiniProgram$1, i as connectConsoleMiniProgram, l as runRetryableCommand, p as createWechatIdeLoginRequiredExitError, r as closeSharedMiniProgram, s as releaseSharedMiniProgram, t as acquireConsoleMiniProgram } from "./automator-session-gWEsSs_A.js";
-import { a as navigateBack, c as pageStack, d as remote, f as scrollTo, g as tap, i as input, l as reLaunch, m as systemInfo, n as captureScreenshotBuffer, o as navigateTo, p as switchTab, r as currentPage, s as pageData, t as audit, u as redirectTo } from "./commands-C1PF1B4P.js";
-import "./run-mcp-Dl_1TH1x.js";
+import { A as operatingSystemName, B as removeCustomConfigKey, C as registerWechatDevtoolsInstallation, F as createAutoTrustProjectConfig, H as defaultCustomConfigFilePath, I as createCustomConfig, L as createLocaleConfig, M as logger, N as wechatDevtoolsSelectionContext, P as createAutoBootstrapDevtoolsConfig, R as overwriteCustomConfig, S as selectInstalledWechatDevtools, U as resolvePath, d as validateWechatDevtoolsSelection, f as withWechatDevtoolsSelection, j as colors, k as isOperatingSystemSupported, m as assertWechatDevtoolsPort, p as assertWechatDevtoolsHost, u as resolveWechatDevtoolsTarget, w as unregisterWechatDevtoolsInstallation, x as listWechatDevtoolsInstallations, z as readCustomConfig } from "./automatorProject-DjYLqMj6.js";
+import { a as isManagedWechatProjectFullyReleased, c as resolveManagedJournal, d as assertManagedInstallation, f as inspectManagedProjectHost, l as withManagedJournalLock, o as readManagedRecord, p as sameManagedProcess, s as readManagedWechatProjectRecords, u as writeManagedRecord } from "./devtoolsProjectOwnership-BMfSAg4n.js";
+import { C as isWechatIdeLoginRequiredError, E as promptWechatIdeLoginRetry, F as parseAutomatorPort, M as i18nText, N as validateLocaleOption, P as resolveAutomatorSessionOptions, a as bootstrapWechatDevtoolsSettings, j as configureLocaleFromArgv, k as runWithSuspendedSharedInput, o as detectWechatDevtoolsServicePort, y as createWechatIdeLoginRequiredExitError } from "./automator-BOe32upt.js";
+import { a as connectConsoleMiniProgram, c as releaseSharedMiniProgram, i as closeSharedMiniProgram, l as withMiniProgram$1, r as closeOwnedSharedMiniProgram, t as acquireConsoleMiniProgram, u as runRetryableCommand } from "./automator-session-VOB03glx.js";
+import { a as navigateBack, c as pageStack, d as remote, f as scrollTo, g as tap, i as input, l as reLaunch, m as systemInfo, n as captureScreenshotBuffer, o as navigateTo, p as switchTab, r as currentPage, s as pageData, t as audit, u as redirectTo } from "./commands-mslf7-sP.js";
+import "./run-mcp-Ni139Z5C.js";
 import path from "node:path";
 import { inspect } from "node:util";
 import { withMachineE2ELease } from "@weapp-vite/devtools-runtime";
@@ -494,7 +494,7 @@ async function runScreenshot(argv) {
 	}
 	const options = parseScreenshotArgs(argv);
 	const isJsonOutput = argv.includes("--json");
-	const { takeScreenshot } = await import("./commands-CZVPfkE9.js");
+	const { takeScreenshot } = await import("./commands-DmirGBy4.js");
 	const result = await takeScreenshot(options);
 	if (isJsonOutput) {
 		console.log(JSON.stringify(result, null, 2));
@@ -1055,6 +1055,7 @@ const WEAPP_IDE_TOP_LEVEL_COMMAND_NAMES = [
 	...WECHAT_CLI_COMMAND_NAMES,
 	...AUTOMATOR_COMMAND_NAMES,
 	...MINIDEV_NAMESPACE_COMMAND_NAMES,
+	"devtools",
 	CONFIG_COMMAND_NAME,
 	"mcp"
 ];
@@ -1066,6 +1067,91 @@ function isWeappIdeTopLevelCommand(command) {
 	return Boolean(command && WEAPP_IDE_TOP_LEVEL_COMMAND_SET.has(command));
 }
 //#endregion
+//#region src/config/resolver.ts
+function isCustomConfigJson(value) {
+	return typeof value === "object" && value !== null;
+}
+/**
+* @description 解析开发者工具自动预热相关配置的最终生效值。
+*/
+function resolveDevtoolsAutomationDefaults(config) {
+	return {
+		autoBootstrapDevtools: config.autoBootstrapDevtools ?? true,
+		autoTrustProject: config.autoTrustProject ?? false
+	};
+}
+/**
+* @description 读取并解析 CLI 配置（进程选择优先，其次用户配置与平台默认）
+*/
+async function getConfig() {
+	const frozen = wechatDevtoolsSelectionContext.getStore();
+	if (frozen) return {
+		...await readCustomConfig(),
+		cliPath: frozen.cliPath,
+		source: "environment"
+	};
+	if (process.env.WEAPP_IDE_DEVTOOLS_CHANNEL?.trim() || process.env.WEAPP_IDE_DEVTOOLS_VERSION?.trim()) {
+		const target = await resolveWechatDevtoolsTarget();
+		return {
+			...await readCustomConfig(),
+			cliPath: target.cliPath,
+			source: "environment"
+		};
+	}
+	const selectedCliPath = process.env.WEAPP_IDE_CLI_PATH?.trim();
+	if (await fs$1.pathExists(defaultCustomConfigFilePath)) try {
+		const rawConfig = await fs$1.readJSON(defaultCustomConfigFilePath);
+		const config = isCustomConfigJson(rawConfig) ? rawConfig : {};
+		const cliPath = typeof config.cliPath === "string" ? config.cliPath.trim() : "";
+		const locale = config.locale === "zh" || config.locale === "en" ? config.locale : void 0;
+		const autoBootstrapDevtools = typeof config.autoBootstrapDevtools === "boolean" ? config.autoBootstrapDevtools : void 0;
+		const autoTrustProject = typeof config.autoTrustProject === "boolean" ? config.autoTrustProject : void 0;
+		if (selectedCliPath || cliPath) {
+			logger.info(`全局配置文件路径：${colors.green(defaultCustomConfigFilePath)}`);
+			logger.info(`${selectedCliPath ? "进程指定" : "自定义"} CLI 路径：${colors.green(selectedCliPath || cliPath)}`);
+			return {
+				cliPath: selectedCliPath || cliPath,
+				locale,
+				autoBootstrapDevtools,
+				autoTrustProject,
+				source: selectedCliPath ? "environment" : "custom"
+			};
+		}
+		logger.warn("自定义配置文件缺少有效的 CLI 路径，将尝试使用默认路径。");
+	} catch (error) {
+		const reason = error instanceof Error ? error.message : String(error);
+		logger.warn(`解析自定义配置失败，${selectedCliPath ? "继续使用进程指定路径" : "将尝试使用默认路径"}。原因：${reason}`);
+	}
+	if (selectedCliPath) return {
+		cliPath: selectedCliPath,
+		source: "environment"
+	};
+	const fallbackPath = await selectInstalledWechatDevtools().then((target) => target.cliPath, (error) => {
+		if (error.code === "WECHAT_DEVTOOLS_INSTALLATION_NOT_FOUND") return;
+		throw error;
+	});
+	if (fallbackPath) return {
+		cliPath: fallbackPath,
+		locale: void 0,
+		autoBootstrapDevtools: void 0,
+		autoTrustProject: void 0,
+		source: "default"
+	};
+	return {
+		cliPath: "",
+		locale: void 0,
+		autoBootstrapDevtools: void 0,
+		autoTrustProject: void 0,
+		source: "missing"
+	};
+}
+/**
+* @description 获取用户配置的语言偏好。
+*/
+async function getConfiguredLocale() {
+	return (await readCustomConfig()).locale;
+}
+//#endregion
 //#region src/cli/prompt.ts
 /**
 * @description 交互式提示并保存 CLI 路径
@@ -1274,6 +1360,126 @@ 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/devtoolsSelection.ts
+const selectionOptions$1 = /* @__PURE__ */ new Map([
+	["--cli-path", "cliPath"],
+	["--devtools-channel", "devtoolsChannel"],
+	["--devtools-version", "devtoolsVersion"]
+]);
+const valueOptions = /* @__PURE__ */ new Set([
+	"--project",
+	"-p",
+	"--desc",
+	"-d",
+	"--version",
+	"-v",
+	"--uv",
+	"--appid",
+	"--ext-appid",
+	"--info-output",
+	"-i",
+	"--result-output",
+	"-r",
+	"--qr-output",
+	"--qr-format",
+	"--qr-size",
+	"--port",
+	"--timeout",
+	"-t",
+	"--session-id",
+	"--output",
+	"-o",
+	"--page",
+	"--lang",
+	"--platform",
+	"--runtime-url",
+	"--login-retry",
+	"--login-retry-timeout",
+	"--config",
+	"-c",
+	"--mode",
+	"-m",
+	"--filter",
+	"-f",
+	"--base",
+	"--logLevel",
+	"-l",
+	"--project-config",
+	"--logPath",
+	"--ticket",
+	"--account",
+	"--test-ticket",
+	"--compile-condition",
+	"--compile-type",
+	"--clean",
+	"--auto-port",
+	"--auto-account",
+	"--replay-config-path",
+	"--key-store",
+	"--key-alias",
+	"--key-pass",
+	"--store-pass",
+	"--use-aab",
+	"--resourceBundleVersion",
+	"--resourceBundleDesc",
+	"--isDistribute",
+	"--isRemoteBuild",
+	"--profilePath",
+	"--certificateName",
+	"--p12Path",
+	"--p12Password",
+	"--tpnsProfilePath",
+	"--isUploadBeta",
+	"--versionName",
+	"--versionCode",
+	"--versionDesc"
+]);
+/** 包装参数不会透传官方 CLI，选项值和双横线后的内容保持原样。 */
+function splitWechatDevtoolsSelectionArgs(argv) {
+	const selection = {};
+	const args = [];
+	for (let index = 0; index < argv.length; index++) {
+		const token = argv[index];
+		if (token === "--") {
+			args.push(...argv.slice(index));
+			break;
+		}
+		const equals = token.indexOf("=");
+		const name = equals < 0 ? token : token.slice(0, equals);
+		const key = selectionOptions$1.get(name);
+		if (key) {
+			const value = equals < 0 ? argv[++index] : token.slice(equals + 1);
+			if (!value?.trim() || value.startsWith("-")) throw new Error(`${name} requires a value.`);
+			if (selection[key] !== void 0 && selection[key] !== value.trim()) throw new Error(`Conflicting ${name} values in the same command.`);
+			Object.assign(selection, { [key]: value.trim() });
+		} else if (name === "--require-official-latest") {
+			const value = equals < 0 ? "true" : token.slice(equals + 1);
+			if (![
+				"true",
+				"false",
+				"1",
+				"0"
+			].includes(value)) throw new Error("--require-official-latest requires a boolean.");
+			const enabled = value === "true" || value === "1";
+			if (selection.requireOfficialLatest !== void 0 && selection.requireOfficialLatest !== enabled) throw new Error("Conflicting --require-official-latest values in the same command.");
+			selection.requireOfficialLatest = enabled;
+		} else {
+			args.push(token);
+			if (equals < 0 && valueOptions.has(name) && argv[index + 1] !== void 0) args.push(argv[++index]);
+		}
+	}
+	validateWechatDevtoolsSelection(selection);
+	return {
+		args,
+		selection
+	};
+}
+/** 显式选择在任何 helper 或 CLI 回退之前固定，避免入口间选版漂移。 */
+async function withWechatDevtoolsSelectionArgs(argv, runner) {
+	const { args, selection } = splitWechatDevtoolsSelectionArgs(argv);
+	return Object.keys(selection).length ? await withWechatDevtoolsSelection(selection, () => runner(args)) : await runner(args);
+}
+//#endregion
 //#region src/cli/managedProjectGate.ts
 function sameTarget(first, second) {
 	return first.installationId === second.installationId && first.cliPath === second.cliPath && first.appPath === second.appPath && first.profileDir === second.profileDir && first.version === second.version && first.channel === second.channel;
@@ -1286,7 +1492,7 @@ async function findConfirmedProject(journalPath, target, projectPath) {
 			"unconfirmed",
 			"closing",
 			"failed"
-		].includes(record.state))) throw new Error("Managed DevTools journal contains unresolved ownership or cleanup; refusing a project mutation.");
+		].includes(record.state) || record.state === "released" && !isManagedWechatProjectFullyReleased(record) || record.state === "borrowed" && record.snapshot?.state !== void 0 && record.snapshot.state !== "removed")) throw new Error("Managed DevTools journal contains unresolved ownership or cleanup; refusing a project mutation.");
 		return scopeRoot === journalPath ? scopeRecords : await readManagedWechatProjectRecords(journalPath);
 	})).filter((record) => record.state !== "released" && record.projectPath === projectPath && sameTarget(record.target, target));
 	for (const record of matching) try {
@@ -1319,8 +1525,8 @@ async function ensureManagedWechatProject(target, projectPath, options = {}) {
 		await assertManagedInstallation(target);
 		options.signal?.throwIfAborted();
 		if (existing) return existing;
-		const { launchAutomator } = await import("./automator-BkZZsGtn.js");
-		(await launchAutomator({
+		const { launchAutomator } = await import("./automator-VSjgHujY.js");
+		await (await launchAutomator({
 			target,
 			cliPath: target.cliPath,
 			projectPath: resolvedProjectPath,
@@ -1699,6 +1905,30 @@ async function prepareAcceptanceProject(projectPath, signal, options = {}) {
 	});
 }
 //#endregion
+//#region src/cli/forwardConsole/refresh.ts
+/** 刷新已有项目的日志开关，并保留日志启用与连接释放的独立错误。 */
+async function refreshOpenedMiniProgramConsoleLog(options, enableLog) {
+	const miniProgram = await connectConsoleMiniProgram({
+		...options,
+		openedOnly: true
+	});
+	let failure;
+	let failed = false;
+	try {
+		await enableLog(miniProgram);
+	} catch (error) {
+		failed = true;
+		failure = error;
+	}
+	try {
+		await miniProgram.disconnect();
+	} catch (cleanupError) {
+		if (failed) throw new AggregateError([failure, cleanupError], "Console log refresh and connection cleanup failed", { cause: failure });
+		throw cleanupError;
+	}
+	if (failed) throw failure;
+}
+//#endregion
 //#region src/cli/forwardConsole.ts
 const DEFAULT_FORWARD_CONSOLE_LEVELS = [
 	"log",
@@ -1842,29 +2072,28 @@ async function acquireForwardConsoleMiniProgram(options) {
 			return miniProgram;
 		} catch (error) {
 			lastError = error;
-			if (miniProgram) releaseSharedMiniProgram(options.projectPath, options.sessionId || options.port, options);
-			await closeSharedMiniProgram(options.projectPath, options.sessionId || options.port, options);
+			const cleanupErrors = [];
+			if (miniProgram) try {
+				await releaseSharedMiniProgram(options.projectPath, options.sessionId || options.port, options);
+			} catch (cleanupError) {
+				cleanupErrors.push(cleanupError);
+			}
+			try {
+				await closeSharedMiniProgram(options.projectPath, options.sessionId || options.port, options);
+			} catch (cleanupError) {
+				cleanupErrors.push(cleanupError);
+			}
+			if (cleanupErrors.length) throw new AggregateError([error, ...cleanupErrors], "Forward console setup and connection cleanup failed", { cause: error });
 			if (attempt < ENABLE_LOG_RETRY_TIMES) await sleep(ENABLE_LOG_RETRY_DELAY_MS);
 		}
 	}
 	throw lastError instanceof Error ? lastError : new Error(String(lastError));
 }
-async function refreshOpenedMiniProgramConsoleLog(options) {
-	const miniProgram = await connectConsoleMiniProgram({
-		...options,
-		openedOnly: true
-	});
-	try {
-		await enableMiniProgramConsoleLog(miniProgram);
-	} finally {
-		miniProgram.disconnect();
-	}
-}
 function startEnableLogRefresh(miniProgram, options, refreshOpenedSession) {
 	if (typeof miniProgram.enableLog !== "function") return;
 	const timer = setInterval(() => {
 		miniProgram.enableLog(ENABLE_LOG_TIMEOUT_MS).catch(() => {});
-		if (refreshOpenedSession) refreshOpenedMiniProgramConsoleLog(options).catch(() => {});
+		if (refreshOpenedSession) refreshOpenedMiniProgramConsoleLog(options, enableMiniProgramConsoleLog).catch(() => {});
 	}, ENABLE_LOG_REFRESH_INTERVAL_MS);
 	return () => {
 		clearInterval(timer);
@@ -1900,8 +2129,10 @@ async function startForwardConsole(options) {
 	let stopEnableLogRefresh;
 	let auxiliaryMiniProgram;
 	let auxiliaryTimer;
-	const closeSession = async () => {
-		if (closed) return;
+	let closing;
+	let sharedReleased = false;
+	const closeSession = () => {
+		if (closing) return closing;
 		closed = true;
 		if (auxiliaryTimer) {
 			clearTimeout(auxiliaryTimer);
@@ -1911,13 +2142,33 @@ async function startForwardConsole(options) {
 		stopEnableLogRefresh = void 0;
 		detachMiniProgramListener(miniProgram, "console", onConsole);
 		detachMiniProgramListener(miniProgram, "exception", onException);
-		if (auxiliaryMiniProgram) {
-			detachMiniProgramListener(auxiliaryMiniProgram, "console", onConsole);
-			detachMiniProgramListener(auxiliaryMiniProgram, "exception", onException);
-			auxiliaryMiniProgram.disconnect();
-			auxiliaryMiniProgram = void 0;
-		}
-		if (usesSharedSession) releaseSharedMiniProgram(options.projectPath, options.sessionId || options.port, options);
+		closing = (async () => {
+			const errors = [];
+			if (auxiliaryMiniProgram) {
+				detachMiniProgramListener(auxiliaryMiniProgram, "console", onConsole);
+				detachMiniProgramListener(auxiliaryMiniProgram, "exception", onException);
+				try {
+					await auxiliaryMiniProgram.disconnect();
+					auxiliaryMiniProgram = void 0;
+				} catch (error) {
+					errors.push(error);
+				}
+			}
+			if (usesSharedSession) try {
+				if (!sharedReleased) {
+					sharedReleased = true;
+					await releaseSharedMiniProgram(options.projectPath, options.sessionId || options.port, options);
+				}
+				await closeOwnedSharedMiniProgram(options, miniProgram);
+			} catch (error) {
+				errors.push(error);
+			}
+			if (errors.length) throw new AggregateError(errors, "Forward console session cleanup failed");
+		})().catch((error) => {
+			closing = void 0;
+			throw error;
+		});
+		return closing;
 	};
 	miniProgram.on("console", onConsole);
 	miniProgram.on("exception", onException);
@@ -1929,7 +2180,7 @@ async function startForwardConsole(options) {
 				openedOnly: true
 			});
 			if (closed) {
-				openedMiniProgram.disconnect();
+				await openedMiniProgram.disconnect();
 				return;
 			}
 			auxiliaryMiniProgram = openedMiniProgram;
@@ -2077,6 +2328,22 @@ async function runMinidev(argv) {
 	}
 }
 //#endregion
+//#region src/cli/devtools.ts
+/** 本地安装管理不启动 IDE，不更改账号或默认 CLI 配置。 */
+async function handleDevtoolsCommand(argv) {
+	const [action = "list", cliPath] = argv;
+	if (action === "list") {
+		const installations = await listWechatDevtoolsInstallations();
+		if (argv.includes("--json")) console.log(JSON.stringify({ installations }, null, 2));
+		else for (const entry of installations) console.log(entry.target ? `${entry.target.channel ?? "unknown"}@${entry.target.version ?? "unknown"}\n  CLI: ${entry.cliPath}\n  installation: ${entry.target.installationId}\n  profile: ${entry.target.profileDir}` : `unavailable: ${entry.cliPath}\n  ${entry.error}`);
+		return;
+	}
+	if (action !== "add" && action !== "remove") throw new Error("Use weapp devtools list [--json] | add <path-to-cli> | remove <path-to-cli>.");
+	if (!cliPath || argv.length !== 2) throw new Error(`weapp devtools ${action} requires one CLI path.`);
+	if (action === "add") console.log(JSON.stringify(await registerWechatDevtoolsInstallation(cliPath), null, 2));
+	else await unregisterWechatDevtoolsInstallation(cliPath);
+}
+//#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)`));
@@ -2274,6 +2541,7 @@ async function resolveWechatCliCommandTarget(options = {}) {
 		logger.warn(i18nText(`微信web开发者工具不支持当前平台：${operatingSystemName} !`, `Wechat Web DevTools CLI is not supported on current platform: ${operatingSystemName}!`));
 		return;
 	}
+	if (options.cliPath || options.devtoolsChannel || options.devtoolsVersion || options.requireOfficialLatest) return await resolveWechatDevtoolsTarget(options);
 	let target = options.target;
 	if (!target) {
 		const { cliPath, source } = await resolveCliPath();
@@ -2393,6 +2661,20 @@ function validateWechatCliCommandArgs(argv) {
 }
 //#endregion
 //#region src/cli/wechat-commands.ts
+function selectionOptions(options) {
+	return Object.fromEntries([
+		"cliPath",
+		"target",
+		"devtoolsChannel",
+		"devtoolsVersion",
+		"requireOfficialLatest"
+	].filter((key) => options[key] !== void 0).map((key) => [key, options[key]]));
+}
+async function runSelectedCommand(argv, options) {
+	const selection = selectionOptions(options);
+	if (Object.keys(selection).length) await runWechatCliCommand(argv, selection);
+	else await runWechatCliCommand(argv);
+}
 const DEVTOOLS_SHUTDOWN_TIMEOUT_MS = 1e4;
 function appendProjectLocatorArgv(argv, options) {
 	if (options.projectPath) argv.push("--project", path.resolve(options.projectPath));
@@ -2418,7 +2700,7 @@ async function openSelectedWechatIde(options, target) {
 /** 打开与兼容回退在同一机器租约内沿用固定安装，禁止重新选择宿主。 */
 async function openWechatIde(options = {}) {
 	return await withMachineE2ELease(async () => {
-		const target = await resolveWechatCliCommandTarget();
+		const target = await resolveWechatCliCommandTarget(options);
 		if (target) {
 			if (process.env["WEAPP_IDE_MANAGED_PROJECT_JOURNAL"]?.trim()) {
 				if (!options.projectPath) throw new Error("Managed DevTools open requires an explicit project path; no project was opened.");
@@ -2438,7 +2720,7 @@ async function loginWechatIde(options = {}) {
 	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);
+	await runSelectedCommand(argv, options);
 }
 /**
 * @description 调用微信开发者工具 islogin 命令。
@@ -2446,8 +2728,11 @@ async function loginWechatIde(options = {}) {
 async function isWechatIdeLoggedIn(options = {}) {
 	const argv = ["islogin"];
 	if (options.nonInteractive) argv.push("--non-interactive");
-	if (options.silent) await runWechatCliCommand(argv, { silent: true });
-	else await runWechatCliCommand(argv);
+	if (options.silent) await runWechatCliCommand(argv, {
+		...selectionOptions(options),
+		silent: true
+	});
+	else await runSelectedCommand(argv, options);
 }
 /**
 * @description 调用微信开发者工具 build-npm 命令。
@@ -2459,7 +2744,7 @@ async function buildWechatIdeNpm(options = {}) {
 		path.resolve(options.projectPath ?? process.cwd())
 	];
 	if (options.compileType) argv.push("--compile-type", options.compileType);
-	await runWechatCliCommand(argv);
+	await runSelectedCommand(argv, options);
 }
 /**
 * @description 调用微信开发者工具 preview 命令。
@@ -2472,7 +2757,7 @@ async function previewWechatIde(options = {}) {
 	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);
+	await runSelectedCommand(argv, options);
 }
 /**
 * @description 调用微信开发者工具 auto-preview 命令。
@@ -2482,7 +2767,7 @@ async function autoPreviewWechatIde(options = {}) {
 	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);
+	await runSelectedCommand(argv, options);
 }
 /**
 * @description 调用微信开发者工具 auto 命令。
@@ -2495,7 +2780,7 @@ async function autoWechatIde(options = {}) {
 	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);
+	await runSelectedCommand(argv, options);
 }
 /**
 * @description 调用微信开发者工具 auto-replay 命令。
@@ -2510,7 +2795,7 @@ async function autoReplayWechatIde(options = {}) {
 	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);
+	await runSelectedCommand(argv, options);
 }
 /**
 * @description 调用微信开发者工具 upload 命令。
@@ -2520,7 +2805,7 @@ async function uploadWechatIde(options) {
 	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);
+	await runSelectedCommand(argv, options);
 }
 /**
 * @description 调用微信开发者工具 close 命令。
@@ -2530,45 +2815,50 @@ async function closeWechatIdeProject(options = {}) {
 	if (options.cliPath !== void 0 && !options.cliPath.trim()) throw new Error("The explicit close cliPath must not be empty.");
 	const argv = ["close"];
 	appendProjectLocatorArgv(argv, options);
-	const target = options.target || options.cliPath ? await resolveWechatDevtoolsTarget({
-		target: options.target,
-		cliPath: options.cliPath
-	}) : void 0;
+	const target = options.target || options.cliPath || options.devtoolsChannel || options.devtoolsVersion ? await resolveWechatDevtoolsTarget(selectionOptions(options)) : void 0;
 	await runWechatCliCommand(argv, {
-		...target ? { target } : {},
+		...target ? { target } : selectionOptions(options),
 		timeout: DEVTOOLS_SHUTDOWN_TIMEOUT_MS
 	});
 }
 /**
 * @description 调用微信开发者工具 quit 命令。
 */
-async function quitWechatIde() {
-	await runWechatCliCommand(["quit"], { timeout: DEVTOOLS_SHUTDOWN_TIMEOUT_MS });
+async function quitWechatIde(options = {}) {
+	await runWechatCliCommand(["quit"], {
+		...selectionOptions(options),
+		timeout: DEVTOOLS_SHUTDOWN_TIMEOUT_MS
+	});
 }
 /**
 * @description 调用微信开发者工具 cache 命令。
 */
 async function clearWechatIdeCache(options) {
-	await runWechatCliCommand([
+	await runSelectedCommand([
 		"cache",
 		"--clean",
 		options.clean
-	]);
+	], options);
 }
 /**
 * @description 调用微信开发者工具 open-other 命令。
 */
-async function openWechatIdeOtherProject(_options = {}) {
-	await runWechatCliCommand(["open-other"]);
+async function openWechatIdeOtherProject(options = {}) {
+	await runSelectedCommand(["open-other"], options);
 }
 /**
 * @description 通过微信开发者工具 HTTP 服务端口重置指定项目的 fileutils 状态。
 */
 async function resetWechatIdeFileUtils(options) {
-	await resetWechatIdeFileUtilsByHttp(path.resolve(options.projectPath));
+	const selection = selectionOptions(options);
+	if (Object.keys(selection).length) await resetWechatIdeFileUtilsByHttp(path.resolve(options.projectPath), selection);
+	else await resetWechatIdeFileUtilsByHttp(path.resolve(options.projectPath));
 }
 function createAutomatorSessionOptions(options) {
 	return {
+		cliPath: options.cliPath,
+		target: options.target,
+		...selectionOptions(options),
 		...options.port ? { port: options.port } : {},
 		preferOpenedSession: options.preferOpenedSession ?? true,
 		preserveProjectRoot: options.preserveProjectRoot,
@@ -2656,7 +2946,7 @@ async function buildWechatIdeApk(options) {
 	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);
+	await runSelectedCommand(argv, options);
 }
 /**
 * @description 调用微信开发者工具 build-ipa 命令。
@@ -2682,7 +2972,7 @@ async function buildWechatIdeIpa(options) {
 	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);
+	await runSelectedCommand(argv, options);
 }
 //#endregion
 //#region src/cli/wechat-dispatch.ts
@@ -2898,6 +3188,11 @@ function createCli() {
 	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("devtools [...args]", "管理本机多版本开发者工具").allowUnknownOptions();
+	cli.option("--devtools-channel <channel>", "选择 stable | rc | nightly");
+	cli.option("--devtools-version <version>", "固定开发者工具产品版本");
+	cli.option("--cli-path <path>", "固定开发者工具 CLI 安装路径");
+	cli.option("--require-official-latest", "要求匹配所选渠道的官方最新版本");
 	cli.command(`${CONFIG_COMMAND_NAME} [...args]`, "配置 weapp-ide-cli").allowUnknownOptions();
 	cli.command(`mcp [...args]`, "启动 weapp-ide-cli MCP 服务").allowUnknownOptions();
 	for (const command of AUTOMATOR_COMMAND_NAMES) cli.command(`${command} [...args]`, "automator 增强命令").allowUnknownOptions();
@@ -2946,7 +3241,7 @@ function createMinidevOpenArgv(argv) {
 /**
 * @description CLI 入口解析与分发。
 */
-async function parse(argv) {
+async function parseSelected(argv) {
 	validateLocaleOption(argv);
 	configureLocaleFromArgv(argv, await getConfiguredLocale());
 	const cli = createCli();
@@ -2968,12 +3263,16 @@ async function parse(argv) {
 		await runMinidev(argv.slice(1));
 		return;
 	}
+	if (matchedCommand === "devtools") {
+		await handleDevtoolsCommand(argv.slice(1));
+		return;
+	}
 	if (matchedCommand === "config") {
 		await handleConfigCommand(argv.slice(1));
 		return;
 	}
 	if (matchedCommand === "mcp") {
-		const { runMcpCommand } = await import("./run-mcp-CPv8cesh.js");
+		const { runMcpCommand } = await import("./run-mcp-83-VKZVA.js");
 		await runMcpCommand(argv.slice(1));
 		return;
 	}
@@ -2990,5 +3289,17 @@ async function parse(argv) {
 	if (await dispatchWechatCliCommand(formattedArgv)) return;
 	await runWechatCliCommand(formattedArgv);
 }
+/** 在分发前剥离公共选择参数并固定本次安装。 */
+async function parse(argv) {
+	if ([
+		"help",
+		"config",
+		"devtools",
+		"alipay",
+		"ali",
+		"minidev"
+	].includes(argv[0] ?? "") || argv.includes("--help") || argv.includes("-h")) return await parseSelected(argv);
+	return await withWechatDevtoolsSelectionArgs(argv, parseSelected);
+}
 //#endregion
-export { MINIDEV_NAMESPACE_COMMAND_NAMES as $, queryWechatIdeLogin as A, WECHAT_DEVTOOLS_ENGINE_BUILD_STATUSES as B, refreshWechatIdeTicket as C, validateWechatCliCommandArgs as D, uploadWechatIde as E, startForwardConsole as F, startWechatIdeEngineBuildByHttp as G, pollWechatIdeEngineBuildResultByHttp as H, isWechatIdeEngineBuildEndpointMissingError as I, handleConfigCommand as J, getRuntimeWechatDevtoolsServicePort as K, prepareAcceptanceProject as L, createAlias as M, createPathCompat as N, runWechatCliWithRetry as O, transformArgv as P, MCP_COMMAND_NAME as Q, runWechatIdeEngineBuild as R, quitWechatIde as S, setWechatIdeTicket as T, requestWechatDevtoolsHttp as U, openWechatIdeProjectByHttp as V, resetWechatIdeFileUtilsByHttp as W, promptForCliPath as X, resolveCliPath as Y, CONFIG_COMMAND_NAME as Z, isWechatIdeLoggedIn as _, autoReplayWechatIde as a, isAutomatorCommand as at, openWechatIdeOtherProject as b, buildWechatIdeIpa as c, printScreenshotHelp as ct, clearWechatIdeCacheByAutomator as d, parseAutomatorArgs as dt, WEAPP_IDE_TOP_LEVEL_COMMAND_NAMES as et, closeWechatIdeProject as f, readBooleanOption as ft, getWechatIdeToolInfo as g, getWechatIdeTicket as h, autoPreviewWechatIde as i, getAutomatorCommandHelp as it, execute as j, runMinidev as k, buildWechatIdeNpm as l, parseCompareArgs as lt, getWechatIdeTestAccounts as m, removeOption as mt, parse as n, isWeappIdeTopLevelCommand as nt, autoWechatIde as o, runAutomatorCommand as ot, compileWechatIdeByAutomator as p, readOptionValue as pt, setRuntimeWechatDevtoolsServicePort as q, dispatchWechatCliCommand as r, AUTOMATOR_COMMAND_NAMES as rt, buildWechatIdeApk as s, parseScreenshotArgs as st, createCli as t, WECHAT_CLI_COMMAND_NAMES as tt, clearWechatIdeCache as u, printCompareHelp as ut, loginWechatIde as v, resetWechatIdeFileUtils as w, previewWechatIde as x, openWechatIde as y, runWechatIdeEngineBuildByHttp as z };
+export { getConfig as $, queryWechatIdeLogin as A, WECHAT_DEVTOOLS_ENGINE_BUILD_STATUSES as B, refreshWechatIdeTicket as C, validateWechatCliCommandArgs as D, uploadWechatIde as E, startForwardConsole as F, startWechatIdeEngineBuildByHttp as G, pollWechatIdeEngineBuildResultByHttp as H, isWechatIdeEngineBuildEndpointMissingError as I, splitWechatDevtoolsSelectionArgs as J, getRuntimeWechatDevtoolsServicePort as K, prepareAcceptanceProject as L, createAlias as M, createPathCompat as N, runWechatCliWithRetry as O, transformArgv as P, promptForCliPath as Q, runWechatIdeEngineBuild as R, quitWechatIde as S, setWechatIdeTicket as T, requestWechatDevtoolsHttp as U, openWechatIdeProjectByHttp as V, resetWechatIdeFileUtilsByHttp as W, handleConfigCommand as X, withWechatDevtoolsSelectionArgs as Y, resolveCliPath as Z, isWechatIdeLoggedIn as _, readBooleanOption as _t, autoReplayWechatIde as a, WEAPP_IDE_TOP_LEVEL_COMMAND_NAMES as at, openWechatIdeOtherProject as b, buildWechatIdeIpa as c, AUTOMATOR_COMMAND_NAMES as ct, clearWechatIdeCacheByAutomator as d, runAutomatorCommand as dt, getConfiguredLocale as et, closeWechatIdeProject as f, parseScreenshotArgs as ft, getWechatIdeToolInfo as g, parseAutomatorArgs as gt, getWechatIdeTicket as h, printCompareHelp as ht, autoPreviewWechatIde as i, MINIDEV_NAMESPACE_COMMAND_NAMES as it, execute as j, runMinidev as k, buildWechatIdeNpm as l, getAutomatorCommandHelp as lt, getWechatIdeTestAccounts as m, parseCompareArgs as mt, parse as n, CONFIG_COMMAND_NAME as nt, autoWechatIde as o, WECHAT_CLI_COMMAND_NAMES as ot, compileWechatIdeByAutomator as p, printScreenshotHelp as pt, setRuntimeWechatDevtoolsServicePort as q, dispatchWechatCliCommand as r, MCP_COMMAND_NAME as rt, buildWechatIdeApk as s, isWeappIdeTopLevelCommand as st, createCli as t, resolveDevtoolsAutomationDefaults as tt, clearWechatIdeCache as u, isAutomatorCommand as ut, loginWechatIde as v, readOptionValue as vt, resetWechatIdeFileUtils as w, previewWechatIde as x, openWechatIde as y, removeOption as yt, runWechatIdeEngineBuildByHttp as z };