weapp-ide-cli 6.1.9 → 6.2.0

package/dist/{cli-2sY1sAVq.js → cli-ChMQqi5w.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 { 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 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-CZVPfkE9.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 子命令。
@@ -878,6 +1066,59 @@ function isWeappIdeTopLevelCommand(command) {
 	return Boolean(command && WEAPP_IDE_TOP_LEVEL_COMMAND_SET.has(command));
 }
 //#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 +1139,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 +1173,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 +1200,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 +1211,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 +1232,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 +1246,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 +1268,221 @@ 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/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))) 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-BkZZsGtn.js");
+		(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 +1548,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 +1577,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 +1609,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 +1637,67 @@ 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.ts
 const DEFAULT_FORWARD_CONSOLE_LEVELS = [
@@ -1225,15 +1748,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,8 +1842,8 @@ 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);
+			if (miniProgram) releaseSharedMiniProgram(options.projectPath, options.sessionId || options.port, options);
+			await closeSharedMiniProgram(options.projectPath, options.sessionId || options.port, options);
 			if (attempt < ENABLE_LOG_RETRY_TIMES) await sleep(ENABLE_LOG_RETRY_DELAY_MS);
 		}
 	}
@@ -1351,6 +1874,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);
@@ -1393,7 +1917,7 @@ async function startForwardConsole(options) {
 			auxiliaryMiniProgram.disconnect();
 			auxiliaryMiniProgram = void 0;
 		}
-		if (usesSharedSession) releaseSharedMiniProgram(options.projectPath, options.sessionId || options.port);
+		if (usesSharedSession) releaseSharedMiniProgram(options.projectPath, options.sessionId || options.port, options);
 	};
 	miniProgram.on("console", onConsole);
 	miniProgram.on("exception", onException);
@@ -1418,6 +1942,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 +2066,248 @@ 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/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;
+	}
+	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 +2392,299 @@ function validateWechatCliCommandArgs(argv) {
 	}
 }
 //#endregion
+//#region src/cli/wechat-commands.ts
+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();
+		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 runWechatCliCommand(argv);
+}
+/**
+* @description 调用微信开发者工具 islogin 命令。
+*/
+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);
+}
+/**
+* @description 调用微信开发者工具 build-npm 命令。
+*/
+async function buildWechatIdeNpm(options = {}) {
+	const argv = [
+		"build-npm",
+		"--project",
+		path.resolve(options.projectPath ?? process.cwd())
+	];
+	if (options.compileType) argv.push("--compile-type", options.compileType);
+	await runWechatCliCommand(argv);
+}
+/**
+* @description 调用微信开发者工具 preview 命令。
+*/
+async function previewWechatIde(options = {}) {
+	const argv = ["preview"];
+	appendProjectLocatorArgv(argv, options);
+	if (options.qrFormat) argv.push("--qr-format", options.qrFormat);
+	if (options.qrOutput) argv.push("--qr-output", path.resolve(options.qrOutput));
+	if (options.qrSize) argv.push("--qr-size", options.qrSize);
+	if (options.infoOutput) argv.push("--info-output", path.resolve(options.infoOutput));
+	if (options.compileCondition) argv.push("--compile-condition", options.compileCondition);
+	await runWechatCliCommand(argv);
+}
+/**
+* @description 调用微信开发者工具 auto-preview 命令。
+*/
+async function autoPreviewWechatIde(options = {}) {
+	const argv = ["auto-preview"];
+	appendProjectLocatorArgv(argv, options);
+	if (options.infoOutput) argv.push("--info-output", path.resolve(options.infoOutput));
+	if (options.compileCondition) argv.push("--compile-condition", options.compileCondition);
+	await runWechatCliCommand(argv);
+}
+/**
+* @description 调用微信开发者工具 auto 命令。
+*/
+async function autoWechatIde(options = {}) {
+	const argv = ["auto"];
+	appendProjectLocatorArgv(argv, options);
+	if (options.port) argv.push("--auto-port", options.port);
+	if (options.account) argv.push("--auto-account", options.account);
+	if (options.testTicket) argv.push("--test-ticket", options.testTicket);
+	if (options.ticket) argv.push("--ticket", options.ticket);
+	if (options.trustProject) argv.push("--trust-project");
+	await runWechatCliCommand(argv);
+}
+/**
+* @description 调用微信开发者工具 auto-replay 命令。
+*/
+async function autoReplayWechatIde(options = {}) {
+	const argv = ["auto-replay"];
+	appendProjectLocatorArgv(argv, options);
+	if (options.port) argv.push("--auto-port", options.port);
+	if (options.account) argv.push("--auto-account", options.account);
+	if (options.replayAll) argv.push("--replay-all");
+	if (options.replayConfigPath) argv.push("--replay-config-path", path.resolve(options.replayConfigPath));
+	if (options.testTicket) argv.push("--test-ticket", options.testTicket);
+	if (options.ticket) argv.push("--ticket", options.ticket);
+	if (options.trustProject) argv.push("--trust-project");
+	await runWechatCliCommand(argv);
+}
+/**
+* @description 调用微信开发者工具 upload 命令。
+*/
+async function uploadWechatIde(options) {
+	const argv = ["upload"];
+	appendProjectLocatorArgv(argv, options);
+	argv.push("--version", options.version, "--desc", options.desc);
+	if (options.infoOutput) argv.push("--info-output", path.resolve(options.infoOutput));
+	await runWechatCliCommand(argv);
+}
+/**
+* @description 调用微信开发者工具 close 命令。
+*/
+async function closeWechatIdeProject(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 ? await resolveWechatDevtoolsTarget({
+		target: options.target,
+		cliPath: options.cliPath
+	}) : void 0;
+	await runWechatCliCommand(argv, {
+		...target ? { target } : {},
+		timeout: DEVTOOLS_SHUTDOWN_TIMEOUT_MS
+	});
+}
+/**
+* @description 调用微信开发者工具 quit 命令。
+*/
+async function quitWechatIde() {
+	await runWechatCliCommand(["quit"], { timeout: DEVTOOLS_SHUTDOWN_TIMEOUT_MS });
+}
+/**
+* @description 调用微信开发者工具 cache 命令。
+*/
+async function clearWechatIdeCache(options) {
+	await runWechatCliCommand([
+		"cache",
+		"--clean",
+		options.clean
+	]);
+}
+/**
+* @description 调用微信开发者工具 open-other 命令。
+*/
+async function openWechatIdeOtherProject(_options = {}) {
+	await runWechatCliCommand(["open-other"]);
+}
+/**
+* @description 通过微信开发者工具 HTTP 服务端口重置指定项目的 fileutils 状态。
+*/
+async function resetWechatIdeFileUtils(options) {
+	await resetWechatIdeFileUtilsByHttp(path.resolve(options.projectPath));
+}
+function createAutomatorSessionOptions(options) {
+	return {
+		...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 runWechatCliCommand(argv);
+}
+/**
+* @description 调用微信开发者工具 build-ipa 命令。
+*/
+async function buildWechatIdeIpa(options) {
+	const argv = [
+		"build-ipa",
+		"--output",
+		path.resolve(options.output),
+		"--isDistribute",
+		String(options.isDistribute)
+	];
+	if (options.isRemoteBuild !== void 0) argv.push("--isRemoteBuild", String(options.isRemoteBuild));
+	if (options.profilePath) argv.push("--profilePath", path.resolve(options.profilePath));
+	if (options.certificateName) argv.push("--certificateName", options.certificateName);
+	if (options.p12Path) argv.push("--p12Path", path.resolve(options.p12Path));
+	if (options.p12Password) argv.push("--p12Password", options.p12Password);
+	if (options.tpnsProfilePath) argv.push("--tpnsProfilePath", path.resolve(options.tpnsProfilePath));
+	if (options.isUploadBeta !== void 0) argv.push("--isUploadBeta", String(options.isUploadBeta));
+	if (options.isUploadResourceBundle) argv.push("--isUploadResourceBundle");
+	if (options.resourceBundleVersion) argv.push("--resourceBundleVersion", options.resourceBundleVersion);
+	if (options.resourceBundleDesc) argv.push("--resourceBundleDesc", options.resourceBundleDesc);
+	if (options.versionName) argv.push("--versionName", options.versionName);
+	if (options.versionCode !== void 0) argv.push("--versionCode", String(options.versionCode));
+	if (options.versionDesc) argv.push("--versionDesc", options.versionDesc);
+	await runWechatCliCommand(argv);
+}
+//#endregion
 //#region src/cli/wechat-dispatch.ts
 function hasOption(argv, optionName) {
 	return argv.includes(optionName) || argv.some((token) => token.startsWith(`${optionName}=`));
@@ -1676,7 +2835,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") {
@@ -1806,7 +2973,7 @@ async function parse(argv) {
 		return;
 	}
 	if (matchedCommand === "mcp") {
-		const { runMcpCommand } = await import("./run-mcp-C2SQ_hRJ.js");
+		const { runMcpCommand } = await import("./run-mcp-CPv8cesh.js");
 		await runMcpCommand(argv.slice(1));
 		return;
 	}
@@ -1824,4 +2991,4 @@ async function parse(argv) {
 	await runWechatCliCommand(formattedArgv);
 }
 //#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 { 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 };