weapp-vite 6.13.3 → 6.14.0

package/dist/cli.mjs

@@ -1,11 +1,10 @@
-import { _ as getDefaultIdeProjectRoot, b as shouldPassPlatformArgToIdeOpen, c as SHARED_CHUNK_VIRTUAL_PREFIX, d as checkRuntime, f as getProjectConfigFileName, g as DEFAULT_MP_PLATFORM, h as createCjsConfigLoadError, m as parseCommentJson, n as syncProjectSupportFiles, o as formatBytes, p as loadViteConfigFile, r as syncManagedTsconfigBootstrapFiles, s as createSharedBuildConfig, t as createCompilerContext, u as resolveWeappConfigFile, v as normalizeMiniPlatform, x as isPathInside, y as resolveMiniPlatform } from "./createContext-3UhoQl2A.mjs";
-import { r as logger_default, t as colors } from "./logger-gutcwWKE.mjs";
-import { p as VERSION } from "./file-BAUXs16l.mjs";
-import { resolveWeappMcpConfig, startWeappViteMcpServer } from "./mcp.mjs";
+import { S as isPathInside, _ as DEFAULT_MP_PLATFORM, b as resolveMiniPlatform, c as createSharedBuildConfig, d as resolveWeappConfigFile, f as checkRuntime, g as createCjsConfigLoadError, h as parseCommentJson, l as SHARED_CHUNK_VIRTUAL_PREFIX, m as loadViteConfigFile, n as syncProjectSupportFiles, p as getProjectConfigFileName, r as syncManagedTsconfigBootstrapFiles, s as formatBytes, t as createCompilerContext, v as getDefaultIdeProjectRoot, x as shouldPassPlatformArgToIdeOpen, y as normalizeMiniPlatform } from "./createContext-BolxgJjC.mjs";
+import { r as logger_default, t as colors } from "./logger-CgxdNjvb.mjs";
+import { m as VERSION } from "./file-Ej-4GoYg.mjs";
+import { a as resolveWeappMcpConfig, o as startWeappViteMcpServer } from "./mcp-DRlj32v4.mjs";
 import { createRequire } from "node:module";
-import { defu } from "@weapp-core/shared";
+import { defu, fs } from "@weapp-core/shared";
 import path, { posix } from "pathe";
-import fs from "fs-extra";
 import process from "node:process";
 import fs$1 from "node:fs/promises";
 import { build, createServer } from "vite";
@@ -15,10 +14,11 @@ import fs$2 from "node:fs";
 import { cac } from "cac";
 import { resolveCommand } from "package-manager-detector/commands";
 import { promisify } from "node:util";
-import { formatRetryHotkeyPrompt, formatWechatIdeLoginRequiredError, getConfig, isWeappIdeTopLevelCommand, isWechatIdeLoginRequiredError, parse, startForwardConsole, waitForRetryKeypress } from "weapp-ide-cli";
+import { closeSharedMiniProgram, connectOpenedAutomator, formatRetryHotkeyPrompt, formatWechatIdeLoginRequiredError, getConfig, isWeappIdeTopLevelCommand, isWechatIdeLoginRequiredError, launchAutomator, parse, startForwardConsole, takeScreenshot, waitForRetryKeypress } from "weapp-ide-cli";
 import { generateJs, generateJson, generateWxml, generateWxss } from "@weapp-core/schematics";
 import { determineAgent } from "@vercel/detect-agent";
 import { initConfig } from "@weapp-core/init";
+import { emitKeypressEvents } from "node:readline";
 //#region src/analyze/subpackages/classifier.ts
 const VIRTUAL_MODULE_INDICATOR = "\0";
 const VIRTUAL_PREFIX = `${SHARED_CHUNK_VIRTUAL_PREFIX}/`;
@@ -857,6 +857,14 @@ function registerAnalyzeCommand(cli) {
 	});
 }
 //#endregion
+//#region src/cli/formatDuration.ts
+/**
+* 将毫秒耗时格式化为适合 CLI 展示的文本。
+*/
+function formatDuration(durationMs) {
+	return `${durationMs}ms`;
+}
+//#endregion
 //#region src/cli/logBuildAppFinish.ts
 let logBuildAppFinishOnlyShowOnce = false;
 function collectServerUrls(webServer) {
@@ -942,6 +950,27 @@ function logBuildPackageSizeReport(options) {
 //#endregion
 //#region src/cli/openIde.ts
 const execFileAsync = promisify(execFile);
+async function openWechatIdeByAutomator(projectPath) {
+	(await launchAutomator({
+		projectPath,
+		trustProject: true
+	})).disconnect();
+}
+/**
+* @description 若当前项目已在微信开发者工具中打开且自动化可连通，则直接复用现有会话，避免重复拉起 IDE。
+*/
+async function tryReuseOpenedWechatIde(projectPath) {
+	try {
+		(await connectOpenedAutomator({
+			projectPath,
+			timeout: 3e3
+		})).disconnect();
+		logger_default.info("目标项目已在微信开发者工具中打开，跳过重复打开。");
+		return true;
+	} catch {
+		return false;
+	}
+}
 /**
 * @description 执行 IDE 打开流程，并在登录失效时允许按键重试。
 */
@@ -1001,7 +1030,15 @@ function resolveIdeProjectPath(mpDistRoot) {
 function resolveIdeProjectRoot(mpDistRoot, cwd) {
 	return resolveIdeProjectPath(mpDistRoot) ?? cwd;
 }
-async function openIde(platform, projectPath) {
+async function openIde(platform, projectPath, options = {}) {
+	if (platform === "weapp" && projectPath && options.trustProject !== false) try {
+		if (await tryReuseOpenedWechatIde(projectPath)) return;
+		await openWechatIdeByAutomator(projectPath);
+		return;
+	} catch (error) {
+		logger_default.warn("通过 automator 启动微信开发者工具并自动信任项目失败，回退到普通 open 流程。");
+		logger_default.error(error);
+	}
 	const argv = ["open", "-p"];
 	if (projectPath) argv.push(projectPath);
 	if (shouldPassPlatformArgToIdeOpen(platform)) argv.push("--platform", platform);
@@ -1085,7 +1122,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 | h5 | 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("--ui", `[boolean] 启动调试 UI（当前提供分析视图）`, { default: false }).option("--analyze", `[boolean] 输出分包分析仪表盘`, { default: false }).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 | h5 | 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 }).action(async (root, options) => {
 		filterDuplicateOptions(options);
 		const configFile = resolveConfigFile(options);
 		const targets = resolveRuntimeTargets(options);
@@ -1105,6 +1142,8 @@ function registerBuildCommand(cli) {
 		if (targets.runMini) {
 			const miniBuildStartedAt = Date.now();
 			const output = await buildService.build(options);
+			const miniBuildDurationMs = Date.now() - miniBuildStartedAt;
+			logger_default.success(`小程序构建完成，耗时：${colors.green(formatDuration(miniBuildDurationMs))}`);
 			if (!Array.isArray(output) && "output" in output) logBuildPackageSizeReport({
 				output,
 				subPackageMap: ctx.scanService?.subPackageMap,
@@ -1122,7 +1161,7 @@ function registerBuildCommand(cli) {
 					level: "success",
 					title: "mini build completed",
 					detail: `生产构建已完成，当前 analyze 结果包含 ${analyzeResult.packages.length} 个包。`,
-					durationMs: Date.now() - miniBuildStartedAt,
+					durationMs: miniBuildDurationMs,
 					tags: ["build", "mini"]
 				}]);
 			}
@@ -1132,13 +1171,14 @@ function registerBuildCommand(cli) {
 			const webBuildStartedAt = Date.now();
 			try {
 				await webService?.build();
-				logger_default.success(`Web 构建完成，输出目录：${colors.green(configService.relativeCwd(webConfig.outDir))}`);
+				const webBuildDurationMs = Date.now() - webBuildStartedAt;
+				logger_default.success(`Web 构建完成，输出目录：${colors.green(configService.relativeCwd(webConfig.outDir))}，耗时：${colors.green(formatDuration(webBuildDurationMs))}`);
 				emitDashboardEvents$1(analyzeHandle, [{
 					kind: "build",
 					level: "success",
 					title: "web build completed",
 					detail: `Web 构建已完成，输出目录 ${configService.relativeCwd(webConfig.outDir)}。`,
-					durationMs: Date.now() - webBuildStartedAt,
+					durationMs: webBuildDurationMs,
 					tags: ["build", "web"]
 				}]);
 			} catch (error) {
@@ -1163,7 +1203,7 @@ function registerBuildCommand(cli) {
 				detail: "构建完成后准备打开 IDE 项目。",
 				tags: ["ide", "open"]
 			}]);
-			await openIde(configService.platform, resolveIdeProjectPath(configService.mpDistRoot));
+			await openIde(configService.platform, resolveIdeProjectPath(configService.mpDistRoot), { trustProject: options.trustProject });
 		}
 		if (analyzeHandle) await analyzeHandle.waitForExit();
 		ctx.watcherService?.closeAll();
@@ -1486,12 +1526,25 @@ function sleep(ms) {
 }
 //#endregion
 //#region src/cli/commands/ide.ts
-/**
-* @description 注册 IDE 相关子命令。
-*/
-function registerIdeCommand(cli) {
-	cli.command("ide [action] [root]", "forward Wechat DevTools console logs to terminal").option("-o, --open", "[boolean] open ide before attaching log bridge").option("-p, --platform <platform>", "[string] target platform (weapp | h5)").option("--project-config <path>", "[string] project config path (miniprogram only)").action(async (action, root, options) => {
-		await runIdeCommand(action, root, options);
+async function waitForTermination(cleanup) {
+	await new Promise((resolve) => {
+		const signals = ["SIGINT", "SIGTERM"];
+		let cleaning = false;
+		const handlers = /* @__PURE__ */ new Map();
+		const teardown = async () => {
+			if (cleaning) return;
+			cleaning = true;
+			for (const signal of signals) process.off(signal, handlers.get(signal));
+			await cleanup();
+			resolve();
+		};
+		for (const signal of signals) {
+			const handler = () => {
+				teardown();
+			};
+			handlers.set(signal, handler);
+			process.on(signal, handler);
+		}
 	});
 }
 /**
@@ -1511,7 +1564,7 @@ async function runIdeCommand(action, root, options) {
 	});
 	if (resolved.platform !== "weapp") throw new Error("`weapp-vite ide logs` 当前仅支持微信小程序平台。");
 	if (!resolved.projectPath) throw new Error("无法解析微信开发者工具项目目录，请显式传入 root 或检查 project.config.json。");
-	if (options.open) await openIde(resolved.platform, resolved.projectPath);
+	if (options.open) await openIde(resolved.platform, resolved.projectPath, { trustProject: options.trustProject });
 	const forwardConsoleOptions = await resolveForwardConsoleOptions({
 		...resolved.weappViteConfig,
 		forwardConsole: resolved.weappViteConfig?.forwardConsole === false ? { enabled: true } : {
@@ -1531,25 +1584,12 @@ async function runIdeCommand(action, root, options) {
 		await session.close();
 	});
 }
-async function waitForTermination(cleanup) {
-	await new Promise((resolve) => {
-		const signals = ["SIGINT", "SIGTERM"];
-		let cleaning = false;
-		const teardown = async () => {
-			if (cleaning) return;
-			cleaning = true;
-			for (const signal of signals) process.off(signal, handlers.get(signal));
-			await cleanup();
-			resolve();
-		};
-		const handlers = /* @__PURE__ */ new Map();
-		for (const signal of signals) {
-			const handler = () => {
-				teardown();
-			};
-			handlers.set(signal, handler);
-			process.on(signal, handler);
-		}
+/**
+* @description 注册 IDE 相关子命令。
+*/
+function registerIdeCommand(cli) {
+	cli.command("ide [action] [root]", "forward Wechat DevTools console logs to terminal").option("-o, --open", "[boolean] open ide before attaching log bridge").option("-p, --platform <platform>", "[string] target platform (weapp | h5)").option("--project-config <path>", "[string] project config path (miniprogram only)").option("--trust-project", "[boolean] auto trust Wechat DevTools project on open", { default: true }).action(async (action, root, options) => {
+		await runIdeCommand(action, root, options);
 	});
 }
 //#endregion
@@ -1599,7 +1639,7 @@ function registerNpmCommand(cli) {
 //#endregion
 //#region src/cli/commands/open.ts
 function registerOpenCommand(cli) {
-	cli.command("open [root]").option("-p, --platform <platform>", `[string] target platform (weapp | h5)`).action(async (root, options) => {
+	cli.command("open [root]").option("-p, --platform <platform>", `[string] target platform (weapp | h5)`).option("--trust-project", "[boolean] auto trust Wechat DevTools project on open", { default: true }).action(async (root, options) => {
 		filterDuplicateOptions(options);
 		const configFile = resolveConfigFile(options);
 		const targets = resolveRuntimeTargets(options);
@@ -1610,7 +1650,7 @@ function registerOpenCommand(cli) {
 			projectPath: root,
 			cliPlatform: targets.rawPlatform
 		});
-		await openIde(platform, projectPath ?? resolveIdeProjectRoot(mpDistRoot, process.cwd()));
+		await openIde(platform, projectPath ?? resolveIdeProjectRoot(mpDistRoot, process.cwd()), { trustProject: options.trustProject });
 	});
 }
 //#endregion
@@ -1641,6 +1681,339 @@ function registerPrepareCommand(cli) {
 	});
 }
 //#endregion
+//#region package.json
+var version = "6.14.0";
+//#endregion
+//#region src/cli/devHotkeys.ts
+const DEV_SCREENSHOT_DIR = ".tmp/weapp-vite-dev-screenshots";
+const DEFAULT_SCREENSHOT_TIMEOUT = 3e4;
+const REG_PENDING_PREFIX = /^正在/;
+const FULLWIDTH_ASCII_START = 65281;
+const FULLWIDTH_ASCII_END = 65374;
+const FULLWIDTH_ASCII_OFFSET = 65248;
+const HOTKEY_DEDUP_WINDOW_MS = 32;
+function formatMcpUrl(host, port, endpoint) {
+	return `http://${host}:${port}${endpoint}`;
+}
+function forwardSigint() {
+	process.kill(process.pid, "SIGINT");
+}
+function forwardSigtstp() {
+	process.kill(process.pid, "SIGTSTP");
+}
+function formatProjectLabel(cwd) {
+	return path.basename(cwd) || cwd;
+}
+function formatMcpStatus(state) {
+	if (!state.mcpEnabled) return "已禁用";
+	return state.mcpRunning ? "运行中" : "未启动";
+}
+function formatFooterLine(state) {
+	if (state.currentAction) return `执行中    ${state.currentAction}`;
+	return "就绪      等待操作...";
+}
+/**
+* @description 生成带状态的开发态快捷键帮助文本。
+*/
+function formatDevHotkeyHelpWithState(state) {
+	const key = (value) => colors.bold(colors.green(value));
+	const actionRows = [{
+		key: key("s"),
+		description: "截图当前页面并保存到本地"
+	}, {
+		key: key("m"),
+		description: "开关 MCP 服务"
+	}];
+	const processRows = [
+		{
+			key: key("q"),
+			description: "退出当前 dev"
+		},
+		{
+			key: key("Ctrl+C"),
+			description: "强制中断当前 dev"
+		},
+		{
+			key: key("Ctrl+Z"),
+			description: "暂时挂起当前 dev，恢复终端控制"
+		}
+	];
+	const helpRows = [{
+		key: key("h"),
+		description: "重新显示这份帮助"
+	}];
+	const keyColumnWidth = Math.max(...[
+		...actionRows,
+		...processRows,
+		...helpRows
+	].map((row) => row.key.length));
+	const formatRows = (rows) => rows.map(({ key, description }) => `按 ${key.padEnd(keyColumnWidth)}  ${description}`);
+	return [
+		`${colors.bold(colors.green("DEV"))}  weapp-vite v${version}  ${state.projectLabel ?? "weapp"}`,
+		"",
+		"快捷命令",
+		...formatRows(actionRows),
+		"",
+		"进程控制",
+		...formatRows(processRows),
+		"",
+		"帮助",
+		...formatRows(helpRows),
+		"",
+		`当前状态：${state.currentAction ?? "等待操作"} / MCP ${formatMcpStatus(state)}`
+	].join("\n");
+}
+/**
+* @description 生成带状态的开发态快捷键简短提示。
+*/
+function formatDevHotkeyHintWithState(state) {
+	const key = (value) => colors.bold(colors.green(value));
+	if (state.currentAction) return `${formatFooterLine(state)}，按 ${key("h")} 显示帮助，按 ${key("q")} 退出`;
+	return `开发快捷键已就绪，按 ${key("h")} 显示帮助，按 ${key("q")} 退出`;
+}
+/**
+* @description 生成开发态截图输出路径。
+*/
+function resolveDevScreenshotOutputPath(cwd, now = /* @__PURE__ */ new Date()) {
+	const stamp = now.toISOString().replace(/[:.]/g, "-");
+	return path.join(cwd, DEV_SCREENSHOT_DIR, `screenshot-${stamp}.png`);
+}
+function formatLogPath(cwd, targetPath) {
+	const relativePath = path.relative(cwd, targetPath);
+	if (!relativePath || relativePath.startsWith("..")) return targetPath;
+	return relativePath;
+}
+function formatResolvedScreenshotPath(cwd, fallbackPath, result) {
+	return formatLogPath(cwd, result.path ?? fallbackPath);
+}
+function normalizeInputChar(input) {
+	if (input.length !== 1) return input;
+	const codePoint = input.codePointAt(0);
+	if (!codePoint) return input;
+	if (codePoint >= FULLWIDTH_ASCII_START && codePoint <= FULLWIDTH_ASCII_END) return String.fromCodePoint(codePoint - FULLWIDTH_ASCII_OFFSET);
+	return input;
+}
+/**
+* @description 执行当前页面截图并输出结果日志。
+*/
+async function runScreenshotAction(options) {
+	const outputPath = resolveDevScreenshotOutputPath(options.cwd);
+	await fs$1.mkdir(path.dirname(outputPath), { recursive: true });
+	logger_default.info(`[dev action] 正在截图当前页面，输出到 ${colors.cyan(formatLogPath(options.cwd, outputPath))}`);
+	const result = await takeScreenshot({
+		fullPage: true,
+		projectPath: options.projectPath,
+		sharedSession: true,
+		outputPath,
+		timeout: DEFAULT_SCREENSHOT_TIMEOUT
+	});
+	const resolvedPath = formatResolvedScreenshotPath(options.cwd, outputPath, result);
+	logger_default.success(`[dev action] 当前页面截图完成：${colors.cyan(resolvedPath)}`);
+	return resolvedPath;
+}
+/**
+* @description 在开发态启动终端快捷键，并将动作输出到本地日志。
+*/
+function startDevHotkeys(options) {
+	if (options.platform !== "weapp" || !process.stdin.isTTY) return;
+	emitKeypressEvents(process.stdin);
+	const hasSetRawMode = typeof process.stdin.setRawMode === "function";
+	if (hasSetRawMode) process.stdin.setRawMode(true);
+	process.stdin.resume();
+	let closed = false;
+	let running = false;
+	let mcpHandle;
+	let onData;
+	let onKeypress;
+	let onSigcont;
+	let currentAction;
+	let lastAction;
+	let lastRenderedPanel = "";
+	const recentInputs = /* @__PURE__ */ new Map();
+	const resolvedMcp = resolveWeappMcpConfig(options.mcpConfig);
+	const getState = () => ({
+		currentAction,
+		lastAction,
+		mcpEnabled: resolvedMcp.enabled,
+		mcpRunning: Boolean(mcpHandle?.close),
+		projectLabel: formatProjectLabel(options.cwd)
+	});
+	const detachTerminal = () => {
+		if (hasSetRawMode) process.stdin.setRawMode(false);
+		process.stdin.pause();
+	};
+	const attachTerminal = () => {
+		if (closed) return;
+		if (hasSetRawMode) process.stdin.setRawMode(true);
+		process.stdin.resume();
+	};
+	const ensureTerminalActive = () => {
+		if (closed) return;
+		if (hasSetRawMode) process.stdin.setRawMode(true);
+		process.stdin.resume();
+	};
+	const close = () => {
+		if (closed) return;
+		closed = true;
+		if (onData) process.stdin.off("data", onData);
+		if (onKeypress) process.stdin.off("keypress", onKeypress);
+		if (onSigcont) process.off("SIGCONT", onSigcont);
+		detachTerminal();
+		if (mcpHandle?.close) mcpHandle.close().catch((error) => {
+			logger_default.warn(`[dev action] MCP 服务关闭失败：${error instanceof Error ? error.message : String(error)}`);
+		});
+		closeSharedMiniProgram(options.projectPath).catch((error) => {
+			logger_default.warn(`[dev action] DevTools 会话关闭失败：${error instanceof Error ? error.message : String(error)}`);
+		});
+	};
+	const printPanel = (message, force = false) => {
+		if (!force && message === lastRenderedPanel) return;
+		lastRenderedPanel = message;
+		logger_default.info(message);
+	};
+	const printHelp = () => {
+		printPanel(formatDevHotkeyHelpWithState(getState()), true);
+		ensureTerminalActive();
+	};
+	const printHint = () => {
+		printPanel(formatDevHotkeyHintWithState(getState()));
+		ensureTerminalActive();
+	};
+	const restore = () => {
+		if (closed) return;
+		if (onData) process.stdin.off("data", onData);
+		if (onKeypress) process.stdin.off("keypress", onKeypress);
+		attachTerminal();
+		if (onData) process.stdin.on("data", onData);
+		if (onKeypress) process.stdin.on("keypress", onKeypress);
+		printHint();
+	};
+	const suspend = () => {
+		lastRenderedPanel = "";
+		detachTerminal();
+		forwardSigtstp();
+	};
+	const toggleMcp = async () => {
+		if (!resolvedMcp.enabled) {
+			logger_default.warn("[dev action] MCP 已在配置中禁用，跳过切换。");
+			return "MCP 已禁用";
+		}
+		if (mcpHandle?.close) {
+			const url = formatMcpUrl(resolvedMcp.host, resolvedMcp.port, resolvedMcp.endpoint);
+			logger_default.info(`[dev action] 正在关闭 MCP 服务：${colors.cyan(url)}`);
+			await mcpHandle.close();
+			mcpHandle = void 0;
+			logger_default.success(`[dev action] MCP 服务已关闭：${colors.cyan(url)}`);
+			return `MCP 已关闭 (${url})`;
+		}
+		const url = formatMcpUrl(resolvedMcp.host, resolvedMcp.port, resolvedMcp.endpoint);
+		logger_default.info(`[dev action] 正在启动 MCP 服务：${colors.cyan(url)}`);
+		mcpHandle = await startWeappViteMcpServer({
+			endpoint: resolvedMcp.endpoint,
+			host: resolvedMcp.host,
+			port: resolvedMcp.port,
+			transport: "streamable-http",
+			unref: false,
+			workspaceRoot: options.cwd
+		});
+		logger_default.success(`[dev action] MCP 服务已启动：${colors.cyan(url)}`);
+		return `MCP 已启动 (${url})`;
+	};
+	const runAction = (label, pendingLabel, action) => {
+		if (running) {
+			const current = currentAction ?? "已有命令";
+			logger_default.warn(`[dev action] 当前正在${current.replace(REG_PENDING_PREFIX, "")}，请稍后再试。`);
+			return;
+		}
+		running = true;
+		currentAction = pendingLabel;
+		printHint();
+		action().then((summary) => {
+			if (summary) lastAction = summary;
+		}).catch((error) => {
+			logger_default.error(`[dev action] ${label}失败：${error instanceof Error ? error.message : String(error)}`);
+		}).finally(() => {
+			running = false;
+			currentAction = void 0;
+			if (!closed) printHint();
+		});
+	};
+	const handleInput = (input) => {
+		if (closed) return;
+		const normalizedInput = normalizeInputChar(input);
+		if (normalizedInput === "") {
+			close();
+			forwardSigint();
+			return;
+		}
+		if (normalizedInput === "") {
+			suspend();
+			return;
+		}
+		const normalized = normalizedInput.toLowerCase();
+		if (normalized === "q") {
+			close();
+			forwardSigint();
+			return;
+		}
+		if (normalized === "h") {
+			printHelp();
+			return;
+		}
+		if (normalized === "s") {
+			runAction("截图", "正在截图当前页面", async () => {
+				return `截图已保存到 ${await runScreenshotAction(options)}`;
+			});
+			return;
+		}
+		if (normalized === "m") runAction("MCP 切换", mcpHandle?.close ? "正在关闭 MCP 服务" : "正在启动 MCP 服务", async () => {
+			return await toggleMcp();
+		});
+	};
+	const handleInputOnce = (input, source) => {
+		const normalizedInput = normalizeInputChar(input);
+		const now = Date.now();
+		for (const [token, timestamp] of recentInputs) if (now - timestamp > HOTKEY_DEDUP_WINDOW_MS) recentInputs.delete(token);
+		const dedupKey = normalizedInput;
+		const recentEntry = recentInputs.get(dedupKey);
+		if (recentEntry !== void 0) {
+			const [recentSource, recentTimestamp] = recentEntry.split(":");
+			if (recentSource !== source && now - Number(recentTimestamp) <= HOTKEY_DEDUP_WINDOW_MS) return;
+		}
+		recentInputs.set(dedupKey, `${source}:${now}`);
+		handleInput(normalizedInput);
+	};
+	onData = (chunk) => {
+		const text = typeof chunk === "string" ? chunk : Buffer.from(chunk).toString("utf8");
+		for (const char of text) handleInputOnce(char, "data");
+	};
+	process.stdin.on("data", onData);
+	onKeypress = (str, key) => {
+		if (key?.ctrl && key.name === "c") {
+			handleInputOnce("", "keypress");
+			return;
+		}
+		if (key?.ctrl && key.name === "z") {
+			handleInputOnce("", "keypress");
+			return;
+		}
+		if (typeof str === "string" && str) handleInputOnce(str, "keypress");
+	};
+	process.stdin.on("keypress", onKeypress);
+	onSigcont = () => {
+		restore();
+	};
+	process.on("SIGCONT", onSigcont);
+	if (!options.silentStartupHint) printHint();
+	if (resolvedMcp.enabled && resolvedMcp.autoStart) runAction("MCP 自动启动", "正在启动 MCP 服务", async () => {
+		await toggleMcp();
+	});
+	return {
+		close,
+		restore
+	};
+}
+//#endregion
 //#region src/cli/commands/serve.ts
 function emitDashboardEvents(handle, events) {
 	handle?.emitRuntimeEvents(events);
@@ -1656,6 +2029,17 @@ const REG_DIST_POSIX_SEP = /\\/g;
 function hasAnalyzeData(result) {
 	return result.packages.length > 0 || result.modules.length > 0;
 }
+function waitForServeShutdownSignal() {
+	return new Promise((resolve) => {
+		const onSignal = () => {
+			process.off("SIGINT", onSignal);
+			process.off("SIGTERM", onSignal);
+			resolve();
+		};
+		process.on("SIGINT", onSignal);
+		process.on("SIGTERM", onSignal);
+	});
+}
 async function collectOutputFiles(root) {
 	const entries = await fs$1.readdir(root, { withFileTypes: true });
 	const files = [];
@@ -1730,7 +2114,7 @@ async function analyzeUiFallback(ctx) {
 	};
 }
 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 | h5 | all)`).option("--project-config <path>", `[string] project config path (miniprogram only)`).option("--host [host]", `[string] web dev server host`).option("--ui", `[boolean] 启动调试 UI（当前提供分析视图）`, { default: false }).option("--analyze", `[boolean] 启动分包分析仪表盘 (实验特性)`, { default: false }).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 | h5 | 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("--host [host]", `[string] web dev server host`).option("--ui", `[boolean] 启动调试 UI（当前提供分析视图）`, { default: false }).option("--analyze", `[boolean] 启动分包分析仪表盘 (实验特性)`, { default: false }).action(async (root, options) => {
 		filterDuplicateOptions(options);
 		const configFile = resolveConfigFile(options);
 		const targets = resolveRuntimeTargets(options);
@@ -1787,162 +2171,181 @@ function registerServeCommand(cli) {
 		const enableAnalyze = Boolean(isUiEnabled(options) && targets.runMini);
 		let analyzeHandle;
 		let analyzeRunId = 0;
-		const runAnalyze = async () => {
-			const startedAt = Date.now();
-			try {
-				const result = await analyzeSubpackages(await createCompilerContext({
-					key: `serve-ui-analyze:${process.pid}:${++analyzeRunId}`,
-					cwd: configService.cwd,
-					mode: configService.mode,
-					isDev: false,
-					configFile,
-					inlineConfig: createInlineConfig(targets.mpPlatform),
-					cliPlatform: targets.rawPlatform,
-					projectConfigPath: options.projectConfig,
-					syncSupportFiles: false
-				}));
-				if (hasAnalyzeData(result)) return {
-					result,
-					durationMs: Date.now() - startedAt,
-					mode: "full"
-				};
-			} catch (error) {
-				const message = error instanceof Error ? error.message : String(error);
-				logger_default.warn(`[ui] 完整分析失败，已回退到 dist 文件扫描：${message}`);
+		const devHotkeysSession = targets.runMini ? startDevHotkeys({
+			cwd: configService.cwd,
+			mcpConfig: configService.weappViteConfig?.weapp?.mcp,
+			platform: configService.platform,
+			projectPath: resolveIdeProjectRoot(configService.mpDistRoot, configService.cwd),
+			silentStartupHint: true
+		}) : void 0;
+		try {
+			const runAnalyze = async () => {
+				const startedAt = Date.now();
+				try {
+					const result = await analyzeSubpackages(await createCompilerContext({
+						key: `serve-ui-analyze:${process.pid}:${++analyzeRunId}`,
+						cwd: configService.cwd,
+						mode: configService.mode,
+						isDev: false,
+						configFile,
+						inlineConfig: createInlineConfig(targets.mpPlatform),
+						cliPlatform: targets.rawPlatform,
+						projectConfigPath: options.projectConfig,
+						syncSupportFiles: false
+					}));
+					if (hasAnalyzeData(result)) return {
+						result,
+						durationMs: Date.now() - startedAt,
+						mode: "full"
+					};
+				} catch (error) {
+					const message = error instanceof Error ? error.message : String(error);
+					logger_default.warn(`[ui] 完整分析失败，已回退到 dist 文件扫描：${message}`);
+					return {
+						result: await analyzeUiFallback(ctx),
+						durationMs: Date.now() - startedAt,
+						mode: "fallback",
+						fallbackReason: message
+					};
+				}
 				return {
 					result: await analyzeUiFallback(ctx),
 					durationMs: Date.now() - startedAt,
 					mode: "fallback",
-					fallbackReason: message
+					fallbackReason: "完整分析结果为空，已回退到 dist 文件扫描。"
 				};
-			}
-			return {
-				result: await analyzeUiFallback(ctx),
-				durationMs: Date.now() - startedAt,
-				mode: "fallback",
-				fallbackReason: "完整分析结果为空，已回退到 dist 文件扫描。"
 			};
-		};
-		const triggerAnalyzeUpdate = async (reason = "watch") => {
-			if (!analyzeHandle) return;
-			emitDashboardEvents(analyzeHandle, [{
-				kind: reason === "watch" ? "hmr" : "build",
-				level: "info",
-				title: reason === "watch" ? "analyze refresh started" : "initial analyze started",
-				detail: reason === "watch" ? "检测到新的构建结束事件，开始刷新 analyze 面板。" : "开发态 UI 已启动，开始生成第一份 analyze 结果。",
-				tags: reason === "watch" ? ["watch", "analyze"] : ["initial", "analyze"]
-			}]);
-			const next = await runAnalyze();
-			if (next.mode === "fallback") emitDashboardEvents(analyzeHandle, [{
-				kind: "diagnostic",
-				level: "warning",
-				title: "analyze fallback enabled",
-				detail: next.fallbackReason ?? "完整分析不可用，已回退到 dist 文件扫描。",
-				durationMs: next.durationMs,
-				tags: ["analyze", "fallback"]
-			}]);
-			await analyzeHandle.update(next.result);
-			emitDashboardEvents(analyzeHandle, [{
-				kind: next.mode === "fallback" ? "diagnostic" : "build",
-				level: next.mode === "fallback" ? "warning" : "success",
-				title: reason === "watch" ? "analyze refresh completed" : "initial analyze completed",
-				detail: next.mode === "fallback" ? `analyze 已回退到 dist 扫描，当前包含 ${next.result.packages.length} 个包。` : `analyze 已刷新完成，当前包含 ${next.result.packages.length} 个包与 ${next.result.modules.length} 个模块。`,
-				durationMs: next.durationMs,
-				tags: next.mode === "fallback" ? ["analyze", "fallback"] : ["analyze", reason === "watch" ? "refresh" : "initial"]
-			}]);
-		};
-		if (targets.runMini) {
-			const buildResult = await buildService.build(options);
-			if (enableAnalyze) {
-				const initialAnalyze = await runAnalyze();
-				analyzeHandle = await startAnalyzeDashboard(initialAnalyze.result, {
-					watch: true,
-					cwd: configService.cwd,
-					packageManagerAgent: configService.packageManager.agent,
-					silentStartupLog: true
-				}) ?? void 0;
+			const triggerAnalyzeUpdate = async (reason = "watch") => {
+				if (!analyzeHandle) return;
 				emitDashboardEvents(analyzeHandle, [{
-					kind: "command",
-					level: "success",
-					title: "dev ui session ready",
-					detail: `开发态分析面板已启动，当前包含 ${initialAnalyze.result.packages.length} 个包。`,
-					durationMs: initialAnalyze.durationMs,
-					tags: ["dev", "ui"]
+					kind: reason === "watch" ? "hmr" : "build",
+					level: "info",
+					title: reason === "watch" ? "analyze refresh started" : "initial analyze started",
+					detail: reason === "watch" ? "检测到新的构建结束事件，开始刷新 analyze 面板。" : "开发态 UI 已启动，开始生成第一份 analyze 结果。",
+					tags: reason === "watch" ? ["watch", "analyze"] : ["initial", "analyze"]
 				}]);
-				if (initialAnalyze.mode === "fallback") emitDashboardEvents(analyzeHandle, [{
+				const next = await runAnalyze();
+				if (next.mode === "fallback") emitDashboardEvents(analyzeHandle, [{
 					kind: "diagnostic",
 					level: "warning",
-					title: "initial analyze fallback enabled",
-					detail: initialAnalyze.fallbackReason ?? "完整分析不可用，已回退到 dist 文件扫描。",
-					durationMs: initialAnalyze.durationMs,
-					tags: [
-						"analyze",
-						"fallback",
-						"initial"
-					]
+					title: "analyze fallback enabled",
+					detail: next.fallbackReason ?? "完整分析不可用，已回退到 dist 文件扫描。",
+					durationMs: next.durationMs,
+					tags: ["analyze", "fallback"]
 				}]);
-				let updating = false;
-				if (analyzeHandle && buildResult && typeof buildResult.on === "function") buildResult.on("event", (event) => {
-					if (event.code !== "END" || updating) return;
-					updating = true;
-					triggerAnalyzeUpdate("watch").finally(() => {
-						updating = false;
+				await analyzeHandle.update(next.result);
+				emitDashboardEvents(analyzeHandle, [{
+					kind: next.mode === "fallback" ? "diagnostic" : "build",
+					level: next.mode === "fallback" ? "warning" : "success",
+					title: reason === "watch" ? "analyze refresh completed" : "initial analyze completed",
+					detail: next.mode === "fallback" ? `analyze 已回退到 dist 扫描，当前包含 ${next.result.packages.length} 个包。` : `analyze 已刷新完成，当前包含 ${next.result.packages.length} 个包与 ${next.result.modules.length} 个模块。`,
+					durationMs: next.durationMs,
+					tags: next.mode === "fallback" ? ["analyze", "fallback"] : ["analyze", reason === "watch" ? "refresh" : "initial"]
+				}]);
+			};
+			if (targets.runMini) {
+				const miniBuildStartedAt = Date.now();
+				const buildResult = await buildService.build(options);
+				logger_default.success(`小程序初次构建完成，耗时：${formatDuration(Date.now() - miniBuildStartedAt)}`);
+				if (enableAnalyze) {
+					const initialAnalyze = await runAnalyze();
+					analyzeHandle = await startAnalyzeDashboard(initialAnalyze.result, {
+						watch: true,
+						cwd: configService.cwd,
+						packageManagerAgent: configService.packageManager.agent,
+						silentStartupLog: true
+					}) ?? void 0;
+					emitDashboardEvents(analyzeHandle, [{
+						kind: "command",
+						level: "success",
+						title: "dev ui session ready",
+						detail: `开发态分析面板已启动，当前包含 ${initialAnalyze.result.packages.length} 个包。`,
+						durationMs: initialAnalyze.durationMs,
+						tags: ["dev", "ui"]
+					}]);
+					if (initialAnalyze.mode === "fallback") emitDashboardEvents(analyzeHandle, [{
+						kind: "diagnostic",
+						level: "warning",
+						title: "initial analyze fallback enabled",
+						detail: initialAnalyze.fallbackReason ?? "完整分析不可用，已回退到 dist 文件扫描。",
+						durationMs: initialAnalyze.durationMs,
+						tags: [
+							"analyze",
+							"fallback",
+							"initial"
+						]
+					}]);
+					let updating = false;
+					if (analyzeHandle && buildResult && typeof buildResult.on === "function") buildResult.on("event", (event) => {
+						if (event.code !== "END" || updating) return;
+						updating = true;
+						triggerAnalyzeUpdate("watch").finally(() => {
+							updating = false;
+						});
 					});
-				});
-				if (analyzeHandle) {
-					updating = true;
-					await triggerAnalyzeUpdate("initial");
-					updating = false;
+					if (analyzeHandle) {
+						updating = true;
+						await triggerAnalyzeUpdate("initial");
+						updating = false;
+					}
 				}
 			}
-		}
-		let webServer;
-		if (targets.runWeb) {
-			const webServerStartedAt = Date.now();
-			try {
-				webServer = await webService?.startDevServer();
-				emitDashboardEvents(analyzeHandle, [{
-					kind: "system",
-					level: "success",
-					title: "web dev server started",
-					detail: "Web 开发服务器已启动，可与小程序调试 UI 并行工作。",
-					durationMs: Date.now() - webServerStartedAt,
-					tags: ["dev", "web"]
-				}]);
-			} catch (error) {
+			let webServer;
+			if (targets.runWeb) {
+				const webServerStartedAt = Date.now();
+				try {
+					webServer = await webService?.startDevServer();
+					logger_default.success(`Web 开发服务启动完成，耗时：${formatDuration(Date.now() - webServerStartedAt)}`);
+					emitDashboardEvents(analyzeHandle, [{
+						kind: "system",
+						level: "success",
+						title: "web dev server started",
+						detail: "Web 开发服务器已启动，可与小程序调试 UI 并行工作。",
+						durationMs: Date.now() - webServerStartedAt,
+						tags: ["dev", "web"]
+					}]);
+				} catch (error) {
+					emitDashboardEvents(analyzeHandle, [{
+						kind: "diagnostic",
+						level: "error",
+						title: "web dev server failed",
+						detail: error instanceof Error ? error.message : String(error),
+						durationMs: Date.now() - webServerStartedAt,
+						tags: ["dev", "web"]
+					}]);
+					logger_default.error(error);
+					throw error;
+				}
+			}
+			if (targets.runMini) {
+				logBuildAppFinish(configService, webServer, {
+					skipWeb: !targets.runWeb,
+					uiUrls: analyzeHandle?.urls
+				});
+				devHotkeysSession?.restore();
+			} else if (targets.runWeb) logBuildAppFinish(configService, webServer, { skipMini: true });
+			if (options.open && targets.runMini) {
 				emitDashboardEvents(analyzeHandle, [{
-					kind: "diagnostic",
-					level: "error",
-					title: "web dev server failed",
-					detail: error instanceof Error ? error.message : String(error),
-					durationMs: Date.now() - webServerStartedAt,
-					tags: ["dev", "web"]
+					kind: "command",
+					level: "info",
+					title: "opening ide",
+					detail: "开发服务已就绪，准备打开 IDE 项目。",
+					tags: ["ide", "open"]
 				}]);
-				logger_default.error(error);
-				throw error;
+				if (!await maybeStartForwardConsole({
+					platform: configService.platform,
+					mpDistRoot: configService.mpDistRoot,
+					cwd: configService.cwd,
+					weappViteConfig: configService.weappViteConfig
+				})) await openIde(configService.platform, resolveIdeProjectRoot(configService.mpDistRoot, configService.cwd), { trustProject: options.trustProject });
+				devHotkeysSession?.restore();
 			}
+			if (analyzeHandle) await analyzeHandle.waitForExit();
+			else if (targets.runMini || targets.runWeb) await waitForServeShutdownSignal();
+		} finally {
+			devHotkeysSession?.close();
+			ctx.watcherService?.closeAll();
 		}
-		if (targets.runMini) logBuildAppFinish(configService, webServer, {
-			skipWeb: !targets.runWeb,
-			uiUrls: analyzeHandle?.urls
-		});
-		else if (targets.runWeb) logBuildAppFinish(configService, webServer, { skipMini: true });
-		if (options.open && targets.runMini) {
-			emitDashboardEvents(analyzeHandle, [{
-				kind: "command",
-				level: "info",
-				title: "opening ide",
-				detail: "开发服务已就绪，准备打开 IDE 项目。",
-				tags: ["ide", "open"]
-			}]);
-			if (!await maybeStartForwardConsole({
-				platform: configService.platform,
-				mpDistRoot: configService.mpDistRoot,
-				cwd: configService.cwd,
-				weappViteConfig: configService.weappViteConfig
-			})) await openIde(configService.platform, resolveIdeProjectRoot(configService.mpDistRoot, configService.cwd));
-		}
-		if (analyzeHandle) await analyzeHandle.waitForExit();
 	});
 }
 //#endregion
@@ -2031,13 +2434,12 @@ const SKIP_COMMANDS = new Set([
 	"ide",
 	"mcp"
 ]);
-const DEV_COMMANDS = new Set(["dev", "serve"]);
+const REG_EADDRINUSE = /EADDRINUSE/;
 let started = false;
 function shouldAutoStartMcp(argv) {
 	const command = argv[0];
 	if (!command || command.startsWith("-")) return true;
 	if (SKIP_COMMANDS.has(command)) return false;
-	if (DEV_COMMANDS.has(command)) return true;
 	return command.includes("/") || command.includes("\\") || command.startsWith(".");
 }
 async function maybeAutoStartMcpServer(argv, cliOptions) {
@@ -2067,7 +2469,7 @@ async function maybeAutoStartMcpServer(argv, cliOptions) {
 		logger_default.info(`  ➜  ${colors.cyan(mcpUrl)}`);
 	} catch (error) {
 		const message = error instanceof Error ? error.message : String(error);
-		if (/EADDRINUSE/.test(message)) {
+		if (REG_EADDRINUSE.test(message)) {
 			logger_default.info(`[mcp] 端口 ${resolvedMcp.port} 已被占用，跳过自动启动。`);
 			started = true;
 			return;
@@ -2147,22 +2549,19 @@ function resolveManagedTsconfigBootstrapRoot(args) {
 	return path.resolve(firstArg);
 }
 try {
-	Promise.resolve().then(async () => {
-		const args = process.argv.slice(2);
-		if (await tryRunIdeCommand(args)) return;
+	const args = process.argv.slice(2);
+	if (!await tryRunIdeCommand(args)) {
 		const managedTsconfigBootstrapRoot = resolveManagedTsconfigBootstrapRoot(args);
 		if (managedTsconfigBootstrapRoot) await syncManagedTsconfigBootstrapFiles(managedTsconfigBootstrapRoot);
 		cli.parse(process.argv, { run: false });
 		await maybeAutoStartMcpServer(args, cli.options);
 		await cli.runMatchedCommand();
-	}).catch((error) => {
-		if (handlePrepareLifecycleError(process.argv.slice(2), error)) return;
+	}
+} catch (error) {
+	if (!handlePrepareLifecycleError(process.argv.slice(2), error)) {
 		handleCLIError(error);
 		process.exitCode = 1;
-	});
-} catch (error) {
-	handleCLIError(error);
-	process.exitCode = 1;
+	}
 }
 //#endregion
 export {};