weapp-vite 6.15.0 → 6.15.3

package/dist/auto-routes.mjs

@@ -1,4 +1,4 @@
-import { i as getCompilerContext, u as getRouteRuntimeGlobalKeys } from "./createContext-DZzBkyLu.mjs";
+import { i as getCompilerContext, u as getRouteRuntimeGlobalKeys } from "./createContext-BuwQryVc.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,10 +1,10 @@
-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-DZzBkyLu.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-BuwQryVc.mjs";
 import { r as logger_default, t as colors } from "./logger-CgxdNjvb.mjs";
-import { m as VERSION } from "./file-DZdM8x0_.mjs";
+import { h as VERSION } from "./file-x_pM3sdN.mjs";
 import { a as resolveWeappMcpConfig, o as startWeappViteMcpServer } from "./mcp-DRlj32v4.mjs";
 import { createRequire } from "node:module";
-import { defu, fs } from "@weapp-core/shared";
 import path, { posix } from "pathe";
+import { defu, fs } from "@weapp-core/shared";
 import process from "node:process";
 import fs$1 from "node:fs/promises";
 import { build, createServer } from "vite";
@@ -1626,7 +1626,7 @@ function registerInitCommand(cli) {
 	});
 }
 //#endregion
-//#region src/cli/mcpClient.ts
+//#region src/cli/mcpClient/shared.ts
 const CODEX_BLOCK_PREFIX = "# >>> weapp-vite mcp ";
 const CODEX_BLOCK_SUFFIX = " >>>";
 const CODEX_BLOCK_END_PREFIX = "# <<< weapp-vite mcp ";
@@ -1710,6 +1710,9 @@ function resolveHttpEntry(client, url) {
 	};
 	return { url };
 }
+function resolveConfigEntry(client, transport, workspaceRoot, url) {
+	return transport === "http" ? resolveHttpEntry(client, url ?? "") : resolveCommandEntry(client, workspaceRoot);
+}
 function resolveCodexBlockPattern(serverName) {
 	const startMarker = `${CODEX_BLOCK_PREFIX}${serverName}${CODEX_BLOCK_SUFFIX}`;
 	const endMarker = `${CODEX_BLOCK_END_PREFIX}${serverName}${CODEX_BLOCK_END_SUFFIX}`;
@@ -1750,40 +1753,8 @@ function resolveTarget(client, workspaceRoot) {
 		serverName
 	};
 }
-function resolveSupportedMcpClient(input) {
-	if (input === "codex" || input === "claude-code" || input === "cursor") return input;
-	throw new Error(`不支持的 MCP 客户端：${input}。当前仅支持 codex、claude-code、cursor。`);
-}
-function buildMcpClientConfigPlan(options) {
-	const workspaceRoot = path.resolve(options.workspaceRoot);
-	const target = resolveTarget(options.client, workspaceRoot);
-	const entry = options.transport === "http" ? resolveHttpEntry(options.client, options.url ?? "") : resolveCommandEntry(options.client, workspaceRoot);
-	if (options.transport === "http" && !entry.url) throw new Error("HTTP 模式缺少 MCP 服务地址，请使用 --url 指定或在当前项目中检测到可用地址。");
-	return {
-		entry,
-		preview: target.client === "codex" ? renderCodexBlock(target.serverName, entry) : renderJsonPreview(target.serverName, entry),
-		target,
-		transport: options.transport
-	};
-}
-async function writeMcpClientConfig(plan) {
-	await fs.ensureDir(path.dirname(plan.target.configPath));
-	const existing = await fs.readFile(plan.target.configPath, "utf8").catch(() => "");
-	if (plan.target.client === "codex") {
-		const nextContent = upsertCodexManagedBlock(existing, plan.target.serverName, plan.preview);
-		await fs.writeFile(plan.target.configPath, nextContent, "utf8");
-		return;
-	}
-	const parsed = parseJsonConfig(existing, plan.target.configPath);
-	const nextConfig = {
-		...parsed,
-		mcpServers: {
-			...parsed.mcpServers ?? {},
-			[plan.target.serverName]: plan.entry
-		}
-	};
-	await fs.writeFile(plan.target.configPath, `${JSON.stringify(nextConfig, null, 2)}\n`, "utf8");
-}
+//#endregion
+//#region src/cli/mcpClient/inspect.ts
 async function probeHttpEndpoint(url) {
 	const controller = new AbortController();
 	const timer = setTimeout$1(() => {
@@ -1888,6 +1859,24 @@ async function inspectMcpClientConfig(options) {
 	if (target.client === "codex") return await inspectCodexConfig(target);
 	return await inspectJsonConfig(target);
 }
+//#endregion
+//#region src/cli/mcpClient/plan.ts
+function resolveSupportedMcpClient(input) {
+	if (input === "codex" || input === "claude-code" || input === "cursor") return input;
+	throw new Error(`不支持的 MCP 客户端：${input}。当前仅支持 codex、claude-code、cursor。`);
+}
+function buildMcpClientConfigPlan(options) {
+	const workspaceRoot = path.resolve(options.workspaceRoot);
+	const target = resolveTarget(options.client, workspaceRoot);
+	const entry = resolveConfigEntry(options.client, options.transport, workspaceRoot, options.url);
+	if (options.transport === "http" && !entry.url) throw new Error("HTTP 模式缺少 MCP 服务地址，请使用 --url 指定或在当前项目中检测到可用地址。");
+	return {
+		entry,
+		preview: target.client === "codex" ? renderCodexBlock(target.serverName, entry) : renderJsonPreview(target.serverName, entry),
+		target,
+		transport: options.transport
+	};
+}
 function formatMcpQuickStart(options) {
 	const suffix = options.transport === "http" && options.httpUrl ? ` --transport http --url ${options.httpUrl}` : "";
 	return [
@@ -1898,6 +1887,26 @@ function formatMcpQuickStart(options) {
 	];
 }
 //#endregion
+//#region src/cli/mcpClient/index.ts
+async function writeMcpClientConfig(plan) {
+	await fs.ensureDir(path.dirname(plan.target.configPath));
+	const existing = await fs.readFile(plan.target.configPath, "utf8").catch(() => "");
+	if (plan.target.client === "codex") {
+		const nextContent = upsertCodexManagedBlock(existing, plan.target.serverName, plan.preview);
+		await fs.writeFile(plan.target.configPath, nextContent, "utf8");
+		return;
+	}
+	const parsed = parseJsonConfig(existing, plan.target.configPath);
+	const nextConfig = {
+		...parsed,
+		mcpServers: {
+			...parsed.mcpServers ?? {},
+			[plan.target.serverName]: plan.entry
+		}
+	};
+	await fs.writeFile(plan.target.configPath, `${JSON.stringify(nextConfig, null, 2)}\n`, "utf8");
+}
+//#endregion
 //#region src/cli/commands/mcp.ts
 function resolvePort(port) {
 	if (typeof port === "number" && Number.isInteger(port)) return port;
@@ -2068,25 +2077,13 @@ function registerPrepareCommand(cli) {
 }
 //#endregion
 //#region package.json
-var version = "6.15.0";
+var version = "6.15.3";
 //#endregion
-//#region src/cli/devHotkeys.ts
-const DEV_SCREENSHOT_DIR = ".weapp-vite/dev-screenshots";
-const DEFAULT_SCREENSHOT_TIMEOUT = 3e4;
-const REG_PENDING_PREFIX = /^正在/;
+//#region src/cli/devHotkeys/format.ts
 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");
-}
+const REG_PENDING_PREFIX = /^正在/;
 function formatProjectLabel(cwd) {
 	return path.basename(cwd) || cwd;
 }
@@ -2157,6 +2154,59 @@ function formatDevHotkeyHintWithState(state) {
 	if (state.currentAction) return `${formatFooterLine(state)}，按 ${key("h")} 显示帮助，按 ${key("q")} 退出`;
 	return `开发快捷键已就绪，按 ${key("h")} 显示帮助，按 ${key("q")} 退出`;
 }
+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;
+}
+function resolveProjectLabel(cwd) {
+	return formatProjectLabel(cwd);
+}
+//#endregion
+//#region src/cli/devHotkeys/mcp.ts
+function formatMcpUrl(host, port, endpoint) {
+	return `http://${host}:${port}${endpoint}`;
+}
+function createToggleMcpAction(options) {
+	const { cwd, getHandle, resolvedMcp, setHandle } = options;
+	return async function toggleMcp() {
+		if (!resolvedMcp.enabled) {
+			logger_default.warn("[dev action] MCP 已在配置中禁用，跳过切换。");
+			return "MCP 已禁用";
+		}
+		const existingHandle = getHandle();
+		if (existingHandle?.close) {
+			const url = formatMcpUrl(resolvedMcp.host, resolvedMcp.port, resolvedMcp.endpoint);
+			logger_default.info(`[dev action] 正在关闭 MCP 服务：${colors.cyan(url)}`);
+			await existingHandle.close();
+			setHandle(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)}`);
+		setHandle(await startWeappViteMcpServer({
+			endpoint: resolvedMcp.endpoint,
+			host: resolvedMcp.host,
+			port: resolvedMcp.port,
+			transport: "streamable-http",
+			unref: false,
+			workspaceRoot: cwd
+		}));
+		logger_default.success(`[dev action] MCP 服务已启动：${colors.cyan(url)}`);
+		for (const line of formatMcpQuickStart({
+			httpUrl: url,
+			transport: "http"
+		})) logger_default.info(line);
+		return `MCP 已启动 (${url})`;
+	};
+}
+//#endregion
+//#region src/cli/devHotkeys/screenshot.ts
+const DEV_SCREENSHOT_DIR = ".weapp-vite/dev-screenshots";
+const DEFAULT_SCREENSHOT_TIMEOUT = 3e4;
 /**
 * @description 生成开发态截图输出路径。
 */
@@ -2172,13 +2222,6 @@ function formatLogPath(cwd, targetPath) {
 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 执行当前页面截图并输出结果日志。
 */
@@ -2197,6 +2240,14 @@ async function runScreenshotAction(options) {
 	logger_default.success(`[dev action] 当前页面截图完成：${colors.cyan(resolvedPath)}`);
 	return resolvedPath;
 }
+//#endregion
+//#region src/cli/devHotkeys/index.ts
+function forwardSigint() {
+	process.kill(process.pid, "SIGINT");
+}
+function forwardSigtstp() {
+	process.kill(process.pid, "SIGTSTP");
+}
 /**
 * @description 在开发态启动终端快捷键，并将动作输出到本地日志。
 */
@@ -2222,7 +2273,7 @@ function startDevHotkeys(options) {
 		lastAction,
 		mcpEnabled: resolvedMcp.enabled,
 		mcpRunning: Boolean(mcpHandle?.close),
-		projectLabel: formatProjectLabel(options.cwd)
+		projectLabel: resolveProjectLabel(options.cwd)
 	});
 	const detachTerminal = () => {
 		if (hasSetRawMode) process.stdin.setRawMode(false);
@@ -2279,36 +2330,14 @@ function startDevHotkeys(options) {
 		detachTerminal();
 		forwardSigtstp();
 	};
-	const toggleMcp = async () => {
-		if (!resolvedMcp.enabled) {
-			logger_default.warn("[dev action] MCP 已在配置中禁用，跳过切换。");
-			return "MCP 已禁用";
+	const toggleMcp = createToggleMcpAction({
+		cwd: options.cwd,
+		getHandle: () => mcpHandle,
+		resolvedMcp,
+		setHandle: (handle) => {
+			mcpHandle = handle;
 		}
-		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)}`);
-		for (const line of formatMcpQuickStart({
-			httpUrl: url,
-			transport: "http"
-		})) logger_default.info(line);
-		return `MCP 已启动 (${url})`;
-	};
+	});
 	const runAction = (label, pendingLabel, action) => {
 		if (running) {
 			const current = currentAction ?? "已有命令";
@@ -2363,12 +2392,12 @@ function startDevHotkeys(options) {
 	const handleInputOnce = (input, source) => {
 		const normalizedInput = normalizeInputChar(input);
 		const now = Date.now();
-		for (const [token, timestamp] of recentInputs) if (now - Number(timestamp.split(":")[1] ?? 0) > HOTKEY_DEDUP_WINDOW_MS) recentInputs.delete(token);
+		for (const [token, timestamp] of recentInputs) if (now - Number(timestamp.split(":")[1] ?? 0) > 32) 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;
+			if (recentSource !== source && now - Number(recentTimestamp) <= 32) return;
 		}
 		recentInputs.set(dedupKey, `${source}:${now}`);
 		handleInput(normalizedInput);
@@ -2404,32 +2433,15 @@ function startDevHotkeys(options) {
 	};
 }
 //#endregion
-//#region src/cli/commands/serve.ts
+//#region src/cli/commands/serve/analyze.ts
+const REG_DIST_PAGE_ENTRY = /pages\/.+\/index\.js$/;
+const REG_DIST_POSIX_SEP = /\\/g;
 function emitDashboardEvents(handle, events) {
 	handle?.emitRuntimeEvents(events);
 }
-function resolveWebHost(host) {
-	if (host === void 0) return;
-	if (typeof host === "boolean") return host;
-	if (typeof host === "string") return host;
-	return String(host);
-}
-const REG_DIST_PAGE_ENTRY = /pages\/.+\/index\.js$/;
-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 = [];
@@ -2503,6 +2515,153 @@ async function analyzeUiFallback(ctx) {
 		})).filter((item) => item.root).sort((a, b) => a.root.localeCompare(b.root))
 	};
 }
+function createAnalyzeController(options) {
+	const { configFile, ctx, options: cliOptions, targets } = options;
+	const { configService } = ctx;
+	let analyzeRunId = 0;
+	let analyzeHandle;
+	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: cliOptions.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: "完整分析结果为空，已回退到 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"]
+		}]);
+	};
+	const bindWatcher = (buildResult) => {
+		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;
+			});
+		});
+		return { async runInitialUpdate() {
+			if (analyzeHandle) {
+				updating = true;
+				await triggerAnalyzeUpdate("initial");
+				updating = false;
+			}
+		} };
+	};
+	return {
+		getHandle: () => analyzeHandle,
+		async startDashboard(startDashboard) {
+			const initialAnalyze = await runAnalyze();
+			analyzeHandle = await startDashboard(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"
+				]
+			}]);
+		},
+		bindWatcher,
+		emitRuntimeEvents(events) {
+			emitDashboardEvents(analyzeHandle, events);
+		},
+		waitForExit() {
+			return analyzeHandle?.waitForExit();
+		}
+	};
+}
+//#endregion
+//#region src/cli/commands/serve/shared.ts
+function resolveWebHost(host) {
+	if (host === void 0) return;
+	if (typeof host === "boolean") return host;
+	if (typeof host === "string") return host;
+	return String(host);
+}
+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);
+	});
+}
+//#endregion
+//#region src/cli/commands/serve/index.ts
 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("--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);
@@ -2551,7 +2710,6 @@ function registerServeCommand(cli) {
 		logRuntimeTarget(targets, { resolvedConfigPlatform: configService.platform });
 		const enableAnalyze = Boolean(isUiEnabled(options) && targets.runMini);
 		let analyzeHandle;
-		let analyzeRunId = 0;
 		const devHotkeysSession = targets.runMini ? startDevHotkeys({
 			cwd: configService.cwd,
 			mcpConfig: configService.weappViteConfig?.mcp,
@@ -2560,115 +2718,20 @@ function registerServeCommand(cli) {
 			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: "完整分析结果为空，已回退到 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"]
-				}]);
-			};
+			const analyzeController = createAnalyzeController({
+				configFile,
+				ctx,
+				options,
+				targets
+			});
 			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;
-					}
+					await analyzeController.startDashboard(startAnalyzeDashboard);
+					analyzeHandle = analyzeController.getHandle();
+					await analyzeController.bindWatcher(buildResult).runInitialUpdate();
 				}
 			}
 			let webServer;
@@ -2677,7 +2740,7 @@ function registerServeCommand(cli) {
 				try {
 					webServer = await webService?.startDevServer();
 					logger_default.success(`Web 开发服务启动完成，耗时：${formatDuration(Date.now() - webServerStartedAt)}`);
-					emitDashboardEvents(analyzeHandle, [{
+					analyzeController.emitRuntimeEvents([{
 						kind: "system",
 						level: "success",
 						title: "web dev server started",
@@ -2686,7 +2749,7 @@ function registerServeCommand(cli) {
 						tags: ["dev", "web"]
 					}]);
 				} catch (error) {
-					emitDashboardEvents(analyzeHandle, [{
+					analyzeController.emitRuntimeEvents([{
 						kind: "diagnostic",
 						level: "error",
 						title: "web dev server failed",
@@ -2706,7 +2769,7 @@ function registerServeCommand(cli) {
 				devHotkeysSession?.restore();
 			} else if (targets.runWeb) logBuildAppFinish(configService, webServer, { skipMini: true });
 			if (options.open && targets.runMini) {
-				emitDashboardEvents(analyzeHandle, [{
+				analyzeController.emitRuntimeEvents([{
 					kind: "command",
 					level: "info",
 					title: "opening ide",
@@ -2721,7 +2784,7 @@ function registerServeCommand(cli) {
 				})) await openIde(configService.platform, resolveIdeProjectRoot(configService.mpDistRoot, configService.cwd), { trustProject: options.trustProject });
 				devHotkeysSession?.restore();
 			}
-			if (analyzeHandle) await analyzeHandle.waitForExit();
+			if (analyzeHandle) await analyzeController.waitForExit();
 			else if (targets.runMini || targets.runWeb) await waitForServeShutdownSignal();
 		} finally {
 			devHotkeysSession?.close();