weapp-vite 6.16.47 → 6.17.1

package/dist/auto-routes.mjs

@@ -1,4 +1,4 @@
-import { g as getRouteRuntimeGlobalKeys, n as getCompilerContext } from "./createContext-BJPEU7dU.mjs";
+import { g as getRouteRuntimeGlobalKeys, n as getCompilerContext } from "./createContext-Dg_HER2J.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,7 +1,7 @@
-import { C as createCjsConfigLoadError, E as isPathInside, S as parseCommentJson, T as shouldPassPlatformArgToIdeOpen, _ as createBuildScopeConfigFromCli, a as formatBytes, b as getProjectConfigFileName, d as syncProjectSupportFiles, f as syncManagedTsconfigBootstrapFiles, h as resolveHmrProfileJsonPath, m as SHARED_CHUNK_VIRTUAL_PREFIX, p as createSharedBuildConfig, t as createCompilerContext, u as resolveWeappViteTarget, v as resolveWeappConfigFile, w as getDefaultIdeProjectRoot, x as loadViteConfigFile, y as checkRuntime } from "./createContext-BJPEU7dU.mjs";
+import { C as createCjsConfigLoadError, E as isPathInside, S as parseCommentJson, T as shouldPassPlatformArgToIdeOpen, _ as createBuildScopeConfigFromCli, a as formatBytes, b as getProjectConfigFileName, d as syncProjectSupportFiles, f as syncManagedTsconfigBootstrapFiles, h as resolveHmrProfileJsonPath, m as SHARED_CHUNK_VIRTUAL_PREFIX, p as createSharedBuildConfig, t as createCompilerContext, u as resolveWeappViteTarget, v as resolveWeappConfigFile, w as getDefaultIdeProjectRoot, x as loadViteConfigFile, y as checkRuntime } from "./createContext-Dg_HER2J.mjs";
 import { r as logger_default, t as colors } from "./logger-mt4mSTqV.mjs";
-import { h as VERSION } from "./file-_O6M6mJG.mjs";
-import { c as startWeappViteMcpServer, l as detectAiDevelopmentEnvironment, s as resolveWeappMcpConfig } from "./mcp-YXCIQr-Z.mjs";
+import { h as VERSION } from "./file-CtueODLX.mjs";
+import { c as startWeappViteMcpServer, l as detectAiDevelopmentEnvironment, s as resolveWeappMcpConfig } from "./mcp-BG6TliEg.mjs";
 import { createRequire } from "node:module";
 import path, { posix } from "pathe";
 import path$1 from "node:path";
@@ -247,6 +247,35 @@ async function closeIde$1() {
 	}
 }
 //#endregion
+//#region src/cli/openIde/diagnostics.ts
+/**
+* @description 输出微信开发者工具打开后的自助恢复步骤。
+*/
+function logWechatIdeRecoveryHint(options) {
+	const lines = [
+		`微信开发者工具打开后状态可能不稳定：${options.reason}`,
+		"可按下面顺序恢复：",
+		"1. 在微信开发者工具中确认：设置 -> 安全设置 -> 服务端口已开启。",
+		"2. 仅当项目索引刷新失败时，默认会自动关闭并重开一次当前目标项目；如需跳过，传入 `--no-open-recovery` 或设置 `WEAPP_VITE_DISABLE_IDE_OPEN_RECOVERY=1`。",
+		"3. 如果仍然回到项目选择页，手动导入 project.config.json 所在目录，并关闭多余的微信开发者工具窗口后重试。",
+		"4. 需要查看底层错误时，设置 `WEAPP_VITE_DEBUG_AUTOMATOR_OPEN=1` 后重试。"
+	];
+	if (options.projectPath) lines.push(`当前目标项目目录：${options.projectPath}`);
+	logger_default.warn(lines.join("\n"));
+}
+/**
+* @description 输出服务端口关闭时的定向恢复提示。
+*/
+function logWechatIdeServicePortDisabledHint(projectPath) {
+	const lines = [
+		"检测到微信开发者工具服务端口当前处于关闭状态，已保留用户设置并回退到普通 open 流程。",
+		"自动刷新、截图、MCP 和 IDE 联动能力需要服务端口。",
+		"请在微信开发者工具中打开：设置 -> 安全设置 -> 服务端口，然后重新执行当前 dev/open 命令。"
+	];
+	if (projectPath) lines.push(`当前目标项目目录：${projectPath}`);
+	logger_default.warn(lines.join("\n"));
+}
+//#endregion
 //#region src/cli/openIde/reuse.ts
 function formatReuseOpenedWechatIdePrompt() {
 	return `目标项目已在微信开发者工具中打开，已跳过重复打开。按 ${colors.bold(colors.green("r"))} 关闭当前窗口后重新打开。`;
@@ -256,8 +285,10 @@ function disconnectMiniProgram(miniProgram) {
 }
 async function openWechatIdeByAutomator(projectPath) {
 	disconnectMiniProgram(await launchAutomator({
+		persistAsDefaultSession: true,
 		preserveProjectRoot: true,
 		projectPath,
+		port: resolveProjectAutomatorPort(projectPath),
 		trustProject: true
 	}));
 }
@@ -265,6 +296,7 @@ async function connectOpenedProject(projectPath) {
 	try {
 		return await connectOpenedAutomator({
 			projectPath,
+			port: resolveProjectAutomatorPort(projectPath),
 			timeout: 3e3
 		});
 	} catch {
@@ -316,6 +348,17 @@ function shouldLogAutomatorFallbackError() {
 	const flag = process.env.WEAPP_VITE_DEBUG_AUTOMATOR_OPEN;
 	return flag === "1" || flag === "true";
 }
+const PREPARE_AUTOMATOR_SESSION_TIMEOUT = 8e3;
+const RESET_FILEUTILS_ENV = "WEAPP_VITE_RESET_IDE_FILEUTILS";
+function isWechatIdeOpenRecoveryDisabled(options) {
+	if (options.openRecovery === false) return true;
+	const flag = process.env.WEAPP_VITE_DISABLE_IDE_OPEN_RECOVERY;
+	return flag === "1" || flag === "true";
+}
+function shouldResetWechatIdeFileUtils() {
+	const flag = process.env[RESET_FILEUTILS_ENV];
+	return flag === "1" || flag === "true";
+}
 /**
 * @description 执行 IDE 打开流程，并在登录失效时允许按键重试。
 */
@@ -366,6 +409,16 @@ function appendLoginRetryArgv(argv, options) {
 	if (options.loginRetryTimeout) argv.push("--login-retry-timeout", options.loginRetryTimeout);
 	return argv;
 }
+function createIdeOpenArgv(platform, projectPath, options = {}) {
+	const argv = ["open", "-p"];
+	if (projectPath) argv.push(projectPath);
+	if (platform === "weapp" && options.trustProject !== false) argv.push("--trust-project");
+	if (platform && shouldPassPlatformArgToIdeOpen(platform)) argv.push("--platform", platform);
+	if (options.nonInteractive) argv.push("--non-interactive");
+	if (options.loginRetry) argv.push("--login-retry", options.loginRetry);
+	if (options.loginRetryTimeout) argv.push("--login-retry-timeout", options.loginRetryTimeout);
+	return argv;
+}
 async function prepareOpenedWechatIdeAutomatorSession(projectPath, options) {
 	try {
 		(await launchAutomator({
@@ -373,24 +426,37 @@ async function prepareOpenedWechatIdeAutomatorSession(projectPath, options) {
 			preserveProjectRoot: true,
 			projectPath,
 			port: resolveProjectAutomatorPort(projectPath),
-			timeout: 3e4,
+			timeout: PREPARE_AUTOMATOR_SESSION_TIMEOUT,
 			trustProject: options.trustProject !== false
 		})).disconnect?.();
+		return { ok: true };
 	} catch (error) {
 		logger_default.warn("准备当前项目的微信开发者工具自动化会话失败，截图、MCP 或 IDE 联动命令首次运行时将重新连接。");
+		logWechatIdeRecoveryHint({
+			projectPath,
+			reason: "无法建立当前项目的自动化会话，常见原因是 DevTools 服务端口未就绪、窗口停留在项目选择页，或存在残留 DevTools 会话。"
+		});
 		if (shouldLogAutomatorFallbackError()) logger_default.error(error);
+		return {
+			ok: false,
+			reason: "automator-session-failed",
+			error
+		};
 	}
 }
 async function stabilizeOpenedWechatIdeProject(projectPath, servicePortEnabled, options = {}) {
-	if (servicePortEnabled === false) return;
+	if (servicePortEnabled === false) return {
+		ok: false,
+		reason: "service-port-disabled"
+	};
 	try {
-		await executeWechatIdeCliCommand(appendLoginRetryArgv([
+		if (shouldResetWechatIdeFileUtils()) await executeWechatIdeCliCommand(appendLoginRetryArgv([
 			"reset-fileutils",
 			"-p",
 			projectPath
 		], options), {
 			automatorMode: options.useAutomatorOpen === false ? "skip" : "prefer",
-			httpMode: "prefer",
+			httpMode: "require",
 			onNonLoginError: (error) => logger_default.error(error),
 			preserveProjectRoot: options.useAutomatorOpen === false,
 			projectPath
@@ -422,21 +488,53 @@ async function stabilizeOpenedWechatIdeProject(projectPath, servicePortEnabled,
 		} catch (error) {
 			if (shouldLogAutomatorFallbackError()) logger_default.error(error);
 		}
+		return { ok: true };
 	} catch (error) {
 		if (isWechatIdeLoginRequiredExitError(error)) throw error;
 		logger_default.warn("刷新微信开发者工具项目索引失败，已保留当前打开状态；如模拟器仍显示旧状态，可手动刷新一次。");
+		logWechatIdeRecoveryHint({
+			projectPath,
+			reason: "打开项目后的文件索引刷新失败，DevTools 可能仍在使用旧项目状态或内部服务未就绪。"
+		});
 		if (shouldLogAutomatorFallbackError()) logger_default.error(error);
+		return {
+			ok: false,
+			reason: "index-refresh-failed",
+			error
+		};
 	}
 }
-function createIdeOpenArgv(platform, projectPath, options = {}) {
-	const argv = ["open", "-p"];
-	if (projectPath) argv.push(projectPath);
-	if (platform === "weapp" && options.trustProject !== false) argv.push("--trust-project");
-	if (platform && shouldPassPlatformArgToIdeOpen(platform)) argv.push("--platform", platform);
-	if (options.nonInteractive) argv.push("--non-interactive");
-	if (options.loginRetry) argv.push("--login-retry", options.loginRetry);
-	if (options.loginRetryTimeout) argv.push("--login-retry-timeout", options.loginRetryTimeout);
-	return argv;
+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);
+	return stabilizeResult;
+}
+function formatWechatIdeOpenHealthReason(result) {
+	if (result.reason === "index-refresh-failed") return "项目索引刷新失败";
+	return "服务端口未开启";
+}
+async function recoverOpenedWechatIdeProject(platform, projectPath, servicePortEnabled, options, failedResult) {
+	if (failedResult.reason === "service-port-disabled") return failedResult;
+	if (failedResult.reason === "automator-session-failed") {
+		logger_default.warn("已跳过微信开发者工具自动恢复；自动化会话预热失败不影响当前项目打开，截图、MCP 或 IDE 联动命令首次运行时会重新连接。");
+		return failedResult;
+	}
+	if (isWechatIdeOpenRecoveryDisabled(options)) {
+		logger_default.warn("已跳过微信开发者工具自动恢复；请按上方提示手动关闭并重新打开目标项目。");
+		return failedResult;
+	}
+	logger_default.info(`检测到微信开发者工具打开后状态不稳定（${formatWechatIdeOpenHealthReason(failedResult)}），正在自动关闭并重新打开目标项目...`);
+	if (!await closeIde()) logger_default.warn("自动恢复时关闭当前微信开发者工具失败，仍继续尝试重新打开目标项目。");
+	await runWechatIdeOpenWithRetry(createIdeOpenArgv(platform, projectPath, options));
+	const recoveredResult = await verifyOpenedWechatIdeProject(projectPath, servicePortEnabled, options);
+	if (recoveredResult.ok) logger_default.info("微信开发者工具已完成自动恢复。");
+	else logger_default.warn("微信开发者工具自动恢复未完成；可设置 `WEAPP_VITE_DISABLE_IDE_OPEN_RECOVERY=1` 或传入 `--no-open-recovery` 跳过自动关闭重开，并按提示手动处理。");
+	return recoveredResult;
+}
+async function verifyAndRecoverOpenedWechatIdeProject(platform, projectPath, servicePortEnabled, options) {
+	const healthResult = await verifyOpenedWechatIdeProject(projectPath, servicePortEnabled, options);
+	if (!healthResult.ok) await recoverOpenedWechatIdeProject(platform, projectPath, servicePortEnabled, options, healthResult);
 }
 async function openIde(platform, projectPath, options = {}) {
 	let bootstrapResult;
@@ -454,12 +552,12 @@ async function openIde(platform, projectPath, options = {}) {
 		logger_default.warn("检测微信开发者工具服务端口或写入项目信任状态失败，继续执行 open 流程。");
 		logger_default.error(error);
 	}
-	if (platform === "weapp" && projectPath && bootstrapResult?.servicePortEnabled === false) logger_default.warn("检测到微信开发者工具服务端口当前处于关闭状态，已保留用户设置并回退到普通 open 流程。");
+	if (platform === "weapp" && projectPath && bootstrapResult?.servicePortEnabled === false) logWechatIdeServicePortDisabledHint(projectPath);
 	if (platform === "weapp" && projectPath && normalizedOptions.trustProject !== false && bootstrapResult?.servicePortEnabled !== false && useAutomatorOpen) try {
 		const openResult = await tryOpenWechatIdeByAutomator(projectPath, normalizedOptions);
 		if (openResult === "reused") return;
 		if (openResult) {
-			await stabilizeOpenedWechatIdeProject(projectPath, bootstrapResult?.servicePortEnabled, normalizedOptions);
+			if (!normalizedOptions.skipPostOpenHealthCheck) await verifyAndRecoverOpenedWechatIdeProject(platform, projectPath, bootstrapResult?.servicePortEnabled, normalizedOptions);
 			return;
 		}
 	} catch (error) {
@@ -474,10 +572,8 @@ async function openIde(platform, projectPath, options = {}) {
 		if (!await closeIde()) logger_default.warn("关闭当前微信开发者工具失败，仍继续尝试打开目标项目。");
 	}
 	await runWechatIdeOpenWithRetry(createIdeOpenArgv(platform, projectPath, normalizedOptions));
-	if (platform === "weapp" && projectPath) {
-		await stabilizeOpenedWechatIdeProject(projectPath, bootstrapResult?.servicePortEnabled, normalizedOptions);
-		if (!useAutomatorOpen && bootstrapResult?.servicePortEnabled !== false) await prepareOpenedWechatIdeAutomatorSession(projectPath, normalizedOptions);
-	}
+	if (platform === "weapp" && projectPath && normalizedOptions.prepareAutomatorSession) await prepareOpenedWechatIdeAutomatorSession(projectPath, normalizedOptions);
+	if (platform === "weapp" && projectPath && !normalizedOptions.skipPostOpenHealthCheck) await verifyAndRecoverOpenedWechatIdeProject(platform, projectPath, bootstrapResult?.servicePortEnabled, normalizedOptions);
 }
 /**
 * @description 解析 IDE 相关命令所需的平台、项目目录与配置上下文。
@@ -876,7 +972,7 @@ function analyzeComponentUsage(options) {
 			visit(edge.component, page, nextStack);
 		}
 	};
-	for (const page of pages) visit(page, page, new Set([page]));
+	for (const page of pages) visit(page, page, /* @__PURE__ */ new Set([page]));
 	return Array.from(usageMap.values()).map((usage) => {
 		const pages = Array.from(usage.pages.values()).sort((left, right) => left.page.localeCompare(right.page));
 		const suggestions = [createComponentSuggestion(usage)].filter((item) => Boolean(item));
@@ -2425,7 +2521,7 @@ function resolveSubPackageRoot(fileName, roots) {
 function collectPackageSizeReports(output, subPackageMap) {
 	const outputs = Array.isArray(output) ? output : [output];
 	const roots = [...subPackageMap?.keys() ?? []].filter(Boolean).sort((a, b) => b.length - a.length || a.localeCompare(b));
-	const packageBytes = new Map([["__main__", 0]]);
+	const packageBytes = /* @__PURE__ */ new Map([["__main__", 0]]);
 	for (const root of roots) packageBytes.set(root, 0);
 	for (const current of outputs) for (const item of current.output ?? []) {
 		const root = resolveSubPackageRoot(item.fileName, roots) ?? "__main__";
@@ -2475,7 +2571,7 @@ function emitDashboardEvents$1(handle, events) {
 	handle?.emitRuntimeEvents(events);
 }
 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("--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("--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) => {
 		filterDuplicateOptions(options);
 		const cwd = root ?? process.cwd();
 		const configFile = resolveConfigFile(options);
@@ -2572,7 +2668,10 @@ function registerBuildCommand(cli) {
 				detail: "构建完成后准备打开 IDE 项目。",
 				tags: ["ide", "open"]
 			}]);
-			await openIde(configService.platform, resolveIdeProjectPath(configService.mpDistRoot), { trustProject: options.trustProject });
+			await openIde(configService.platform, resolveIdeProjectPath(configService.mpDistRoot), {
+				openRecovery: options.openRecovery,
+				trustProject: options.trustProject
+			});
 		}
 		if (analyzeHandle) await analyzeHandle.waitForExit();
 		ctx.watcherService?.closeAll();
@@ -2764,6 +2863,56 @@ const DEFAULT_FORWARD_CONSOLE_LEVELS = [
 let activeForwardConsoleSession;
 const FORWARD_CONSOLE_RETRY_DELAY_MS = 1e3;
 const FORWARD_CONSOLE_RETRY_TIMES = 5;
+async function detectAgent() {
+	try {
+		const result = await determineAgent();
+		return {
+			isAgent: result.isAgent,
+			agentName: result.isAgent ? result.agent.name : void 0
+		};
+	} catch {
+		return {
+			isAgent: false,
+			agentName: void 0
+		};
+	}
+}
+function formatForwardConsolePrefix(level, color) {
+	const label = `[mini:${level.padEnd(5)}]`;
+	if (!color) return label;
+	if (level === "error") return colors.bold(colors.red(label));
+	if (level === "warn") return colors.bold(colors.yellow(label));
+	if (level === "info") return colors.bold(colors.cyan(label));
+	if (level === "debug") return colors.dim(label);
+	return colors.bold(colors.green(label));
+}
+function formatForwardConsoleMessage(level, message, color) {
+	if (!color) return message;
+	if (level === "error") return colors.red(message);
+	if (level === "warn") return colors.yellow(message);
+	if (level === "debug") return colors.dim(message);
+	return message;
+}
+function writeForwardConsoleLine(line) {
+	process.stdout.write(`${line}\n`);
+}
+function isDevtoolsPortNotReadyError(error) {
+	return error instanceof Error && (error.message === "DEVTOOLS_HTTP_PORT_ERROR" || error.message === "DEVTOOLS_WS_CONNECT_ERROR" || error.message === "DEVTOOLS_EXTENSION_CONTEXT_INVALIDATED");
+}
+function sleep(ms) {
+	return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function withForwardConsoleRetry(runner) {
+	let lastError;
+	for (let attempt = 0; attempt <= FORWARD_CONSOLE_RETRY_TIMES; attempt++) try {
+		return await runner();
+	} catch (error) {
+		lastError = error;
+		if (!isDevtoolsPortNotReadyError(error) || attempt === FORWARD_CONSOLE_RETRY_TIMES) break;
+		await sleep(FORWARD_CONSOLE_RETRY_DELAY_MS);
+	}
+	throw lastError instanceof Error ? lastError : new Error(String(lastError));
+}
 /**
 * @description 解析 forwardConsole 配置，并在 auto 模式下检测 AI 终端。
 */
@@ -2804,93 +2953,71 @@ async function resolveForwardConsoleOptions(config) {
 	};
 }
 /**
-* @description 在 weapp 开发态按需启动控制台转发。
-*/
-async function maybeStartForwardConsole(options) {
-	if (options.platform !== "weapp") return false;
-	const projectPath = resolveIdeProjectPath(options.mpDistRoot) ?? options.cwd;
-	if (!projectPath) return false;
-	const resolved = await resolveForwardConsoleOptions(options.weappViteConfig);
-	if (!resolved.enabled) return false;
-	if (activeForwardConsoleSession) return true;
-	try {
-		activeForwardConsoleSession = await startForwardConsoleBridge({
-			agentName: resolved.agentName,
-			projectPath,
-			logLevels: resolved.logLevels,
-			unhandledErrors: resolved.unhandledErrors,
-			onReadyMessage: "[forwardConsole] 已连接微信开发者工具日志"
-		});
-		return true;
-	} catch (error) {
-		activeForwardConsoleSession = void 0;
-		const message = error instanceof Error ? error.message : String(error);
-		logger_default.warn(`[forwardConsole] 启动失败，回退到普通 IDE 打开流程：${message}`);
-		return false;
-	}
-}
-/**
 * @description 统一启动 DevTools 日志桥，并在 IDE 刚启动时做短暂重试。
 */
 async function startForwardConsoleBridge(options) {
 	return await withForwardConsoleRetry(async () => {
+		const color = options.color ?? true;
 		return await startForwardConsole({
 			projectPath: options.projectPath,
 			logLevels: options.logLevels,
+			openedOnly: options.openedOnly,
+			port: options.port,
 			unhandledErrors: options.unhandledErrors,
 			onReady: () => {
 				const suffix = options.agentName ? `（AI 终端：${options.agentName}）` : "";
 				logger_default.info(`${options.onReadyMessage}${suffix}`);
 			},
 			onLog: (event) => {
-				const line = `[mini:${event.level}] ${event.message}`;
-				if (event.level === "error") {
-					logger_default.error(line);
-					return;
-				}
-				if (event.level === "warn") {
-					logger_default.warn(line);
-					return;
-				}
-				if (event.level === "info") {
-					logger_default.info(line);
-					return;
-				}
-				logger_default.log(line);
+				writeForwardConsoleLine(`${formatForwardConsolePrefix(event.level, color)} ${formatForwardConsoleMessage(event.level, event.message, color)}`);
 			}
 		});
 	});
 }
-async function detectAgent() {
+/**
+* @description 在 weapp 开发态按需启动控制台转发。
+*/
+async function maybeStartForwardConsole(options) {
+	if (options.platform !== "weapp") return false;
+	const projectPath = resolveIdeProjectPath(options.mpDistRoot) ?? options.cwd;
+	if (!projectPath) return false;
+	const resolved = await resolveForwardConsoleOptions(options.weappViteConfig);
+	if (!resolved.enabled) return false;
+	if (activeForwardConsoleSession) return true;
+	const bridgeOptions = {
+		agentName: resolved.agentName,
+		color: !resolved.agentName,
+		projectPath,
+		port: resolveProjectAutomatorPort(projectPath),
+		logLevels: resolved.logLevels,
+		openedOnly: options.openedOnly,
+		unhandledErrors: resolved.unhandledErrors,
+		onReadyMessage: "[forwardConsole] 已连接微信开发者工具日志"
+	};
 	try {
-		const result = await determineAgent();
-		return {
-			isAgent: result.isAgent,
-			agentName: result.isAgent ? result.agent.name : void 0
-		};
-	} catch {
-		return {
-			isAgent: false,
-			agentName: void 0
-		};
-	}
-}
-async function withForwardConsoleRetry(runner) {
-	let lastError;
-	for (let attempt = 0; attempt <= FORWARD_CONSOLE_RETRY_TIMES; attempt++) try {
-		return await runner();
+		activeForwardConsoleSession = await startForwardConsoleBridge(bridgeOptions);
+		return true;
 	} catch (error) {
-		lastError = error;
-		if (!isDevtoolsPortNotReadyError(error) || attempt === FORWARD_CONSOLE_RETRY_TIMES) break;
-		await sleep(FORWARD_CONSOLE_RETRY_DELAY_MS);
+		if (!isDevtoolsPortNotReadyError(error)) {
+			activeForwardConsoleSession = void 0;
+			const message = error instanceof Error ? error.message : String(error);
+			logger_default.warn(`[forwardConsole] 启动失败，回退到普通 IDE 打开流程：${message}`);
+			return false;
+		}
+		try {
+			activeForwardConsoleSession = await startForwardConsoleBridge({
+				...bridgeOptions,
+				openedOnly: true,
+				port: void 0
+			});
+			return true;
+		} catch (fallbackError) {
+			activeForwardConsoleSession = void 0;
+			const message = fallbackError instanceof Error ? fallbackError.message : String(fallbackError);
+			logger_default.warn(`[forwardConsole] 启动失败，回退到普通 IDE 打开流程：${message}`);
+			return false;
+		}
 	}
-	throw lastError instanceof Error ? lastError : new Error(String(lastError));
-}
-function isDevtoolsPortNotReadyError(error) {
-	return error instanceof Error && error.message === "DEVTOOLS_HTTP_PORT_ERROR";
-}
-function sleep(ms) {
-	return new Promise((resolve) => setTimeout(resolve, ms));
 }
 //#endregion
 //#region src/cli/hmrProfileSummary.ts
@@ -3017,7 +3144,10 @@ async function runIdeCommand(action, root, options) {
 		logger_default.info(`已完成微信开发者工具配置预热：扫描实例 ${result.touchedInstanceCount} 个，检测服务端口配置 ${result.detectedSecurityCount} 处，写入项目信任 ${result.trustedProjectCount} 处。`);
 		return;
 	}
-	if (options.open) await openIde(resolved.platform, resolved.projectPath, { trustProject: options.trustProject });
+	if (options.open) await openIde(resolved.platform, resolved.projectPath, {
+		openRecovery: options.openRecovery,
+		trustProject: options.trustProject
+	});
 	if (action === "info") {
 		const result = await getWechatIdeToolInfo({ projectPath: resolved.projectPath });
 		logger_default.info(formatIdeOutput(result, options));
@@ -3062,6 +3192,7 @@ async function runIdeCommand(action, root, options) {
 	if (latestHmrSummary) logger_default.info(latestHmrSummary.line);
 	const session = await startForwardConsoleBridge({
 		projectPath: resolved.projectPath,
+		port: resolveProjectAutomatorPort(resolved.projectPath),
 		agentName: void 0,
 		logLevels: forwardConsoleOptions.logLevels,
 		unhandledErrors: forwardConsoleOptions.unhandledErrors,
@@ -3076,7 +3207,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 }).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("--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) => {
 		await runIdeCommand(action, root, options);
 	});
 }
@@ -3611,7 +3742,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("--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("--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);
@@ -3640,6 +3771,7 @@ function registerOpenCommand(cli) {
 			loginRetry: options.loginRetry,
 			loginRetryTimeout: options.loginRetryTimeout,
 			nonInteractive: options.nonInteractive,
+			openRecovery: options.openRecovery,
 			trustProject: options.trustProject
 		});
 	});
@@ -3892,7 +4024,7 @@ function resolveRunnableHotkeyDefinition(input) {
 }
 //#endregion
 //#region package.json
-var version = "6.16.47";
+var version = "6.17.1";
 //#endregion
 //#region src/cli/devHotkeys/format.ts
 const FULLWIDTH_ASCII_START = 65281;
@@ -4524,6 +4656,7 @@ function createServeMiniProgramDevActions(options) {
 		openIde: async (openOptions = {}) => {
 			if (!openOptions.forceOpen && await options.tryReuseForwardConsole?.()) return "已通过控制台转发复用当前开发者工具会话";
 			await options.openIde(projectPath, openOptions);
+			await options.tryReuseForwardConsole?.();
 			return openOptions.forceReopen ? "已重新打开微信开发者工具项目" : "已打开或复用微信开发者工具项目";
 		},
 		rebuild: async () => {
@@ -4545,8 +4678,11 @@ function waitForServeShutdownSignal() {
 }
 //#endregion
 //#region src/cli/commands/serve/index.ts
+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("--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("--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);
 		const cwd = root ?? process.cwd();
 		const configFile = resolveConfigFile(options);
@@ -4606,10 +4742,14 @@ function registerServeCommand(cli) {
 					loginRetry: options.loginRetry,
 					loginRetryTimeout: options.loginRetryTimeout,
 					nonInteractive: options.nonInteractive,
+					openRecovery: false,
+					prepareAutomatorSession: true,
 					reuseOpenedProject: !openOptions?.forceReopen,
+					skipPostOpenHealthCheck: true,
 					trustProject: options.trustProject,
-					useAutomatorOpen: false
+					useAutomatorOpen: true
 				});
+				writePostOpenSeparator();
 			},
 			projectPath: resolveIdeProjectRoot(configService.mpDistRoot, configService.cwd),
 			tryReuseForwardConsole: async () => {
@@ -4728,7 +4868,7 @@ function registerServeCommand(cli) {
 }
 //#endregion
 //#region src/cli/error.ts
-const watchLimitErrorCodes = new Set(["EMFILE", "ENOSPC"]);
+const watchLimitErrorCodes = /* @__PURE__ */ new Set(["EMFILE", "ENOSPC"]);
 const watchLimitMessagePattern = /EMFILE|ENOSPC|unable to start FSEvent stream/i;
 function findWatchLimitErrorCode(error) {
 	const visited = /* @__PURE__ */ new Set();
@@ -4764,7 +4904,7 @@ function handleCLIError(error) {
 }
 //#endregion
 //#region src/cli/ide.ts
-const WEAPP_VITE_NATIVE_COMMANDS = new Set([
+const WEAPP_VITE_NATIVE_COMMANDS = /* @__PURE__ */ new Set([
 	"dev",
 	"serve",
 	"build",
@@ -4804,7 +4944,7 @@ async function tryRunIdeCommand(argv) {
 }
 //#endregion
 //#region src/cli/mcpAutoStart.ts
-const SKIP_COMMANDS = new Set([
+const SKIP_COMMANDS = /* @__PURE__ */ new Set([
 	"--help",
 	"--version",
 	"-h",
@@ -4907,7 +5047,7 @@ registerMcpCommand(cli);
 registerServeCommand(cli);
 cli.help();
 cli.version(VERSION);
-const skipManagedTsconfigBootstrapCommands = new Set([
+const skipManagedTsconfigBootstrapCommands = /* @__PURE__ */ new Set([
 	"g",
 	"generate",
 	"ide",

package/dist/{config-Ds7MBgQm.d.mts → config-Cxi7xvCa.d.mts}

@@ -1523,6 +1523,10 @@ interface RuntimeState {
     independent: {
       outputs: Map<string, RolldownOutput>;
     };
+    output: {
+      emittedSource: Map<string, string>;
+      wevuInternalRuntimeFileName?: string;
+    };
     hmr: {
       loadedEntrySet: Set<string>;
       dirtyEntrySet: Set<string>;
@@ -1535,10 +1539,12 @@ interface RuntimeState {
       vueEntryHasTemplate: Map<string, boolean>;
       vueEntryNonJsonSignatures: Map<string, string>;
       vueEntryScriptSignatures: Map<string, string>;
+      appEntryAutoRoutesSignature?: string;
       dirtyVueEntryIds: Set<string>;
       didEmitAllEntries: boolean;
       lastHmrEntryIds: Set<string>;
       lastEmittedEntryIds: Set<string>;
+      lastEmittedChunkFileNames: Set<string>;
       recentProfiles: Array<{
         timestamp?: string;
         totalMs: number;

package/dist/config.d.mts

@@ -1,2 +1,2 @@
-import { Bn as WeappViteHostMeta, Hn as createWeappViteHostMeta, Un as isWeappViteHost, Vn as applyWeappViteHostMeta, Wn as resolveWeappViteHostMeta, Yn as WeappViteRuntime, _ 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, r as UserConfigFn, s as UserConfigFnObjectPlain, t as UserConfig, u as App, v as defineSitemapJson, y as defineThemeJson, zn as WEAPP_VITE_HOST_NAME } from "./config-Ds7MBgQm.mjs";
+import { Bn as WeappViteHostMeta, Hn as createWeappViteHostMeta, Un as isWeappViteHost, Vn as applyWeappViteHostMeta, Wn as resolveWeappViteHostMeta, Yn as WeappViteRuntime, _ 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, r as UserConfigFn, s as UserConfigFnObjectPlain, t as UserConfig, u as App, v as defineSitemapJson, y as defineThemeJson, zn as WEAPP_VITE_HOST_NAME } from "./config-Cxi7xvCa.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 };