weapp-ide-cli 6.1.9 → 6.3.0

package/dist/{cli-2sY1sAVq.js → cli-CFlqFpIw.js}

@@ -1,15 +1,191 @@
-import { $ as createAutoTrustProjectConfig, D as validateLocaleOption, E as i18nText, G as resolveDevtoolsAutomationDefaults, H as resolveCliPath, Q as createAutoBootstrapDevtoolsConfig, T as configureLocaleFromArgv, W as getConfiguredLocale, X as colors, Z as logger_default, et as createCustomConfig, i as connectConsoleMiniProgram, it as removeCustomConfigKey, nt as overwriteCustomConfig, ot as defaultCustomConfigFilePath, r as closeSharedMiniProgram, rt as readCustomConfig, s as releaseSharedMiniProgram, t as acquireConsoleMiniProgram, tt as createLocaleConfig } from "./automator-session-fbanL2eW.js";
-import { A as isWechatIdeLoggedIn, B as runWechatCliCommand, C as clearWechatIdeCache, F as quitWechatIde, G as transformArgv, H as execute, K as promptForCliPath, L as resetWechatIdeFileUtils, M as openWechatIde, N as openWechatIdeOtherProject, P as previewWechatIde, Q as startWechatIdeEngineBuildByHttp, S as buildWechatIdeNpm, T as closeWechatIdeProject, U as createAlias, W as createPathCompat, Y as pollWechatIdeEngineBuildResultByHttp, _ as autoPreviewWechatIde, a as navigateBack, b as buildWechatIdeApk, c as pageStack, d as remote, f as scrollTo, g as tap, i as input, it as removeOption, j as loginWechatIde, l as reLaunch, m as systemInfo, n as captureScreenshotBuffer, nt as readBooleanOption, o as navigateTo, p as switchTab, r as currentPage, rt as readOptionValue, s as pageData, t as audit, tt as parseAutomatorArgs, u as redirectTo, v as autoReplayWechatIde, x as buildWechatIdeIpa, y as autoWechatIde, z as uploadWechatIde } from "./commands-__RJ552L.js";
-import "./run-mcp-LqaWlQJ_.js";
-import fs from "node:fs/promises";
+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";
+import { execa } from "execa";
+import fs from "node:fs/promises";
+import process, { stdin, stdout } from "node:process";
 import { fs as fs$1 } from "@weapp-core/shared/fs";
-import process from "node:process";
+import { OperationLifecycle, readWechatLoginState } from "@weapp-vite/miniprogram-automator/operation";
 import { PNG } from "pngjs";
 import pixelmatch from "pixelmatch";
-import { execa } from "execa";
-import { inspect } from "node:util";
+import { createInterface } from "node:readline/promises";
 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 === "--cli-path" || optionName === "--port" || optionName === "--session-id" || optionName === "-o" || optionName === "--output" || optionName === "--page" || optionName === "--login-retry" || optionName === "--login-retry-timeout" || optionName === "--lang" || optionName === "--platform" || optionName === "--runtime-url" || optionName === "--qr-output" || optionName === "-r" || optionName === "--result-output" || optionName === "--info-output" || optionName === "-i";
+}
+/**
+* @description 解析 automator 命令通用参数与位置参数。
+*/
+function parseAutomatorArgs(argv) {
+	const positionals = [];
+	let projectPath = process.cwd();
+	let cliPath;
+	let timeout;
+	let port;
+	let sessionId;
+	let preferOpenedSession;
+	let json = false;
+	for (let index = 0; index < argv.length; index += 1) {
+		const token = argv[index];
+		if (!token) continue;
+		if (token === "-p" || token === "--project") {
+			const value = argv[index + 1];
+			if (typeof value === "string" && !value.startsWith("-")) {
+				projectPath = value;
+				index += 1;
+			} else projectPath = process.cwd();
+			continue;
+		}
+		if (token.startsWith("--project=")) {
+			projectPath = token.slice(10) || process.cwd();
+			continue;
+		}
+		if (token === "--cli-path") {
+			const value = argv[index + 1];
+			if (value && !value.startsWith("-")) {
+				cliPath = value;
+				index += 1;
+			}
+			continue;
+		}
+		if (token.startsWith("--cli-path=")) {
+			cliPath = token.slice(11) || void 0;
+			continue;
+		}
+		if (token === "-t" || token === "--timeout") {
+			const value = argv[index + 1];
+			if (typeof value === "string") {
+				timeout = parsePositiveInt(value);
+				index += 1;
+			}
+			continue;
+		}
+		if (token.startsWith("--timeout=")) {
+			timeout = parsePositiveInt(token.slice(10));
+			continue;
+		}
+		if (token === "--port") {
+			port = parseAutomatorPort(argv[index + 1]);
+			index += 1;
+			continue;
+		}
+		if (token.startsWith("--port=")) {
+			port = parseAutomatorPort(token.slice(7));
+			continue;
+		}
+		if (token === "--session-id") {
+			const value = argv[index + 1];
+			if (typeof value === "string" && !value.startsWith("-")) {
+				sessionId = value.trim() || void 0;
+				index += 1;
+			}
+			continue;
+		}
+		if (token.startsWith("--session-id=")) {
+			sessionId = token.slice(13).trim() || void 0;
+			continue;
+		}
+		if (token === "--json") {
+			json = true;
+			continue;
+		}
+		if (token === "--no-runtime-service") {
+			preferOpenedSession = false;
+			continue;
+		}
+		if (token.startsWith("-")) {
+			if (takesValue(token.includes("=") ? token.slice(0, token.indexOf("=")) : token) && !token.includes("=")) {
+				const value = argv[index + 1];
+				if (typeof value === "string" && !value.startsWith("-")) index += 1;
+			}
+			continue;
+		}
+		positionals.push(token);
+	}
+	return {
+		...cliPath ? { cliPath } : {},
+		projectPath,
+		...timeout ? { timeout } : {},
+		...port ? { port } : {},
+		...sessionId ? { sessionId } : {},
+		...preferOpenedSession === false ? { preferOpenedSession } : {},
+		json,
+		positionals
+	};
+}
+/**
+* @description 读取选项值，支持多个别名，以及 --option value 与 --option=value。
+*/
+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;
+			}
+		}
+	}
+}
+/**
+* @description 删除参数中的指定选项（同时支持 --opt value 与 --opt=value）。
+*/
+function removeOption(argv, optionName) {
+	const optionWithEqual = `${optionName}=`;
+	const nextArgv = [];
+	for (let index = 0; index < argv.length; index += 1) {
+		const token = argv[index];
+		if (!token) continue;
+		if (token === optionName) {
+			const nextToken = argv[index + 1];
+			if (takesValue(optionName) && typeof nextToken === "string" && !nextToken.startsWith("-")) index += 1;
+			continue;
+		}
+		if (token.startsWith(optionWithEqual)) continue;
+		nextArgv.push(token);
+	}
+	return nextArgv;
+}
+//#endregion
 //#region src/cli/imageDiff.ts
 function readPng(buffer, label) {
 	try {
@@ -298,6 +474,7 @@ function parseScreenshotArgs(argv) {
 	const fullPage = argv.includes("--full-page");
 	return {
 		projectPath: parsed.projectPath,
+		...parsed.cliPath ? { cliPath: parsed.cliPath } : {},
 		...parsed.timeout ? { timeout: parsed.timeout } : {},
 		...parsed.port ? { port: parsed.port } : {},
 		...parsed.sessionId ? { sessionId: parsed.sessionId } : {},
@@ -317,7 +494,7 @@ async function runScreenshot(argv) {
 	}
 	const options = parseScreenshotArgs(argv);
 	const isJsonOutput = argv.includes("--json");
-	const { takeScreenshot } = await import("./commands-DpMG1w04.js");
+	const { takeScreenshot } = await import("./commands-DmirGBy4.js");
 	const result = await takeScreenshot(options);
 	if (isJsonOutput) {
 		console.log(JSON.stringify(result, null, 2));
@@ -350,8 +527,13 @@ function resolveOutputPath(outputPath) {
 	return outputPath ? path.resolve(outputPath) : void 0;
 }
 function createConnectionPayload(args) {
+	const cliPath = args.cliPath ?? process.env.WEAPP_IDE_CLI_PATH;
 	return {
 		projectPath: resolveProjectPath(args.projectPath),
+		...cliPath ? { cliPath } : {},
+		...args.port ? { port: args.port } : {},
+		...args.sessionId ? { sessionId: args.sessionId } : {},
+		...args.preferOpenedSession !== void 0 ? { preferOpenedSession: args.preferOpenedSession } : {},
 		...args.timeout ? { timeout: args.timeout } : {}
 	};
 }
@@ -405,7 +587,7 @@ async function runRouteCommand(command, args, baseUrl) {
 	}, (args.timeout ?? 3e4) + 5e3);
 	if (result === void 0) return false;
 	if (args.json) printJsonResult(result);
-	else logger_default.success(`已通过 runtime service 执行 ${command}：${formatRuntimeServiceUrl(baseUrl)}`);
+	else logger.success(`已通过 runtime service 执行 ${command}：${formatRuntimeServiceUrl(baseUrl)}`);
 	return true;
 }
 async function runInfoCommand(command, args, baseUrl) {
@@ -424,20 +606,18 @@ async function runScreenshotCommand(argv, baseUrl) {
 	if (options.fullPage) return false;
 	if (options.page) {
 		if (await tryRequestRuntimeService(baseUrl, "/route", {
-			projectPath: resolveProjectPath(options.projectPath),
-			...options.timeout ? { timeout: options.timeout } : {},
+			...createConnectionPayload(options),
 			path: options.page,
 			transition: "reLaunch"
 		}, (options.timeout ?? 3e4) + 5e3) === void 0) return false;
 	}
 	const result = await tryRequestRuntimeService(baseUrl, "/capture", {
-		projectPath: resolveProjectPath(options.projectPath),
-		...options.timeout ? { timeout: options.timeout } : {},
+		...createConnectionPayload(options),
 		...options.outputPath ? { outputPath: resolveOutputPath(options.outputPath) } : {}
 	}, (options.timeout ?? 3e4) + 5e3);
 	if (result === void 0) return false;
 	if (argv.includes("--json")) printJsonResult(options.outputPath ? { path: options.outputPath } : result);
-	else if (options.outputPath) logger_default.success(`截图已通过 runtime service 保存到 ${colors.cyan(options.outputPath)}`);
+	else if (options.outputPath) logger.success(`截图已通过 runtime service 保存到 ${colors.cyan(options.outputPath)}`);
 	else if (result.base64) process.stdout.write(`${result.base64}\n`);
 	return true;
 }
@@ -454,6 +634,13 @@ async function tryRunRuntimeServiceCommand(command, argv) {
 //#endregion
 //#region src/cli/run-automator.ts
 const COMMON_OPTION_DEFINITIONS = [
+	{
+		flag: "--cli-path <path>",
+		description: {
+			zh: "指定微信开发者工具安装",
+			en: "Select the WeChat DevTools installation"
+		}
+	},
 	{
 		flag: "-p, --project <path>",
 		description: {
@@ -519,6 +706,7 @@ const COMMON_OPTION_DEFINITIONS = [
 	}
 ];
 const COMMON_ALLOWED_OPTIONS = /* @__PURE__ */ new Set([
+	"--cli-path",
 	"-p",
 	"--project",
 	"-t",
@@ -805,7 +993,7 @@ function printCommandHelp(command) {
 		console.log(help);
 		return;
 	}
-	logger_default.warn(i18nText(`命令 ${command} 暂无帮助信息`, `No help available for command: ${command}`));
+	logger.warn(i18nText(`命令 ${command} 暂无帮助信息`, `No help available for command: ${command}`));
 }
 /**
 * @description 执行 automator 子命令。
@@ -867,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"
 ];
@@ -878,6 +1067,144 @@ 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 路径
+*/
+async function promptForCliPath() {
+	return await runWithSuspendedSharedInput(async () => {
+		const rl = createInterface({
+			input: stdin,
+			output: stdout
+		});
+		try {
+			logger.info(`请设置 ${colors.bold("微信web开发者工具 CLI")} 的路径`);
+			logger.info("提示：命令行工具默认所在位置：");
+			logger.info(`- MacOS: ${colors.green("<安装路径>/Contents/MacOS/cli")}`);
+			logger.info(`- Windows: ${colors.green("<安装路径>/cli.bat")}`);
+			logger.info(`- Linux: ${colors.green("<安装路径>/files/bin/bin/wechat-devtools-cli")}`);
+			const cliPath = (await rl.question("请输入微信web开发者工具 CLI 路径：")).trim();
+			if (!cliPath) {
+				logger.error("路径不能为空，已取消本次配置。");
+				return null;
+			}
+			try {
+				const normalizedPath = await createCustomConfig({ cliPath });
+				logger.info(`全局配置存储位置：${colors.green(defaultCustomConfigFilePath)}`);
+				if (!await fs$1.pathExists(normalizedPath)) logger.warn("在当前路径未找到微信web开发者命令行工具，请确认路径是否正确。");
+				return normalizedPath;
+			} catch (error) {
+				const reason = error instanceof Error ? error.message : String(error);
+				logger.error(`保存配置失败：${reason}`);
+				return null;
+			}
+		} finally {
+			rl.close();
+		}
+	});
+}
+//#endregion
+//#region src/cli/resolver.ts
+/**
+* @description 解析 CLI 路径并校验可用性
+*/
+async function resolveCliPath() {
+	const config = await getConfig();
+	if (!config.cliPath) return {
+		cliPath: null,
+		source: config.source
+	};
+	return {
+		cliPath: await fs$1.pathExists(config.cliPath) ? config.cliPath : null,
+		source: config.source
+	};
+}
+//#endregion
 //#region src/cli/config-command.ts
 function parseBooleanConfigValue(rawValue) {
 	const normalized = rawValue.trim().toLowerCase();
@@ -898,13 +1225,13 @@ async function handleConfigCommand(argv) {
 		const nextLocale = argv[1];
 		if (nextLocale !== "zh" && nextLocale !== "en") throw new Error(i18nText("请使用 weapp config lang <zh|en> 切换语言", "Use weapp config lang <zh|en> to switch language"));
 		await createLocaleConfig(nextLocale);
-		logger_default.info(i18nText(`语言已切换为：${nextLocale === "zh" ? "中文" : "英文"}`, `Language switched to: ${nextLocale}`));
+		logger.info(i18nText(`语言已切换为：${nextLocale === "zh" ? "中文" : "英文"}`, `Language switched to: ${nextLocale}`));
 		return;
 	}
 	if (action === "show") {
 		const config = await readCustomConfig();
 		const effectiveDevtoolsDefaults = resolveDevtoolsAutomationDefaults(config);
-		logger_default.info(i18nText(`配置文件路径：${colors.green(defaultCustomConfigFilePath)}`, `Config file: ${colors.green(defaultCustomConfigFilePath)}`));
+		logger.info(i18nText(`配置文件路径：${colors.green(defaultCustomConfigFilePath)}`, `Config file: ${colors.green(defaultCustomConfigFilePath)}`));
 		console.log(JSON.stringify({
 			...config,
 			effective: effectiveDevtoolsDefaults
@@ -932,25 +1259,25 @@ async function handleConfigCommand(argv) {
 		if (!value) throw new Error(i18nText("请提供配置值，例如：weapp config set locale en", "Please provide a value, e.g. weapp config set locale en"));
 		if (key === "cliPath") {
 			await createCustomConfig({ cliPath: value });
-			logger_default.info(i18nText("CLI 路径已更新。", "CLI path updated."));
+			logger.info(i18nText("CLI 路径已更新。", "CLI path updated."));
 			return;
 		}
 		if (key === "locale") {
 			if (value !== "zh" && value !== "en") throw new Error(i18nText("locale 仅支持 zh 或 en", "locale only supports zh or en"));
 			await createLocaleConfig(value);
-			logger_default.info(i18nText(`语言已切换为：${value === "zh" ? "中文" : "英文"}`, `Language switched to: ${value}`));
+			logger.info(i18nText(`语言已切换为：${value === "zh" ? "中文" : "英文"}`, `Language switched to: ${value}`));
 			return;
 		}
 		if (key === "autoBootstrapDevtools") {
 			const parsed = parseBooleanConfigValue(value);
 			await createAutoBootstrapDevtoolsConfig(parsed);
-			logger_default.info(i18nText(`autoBootstrapDevtools 已更新为：${parsed}`, `autoBootstrapDevtools updated to: ${parsed}`));
+			logger.info(i18nText(`autoBootstrapDevtools 已更新为：${parsed}`, `autoBootstrapDevtools updated to: ${parsed}`));
 			return;
 		}
 		if (key === "autoTrustProject") {
 			const parsed = parseBooleanConfigValue(value);
 			await createAutoTrustProjectConfig(parsed);
-			logger_default.info(i18nText(`autoTrustProject 已更新为：${parsed}`, `autoTrustProject updated to: ${parsed}`));
+			logger.info(i18nText(`autoTrustProject 已更新为：${parsed}`, `autoTrustProject updated to: ${parsed}`));
 			return;
 		}
 		throw new Error(i18nText("仅支持设置配置项：cliPath | locale | autoBootstrapDevtools | autoTrustProject", "Supported keys for set: cliPath | locale | autoBootstrapDevtools | autoTrustProject"));
@@ -959,7 +1286,7 @@ async function handleConfigCommand(argv) {
 		const key = argv[1];
 		if (key !== "cliPath" && key !== "locale" && key !== "autoBootstrapDevtools" && key !== "autoTrustProject") throw new Error(i18nText("仅支持清除配置项：cliPath | locale | autoBootstrapDevtools | autoTrustProject", "Supported keys for unset: cliPath | locale | autoBootstrapDevtools | autoTrustProject"));
 		await removeCustomConfigKey(key);
-		logger_default.info(i18nText(`已清除配置项：${key}`, `Config key cleared: ${key}`));
+		logger.info(i18nText(`已清除配置项：${key}`, `Config key cleared: ${key}`));
 		return;
 	}
 	if (action === "doctor") {
@@ -970,10 +1297,19 @@ async function handleConfigCommand(argv) {
 		const hasValidCli = Boolean(resolvedCli.cliPath);
 		const locale = rawConfig.locale ?? "zh";
 		const effectiveDevtoolsDefaults = resolveDevtoolsAutomationDefaults(rawConfig);
+		const installation = resolvedCli.cliPath ? await resolveWechatDevtoolsTarget({ cliPath: resolvedCli.cliPath }).then((target) => ({
+			status: "identified",
+			installationId: target.installationId,
+			version: target.version ?? null,
+			channel: target.channel ?? "unknown",
+			profileDir: target.profileDir
+		}), () => ({ status: "unavailable" })) : { status: "unavailable" };
 		const report = {
 			configFile: defaultCustomConfigFilePath,
 			configFileExists: hasConfigFile,
 			cliPath: rawConfig.cliPath ?? null,
+			effectiveCliPath: resolvedCli.cliPath,
+			installation,
 			cliPathValid: hasValidCli,
 			locale,
 			autoBootstrapDevtools: rawConfig.autoBootstrapDevtools ?? null,
@@ -982,10 +1318,10 @@ async function handleConfigCommand(argv) {
 			effectiveAutoTrustProject: effectiveDevtoolsDefaults.autoTrustProject,
 			source: resolvedCli.source
 		};
-		logger_default.info(i18nText("配置诊断结果：", "Configuration diagnostics:"));
+		logger.info(i18nText("配置诊断结果：", "Configuration diagnostics:"));
 		console.log(JSON.stringify(report, null, 2));
-		if (!hasConfigFile) logger_default.warn(i18nText("未找到配置文件，可执行 weapp config 进行初始化。", "Config file not found. Run `weapp config` to initialize."));
-		if (hasCustomCli && !hasValidCli) logger_default.warn(i18nText("检测到配置的 cliPath 不可用，请执行 weapp config set cliPath <path> 修复。", "Configured cliPath is not available. Run `weapp config set cliPath <path>` to fix it."));
+		if (!hasConfigFile) logger.warn(i18nText("未找到配置文件，可执行 weapp config 进行初始化。", "Config file not found. Run `weapp config` to initialize."));
+		if (hasCustomCli && !hasValidCli) logger.warn(i18nText("检测到配置的 cliPath 不可用，请执行 weapp config set cliPath <path> 修复。", "Configured cliPath is not available. Run `weapp config set cliPath <path>` to fix it."));
 		return;
 	}
 	if (action === "export") {
@@ -996,7 +1332,7 @@ async function handleConfigCommand(argv) {
 				spaces: 2,
 				encoding: "utf8"
 			});
-			logger_default.info(i18nText(`配置已导出到：${colors.green(outputPath)}`, `Config exported to: ${colors.green(outputPath)}`));
+			logger.info(i18nText(`配置已导出到：${colors.green(outputPath)}`, `Config exported to: ${colors.green(outputPath)}`));
 			return;
 		}
 		console.log(JSON.stringify(config, null, 2));
@@ -1018,12 +1354,341 @@ async function handleConfigCommand(argv) {
 			autoBootstrapDevtools,
 			autoTrustProject
 		});
-		logger_default.info(i18nText(`配置已从 ${colors.green(inputPath)} 导入`, `Config imported from ${colors.green(inputPath)}`));
+		logger.info(i18nText(`配置已从 ${colors.green(inputPath)} 导入`, `Config imported from ${colors.green(inputPath)}`));
 		return;
 	}
 	throw new Error(i18nText("支持的 config 子命令：lang | set-lang | show | get | set | unset | doctor | import | export", "Supported config subcommands: lang | set-lang | show | get | set | unset | doctor | import | export"));
 }
 //#endregion
+//#region src/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;
+}
+async function findConfirmedProject(journalPath, target, projectPath) {
+	const matching = (await withManagedJournalLock(journalPath, async (scopeRoot) => {
+		const scopeRecords = await readManagedWechatProjectRecords(scopeRoot);
+		if (scopeRecords.some((record) => [
+			"starting",
+			"unconfirmed",
+			"closing",
+			"failed"
+		].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 {
+		if (!record.host || !record.port || (record.state === "owned" ? record.openedProjectWindow !== true : record.openedProjectWindow !== false)) throw new Error("Managed DevTools project has no confirmed window receipt and listener identity.");
+		const live = await inspectManagedProjectHost(target, record.port);
+		if (!sameManagedProcess(live, record.host)) throw new Error("Managed DevTools project listener changed; refusing to reopen the project.");
+		if (matching.some((other) => other.port !== record.port || !other.host || !sameManagedProcess(other.host, record.host))) throw new Error("Managed DevTools project has conflicting listener records; refusing to restart its automator.");
+	} catch (error) {
+		await withManagedJournalLock(record.journalPath, async () => {
+			const current = await readManagedRecord(record.journalPath, record.id);
+			if (current.state === "released") return;
+			current.state = "failed";
+			current.error = error instanceof Error ? error.message : String(error);
+			await writeManagedRecord(current);
+		});
+		throw error;
+	}
+	return matching[0];
+}
+/** 开窗与构建入口先确认任务持有的项目回执，已登记项目保留原自动化端口。 */
+async function ensureManagedWechatProject(target, projectPath, options = {}) {
+	options.signal?.throwIfAborted();
+	const journalPath = resolveManagedJournal();
+	if (!journalPath) return;
+	if (!projectPath.trim()) throw new Error("Managed DevTools project mutation requires an explicit project path.");
+	return await withMachineE2ELease(async () => {
+		const resolvedProjectPath = path.resolve(projectPath);
+		const existing = await findConfirmedProject(journalPath, target, resolvedProjectPath);
+		options.signal?.throwIfAborted();
+		await assertManagedInstallation(target);
+		options.signal?.throwIfAborted();
+		if (existing) return existing;
+		const { launchAutomator } = await import("./automator-VSjgHujY.js");
+		await (await launchAutomator({
+			target,
+			cliPath: target.cliPath,
+			projectPath: resolvedProjectPath,
+			runtimeProvider: "devtools",
+			preserveProjectRoot: true,
+			persistAsDefaultSession: true,
+			signal: options.signal,
+			trustProject: options.trustProject,
+			timeout: 12e4
+		})).disconnect();
+		options.signal?.throwIfAborted();
+		const confirmed = await findConfirmedProject(journalPath, target, resolvedProjectPath);
+		if (!confirmed) throw new Error("Managed DevTools launcher returned without a confirmed task project; refusing a project mutation.");
+		return confirmed;
+	});
+}
+//#endregion
+//#region src/cli/wechatDevtoolsRuntimePort.ts
+const runtimePorts = /* @__PURE__ */ new Map();
+/**
+* @description 标记所选安装检测到的服务端口；无身份的旧调用仅保留在独立兼容槽中。
+*/
+function setRuntimeWechatDevtoolsServicePort(port, target) {
+	const key = target?.installationId ?? "";
+	if (typeof port !== "number" || !Number.isInteger(port) || port <= 0 || port > 65535) {
+		runtimePorts.delete(key);
+		return;
+	}
+	runtimePorts.set(key, port);
+}
+/**
+* @description 只读取所选安装的服务端口，不借用其他安装或无身份的旧记录。
+*/
+function getRuntimeWechatDevtoolsServicePort(target) {
+	return runtimePorts.get(target?.installationId ?? "");
+}
+//#endregion
+//#region src/cli/http.ts
+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(target, port) {
+	if (port !== void 0) {
+		if (typeof port !== "number" || !Number.isInteger(port) || port < 1 || port > 65535) throw createWechatDevtoolsHttpError("The explicit DevTools HTTP port must be an integer from 1 to 65535.", "WECHAT_DEVTOOLS_INVALID_PORT");
+		return port;
+	}
+	const runtimePort = getRuntimeWechatDevtoolsServicePort(target);
+	if (runtimePort) return runtimePort;
+	const detected = await detectWechatDevtoolsServicePort({ target });
+	if (detected.servicePortEnabled === false) throw createWechatDevtoolsHttpError("WECHAT_DEVTOOLS_SERVICE_PORT_DISABLED", "WECHAT_DEVTOOLS_SERVICE_PORT_DISABLED");
+	if (!detected.servicePort) throw createWechatDevtoolsHttpError("The selected DevTools installation has no known HTTP service port.", "WECHAT_DEVTOOLS_SERVICE_PORT_UNKNOWN");
+	return detected.servicePort;
+}
+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 requestSelectedWechatDevtoolsHttp(pathname, query, options = {}) {
+	options.signal?.throwIfAborted();
+	const target = await resolveWechatDevtoolsTarget(options);
+	options.signal?.throwIfAborted();
+	const projectParameter = pathname === "/v2/open" ? "project" : pathname === "/engine/build" ? "projectpath" : void 0;
+	if (projectParameter) {
+		await ensureManagedWechatProject(target, query[projectParameter] ?? "", { signal: options.signal });
+		options.signal?.throwIfAborted();
+	}
+	const port = await resolveWechatDevtoolsHttpPort(target, options.port).catch((error) => {
+		options.signal?.throwIfAborted();
+		throw error;
+	});
+	options.signal?.throwIfAborted();
+	await assertWechatDevtoolsPort(target, port, {
+		signal: options.signal,
+		timeout: options.timeoutMs
+	});
+	options.signal?.throwIfAborted();
+	const url = createWechatDevtoolsHttpUrl(port, pathname, query);
+	const controller = new AbortController();
+	const signal = options.signal ? AbortSignal.any([options.signal, controller.signal]) : controller.signal;
+	const timeout = setTimeout(() => {
+		controller.abort(createWechatDevtoolsHttpError("WECHAT_DEVTOOLS_HTTP_TIMEOUT", "WECHAT_DEVTOOLS_HTTP_TIMEOUT"));
+	}, options.timeoutMs ?? 1e4);
+	try {
+		const response = await fetch(url, {
+			method: "GET",
+			signal
+		});
+		const body = await response.text();
+		signal.throwIfAborted();
+		if (!response.ok) throw createWechatDevtoolsHttpError(body || `HTTP ${response.status}`, "WECHAT_DEVTOOLS_HTTP_REQUEST_FAILED");
+		return body;
+	} catch (error) {
+		signal.throwIfAborted();
+		throw error;
+	} finally {
+		clearTimeout(timeout);
+	}
+}
+/** 请求期间持有机器租约，避免 E2E 与另一入口同时更改共享宿主。 */
+async function requestWechatDevtoolsHttp(pathname, query, options = {}) {
+	options.signal?.throwIfAborted();
+	return await withMachineE2ELease(() => requestSelectedWechatDevtoolsHttp(pathname, query, options));
+}
+/**
+* @description 请求微信开发者工具打开项目并返回原始响应；目标 runtime 状态仍需通过会话或界面确认。
+*/
+async function openWechatIdeProjectByHttp(projectPath, options = {}) {
+	const body = await requestWechatDevtoolsHttp("/v2/open", { project: path.resolve(projectPath) }, options);
+	const response = body.trim();
+	if (!response || /^\{\s*\}$/.test(response)) throw createWechatDevtoolsHttpError("DevTools HTTP returned no project-open result; the target project opening is unconfirmed.", "WECHAT_DEVTOOLS_HTTP_OPEN_UNCONFIRMED");
+	return body;
+}
+/**
+* @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);
@@ -1089,13 +1754,16 @@ function compactOutput(value) {
 }
 async function runWechatIdeEngineBuildByCli(projectPath, options = {}) {
 	options.signal?.throwIfAborted();
-	const { cliPath } = await resolveCliPath().catch((error) => {
+	const target = await resolveWechatDevtoolsTarget(options).catch((error) => {
 		options.signal?.throwIfAborted();
 		throw error;
 	});
 	options.signal?.throwIfAborted();
-	if (!cliPath) throw createEngineBuildError("WECHAT_DEVTOOLS_CLI_NOT_FOUND", "WECHAT_DEVTOOLS_CLI_NOT_FOUND");
-	const result = await execa(cliPath, [
+	await ensureManagedWechatProject(target, projectPath, { signal: options.signal });
+	options.signal?.throwIfAborted();
+	await assertWechatDevtoolsHost(target, { signal: options.signal });
+	options.signal?.throwIfAborted();
+	const result = await execa(target.cliPath, [
 		"engine",
 		"build",
 		path.resolve(projectPath)
@@ -1115,20 +1783,20 @@ async function runWechatIdeEngineBuildByCli(projectPath, options = {}) {
 	await writeEngineBuildLog(options.logPath, output);
 	options.signal?.throwIfAborted();
 	if ((result.exitCode ?? 1) === 0) {
-		if (stdout) process.stdout.write(stdout);
-		if (stderr) process.stderr.write(stderr);
+		if (stdout && !options.quiet) process.stdout.write(stdout);
+		if (stderr && !options.quiet) process.stderr.write(stderr);
 		return;
 	}
 	if (ENGINE_BUILD_CLI_OPENED_PATTERN.test(output)) return;
 	if (isEngineBuildEndpointMissingError(output)) throw createEngineBuildEndpointMissingError();
-	if (stdout) process.stdout.write(stdout);
-	if (stderr) process.stderr.write(stderr);
+	if (stdout && !options.quiet) process.stdout.write(stdout);
+	if (stderr && !options.quiet) process.stderr.write(stderr);
 	throw createEngineBuildError(compactOutput(stderr) || compactOutput(stdout) || `WECHAT_DEVTOOLS_ENGINE_BUILD_CLI_FAILED:${result.exitCode ?? 1}`, "WECHAT_DEVTOOLS_ENGINE_BUILD_CLI_FAILED");
 }
 /**
 * @description 通过开发者工具 HTTP 服务端口执行 engine build，并轮询直到构建结束。
 */
-async function runWechatIdeEngineBuildByHttp(projectPath, options = {}) {
+async function runSelectedWechatIdeEngineBuildByHttp(projectPath, options = {}) {
 	options.signal?.throwIfAborted();
 	await startWechatIdeEngineBuildByHttp(projectPath, options);
 	const startedAt = Date.now();
@@ -1147,11 +1815,11 @@ async function runWechatIdeEngineBuildByHttp(projectPath, options = {}) {
 /**
 * @description 以更接近官方 CLI 的方式执行 engine build，并支持将构建日志写入文件。
 */
-async function runWechatIdeEngineBuild(projectPath, options = {}) {
+async function runSelectedWechatIdeEngineBuild(projectPath, options = {}) {
 	const logs = [];
 	let lastLoggedMessage;
 	try {
-		const result = await runWechatIdeEngineBuildByHttp(projectPath, {
+		const result = await runSelectedWechatIdeEngineBuildByHttp(projectPath, {
 			...options,
 			onProgress: (progress) => {
 				if (progress.msg && progress.msg !== lastLoggedMessage) {
@@ -1175,6 +1843,91 @@ async function runWechatIdeEngineBuild(projectPath, options = {}) {
 		throw error;
 	}
 }
+/** 固定安装上下文后完整持有 HTTP 构建与轮询期间的租约。 */
+async function runWechatIdeEngineBuildByHttp(projectPath, options = {}) {
+	options.signal?.throwIfAborted();
+	return await withMachineE2ELease(async () => {
+		const target = await resolveWechatDevtoolsTarget(options);
+		options.signal?.throwIfAborted();
+		return await runSelectedWechatIdeEngineBuildByHttp(projectPath, {
+			...options,
+			target
+		});
+	});
+}
+/** HTTP、轮询与 CLI 回退沿用同一次解析的安装。 */
+async function runWechatIdeEngineBuild(projectPath, options = {}) {
+	options.signal?.throwIfAborted();
+	return await withMachineE2ELease(async () => {
+		const target = await resolveWechatDevtoolsTarget(options);
+		options.signal?.throwIfAborted();
+		return await runSelectedWechatIdeEngineBuild(projectPath, {
+			...options,
+			target
+		});
+	});
+}
+async function prepareSelectedAcceptanceProject(projectPath, signal, options) {
+	await openWechatIdeProjectByHttp(projectPath, {
+		...options,
+		signal,
+		timeoutMs: 1e4
+	});
+	await sleep$1(1e3, signal);
+	await resetWechatIdeFileUtilsByHttp(projectPath, {
+		...options,
+		signal,
+		timeoutMs: 1e4
+	});
+	const result = await runWechatIdeEngineBuild(projectPath, {
+		...options,
+		signal,
+		overallTimeoutMs: 6e4,
+		timeoutMs: 1e4,
+		quiet: true
+	});
+	if (!result) await sleep$1(1500, signal);
+	return result;
+}
+/** 在验收交互前等待 IDE 消费产物，并沿用该会话选择的安装。 */
+async function prepareAcceptanceProject(projectPath, signal, options = {}) {
+	signal.throwIfAborted();
+	if (options.runtimeProvider === "headless") return;
+	return await withMachineE2ELease(async () => {
+		const target = await resolveWechatDevtoolsTarget(options);
+		signal.throwIfAborted();
+		await ensureManagedWechatProject(target, projectPath, { signal });
+		signal.throwIfAborted();
+		return await prepareSelectedAcceptanceProject(projectPath, signal, {
+			...options,
+			target
+		});
+	});
+}
+//#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 = [
@@ -1225,15 +1978,15 @@ function printForwardConsoleEvent(event) {
 	const line = `${formatForwardConsolePrefix(event.level)} ${formatForwardConsoleMessage(event)}`;
 	switch (event.level) {
 		case "error":
-			logger_default.error(line);
+			logger.error(line);
 			return;
 		case "warn":
-			logger_default.warn(line);
+			logger.warn(line);
 			return;
 		case "info":
-			logger_default.info(line);
+			logger.info(line);
 			return;
-		default: logger_default.log(line);
+		default: logger.log(line);
 	}
 }
 function formatConsoleArgument(value) {
@@ -1319,29 +2072,28 @@ async function acquireForwardConsoleMiniProgram(options) {
 			return miniProgram;
 		} catch (error) {
 			lastError = error;
-			if (miniProgram) releaseSharedMiniProgram(options.projectPath, options.sessionId || options.port);
-			await closeSharedMiniProgram(options.projectPath, options.sessionId || options.port);
+			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);
@@ -1351,6 +2103,7 @@ function startEnableLogRefresh(miniProgram, options, refreshOpenedSession) {
 * @description 启动小程序控制台日志转发，并保持 automator 会话常驻。
 */
 async function startForwardConsole(options) {
+	options = options.miniProgram ? options : await resolveAutomatorSessionOptions(options);
 	const usesSharedSession = !options.miniProgram;
 	const miniProgram = await acquireForwardConsoleMiniProgram(options);
 	const logLevels = new Set(options.logLevels?.length ? options.logLevels : DEFAULT_FORWARD_CONSOLE_LEVELS);
@@ -1376,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);
@@ -1387,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);
+		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);
@@ -1405,7 +2180,7 @@ async function startForwardConsole(options) {
 				openedOnly: true
 			});
 			if (closed) {
-				openedMiniProgram.disconnect();
+				await openedMiniProgram.disconnect();
 				return;
 			}
 			auxiliaryMiniProgram = openedMiniProgram;
@@ -1418,6 +2193,117 @@ async function startForwardConsole(options) {
 	return { close: closeSession };
 }
 //#endregion
+//#region src/utils/argv.ts
+function ensurePathArgument(argv, optionIndex) {
+	const paramIdx = optionIndex + 1;
+	const param = argv[paramIdx];
+	if (param && !param.startsWith("-")) argv[paramIdx] = resolvePath(param);
+	else argv.splice(paramIdx, 0, process.cwd());
+	return argv;
+}
+/**
+* @description 依次应用 argv 处理函数（不修改原始 argv）
+*/
+function transformArgv(argv, transforms) {
+	return transforms.reduce((current, transform) => transform(current), [...argv]);
+}
+/**
+* @description 创建参数别名转换器
+*/
+function createAlias(entry) {
+	return (input) => {
+		const argv = [...input];
+		let optionIndex = argv.indexOf(entry.find);
+		if (optionIndex > -1) argv.splice(optionIndex, 1, entry.replacement);
+		else optionIndex = argv.indexOf(entry.replacement);
+		if (optionIndex === -1) return argv;
+		return ensurePathArgument(argv, optionIndex);
+	};
+}
+/**
+* @description 创建路径参数兼容转换器（补全或规范化路径）
+*/
+function createPathCompat(option) {
+	return (input) => {
+		const argv = [...input];
+		const optionIndex = argv.indexOf(option);
+		if (optionIndex === -1) return argv;
+		return ensurePathArgument(argv, optionIndex);
+	};
+}
+//#endregion
+//#region src/utils/exec.ts
+/**
+* @description 执行 CLI 命令并透传输出
+*/
+async function execute(cliPath, argv, options = {}) {
+	const { pipeStdout = true, pipeStderr = true, timeout } = options;
+	const { execa } = await import("execa");
+	const task = execa(cliPath, argv, {
+		timeout,
+		cancelSignal: options.signal,
+		forceKillAfterDelay: 100
+	});
+	if (pipeStdout) task?.stdout?.pipe(process.stdout);
+	if (pipeStderr) task?.stderr?.pipe(process.stderr);
+	return await task;
+}
+//#endregion
+//#region src/cli/loginQuery.ts
+/** 读取原生 CLI 的明确登录结果；日志、空输出与相互矛盾的响应均不能证明登录状态。 */
+function parseLoginOutput(stdout) {
+	const login = readWechatLoginState(stdout);
+	if (login !== void 0) return {
+		status: "success",
+		login
+	};
+	return {
+		status: "unknown",
+		reason: "invalid-response"
+	};
+}
+/** 显式调用指定 CLI 查询登录语义，不重试、不提示登录；原生 CLI 可能启动 IDE。 */
+async function queryWechatIdeLogin(cliPath, options = {}) {
+	const timeout = options.timeout ?? 3e3;
+	if (!Number.isFinite(timeout) || timeout <= 0) throw new TypeError("登录查询 timeout 必须是有限正数。");
+	const operation = new OperationLifecycle(timeout, "IDE login query", options.signal);
+	try {
+		return await operation.run((scope) => withMachineE2ELease(async () => {
+			const target = await scope.step(() => resolveWechatDevtoolsTarget({ cliPath }), { stage: "installation" });
+			await scope.step(() => assertWechatDevtoolsHost(target, {
+				signal: scope.signal,
+				timeout: scope.remainingMs()
+			}), {
+				stage: "host-identity",
+				waitForExit: true
+			});
+			return parseLoginOutput((await scope.step(() => execute(target.cliPath, ["islogin"], {
+				pipeStdout: false,
+				pipeStderr: false,
+				timeout: scope.remainingMs(),
+				signal: scope.signal
+			}), {
+				stage: "login-query",
+				waitForExit: true
+			})).stdout);
+		}));
+	} catch (error) {
+		options.signal?.throwIfAborted();
+		if (error instanceof Error && error.message.startsWith("Runtime busy:")) return {
+			status: "unknown",
+			reason: "runtime-busy"
+		};
+		if (error && typeof error === "object" && "code" in error && error.code === "WECHAT_DEVTOOLS_HOST_IDENTITY_MISMATCH") return {
+			status: "unknown",
+			reason: "installation-mismatch"
+		};
+		return {
+			status: "unknown",
+			reason: operation.timedOut || error && typeof error === "object" && "timedOut" in error && error.timedOut === true ? "timeout" : "command-failed"
+		};
+	}
+}
+//#endregion
 //#region src/cli/minidev.ts
 const MINIDEV_COMMAND = "minidev";
 function isCommandNotFound(error) {
@@ -1431,17 +2317,265 @@ async function runMinidev(argv) {
 		await execute(MINIDEV_COMMAND, [...argv]);
 	} catch (error) {
 		if (isCommandNotFound(error)) {
-			logger_default.error("未检测到支付宝小程序 CLI：minidev");
-			logger_default.warn("请先安装 minidev，可使用以下任一命令：");
-			logger_default.info(`- ${colors.green("pnpm add -g minidev")}`);
-			logger_default.info(`- ${colors.green("npm install -g minidev")}`);
-			logger_default.info(`- ${colors.green("yarn global add minidev")}`);
+			logger.error("未检测到支付宝小程序 CLI：minidev");
+			logger.warn("请先安装 minidev，可使用以下任一命令：");
+			logger.info(`- ${colors.green("pnpm add -g minidev")}`);
+			logger.info(`- ${colors.green("npm install -g minidev")}`);
+			logger.info(`- ${colors.green("yarn global add minidev")}`);
 			return;
 		}
 		throw error;
 	}
 }
 //#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)`));
+	if (value === "never" || value === "once" || value === "always") return value;
+	return nonInteractive ? "never" : "always";
+}
+function normalizeLoginRetryTimeout(value) {
+	if (!value) return 3e4;
+	const parsed = Number.parseInt(value, 10);
+	if (!Number.isFinite(parsed) || parsed <= 0) throw new Error(i18nText(`无效的 --login-retry-timeout 值: ${value}（必须为正整数）`, `Invalid --login-retry-timeout value: ${value} (must be a positive integer)`));
+	return parsed;
+}
+function isStdinInteractive() {
+	return Boolean(process.stdin && process.stdin.isTTY);
+}
+function stripLoginRetryControlFlags(argv) {
+	let next = removeOption(argv, "--login-retry");
+	next = removeOption(next, "--login-retry-timeout");
+	next = removeOption(next, "--non-interactive");
+	return next;
+}
+/**
+* @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.ts
+const IDE_SERVER_STARTED_RE = /IDE server has started,\s*listening on\s+https?:\/\/127\.0\.0\.1:(\d+)/i;
+function unwrapWechatCliExecutionError(result) {
+	return result.kind === "retryable" ? result.error : result.value;
+}
+async function promptLoginRetry(errorLike, options, retryCount, operation) {
+	const { nonInteractive, retryMode, retryTimeoutMs } = options;
+	if (nonInteractive) {
+		logger.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,
+			promptOpenIdeLogin: true,
+			retryTimeoutMs: operation.remainingMs(retryTimeoutMs),
+			signal: operation.signal
+		});
+		logger.info(i18nText("当前重试策略不允许继续重试。", "Current retry policy does not allow further retries."));
+		return "cancel";
+	}
+	return await promptWechatIdeLoginRetry({
+		error: errorLike,
+		logger,
+		promptOpenIdeLogin: true,
+		retryTimeoutMs: operation.remainingMs(retryTimeoutMs),
+		signal: operation.signal
+	});
+}
+function flushExecutionOutput(result) {
+	if (!result || typeof result !== "object") return;
+	const candidate = result;
+	if (typeof candidate.stdout === "string" && candidate.stdout) process.stdout.write(candidate.stdout);
+	if (typeof candidate.stderr === "string" && candidate.stderr) process.stderr.write(candidate.stderr);
+}
+function captureWechatDevtoolsServicePort(result, target) {
+	if (!result || typeof result !== "object") return;
+	const candidate = result;
+	const match = [typeof candidate.stdout === "string" ? candidate.stdout : "", typeof candidate.stderr === "string" ? candidate.stderr : ""].join("\n").match(IDE_SERVER_STARTED_RE);
+	if (!match?.[1]) return;
+	setRuntimeWechatDevtoolsServicePort(Number.parseInt(match[1], 10), target);
+}
+/**
+* @description 运行微信开发者工具 CLI，并在登录失效时允许按键重试。
+*/
+async function executeWechatCliWithRetry(cliPath, argv, options) {
+	options.signal?.throwIfAborted();
+	const target = await resolveWechatDevtoolsTarget({
+		target: options.target,
+		cliPath
+	});
+	const loginRetryOptions = resolveLoginRetryConfig(argv);
+	const result = await runWithSuspendedSharedInput(async () => {
+		return await runRetryableCommand({
+			timeout: options.timeout,
+			signal: options.signal,
+			createCancelError: (result) => createWechatIdeLoginRequiredExitError(unwrapWechatCliExecutionError(result)),
+			execute: async (operation) => {
+				await assertWechatDevtoolsHost(target, {
+					signal: operation.signal,
+					timeout: operation.remainingMs()
+				});
+				operation.signal.throwIfAborted();
+				try {
+					return {
+						kind: "result",
+						value: await execute(target.cliPath, loginRetryOptions.runtimeArgv, {
+							pipeStdout: false,
+							pipeStderr: false,
+							timeout: operation.remainingMs(),
+							signal: operation.signal
+						})
+					};
+				} catch (error) {
+					if (!isWechatIdeLoginRequiredError(error)) throw error;
+					return {
+						error,
+						kind: "retryable"
+					};
+				}
+			},
+			isRetryableResult: (result) => result.kind === "retryable" || isWechatIdeLoginRequiredError(result.value),
+			onRetry: () => {
+				logger.info(i18nText("正在重试连接微信开发者工具...", "Retrying to connect Wechat DevTools..."));
+			},
+			promptRetry: async (result, retryCount, operation) => {
+				return await promptLoginRetry(unwrapWechatCliExecutionError(result), loginRetryOptions, retryCount, operation);
+			},
+			shouldRetry: (action) => action === "retry"
+		});
+	});
+	if (result.kind === "retryable") throw createWechatIdeLoginRequiredExitError(result.error);
+	if (isWechatIdeLoginRequiredError(result.value)) throw createWechatIdeLoginRequiredExitError(result.value);
+	captureWechatDevtoolsServicePort(result.value, target);
+	if (!options.silent) flushExecutionOutput(result.value);
+}
+/** 原生 CLI 可能启动或改变共享宿主，完整命令与有限重试共用机器租约。 */
+async function runWechatCliWithRetry(cliPath, argv, options = {}) {
+	return await withMachineE2ELease(() => executeWechatCliWithRetry(cliPath, argv, options));
+}
+//#endregion
+//#region src/cli/run-wechat-cli.ts
+function shouldBootstrapWechatDevtools(command) {
+	return command === "open" || command === "auto" || command === "auto-preview";
+}
+function appendOptionValue(argv, sourceArgv, optionName) {
+	const value = readOptionValue(sourceArgv, optionName);
+	if (value !== void 0) argv.push(optionName, value);
+}
+function createAutoPreviewWakeArgv(argv, trustProject) {
+	if (argv[0] !== "auto-preview") return;
+	const projectPath = readOptionValue(argv, "--project");
+	const appid = readOptionValue(argv, "--appid");
+	if (!projectPath && !appid) return;
+	const wakeArgv = ["open"];
+	appendOptionValue(wakeArgv, argv, "--project");
+	appendOptionValue(wakeArgv, argv, "--appid");
+	appendOptionValue(wakeArgv, argv, "--ext-appid");
+	if (trustProject === true) wakeArgv.push("--trust-project");
+	return wakeArgv;
+}
+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) {
+	if (source === "environment") throw new Error("WEAPP_IDE_CLI_PATH 指定的开发者工具不可用；已停止，不回退其他安装。");
+	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.warn(message);
+	await promptForCliPath();
+}
+async function maybeBootstrapWechatDevtoolsSettings(argv, target) {
+	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");
+	const trustProject = trustProjectOption === void 0 ? config.autoTrustProject ?? false : trustProjectOption;
+	await bootstrapWechatDevtoolsSettings({
+		target,
+		projectPath,
+		trustProject
+	});
+	return { trustProject };
+}
+/** 在动作开始前选择安装，沿用原有平台检查和缺失路径配置提示。 */
+async function resolveWechatCliCommandTarget(options = {}) {
+	if (!isOperatingSystemSupported(operatingSystemName)) {
+		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();
+		if (!cliPath) {
+			await handleMissingCliPath(source);
+			return;
+		}
+		target = await resolveWechatDevtoolsTarget({ cliPath });
+	}
+	return target;
+}
+/**
+* @description 执行微信开发者工具 CLI 阶段，包括环境检查、路径解析、bootstrap 与登录重试。
+*/
+async function executeWechatCliCommand(argv, options) {
+	const target = await resolveWechatCliCommandTarget(options);
+	if (!target) return;
+	await assertWechatDevtoolsHost(target, {
+		signal: options.signal,
+		timeout: options.timeout
+	});
+	const executionOptions = {
+		...options,
+		target
+	};
+	const wakeArgv = createAutoPreviewWakeArgv(argv, (await maybeBootstrapWechatDevtoolsSettings(argv, target))?.trustProject);
+	if (wakeArgv) await runWechatCliWithRetry(target.cliPath, wakeArgv, executionOptions);
+	await runWechatCliWithRetry(target.cliPath, argv, executionOptions);
+}
+/** 配置预热与原生命令属于同一个宿主操作，排他租约在任何写入之前取得。 */
+async function runWechatCliCommand(argv, options = {}) {
+	return await withMachineE2ELease(() => executeWechatCliCommand(argv, options));
+}
+//#endregion
 //#region src/cli/wechat-command-schema.ts
 const CACHE_CLEAN_TYPES = [
 	"storage",
@@ -1526,6 +2660,321 @@ 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));
+	if (options.appid) argv.push("--appid", options.appid);
+	if (options.extAppid) argv.push("--ext-appid", options.extAppid);
+}
+/**
+* @description 调用微信开发者工具 open 命令。
+*/
+async function openSelectedWechatIde(options, target) {
+	const argv = ["open"];
+	appendProjectLocatorArgv(argv, options);
+	if (options.platform) argv.push("--platform", options.platform);
+	if (options.trustProject) argv.push("--trust-project");
+	if (options.projectPath) try {
+		await openWechatIdeProjectByHttp(options.projectPath, { target });
+		return;
+	} catch (error) {
+		if (error instanceof Error && (error.message.startsWith("Runtime busy:") || "code" in error && (error.code === "WECHAT_DEVTOOLS_HOST_IDENTITY_MISMATCH" || error.code === "WECHAT_DEVTOOLS_INSTALLATION_SELECTION_CONFLICT"))) throw error;
+	}
+	await runWechatCliCommand(argv, { target });
+}
+/** 打开与兼容回退在同一机器租约内沿用固定安装，禁止重新选择宿主。 */
+async function openWechatIde(options = {}) {
+	return await withMachineE2ELease(async () => {
+		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.");
+				await ensureManagedWechatProject(target, options.projectPath, { trustProject: options.trustProject });
+				return;
+			}
+			return await openSelectedWechatIde(options, target);
+		}
+	});
+}
+/**
+* @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 runSelectedCommand(argv, options);
+}
+/**
+* @description 调用微信开发者工具 islogin 命令。
+*/
+async function isWechatIdeLoggedIn(options = {}) {
+	const argv = ["islogin"];
+	if (options.nonInteractive) argv.push("--non-interactive");
+	if (options.silent) await runWechatCliCommand(argv, {
+		...selectionOptions(options),
+		silent: true
+	});
+	else await runSelectedCommand(argv, options);
+}
+/**
+* @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 runSelectedCommand(argv, options);
+}
+/**
+* @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 runSelectedCommand(argv, options);
+}
+/**
+* @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 runSelectedCommand(argv, options);
+}
+/**
+* @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 runSelectedCommand(argv, options);
+}
+/**
+* @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 runSelectedCommand(argv, options);
+}
+/**
+* @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 runSelectedCommand(argv, options);
+}
+/**
+* @description 调用微信开发者工具 close 命令。
+*/
+async function closeWechatIdeProject(options = {}) {
+	if (options.projectPath !== void 0 && !options.projectPath.trim()) throw new Error("The explicit close projectPath must not be empty.");
+	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 || options.devtoolsChannel || options.devtoolsVersion ? await resolveWechatDevtoolsTarget(selectionOptions(options)) : void 0;
+	await runWechatCliCommand(argv, {
+		...target ? { target } : selectionOptions(options),
+		timeout: DEVTOOLS_SHUTDOWN_TIMEOUT_MS
+	});
+}
+/**
+* @description 调用微信开发者工具 quit 命令。
+*/
+async function quitWechatIde(options = {}) {
+	await runWechatCliCommand(["quit"], {
+		...selectionOptions(options),
+		timeout: DEVTOOLS_SHUTDOWN_TIMEOUT_MS
+	});
+}
+/**
+* @description 调用微信开发者工具 cache 命令。
+*/
+async function clearWechatIdeCache(options) {
+	await runSelectedCommand([
+		"cache",
+		"--clean",
+		options.clean
+	], options);
+}
+/**
+* @description 调用微信开发者工具 open-other 命令。
+*/
+async function openWechatIdeOtherProject(options = {}) {
+	await runSelectedCommand(["open-other"], options);
+}
+/**
+* @description 通过微信开发者工具 HTTP 服务端口重置指定项目的 fileutils 状态。
+*/
+async function resetWechatIdeFileUtils(options) {
+	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,
+		projectPath: path.resolve(options.projectPath),
+		...options.sessionId ? { sessionId: options.sessionId } : {},
+		sharedSession: options.sharedSession ?? true,
+		timeout: options.timeout
+	};
+}
+/**
+* @description 通过已打开或新建的 automator 会话获取开发者工具基础信息。
+*/
+async function getWechatIdeToolInfo(options) {
+	return await withMiniProgram$1(createAutomatorSessionOptions(options), async (miniProgram) => {
+		return await miniProgram.toolInfo();
+	});
+}
+/**
+* @description 通过已打开或新建的 automator 会话执行项目编译。
+*/
+async function compileWechatIdeByAutomator(options) {
+	return await withMiniProgram$1(createAutomatorSessionOptions(options), async (miniProgram) => {
+		return await miniProgram.compile({ force: options.force });
+	});
+}
+/**
+* @description 通过已打开或新建的 automator 会话清理开发者工具缓存。
+*/
+async function clearWechatIdeCacheByAutomator(options) {
+	return await withMiniProgram$1(createAutomatorSessionOptions(options), async (miniProgram) => {
+		return await miniProgram.clearCache({ clean: options.clean });
+	});
+}
+/**
+* @description 通过已打开或新建的 automator 会话获取当前 ticket。
+*/
+async function getWechatIdeTicket(options) {
+	return await withMiniProgram$1(createAutomatorSessionOptions(options), async (miniProgram) => {
+		return await miniProgram.getTicket();
+	});
+}
+/**
+* @description 通过已打开或新建的 automator 会话设置 ticket。
+*/
+async function setWechatIdeTicket(options) {
+	return await withMiniProgram$1(createAutomatorSessionOptions(options), async (miniProgram) => {
+		await miniProgram.setTicket(options.ticket);
+	});
+}
+/**
+* @description 通过已打开或新建的 automator 会话刷新 ticket。
+*/
+async function refreshWechatIdeTicket(options) {
+	return await withMiniProgram$1(createAutomatorSessionOptions(options), async (miniProgram) => {
+		await miniProgram.refreshTicket();
+	});
+}
+/**
+* @description 通过已打开或新建的 automator 会话获取测试账号列表。
+*/
+async function getWechatIdeTestAccounts(options) {
+	return await withMiniProgram$1(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 runSelectedCommand(argv, options);
+}
+/**
+* @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 runSelectedCommand(argv, options);
+}
+//#endregion
 //#region src/cli/wechat-dispatch.ts
 function hasOption(argv, optionName) {
 	return argv.includes(optionName) || argv.some((token) => token.startsWith(`${optionName}=`));
@@ -1676,7 +3125,15 @@ async function dispatchWechatCliCommand(argv) {
 		return true;
 	}
 	if (command === "close") {
-		await closeWechatIdeProject();
+		const projectPath = readOptionValue(argv, "--project", "-p");
+		const cliPath = readOptionValue(argv, "--cli-path");
+		if ((hasOption(argv, "--project") || hasOption(argv, "-p")) && (!projectPath || projectPath.startsWith("-"))) throw new Error("The close --project/-p option requires a value.");
+		if (hasOption(argv, "--cli-path") && (!cliPath || cliPath.startsWith("-"))) throw new Error("The close --cli-path option requires a value.");
+		if (projectPath !== void 0 || cliPath !== void 0) await closeWechatIdeProject({
+			...projectPath !== void 0 ? { projectPath } : {},
+			...cliPath !== void 0 ? { cliPath } : {}
+		});
+		else await closeWechatIdeProject();
 		return true;
 	}
 	if (command === "quit") {
@@ -1731,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();
@@ -1779,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();
@@ -1801,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-C2SQ_hRJ.js");
+		const { runMcpCommand } = await import("./run-mcp-83-VKZVA.js");
 		await runMcpCommand(argv.slice(1));
 		return;
 	}
@@ -1823,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 { parseCompareArgs as C, printScreenshotHelp as S, AUTOMATOR_COMMAND_NAMES as _, runMinidev as a, runAutomatorCommand as b, runWechatIdeEngineBuild as c, CONFIG_COMMAND_NAME as d, MCP_COMMAND_NAME as f, isWeappIdeTopLevelCommand as g, WECHAT_CLI_COMMAND_NAMES as h, validateWechatCliCommandArgs as i, runWechatIdeEngineBuildByHttp as l, WEAPP_IDE_TOP_LEVEL_COMMAND_NAMES as m, parse as n, startForwardConsole as o, MINIDEV_NAMESPACE_COMMAND_NAMES as p, dispatchWechatCliCommand as r, isWechatIdeEngineBuildEndpointMissingError as s, createCli as t, handleConfigCommand as u, getAutomatorCommandHelp as v, printCompareHelp as w, parseScreenshotArgs as x, isAutomatorCommand as y };
+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 };