weapp-vite 6.11.9 → 6.12.0

package/dist/auto-routes.mjs

@@ -1,4 +1,4 @@
-import { i as getCompilerContext } from "./createContext-DZgOqIMU.mjs";
+import { i as getCompilerContext, l as getRouteRuntimeGlobalKeys } from "./createContext-Cy_160Dm.mjs";
 //#region src/auto-routes.ts
 const ROUTE_RUNTIME_OVERRIDE_KEY = Symbol.for("weapp-vite.route-runtime");
 function createGetter(resolver) {
@@ -28,7 +28,10 @@ function resolveMiniProgramGlobal() {
 	const runtime = globalThis;
 	const overrideRuntime = runtime[ROUTE_RUNTIME_OVERRIDE_KEY];
 	if (overrideRuntime) return overrideRuntime;
-	return runtime.wx ?? runtime.tt ?? runtime.my;
+	for (const key of getRouteRuntimeGlobalKeys()) {
+		const candidate = runtime[key];
+		if (candidate) return candidate;
+	}
 }
 function callRouteMethod(methodName, option) {
 	const miniProgramGlobal = resolveMiniProgramGlobal();

package/dist/cli.mjs

@@ -1,6 +1,6 @@
-import { _ as isPathInside, c as normalizeMiniPlatform, d as SHARED_CHUNK_VIRTUAL_PREFIX, f as resolveWeappConfigFile, g as createCjsConfigLoadError, h as parseCommentJson, l as resolveMiniPlatform, m as getProjectConfigFileName, n as syncProjectSupportFiles, o as formatBytes, p as checkRuntime, r as syncManagedTsconfigBootstrapFiles, s as DEFAULT_MP_PLATFORM, t as createCompilerContext, u as createSharedBuildConfig } from "./createContext-DZgOqIMU.mjs";
+import { _ as normalizeMiniPlatform, b as isPathInside, c as SHARED_CHUNK_VIRTUAL_PREFIX, d as checkRuntime, f as getProjectConfigFileName, g as getDefaultIdeProjectRoot, h as DEFAULT_MP_PLATFORM, m as createCjsConfigLoadError, n as syncProjectSupportFiles, o as formatBytes, p as parseCommentJson, r as syncManagedTsconfigBootstrapFiles, s as createSharedBuildConfig, t as createCompilerContext, u as resolveWeappConfigFile, v as resolveMiniPlatform, y as shouldPassPlatformArgToIdeOpen } from "./createContext-Cy_160Dm.mjs";
 import { r as logger_default, t as colors } from "./logger-gutcwWKE.mjs";
-import { f as VERSION } from "./file-rRQhPOL8.mjs";
+import { p as VERSION } from "./file-DKg072cZ.mjs";
 import { resolveWeappMcpConfig, startWeappViteMcpServer } from "./mcp.mjs";
 import { createRequire } from "node:module";
 import { defu } from "@weapp-core/shared";
@@ -22,6 +22,20 @@ import { initConfig } from "@weapp-core/init";
 //#region src/analyze/subpackages/classifier.ts
 const VIRTUAL_MODULE_INDICATOR = "\0";
 const VIRTUAL_PREFIX = `${SHARED_CHUNK_VIRTUAL_PREFIX}/`;
+function classifyModuleSourceKind(options) {
+	if (options.isNodeModule) return "node_modules";
+	if (options.inSrc) return "src";
+	if (options.inPlugin) return "plugin";
+	return "workspace";
+}
+function resolvePluginAssetAbsolute(normalizedFileName, pluginRoot) {
+	if (!pluginRoot) return;
+	const pluginBase = posix.basename(pluginRoot);
+	if (normalizedFileName !== pluginBase && !normalizedFileName.startsWith(`${pluginBase}/`)) return;
+	const relative = normalizedFileName === pluginBase ? "" : normalizedFileName.slice(pluginBase.length + 1);
+	const absolute = posix.resolve(pluginRoot, relative);
+	return isPathInside(pluginRoot, absolute) ? absolute : void 0;
+}
 function classifyPackage(fileName, origin, context) {
 	if (fileName.startsWith(VIRTUAL_PREFIX)) {
 		const combination = fileName.slice(VIRTUAL_PREFIX.length).split("/")[0] || "shared";
@@ -56,13 +70,11 @@ function resolveModuleSourceType(absoluteId, ctx) {
 	const isNodeModule = absoluteId.includes("/node_modules/") || absoluteId.includes("\\node_modules\\");
 	const pluginRoot = configService.absolutePluginRoot;
 	const srcRoot = configService.absoluteSrcRoot;
-	const inSrc = isPathInside(srcRoot, absoluteId);
-	const inPlugin = pluginRoot ? isPathInside(pluginRoot, absoluteId) : false;
-	let sourceType;
-	if (isNodeModule) sourceType = "node_modules";
-	else if (inSrc) sourceType = "src";
-	else if (inPlugin) sourceType = "plugin";
-	else sourceType = "workspace";
+	const sourceType = classifyModuleSourceKind({
+		isNodeModule,
+		inSrc: isPathInside(srcRoot, absoluteId),
+		inPlugin: pluginRoot ? isPathInside(pluginRoot, absoluteId) : false
+	});
 	return {
 		source: configService.relativeAbsoluteSrcRoot(absoluteId),
 		sourceType
@@ -77,19 +89,12 @@ function resolveAssetSource(fileName, ctx) {
 		source: configService.relativeAbsoluteSrcRoot(srcCandidate),
 		sourceType: "src"
 	};
-	const pluginRoot = configService.absolutePluginRoot;
-	if (pluginRoot) {
-		const pluginBase = posix.basename(pluginRoot);
-		if (normalized === pluginBase || normalized.startsWith(`${pluginBase}/`)) {
-			const relative = normalized === pluginBase ? "" : normalized.slice(pluginBase.length + 1);
-			const absolute = posix.resolve(pluginRoot, relative);
-			if (isPathInside(pluginRoot, absolute)) return {
-				absolute,
-				source: configService.relativeAbsoluteSrcRoot(absolute),
-				sourceType: "plugin"
-			};
-		}
-	}
+	const pluginAbsolute = resolvePluginAssetAbsolute(normalized, configService.absolutePluginRoot);
+	if (pluginAbsolute) return {
+		absolute: pluginAbsolute,
+		source: configService.relativeAbsoluteSrcRoot(pluginAbsolute),
+		sourceType: "plugin"
+	};
 }
 //#endregion
 //#region src/analyze/subpackages/registry.ts
@@ -315,14 +320,32 @@ async function analyzeSubpackages(ctx) {
 //#endregion
 //#region src/cli/analyze/dashboard.ts
 const ANALYZE_GLOBAL_KEY = "__WEAPP_VITE_ANALYZE_RESULT__";
+const DASHBOARD_EVENTS_GLOBAL_KEY = "__WEAPP_VITE_DASHBOARD_EVENTS__";
 const ANALYZE_DASHBOARD_PACKAGE_NAME = "@weapp-vite/dashboard";
 const ANALYZE_SSE_PATH = "/__weapp_vite_analyze";
+const DASHBOARD_EVENT_NAME = "weapp-dashboard:event";
 const require = createRequire(import.meta.url);
 function createInstallCommand(agent) {
 	const resolved = resolveCommand(agent ?? "npm", "install", [ANALYZE_DASHBOARD_PACKAGE_NAME]);
 	if (!resolved) return `npm install ${ANALYZE_DASHBOARD_PACKAGE_NAME}`;
 	return `${resolved.command} ${resolved.args.join(" ")}`;
 }
+function formatEventTimestamp(date = /* @__PURE__ */ new Date()) {
+	return date.toLocaleTimeString("zh-CN", { hour12: false });
+}
+function createDashboardRuntimeEvent(input) {
+	return {
+		id: `dashboard:${Date.now()}:${Math.random().toString(36).slice(2, 8)}`,
+		kind: input.kind,
+		level: input.level,
+		title: input.title,
+		detail: input.detail,
+		timestamp: formatEventTimestamp(),
+		source: input.source ?? "weapp-vite",
+		durationMs: input.durationMs,
+		tags: input.tags
+	};
+}
 function readDashboardManifest(packageJsonPath) {
 	try {
 		return parseCommentJson(fs$2.readFileSync(packageJsonPath, "utf8"));
@@ -371,13 +394,25 @@ function resolveDashboardRoot(options) {
 	logger_default.warn(`[weapp-vite ui] 未安装可选仪表盘包 ${colors.bold(colors.green(ANALYZE_DASHBOARD_PACKAGE_NAME))}，已自动降级关闭 dashboard 能力。`);
 	logger_default.info(`如需启用，请执行 ${colors.bold(colors.green(createInstallCommand(options?.packageManagerAgent)))}`);
 }
-function createAnalyzeHtmlPlugin(state, onServerInstance, onBroadcastReady) {
+function createAnalyzeHtmlPlugin(state, runtimeEvents, onServerInstance, onBroadcastReady) {
 	const sseClients = /* @__PURE__ */ new Set();
 	const hotBridgeScript = `
     const applyAnalyzePayload = (payload) => {
       window.${ANALYZE_GLOBAL_KEY} = payload
       window.dispatchEvent(new CustomEvent('weapp-analyze:update', { detail: payload }))
     }
+    const applyDashboardEvents = (payload) => {
+      const events = Array.isArray(payload) ? payload : [payload]
+      const nextEvents = events.filter(Boolean)
+      if (nextEvents.length === 0) {
+        return
+      }
+      window.${DASHBOARD_EVENTS_GLOBAL_KEY} = [
+        ...(window.${DASHBOARD_EVENTS_GLOBAL_KEY} ?? []),
+        ...nextEvents,
+      ]
+      window.dispatchEvent(new CustomEvent('${DASHBOARD_EVENT_NAME}', { detail: nextEvents }))
+    }
     const source = new EventSource('${ANALYZE_SSE_PATH}')
     source.onmessage = (event) => {
       try {
@@ -389,6 +424,9 @@ function createAnalyzeHtmlPlugin(state, onServerInstance, onBroadcastReady) {
       import.meta.hot.on('weapp-analyze:update', (payload) => {
         applyAnalyzePayload(payload)
       })
+      import.meta.hot.on('${DASHBOARD_EVENT_NAME}', (payload) => {
+        applyDashboardEvents(payload)
+      })
     }
   `.trim();
 	const broadcast = (payload) => {
@@ -407,6 +445,11 @@ function createAnalyzeHtmlPlugin(state, onServerInstance, onBroadcastReady) {
 						children: `window.${ANALYZE_GLOBAL_KEY} = ${JSON.stringify(state.current)}`,
 						injectTo: "head-prepend"
 					},
+					{
+						tag: "script",
+						children: `window.${DASHBOARD_EVENTS_GLOBAL_KEY} = ${JSON.stringify(runtimeEvents.current)}`,
+						injectTo: "head-prepend"
+					},
 					{
 						tag: "script",
 						attrs: {
@@ -475,9 +518,16 @@ async function startAnalyzeDashboard(result, options) {
 	if (!resolved) return;
 	const { root, configFile } = resolved;
 	const state = { current: result };
+	const runtimeEvents = { current: [createDashboardRuntimeEvent({
+		kind: "command",
+		level: "success",
+		title: options?.watch ? "dashboard watch session started" : "dashboard static session started",
+		detail: options?.watch ? "weapp-vite UI 已进入实时分析模式，后续 analyze 结果会继续推送到 dashboard。" : "weapp-vite UI 已进入静态分析模式，当前页面展示的是一次性分析结果。",
+		tags: options?.watch ? ["watch", "analyze"] : ["static", "analyze"]
+	})] };
 	let serverRef;
 	let broadcastAnalyzeResult;
-	const plugins = [createAnalyzeHtmlPlugin(state, (server) => {
+	const plugins = [createAnalyzeHtmlPlugin(state, runtimeEvents, (server) => {
 		serverRef = server;
 	}, (broadcast) => {
 		broadcastAnalyzeResult = broadcast;
@@ -507,15 +557,39 @@ async function startAnalyzeDashboard(result, options) {
 		return [...resolved.local ?? [], ...resolved.network ?? []];
 	})();
 	const waitPromise = waitForServerExit(server);
-	if (serverRef?.ws) serverRef.ws.send({
-		type: "custom",
-		event: "weapp-analyze:update",
-		data: state.current
-	});
+	if (serverRef?.ws) {
+		serverRef.ws.send({
+			type: "custom",
+			event: "weapp-analyze:update",
+			data: state.current
+		});
+		serverRef.ws.send({
+			type: "custom",
+			event: DASHBOARD_EVENT_NAME,
+			data: runtimeEvents.current
+		});
+	}
 	broadcastAnalyzeResult?.(state.current);
+	const emitRuntimeEvents = (events) => {
+		if (events.length === 0) return;
+		const nextEvents = events.map((event) => createDashboardRuntimeEvent(event));
+		runtimeEvents.current = [...nextEvents, ...runtimeEvents.current].slice(0, 24);
+		if (serverRef) serverRef.ws.send({
+			type: "custom",
+			event: DASHBOARD_EVENT_NAME,
+			data: nextEvents
+		});
+	};
 	const handle = {
 		async update(nextResult) {
 			state.current = nextResult;
+			emitRuntimeEvents([{
+				kind: "build",
+				level: "info",
+				title: "analyze payload refreshed",
+				detail: `已推送新的 analyze 结果，当前包含 ${nextResult.packages.length} 个包与 ${nextResult.modules.length} 个模块。`,
+				tags: ["analyze", "refresh"]
+			}]);
 			if (serverRef) serverRef.ws.send({
 				type: "custom",
 				event: "weapp-analyze:update",
@@ -523,6 +597,7 @@ async function startAnalyzeDashboard(result, options) {
 			});
 			broadcastAnalyzeResult?.(nextResult);
 		},
+		emitRuntimeEvents,
 		waitForExit: () => waitPromise,
 		close: async () => {
 			await server.close();
@@ -883,10 +958,69 @@ function logBuildPackageSizeReport(options) {
 //#endregion
 //#region src/cli/openIde.ts
 const execFileAsync = promisify(execFile);
+/**
+* @description 执行 IDE 打开流程，并在登录失效时允许按键重试。
+*/
+async function runWechatIdeOpenWithRetry(argv) {
+	let retrying = true;
+	while (retrying) try {
+		await parse(argv);
+		return;
+	} catch (error) {
+		if (!isWechatIdeLoginRequiredError(error)) {
+			logger_default.error(error);
+			return;
+		}
+		logger_default.error("检测到微信开发者工具登录状态失效，请先登录后重试。");
+		logger_default.warn(formatWechatIdeLoginRequiredError(error));
+		logger_default.info(formatRetryHotkeyPrompt());
+		if (!await waitForRetryKeypress()) {
+			logger_default.warn("已取消重试。完成登录后请重新执行当前命令。");
+			retrying = false;
+			continue;
+		}
+		logger_default.info(colors.bold(colors.green("正在重试连接微信开发者工具...")));
+	}
+}
+async function closeIdeByAppleScript() {
+	if (process.platform !== "darwin") return false;
+	const appName = process.env.WEAPP_DEVTOOLS_APP_NAME || "wechatwebdevtools";
+	try {
+		await execFileAsync("osascript", ["-e", `tell application "${appName}" to quit`]);
+		return true;
+	} catch {
+		return false;
+	}
+}
+async function closeIdeByProcessKill(cliPath) {
+	if (!cliPath) return false;
+	const appContentsRoot = cliPath.includes(".app/") ? cliPath.slice(0, cliPath.indexOf(".app/") + 4) : path.dirname(path.dirname(cliPath));
+	try {
+		await execFileAsync("pkill", ["-f", appContentsRoot]);
+		return true;
+	} catch {
+		return false;
+	}
+}
+/**
+* @description 根据 mpDistRoot 推导 IDE 项目目录（目录内应包含 project/mini 配置）
+*/
+function resolveIdeProjectPath(mpDistRoot) {
+	if (!mpDistRoot || !mpDistRoot.trim()) return;
+	const parent = path.dirname(mpDistRoot);
+	if (!parent || parent === "." || parent === "/") return;
+	return parent;
+}
+/**
+* @description 结合 mpDistRoot 与配置根目录解析最终 IDE 项目目录。
+*/
+function resolveIdeProjectRoot(mpDistRoot, cwd) {
+	return resolveIdeProjectPath(mpDistRoot) ?? cwd;
+}
 async function openIde(platform, projectPath) {
 	const argv = ["open", "-p"];
 	if (projectPath) argv.push(projectPath);
-	if (platform === "alipay") argv.push("--platform", platform);
+	if (shouldPassPlatformArgToIdeOpen(platform)) argv.push("--platform", platform);
 	await runWechatIdeOpenWithRetry(argv);
 }
 async function closeIde() {
@@ -941,73 +1075,31 @@ async function resolveIdeCommandContext(options) {
 			mpDistRoot: ctx.configService.mpDistRoot
 		};
 	} catch {}
-	if (!projectPath && platform === "alipay") projectPath = resolveIdeProjectRoot("dist/alipay/dist", cwd);
+	if (!projectPath) {
+		const defaultProjectRoot = getDefaultIdeProjectRoot(platform);
+		if (defaultProjectRoot) projectPath = resolveIdeProjectRoot(defaultProjectRoot, cwd);
+	}
 	return {
 		platform,
 		projectPath
 	};
 }
-/**
-* @description 执行 IDE 打开流程，并在登录失效时允许按键重试。
-*/
-async function runWechatIdeOpenWithRetry(argv) {
-	let retrying = true;
-	while (retrying) try {
-		await parse(argv);
-		return;
-	} catch (error) {
-		if (!isWechatIdeLoginRequiredError(error)) {
-			logger_default.error(error);
-			return;
-		}
-		logger_default.error("检测到微信开发者工具登录状态失效，请先登录后重试。");
-		logger_default.warn(formatWechatIdeLoginRequiredError(error));
-		logger_default.info(formatRetryHotkeyPrompt());
-		if (!await waitForRetryKeypress()) {
-			logger_default.warn("已取消重试。完成登录后请重新执行当前命令。");
-			retrying = false;
-			continue;
-		}
-		logger_default.info(colors.bold(colors.green("正在重试连接微信开发者工具...")));
-	}
-}
-async function closeIdeByAppleScript() {
-	if (process.platform !== "darwin") return false;
-	const appName = process.env.WEAPP_DEVTOOLS_APP_NAME || "wechatwebdevtools";
-	try {
-		await execFileAsync("osascript", ["-e", `tell application "${appName}" to quit`]);
-		return true;
-	} catch {
-		return false;
-	}
-}
-async function closeIdeByProcessKill(cliPath) {
-	if (!cliPath) return false;
-	const appContentsRoot = cliPath.includes(".app/") ? cliPath.slice(0, cliPath.indexOf(".app/") + 4) : path.dirname(path.dirname(cliPath));
-	try {
-		await execFileAsync("pkill", ["-f", appContentsRoot]);
-		return true;
-	} catch {
-		return false;
-	}
+//#endregion
+//#region src/cli/commands/build.ts
+function isSassEmbeddedChild(handle) {
+	return Boolean(handle && typeof handle === "object" && "kill" in handle && "spawnfile" in handle && typeof handle.spawnfile === "string" && handle.spawnfile?.includes("sass-embedded"));
 }
-/**
-* @description 根据 mpDistRoot 推导 IDE 项目目录（目录内应包含 project/mini 配置）
-*/
-function resolveIdeProjectPath(mpDistRoot) {
-	if (!mpDistRoot || !mpDistRoot.trim()) return;
-	const parent = path.dirname(mpDistRoot);
-	if (!parent || parent === "." || parent === "/") return;
-	return parent;
+function terminateStaleSassEmbeddedProcess() {
+	const getHandles = process._getActiveHandles;
+	const handles = typeof getHandles === "function" ? getHandles() : void 0;
+	if (!Array.isArray(handles)) return;
+	for (const handle of handles) if (isSassEmbeddedChild(handle)) try {
+		handle.kill();
+	} catch {}
 }
-/**
-* @description 结合 mpDistRoot 与配置根目录解析最终 IDE 项目目录。
-*/
-function resolveIdeProjectRoot(mpDistRoot, cwd) {
-	return resolveIdeProjectPath(mpDistRoot) ?? cwd;
+function emitDashboardEvents$1(handle, events) {
+	handle?.emitRuntimeEvents(events);
 }
-//#endregion
-//#region src/cli/commands/build.ts
 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) => {
 		filterDuplicateOptions(options);
@@ -1027,44 +1119,73 @@ function registerBuildCommand(cli) {
 		const enableAnalyze = Boolean(isUiEnabled(options) && targets.runMini);
 		let analyzeHandle;
 		if (targets.runMini) {
+			const miniBuildStartedAt = Date.now();
 			const output = await buildService.build(options);
 			if (!Array.isArray(output) && "output" in output) logBuildPackageSizeReport({
 				output,
 				subPackageMap: ctx.scanService?.subPackageMap,
 				warningBytes: configService.weappViteConfig.packageSizeWarningBytes
 			});
-			if (enableAnalyze) analyzeHandle = await startAnalyzeDashboard(await analyzeSubpackages(ctx), {
-				watch: true,
-				cwd: configService.cwd,
-				packageManagerAgent: configService.packageManager.agent
-			}) ?? void 0;
+			if (enableAnalyze) {
+				const analyzeResult = await analyzeSubpackages(ctx);
+				analyzeHandle = await startAnalyzeDashboard(analyzeResult, {
+					watch: true,
+					cwd: configService.cwd,
+					packageManagerAgent: configService.packageManager.agent
+				}) ?? void 0;
+				emitDashboardEvents$1(analyzeHandle, [{
+					kind: "build",
+					level: "success",
+					title: "mini build completed",
+					detail: `生产构建已完成，当前 analyze 结果包含 ${analyzeResult.packages.length} 个包。`,
+					durationMs: Date.now() - miniBuildStartedAt,
+					tags: ["build", "mini"]
+				}]);
+			}
 		}
 		const webConfig = configService.weappWebConfig;
-		if (targets.runWeb && webConfig?.enabled) try {
-			await webService?.build();
-			logger_default.success(`Web 构建完成，输出目录：${colors.green(configService.relativeCwd(webConfig.outDir))}`);
-		} catch (error) {
-			logger_default.error(error);
-			throw error;
+		if (targets.runWeb && webConfig?.enabled) {
+			const webBuildStartedAt = Date.now();
+			try {
+				await webService?.build();
+				logger_default.success(`Web 构建完成，输出目录：${colors.green(configService.relativeCwd(webConfig.outDir))}`);
+				emitDashboardEvents$1(analyzeHandle, [{
+					kind: "build",
+					level: "success",
+					title: "web build completed",
+					detail: `Web 构建已完成，输出目录 ${configService.relativeCwd(webConfig.outDir)}。`,
+					durationMs: Date.now() - webBuildStartedAt,
+					tags: ["build", "web"]
+				}]);
+			} catch (error) {
+				emitDashboardEvents$1(analyzeHandle, [{
+					kind: "diagnostic",
+					level: "error",
+					title: "web build failed",
+					detail: error instanceof Error ? error.message : String(error),
+					durationMs: Date.now() - webBuildStartedAt,
+					tags: ["build", "web"]
+				}]);
+				logger_default.error(error);
+				throw error;
+			}
 		}
 		if (targets.runMini) logBuildAppFinish(configService, void 0, { skipWeb: !targets.runWeb });
-		if (options.open && targets.runMini) await openIde(configService.platform, resolveIdeProjectPath(configService.mpDistRoot));
+		if (options.open && targets.runMini) {
+			emitDashboardEvents$1(analyzeHandle, [{
+				kind: "command",
+				level: "info",
+				title: "opening ide",
+				detail: "构建完成后准备打开 IDE 项目。",
+				tags: ["ide", "open"]
+			}]);
+			await openIde(configService.platform, resolveIdeProjectPath(configService.mpDistRoot));
+		}
 		if (analyzeHandle) await analyzeHandle.waitForExit();
 		ctx.watcherService?.closeAll();
 		terminateStaleSassEmbeddedProcess();
 	});
 }
-function terminateStaleSassEmbeddedProcess() {
-	const getHandles = process._getActiveHandles;
-	const handles = typeof getHandles === "function" ? getHandles() : void 0;
-	if (!Array.isArray(handles)) return;
-	for (const handle of handles) if (isSassEmbeddedChild(handle)) try {
-		handle.kill();
-	} catch {}
-}
-function isSassEmbeddedChild(handle) {
-	return Boolean(handle && typeof handle === "object" && "kill" in handle && "spawnfile" in handle && typeof handle.spawnfile === "string" && handle.spawnfile?.includes("sass-embedded"));
-}
 //#endregion
 //#region src/cli/commands/close.ts
 function registerCloseCommand(cli) {
@@ -1537,6 +1658,9 @@ function registerPrepareCommand(cli) {
 }
 //#endregion
 //#region src/cli/commands/serve.ts
+function emitDashboardEvents(handle, events) {
+	handle?.emitRuntimeEvents(events);
+}
 function resolveWebHost(host) {
 	if (host === void 0) return;
 	if (typeof host === "boolean") return host;
@@ -1680,6 +1804,7 @@ function registerServeCommand(cli) {
 		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}`,
@@ -1692,48 +1817,126 @@ function registerServeCommand(cli) {
 					projectConfigPath: options.projectConfig,
 					syncSupportFiles: false
 				}));
-				if (hasAnalyzeData(result)) return result;
+				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 analyzeUiFallback(ctx);
+			return {
+				result: await analyzeUiFallback(ctx),
+				durationMs: Date.now() - startedAt,
+				mode: "fallback",
+				fallbackReason: "完整分析结果为空，已回退到 dist 文件扫描。"
+			};
 		};
-		const triggerAnalyzeUpdate = async () => {
+		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();
-			await analyzeHandle.update(next);
+			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) {
-				analyzeHandle = await startAnalyzeDashboard(await runAnalyze(), {
+				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().finally(() => {
+					triggerAnalyzeUpdate("watch").finally(() => {
 						updating = false;
 					});
 				});
 				if (analyzeHandle) {
 					updating = true;
-					await triggerAnalyzeUpdate();
+					await triggerAnalyzeUpdate("initial");
 					updating = false;
 				}
 			}
 		}
 		let webServer;
-		if (targets.runWeb) try {
-			webServer = await webService?.startDevServer();
-		} catch (error) {
-			logger_default.error(error);
-			throw error;
+		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) {
+				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,
@@ -1741,6 +1944,13 @@ function registerServeCommand(cli) {
 		});
 		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,