weapp-vite 6.20.1 → 6.20.2

package/README.md

@@ -219,8 +219,14 @@ weapp-vite ide logs --open
 # 等价写法
 wv ide logs
 wv ide logs --open
+
+# 检查 DevTools CLI、服务端口、登录和已打开 automator 会话
+wv ide doctor
+wv ide doctor --json
 ```
 
+`wv open`、`wv dev -o`、`wv build -o` 和 `wv ide logs --open` 默认使用官方 CLI 打开项目，再连接 automator。需要调试旧版自动化启动链路时，可显式传入 `--ide-open-strategy automator`；项目自动信任与打开策略相互独立。
+
 除了日志桥接，`ide` 子命令现在也支持直接读取已打开 DevTools 会话的信息：
 
 ```sh

package/dist/auto-routes.mjs

@@ -1,4 +1,4 @@
-import { n as getCompilerContext, v as getRouteRuntimeGlobalKeys } from "./createContext-DutRdQ_I.mjs";
+import { n as getCompilerContext, v as getRouteRuntimeGlobalKeys } from "./createContext-DiBG4uOB.mjs";
 //#region src/auto-routes.ts
 const ROUTE_RUNTIME_OVERRIDE_KEY = Symbol.for("weapp-vite.route-runtime");
 function createGetter(resolver) {

package/dist/cli.mjs

@@ -1,6 +1,6 @@
-import { C as parseCommentJson, D as isPathInside, E as shouldPassPlatformArgToIdeOpen, S as loadViteConfigFile, T as getDefaultIdeProjectRoot, _ as resolveHmrProfileJsonPath, a as formatBytes, b as checkRuntime, d as getBackendForCapability, f as resolveBackendExecution, g as SHARED_CHUNK_VIRTUAL_PREFIX, h as createSharedBuildConfig, m as syncManagedTsconfigBootstrapFiles, p as syncProjectSupportFiles, t as createCompilerContext, w as createCjsConfigLoadError, x as getProjectConfigFileName, y as resolveWeappConfigFile } from "./createContext-DutRdQ_I.mjs";
+import { C as parseCommentJson, D as isPathInside, E as shouldPassPlatformArgToIdeOpen, S as loadViteConfigFile, T as getDefaultIdeProjectRoot, _ as resolveHmrProfileJsonPath, a as formatBytes, b as checkRuntime, d as getBackendForCapability, f as resolveBackendExecution, g as SHARED_CHUNK_VIRTUAL_PREFIX, h as createSharedBuildConfig, m as syncManagedTsconfigBootstrapFiles, p as syncProjectSupportFiles, t as createCompilerContext, w as createCjsConfigLoadError, x as getProjectConfigFileName, y as resolveWeappConfigFile } from "./createContext-DiBG4uOB.mjs";
 import { r as logger_default, t as colors } from "./logger-mt4mSTqV.mjs";
-import { h as VERSION } from "./file-Bwxu2veP.mjs";
+import { h as VERSION } from "./file-DQ5FlYd5.mjs";
 import { c as startWeappViteMcpServer, l as detectAiDevelopmentEnvironment, s as resolveWeappMcpConfig } from "./mcp-BG6TliEg.mjs";
 import { createRequire } from "node:module";
 import fs from "node:fs";
@@ -15,7 +15,7 @@ import os from "node:os";
 import { execFile, spawn } from "node:child_process";
 import { Buffer } from "node:buffer";
 import { cac } from "cac";
-import { RETRY_CANCEL_KEYS, RETRY_CONFIRM_KEYS, bootstrapWechatDevtoolsSettings, buildWechatIdeNpm, clearWechatIdeCache, clearWechatIdeCacheByAutomator, closeSharedMiniProgram, closeWechatIdeProject, compileWechatIdeByAutomator, connectOpenedAutomator, createSharedInputSession, createWechatIdeLoginRequiredExitError, dispatchWechatCliCommand, formatAutomatorLoginError, getConfig, getWechatIdeTestAccounts, getWechatIdeTicket, getWechatIdeToolInfo, isAutomatorLoginError, isWeappIdeTopLevelCommand, isWechatIdeEngineBuildEndpointMissingError, isWechatIdeLoginRequiredError, isWechatIdeLoginRequiredExitError, launchAutomator, parse, promptRetryKeypress, promptWechatIdeLoginRetry, quitWechatIde, refreshWechatIdeTicket, resetWechatIdeFileUtilsByHttp, resolveProjectAutomatorPort, runRetryableCommand, runWechatIdeEngineBuild, runWithSuspendedSharedInput, setWechatIdeTicket, startForwardConsole, takeScreenshot } from "weapp-ide-cli";
+import { RETRY_CANCEL_KEYS, RETRY_CONFIRM_KEYS, bootstrapWechatDevtoolsSettings, buildWechatIdeNpm, clearWechatIdeCache, clearWechatIdeCacheByAutomator, closeSharedMiniProgram, closeWechatIdeProject, compileWechatIdeByAutomator, connectOpenedAutomator, createSharedInputSession, createWechatIdeLoginRequiredExitError, defaultCustomConfigFilePath, detectWechatDevtoolsServicePort, dispatchWechatCliCommand, formatAutomatorLoginError, getConfig, getWechatIdeTestAccounts, getWechatIdeTicket, getWechatIdeToolInfo, isAutomatorLoginError, isWeappIdeTopLevelCommand, isWechatIdeEngineBuildEndpointMissingError, isWechatIdeLoggedIn, isWechatIdeLoginRequiredError, isWechatIdeLoginRequiredExitError, launchAutomator, parse, promptRetryKeypress, promptWechatIdeLoginRetry, quitWechatIde, refreshWechatIdeTicket, resetWechatIdeFileUtilsByHttp, resolveCliPath, resolveProjectAutomatorPort, runRetryableCommand, runWechatIdeEngineBuild, runWithSuspendedSharedInput, setWechatIdeTicket, startForwardConsole, takeScreenshot } from "weapp-ide-cli";
 import { promisify } from "node:util";
 import { brotliCompressSync, gzipSync } from "node:zlib";
 import { resolveCommand } from "package-manager-detector/commands";
@@ -251,6 +251,17 @@ async function closeIde$1() {
 //#endregion
 //#region src/cli/openIde/diagnostics.ts
 /**
+* @description 将 automator 启动错误归类为用户可执行的恢复提示。
+*/
+function formatWechatIdeAutomatorFailure(error) {
+	const message = error instanceof Error ? error.message : String(error);
+	if (/需要重新登录|need\s+re-?login|code\s*[:=]\s*10/i.test(message)) return "登录状态失效，请先登录微信开发者工具。";
+	if (/service port|http port|ECONNREFUSED|listen EPERM|EACCES/i.test(message)) return "服务端口不可用，请在设置 -> 安全设置中开启服务端口。";
+	if (/protocol method|protocol timeout|automator.*timeout|Wait timed out|websocket|ws:\/\//i.test(message)) return "自动化 websocket 或协议尚未就绪，已保留普通 CLI 打开的项目。";
+	if (/cliPath|not found|spawn/i.test(message)) return "微信开发者工具 CLI 路径不可用，请执行 `wv ide doctor` 检查配置。";
+	return "当前 DevTools 自动化能力不可用，已保留普通 CLI 打开的项目。";
+}
+/**
 * @description 输出微信开发者工具打开后的自助恢复步骤。
 */
 function logWechatIdeRecoveryHint(options) {
@@ -302,14 +313,14 @@ async function verifyOpenedProjectHealth(miniProgram) {
 	if (typeof miniProgram.screenshot !== "function") return;
 	await withTimeout(miniProgram.screenshot({ timeout: OPENED_PROJECT_HEALTH_CHECK_TIMEOUT }), OPENED_PROJECT_HEALTH_CHECK_TIMEOUT);
 }
-async function openWechatIdeByAutomator(projectPath) {
+async function openWechatIdeByAutomator(projectPath, options = {}) {
 	disconnectMiniProgram(await launchAutomator({
 		persistAsDefaultSession: true,
-		preserveProjectRoot: true,
+		preserveProjectRoot: options.preserveProjectRoot ?? true,
 		projectPath,
 		port: resolveProjectAutomatorPort(projectPath),
 		timeout: OPEN_AUTOMATOR_TIMEOUT,
-		trustProject: true
+		trustProject: options.trustProject !== false
 	}));
 }
 async function connectOpenedProject(projectPath) {
@@ -361,7 +372,10 @@ async function tryReuseOpenedWechatIde(projectPath, closeIde, options = {}) {
 	};
 	logger_default.info(colors.bold(colors.green("正在关闭当前已打开项目，并重新拉起微信开发者工具...")));
 	if (!await closeIde()) logger_default.warn("关闭当前微信开发者工具失败，仍继续尝试重新打开目标项目。");
-	await openWechatIdeByAutomator(projectPath);
+	await openWechatIdeByAutomator(projectPath, {
+		preserveProjectRoot: options.preserveProjectRoot,
+		trustProject: options.trustProject
+	});
 	return {
 		reopened: true,
 		reused: false
@@ -370,14 +384,14 @@ async function tryReuseOpenedWechatIde(projectPath, closeIde, options = {}) {
 /**
 * @description 对已打开的目标项目执行强制重开，以刷新最新构建产物。
 */
-async function reopenOpenedWechatIde(projectPath, closeIde) {
+async function reopenOpenedWechatIde(projectPath, closeIde, options = {}) {
 	const connection = await connectOpenedProject(projectPath);
 	if (connection.status !== "connected") return false;
 	const { miniProgram } = connection;
 	disconnectMiniProgram(miniProgram);
 	logger_default.info("目标项目已在微信开发者工具中打开，当前命令将主动重开以刷新最新构建产物。");
 	if (!await closeIde()) logger_default.warn("关闭当前微信开发者工具失败，仍继续尝试重新打开目标项目。");
-	await openWechatIdeByAutomator(projectPath);
+	await openWechatIdeByAutomator(projectPath, options);
 	return true;
 }
 //#endregion
@@ -388,6 +402,19 @@ function shouldLogAutomatorFallbackError() {
 }
 const PREPARE_AUTOMATOR_SESSION_TIMEOUT = 8e3;
 const RESET_FILEUTILS_ENV = "WEAPP_VITE_RESET_IDE_FILEUTILS";
+function readProjectConfigObject(projectPath) {
+	try {
+		const raw = fs.readFileSync(path.join(projectPath, "project.config.json"), "utf8");
+		const value = JSON.parse(raw);
+		return value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
+	} catch {
+		return;
+	}
+}
+function shouldUseAutomatorProjectWrapper(projectPath) {
+	const projectConfig = readProjectConfigObject(projectPath);
+	return projectConfig?.compileType === "plugin" && typeof projectConfig.miniprogramRoot === "string" && projectConfig.miniprogramRoot.trim().length > 0;
+}
 function isWechatIdeOpenRecoveryDisabled(options) {
 	if (options.openRecovery === false) return true;
 	const flag = process.env.WEAPP_VITE_DISABLE_IDE_OPEN_RECOVERY;
@@ -429,14 +456,25 @@ async function closeIde() {
 	return await closeIde$1();
 }
 async function tryOpenWechatIdeByAutomator(projectPath, options) {
+	const preserveProjectRoot = !shouldUseAutomatorProjectWrapper(projectPath);
 	if (options.reuseOpenedProject === false) {
-		if (await reopenOpenedWechatIde(projectPath, closeIde)) return "reopened";
+		if (await reopenOpenedWechatIde(projectPath, closeIde, {
+			preserveProjectRoot,
+			trustProject: options.trustProject
+		})) return "reopened";
 	}
-	const reuseResult = await tryReuseOpenedWechatIde(projectPath, closeIde, { promptReopen: options.reuseOpenedProject !== true });
+	const reuseResult = await tryReuseOpenedWechatIde(projectPath, closeIde, {
+		preserveProjectRoot,
+		promptReopen: options.reuseOpenedProject !== true,
+		trustProject: options.trustProject
+	});
 	if (reuseResult?.reused) return "reused";
 	if (reuseResult?.reopened) return "reopened";
 	if (reuseResult?.unhealthy) return "unhealthy";
-	await openWechatIdeByAutomator(projectPath);
+	await openWechatIdeByAutomator(projectPath, {
+		preserveProjectRoot,
+		trustProject: options.trustProject
+	});
 	return "opened";
 }
 /**
@@ -459,10 +497,11 @@ function createIdeOpenArgv(platform, projectPath, options = {}) {
 	return argv;
 }
 async function prepareOpenedWechatIdeAutomatorSession(projectPath, options) {
+	const preserveProjectRoot = !shouldUseAutomatorProjectWrapper(projectPath);
 	try {
 		(await launchAutomator({
 			persistAsDefaultSession: true,
-			preserveProjectRoot: true,
+			preserveProjectRoot,
 			projectPath,
 			port: resolveProjectAutomatorPort(projectPath),
 			timeout: PREPARE_AUTOMATOR_SESSION_TIMEOUT,
@@ -547,7 +586,7 @@ async function stabilizeOpenedWechatIdeProject(projectPath, servicePortEnabled,
 			await executeWechatIdeCliCommand(appendLoginRetryArgv(["compile"], options), {
 				automatorMode: "require",
 				httpMode: "skip",
-				preserveProjectRoot: true,
+				preserveProjectRoot: !shouldUseAutomatorProjectWrapper(projectPath),
 				projectPath
 			});
 		} catch (error) {
@@ -572,7 +611,7 @@ async function stabilizeOpenedWechatIdeProject(projectPath, servicePortEnabled,
 async function verifyOpenedWechatIdeProject(projectPath, servicePortEnabled, options) {
 	const stabilizeResult = await stabilizeOpenedWechatIdeProject(projectPath, servicePortEnabled, options);
 	if (!stabilizeResult.ok) return stabilizeResult;
-	if (options.useAutomatorOpen === false && servicePortEnabled !== false) return await prepareOpenedWechatIdeAutomatorSession(projectPath, options);
+	if (options.useAutomatorOpen === false && servicePortEnabled !== false) return await connectOpenedWechatIdeAutomatorSession(projectPath);
 	return stabilizeResult;
 }
 function formatWechatIdeOpenHealthReason(result) {
@@ -603,9 +642,11 @@ async function verifyAndRecoverOpenedWechatIdeProject(platform, projectPath, ser
 }
 async function openIde(platform, projectPath, options = {}) {
 	let bootstrapResult;
-	const useAutomatorOpen = options.useAutomatorOpen === true;
+	const openStrategy = options.openStrategy ?? (options.useAutomatorOpen === true ? "automator" : "cli");
+	const useAutomatorOpen = openStrategy === "automator";
 	const normalizedOptions = {
 		...options,
+		openStrategy,
 		useAutomatorOpen
 	};
 	if (platform === "weapp" && projectPath) try {
@@ -618,7 +659,7 @@ async function openIde(platform, projectPath, options = {}) {
 		logger_default.error(error);
 	}
 	if (platform === "weapp" && projectPath && bootstrapResult?.servicePortEnabled === false) logWechatIdeServicePortDisabledHint(projectPath);
-	if (platform === "weapp" && projectPath && normalizedOptions.trustProject !== false && bootstrapResult?.servicePortEnabled !== false && useAutomatorOpen) try {
+	if (platform === "weapp" && projectPath && bootstrapResult?.servicePortEnabled !== false && useAutomatorOpen) try {
 		const openResult = await tryOpenWechatIdeByAutomator(projectPath, normalizedOptions);
 		if (openResult === "reused") return;
 		if (openResult === "unhealthy") {
@@ -633,7 +674,7 @@ async function openIde(platform, projectPath, options = {}) {
 			logger_default.error("检测到微信开发者工具登录状态失效，请先登录后重试。");
 			logger_default.warn(formatAutomatorLoginError(error));
 		}
-		logger_default.warn("通过 automator 启动微信开发者工具并自动信任项目失败，回退到普通 open 流程。");
+		logger_default.warn(`通过 automator 启动微信开发者工具失败，回退到普通 open 流程：${formatWechatIdeAutomatorFailure(error)}`);
 		if (shouldLogAutomatorFallbackError()) logger_default.error(error);
 	}
 	else if (platform === "weapp" && projectPath && normalizedOptions.reuseOpenedProject === false) {
@@ -2885,7 +2926,7 @@ function scheduleCompletedProductionBuildExit(options, analyzeHandle) {
 	}, 0).unref?.();
 }
 function registerBuildCommand(cli) {
-	cli.command("build [root]", "build for production").option("--target <target>", `[string] transpile target (default: 'modules')`).option("--outDir <dir>", `[string] output directory (default: dist)`).option("-p, --platform <platform>", `[string] target platform (weapp | web | all)`).option("--project-config <path>", `[string] project config path (miniprogram only)`).option("--sourcemap [output]", `[boolean | "inline" | "hidden"] output source maps for build (default: false)`).option("--minify [minifier]", "[boolean | \"terser\" | \"esbuild\"] enable/disable minification, or specify minifier to use (default: esbuild)").option("--emptyOutDir", `[boolean] force empty outDir when it's outside of root`).option("-w, --watch", `[boolean] rebuilds when modules have changed on disk`).option("--skipNpm", `[boolean] if skip npm build`).option("-o, --open", `[boolean] open ide`).option("--trust-project", "[boolean] auto trust Wechat DevTools project on open", { default: true }).option("--no-open-recovery", "[boolean] disable automatic Wechat DevTools close-and-reopen recovery").option("--ui", `[boolean] 启动调试 UI（当前提供分析视图）`, { default: false }).option("--analyze", `[boolean] 输出分包分析仪表盘`, { default: false }).option("--scope <scope>", `[string] 局部构建范围，例如 main,packages/order`).action(async (root, options) => {
+	cli.command("build [root]", "build for production").option("--target <target>", `[string] transpile target (default: 'modules')`).option("--outDir <dir>", `[string] output directory (default: dist)`).option("-p, --platform <platform>", `[string] target platform (weapp | web | all)`).option("--project-config <path>", `[string] project config path (miniprogram only)`).option("--sourcemap [output]", `[boolean | "inline" | "hidden"] output source maps for build (default: false)`).option("--minify [minifier]", "[boolean | \"terser\" | \"esbuild\"] enable/disable minification, or specify minifier to use (default: esbuild)").option("--emptyOutDir", `[boolean] force empty outDir when it's outside of root`).option("-w, --watch", `[boolean] rebuilds when modules have changed on disk`).option("--skipNpm", `[boolean] if skip npm build`).option("-o, --open", `[boolean] open ide`).option("--trust-project", "[boolean] auto trust Wechat DevTools project on open", { default: true }).option("--ide-open-strategy <strategy>", "[string] IDE open strategy (cli | automator)", { default: "cli" }).option("--no-open-recovery", "[boolean] disable automatic Wechat DevTools close-and-reopen recovery").option("--ui", `[boolean] 启动调试 UI（当前提供分析视图）`, { default: false }).option("--analyze", `[boolean] 输出分包分析仪表盘`, { default: false }).option("--scope <scope>", `[string] 局部构建范围，例如 main,packages/order`).action(async (root, options) => {
 		let analyzeHandle;
 		let ctx;
 		let targets;
@@ -2996,7 +3037,8 @@ function registerBuildCommand(cli) {
 				}]);
 				await openIde(configService.platform, resolveIdeProjectPath(configService.mpDistRoot), {
 					openRecovery: options.openRecovery,
-					trustProject: options.trustProject
+					trustProject: options.trustProject,
+					openStrategy: options.ideOpenStrategy
 				});
 			}
 			if (analyzeHandle) await analyzeHandle.waitForExit();
@@ -3610,6 +3652,121 @@ async function readLatestHmrProfileSummary(options) {
 }
 //#endregion
 //#region src/cli/commands/ide.ts
+async function runIdeDoctor(projectPath, options) {
+	const resolvedCli = await resolveCliPath();
+	const servicePort = await detectWechatDevtoolsServicePort().catch((error) => ({
+		servicePortEnabled: void 0,
+		servicePort: void 0,
+		error
+	}));
+	const cliCheck = resolvedCli.cliPath ? {
+		status: "ok",
+		value: {
+			path: resolvedCli.cliPath,
+			source: resolvedCli.source
+		}
+	} : {
+		fix: "执行 `weapp config set cliPath <path-to-cli>` 配置微信开发者工具 CLI。",
+		message: "未找到可用的微信开发者工具 CLI。",
+		status: "failed",
+		value: { source: resolvedCli.source }
+	};
+	const servicePortCheck = servicePort.servicePortEnabled === false ? {
+		fix: "在微信开发者工具中打开：设置 -> 安全设置 -> 服务端口。",
+		message: "微信开发者工具服务端口已关闭。",
+		status: "failed",
+		value: servicePort
+	} : servicePort.error ? {
+		fix: "执行 `wv ide doctor --json` 查看底层错误，并确认微信开发者工具已安装。",
+		message: servicePort.error instanceof Error ? servicePort.error.message : String(servicePort.error),
+		status: "warning"
+	} : {
+		status: servicePort.servicePortEnabled === true ? "ok" : "unknown",
+		value: {
+			enabled: servicePort.servicePortEnabled ?? null,
+			port: servicePort.servicePort ?? null
+		}
+	};
+	let loginCheck = {
+		fix: "打开微信开发者工具完成登录后重试。",
+		message: "暂未确认登录状态。",
+		status: "unknown"
+	};
+	if (resolvedCli.cliPath) try {
+		await isWechatIdeLoggedIn({
+			nonInteractive: true,
+			silent: true
+		});
+		loginCheck = {
+			status: "ok",
+			value: true
+		};
+	} catch (error) {
+		loginCheck = {
+			fix: "打开微信开发者工具完成登录后重试，或执行 `wv ide doctor --json` 查看 CLI 错误。",
+			message: error instanceof Error ? error.message : String(error),
+			status: "warning",
+			value: false
+		};
+	}
+	const projectCheck = projectPath ? {
+		status: "ok",
+		value: projectPath
+	} : {
+		fix: "在项目目录执行命令，或显式传入 `wv ide doctor <project-root>`。",
+		message: "未解析到微信开发者工具项目目录。",
+		status: "warning"
+	};
+	let automatorCheck = {
+		message: projectPath ? "当前项目没有可连接的已打开 automator 会话。" : "缺少项目目录，跳过 automator 检查。",
+		status: "unknown"
+	};
+	let toolCheck = {
+		message: "当前没有可读取的 DevTools Tool.getInfo。",
+		status: "unknown"
+	};
+	if (projectPath) try {
+		const miniProgram = await connectOpenedAutomator({
+			projectPath,
+			port: resolveProjectAutomatorPort(projectPath),
+			timeout: 3e3
+		});
+		automatorCheck = {
+			status: "ok",
+			value: true
+		};
+		if (typeof miniProgram.toolInfo === "function") toolCheck = {
+			status: "ok",
+			value: await miniProgram.toolInfo()
+		};
+		miniProgram.disconnect?.();
+	} catch (error) {
+		automatorCheck = {
+			fix: "先执行 `wv open` 打开项目；若服务端口已开启，关闭多余 DevTools 窗口后重试。",
+			message: error instanceof Error ? error.message : String(error),
+			status: "warning"
+		};
+	}
+	const report = {
+		checks: {
+			automator: automatorCheck,
+			cli: cliCheck,
+			login: loginCheck,
+			project: projectCheck,
+			servicePort: servicePortCheck,
+			tool: toolCheck
+		},
+		configFile: defaultCustomConfigFilePath,
+		nodeVersion: process.version,
+		platform: process.platform,
+		weappViteVersion: VERSION
+	};
+	const output = JSON.stringify(report, null, 2);
+	if (options.json) process.stdout.write(`${output}\n`);
+	else logger_default.info(output);
+	if (options.strict && Object.values(report.checks).some((check) => check.status === "failed")) throw new Error("微信开发者工具环境诊断未通过，请根据 doctor 输出修复失败项后重试。");
+	return report;
+}
 async function waitForTermination(cleanup) {
 	await new Promise((resolve) => {
 		const signals = ["SIGINT", "SIGTERM"];
@@ -3639,7 +3796,7 @@ function formatIdeOutput(data, options) {
 * @description 执行 ide 子命令。
 */
 async function runIdeCommand(action, root, options) {
-	if (action !== "logs" && action !== "setup" && action !== "info" && action !== "test-accounts" && action !== "ticket" && action !== "ticket:set" && action !== "ticket:refresh") throw new Error(`未知 ide 子命令: ${action ?? "(empty)"}`);
+	if (action !== "logs" && action !== "setup" && action !== "info" && action !== "test-accounts" && action !== "ticket" && action !== "ticket:set" && action !== "ticket:refresh" && action !== "doctor") throw new Error(`未知 ide 子命令: ${action ?? "(empty)"}`);
 	filterDuplicateOptions(options);
 	const configFile = resolveConfigFile(options);
 	const targets = resolveRuntimeTargets(options);
@@ -3652,8 +3809,12 @@ async function runIdeCommand(action, root, options) {
 		projectPath: root,
 		cliPlatform: targets.rawPlatform
 	});
-	if (resolved.platform !== "weapp") throw new Error("`weapp-vite ide logs` 当前仅支持微信小程序平台。");
-	if (!resolved.projectPath) throw new Error("无法解析微信开发者工具项目目录，请显式传入 root 或检查 project.config.json。");
+	if (action !== "doctor" && resolved.platform !== "weapp") throw new Error("`weapp-vite ide logs` 当前仅支持微信小程序平台。");
+	if (action !== "doctor" && !resolved.projectPath) throw new Error("无法解析微信开发者工具项目目录，请显式传入 root 或检查 project.config.json。");
+	if (action === "doctor") {
+		await runIdeDoctor(resolved.projectPath, options);
+		return;
+	}
 	if (action === "setup") {
 		const result = await bootstrapWechatDevtoolsSettings({
 			projectPath: resolved.projectPath,
@@ -3664,7 +3825,8 @@ async function runIdeCommand(action, root, options) {
 	}
 	if (options.open) await openIde(resolved.platform, resolved.projectPath, {
 		openRecovery: options.openRecovery,
-		trustProject: options.trustProject
+		trustProject: options.trustProject,
+		openStrategy: options.ideOpenStrategy
 	});
 	if (action === "info") {
 		const result = await getWechatIdeToolInfo({ projectPath: resolved.projectPath });
@@ -3725,7 +3887,7 @@ async function runIdeCommand(action, root, options) {
 * @description 注册 IDE 相关子命令。
 */
 function registerIdeCommand(cli) {
-	cli.command("ide [action] [root]", "run Wechat DevTools utility actions and log bridge commands").option("-o, --open", "[boolean] open ide before attaching log bridge").option("-p, --platform <platform>", "[string] target platform (weapp | web)").option("--project-config <path>", "[string] project config path (miniprogram only)").option("--ticket <value>", "[string] ticket used by `ide ticket:set`").option("--trust-project", "[boolean] auto trust Wechat DevTools project on open", { default: true }).option("--no-open-recovery", "[boolean] disable automatic Wechat DevTools close-and-reopen recovery").action(async (action, root, options) => {
+	cli.command("ide [action] [root]", "run Wechat DevTools utility actions and log bridge commands").option("-o, --open", "[boolean] open ide before attaching log bridge").option("-p, --platform <platform>", "[string] target platform (weapp | web)").option("--project-config <path>", "[string] project config path (miniprogram only)").option("--json", "[boolean] output the doctor report as JSON").option("--ticket <value>", "[string] ticket used by `ide ticket:set`").option("--trust-project", "[boolean] auto trust Wechat DevTools project on open", { default: true }).option("--ide-open-strategy <strategy>", "[string] IDE open strategy (cli | automator)", { default: "cli" }).option("--strict", "[boolean] fail when doctor finds blocking environment errors").option("--no-open-recovery", "[boolean] disable automatic Wechat DevTools close-and-reopen recovery").action(async (action, root, options) => {
 		await runIdeCommand(action, root, options);
 	});
 }
@@ -4261,7 +4423,7 @@ function applyMcpCliOptions(config, options) {
 //#endregion
 //#region src/cli/commands/open.ts
 function registerOpenCommand(cli) {
-	cli.command("open [root]").option("-p, --platform <platform>", `[string] target platform (weapp | web)`).option("--trust-project", "[boolean] auto trust Wechat DevTools project on open", { default: true }).option("--login-retry <mode>", "[string] login retry mode for Wechat DevTools (never | once | always)").option("--login-retry-timeout <ms>", "[number] login retry prompt timeout in milliseconds").option("--non-interactive", "[boolean] fail immediately when Wechat DevTools login has expired").option("--no-open-recovery", "[boolean] disable automatic Wechat DevTools close-and-reopen recovery").option("--mcp", "[boolean] auto start MCP service before opening IDE").option("--no-mcp", "[boolean] disable MCP service before opening IDE").action(async (root, options) => {
+	cli.command("open [root]").option("-p, --platform <platform>", `[string] target platform (weapp | web)`).option("--trust-project", "[boolean] auto trust Wechat DevTools project on open", { default: true }).option("--ide-open-strategy <strategy>", "[string] IDE open strategy (cli | automator)", { default: "cli" }).option("--login-retry <mode>", "[string] login retry mode for Wechat DevTools (never | once | always)").option("--login-retry-timeout <ms>", "[number] login retry prompt timeout in milliseconds").option("--non-interactive", "[boolean] fail immediately when Wechat DevTools login has expired").option("--no-open-recovery", "[boolean] disable automatic Wechat DevTools close-and-reopen recovery").option("--mcp", "[boolean] auto start MCP service before opening IDE").option("--no-mcp", "[boolean] disable MCP service before opening IDE").action(async (root, options) => {
 		filterDuplicateOptions(options);
 		const configFile = resolveConfigFile(options);
 		const targets = resolveRuntimeTargets(options);
@@ -4293,7 +4455,8 @@ function registerOpenCommand(cli) {
 			loginRetryTimeout: options.loginRetryTimeout,
 			nonInteractive: options.nonInteractive,
 			openRecovery: options.openRecovery,
-			trustProject: options.trustProject
+			trustProject: options.trustProject,
+			openStrategy: options.ideOpenStrategy
 		});
 	});
 }
@@ -4564,7 +4727,7 @@ function resolveRunnableHotkeyDefinition(input) {
 }
 //#endregion
 //#region package.json
-var version = "6.20.1";
+var version = "6.20.2";
 //#endregion
 //#region src/cli/devHotkeys/format.ts
 const FULLWIDTH_ASCII_START = 65281;
@@ -4730,6 +4893,7 @@ function startDevHotkeys(options) {
 	let onKeypress;
 	let onSigcont;
 	let currentAction;
+	let actionStartedAt;
 	let lastAction;
 	let lastRenderedPanel = "";
 	const recentInputs = /* @__PURE__ */ new Map();
@@ -4809,10 +4973,12 @@ function startDevHotkeys(options) {
 	const runAction = (label, pendingLabel, action) => {
 		if (running) {
 			const current = currentAction ?? "已有命令";
-			logger_default.warn(`[dev action] 当前正在${current.replace(REG_PENDING_PREFIX, "")}，请稍后再试。`);
+			const elapsed = actionStartedAt === void 0 ? "" : `（已运行 ${Math.max(0, Date.now() - actionStartedAt)} ms）`;
+			logger_default.warn(`[dev action] 当前正在${current.replace(REG_PENDING_PREFIX, "")}${elapsed}，已忽略重复请求。`);
 			return;
 		}
 		running = true;
+		actionStartedAt = Date.now();
 		currentAction = pendingLabel;
 		printHint();
 		action().then((summary) => {
@@ -4821,6 +4987,7 @@ function startDevHotkeys(options) {
 			logger_default.error(`[dev action] ${label}失败：${error instanceof Error ? error.message : String(error)}`);
 		}).finally(() => {
 			running = false;
+			actionStartedAt = void 0;
 			currentAction = void 0;
 			if (!closed) printHint();
 		});
@@ -4828,6 +4995,7 @@ function startDevHotkeys(options) {
 	const runBackgroundAction = (label, pendingLabel, action) => {
 		if (running) return;
 		running = true;
+		actionStartedAt = Date.now();
 		currentAction = pendingLabel;
 		action().then((summary) => {
 			if (summary) lastAction = summary;
@@ -4835,6 +5003,7 @@ function startDevHotkeys(options) {
 			logger_default.error(`[dev action] ${label}失败：${error instanceof Error ? error.message : String(error)}`);
 		}).finally(() => {
 			running = false;
+			actionStartedAt = void 0;
 			currentAction = void 0;
 		});
 	};
@@ -5228,7 +5397,7 @@ function writePostOpenSeparator() {
 	process.stdout?.write?.("\n");
 }
 function registerServeCommand(cli) {
-	cli.command("[root]", "start dev server").alias("serve").alias("dev").option("--skipNpm", `[boolean] if skip npm build`).option("-o, --open", `[boolean] open ide`).option("-p, --platform <platform>", `[string] target platform (weapp | web | all)`).option("--project-config <path>", `[string] project config path (miniprogram only)`).option("--trust-project", "[boolean] auto trust Wechat DevTools project on open", { default: true }).option("--login-retry <mode>", "[string] login retry mode for Wechat DevTools (never | once | always)").option("--login-retry-timeout <ms>", "[number] login retry prompt timeout in milliseconds").option("--non-interactive", "[boolean] fail immediately when Wechat DevTools login has expired").option("--no-open-recovery", "[boolean] disable automatic Wechat DevTools close-and-reopen recovery").option("--mcp", "[boolean] auto start MCP service during dev").option("--no-mcp", "[boolean] disable MCP service during dev").option("--host [host]", `[string] web dev server host`).option("--ui", `[boolean] 启动调试 UI（当前提供分析视图）`, { default: false }).option("--analyze", `[boolean] 启动分包分析仪表盘 (实验特性)`, { default: false }).option("--scope <scope>", `[string] 局部构建范围，例如 main,packages/order`).action(async (root, options) => {
+	cli.command("[root]", "start dev server").alias("serve").alias("dev").option("--skipNpm", `[boolean] if skip npm build`).option("-o, --open", `[boolean] open ide`).option("-p, --platform <platform>", `[string] target platform (weapp | web | all)`).option("--project-config <path>", `[string] project config path (miniprogram only)`).option("--trust-project", "[boolean] auto trust Wechat DevTools project on open", { default: true }).option("--ide-open-strategy <strategy>", "[string] IDE open strategy (cli | automator)", { default: "cli" }).option("--login-retry <mode>", "[string] login retry mode for Wechat DevTools (never | once | always)").option("--login-retry-timeout <ms>", "[number] login retry prompt timeout in milliseconds").option("--non-interactive", "[boolean] fail immediately when Wechat DevTools login has expired").option("--no-open-recovery", "[boolean] disable automatic Wechat DevTools close-and-reopen recovery").option("--mcp", "[boolean] auto start MCP service during dev").option("--no-mcp", "[boolean] disable MCP service during dev").option("--host [host]", `[string] web dev server host`).option("--ui", `[boolean] 启动调试 UI（当前提供分析视图）`, { default: false }).option("--analyze", `[boolean] 启动分包分析仪表盘 (实验特性)`, { default: false }).option("--scope <scope>", `[string] 局部构建范围，例如 main,packages/order`).action(async (root, options) => {
 		filterDuplicateOptions(options);
 		setCommandNodeEnv("development");
 		const cwd = root ?? process.cwd();
@@ -5265,7 +5434,7 @@ function registerServeCommand(cli) {
 			fallbackProjectPath: configService.cwd,
 			openIde: async (projectPath, openOptions) => {
 				const forceReopen = openOptions?.forceReopen === true;
-				const useAutomatorOpen = forceReopen || openOptions?.useAutomatorOpen === true;
+				const useAutomatorOpen = openOptions?.openStrategy === "automator" || openOptions?.useAutomatorOpen === true;
 				await openIde(configService.platform, projectPath, {
 					loginRetry: options.loginRetry,
 					loginRetryTimeout: options.loginRetryTimeout,
@@ -5276,6 +5445,7 @@ function registerServeCommand(cli) {
 					skipAutomatorCompile: !forceReopen,
 					skipPostOpenHealthCheck: true,
 					trustProject: options.trustProject,
+					openStrategy: openOptions?.openStrategy ?? options.ideOpenStrategy ?? "cli",
 					useAutomatorOpen
 				});
 				writePostOpenSeparator();
@@ -5388,7 +5558,7 @@ function registerServeCommand(cli) {
 					await miniProgramDevActions.openIde({
 						forceOpen: true,
 						forceReopen: false,
-						useAutomatorOpen: options.trustProject !== false
+						openStrategy: options.ideOpenStrategy ?? "cli"
 					});
 				} finally {
 					devHotkeysSession?.restore();
@@ -5463,7 +5633,7 @@ async function tryRunIdeCommand(argv) {
 	const command = argv[0];
 	if (!command) return false;
 	if (command === "ide") {
-		if (argv[1] === "logs") return false;
+		if (argv[1] === "logs" || argv[1] === "doctor" || argv[1] === "--help" || argv[1] === "-h") return false;
 		if (!await dispatchWechatCliCommand(argv.slice(1))) await executeWechatIdeCliCommand(argv.slice(1));
 		return true;
 	}

package/dist/{config-Dd_PqIy2.d.mts → config-C810aRQQ.d.mts}

@@ -410,6 +410,7 @@ interface HandleWxmlOptions {
   importMetaExtension?: string;
   removeComment?: boolean;
   transformEvent?: boolean;
+  transformPlatformSyntax?: boolean;
   scriptModuleExtension?: string;
   scriptModuleTag?: string;
   templateExtension?: string;

package/dist/config.d.mts

@@ -1,2 +1,2 @@
-import { $n as WeappViteRuntime, Gn as applyWeappViteHostMeta, Jn as resolveWeappViteHostMeta, Kn as createWeappViteHostMeta, Un as WEAPP_VITE_HOST_NAME, Wn as WeappViteHostMeta, _ as definePageJson, a as UserConfigFnNoEnvPlain, at as WeappViteConfig, c as UserConfigFnPromise, d as Component, f as Page, g as defineComponentJson, h as defineAppJson, i as UserConfigFnNoEnv, l as defineConfig, m as Theme, n as UserConfigExport, o as UserConfigFnObject, p as Sitemap, qn as isWeappViteHost, r as UserConfigFn, s as UserConfigFnObjectPlain, t as UserConfig, u as App, v as defineSitemapJson, y as defineThemeJson } from "./config-Dd_PqIy2.mjs";
+import { $n as WeappViteRuntime, Gn as applyWeappViteHostMeta, Jn as resolveWeappViteHostMeta, Kn as createWeappViteHostMeta, Un as WEAPP_VITE_HOST_NAME, Wn as WeappViteHostMeta, _ as definePageJson, a as UserConfigFnNoEnvPlain, at as WeappViteConfig, c as UserConfigFnPromise, d as Component, f as Page, g as defineComponentJson, h as defineAppJson, i as UserConfigFnNoEnv, l as defineConfig, m as Theme, n as UserConfigExport, o as UserConfigFnObject, p as Sitemap, qn as isWeappViteHost, r as UserConfigFn, s as UserConfigFnObjectPlain, t as UserConfig, u as App, v as defineSitemapJson, y as defineThemeJson } from "./config-C810aRQQ.mjs";
 export { type App, type Component, type Page, type Sitemap, type Theme, UserConfig, UserConfigExport, UserConfigFn, UserConfigFnNoEnv, UserConfigFnNoEnvPlain, UserConfigFnObject, UserConfigFnObjectPlain, UserConfigFnPromise, WEAPP_VITE_HOST_NAME, type WeappViteConfig, WeappViteHostMeta, type WeappViteRuntime, applyWeappViteHostMeta, createWeappViteHostMeta, defineAppJson, defineComponentJson, defineConfig, definePageJson, defineSitemapJson, defineThemeJson, isWeappViteHost, resolveWeappViteHostMeta };