weapp-ide-cli 6.1.8 → 6.2.0

package/dist/sessionStore-zdzy2UFM.js

@@ -0,0 +1,605 @@
+import path from "node:path";
+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 { 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 解析为绝对路径（基于当前工作目录）
+*/
+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/config/resolver.ts
+function isCustomConfigJson(value) {
+	return typeof value === "object" && value !== null;
+}
+/**
+* @description 解析开发者工具自动预热相关配置的最终生效值。
+*/
+function resolveDevtoolsAutomationDefaults(config) {
+	return {
+		autoBootstrapDevtools: config.autoBootstrapDevtools ?? true,
+		autoTrustProject: config.autoTrustProject ?? false
+	};
+}
+/**
+* @description 读取并解析 CLI 配置（进程选择优先，其次用户配置与平台默认）
+*/
+async function getConfig() {
+	const selectedCliPath = process.env.WEAPP_IDE_CLI_PATH?.trim();
+	if (await fs$1.pathExists(defaultCustomConfigFilePath)) try {
+		const rawConfig = await fs$1.readJSON(defaultCustomConfigFilePath);
+		const config = isCustomConfigJson(rawConfig) ? rawConfig : {};
+		const cliPath = typeof config.cliPath === "string" ? config.cliPath.trim() : "";
+		const locale = config.locale === "zh" || config.locale === "en" ? config.locale : void 0;
+		const autoBootstrapDevtools = typeof config.autoBootstrapDevtools === "boolean" ? config.autoBootstrapDevtools : void 0;
+		const autoTrustProject = typeof config.autoTrustProject === "boolean" ? config.autoTrustProject : void 0;
+		if (selectedCliPath || cliPath) {
+			logger.info(`全局配置文件路径：${colors.green(defaultCustomConfigFilePath)}`);
+			logger.info(`${selectedCliPath ? "进程指定" : "自定义"} CLI 路径：${colors.green(selectedCliPath || cliPath)}`);
+			return {
+				cliPath: selectedCliPath || cliPath,
+				locale,
+				autoBootstrapDevtools,
+				autoTrustProject,
+				source: selectedCliPath ? "environment" : "custom"
+			};
+		}
+		logger.warn("自定义配置文件缺少有效的 CLI 路径，将尝试使用默认路径。");
+	} catch (error) {
+		const reason = error instanceof Error ? error.message : String(error);
+		logger.warn(`解析自定义配置失败，${selectedCliPath ? "继续使用进程指定路径" : "将尝试使用默认路径"}。原因：${reason}`);
+	}
+	if (selectedCliPath) return {
+		cliPath: selectedCliPath,
+		source: "environment"
+	};
+	const fallbackPath = await getDefaultCliPath();
+	if (fallbackPath) return {
+		cliPath: fallbackPath,
+		locale: void 0,
+		autoBootstrapDevtools: void 0,
+		autoTrustProject: void 0,
+		source: "default"
+	};
+	return {
+		cliPath: "",
+		locale: void 0,
+		autoBootstrapDevtools: void 0,
+		autoTrustProject: void 0,
+		source: "missing"
+	};
+}
+/**
+* @description 获取用户配置的语言偏好。
+*/
+async function getConfiguredLocale() {
+	return (await readCustomConfig()).locale;
+}
+//#endregion
+//#region src/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 new Error("The selected application metadata does not identify WeChat DevTools.");
+	return {
+		version: typeof value.version === "string" && /^\d+\.\d+\.\d+$/.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/utils/powershell.ts
+/** 固定重定向 stdout 的 UTF-8 编码，避免默认代码页损坏进程路径和安装身份。 */
+function withPowerShellUtf8Output(script) {
+	return `[Console]::OutputEncoding=[Text.UTF8Encoding]::new($false); ${script}`;
+}
+//#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" ? 1e4 : 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) {
+	const normalized = value.replaceAll("\\", "/").replace(/\/$/, "");
+	return platform === "win32" ? normalized.toLowerCase() : normalized;
+}
+/** 复用宿主归属检查的安装根规则，不能把 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
+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.");
+}
+/** 一次解析 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;
+	}
+	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
+	};
+}
+//#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
+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 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "weapp-ide-cli",
   "type": "module",
-  "version": "6.1.8",
+  "version": "6.2.0",
   "description": "Command-line tools for automating WeChat DevTools and mini-program projects.",
   "author": "ice breaker <1324318532@qq.com>",
   "license": "MIT",
@@ -64,20 +64,20 @@
     "registry": "https://registry.npmjs.org"
   },
   "dependencies": {
-    "@modelcontextprotocol/server": "^2.0.0",
-    "@weapp-core/logger": "3.1.7",
-    "@weapp-core/shared": "3.2.6",
-    "@weapp-vite/devtools-runtime": "0.4.23",
-    "@weapp-vite/miniprogram-automator": "1.2.22",
-    "cac": "^7.0.0",
-    "execa": "10.0.1",
+    "@modelcontextprotocol/server": "^2.3.1",
+    "@weapp-core/logger": "3.1.9",
+    "@weapp-core/shared": "3.2.8",
+    "@weapp-vite/devtools-runtime": "0.5.0",
+    "@weapp-vite/miniprogram-automator": "1.3.0",
+    "cac": "^7.0.1",
+    "execa": "10.1.0",
     "pathe": "^2.0.3",
     "pixelmatch": "^7.2.0",
     "pngjs": "^7.0.0",
     "zod": "^4.6.5"
   },
   "devDependencies": {
-    "@types/node": "^26.6.2"
+    "@types/node": "^26.6.4"
   },
   "tsd": {
     "compilerOptions": {
@@ -91,11 +91,12 @@
     "release": "node scripts/release.js",
     "test:dev": "vitest",
     "test": "vitest run",
-    "test:types": "pnpm build && tsd --files \"test-d/**/*.test-d.ts\"",
+    "test:types": "pnpm build && pnpm run test:types:check",
+    "test:types:check": "tsd --files \"test-d/**/*.test-d.ts\"",
     "typecheck": "tsc --noEmit",
     "weapp": "tsx src/cli.ts",
     "debug": "tsx src/cli.ts config",
     "raw": "node bin/weapp.js",
-    "sync": "cnpm sync weapp-ide-cli"
+    "sync": "repo release sync-npmmirror --package weapp-ide-cli"
   }
 }