weapp-ide-cli 6.1.9 → 6.3.0

package/dist/automatorProject-DjYLqMj6.js

@@ -0,0 +1,881 @@
+import path from "node:path";
+import { mutateLease } from "@weapp-vite/devtools-runtime";
+import { execa } from "execa";
+import fs from "node:fs/promises";
+import process from "node:process";
+import { fs as fs$1 } from "@weapp-core/shared/fs";
+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/utils/path.ts
+/**
+* @description 解析为绝对路径（基于当前工作目录）
+*/
+function resolvePath(filePath) {
+	if (path$1.isAbsolute(filePath)) return filePath;
+	return path$1.resolve(process.cwd(), filePath);
+}
+//#endregion
+//#region src/config/paths.ts
+const homedir = os.homedir();
+/**
+* @description 默认自定义配置目录
+*/
+const defaultCustomConfigDirPath = path$1.join(homedir, ".weapp-ide-cli");
+/**
+* @description 默认自定义配置文件路径
+*/
+const defaultCustomConfigFilePath = path$1.join(defaultCustomConfigDirPath, "config.json");
+//#endregion
+//#region src/config/custom.ts
+const JSON_OPTIONS = {
+	encoding: "utf8",
+	spaces: 2
+};
+async function readCustomConfig() {
+	if (!await fs$1.pathExists(defaultCustomConfigFilePath)) return {};
+	try {
+		const config = await fs$1.readJSON(defaultCustomConfigFilePath);
+		if (!config || typeof config !== "object") return {};
+		const candidate = config;
+		const next = {};
+		if (typeof candidate.cliPath === "string" && candidate.cliPath.trim()) next.cliPath = candidate.cliPath.trim();
+		if (candidate.locale === "zh" || candidate.locale === "en") next.locale = candidate.locale;
+		if (typeof candidate.autoBootstrapDevtools === "boolean") next.autoBootstrapDevtools = candidate.autoBootstrapDevtools;
+		if (typeof candidate.autoTrustProject === "boolean") next.autoTrustProject = candidate.autoTrustProject;
+		return next;
+	} catch {
+		return {};
+	}
+}
+async function writeCustomConfig(patch, options = {}) {
+	const nextConfig = {
+		...options.replace ? {} : await readCustomConfig(),
+		...patch
+	};
+	await fs$1.ensureDir(defaultCustomConfigDirPath);
+	await fs$1.writeJSON(defaultCustomConfigFilePath, nextConfig, JSON_OPTIONS);
+}
+/**
+* @description 写入自定义 CLI 路径配置
+*/
+async function createCustomConfig(params) {
+	const trimmedCliPath = params.cliPath.trim();
+	if (!trimmedCliPath) throw new Error("cliPath cannot be empty");
+	const normalizedCliPath = resolvePath(trimmedCliPath);
+	await writeCustomConfig({ cliPath: normalizedCliPath });
+	return normalizedCliPath;
+}
+/**
+* @description 写入语言配置（zh / en）。
+*/
+async function createLocaleConfig(locale) {
+	await writeCustomConfig({ locale });
+	return locale;
+}
+/**
+* @description 写入开发者工具自动预热配置。
+*/
+async function createAutoBootstrapDevtoolsConfig(value) {
+	await writeCustomConfig({ autoBootstrapDevtools: value });
+	return value;
+}
+/**
+* @description 写入项目自动信任配置。
+*/
+async function createAutoTrustProjectConfig(value) {
+	await writeCustomConfig({ autoTrustProject: value });
+	return value;
+}
+/**
+* @description 删除指定配置项。
+*/
+async function removeCustomConfigKey(key) {
+	const currentConfig = await readCustomConfig();
+	if (!(key in currentConfig)) return;
+	const nextConfig = { ...currentConfig };
+	delete nextConfig[key];
+	await writeCustomConfig(nextConfig, { replace: true });
+}
+/**
+* @description 覆盖写入配置内容（会替换原内容）。
+*/
+async function overwriteCustomConfig(config) {
+	const nextConfig = {};
+	if (typeof config.cliPath === "string" && config.cliPath.trim()) nextConfig.cliPath = resolvePath(config.cliPath.trim());
+	if (config.locale === "zh" || config.locale === "en") nextConfig.locale = config.locale;
+	if (typeof config.autoBootstrapDevtools === "boolean") nextConfig.autoBootstrapDevtools = config.autoBootstrapDevtools;
+	if (typeof config.autoTrustProject === "boolean") nextConfig.autoTrustProject = config.autoTrustProject;
+	await writeCustomConfig(nextConfig, { replace: true });
+}
+//#endregion
+//#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 官方微信开发者工具只支持 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/powershell.ts
+/** 固定重定向 stdout 的 UTF-8 编码，避免默认代码页损坏进程路径和安装身份。 */
+function withPowerShellUtf8Output(script) {
+	return `[Console]::OutputEncoding=[Text.UTF8Encoding]::new($false); ${script}`;
+}
+//#endregion
+//#region src/devtoolsTarget/metadata.ts
+const MAX_HEADER_BYTES = 16777216;
+const MAX_PACKAGE_BYTES = 1048576;
+function record(value) {
+	return !!value && typeof value === "object" && !Array.isArray(value);
+}
+async function readPackageFile(filePath) {
+	if ((await fs.stat(filePath)).size > MAX_PACKAGE_BYTES) throw new Error("DevTools package metadata exceeds the size limit.");
+	return JSON.parse(await fs.readFile(filePath, "utf8"));
+}
+/** 只读取归档目录和根 package.json，不执行宿主代码或解包其他文件。 */
+async function readAsarPackage(asarPath) {
+	const file = await fs.open(asarPath, "r");
+	try {
+		const stat = await file.stat();
+		const prefix = Buffer.alloc(16);
+		if ((await file.read(prefix, 0, prefix.length, 0)).bytesRead !== prefix.length) throw new Error("Invalid DevTools ASAR header.");
+		const headerSize = prefix.readUInt32LE(4);
+		const jsonSize = prefix.readUInt32LE(12);
+		if (prefix.readUInt32LE(0) !== 4 || prefix.readUInt32LE(8) + 4 !== headerSize || headerSize < 8 || headerSize > MAX_HEADER_BYTES || jsonSize > headerSize - 8 || headerSize + 8 > stat.size) throw new Error("Invalid DevTools ASAR header size.");
+		const header = Buffer.alloc(jsonSize);
+		if ((await file.read(header, 0, jsonSize, 16)).bytesRead !== jsonSize) throw new Error("Truncated DevTools ASAR header.");
+		const parsed = JSON.parse(header.toString("utf8"));
+		const entry = record(parsed) && record(parsed.files) ? parsed.files["package.json"] : void 0;
+		if (!record(entry) || entry.link !== void 0) throw new Error("DevTools ASAR has no direct package metadata.");
+		if (entry.unpacked === true) return await readPackageFile(path.join(`${asarPath}.unpacked`, "package.json"));
+		const size = entry.size;
+		const offset = typeof entry.offset === "string" && /^\d+$/.test(entry.offset) ? Number(entry.offset) : NaN;
+		const position = 8 + headerSize + offset;
+		if (typeof size !== "number" || !Number.isSafeInteger(size) || size < 0 || size > MAX_PACKAGE_BYTES || !Number.isSafeInteger(offset) || offset < 0 || !Number.isSafeInteger(position) || position + size > stat.size) throw new Error("Invalid DevTools ASAR package bounds.");
+		const content = Buffer.alloc(size);
+		if ((await file.read(content, 0, size, position)).bytesRead !== size) throw new Error("Truncated DevTools ASAR package metadata.");
+		return JSON.parse(content.toString("utf8"));
+	} finally {
+		await file.close();
+	}
+}
+/** 产品版本来自应用 package.json，不能使用外层 Electron 的版本。 */
+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 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+){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"
+	};
+}
+//#endregion
+//#region src/devtoolsTarget/profile.ts
+/** 按所选宿主的存储布局定位配置，不扫描其他安装的目录。 */
+function resolveWechatDevtoolsProfileDir(appPath, options = {}) {
+	const platform = options.platform ?? process.platform;
+	const homeDir = options.homeDir ?? os.homedir();
+	const baseDir = platform === "darwin" ? path.join(homeDir, "Library", "Application Support", "微信开发者工具") : platform === "win32" ? path.join(options.localAppDataDir ?? process.env.LOCALAPPDATA ?? path.join(homeDir, "AppData", "Local"), "微信开发者工具", "User Data") : path.join(process.env.XDG_CONFIG_HOME ?? path.join(homeDir, ".config"), "微信开发者工具");
+	if (platform === "win32" && path.basename(appPath) === "package.nw") return baseDir;
+	return path.join(baseDir, createHash("md5").update(appPath).digest("hex"));
+}
+//#endregion
+//#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 初始化；显式较小预算始终优先。 */
+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" ? 3e4 : 3e3;
+	return Math.min(timeout ?? maximum, maximum);
+}
+//#endregion
+//#region src/devtoolsTarget/host.ts
+function ownershipError(message) {
+	return Object.assign(new Error(message), { code: "WECHAT_DEVTOOLS_HOST_IDENTITY_MISMATCH" });
+}
+function normalize(value, platform) {
+	return (platform === "win32" ? value.replaceAll("\\", "/").toLowerCase() : value).replace(/\/$/, "");
+}
+/** 复用宿主归属检查的安装根规则，不能把 app.asar 当作可执行文件目录。 */
+function resolveWechatDevtoolsInstallationRoot(target, platform) {
+	const appPath = normalize(target.appPath, platform);
+	return platform === "darwin" ? appPath.split("/Contents/")[0] : appPath.replace(/\/(?:resources\/)?(?:app\.asar|app|package\.nw)$/, "");
+}
+function assertExecutable(target, executable, platform) {
+	const root = resolveWechatDevtoolsInstallationRoot(target, platform);
+	const selected = normalize(executable.trim(), platform);
+	if (!root || !selected.startsWith(`${root}/`)) throw ownershipError("The running WeChat DevTools host belongs to a different installation. Keep the selected installation running and retry; no host was stopped.");
+}
+async function runInspection(file, args, options) {
+	options.signal?.throwIfAborted();
+	try {
+		const timeout = resolveWechatInspectionTimeout(options.platform ?? process.platform, options.timeout);
+		const result = await execa(file, args, {
+			timeout,
+			cancelSignal: options.signal,
+			reject: false,
+			windowsHide: true
+		});
+		options.signal?.throwIfAborted();
+		return result;
+	} catch (cause) {
+		options.signal?.throwIfAborted();
+		throw Object.assign(ownershipError("Unable to verify the running WeChat DevTools installation."), { cause });
+	}
+}
+async function readUnixExecutable(pid, options) {
+	if ((options.platform ?? process.platform) === "linux") {
+		options.signal?.throwIfAborted();
+		try {
+			const executable = await fs.readlink(`/proc/${pid}/exe`);
+			options.signal?.throwIfAborted();
+			return executable;
+		} catch (cause) {
+			options.signal?.throwIfAborted();
+			if (cause.code === "ENOENT") return;
+			throw Object.assign(ownershipError("The running WeChat DevTools executable could not be verified through procfs."), { cause });
+		}
+	}
+	const result = await runInspection("ps", [
+		"-p",
+		String(pid),
+		"-o",
+		"comm="
+	], options);
+	if (result.exitCode === 1 && !result.stdout.trim()) return;
+	if (result.exitCode !== 0 || !result.stdout.trim()) throw ownershipError("The running WeChat DevTools process identity could not be verified.");
+	return result.stdout.trim();
+}
+async function readWindowsProcesses(script, options) {
+	const result = await runInspection("powershell.exe", [
+		"-NoProfile",
+		"-NonInteractive",
+		"-Command",
+		withPowerShellUtf8Output(script)
+	], options);
+	if (result.exitCode !== 0) throw ownershipError("Windows could not verify the WeChat DevTools process identity.");
+	let parsed;
+	try {
+		parsed = JSON.parse(result.stdout.trim() || "[]");
+	} catch (cause) {
+		throw Object.assign(ownershipError("Windows returned unreadable DevTools process identities."), { cause });
+	}
+	return (Array.isArray(parsed) ? parsed : [parsed]).map((value) => {
+		if (!value || typeof value !== "object") throw ownershipError("Windows returned an invalid DevTools process identity.");
+		const entry = value;
+		if (typeof entry.ProcessId !== "number" || !Number.isInteger(entry.ProcessId) || entry.ProcessId <= 0 || typeof entry.ExecutablePath !== "string" || !entry.ExecutablePath) throw ownershipError("Windows could not read the DevTools executable path.");
+		return {
+			pid: entry.ProcessId,
+			executable: entry.ExecutablePath
+		};
+	});
+}
+/** 启动前验证共享宿主身份；无活跃宿主可以继续，其他安装不得被隐式接管。 */
+async function assertWechatDevtoolsHost(target, options = {}) {
+	options.signal?.throwIfAborted();
+	const platform = options.platform ?? process.platform;
+	if (platform === "win32") {
+		const entries = await readWindowsProcesses("@(Get-CimInstance Win32_Process -Filter \"Name='wechatdevtools.exe' OR Name='wechatwebdevtools.exe'\" | Select-Object ProcessId,ExecutablePath) | ConvertTo-Json -Compress", options);
+		for (const entry of entries) assertExecutable(target, entry.executable, platform);
+		return;
+	}
+	for (const directory of /* @__PURE__ */ new Set([path.dirname(target.profileDir), target.profileDir])) {
+		let link;
+		try {
+			link = await fs.readlink(path.join(directory, "SingletonLock"));
+		} catch (error) {
+			if (error.code === "ENOENT") continue;
+			throw ownershipError("The shared DevTools host lock could not be verified.");
+		}
+		const match = /-(\d+)$/.exec(link);
+		if (!match) throw ownershipError("The shared DevTools host lock has an unknown owner.");
+		const executable = await readUnixExecutable(Number(match[1]), options);
+		if (executable) assertExecutable(target, executable, platform);
+	}
+}
+/** HTTP 与 WebSocket 的显式端口均需由所选安装持有，端口号本身不是宿主身份。 */
+async function assertWechatDevtoolsPort(target, port, options = {}) {
+	if (!Number.isInteger(port) || port < 1 || port > 65535) throw new Error("Invalid WeChat DevTools port.");
+	options.signal?.throwIfAborted();
+	const platform = options.platform ?? process.platform;
+	if (platform === "win32") {
+		const entries = await readWindowsProcesses(`$ErrorActionPreference='Stop'; @(Get-NetTCPConnection -LocalPort ${port} -State Listen | Select-Object -ExpandProperty OwningProcess -Unique | ForEach-Object { Get-CimInstance Win32_Process -Filter "ProcessId=$_" } | Select-Object ProcessId,ExecutablePath) | ConvertTo-Json -Compress`, options);
+		if (!entries.length) throw ownershipError("No verified WeChat DevTools listener owns the selected port.");
+		for (const entry of entries) assertExecutable(target, entry.executable, platform);
+		return;
+	}
+	const result = await runInspection("lsof", [
+		"-nP",
+		`-iTCP:${port}`,
+		"-sTCP:LISTEN",
+		"-Fp"
+	], options);
+	const pids = [...new Set(result.stdout.split(/\r?\n/).filter((line) => /^p\d+$/.test(line)).map((line) => Number(line.slice(1))))];
+	if (result.exitCode !== 0 || !pids.length) throw ownershipError("No verified WeChat DevTools listener owns the selected port.");
+	for (const pid of pids) {
+		const executable = await readUnixExecutable(pid, options);
+		if (!executable) throw ownershipError("The selected DevTools listener exited before its identity could be verified.");
+		assertExecutable(target, executable, platform);
+	}
+}
+//#endregion
+//#region src/devtoolsTarget/index.ts
+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;
+}
+/** 每次操作只解析一次安装，显式选择覆盖继承的配置但不写回全局设置。 */
+async function resolveWechatDevtoolsTarget(options = {}) {
+	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
+		};
+	}
+	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,
+		path.resolve(options.projectPath),
+		options.sessionId?.trim() || null,
+		options.port || null
+	]);
+	return path.join(SESSION_DIRECTORY, `${createHash("sha256").update(key).digest("hex")}.json`);
+}
+/** 只保存所选安装的端点，不覆盖其他安装或旧版会话记录。 */
+async function persistAutomatorSession(options) {
+	options.signal?.throwIfAborted();
+	const filePath = resolveAutomatorSessionFilePath(options);
+	const payload = {
+		installationId: options.installationId,
+		...options.port ? { port: options.port } : {},
+		projectPath: path.resolve(options.projectPath),
+		...options.sessionId ? { sessionId: options.sessionId } : {},
+		updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+		wsEndpoint: options.wsEndpoint
+	};
+	await fs.mkdir(path.dirname(filePath), { recursive: true });
+	options.signal?.throwIfAborted();
+	await fs.writeFile(filePath, JSON.stringify(payload, null, 2), {
+		encoding: "utf8",
+		signal: options.signal
+	});
+}
+async function readSessionFile(filePath, options) {
+	try {
+		const raw = await fs.readFile(filePath, "utf8");
+		const payload = JSON.parse(raw);
+		if (!payload || typeof payload !== "object") return null;
+		const session = payload;
+		if (session.installationId !== options.installationId || session.projectPath !== path.resolve(options.projectPath)) return null;
+		if (options.sessionId && session.sessionId !== options.sessionId || options.port && session.port !== options.port) return null;
+		if (typeof session.wsEndpoint !== "string") return null;
+		const endpoint = new URL(session.wsEndpoint);
+		if (endpoint.protocol !== "ws:" || endpoint.hostname !== "127.0.0.1" || !endpoint.port || options.port && Number(endpoint.port) !== options.port) return null;
+		return session;
+	} catch {
+		return null;
+	}
+}
+/** 未携带安装身份、身份冲突或端口不符的缓存均不可用于连接。 */
+async function readPersistedAutomatorSession(options) {
+	const direct = await readSessionFile(resolveAutomatorSessionFilePath(options), options);
+	if (direct || !options.sessionId || options.port) return direct;
+	try {
+		const entries = await fs.readdir(SESSION_DIRECTORY);
+		const matches = [];
+		for (const entry of entries) {
+			if (!entry.endsWith(".json")) continue;
+			const session = await readSessionFile(path.join(SESSION_DIRECTORY, entry), options);
+			if (session) matches.push(session);
+		}
+		return matches.length === 1 ? matches[0] : null;
+	} catch {
+		return null;
+	}
+}
+//#endregion
+//#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 };