weapp-ide-cli 6.2.0 → 6.3.0

package/dist/{sessionStore-zdzy2UFM.js → automatorProject-DjYLqMj6.js}

@@ -1,124 +1,15 @@
 import path from "node:path";
+import { mutateLease } from "@weapp-vite/devtools-runtime";
 import { execa } from "execa";
-import { createHash } from "node:crypto";
 import fs from "node:fs/promises";
 import process from "node:process";
 import { fs as fs$1 } from "@weapp-core/shared/fs";
-import baseLogger, { colors } from "@weapp-core/logger";
-import os from "node:os";
 import path$1 from "pathe";
+import os from "node:os";
+import { AsyncLocalStorage } from "node:async_hooks";
+import baseLogger, { colors } from "@weapp-core/logger";
+import { createHash } from "node:crypto";
 import { Buffer } from "node:buffer";
-//#region src/logger.ts
-const logger = baseLogger.create({
-	stdout: process.stderr,
-	stderr: process.stderr
-});
-//#endregion
-//#region src/runtime/platform.ts
-/**
-* @description 官方微信开发者工具只支持 Windows、macOS，Linux 只有社区版。
-* https://github.com/msojocs/wechat-web-devtools-linux
-*/
-const SupportedPlatformsMap = {
-	Windows_NT: "Windows_NT",
-	Darwin: "Darwin",
-	Linux: "Linux"
-};
-/**
-* @description 判断当前系统是否支持微信开发者工具。
-*/
-function isOperatingSystemSupported(osName = os.type()) {
-	return osName === SupportedPlatformsMap.Windows_NT || osName === SupportedPlatformsMap.Darwin || osName === SupportedPlatformsMap.Linux;
-}
-/**
-* @description 当前系统名称。
-*/
-const operatingSystemName = os.type();
-async function findFirstExistingPath(candidates) {
-	for (const candidate of candidates) {
-		if (!candidate) continue;
-		if (await fs$1.pathExists(candidate)) return candidate;
-	}
-}
-async function getFirstBinaryPath(command) {
-	const pathDirs = (process.env.PATH || "").split(path$1.delimiter);
-	for (const dir of pathDirs) {
-		const fullPath = path$1.join(dir, command);
-		try {
-			await fs$1.access(fullPath, fs$1.constants.X_OK);
-			return fullPath;
-		} catch {
-			continue;
-		}
-	}
-}
-function createLinuxCliResolver() {
-	let resolvedPath;
-	let attempted = false;
-	let pending = null;
-	return async () => {
-		if (attempted) return resolvedPath;
-		if (!pending) pending = (async () => {
-			try {
-				const envPath = await getFirstBinaryPath("wechat-devtools-cli");
-				if (envPath) resolvedPath = envPath;
-			} catch (error) {
-				const reason = error instanceof Error ? error.message : String(error);
-				logger.warn(`获取 Linux wechat-devtools-cli 路径失败：${reason}`);
-			} finally {
-				attempted = true;
-			}
-			return resolvedPath;
-		})();
-		return pending;
-	};
-}
-function createWindowsCliResolver() {
-	let resolvedPath;
-	let attempted = false;
-	let pending = null;
-	return async () => {
-		if (attempted) return resolvedPath;
-		if (!pending) pending = (async () => {
-			const programFilesX86 = process.env["ProgramFiles(x86)"] || "C:\\Program Files (x86)";
-			const programFiles = process.env.ProgramFiles || "C:\\Program Files";
-			const localAppData = process.env.LOCALAPPDATA || path$1.join(os.homedir(), "AppData", "Local");
-			const candidates = [
-				path$1.join(programFilesX86, "Tencent", "微信web开发者工具", "cli.bat"),
-				path$1.join(programFiles, "Tencent", "微信web开发者工具", "cli.bat"),
-				path$1.join(localAppData, "Programs", "微信开发者工具", "cli.bat"),
-				path$1.join(localAppData, "Tencent", "微信web开发者工具", "cli.bat")
-			];
-			try {
-				resolvedPath = await findFirstExistingPath(candidates);
-			} catch (error) {
-				const reason = error instanceof Error ? error.message : String(error);
-				logger.warn(`获取 Windows 微信开发者工具 CLI 路径失败：${reason}`);
-			} finally {
-				attempted = true;
-			}
-			return resolvedPath;
-		})();
-		return pending;
-	};
-}
-const linuxCliResolver = createLinuxCliResolver();
-const windowsCliResolver = createWindowsCliResolver();
-const DARWIN_DEFAULT_CLI = "/Applications/wechatwebdevtools.app/Contents/MacOS/cli";
-const cliPathResolvers = {
-	[SupportedPlatformsMap.Windows_NT]: windowsCliResolver,
-	[SupportedPlatformsMap.Darwin]: async () => DARWIN_DEFAULT_CLI,
-	[SupportedPlatformsMap.Linux]: linuxCliResolver
-};
-/**
-* @description 获取默认 CLI 路径（按系统）。
-*/
-async function getDefaultCliPath(targetOs = operatingSystemName) {
-	if (!isOperatingSystemSupported(targetOs)) return;
-	const resolver = cliPathResolvers[targetOs];
-	return await resolver();
-}
-//#endregion
 //#region src/utils/path.ts
 /**
 * @description 解析为绝对路径（基于当前工作目录）
@@ -221,72 +112,124 @@ async function overwriteCustomConfig(config) {
 	await writeCustomConfig(nextConfig, { replace: true });
 }
 //#endregion
-//#region src/config/resolver.ts
-function isCustomConfigJson(value) {
-	return typeof value === "object" && value !== null;
-}
+//#region src/devtoolsTarget/context.ts
+const wechatDevtoolsSelectionContext = new AsyncLocalStorage();
+//#endregion
+//#region src/logger.ts
+const logger = baseLogger.create({
+	stdout: process.stderr,
+	stderr: process.stderr
+});
+//#endregion
+//#region src/runtime/platform.ts
 /**
-* @description 解析开发者工具自动预热相关配置的最终生效值。
+* @description 官方微信开发者工具只支持 Windows、macOS，Linux 只有社区版。
+* https://github.com/msojocs/wechat-web-devtools-linux
 */
-function resolveDevtoolsAutomationDefaults(config) {
-	return {
-		autoBootstrapDevtools: config.autoBootstrapDevtools ?? true,
-		autoTrustProject: config.autoTrustProject ?? false
-	};
+const SupportedPlatformsMap = {
+	Windows_NT: "Windows_NT",
+	Darwin: "Darwin",
+	Linux: "Linux"
+};
+/**
+* @description 判断当前系统是否支持微信开发者工具。
+*/
+function isOperatingSystemSupported(osName = os.type()) {
+	return osName === SupportedPlatformsMap.Windows_NT || osName === SupportedPlatformsMap.Darwin || osName === SupportedPlatformsMap.Linux;
 }
 /**
-* @description 读取并解析 CLI 配置（进程选择优先，其次用户配置与平台默认）
+* @description 当前系统名称。
 */
-async function getConfig() {
-	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"
-			};
+const operatingSystemName = os.type();
+async function findFirstExistingPath(candidates) {
+	for (const candidate of candidates) {
+		if (!candidate) continue;
+		if (await fs$1.pathExists(candidate)) return candidate;
+	}
+}
+async function getFirstBinaryPath(command) {
+	const pathDirs = (process.env.PATH || "").split(path$1.delimiter);
+	for (const dir of pathDirs) {
+		const fullPath = path$1.join(dir, command);
+		try {
+			await fs$1.access(fullPath, fs$1.constants.X_OK);
+			return fullPath;
+		} catch {
+			continue;
 		}
-		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 getDefaultCliPath();
-	if (fallbackPath) return {
-		cliPath: fallbackPath,
-		locale: void 0,
-		autoBootstrapDevtools: void 0,
-		autoTrustProject: void 0,
-		source: "default"
+}
+function createLinuxCliResolver() {
+	let resolvedPath;
+	let attempted = false;
+	let pending = null;
+	return async () => {
+		if (attempted) return resolvedPath;
+		if (!pending) pending = (async () => {
+			try {
+				const envPath = await getFirstBinaryPath("wechat-devtools-cli");
+				if (envPath) resolvedPath = envPath;
+			} catch (error) {
+				const reason = error instanceof Error ? error.message : String(error);
+				logger.warn(`获取 Linux wechat-devtools-cli 路径失败：${reason}`);
+			} finally {
+				attempted = true;
+			}
+			return resolvedPath;
+		})();
+		return pending;
 	};
-	return {
-		cliPath: "",
-		locale: void 0,
-		autoBootstrapDevtools: void 0,
-		autoTrustProject: void 0,
-		source: "missing"
+}
+function createWindowsCliResolver() {
+	let resolvedPath;
+	let attempted = false;
+	let pending = null;
+	return async () => {
+		if (attempted) return resolvedPath;
+		if (!pending) pending = (async () => {
+			const programFilesX86 = process.env["ProgramFiles(x86)"] || "C:\\Program Files (x86)";
+			const programFiles = process.env.ProgramFiles || "C:\\Program Files";
+			const localAppData = process.env.LOCALAPPDATA || path$1.join(os.homedir(), "AppData", "Local");
+			const candidates = [
+				path$1.join(programFilesX86, "Tencent", "微信web开发者工具", "cli.bat"),
+				path$1.join(programFiles, "Tencent", "微信web开发者工具", "cli.bat"),
+				path$1.join(localAppData, "Programs", "微信开发者工具", "cli.bat"),
+				path$1.join(localAppData, "Tencent", "微信web开发者工具", "cli.bat")
+			];
+			try {
+				resolvedPath = await findFirstExistingPath(candidates);
+			} catch (error) {
+				const reason = error instanceof Error ? error.message : String(error);
+				logger.warn(`获取 Windows 微信开发者工具 CLI 路径失败：${reason}`);
+			} finally {
+				attempted = true;
+			}
+			return resolvedPath;
+		})();
+		return pending;
 	};
 }
+const linuxCliResolver = createLinuxCliResolver();
+const windowsCliResolver = createWindowsCliResolver();
+const DARWIN_DEFAULT_CLI = "/Applications/wechatwebdevtools.app/Contents/MacOS/cli";
+const cliPathResolvers = {
+	[SupportedPlatformsMap.Windows_NT]: windowsCliResolver,
+	[SupportedPlatformsMap.Darwin]: async () => DARWIN_DEFAULT_CLI,
+	[SupportedPlatformsMap.Linux]: linuxCliResolver
+};
 /**
-* @description 获取用户配置的语言偏好。
+* @description 获取默认 CLI 路径（按系统）。
 */
-async function getConfiguredLocale() {
-	return (await readCustomConfig()).locale;
+async function getDefaultCliPath(targetOs = operatingSystemName) {
+	if (!isOperatingSystemSupported(targetOs)) return;
+	const resolver = cliPathResolvers[targetOs];
+	return await resolver();
+}
+//#endregion
+//#region src/utils/powershell.ts
+/** 固定重定向 stdout 的 UTF-8 编码，避免默认代码页损坏进程路径和安装身份。 */
+function withPowerShellUtf8Output(script) {
+	return `[Console]::OutputEncoding=[Text.UTF8Encoding]::new($false); ${script}`;
 }
 //#endregion
 //#region src/devtoolsTarget/metadata.ts
@@ -330,9 +273,9 @@ async function readAsarPackage(asarPath) {
 async function readWechatDevtoolsMetadata(appPath) {
 	const value = appPath.endsWith(".asar") ? await readAsarPackage(appPath) : await readPackageFile(path.join(appPath, "package.json"));
 	if (!record(value)) throw new Error("Invalid DevTools package metadata.");
-	if (![value.name, value.productName].filter((name) => typeof name === "string").some((name) => name === "微信开发者工具" || /wechat(?:web)?devtools/i.test(name))) throw new Error("The selected application metadata does not identify WeChat DevTools.");
+	if (![value.name, value.productName].filter((name) => typeof name === "string").some((name) => name === "微信开发者工具" || /wechat(?:web)?devtools/i.test(name))) throw Object.assign(/* @__PURE__ */ new Error("The selected application metadata does not identify WeChat DevTools."), { code: "WECHAT_DEVTOOLS_UNRELATED_APPLICATION" });
 	return {
-		version: typeof value.version === "string" && /^\d+\.\d+\.\d+$/.test(value.version) ? value.version : void 0,
+		version: typeof value.version === "string" && /^\d+(?:\.\d+){2,}$/.test(value.version) ? value.version : void 0,
 		channel: String(value.versionType) === "0" ? "stable" : String(value.versionType) === "1" ? "rc" : String(value.versionType) === "2" ? "nightly" : "unknown"
 	};
 }
@@ -347,17 +290,203 @@ function resolveWechatDevtoolsProfileDir(appPath, options = {}) {
 	return path.join(baseDir, createHash("md5").update(appPath).digest("hex"));
 }
 //#endregion
-//#region src/utils/powershell.ts
-/** 固定重定向 stdout 的 UTF-8 编码，避免默认代码页损坏进程路径和安装身份。 */
-function withPowerShellUtf8Output(script) {
-	return `[Console]::OutputEncoding=[Text.UTF8Encoding]::new($false); ${script}`;
+//#region src/devtoolsTarget/installation.ts
+async function resolveApplicationPath(cliPath, platform) {
+	const root = platform === "darwin" && path.basename(path.dirname(cliPath)) === "MacOS" ? path.join(path.dirname(path.dirname(cliPath)), "Resources") : path.dirname(cliPath);
+	const candidates = platform === "darwin" ? [
+		path.join(root, "app.asar"),
+		path.join(root, "app"),
+		path.join(root, "package.nw")
+	] : [
+		path.join(root, "resources", "app.asar"),
+		path.join(root, "resources", "app"),
+		path.join(root, "package.nw"),
+		path.join(root, "resources", "package.nw")
+	];
+	for (const candidate of candidates) try {
+		const stat = await fs.stat(candidate);
+		if (candidate.endsWith(".asar") ? stat.isFile() : stat.isDirectory()) return await fs.realpath(candidate);
+	} catch (error) {
+		if (error.code !== "ENOENT") throw error;
+	}
+	throw new Error("Cannot identify the selected WeChat DevTools installation. Select its official CLI path.");
+}
+/** 只读取明确路径的安装元数据，不读取配置或启动宿主。 */
+async function inspectWechatDevtoolsInstallation(selected, options = {}) {
+	const cliPath = await fs.realpath(selected);
+	if (!(await fs.stat(cliPath)).isFile()) throw new Error("The selected WeChat DevTools CLI is not a file.");
+	const appPath = await resolveApplicationPath(cliPath, options.platform ?? process.platform);
+	return {
+		cliPath,
+		appPath,
+		installationId: createHash("sha256").update(appPath).digest("hex"),
+		profileDir: resolveWechatDevtoolsProfileDir(appPath, options),
+		...await readWechatDevtoolsMetadata(appPath)
+	};
+}
+//#endregion
+//#region src/devtoolsTarget/registry.ts
+const defaultWechatDevtoolsRegistryPath = path.join(defaultCustomConfigDirPath, "installations.json");
+/** 登记只保存路径；安装渠道和版本每次从实际应用重新读取。 */
+async function readWechatDevtoolsRegistry(registryPath = defaultWechatDevtoolsRegistryPath) {
+	try {
+		const value = JSON.parse(await fs.readFile(registryPath, "utf8"));
+		if (!Array.isArray(value) || !value.every((entry) => typeof entry === "string" && entry.trim())) throw new Error("Invalid DevTools installation registry: expected CLI paths.");
+		return value;
+	} catch (error) {
+		if (error.code === "ENOENT") return [];
+		throw error;
+	}
+}
+async function updateRegistry(registryPath, update) {
+	await fs.mkdir(path.dirname(registryPath), { recursive: true });
+	await mutateLease(`${registryPath}.lock`, async () => {
+		const paths = update(await readWechatDevtoolsRegistry(registryPath));
+		const temporary = `${registryPath}.${process.pid}.tmp`;
+		try {
+			await fs.writeFile(temporary, `${JSON.stringify(paths, null, 2)}\n`);
+			await fs.rename(temporary, registryPath);
+		} finally {
+			await fs.rm(temporary, { force: true });
+		}
+	});
+}
+/** 校验安装后登记真实 CLI 路径，不更改默认选择或登录数据。 */
+async function registerWechatDevtoolsInstallation(cliPath, registryPath = defaultWechatDevtoolsRegistryPath) {
+	const target = await inspectWechatDevtoolsInstallation(cliPath);
+	await updateRegistry(registryPath, (paths) => [.../* @__PURE__ */ new Set([...paths, target.cliPath])]);
+	return target;
+}
+/** 允许移除已经失效的登记；不会删除应用或用户配置。 */
+async function unregisterWechatDevtoolsInstallation(cliPath, registryPath = defaultWechatDevtoolsRegistryPath) {
+	const selected = await fs.realpath(cliPath).catch(() => path.resolve(cliPath));
+	await updateRegistry(registryPath, (paths) => paths.filter((entry) => entry !== selected && entry !== path.resolve(cliPath)));
+}
+//#endregion
+//#region src/devtoolsTarget/discovery.ts
+/** 产品版本按数字段比较，避免日期版本的字符串排序漂移。 */
+function compareWechatDevtoolsVersions(a, b) {
+	const left = a.split(".").map(Number);
+	const right = b.split(".").map(Number);
+	for (let index = 0; index < Math.max(left.length, right.length); index++) {
+		const difference = (left[index] ?? 0) - (right[index] ?? 0);
+		if (difference) return difference;
+	}
+	return 0;
+}
+async function directories(root) {
+	try {
+		return await fs.readdir(root, { withFileTypes: true });
+	} catch (error) {
+		if (["ENOENT", "EACCES"].includes(error.code ?? "")) return [];
+		throw error;
+	}
+}
+async function windowsRegistryRoots() {
+	const result = await execa("powershell.exe", [
+		"-NoProfile",
+		"-NonInteractive",
+		"-Command",
+		withPowerShellUtf8Output("$ErrorActionPreference='Stop'; @('HKLM:\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\*','HKLM:\\SOFTWARE\\WOW6432Node\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\*','HKCU:\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\*') | ForEach-Object { Get-ItemProperty $_ -ErrorAction SilentlyContinue } | Where-Object { $_.DisplayName -match '微信.*开发者|wechat.*devtools' -and $_.InstallLocation } | Select-Object -ExpandProperty InstallLocation | ConvertTo-Json -Compress")
+	], {
+		reject: false,
+		windowsHide: true,
+		timeout: 1e4
+	});
+	if (result.exitCode !== 0) throw new Error("Unable to inspect Windows DevTools installation registry.");
+	const parsed = JSON.parse(result.stdout.trim() || "[]");
+	return (Array.isArray(parsed) ? parsed : [parsed]).filter((value) => typeof value === "string");
+}
+/** 只扫描已知安装根，不递归遍历磁盘，也不执行候选应用。 */
+async function listWechatDevtoolsInstallations(options = {}) {
+	const platform = options.platform ?? process.platform;
+	const home = options.homeDir ?? os.homedir();
+	const registered = await readWechatDevtoolsRegistry(options.registryPath);
+	const config = await readCustomConfig();
+	const candidates = new Set([
+		...registered,
+		config.cliPath,
+		process.env.WEAPP_IDE_CLI_PATH
+	].filter((value) => !!value));
+	const fallback = options.searchRoots || platform === "linux" ? void 0 : await getDefaultCliPath(platform === "darwin" ? "Darwin" : "Windows_NT");
+	if (fallback) candidates.add(fallback);
+	const roots = options.searchRoots ?? (platform === "darwin" ? ["/Applications", path.join(home, "Applications")] : platform === "win32" ? [
+		process.env.ProgramFiles ?? "C:\\Program Files",
+		process.env["ProgramFiles(x86)"] ?? "C:\\Program Files (x86)",
+		options.localAppDataDir ?? process.env.LOCALAPPDATA ?? path.join(home, "AppData", "Local")
+	] : []);
+	if (platform === "win32" && !options.searchRoots) for (const root of await windowsRegistryRoots().catch(() => [])) candidates.add(path.join(root, "cli.bat"));
+	const explicitCandidates = new Set(candidates);
+	for (const root of roots) {
+		const entries = await directories(root);
+		if (platform === "darwin") for (const entry of entries.filter((entry) => /\.app$/i.test(entry.name))) {
+			const candidate = path.join(root, entry.name, "Contents", "MacOS", "cli");
+			if (await fs.stat(candidate).then((stat) => stat.isFile(), () => false)) candidates.add(candidate);
+		}
+		else if (platform === "win32") for (const directory of [root, ...entries.filter((entry) => entry.isDirectory()).map((entry) => path.join(root, entry.name))]) for (const candidateRoot of [directory, ...(await directories(directory)).filter((entry) => entry.isDirectory()).map((entry) => path.join(directory, entry.name))]) {
+			const candidate = path.join(candidateRoot, "cli.bat");
+			if (await fs.stat(candidate).then((stat) => stat.isFile(), () => false)) candidates.add(candidate);
+		}
+	}
+	const seen = /* @__PURE__ */ new Set();
+	const result = [];
+	for (const cliPath of candidates) try {
+		const target = await inspectWechatDevtoolsInstallation(cliPath, options);
+		if (!seen.has(target.installationId)) {
+			seen.add(target.installationId);
+			result.push({
+				cliPath: target.cliPath,
+				target
+			});
+		}
+	} catch (error) {
+		if (!explicitCandidates.has(cliPath)) continue;
+		if (error.code === "WECHAT_DEVTOOLS_UNRELATED_APPLICATION" && !registered.includes(cliPath) && cliPath !== config.cliPath && cliPath !== process.env.WEAPP_IDE_CLI_PATH) continue;
+		result.push({
+			cliPath,
+			error: error instanceof Error ? error.message : String(error)
+		});
+	}
+	return result.sort((a, b) => compareWechatDevtoolsVersions(b.target?.version ?? "0", a.target?.version ?? "0") || a.cliPath.localeCompare(b.cliPath));
+}
+/** 渠道必须显式 opt-in；找不到或存在同版本歧义时不静默换安装。 */
+async function selectInstalledWechatDevtools(options = {}) {
+	const channel = options.devtoolsChannel ?? (options.devtoolsVersion ? void 0 : "stable");
+	const matches = (await listWechatDevtoolsInstallations(options)).flatMap((entry) => entry.target?.version && (!channel || entry.target.channel === channel) && (!options.devtoolsVersion || entry.target.version === options.devtoolsVersion) ? [entry.target] : []);
+	if (!matches.length) throw Object.assign(/* @__PURE__ */ new Error(`No installed WeChat DevTools matches ${channel ?? "any channel"}${options.devtoolsVersion ? `@${options.devtoolsVersion}` : ""}. Register its CLI with weapp devtools add <path-to-cli>.`), { code: "WECHAT_DEVTOOLS_INSTALLATION_NOT_FOUND" });
+	if (matches.filter((target) => compareWechatDevtoolsVersions(target.version, matches[0].version) === 0).length !== 1) throw Object.assign(/* @__PURE__ */ new Error("Multiple DevTools installations match the selected version. Specify --cli-path."), { code: "WECHAT_DEVTOOLS_INSTALLATION_AMBIGUOUS" });
+	return matches[0];
+}
+//#endregion
+//#region src/devtoolsTarget/official.ts
+const WECHAT_DEVTOOLS_OFFICIAL_CHANNELS_URL = "https://devtools.wxqcloud.qq.com.cn/WechatWebDev/nightly/versions/config.json";
+/** 官方查询只提供版本证据，默认选择不依赖网络可用性。 */
+async function readOfficialWechatDevtoolsVersion(channel = "stable") {
+	const queriedAt = (/* @__PURE__ */ new Date()).toISOString();
+	const response = await fetch(WECHAT_DEVTOOLS_OFFICIAL_CHANNELS_URL, { signal: AbortSignal.timeout(15e3) });
+	if (!response.ok) throw new Error(`Unable to query official DevTools versions: HTTP ${response.status}`);
+	const value = await response.json();
+	const entry = (value && typeof value === "object" && "channels" in value && Array.isArray(value.channels) ? value.channels : []).find((entry) => entry && typeof entry === "object" && "id" in entry && entry.id === channel);
+	if (!entry || typeof entry !== "object" || !("version" in entry) || typeof entry.version !== "string" || !/^\d+(?:\.\d+){2,}$/.test(entry.version)) throw new Error(`Official DevTools metadata has no valid ${channel} version.`);
+	return {
+		version: entry.version,
+		source: WECHAT_DEVTOOLS_OFFICIAL_CHANNELS_URL,
+		queriedAt
+	};
+}
+/** 仅显式严格模式要求所选安装匹配官方渠道最新版本。 */
+async function assertOfficialWechatDevtoolsVersion(target) {
+	if (!target.channel || target.channel === "unknown") throw new Error("Cannot verify the official latest version for an unknown DevTools channel.");
+	const official = await readOfficialWechatDevtoolsVersion(target.channel);
+	if (target.version !== official.version) throw new Error(`DEVTOOLS_OFFICIAL_LATEST_REQUIRED: selected ${target.version}, official ${target.channel}@${official.version}.`);
+	return official;
 }
 //#endregion
 //#region src/devtoolsTarget/inspection.ts
-/** Windows 冷启动还需初始化 PowerShell 与 CIM；显式调用预算始终优先。 */
+/** Windows 查询预算包含 PowerShell 冷启动及内核/CIM 初始化；显式较小预算始终优先。 */
 function resolveWechatInspectionTimeout(platform, timeout) {
 	if (timeout !== void 0 && (Number.isNaN(timeout) || timeout <= 0)) throw new RangeError("DevTools inspection timeout must be positive.");
-	const maximum = platform === "win32" ? 1e4 : 3e3;
+	const maximum = platform === "win32" ? 3e4 : 3e3;
 	return Math.min(timeout ?? maximum, maximum);
 }
 //#endregion
@@ -366,8 +495,7 @@ function ownershipError(message) {
 	return Object.assign(new Error(message), { code: "WECHAT_DEVTOOLS_HOST_IDENTITY_MISMATCH" });
 }
 function normalize(value, platform) {
-	const normalized = value.replaceAll("\\", "/").replace(/\/$/, "");
-	return platform === "win32" ? normalized.toLowerCase() : normalized;
+	return (platform === "win32" ? value.replaceAll("\\", "/").toLowerCase() : value).replace(/\/$/, "");
 }
 /** 复用宿主归属检查的安装根规则，不能把 app.asar 当作可执行文件目录。 */
 function resolveWechatDevtoolsInstallationRoot(target, platform) {
@@ -493,53 +621,76 @@ async function assertWechatDevtoolsPort(target, port, options = {}) {
 }
 //#endregion
 //#region src/devtoolsTarget/index.ts
-async function resolveApplicationPath(cliPath, platform) {
-	const root = platform === "darwin" && path.basename(path.dirname(cliPath)) === "MacOS" ? path.join(path.dirname(path.dirname(cliPath)), "Resources") : path.dirname(cliPath);
-	const candidates = platform === "darwin" ? [
-		path.join(root, "app.asar"),
-		path.join(root, "app"),
-		path.join(root, "package.nw")
-	] : [
-		path.join(root, "resources", "app.asar"),
-		path.join(root, "resources", "app"),
-		path.join(root, "package.nw"),
-		path.join(root, "resources", "package.nw")
-	];
-	for (const candidate of candidates) try {
-		const stat = await fs.stat(candidate);
-		if (candidate.endsWith(".asar") ? stat.isFile() : stat.isDirectory()) return await fs.realpath(candidate);
-	} catch (error) {
-		if (error.code !== "ENOENT") throw error;
-	}
-	throw new Error("Cannot identify the selected WeChat DevTools installation. Select its official CLI path.");
+function conflict(message) {
+	throw Object.assign(new Error(message), { code: "WECHAT_DEVTOOLS_INSTALLATION_SELECTION_CONFLICT" });
+}
+function validateWechatDevtoolsSelection(options) {
+	if (options.cliPath !== void 0 && !options.cliPath.trim()) throw new Error("cliPath must not be empty.");
+	if (options.devtoolsChannel !== void 0 && ![
+		"stable",
+		"rc",
+		"nightly"
+	].includes(options.devtoolsChannel)) throw new Error("devtoolsChannel must be stable, rc or nightly.");
+	if (options.devtoolsVersion !== void 0 && !/^\d+(?:\.\d+){2,}$/.test(options.devtoolsVersion)) throw new Error("devtoolsVersion must be a complete DevTools product version.");
+}
+async function assertSelection(target, options) {
+	if (options.cliPath?.trim() && await fs.realpath(options.cliPath.trim()) !== await fs.realpath(target.cliPath)) conflict("The explicit CLI path conflicts with the selected DevTools installation; no installation was changed.");
+	if (options.devtoolsChannel && options.devtoolsChannel !== target.channel) conflict("The requested DevTools channel conflicts with the selected installation.");
+	if (options.devtoolsVersion && options.devtoolsVersion !== target.version) conflict("The requested DevTools version conflicts with the selected installation.");
+	if (options.requireOfficialLatest) await assertOfficialWechatDevtoolsVersion(target);
+	return target;
+}
+function readWechatDevtoolsSelectionEnvironment(env = process.env) {
+	const options = {
+		cliPath: env.WEAPP_IDE_CLI_PATH?.trim() || void 0,
+		devtoolsChannel: env.WEAPP_IDE_DEVTOOLS_CHANNEL?.trim() || void 0,
+		devtoolsVersion: env.WEAPP_IDE_DEVTOOLS_VERSION?.trim() || void 0,
+		requireOfficialLatest: env.WEAPP_IDE_REQUIRE_OFFICIAL_LATEST === "1"
+	};
+	validateWechatDevtoolsSelection(options);
+	return options;
 }
-/** 一次解析 CLI、应用身份及配置目录，供本次操作的所有阶段共同使用。 */
+/** 每次操作只解析一次安装，显式选择覆盖继承的配置但不写回全局设置。 */
 async function resolveWechatDevtoolsTarget(options = {}) {
-	if (options.target) {
-		const explicitCliPath = options.cliPath?.trim();
-		if (explicitCliPath && explicitCliPath !== options.target.cliPath) {
-			const [explicit, selected] = await Promise.all([fs.realpath(explicitCliPath), fs.realpath(options.target.cliPath)]);
-			if (explicit !== selected) throw Object.assign(/* @__PURE__ */ new Error("The explicit CLI path conflicts with the selected DevTools installation; no installation was changed."), { code: "WECHAT_DEVTOOLS_INSTALLATION_SELECTION_CONFLICT" });
-		}
-		return options.target;
+	validateWechatDevtoolsSelection(options);
+	const active = wechatDevtoolsSelectionContext.getStore();
+	if (active && options.target && active.installationId !== options.target.installationId) conflict("The fixed target conflicts with the active operation installation.");
+	const frozen = active ?? options.target;
+	if (frozen) return await assertSelection(frozen, options);
+	let selection = { ...options };
+	if (!options.cliPath?.trim() && !options.devtoolsChannel && !options.devtoolsVersion) {
+		selection = readWechatDevtoolsSelectionEnvironment();
+		selection.requireOfficialLatest = options.requireOfficialLatest ?? selection.requireOfficialLatest;
+		if (!selection.cliPath && !selection.devtoolsChannel && !selection.devtoolsVersion) selection = {
+			...selection,
+			cliPath: (await readCustomConfig()).cliPath
+		};
 	}
-	const selected = options.cliPath?.trim() || (await getConfig()).cliPath;
-	if (!selected) throw new Error("No WeChat DevTools CLI has been selected.");
-	const cliPath = await fs.realpath(selected);
-	if (!(await fs.stat(cliPath)).isFile()) throw new Error("The selected WeChat DevTools CLI is not a file.");
-	const appPath = await resolveApplicationPath(cliPath, options.platform ?? process.platform);
-	const metadata = await readWechatDevtoolsMetadata(appPath);
-	return {
-		cliPath,
-		appPath,
-		installationId: createHash("sha256").update(appPath).digest("hex"),
-		profileDir: resolveWechatDevtoolsProfileDir(appPath, options),
-		...metadata
-	};
+	selection.requireOfficialLatest ??= process.env.WEAPP_IDE_REQUIRE_OFFICIAL_LATEST === "1";
+	return await assertSelection(selection.cliPath?.trim() ? await inspectWechatDevtoolsInstallation(selection.cliPath.trim(), options) : await selectInstalledWechatDevtools({
+		...options,
+		...selection
+	}), selection);
+}
+/** 命令的所有异步阶段复用同一安装，彼此并发的调用不会污染环境变量。 */
+async function withWechatDevtoolsSelection(options, runner) {
+	const target = await resolveWechatDevtoolsTarget(options);
+	return await wechatDevtoolsSelectionContext.run(target, () => runner(target));
+}
+/** 读取当前操作固定的安装；没有活动选择时不触发发现或启动。 */
+function getActiveWechatDevtoolsTarget() {
+	return wechatDevtoolsSelectionContext.getStore();
 }
 //#endregion
+//#region src/devtoolsProjectOwnership/journal/constants.ts
+/** 受管项目日志的环境变量名称；基础设施预检可在构建包之前读取。 */
+const MANAGED_PROJECT_JOURNAL_ENV = "WEAPP_IDE_MANAGED_PROJECT_JOURNAL";
+/** 仅供显式受管任务声明双项目窗口验收；不允许无限扩大并行窗口。 */
+const MANAGED_PROJECT_MAX_WINDOWS_ENV = "WEAPP_IDE_MANAGED_PROJECT_MAX_WINDOWS";
+//#endregion
 //#region src/cli/automator/sessionStore.ts
 const SESSION_DIRECTORY = path.join(os.tmpdir(), "weapp-vite-automator-sessions");
+/** 内部工具复用会话键；不从包入口公开缓存路径契约。 */
 function resolveAutomatorSessionFilePath(options) {
 	const key = JSON.stringify([
 		options.installationId,
@@ -602,4 +753,129 @@ async function readPersistedAutomatorSession(options) {
 	}
 }
 //#endregion
-export { getDefaultCliPath as C, logger as D, colors as E, SupportedPlatformsMap as S, operatingSystemName as T, readCustomConfig as _, assertWechatDevtoolsPort as a, defaultCustomConfigFilePath as b, withPowerShellUtf8Output as c, resolveDevtoolsAutomationDefaults as d, createAutoBootstrapDevtoolsConfig as f, overwriteCustomConfig as g, createLocaleConfig as h, assertWechatDevtoolsHost as i, getConfig as l, createCustomConfig as m, readPersistedAutomatorSession as n, resolveWechatDevtoolsInstallationRoot as o, createAutoTrustProjectConfig as p, resolveWechatDevtoolsTarget as r, resolveWechatInspectionTimeout as s, persistAutomatorSession as t, getConfiguredLocale as u, removeCustomConfigKey as v, isOperatingSystemSupported as w, resolvePath as x, defaultCustomConfigDirPath as y };
+//#region src/cli/automatorProject.ts
+const WRAPPER_ROOT = path.join(os.tmpdir(), "weapp-ide-cli-automator-projects");
+function normalizeProjectRelativeRoot(rawRoot) {
+	if (typeof rawRoot !== "string") return;
+	const normalized = rawRoot.trim().replace(/\\/g, "/").replace(/^\/+/, "").replace(/\/+$/, "");
+	if (!normalized || normalized === ".") return;
+	if (normalized.split("/").includes("..")) return;
+	return normalized;
+}
+async function pathExists(filePath) {
+	try {
+		await fs.access(filePath);
+		return true;
+	} catch {
+		return false;
+	}
+}
+async function readJsonObject(filePath) {
+	try {
+		const raw = await fs.readFile(filePath, "utf8");
+		const value = JSON.parse(raw);
+		return value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
+	} catch {
+		return;
+	}
+}
+async function writeJsonObject(filePath, value) {
+	await fs.mkdir(path.dirname(filePath), { recursive: true });
+	await fs.writeFile(filePath, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+}
+async function copyProjectRoot(sourceProjectPath, wrapperProjectPath, relativeRoot) {
+	const sourcePath = path.join(sourceProjectPath, relativeRoot);
+	if (!await pathExists(sourcePath)) return;
+	await fs.cp(sourcePath, path.join(wrapperProjectPath, relativeRoot), {
+		dereference: true,
+		force: true,
+		recursive: true
+	});
+}
+function createWrapperProjectConfig(source, patch) {
+	const { miniprogramRoot: _miniprogramRoot, qcloudRoot: _qcloudRoot, srcMiniprogramRoot: _srcMiniprogramRoot, ...rest } = source;
+	const sourceSetting = source.setting && typeof source.setting === "object" ? source.setting : {};
+	const patchSetting = patch.setting && typeof patch.setting === "object" ? patch.setting : {};
+	return {
+		...rest,
+		...patch,
+		setting: {
+			...sourceSetting,
+			...patchSetting,
+			packNpmManually: false,
+			packNpmRelationList: []
+		}
+	};
+}
+async function ensureWrapperAppConfig(wrapperProjectPath) {
+	const appConfigPath = path.join(wrapperProjectPath, "app.json");
+	const appConfig = await readJsonObject(appConfigPath);
+	if (!appConfig) return;
+	await writeJsonObject(appConfigPath, {
+		...appConfig,
+		subPackages: Array.isArray(appConfig.subPackages) ? appConfig.subPackages : []
+	});
+}
+/** 只读解析布局，受管路径必须先通过窗口预算再创建快照。 */
+async function readAutomatorProjectPlan(projectPath) {
+	const sourceProjectPath = path.resolve(projectPath);
+	const projectConfig = await readJsonObject(path.join(sourceProjectPath, "project.config.json"));
+	const miniprogramRoot = normalizeProjectRelativeRoot(projectConfig?.miniprogramRoot);
+	if (!miniprogramRoot) return;
+	const distRoot = path.join(sourceProjectPath, miniprogramRoot);
+	if (!await pathExists(path.join(distRoot, "app.json"))) return;
+	return {
+		sourceProjectPath,
+		distRoot,
+		projectConfig: projectConfig ?? {}
+	};
+}
+/** 仅转换已分配快照的布局；目录所有权与删除由调用方持有。 */
+async function populateAutomatorProjectSnapshot(plan, wrapperProjectPath) {
+	const { sourceProjectPath, distRoot, projectConfig: sourceProjectConfig } = plan;
+	await fs.cp(distRoot, wrapperProjectPath, {
+		dereference: true,
+		force: true,
+		recursive: true
+	});
+	const pluginRoot = normalizeProjectRelativeRoot(sourceProjectConfig.pluginRoot);
+	if (pluginRoot) await copyProjectRoot(sourceProjectPath, wrapperProjectPath, pluginRoot);
+	const projectPrivateConfig = await readJsonObject(path.join(sourceProjectPath, "project.private.config.json")) ?? {};
+	await writeJsonObject(path.join(wrapperProjectPath, "project.config.json"), createWrapperProjectConfig(sourceProjectConfig, {
+		...projectPrivateConfig,
+		compileType: sourceProjectConfig.compileType === "plugin" ? "plugin" : "miniprogram",
+		miniprogramRoot: "./",
+		srcMiniprogramRoot: "./"
+	}));
+	await fs.rm(path.join(wrapperProjectPath, "project.private.config.json"), { force: true });
+	await ensureWrapperAppConfig(wrapperProjectPath);
+}
+/** 为普通非受管 automator 保留既有稳定项目路径合同。 */
+async function resolveAutomatorProjectPath(projectPath) {
+	const sourceProjectPath = path.resolve(projectPath);
+	const plan = await readAutomatorProjectPlan(sourceProjectPath);
+	if (!plan) return {
+		projectPath: sourceProjectPath,
+		sourceProjectPath
+	};
+	const wrapperHash = createHash("sha1").update(sourceProjectPath).update("\0").update(path.resolve(plan.distRoot)).digest("hex").slice(0, 16);
+	const wrapperProjectPath = path.join(WRAPPER_ROOT, wrapperHash);
+	await fs.rm(wrapperProjectPath, {
+		recursive: true,
+		force: true
+	});
+	await fs.mkdir(wrapperProjectPath, { recursive: true });
+	await populateAutomatorProjectSnapshot(plan, wrapperProjectPath);
+	return {
+		cleanup: async () => {
+			await fs.rm(wrapperProjectPath, {
+				recursive: true,
+				force: true
+			});
+		},
+		projectPath: wrapperProjectPath,
+		sourceProjectPath
+	};
+}
+//#endregion
+export { operatingSystemName as A, removeCustomConfigKey as B, registerWechatDevtoolsInstallation as C, SupportedPlatformsMap as D, withPowerShellUtf8Output as E, createAutoTrustProjectConfig as F, defaultCustomConfigFilePath as H, createCustomConfig as I, createLocaleConfig as L, logger as M, wechatDevtoolsSelectionContext as N, getDefaultCliPath as O, createAutoBootstrapDevtoolsConfig as P, overwriteCustomConfig as R, selectInstalledWechatDevtools as S, inspectWechatDevtoolsInstallation as T, resolvePath as U, defaultCustomConfigDirPath as V, WECHAT_DEVTOOLS_OFFICIAL_CHANNELS_URL as _, readPersistedAutomatorSession as a, compareWechatDevtoolsVersions as b, getActiveWechatDevtoolsTarget as c, validateWechatDevtoolsSelection as d, withWechatDevtoolsSelection as f, resolveWechatInspectionTimeout as g, resolveWechatDevtoolsInstallationRoot as h, persistAutomatorSession as i, colors as j, isOperatingSystemSupported as k, readWechatDevtoolsSelectionEnvironment as l, assertWechatDevtoolsPort as m, readAutomatorProjectPlan as n, MANAGED_PROJECT_JOURNAL_ENV as o, assertWechatDevtoolsHost as p, resolveAutomatorProjectPath as r, MANAGED_PROJECT_MAX_WINDOWS_ENV as s, populateAutomatorProjectSnapshot as t, resolveWechatDevtoolsTarget as u, assertOfficialWechatDevtoolsVersion as v, unregisterWechatDevtoolsInstallation as w, listWechatDevtoolsInstallations as x, readOfficialWechatDevtoolsVersion as y, readCustomConfig as z };