weapp-ide-cli 6.1.9 → 6.3.0

package/dist/index.js

@@ -1,5 +1,8 @@
-import { $ as createAutoTrustProjectConfig, A as getAutomatorProtocolTimeoutMethod, B as bootstrapWechatDevtoolsSettings, C as runWithSuspendedSharedInput, F as isDevtoolsExtensionContextInvalidatedError, G as resolveDevtoolsAutomationDefaults, H as resolveCliPath, I as isDevtoolsHttpPortError, J as isOperatingSystemSupported, K as SupportedPlatformsMap, L as isRetryableAutomatorLaunchError, M as isAutomatorPortInUseError, N as isAutomatorProtocolTimeoutError, O as connectOpenedAutomator, P as isAutomatorWsConnectError, Q as createAutoBootstrapDevtoolsConfig, R as launchAutomator, S as createSharedInputSession, U as getConfig, V as detectWechatDevtoolsServicePort, W as getConfiguredLocale, Y as operatingSystemName, _ as isWechatIdeLoginRequiredError, a as connectMiniProgram, at as defaultCustomConfigDirPath, b as promptWechatIdeLoginRetry, c as withMiniProgram, d as RETRY_CONFIRM_KEYS, et as createCustomConfig, f as RETRY_PROMPT_INITIAL_IGNORE_MS, g as formatWechatIdeLoginRequiredError, h as formatRetryHotkeyPrompt, it as removeCustomConfigKey, j as isAutomatorLoginError, k as formatAutomatorLoginError, l as runRetryableCommand, m as extractExecutionErrorText, n as acquireSharedMiniProgram, nt as overwriteCustomConfig, o as getSharedMiniProgramSessionCount, ot as defaultCustomConfigFilePath, p as createWechatIdeLoginRequiredExitError, q as getDefaultCliPath, r as closeSharedMiniProgram, rt as readCustomConfig, s as releaseSharedMiniProgram, st as resolvePath, tt as createLocaleConfig, u as RETRY_CANCEL_KEYS, v as isWechatIdeLoginRequiredExitError, w as waitForExclusiveKeypress, x as waitForRetryKeypress, y as promptRetryKeypress, z as resolveProjectAutomatorPort } from "./automator-session-fbanL2eW.js";
-import { $ as getRuntimeWechatDevtoolsServicePort, A as isWechatIdeLoggedIn, C as clearWechatIdeCache, D as getWechatIdeTestAccounts, E as compileWechatIdeByAutomator, F as quitWechatIde, G as transformArgv, H as execute, I as refreshWechatIdeTicket, J as openWechatIdeProjectByHttp, K as promptForCliPath, L as resetWechatIdeFileUtils, M as openWechatIde, N as openWechatIdeOtherProject, O as getWechatIdeTicket, P as previewWechatIde, Q as startWechatIdeEngineBuildByHttp, R as setWechatIdeTicket, S as buildWechatIdeNpm, T as closeWechatIdeProject, U as createAlias, V as runWechatCliWithRetry, W as createPathCompat, X as requestWechatDevtoolsHttp, Y as pollWechatIdeEngineBuildResultByHttp, Z as resetWechatIdeFileUtilsByHttp, _ as autoPreviewWechatIde, a as navigateBack, b as buildWechatIdeApk, c as pageStack, d as remote, et as setRuntimeWechatDevtoolsServicePort, f as scrollTo, g as tap, h as takeScreenshot, i as input, it as removeOption, j as loginWechatIde, k as getWechatIdeToolInfo, l as reLaunch, m as systemInfo, n as captureScreenshotBuffer, nt as readBooleanOption, o as navigateTo, p as switchTab, q as WECHAT_DEVTOOLS_ENGINE_BUILD_STATUSES, r as currentPage, rt as readOptionValue, s as pageData, t as audit, tt as parseAutomatorArgs, u as redirectTo, v as autoReplayWechatIde, w as clearWechatIdeCacheByAutomator, x as buildWechatIdeIpa, y as autoWechatIde, z as uploadWechatIde } from "./commands-__RJ552L.js";
-import { C as parseCompareArgs, S as printScreenshotHelp, _ as AUTOMATOR_COMMAND_NAMES, a as runMinidev, b as runAutomatorCommand, c as runWechatIdeEngineBuild, d as CONFIG_COMMAND_NAME, f as MCP_COMMAND_NAME, g as isWeappIdeTopLevelCommand, h as WECHAT_CLI_COMMAND_NAMES, i as validateWechatCliCommandArgs, l as runWechatIdeEngineBuildByHttp, m as WEAPP_IDE_TOP_LEVEL_COMMAND_NAMES, n as parse, o as startForwardConsole, p as MINIDEV_NAMESPACE_COMMAND_NAMES, r as dispatchWechatCliCommand, s as isWechatIdeEngineBuildEndpointMissingError, t as createCli, u as handleConfigCommand, v as getAutomatorCommandHelp, w as printCompareHelp, x as parseScreenshotArgs, y as isAutomatorCommand } from "./cli-2sY1sAVq.js";
-import { a as readElementSnapshot, i as registerWeappIdeMcpTools, n as startWeappIdeMcpServer, o as resolveProjectPath, r as createWeappIdeMcpServer, s as toSerializableValue, t as runMcpCommand } from "./run-mcp-LqaWlQJ_.js";
-export { AUTOMATOR_COMMAND_NAMES, CONFIG_COMMAND_NAME, MCP_COMMAND_NAME, MINIDEV_NAMESPACE_COMMAND_NAMES, RETRY_CANCEL_KEYS, RETRY_CONFIRM_KEYS, RETRY_PROMPT_INITIAL_IGNORE_MS, SupportedPlatformsMap, WEAPP_IDE_TOP_LEVEL_COMMAND_NAMES, WECHAT_CLI_COMMAND_NAMES, WECHAT_DEVTOOLS_ENGINE_BUILD_STATUSES, acquireSharedMiniProgram, audit, autoPreviewWechatIde, autoReplayWechatIde, autoWechatIde, bootstrapWechatDevtoolsSettings, buildWechatIdeApk, buildWechatIdeIpa, buildWechatIdeNpm, captureScreenshotBuffer, clearWechatIdeCache, clearWechatIdeCacheByAutomator, closeSharedMiniProgram, closeWechatIdeProject, compileWechatIdeByAutomator, connectMiniProgram, connectOpenedAutomator, createAlias, createAutoBootstrapDevtoolsConfig, createAutoTrustProjectConfig, createCli, createCustomConfig, createLocaleConfig, createPathCompat, createSharedInputSession, createWeappIdeMcpServer, createWechatIdeLoginRequiredExitError, currentPage, defaultCustomConfigDirPath, defaultCustomConfigFilePath, detectWechatDevtoolsServicePort, dispatchWechatCliCommand, execute, extractExecutionErrorText, formatAutomatorLoginError, formatRetryHotkeyPrompt, formatWechatIdeLoginRequiredError, getAutomatorCommandHelp, getAutomatorProtocolTimeoutMethod, getConfig, getConfiguredLocale, getDefaultCliPath, getRuntimeWechatDevtoolsServicePort, getSharedMiniProgramSessionCount, getWechatIdeTestAccounts, getWechatIdeTicket, getWechatIdeToolInfo, handleConfigCommand, input, isAutomatorCommand, isAutomatorLoginError, isAutomatorPortInUseError, isAutomatorProtocolTimeoutError, isAutomatorWsConnectError, isDevtoolsExtensionContextInvalidatedError, isDevtoolsHttpPortError, isOperatingSystemSupported, isRetryableAutomatorLaunchError, isWeappIdeTopLevelCommand, isWechatIdeEngineBuildEndpointMissingError, isWechatIdeLoggedIn, isWechatIdeLoginRequiredError, isWechatIdeLoginRequiredExitError, launchAutomator, loginWechatIde, navigateBack, navigateTo, openWechatIde, openWechatIdeOtherProject, openWechatIdeProjectByHttp, operatingSystemName, overwriteCustomConfig, pageData, pageStack, parse, parseAutomatorArgs, parseCompareArgs, parseScreenshotArgs, pollWechatIdeEngineBuildResultByHttp, previewWechatIde, printCompareHelp, printScreenshotHelp, promptForCliPath, promptRetryKeypress, promptWechatIdeLoginRetry, quitWechatIde, reLaunch, readBooleanOption, readCustomConfig, readElementSnapshot, readOptionValue, redirectTo, refreshWechatIdeTicket, registerWeappIdeMcpTools, releaseSharedMiniProgram, remote, removeCustomConfigKey, removeOption, requestWechatDevtoolsHttp, resetWechatIdeFileUtils, resetWechatIdeFileUtilsByHttp, resolveCliPath, resolveDevtoolsAutomationDefaults, resolvePath, resolveProjectAutomatorPort, resolveProjectPath, runAutomatorCommand, runMcpCommand, runMinidev, runRetryableCommand, runWechatCliWithRetry, runWechatIdeEngineBuild, runWechatIdeEngineBuildByHttp, runWithSuspendedSharedInput, scrollTo, setRuntimeWechatDevtoolsServicePort, setWechatIdeTicket, startForwardConsole, startWeappIdeMcpServer, startWechatIdeEngineBuildByHttp, switchTab, systemInfo, takeScreenshot, tap, toSerializableValue, transformArgv, uploadWechatIde, validateWechatCliCommandArgs, waitForExclusiveKeypress, waitForRetryKeypress, withMiniProgram };
+import { A as operatingSystemName, B as removeCustomConfigKey, C as registerWechatDevtoolsInstallation, D as SupportedPlatformsMap, F as createAutoTrustProjectConfig, H as defaultCustomConfigFilePath, I as createCustomConfig, L as createLocaleConfig, O as getDefaultCliPath, P as createAutoBootstrapDevtoolsConfig, R as overwriteCustomConfig, U as resolvePath, V as defaultCustomConfigDirPath, _ as WECHAT_DEVTOOLS_OFFICIAL_CHANNELS_URL, b as compareWechatDevtoolsVersions, c as getActiveWechatDevtoolsTarget, d as validateWechatDevtoolsSelection, f as withWechatDevtoolsSelection, k as isOperatingSystemSupported, l as readWechatDevtoolsSelectionEnvironment, m as assertWechatDevtoolsPort, o as MANAGED_PROJECT_JOURNAL_ENV, p as assertWechatDevtoolsHost, s as MANAGED_PROJECT_MAX_WINDOWS_ENV, u as resolveWechatDevtoolsTarget, v as assertOfficialWechatDevtoolsVersion, w as unregisterWechatDevtoolsInstallation, x as listWechatDevtoolsInstallations, y as readOfficialWechatDevtoolsVersion, z as readCustomConfig } from "./automatorProject-DjYLqMj6.js";
+import { a as isManagedWechatProjectFullyReleased, i as recoverManagedWechatProjectsAfterInstallationExit, m as startWechatIdeAgent, n as cleanupManagedWechatProjects, r as closeManagedWechatProject, s as readManagedWechatProjectRecords, t as beginManagedWechatProject } from "./devtoolsProjectOwnership-BMfSAg4n.js";
+import { A as waitForExclusiveKeypress, C as isWechatIdeLoginRequiredError, D as waitForRetryKeypress, E as promptWechatIdeLoginRetry, O as createSharedInputSession, P as resolveAutomatorSessionOptions, S as formatWechatIdeLoginRequiredError, T as promptRetryKeypress, _ as RETRY_CONFIRM_KEYS, a as bootstrapWechatDevtoolsSettings, b as extractExecutionErrorText, c as getAutomatorProtocolTimeoutMethod, d as isAutomatorProtocolTimeoutError, f as isAutomatorWsConnectError, g as RETRY_CANCEL_KEYS, h as isRetryableAutomatorLaunchError, i as resolveProjectAutomatorPort, k as runWithSuspendedSharedInput, l as isAutomatorLoginError, m as isDevtoolsHttpPortError, n as launchAutomator, o as detectWechatDevtoolsServicePort, p as isDevtoolsExtensionContextInvalidatedError, r as persistOpenedAutomatorSession, s as formatAutomatorLoginError, t as connectOpenedAutomator, u as isAutomatorPortInUseError, v as RETRY_PROMPT_INITIAL_IGNORE_MS, w as isWechatIdeLoginRequiredExitError, x as formatRetryHotkeyPrompt, y as createWechatIdeLoginRequiredExitError } from "./automator-BOe32upt.js";
+import { $ as getConfig, A as queryWechatIdeLogin, B as WECHAT_DEVTOOLS_ENGINE_BUILD_STATUSES, C as refreshWechatIdeTicket, D as validateWechatCliCommandArgs, E as uploadWechatIde, F as startForwardConsole, G as startWechatIdeEngineBuildByHttp, H as pollWechatIdeEngineBuildResultByHttp, I as isWechatIdeEngineBuildEndpointMissingError, J as splitWechatDevtoolsSelectionArgs, K as getRuntimeWechatDevtoolsServicePort, L as prepareAcceptanceProject, M as createAlias, N as createPathCompat, O as runWechatCliWithRetry, P as transformArgv, Q as promptForCliPath, R as runWechatIdeEngineBuild, S as quitWechatIde, T as setWechatIdeTicket, U as requestWechatDevtoolsHttp, V as openWechatIdeProjectByHttp, W as resetWechatIdeFileUtilsByHttp, X as handleConfigCommand, Y as withWechatDevtoolsSelectionArgs, Z as resolveCliPath, _ as isWechatIdeLoggedIn, _t as readBooleanOption, a as autoReplayWechatIde, at as WEAPP_IDE_TOP_LEVEL_COMMAND_NAMES, b as openWechatIdeOtherProject, c as buildWechatIdeIpa, ct as AUTOMATOR_COMMAND_NAMES, d as clearWechatIdeCacheByAutomator, dt as runAutomatorCommand, et as getConfiguredLocale, f as closeWechatIdeProject, ft as parseScreenshotArgs, g as getWechatIdeToolInfo, gt as parseAutomatorArgs, h as getWechatIdeTicket, ht as printCompareHelp, i as autoPreviewWechatIde, it as MINIDEV_NAMESPACE_COMMAND_NAMES, j as execute, k as runMinidev, l as buildWechatIdeNpm, lt as getAutomatorCommandHelp, m as getWechatIdeTestAccounts, mt as parseCompareArgs, n as parse, nt as CONFIG_COMMAND_NAME, o as autoWechatIde, ot as WECHAT_CLI_COMMAND_NAMES, p as compileWechatIdeByAutomator, pt as printScreenshotHelp, q as setRuntimeWechatDevtoolsServicePort, r as dispatchWechatCliCommand, rt as MCP_COMMAND_NAME, s as buildWechatIdeApk, st as isWeappIdeTopLevelCommand, t as createCli, tt as resolveDevtoolsAutomationDefaults, u as clearWechatIdeCache, ut as isAutomatorCommand, v as loginWechatIde, vt as readOptionValue, w as resetWechatIdeFileUtils, x as previewWechatIde, y as openWechatIde, yt as removeOption, z as runWechatIdeEngineBuildByHttp } from "./cli-CFlqFpIw.js";
+import { c as releaseSharedMiniProgram, i as closeSharedMiniProgram, l as withMiniProgram, n as acquireSharedMiniProgram, o as connectMiniProgram, s as getSharedMiniProgramSessionCount, u as runRetryableCommand } from "./automator-session-VOB03glx.js";
+import { a as navigateBack, c as pageStack, d as remote, f as scrollTo, g as tap, h as takeScreenshot, i as input, l as reLaunch, m as systemInfo, n as captureScreenshotBuffer, o as navigateTo, p as switchTab, r as currentPage, s as pageData, t as audit, u as redirectTo } from "./commands-mslf7-sP.js";
+import { a as readElementSnapshot, i as registerWeappIdeMcpTools, n as startWeappIdeMcpServer, o as resolveProjectPath, r as createWeappIdeMcpServer, s as toSerializableValue, t as runMcpCommand } from "./run-mcp-Ni139Z5C.js";
+export { AUTOMATOR_COMMAND_NAMES, CONFIG_COMMAND_NAME, MANAGED_PROJECT_JOURNAL_ENV, MANAGED_PROJECT_MAX_WINDOWS_ENV, MCP_COMMAND_NAME, MINIDEV_NAMESPACE_COMMAND_NAMES, RETRY_CANCEL_KEYS, RETRY_CONFIRM_KEYS, RETRY_PROMPT_INITIAL_IGNORE_MS, SupportedPlatformsMap, WEAPP_IDE_TOP_LEVEL_COMMAND_NAMES, WECHAT_CLI_COMMAND_NAMES, WECHAT_DEVTOOLS_ENGINE_BUILD_STATUSES, WECHAT_DEVTOOLS_OFFICIAL_CHANNELS_URL, acquireSharedMiniProgram, assertOfficialWechatDevtoolsVersion, assertWechatDevtoolsHost, assertWechatDevtoolsPort, audit, autoPreviewWechatIde, autoReplayWechatIde, autoWechatIde, beginManagedWechatProject, bootstrapWechatDevtoolsSettings, buildWechatIdeApk, buildWechatIdeIpa, buildWechatIdeNpm, captureScreenshotBuffer, cleanupManagedWechatProjects, clearWechatIdeCache, clearWechatIdeCacheByAutomator, closeManagedWechatProject, closeSharedMiniProgram, closeWechatIdeProject, compareWechatDevtoolsVersions, compileWechatIdeByAutomator, connectMiniProgram, connectOpenedAutomator, createAlias, createAutoBootstrapDevtoolsConfig, createAutoTrustProjectConfig, createCli, createCustomConfig, createLocaleConfig, createPathCompat, createSharedInputSession, createWeappIdeMcpServer, createWechatIdeLoginRequiredExitError, currentPage, defaultCustomConfigDirPath, defaultCustomConfigFilePath, detectWechatDevtoolsServicePort, dispatchWechatCliCommand, execute, extractExecutionErrorText, formatAutomatorLoginError, formatRetryHotkeyPrompt, formatWechatIdeLoginRequiredError, getActiveWechatDevtoolsTarget, getAutomatorCommandHelp, getAutomatorProtocolTimeoutMethod, getConfig, getConfiguredLocale, getDefaultCliPath, getRuntimeWechatDevtoolsServicePort, getSharedMiniProgramSessionCount, getWechatIdeTestAccounts, getWechatIdeTicket, getWechatIdeToolInfo, handleConfigCommand, input, isAutomatorCommand, isAutomatorLoginError, isAutomatorPortInUseError, isAutomatorProtocolTimeoutError, isAutomatorWsConnectError, isDevtoolsExtensionContextInvalidatedError, isDevtoolsHttpPortError, isManagedWechatProjectFullyReleased, isOperatingSystemSupported, isRetryableAutomatorLaunchError, isWeappIdeTopLevelCommand, isWechatIdeEngineBuildEndpointMissingError, isWechatIdeLoggedIn, isWechatIdeLoginRequiredError, isWechatIdeLoginRequiredExitError, launchAutomator, listWechatDevtoolsInstallations, loginWechatIde, navigateBack, navigateTo, openWechatIde, openWechatIdeOtherProject, openWechatIdeProjectByHttp, operatingSystemName, overwriteCustomConfig, pageData, pageStack, parse, parseAutomatorArgs, parseCompareArgs, parseScreenshotArgs, persistOpenedAutomatorSession, pollWechatIdeEngineBuildResultByHttp, prepareAcceptanceProject, previewWechatIde, printCompareHelp, printScreenshotHelp, promptForCliPath, promptRetryKeypress, promptWechatIdeLoginRetry, queryWechatIdeLogin, quitWechatIde, reLaunch, readBooleanOption, readCustomConfig, readElementSnapshot, readManagedWechatProjectRecords, readOfficialWechatDevtoolsVersion, readOptionValue, readWechatDevtoolsSelectionEnvironment, recoverManagedWechatProjectsAfterInstallationExit, redirectTo, refreshWechatIdeTicket, registerWeappIdeMcpTools, registerWechatDevtoolsInstallation, releaseSharedMiniProgram, remote, removeCustomConfigKey, removeOption, requestWechatDevtoolsHttp, resetWechatIdeFileUtils, resetWechatIdeFileUtilsByHttp, resolveAutomatorSessionOptions, resolveCliPath, resolveDevtoolsAutomationDefaults, resolvePath, resolveProjectAutomatorPort, resolveProjectPath, resolveWechatDevtoolsTarget, runAutomatorCommand, runMcpCommand, runMinidev, runRetryableCommand, runWechatCliWithRetry, runWechatIdeEngineBuild, runWechatIdeEngineBuildByHttp, runWithSuspendedSharedInput, scrollTo, setRuntimeWechatDevtoolsServicePort, setWechatIdeTicket, splitWechatDevtoolsSelectionArgs, startForwardConsole, startWeappIdeMcpServer, startWechatIdeAgent, startWechatIdeEngineBuildByHttp, switchTab, systemInfo, takeScreenshot, tap, toSerializableValue, transformArgv, unregisterWechatDevtoolsInstallation, uploadWechatIde, validateWechatCliCommandArgs, validateWechatDevtoolsSelection, waitForExclusiveKeypress, waitForRetryKeypress, withMiniProgram, withWechatDevtoolsSelection, withWechatDevtoolsSelectionArgs };

package/dist/managed-B04Xo9U_.js

@@ -0,0 +1,264 @@
+import { i as persistAutomatorSession, m as assertWechatDevtoolsPort, n as readAutomatorProjectPlan, t as populateAutomatorProjectSnapshot } from "./automatorProject-DjYLqMj6.js";
+import { m as startWechatIdeAgent, t as beginManagedWechatProject } from "./devtoolsProjectOwnership-BMfSAg4n.js";
+import path from "node:path";
+import { withMachineE2ELease } from "@weapp-vite/devtools-runtime";
+import { execa } from "execa";
+import fs from "node:fs/promises";
+import process from "node:process";
+import { acquireAutomatorPortLease } from "@weapp-vite/miniprogram-automator";
+//#region src/cli/projectImport.ts
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** 使用同一安装的 skill 入口；Windows 由 execa 处理官方 cmd 包装器。 */
+function resolveProjectImportCli(cliPath, platform = process.platform) {
+	const paths = platform === "win32" ? path.win32 : path.posix;
+	return paths.join(paths.dirname(cliPath), platform === "win32" ? "wechatide.cmd" : "wechatide");
+}
+/** 官方导入会重写项目根、条件页和基础库选择；窗口启动前恢复原始输入。 */
+async function preserveProjectConfig(projectPath, fileName, run) {
+	const file = path.join(projectPath, fileName);
+	const original = await fs.readFile(file).catch((error) => {
+		if (error.code !== "ENOENT") throw error;
+	});
+	let failure;
+	let failed = false;
+	try {
+		await run();
+	} catch (error) {
+		failure = error;
+		failed = true;
+	}
+	try {
+		if (original) {
+			if (!(await fs.readFile(file).catch((error) => {
+				if (error.code !== "ENOENT") throw error;
+			}))?.equals(original)) await fs.writeFile(file, original);
+		} else await fs.rm(file, { force: true });
+	} catch (error) {
+		if (failed) throw new AggregateError([failure, error], "Official import failed and fixture config restoration did not complete");
+		throw error;
+	}
+	if (failed) throw failure;
+}
+/** 先完成官方项目导入，再启动受管窗口；导入不编译、不导航，也不修改私有能力记录。 */
+async function importManagedDevtoolsProject(options) {
+	if (!options.trusted || !process.env["WEAPP_IDE_MANAGED_PROJECT_JOURNAL"]) return;
+	options.signal.throwIfAborted();
+	const projectPath = path.resolve(options.projectPath);
+	await withMachineE2ELease(() => preserveProjectConfig(projectPath, "project.config.json", () => preserveProjectConfig(projectPath, "project.private.config.json", async () => {
+		options.signal.throwIfAborted();
+		const { stdout } = await execa(resolveProjectImportCli(options.cliPath), [
+			"-c",
+			"weapp-vite-e2e",
+			"project_import",
+			"--project",
+			projectPath
+		], {
+			timeout: options.timeout,
+			cancelSignal: options.signal,
+			killDescendants: false
+		});
+		const payload = JSON.parse(stdout);
+		const result = isRecord(payload) && isRecord(payload.result) ? payload.result : void 0;
+		if (!isRecord(payload) || payload.ok !== true || payload.tool !== "project_import" || payload.clientName !== "weapp-vite-e2e" || result?.success !== true || result.projectPath !== projectPath || typeof result.alreadyImported !== "boolean" || result.taskId !== void 0 || result.status !== void 0 || result.error !== void 0) throw new Error("DEVTOOLS_PROJECT_IMPORT_INCOMPLETE: 官方项目导入未完成；请检查本地 weapp-vite-e2e 客户端授权与导入结果，未启动项目窗口。");
+		options.signal.throwIfAborted();
+	})));
+}
+//#endregion
+//#region src/cli/automator/managed.ts
+/** 受管启动持有完整窗口回执，快照始终由持久 journal 持有。 */
+async function launchManagedAutomator(options) {
+	const { launcher, scope, target, sourceProjectPath, port } = options;
+	let projectPath = options.projectPath;
+	let portLease;
+	let intent;
+	let program;
+	let allowCleanup;
+	const acquisitionSettled = new Promise((resolve) => {
+		allowCleanup = resolve;
+	});
+	let cleaning;
+	const cleanupLaunch = () => cleaning ??= (async () => {
+		await acquisitionSettled;
+		const errors = [];
+		let disconnected = !program;
+		try {
+			await program?.disconnect();
+			disconnected = true;
+		} catch (error) {
+			errors.push(error);
+		}
+		let projectClosed = !intent;
+		try {
+			await intent?.close();
+			projectClosed = true;
+		} catch (error) {
+			errors.push(error);
+		}
+		if (disconnected && projectClosed) await portLease?.release().catch((error) => errors.push(error));
+		if (errors.length) throw new AggregateError(errors, "Managed DevTools session cleanup failed");
+	})().catch((error) => {
+		cleaning = void 0;
+		throw error;
+	});
+	let disownResources = () => {};
+	try {
+		disownResources = scope.own(cleanupLaunch, "managed-automator-session");
+		const snapshotPlan = options.preserveProjectRoot ? void 0 : await readAutomatorProjectPlan(projectPath);
+		scope.throwIfAborted();
+		if (snapshotPlan) {
+			intent = await beginManagedWechatProject({
+				target,
+				projectPath,
+				port,
+				snapshotProject: true
+			});
+			if (!intent) throw new Error("DEVTOOLS_MANAGED_PROJECT_JOURNAL_REQUIRED: managed launch requires a project ownership journal.");
+			projectPath = intent.projectPath;
+			await intent.prepareSnapshot(async (destination) => await populateAutomatorProjectSnapshot(snapshotPlan, destination));
+			scope.throwIfAborted();
+		}
+		await scope.step(() => importManagedDevtoolsProject({
+			cliPath: target.cliPath,
+			projectPath,
+			trusted: options.trustProject,
+			timeout: scope.remainingMs(),
+			signal: scope.signal
+		}), { stage: "project-import" });
+		scope.throwIfAborted();
+		portLease = await scope.step(() => acquireAutomatorPortLease(port), {
+			stage: "port-lease",
+			disposeLate: (lease) => lease.release()
+		});
+		const rawReleasePortLease = portLease.release.bind(portLease);
+		let releasedPortLease;
+		portLease.release = () => releasedPortLease ??= rawReleasePortLease().catch((error) => {
+			releasedPortLease = void 0;
+			throw error;
+		});
+		intent ??= await beginManagedWechatProject({
+			target,
+			projectPath,
+			port
+		});
+		if (!intent) throw new Error("DEVTOOLS_MANAGED_PROJECT_JOURNAL_REQUIRED: managed launch requires a project ownership journal.");
+		scope.throwIfAborted();
+		await startWechatIdeAgent({
+			target,
+			projectPath,
+			port,
+			trustProject: options.trustProject,
+			signal: scope.signal,
+			timeout: scope.remainingMs(),
+			...snapshotPlan ? { onBeforeDispatch: async () => await intent.markLaunchDispatched() } : {},
+			onStarted: async (result) => await intent.confirm({
+				openedProjectWindow: result.openedProjectWindow,
+				port: result.autoPort
+			})
+		});
+		scope.throwIfAborted();
+		await assertWechatDevtoolsPort(target, port, {
+			signal: scope.signal,
+			timeout: scope.remainingMs()
+		});
+		scope.throwIfAborted();
+		const wsEndpoint = `ws://127.0.0.1:${port}`;
+		program = await launcher.connect({
+			wsEndpoint,
+			signal: scope.signal,
+			timeout: scope.remainingMs()
+		});
+		scope.throwIfAborted();
+		await program.waitForAppReady(scope.remainingMs());
+		scope.throwIfAborted();
+		Reflect.set(program, "__WEAPP_VITE_SESSION_METADATA", {
+			port,
+			projectPath,
+			wsEndpoint,
+			managedProject: {
+				id: intent.id,
+				journalPath: intent.journalPath
+			}
+		});
+		await persistAutomatorSession({
+			installationId: target.installationId,
+			signal: scope.signal,
+			port,
+			projectPath: sourceProjectPath,
+			sessionId: options.sessionId,
+			wsEndpoint
+		});
+		scope.throwIfAborted();
+		if (options.persistAsDefaultSession) {
+			await persistAutomatorSession({
+				installationId: target.installationId,
+				signal: scope.signal,
+				projectPath: sourceProjectPath,
+				wsEndpoint
+			});
+			scope.throwIfAborted();
+		}
+		const connectedProgram = program;
+		const ownedIntent = intent;
+		const ownedPortLease = portLease;
+		const rawDisconnect = connectedProgram.disconnect.bind(connectedProgram);
+		let disconnecting;
+		connectedProgram.disconnect = (...args) => {
+			disconnecting ??= (async () => {
+				await rawDisconnect(...args);
+				await ownedPortLease.release();
+			})().catch((error) => {
+				disconnecting = void 0;
+				throw error;
+			});
+			return disconnecting;
+		};
+		let closing;
+		connectedProgram.close = async () => {
+			closing ??= (async () => {
+				const errors = [];
+				let disconnected = false;
+				try {
+					await connectedProgram.disconnect();
+					disconnected = true;
+				} catch (error) {
+					errors.push(error);
+				}
+				let projectClosed = false;
+				try {
+					await ownedIntent.close();
+					projectClosed = true;
+				} catch (error) {
+					errors.push(error);
+				}
+				if (disconnected && projectClosed) await ownedPortLease.release().catch((error) => errors.push(error));
+				if (errors.length) throw new AggregateError(errors, "Managed DevTools session cleanup failed");
+			})().finally(() => {
+				closing = void 0;
+			});
+			return await closing;
+		};
+		disownResources();
+		allowCleanup();
+		return connectedProgram;
+	} catch (error) {
+		const errors = [error];
+		if (intent) try {
+			await intent.fail(error);
+		} catch (recordError) {
+			errors.push(recordError);
+		}
+		allowCleanup();
+		try {
+			await cleanupLaunch();
+			disownResources();
+		} catch (cleanupError) {
+			errors.push(...cleanupError instanceof AggregateError ? cleanupError.errors : [cleanupError]);
+		}
+		if (errors.length > 1) throw new AggregateError(errors, "Managed DevTools launch failed and project cleanup did not complete.", { cause: error });
+		throw error;
+	}
+}
+//#endregion
+export { launchManagedAutomator };

package/dist/run-mcp-83-VKZVA.js

@@ -0,0 +1 @@
+export { t as runMcpCommand } from "./run-mcp-Ni139Z5C.js";

package/dist/{run-mcp-LqaWlQJ_.js → run-mcp-Ni139Z5C.js}

@@ -1,11 +1,9 @@
-import { c as withMiniProgram$1 } from "./automator-session-fbanL2eW.js";
-import { Buffer } from "node:buffer";
-import fs from "node:fs/promises";
+import { l as withMiniProgram$1 } from "./automator-session-VOB03glx.js";
 import path from "node:path";
-import process from "node:process";
 import { readDevtoolsElementSnapshot as readElementSnapshot, resolveDevtoolsProjectPath as resolveProjectPath, toDevtoolsSerializableValue as toSerializableValue } from "@weapp-vite/devtools-runtime";
-import { serveStdio } from "@modelcontextprotocol/server/stdio";
-import { McpServer } from "@modelcontextprotocol/server";
+import fs from "node:fs/promises";
+import process from "node:process";
+import { Buffer } from "node:buffer";
 import { z } from "zod";
 //#region src/mcp/server.ts
 function createResolvedProjectPath(workspaceRoot, projectPath) {
@@ -16,6 +14,10 @@ function createResolvedOutputPath(workspaceRoot, outputPath) {
 }
 async function withConnectedMiniProgram(runtimeHooks, workspaceRoot, input, runner) {
 	return await runtimeHooks.withMiniProgram({
+		cliPath: input.cliPath,
+		devtoolsChannel: input.devtoolsChannel,
+		devtoolsVersion: input.devtoolsVersion,
+		requireOfficialLatest: input.requireOfficialLatest,
 		preferOpenedSession: input.preferOpenedSession,
 		port: input.port,
 		projectPath: createResolvedProjectPath(workspaceRoot, input.projectPath),
@@ -31,9 +33,17 @@ async function withConnectedPage(runtimeHooks, workspaceRoot, input, runner) {
 }
 function defineConnectionSchema() {
 	return {
+		cliPath: z.string().trim().min(1).optional().describe("指定微信开发者工具 CLI 安装路径"),
+		devtoolsChannel: z.enum([
+			"stable",
+			"rc",
+			"nightly"
+		]).optional(),
+		devtoolsVersion: z.string().regex(/^\d+(?:\.\d+){2,}$/).optional(),
+		requireOfficialLatest: z.boolean().optional(),
 		projectPath: z.string().trim().min(1).describe("小程序项目路径，支持 workspaceRoot 相对路径"),
 		timeout: z.number().int().positive().optional(),
-		port: z.number().int().positive().optional(),
+		port: z.number().int().positive().max(65535).optional(),
 		preferOpenedSession: z.boolean().optional(),
 		sessionId: z.string().trim().min(1).optional()
 	};
@@ -367,6 +377,7 @@ function registerWeappIdeMcpTools(server, options) {
 	});
 }
 async function createWeappIdeMcpServer(options) {
+	const { McpServer } = await import("@modelcontextprotocol/server");
 	const server = new McpServer({
 		name: "weapp-ide-cli",
 		version: "1.0.0"
@@ -380,8 +391,12 @@ async function createWeappIdeMcpServer(options) {
 //#endregion
 //#region src/mcp/runtime.ts
 async function startWeappIdeMcpServer(options = {}) {
+	const { serveStdio } = await import("@modelcontextprotocol/server/stdio");
 	const serverOptions = {
-		runtimeHooks: { withMiniProgram: withMiniProgram$1 },
+		runtimeHooks: { withMiniProgram: (input, runner) => withMiniProgram$1({
+			...input,
+			cliPath: input.cliPath ?? options.cliPath
+		}, runner) },
 		workspaceRoot: options.workspaceRoot
 	};
 	const handle = serveStdio(async () => {
@@ -415,6 +430,7 @@ function printMcpHelp() {
 Start the weapp-ide-cli MCP server over stdio.
 
 Options:
+  --cli-path <path>        Select the WeChat DevTools installation
   --workspace-root <path>  Resolve relative project/output paths from this root
   -h, --help              Show this help
 
@@ -434,7 +450,10 @@ async function runMcpCommand(argv) {
 		printMcpHelp();
 		return;
 	}
-	await startWeappIdeMcpServer({ workspaceRoot: readOptionValue(argv, "--workspace-root") });
+	await startWeappIdeMcpServer({
+		cliPath: readOptionValue(argv, "--cli-path"),
+		workspaceRoot: readOptionValue(argv, "--workspace-root")
+	});
 }
 //#endregion
 export { readElementSnapshot as a, registerWeappIdeMcpTools as i, startWeappIdeMcpServer as n, resolveProjectPath as o, createWeappIdeMcpServer as r, toSerializableValue as s, runMcpCommand as t };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "weapp-ide-cli",
   "type": "module",
-  "version": "6.1.9",
+  "version": "6.3.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.2.0",
-    "@weapp-core/logger": "3.1.8",
-    "@weapp-core/shared": "3.2.7",
-    "@weapp-vite/devtools-runtime": "0.4.24",
-    "@weapp-vite/miniprogram-automator": "1.2.23",
-    "cac": "^7.0.0",
-    "execa": "10.0.1",
+    "@modelcontextprotocol/server": "^2.3.1",
+    "@weapp-core/logger": "3.1.10",
+    "@weapp-core/shared": "3.3.0",
+    "@weapp-vite/devtools-runtime": "0.6.0",
+    "@weapp-vite/miniprogram-automator": "1.4.0",
+    "cac": "^7.1.0",
+    "execa": "10.1.1",
     "pathe": "^2.0.3",
     "pixelmatch": "^7.2.0",
     "pngjs": "^7.0.0",
-    "zod": "^4.6.5"
+    "zod": "^4.6.7"
   },
   "devDependencies": {
-    "@types/node": "^26.6.3"
+    "@types/node": "^26.6.5"
   },
   "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"
   }
 }