weapp-vite 7.3.0 → 7.5.0

package/dist/cli.mjs

@@ -1,35 +1,47 @@
-import { A as getDefaultIdeProjectRoot, C as collectPreloadPages, D as loadViteConfigFile, E as suggestPreloadRules, M as isPathInside, O as createCjsConfigLoadError, S as getProjectConfigFileName, T as resolvePreloadPackageIdentifier, _ as SHARED_CHUNK_VIRTUAL_PREFIX, a as formatBytes, b as resolveWeappConfigFile, d as getBackendForCapability, f as resolveBackendExecution, g as createSharedBuildConfig, h as createGlassEaselAnalyzeResult, j as shouldPassPlatformArgToIdeOpen, k as parseCommentJson, m as syncManagedTsconfigBootstrapFiles, p as syncProjectSupportFiles, t as createCompilerContext, v as resolveHmrProfileJsonPath, w as findPreloadRuleKey, x as checkRuntime } from "./createContext-cqr9Y4EV.mjs";
-import { f as VERSION, i as findJsEntry, o as findTemplateEntry, s as findVueEntry } from "./file-CKB0Tn8Z.mjs";
-import { r as logger_default, t as colors } from "./logger-mt4mSTqV.mjs";
-import { c as startWeappViteMcpServer, l as detectAiDevelopmentEnvironment, s as resolveWeappMcpConfig } from "./mcp-BG6TliEg.mjs";
-import { createRequire } from "node:module";
-import fs from "node:fs";
+import { a as resolveWeappViteHostMeta } from "./pluginHost--CaeyWpA.mjs";
+import { a as getDevShutdownScope, i as createDevShutdownScope, o as getDevServerCloseRecord, s as replaceDevServerClose } from "./lifecycle-BROTlwSL.mjs";
+import { E as createSharedBuildConfig, S as createGlassEaselAnalyzeResult, c as getBackendForCapability, f as syncProjectSupportFiles, l as resolveBackendExecution, n as formatBytes, p as syncManagedTsconfigBootstrapFiles, u as CompilerSession, x as createDevViteServer } from "./createCompilerContextInstance-DJH_P_nZ.mjs";
+import { l as resolveHmrProfileJsonPath } from "./devProvider-BGBkw28J.mjs";
+import { l as getProjectPlatformOptions, n as getDefaultIdeProjectRoot, w as shouldPassPlatformArgToIdeOpen } from "./platform-CnkySBKz.mjs";
+import { i as findJsEntry, o as findTemplateEntry, s as findVueEntry } from "./file-sC3jD7Fh.mjs";
+import { t as VERSION } from "./constants-DEZdcsMn.mjs";
+import { C as resolvePreloadPackageIdentifier, S as findPreloadRuleKey, c as getProjectConfigFileName, w as suggestPreloadRules, x as collectPreloadPages } from "./utils-CJSCgEj6.mjs";
+import { r as logger_default, t as colors } from "./logger-DGn5iEVN.mjs";
+import { t as createCompilerContext } from "./createContext-BqYzHhY9.mjs";
+import { a as filterDuplicateOptions, c as resolveConfigFile, i as convertBase, l as registerAcceptCommand, n as formatMcpQuickStart, o as isUiEnabled, r as coerceBooleanOption, s as parseDashboardUiHost, t as registerMcpCommand } from "./mcp-D3Yh24Cj.mjs";
+import { a as isRuntimeCategory, i as createAnalyzeBudgetCheck, r as createAnalyzeComparison, t as createDuplicateModuleInsights } from "./analyze-ZJUvEdaY.mjs";
+import { i as resolveAnalyzeHistoryMetadata, n as createAnalyzeMetadata, t as terminateStaleSassEmbeddedProcess } from "./processCleanup-B6KA30Zc.mjs";
+import { a as resolveModuleSourceType, i as resolveAssetSource, n as classifyPackage, r as normalizeModuleId, t as version } from "./package-7swhyLmf.mjs";
+import { a as createDashboardArtifactSnapshot, i as resolveDashboardRoot, n as ANALYZE_DASHBOARD_PACKAGE_NAME, t as createAnalyzeDashboardDevframe } from "./dashboard-DvqF3Key.mjs";
+import { a as terminateUploadProcess, i as terminateUploadDescendants, n as resolveUploadPlatforms, r as redactUploadSecrets, t as prepareUpload } from "./upload-D4msblBf.mjs";
+import { t as loadConfig } from "./loadConfig-C3BQhz7F.mjs";
+import { c as startWeappViteMcpServer, l as detectAiDevelopmentEnvironment, s as resolveWeappMcpConfig } from "./mcp-Cj8Maqo6.mjs";
+import process from "node:process";
 import path, { posix } from "pathe";
+import fs, { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
 import path$1 from "node:path";
 import { defu } from "@weapp-core/shared";
 import { fs as fs$1 } from "@weapp-core/shared/fs";
-import process from "node:process";
 import { parse } from "vue/compiler-sfc";
-import fs$2, { mkdir, writeFile } from "node:fs/promises";
-import { build, createServer } from "vite";
-import { createHash } from "node:crypto";
-import { promisify } from "node:util";
-import os from "node:os";
-import { execFile, spawn } from "node:child_process";
+import fs$2, { access, mkdir, readFile, realpath, rm, stat, writeFile } from "node:fs/promises";
+import { build } from "vite";
+import { createHash, randomUUID } from "node:crypto";
+import { parseArgs } from "node:util";
 import { Buffer } from "node:buffer";
+import { fork, spawn } from "node:child_process";
 import { cac } from "cac";
-import { RETRY_CANCEL_KEYS, RETRY_CONFIRM_KEYS, bootstrapWechatDevtoolsSettings, buildWechatIdeNpm, clearWechatIdeCache, clearWechatIdeCacheByAutomator, closeSharedMiniProgram, closeWechatIdeProject, compileWechatIdeByAutomator, connectOpenedAutomator, createSharedInputSession, createWechatIdeLoginRequiredExitError, defaultCustomConfigFilePath, detectWechatDevtoolsServicePort, dispatchWechatCliCommand, formatAutomatorLoginError, getConfig, getWechatIdeTestAccounts, getWechatIdeTicket, getWechatIdeToolInfo, isAutomatorLoginError, isRetryableAutomatorLaunchError, isWeappIdeTopLevelCommand, isWechatIdeEngineBuildEndpointMissingError, isWechatIdeLoggedIn, isWechatIdeLoginRequiredError, isWechatIdeLoginRequiredExitError, launchAutomator, parse as parse$1, promptRetryKeypress, promptWechatIdeLoginRetry, quitWechatIde, refreshWechatIdeTicket, resetWechatIdeFileUtilsByHttp, resolveCliPath, resolveProjectAutomatorPort, runRetryableCommand, runWechatIdeEngineBuild, runWithSuspendedSharedInput, setWechatIdeTicket, startForwardConsole, takeScreenshot } from "weapp-ide-cli";
+import { RETRY_CANCEL_KEYS, RETRY_CONFIRM_KEYS, bootstrapWechatDevtoolsSettings, buildWechatIdeNpm, clearWechatIdeCache, clearWechatIdeCacheByAutomator, closeSharedMiniProgram, closeWechatIdeProject, compileWechatIdeByAutomator, connectOpenedAutomator, createSharedInputSession, createWechatIdeLoginRequiredExitError, defaultCustomConfigFilePath, detectWechatDevtoolsServicePort, dispatchWechatCliCommand, formatAutomatorLoginError, getWechatIdeTestAccounts, getWechatIdeTicket, getWechatIdeToolInfo, isAutomatorLoginError, isRetryableAutomatorLaunchError, isWeappIdeTopLevelCommand, isWechatIdeEngineBuildEndpointMissingError, isWechatIdeLoginRequiredError, isWechatIdeLoginRequiredExitError, launchAutomator, parse as parse$1, promptRetryKeypress, promptWechatIdeLoginRetry, queryWechatIdeLogin, quitWechatIde, refreshWechatIdeTicket, resetWechatIdeFileUtilsByHttp, resolveCliPath, resolveProjectAutomatorPort, runRetryableCommand, runWechatIdeEngineBuild, runWithSuspendedSharedInput, setWechatIdeTicket, startForwardConsole, takeScreenshot } from "weapp-ide-cli";
 import { brotliCompressSync, gzipSync } from "node:zlib";
 import { buildOtpAuthUrl, refreshTempAuthCode } from "devframe/node/auth";
 import { resolveCommand } from "package-manager-detector/commands";
-import { defineDevframe, defineRpcFunction } from "devframe";
-import { Server } from "node:http";
-import { initDevframe } from "devframe/initiate";
+import semverInc from "semver/functions/inc.js";
+import { x } from "tinyexec";
+import { parse as parse$2 } from "dotenv";
+import { expand } from "dotenv-expand";
 import { generateJs, generateJson, generateWxml, generateWxss } from "@weapp-core/schematics";
 import { determineAgent } from "@vercel/detect-agent";
 import { initConfig } from "@weapp-core/init";
-import { createInterface } from "node:readline/promises";
-import { clearTimeout as clearTimeout$1, setTimeout as setTimeout$1 } from "node:timers";
 import net from "node:net";
 //#region src/cli/runtime.ts
 function logRuntimeTarget(targets, options = {}) {
@@ -55,6 +67,9 @@ function resolveRuntimeTargets(options) {
 		rawPlatform
 	};
 }
+function resolveConfiguredRuntimeTargets(targets, platform) {
+	return targets.rawPlatform === void 0 && platform === "web" ? resolveRuntimeTargets({ platform: "web" }) : targets;
+}
 function createInlineConfig(execution, options = {}) {
 	const configs = execution.entries.map((entry) => entry.driver.createInlineConfig({
 		execution,
@@ -198,33 +213,10 @@ async function executeWechatIdeCliCommand(argv, options = {}) {
 }
 //#endregion
 //#region src/cli/openIde/close.ts
-const execFileAsync = promisify(execFile);
-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 关闭微信开发者工具，并在 CLI 不可用时回退到系统级关闭。
+* @description 执行用户显式请求的 CLI close；失败时保留宿主，不升级为系统级退出。
 */
 async function closeIde$1() {
-	const config = await getConfig();
-	const cliPath = config.cliPath?.trim() ? config.cliPath : null;
 	try {
 		await closeWechatIdeProject();
 		return true;
@@ -240,17 +232,9 @@ async function closeIde$1() {
 			logger_default.error(retryError);
 		}
 		else {
-			logger_default.warn("微信开发者工具 CLI close 执行失败，尝试回退为系统级关闭。");
+			logger_default.warn("微信开发者工具 CLI close 执行失败，已保留现有宿主；请在开发者工具中手动关闭目标项目。");
 			logger_default.error(error);
 		}
-		if (await closeIdeByAppleScript()) {
-			logger_default.info("已回退为系统级关闭微信开发者工具。");
-			return true;
-		}
-		if (await closeIdeByProcessKill(cliPath)) {
-			logger_default.info("已回退为进程级关闭微信开发者工具。");
-			return true;
-		}
 		return false;
 	}
 }
@@ -299,7 +283,7 @@ function logWechatIdeServicePortDisabledHint(projectPath) {
 const OPENED_PROJECT_HEALTH_CHECK_TIMEOUT = 3e3;
 const OPEN_AUTOMATOR_TIMEOUT = 12e4;
 function formatReuseOpenedWechatIdePrompt() {
-	return `目标项目已在微信开发者工具中打开，已跳过重复打开。按 ${RETRY_CONFIRM_KEYS.map((key) => colors.bold(colors.green(key))).join(" / ")} 关闭当前窗口后重新打开。`;
+	return `目标项目已在微信开发者工具中打开，已跳过重复打开。按 ${RETRY_CONFIRM_KEYS.map((key) => colors.bold(colors.green(key))).join(" / ")} 重新连接目标项目（保留现有窗口）。`;
 }
 function disconnectMiniProgram(miniProgram) {
 	miniProgram.disconnect();
@@ -354,7 +338,7 @@ async function connectOpenedProject(projectPath) {
 /**
 * @description 若当前项目已在微信开发者工具中打开且自动化可连通，则直接复用现有会话，避免重复拉起 IDE。
 */
-async function tryReuseOpenedWechatIde(projectPath, closeIde, options = {}) {
+async function tryReuseOpenedWechatIde(projectPath, options = {}) {
 	const connection = await connectOpenedProject(projectPath);
 	if (connection.status === "unhealthy") return {
 		reopened: false,
@@ -376,8 +360,7 @@ async function tryReuseOpenedWechatIde(projectPath, closeIde, options = {}) {
 		reopened: false,
 		reused: true
 	};
-	logger_default.info(colors.bold(colors.green("正在关闭当前已打开项目，并重新拉起微信开发者工具...")));
-	if (!await closeIde()) logger_default.warn("关闭当前微信开发者工具失败，仍继续尝试重新打开目标项目。");
+	logger_default.info(colors.bold(colors.green("正在重新连接目标项目，保留现有微信开发者工具窗口...")));
 	await openWechatIdeByAutomator(projectPath, {
 		preserveProjectRoot: options.preserveProjectRoot,
 		trustProject: options.trustProject
@@ -388,16 +371,15 @@ async function tryReuseOpenedWechatIde(projectPath, closeIde, options = {}) {
 	};
 }
 /**
-* @description 对已打开的目标项目执行强制重开，以刷新最新构建产物。
+* @description 重新连接目标项目以刷新构建产物；连接失败不授予关闭共享宿主的权限。
 */
-async function reopenOpenedWechatIde(projectPath, closeIde, options = {}) {
+async function reopenOpenedWechatIde(projectPath, options = {}) {
 	const connection = await connectOpenedProject(projectPath);
 	if (connection.status === "connected") {
 		disconnectMiniProgram(connection.miniProgram);
-		logger_default.info("目标项目已在微信开发者工具中打开，当前命令将主动重开以刷新最新构建产物。");
-	} else if (connection.status === "unhealthy") logger_default.info("目标项目的 automator 会话未通过健康检查，当前命令将关闭窗口并重新拉起。");
-	else logger_default.info("未检测到可复用的 automator 会话，当前命令将关闭现有窗口并重新拉起目标项目。");
-	if (!await (connection.status === "connected" ? closeIde : options.restartIde ?? closeIde)()) logger_default.warn("关闭当前微信开发者工具失败，仍继续尝试重新打开目标项目。");
+		logger_default.info("目标项目已在微信开发者工具中打开，当前命令将重新连接以刷新最新构建产物，保留现有窗口。");
+	} else if (connection.status === "unhealthy") logger_default.info("目标项目的 automator 会话未通过健康检查，将重试连接目标项目，保留现有窗口。");
+	else logger_default.info("未检测到可复用的 automator 会话，将尝试打开目标项目，保留其他窗口。");
 	await openWechatIdeByAutomator(projectPath, options);
 	return true;
 }
@@ -408,11 +390,7 @@ function shouldLogAutomatorFallbackError() {
 	return flag === "1" || flag === "true";
 }
 const PREPARE_AUTOMATOR_SESSION_TIMEOUT = 8e3;
-const AUTOMATOR_RECOVERY_QUIT_SETTLE_MS = 5e3;
 const RESET_FILEUTILS_ENV = "WEAPP_VITE_RESET_IDE_FILEUTILS";
-function sleep$1(ms) {
-	return new Promise((resolve) => setTimeout(resolve, ms));
-}
 function readProjectConfigObject(projectPath) {
 	try {
 		const raw = fs.readFileSync(path.join(projectPath, "project.config.json"), "utf8");
@@ -441,7 +419,10 @@ function shouldResetWechatIdeFileUtils() {
 async function runWechatIdeOpenWithRetry(argv) {
 	await executeWechatIdeCliCommand(argv, {
 		cancelLevel: "warn",
-		onNonLoginError: (error) => logger_default.error(error),
+		onNonLoginError: (error) => {
+			logger_default.error(error);
+			if (process.env.WEAPP_IDE_MANAGED_PROJECT_JOURNAL?.trim()) throw error;
+		},
 		onRetry: () => {
 			logger_default.info(colors.bold(colors.green("正在重试连接微信开发者工具...")));
 		},
@@ -449,10 +430,11 @@ async function runWechatIdeOpenWithRetry(argv) {
 	});
 }
 /**
-* @description 根据 mpDistRoot 推导 IDE 项目目录（目录内应包含 project/mini 配置）
+* @description 根据代码输出目录推导 IDE 项目目录；内联项目配置与 app.json 同目录。
 */
-function resolveIdeProjectPath(mpDistRoot) {
+function resolveIdeProjectPath(mpDistRoot, generatedProjectConfig = false) {
 	if (!mpDistRoot || !mpDistRoot.trim()) return;
+	if (generatedProjectConfig) return mpDistRoot;
 	const parent = path.dirname(mpDistRoot);
 	if (!parent || parent === "." || parent === "/") return;
 	return parent;
@@ -460,31 +442,22 @@ function resolveIdeProjectPath(mpDistRoot) {
 /**
 * @description 结合 mpDistRoot 与配置根目录解析最终 IDE 项目目录。
 */
-function resolveIdeProjectRoot(mpDistRoot, cwd) {
-	return resolveIdeProjectPath(mpDistRoot) ?? cwd;
+function resolveIdeProjectRoot(mpDistRoot, cwd, generatedProjectConfig = false) {
+	const projectPath = resolveIdeProjectPath(mpDistRoot, generatedProjectConfig);
+	return generatedProjectConfig && projectPath && cwd ? path.resolve(cwd, projectPath) : projectPath ?? cwd;
 }
 async function closeIde() {
 	return await closeIde$1();
 }
-async function restartWechatIdeForAutomatorRecovery() {
-	try {
-		await quitWechatIde();
-		await sleep$1(AUTOMATOR_RECOVERY_QUIT_SETTLE_MS);
-		return true;
-	} catch {
-		return await closeIde();
-	}
-}
 async function tryOpenWechatIdeByAutomator(projectPath, options) {
 	const preserveProjectRoot = !shouldUseAutomatorProjectWrapper(projectPath);
 	if (options.reuseOpenedProject === false) {
-		if (await reopenOpenedWechatIde(projectPath, closeIde, {
+		if (await reopenOpenedWechatIde(projectPath, {
 			preserveProjectRoot,
-			restartIde: restartWechatIdeForAutomatorRecovery,
 			trustProject: options.trustProject
 		})) return "reopened";
 	}
-	const reuseResult = await tryReuseOpenedWechatIde(projectPath, closeIde, {
+	const reuseResult = await tryReuseOpenedWechatIde(projectPath, {
 		preserveProjectRoot,
 		promptReopen: options.reuseOpenedProject !== true,
 		trustProject: options.trustProject
@@ -649,12 +622,11 @@ async function recoverOpenedWechatIdeProject(platform, projectPath, servicePortE
 		logger_default.warn("已跳过微信开发者工具自动恢复；请按上方提示手动关闭并重新打开目标项目。");
 		return failedResult;
 	}
-	logger_default.info(`检测到微信开发者工具打开后状态不稳定（${formatWechatIdeOpenHealthReason(failedResult)}），正在自动关闭并重新打开目标项目...`);
-	if (!await closeIde()) logger_default.warn("自动恢复时关闭当前微信开发者工具失败，仍继续尝试重新打开目标项目。");
+	logger_default.info(`检测到微信开发者工具打开后状态不稳定（${formatWechatIdeOpenHealthReason(failedResult)}），正在重试打开目标项目（保留现有窗口）...`);
 	await runWechatIdeOpenWithRetry(createIdeOpenArgv(platform, projectPath, options));
 	const recoveredResult = await verifyOpenedWechatIdeProject(projectPath, servicePortEnabled, options);
 	if (recoveredResult.ok) logger_default.info("微信开发者工具已完成自动恢复。");
-	else logger_default.warn("微信开发者工具自动恢复未完成；可设置 `WEAPP_VITE_DISABLE_IDE_OPEN_RECOVERY=1` 或传入 `--no-open-recovery` 跳过自动关闭重开，并按提示手动处理。");
+	else logger_default.warn("微信开发者工具自动恢复未完成；可设置 `WEAPP_VITE_DISABLE_IDE_OPEN_RECOVERY=1` 或传入 `--no-open-recovery` 跳过自动重试，并按提示手动处理。");
 	return recoveredResult;
 }
 async function verifyAndRecoverOpenedWechatIdeProject(platform, projectPath, servicePortEnabled, options) {
@@ -691,6 +663,7 @@ async function openIde(platform, projectPath, options = {}) {
 			return;
 		}
 	} catch (error) {
+		if (process.env.WEAPP_IDE_MANAGED_PROJECT_JOURNAL?.trim()) throw error;
 		if (isAutomatorLoginError(error)) {
 			logger_default.error("检测到微信开发者工具登录状态失效，请先登录后重试。");
 			logger_default.warn(formatAutomatorLoginError(error));
@@ -698,9 +671,6 @@ async function openIde(platform, projectPath, options = {}) {
 		logger_default.warn(`通过 automator 启动微信开发者工具失败，回退到普通 open 流程：${formatWechatIdeAutomatorFailure(error)}`);
 		if (shouldLogAutomatorFallbackError()) logger_default.error(error);
 	}
-	else if (platform === "weapp" && projectPath && normalizedOptions.reuseOpenedProject === false) {
-		if (!await closeIde()) logger_default.warn("关闭当前微信开发者工具失败，仍继续尝试打开目标项目。");
-	}
 	await runWechatIdeOpenWithRetry(createIdeOpenArgv(platform, projectPath, normalizedOptions));
 	if (platform === "weapp" && projectPath && normalizedOptions.prepareAutomatorSession) await prepareWechatIdeAutomatorSession(projectPath, normalizedOptions);
 	if (platform === "weapp" && projectPath && !normalizedOptions.skipPostOpenHealthCheck) await verifyAndRecoverOpenedWechatIdeProject(platform, projectPath, bootstrapResult?.servicePortEnabled, normalizedOptions);
@@ -722,7 +692,7 @@ async function resolveIdeCommandContext(options) {
 			cliPlatform: options.cliPlatform
 		});
 		platform ??= ctx.configService.platform;
-		if (!projectPath) projectPath = resolveIdeProjectRoot(ctx.configService.mpDistRoot, ctx.configService.cwd);
+		if (!projectPath) projectPath = resolveIdeProjectRoot(ctx.configService.mpDistRoot, ctx.configService.cwd, ctx.configService.multiPlatform.projectConfigs !== void 0);
 		return {
 			cwd: ctx.configService.cwd,
 			platform,
@@ -742,35 +712,6 @@ async function resolveIdeCommandContext(options) {
 	};
 }
 //#endregion
-//#region src/cli/options.ts
-function filterDuplicateOptions(options) {
-	for (const [key, value] of Object.entries(options)) if (Array.isArray(value)) options[key] = value[value.length - 1];
-}
-function resolveConfigFile(options) {
-	if (typeof options.config === "string") return options.config;
-	if (typeof options.c === "string") return options.c;
-}
-function convertBase(value) {
-	if (value === 0) return "";
-	return value;
-}
-function coerceBooleanOption(value) {
-	if (value === void 0) return;
-	if (typeof value === "boolean") return value;
-	if (typeof value === "string") {
-		const normalized = value.trim().toLowerCase();
-		if (normalized === "") return true;
-		if (normalized === "false" || normalized === "0" || normalized === "off" || normalized === "no") return false;
-		if (normalized === "true" || normalized === "1" || normalized === "on" || normalized === "yes") return true;
-		return true;
-	}
-	if (typeof value === "number") return value !== 0;
-	return Boolean(value);
-}
-function isUiEnabled(options) {
-	return Boolean(options.ui || options.analyze);
-}
-//#endregion
 //#region src/cli/commands/alipayExecute.ts
 function createSpawnOptions() {
 	return {
@@ -856,6 +797,154 @@ function registerAlipayCommand(cli) {
 	});
 }
 //#endregion
+//#region src/analyze/hmr/attribution.ts
+const nonnegative = (value) => typeof value === "number" && Number.isFinite(value) && value >= 0;
+function difference(whole, ...parts) {
+	return nonnegative(whole) && parts.every(nonnegative) && whole >= parts.reduce((sum, value) => sum + value, 0) ? whole - parts.reduce((sum, value) => sum + value, 0) : null;
+}
+/** 外层时段互不重叠；插件 hook 属于 bundler 内部的嵌套观测，不能再次累加。 */
+function attributeHmrProfile(sample, external) {
+	const value = (key) => nonnegative(sample[key]) ? sample[key] : null;
+	const phases = sample.pipeline === "stateful" ? Object.fromEntries((sample.profileMode === "delivery" ? [
+		"sourceToBatchMs",
+		"deliveryQueueMs",
+		"prepareMs",
+		"commitQueueMs",
+		"commitMs",
+		"publishMs"
+	] : [
+		"sourceToBatchMs",
+		"snapshotBuildMs",
+		"snapshotPublishMs"
+	]).map((key) => [key, value(key)])) : {
+		batchWaitMs: value("batchWaitMs"),
+		queueWaitMs: value("queueWaitMs"),
+		otherBeforeBuildMs: difference(sample.watchToDirtyMs, sample.batchWaitMs, sample.queueWaitMs),
+		bundlerMs: value("bundlerMs")
+	};
+	const profileResidualMs = sample.pipeline === "stateful" ? difference(sample.totalMs, ...Object.values(phases)) : difference(sample.totalMs, sample.watchToDirtyMs, sample.bundlerMs);
+	let externalStatus = external ? "unknown" : "not-observed";
+	let sourceToWatcherMs = null;
+	let afterProfileToVisibleMs = null;
+	let eventId = null;
+	if (external && sample.schemaVersion === 1 && sample.correlation === "known" && sample.clock?.durations === "performance.now" && nonnegative(sample.clock.timeOrigin) && nonnegative(external.writtenAtEpochMs) && external.visibleAtEpochMs >= external.writtenAtEpochMs) {
+		const events = (sample.sourceEvents ?? []).filter((event) => event.file?.replaceAll("\\", "/") === external.sourceFile.replaceAll("\\", "/") && sample.clock.timeOrigin + event.receivedAtMs >= external.writtenAtEpochMs && sample.clock.timeOrigin + event.receivedAtMs <= external.visibleAtEpochMs);
+		if (events.length === 1 && sample.sourceEvents?.length === 1) {
+			const received = sample.clock.timeOrigin + events[0].receivedAtMs;
+			sourceToWatcherMs = received - external.writtenAtEpochMs;
+			afterProfileToVisibleMs = difference(external.visibleAtEpochMs - received, sample.totalMs);
+			eventId = events[0].eventId;
+			externalStatus = afterProfileToVisibleMs === null ? "unknown" : "matched";
+		}
+	}
+	return {
+		schemaVersion: 1,
+		pipeline: sample.pipeline ?? "standard",
+		status: Object.values(phases).every(nonnegative) && profileResidualMs !== null ? "complete" : "partial",
+		phases,
+		profileResidualMs,
+		external: {
+			status: externalStatus,
+			eventId,
+			sourceToWatcherMs,
+			afterProfileToVisibleMs
+		},
+		nestedMetrics: "hook durations overlap; do not add to outer phases"
+	};
+}
+//#endregion
+//#region src/analyze/hmr/reader.ts
+const stringFields = [
+	"timestamp",
+	"eventId",
+	"event",
+	"file",
+	"relativeFile",
+	"sourceRootFile",
+	"sessionId",
+	"buildId",
+	"batchId"
+];
+const collectionFields = ["dirtyReasonSummary", "pendingReasonSummary"];
+function isSourceEvent(value) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+	const event = value;
+	return typeof event.eventId === "string" && (event.file === void 0 || typeof event.file === "string") && (event.event === void 0 || typeof event.event === "string" && [
+		"update",
+		"create",
+		"delete"
+	].includes(event.event)) && typeof event.receivedAtMs === "number" && Number.isFinite(event.receivedAtMs) && event.receivedAtMs >= 0;
+}
+function isSample(value) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+	const sample = value;
+	for (const [key, values] of Object.entries({
+		pipeline: ["standard", "stateful"],
+		profileMode: [
+			"delivery",
+			"full",
+			"refresh"
+		],
+		completionBoundary: ["delivery-acknowledged", "output-published"]
+	})) if (sample[key] !== void 0 && (typeof sample[key] !== "string" || !values.includes(sample[key]))) return false;
+	if (typeof sample.totalMs !== "number" || !Number.isFinite(sample.totalMs) || sample.totalMs < 0) return false;
+	if (stringFields.some((key) => sample[key] !== void 0 && typeof sample[key] !== "string")) return false;
+	if (collectionFields.some((key) => {
+		const items = sample[key];
+		return items !== void 0 && (!Array.isArray(items) || items.some((item) => typeof item !== "string"));
+	})) return false;
+	if (sample.sourceEvents !== void 0 && (!Array.isArray(sample.sourceEvents) || !sample.sourceEvents.every(isSourceEvent))) return false;
+	return Object.entries(sample).every(([key, value]) => {
+		if (!key.endsWith("Ms") && !key.endsWith("Count")) return true;
+		return typeof value === "number" && Number.isFinite(value) && value >= 0 && (!key.endsWith("Count") || Number.isInteger(value));
+	});
+}
+/** 旧版仍可读取；不兼容、失败和未完成记录不参与正常耗时统计，缺失阶段不补零。 */
+function readHmrProfileLines(content) {
+	const samples = [];
+	const coverage = {
+		legacy: 0,
+		compatible: 0,
+		incompatible: 0,
+		incomplete: 0,
+		invalid: 0
+	};
+	for (const line of content.split(/\r?\n/)) {
+		if (!line.trim()) continue;
+		let value;
+		try {
+			value = JSON.parse(line);
+		} catch {
+			coverage.invalid += 1;
+			continue;
+		}
+		if (!value || typeof value !== "object" || Array.isArray(value)) {
+			coverage.invalid += 1;
+			continue;
+		}
+		const record = value;
+		if (record.schemaVersion !== void 0 && record.schemaVersion !== 1) {
+			coverage.incompatible += 1;
+			continue;
+		}
+		if (record.status === "incomplete" || record.status === "failed") {
+			coverage.incomplete += 1;
+			continue;
+		}
+		if (record.status !== void 0 && record.status !== "complete" || record.schemaVersion === 1 && record.status !== "complete" || !isSample(record)) {
+			coverage.invalid += 1;
+			continue;
+		}
+		coverage[record.schemaVersion === void 0 ? "legacy" : "compatible"] += 1;
+		samples.push(record);
+	}
+	return {
+		samples,
+		coverage,
+		skippedLineCount: coverage.incompatible + coverage.incomplete + coverage.invalid
+	};
+}
+//#endregion
 //#region src/analyze/hmr.ts
 function createMetricSummary(values) {
 	if (!values.length) return { count: 0 };
@@ -894,26 +983,19 @@ function isFiniteNumber$1(value) {
 * @description 聚合 HMR JSONL profile，为命令行与后续仪表盘复用。
 */
 async function analyzeHmrProfile(options) {
-	const lines = (await fs$1.readFile(options.profilePath, "utf8")).split(/\r?\n/);
-	const samples = [];
-	let skippedLineCount = 0;
-	for (const line of lines) {
-		const trimmed = line.trim();
-		if (!trimmed) continue;
-		try {
-			const parsed = JSON.parse(trimmed);
-			if (!isFiniteNumber$1(parsed.totalMs)) {
-				skippedLineCount += 1;
-				continue;
-			}
-			samples.push(parsed);
-		} catch {
-			skippedLineCount += 1;
-		}
-	}
+	const { samples, coverage: inputCoverage, skippedLineCount } = readHmrProfileLines(await fs$1.readFile(options.profilePath, "utf8"));
 	const eventCounts = /* @__PURE__ */ new Map();
 	const dirtyReasonCounts = /* @__PURE__ */ new Map();
 	const pendingReasonCounts = /* @__PURE__ */ new Map();
+	const batchWaitValues = [];
+	const queueWaitValues = [];
+	const bundlerValues = [];
+	const finalizePrepareValues = [];
+	const finalizeTemplateValues = [];
+	const finalizePublishValues = [];
+	const publicationValidateValues = [];
+	const publicationIndependentValues = [];
+	const publicationPruneValues = [];
 	const totalValues = [];
 	const buildCoreValues = [];
 	const buildStartValues = [];
@@ -963,6 +1045,15 @@ async function analyzeHmrProfile(options) {
 	const resolveCountValues = [];
 	const skippedLoadedCountValues = [];
 	for (const sample of samples) {
+		if (isFiniteNumber$1(sample.batchWaitMs)) batchWaitValues.push(sample.batchWaitMs);
+		if (isFiniteNumber$1(sample.queueWaitMs)) queueWaitValues.push(sample.queueWaitMs);
+		if (isFiniteNumber$1(sample.bundlerMs)) bundlerValues.push(sample.bundlerMs);
+		if (isFiniteNumber$1(sample.finalizePrepareMs)) finalizePrepareValues.push(sample.finalizePrepareMs);
+		if (isFiniteNumber$1(sample.finalizeTemplateMs)) finalizeTemplateValues.push(sample.finalizeTemplateMs);
+		if (isFiniteNumber$1(sample.finalizePublishMs)) finalizePublishValues.push(sample.finalizePublishMs);
+		if (isFiniteNumber$1(sample.publicationValidateMs)) publicationValidateValues.push(sample.publicationValidateMs);
+		if (isFiniteNumber$1(sample.publicationIndependentMs)) publicationIndependentValues.push(sample.publicationIndependentMs);
+		if (isFiniteNumber$1(sample.publicationPruneMs)) publicationPruneValues.push(sample.publicationPruneMs);
 		totalValues.push(sample.totalMs);
 		if (sample.event) eventCounts.set(sample.event, (eventCounts.get(sample.event) ?? 0) + 1);
 		if (isFiniteNumber$1(sample.buildCoreMs)) buildCoreValues.push(sample.buildCoreMs);
@@ -1029,9 +1120,24 @@ async function analyzeHmrProfile(options) {
 		profilePath: options.profilePath,
 		sampleCount: samples.length,
 		skippedLineCount,
+		inputCoverage,
+		timelines: samples.map((sample) => ({
+			batchId: sample.batchId,
+			completionBoundary: sample.completionBoundary,
+			...attributeHmrProfile(sample)
+		})),
 		firstTimestamp: orderedByTime[0]?.timestamp,
 		lastTimestamp: orderedByTime[orderedByTime.length - 1]?.timestamp,
 		metrics: {
+			batchWaitMs: createMetricSummary(batchWaitValues),
+			queueWaitMs: createMetricSummary(queueWaitValues),
+			bundlerMs: createMetricSummary(bundlerValues),
+			finalizePrepareMs: createMetricSummary(finalizePrepareValues),
+			finalizeTemplateMs: createMetricSummary(finalizeTemplateValues),
+			finalizePublishMs: createMetricSummary(finalizePublishValues),
+			publicationValidateMs: createMetricSummary(publicationValidateValues),
+			publicationIndependentMs: createMetricSummary(publicationIndependentValues),
+			publicationPruneMs: createMetricSummary(publicationPruneValues),
 			totalMs: createMetricSummary(totalValues),
 			buildCoreMs: createMetricSummary(buildCoreValues),
 			buildStartMs: createMetricSummary(buildStartValues),
@@ -1092,7 +1198,7 @@ async function analyzeHmrProfile(options) {
 //#endregion
 //#region src/analyze/preload/budget.ts
 const PRELOAD_LIMIT_BYTES = 2097152;
-function createPackageSizeMap$1(result) {
+function createPackageSizeMap(result) {
 	return new Map((result?.packages ?? []).map((pkg) => [pkg.id, pkg.files.reduce((total, file) => total + (file.size ?? 0), 0)]));
 }
 function getConfiguredPackages(rule, appJson) {
@@ -1102,7 +1208,7 @@ function getConfiguredPackages(rule, appJson) {
 	return packages.flatMap((item) => typeof item === "string" ? [resolvePreloadPackageIdentifier(item, appJson)] : []).filter((item) => Boolean(item));
 }
 function createPreloadBudgets(appJson, result, configuredRules, packageAnalysis) {
-	const packageSizes = createPackageSizeMap$1(packageAnalysis);
+	const packageSizes = createPackageSizeMap(packageAnalysis);
 	const bySourcePackage = /* @__PURE__ */ new Map();
 	const ensureSourcePackage = (page) => {
 		const sourcePackage = page.packageRoot ?? "__main__";
@@ -1431,140 +1537,100 @@ function analyzeComponentUsage(options) {
 	});
 }
 //#endregion
-//#region src/analyze/subpackages/metadata.ts
-const defaultTotalBudgetBytes = 20971520;
-const defaultPackageBudgetBytes = 2097152;
-const defaultWarningRatio = .85;
-const defaultHistoryDir = ".weapp-vite/analyze-history";
-const defaultHistoryLimit = 20;
-function resolveBudgetValue(value, fallback) {
-	return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : fallback;
-}
-function resolveHistoryLimit(value) {
-	return typeof value === "number" && Number.isFinite(value) && value > 0 ? Math.floor(value) : defaultHistoryLimit;
-}
-function resolveAnalyzeBudgets(configService) {
-	const budgets = configService.weappViteConfig.analyze?.budgets;
-	const legacyPackageBudget = configService.weappViteConfig.packageSizeWarningBytes;
-	const packageFallback = resolveBudgetValue(legacyPackageBudget, defaultPackageBudgetBytes);
-	return {
-		totalBytes: resolveBudgetValue(budgets?.totalBytes, defaultTotalBudgetBytes),
-		mainBytes: resolveBudgetValue(budgets?.mainBytes, packageFallback),
-		subPackageBytes: resolveBudgetValue(budgets?.subPackageBytes, packageFallback),
-		independentBytes: resolveBudgetValue(budgets?.independentBytes, packageFallback),
-		warningRatio: resolveBudgetValue(budgets?.warningRatio, defaultWarningRatio),
-		source: budgets ? "config" : "default"
-	};
-}
-function resolveAnalyzeHistoryMetadata(configService) {
-	const history = configService.weappViteConfig.analyze?.history;
-	if (history === false) return {
-		enabled: false,
-		dir: path.resolve(configService.cwd, defaultHistoryDir),
-		limit: defaultHistoryLimit
-	};
-	const historyConfig = typeof history === "object" && history ? history : {};
-	const rawDir = typeof historyConfig.dir === "string" && historyConfig.dir.trim() ? historyConfig.dir.trim() : defaultHistoryDir;
-	return {
-		enabled: historyConfig.enabled !== false,
-		dir: path.isAbsolute(rawDir) ? rawDir : path.resolve(configService.cwd, rawDir),
-		limit: resolveHistoryLimit(historyConfig.limit)
-	};
-}
-function createAnalyzeMetadata(configService, now = /* @__PURE__ */ new Date()) {
-	const history = resolveAnalyzeHistoryMetadata(configService);
-	const packageName = configService.packageJson?.name;
-	return {
-		projectName: typeof packageName === "string" && packageName.trim() ? packageName.trim() : path.basename(configService.cwd),
-		generatedAt: now.toISOString(),
-		budgets: resolveAnalyzeBudgets(configService),
-		history: {
-			...history,
-			dir: configService.relativeCwd(history.dir)
+//#region src/analyze/subpackages/artifacts/owner.ts
+/** 每次分析独立缓存包边界，兼容 pnpm、工作区和普通 node_modules。 */
+function createModuleOwnerResolver() {
+	const cache = /* @__PURE__ */ new Map();
+	const resolveDirectory = (directory) => {
+		if (cache.has(directory)) return cache.get(directory);
+		let owner;
+		try {
+			const value = JSON.parse(readFileSync(path.join(directory, "package.json"), "utf8"));
+			if (value && typeof value === "object" && "name" in value && typeof value.name === "string") owner = {
+				name: value.name,
+				version: "version" in value && typeof value.version === "string" ? value.version : void 0
+			};
+		} catch (error) {
+			if (!(error && typeof error === "object" && "code" in error && error.code === "ENOENT")) throw error;
 		}
+		const parent = path.dirname(directory);
+		if (!owner && parent !== directory && path.basename(directory) !== "node_modules") owner = resolveDirectory(parent);
+		cache.set(directory, owner);
+		return owner;
 	};
+	return (id) => id === "\0rolldown/runtime.js" ? { name: "rolldown" } : path.isAbsolute(id) && !id.includes("\0") ? resolveDirectory(path.dirname(id.replace(/[?#].*$/, ""))) : void 0;
+}
+function classifyOwnedModule(owner, application) {
+	if (application) return "application";
+	if (owner?.name === "@vue/reactivity") return "reactivity";
+	if (owner?.name === "@vue/shared" || owner?.name === "@weapp-core/constants" || owner?.name === "rolldown") return "helper";
+	if (owner && [
+		"weapi",
+		"@wevu/api",
+		"@wevu/web-apis",
+		"@weapp-vite/web",
+		"@weapp-vite/web-apis"
+	].includes(owner.name)) return "host";
+	if (owner && ["wevu", "@weapp-vite/react"].includes(owner.name)) return "runtime";
+	return owner ? "dependency" : "unknown";
 }
 //#endregion
-//#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;
-	if (posix.isAbsolute(normalizedFileName)) return isPathInside(pluginRoot, normalizedFileName) ? normalizedFileName : void 0;
-	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 resolveSubPackageRoot$1(fileName, context) {
-	const normalized = posix.normalize(fileName);
-	return Array.from(context.subPackageRoots).filter(Boolean).sort((left, right) => right.length - left.length).find((root) => normalized === root || normalized.startsWith(`${root}/`));
-}
-function classifyPackage(fileName, origin, context) {
-	if (fileName.startsWith(VIRTUAL_PREFIX)) {
-		const combination = fileName.slice(VIRTUAL_PREFIX.length).split("/")[0] || "shared";
-		return {
-			id: `virtual:${combination}`,
-			label: `共享虚拟包 ${combination}`,
-			type: "virtual"
-		};
-	}
-	const rootCandidate = resolveSubPackageRoot$1(fileName, context);
-	if (rootCandidate) {
-		const isIndependent = context.independentRoots.has(rootCandidate);
-		return {
-			id: rootCandidate,
-			label: `${isIndependent ? "独立分包" : "分包"} ${rootCandidate}`,
-			type: isIndependent || origin === "independent" ? "independent" : "subPackage"
-		};
+//#region src/analyze/subpackages/artifacts/index.ts
+function createArtifactAnalysis(packages, resolveOwner = createModuleOwnerResolver()) {
+	const files = /* @__PURE__ */ new Map();
+	const moduleCopies = /* @__PURE__ */ new Map();
+	for (const pkg of packages) for (const file of pkg.files) {
+		if (files.has(file.file)) throw new Error(`产物重复归属：${file.file}`);
+		if (typeof file.size !== "number" || !Number.isFinite(file.size) || file.size < 0) throw new Error(`产物缺少有效字节数：${file.file}`);
+		const retained = (file.modules ?? []).filter((module) => module.bytes !== 0);
+		const length = (value) => typeof value === "number" && Number.isFinite(value) && value > 0 ? value : 0;
+		const totalLength = retained.reduce((sum, module) => sum + length(module.bytes), 0);
+		const scale = Math.max(totalLength, file.moduleRenderedLength ?? 0, file.size);
+		const modules = retained.map((module) => {
+			const owner = resolveOwner(module.id);
+			const category = classifyOwnedModule(owner, module.sourceType === "src" || module.sourceType === "plugin");
+			const estimatedBytes = scale > 0 ? file.size * length(module.bytes) / scale : 0;
+			const copies = moduleCopies.get(module.id) ?? [];
+			copies.push(estimatedBytes);
+			moduleCopies.set(module.id, copies);
+			return {
+				source: module.source,
+				package: owner,
+				category,
+				renderedLength: module.bytes,
+				estimatedBytes
+			};
+		});
+		const runtime = modules.filter((module) => isRuntimeCategory(module.category));
+		const roles = new Set(modules.map((module) => isRuntimeCategory(module.category) ? "runtime" : module.category === "application" ? "application" : module.category === "dependency" ? "dependency" : "unknown"));
+		const isAsset = file.type === "asset" && !file.modules && !/\.[cm]?js$/i.test(file.file);
+		const role = isAsset ? "asset" : roles.size > 1 ? "mixed" : [...roles][0] ?? "unknown";
+		files.set(file.file, {
+			file: file.file,
+			packageId: pkg.id,
+			origin: file.from,
+			type: file.type,
+			bytes: file.size,
+			sha256: file.sha256,
+			role,
+			classification: isAsset ? "asset" : modules.length ? "module-ownership" : "unavailable",
+			estimation: "rendered-length-proportional",
+			modules,
+			runtimeEstimatedBytes: runtime.reduce((sum, module) => sum + module.estimatedBytes, 0),
+			unattributedBytes: Math.max(0, file.size - modules.reduce((sum, module) => sum + module.estimatedBytes, 0))
+		});
 	}
+	const artifacts = [...files.values()].sort((a, b) => a.file.localeCompare(b.file));
+	if (artifacts.length === 0) throw new Error("未生成可分析产物，不能把缺失输出计为零字节。");
 	return {
-		id: "__main__",
-		label: "主包",
-		type: "main"
-	};
-}
-function normalizeModuleId(id) {
-	if (!id || id.includes(VIRTUAL_MODULE_INDICATOR)) return;
-	if (!posix.isAbsolute(id)) return;
-	return posix.normalize(id);
-}
-function resolveModuleSourceType(absoluteId, ctx) {
-	const { configService } = ctx;
-	const isNodeModule = absoluteId.includes("/node_modules/") || absoluteId.includes("\\node_modules\\");
-	const pluginRoot = configService.absolutePluginRoot;
-	const srcRoot = configService.absoluteSrcRoot;
-	const sourceType = classifyModuleSourceKind({
-		isNodeModule,
-		inSrc: isPathInside(srcRoot, absoluteId),
-		inPlugin: pluginRoot ? isPathInside(pluginRoot, absoluteId) : false
-	});
-	return {
-		source: configService.relativeAbsoluteSrcRoot(absoluteId),
-		sourceType
-	};
-}
-function resolveAssetSource(fileName, ctx) {
-	const { configService } = ctx;
-	const normalized = posix.normalize(fileName);
-	const srcCandidate = posix.isAbsolute(normalized) ? normalized : posix.resolve(configService.absoluteSrcRoot, normalized);
-	if (isPathInside(configService.absoluteSrcRoot, srcCandidate)) return {
-		absolute: srcCandidate,
-		source: configService.relativeAbsoluteSrcRoot(srcCandidate),
-		sourceType: "src"
-	};
-	const pluginAbsolute = resolvePluginAssetAbsolute(normalized, configService.absolutePluginRoot);
-	if (pluginAbsolute) return {
-		absolute: pluginAbsolute,
-		source: configService.relativeAbsoluteSrcRoot(pluginAbsolute),
-		sourceType: "plugin"
+		files: artifacts,
+		totalBytes: artifacts.reduce((sum, file) => sum + file.bytes, 0),
+		duplicateEstimatedBytes: [...moduleCopies.values()].reduce((sum, copies) => sum + copies.reduce((a, b) => a + b, 0) - Math.max(...copies), 0),
+		runtime: {
+			estimatedBytes: artifacts.reduce((sum, file) => sum + file.runtimeEstimatedBytes, 0),
+			upperBoundBytes: artifacts.filter((file) => file.modules.some((module) => isRuntimeCategory(module.category))).reduce((sum, file) => sum + file.bytes, 0),
+			unknownFiles: artifacts.filter((file) => file.role === "unknown" || file.modules.some((module) => module.category === "unknown")).map((file) => file.file)
+		}
 	};
 }
 //#endregion
@@ -1619,6 +1685,7 @@ function processChunk(chunk, origin, ctx, classifierContext, packages, modules)
 		type: "chunk",
 		from: origin,
 		size: typeof chunk.code === "string" ? Buffer.byteLength(chunk.code, "utf8") : void 0,
+		sha256: createHash("sha256").update(chunk.code).digest("hex"),
 		...getCompressedSizes$1(chunk.code),
 		isEntry: chunk.isEntry,
 		modules: []
@@ -1626,10 +1693,15 @@ function processChunk(chunk, origin, ctx, classifierContext, packages, modules)
 	if (chunk.imports.length > 0) chunkEntry.imports = [...chunk.imports].sort((a, b) => a.localeCompare(b));
 	if (chunk.dynamicImports.length > 0) chunkEntry.dynamicImports = [...chunk.dynamicImports].sort((a, b) => a.localeCompare(b));
 	const moduleEntries = Object.entries(chunk.modules ?? {});
+	chunkEntry.moduleRenderedLength = moduleEntries.reduce((sum, [, info]) => sum + (typeof info.renderedLength === "number" && Number.isFinite(info.renderedLength) && info.renderedLength > 0 ? info.renderedLength : 0), 0);
 	for (const [rawModuleId, info] of moduleEntries) {
-		const absoluteId = normalizeModuleId(rawModuleId);
+		const generatedRuntime = rawModuleId === "\0rolldown/runtime.js";
+		const absoluteId = generatedRuntime ? rawModuleId : normalizeModuleId(rawModuleId);
 		if (!absoluteId) continue;
-		const { source, sourceType } = resolveModuleSourceType(absoluteId, ctx);
+		const { source, sourceType } = generatedRuntime ? {
+			source: "rolldown:runtime",
+			sourceType: "workspace"
+		} : resolveModuleSourceType(absoluteId, ctx);
 		const moduleEntry = {
 			id: absoluteId,
 			source,
@@ -1652,6 +1724,7 @@ function processAsset(asset, origin, ctx, classifierContext, packages, modules)
 		type: "asset",
 		from: origin,
 		size: assetBuffer?.byteLength,
+		sha256: assetBuffer ? createHash("sha256").update(assetBuffer).digest("hex") : void 0,
 		...getCompressedSizes$1(assetBuffer)
 	};
 	let assetSource;
@@ -1672,7 +1745,16 @@ function processOutput(output, origin, ctx, classifierContext, packages, modules
 		processChunk(item, origin, ctx, classifierContext, packages, modules);
 		onArtifact?.(item.fileName, item.code);
 	} else if (item.type === "asset") {
-		processAsset(item, origin, ctx, classifierContext, packages, modules);
+		const originalChunk = ctx.runtimeState?.build?.output?.analysisChunks?.get(item.fileName);
+		if (originalChunk) {
+			processChunk({
+				...originalChunk,
+				fileName: item.fileName,
+				code: Buffer.from(item.source).toString("utf8")
+			}, origin, ctx, classifierContext, packages, modules);
+			const classification = classifyPackage(item.fileName, origin, classifierContext);
+			packages.get(classification.id).files.get(item.fileName).type = "asset";
+		} else processAsset(item, origin, ctx, classifierContext, packages, modules);
 		onArtifact?.(item.fileName, item.source);
 	}
 }
@@ -1777,7 +1859,7 @@ function summarizeSubPackages(metas) {
 }
 //#endregion
 //#region src/analyze/subpackages/index.ts
-async function analyzeSubpackages(ctx, options) {
+async function analyzeBuild(ctx, options) {
 	const { configService, scanService, buildService } = ctx;
 	if (!configService || !scanService || !buildService) throw new Error("analyzeSubpackages 需要先初始化 configService、scanService 和 buildService。");
 	await scanService.loadAppEntry();
@@ -1815,9 +1897,22 @@ async function analyzeSubpackages(ctx, options) {
 	}
 	expandVirtualModulePlacements(modules, packages, classifierContext);
 	const subPackages = summarizeSubPackages(subPackageMetas);
-	return {
+	const packageReports = summarizePackages(packages);
+	const artifacts = createArtifactAnalysis(packageReports);
+	const result = {
+		schemaVersion: 2,
+		build: {
+			id: createHash("sha256").update(JSON.stringify([
+				configService.platform,
+				configService.mode,
+				artifacts.files.map((file) => [file.file, file.sha256])
+			])).digest("hex"),
+			platform: configService.platform,
+			mode: configService.mode
+		},
+		artifacts,
 		metadata: createAnalyzeMetadata(ctx.configService),
-		packages: summarizePackages(packages),
+		packages: packageReports,
 		modules: summarizeModules(modules),
 		subPackages,
 		components: analyzeComponentUsage({
@@ -1826,6 +1921,17 @@ async function analyzeSubpackages(ctx, options) {
 		}),
 		glassEasel: createGlassEaselAnalyzeResult(ctx)
 	};
+	result.budgetChecks = createAnalyzeBudgetCheck(result);
+	return result;
+}
+async function analyzeSubpackages(ctx, options) {
+	const previous = ctx.runtimeState.build.output.analysisChunks;
+	ctx.runtimeState.build.output.analysisChunks = /* @__PURE__ */ new Map();
+	try {
+		return await analyzeBuild(ctx, options);
+	} finally {
+		ctx.runtimeState.build.output.analysisChunks = previous;
+	}
 }
 //#endregion
 //#region src/analyze/subpackages/history.ts
@@ -1897,6 +2003,7 @@ function formatAnalyzeBytes(bytes) {
 	return `${value.toFixed(value >= 100 || unitIndex === 0 ? 0 : 2)} ${units[unitIndex]}`;
 }
 function formatDelta(bytes) {
+	if (bytes === null) return "缺少体积测量";
 	if (typeof bytes !== "number" || Number.isNaN(bytes) || bytes === 0) return "无变化";
 	return `${bytes > 0 ? "+" : "-"}${formatAnalyzeBytes(Math.abs(bytes))}`;
 }
@@ -1906,77 +2013,8 @@ function getFileSize(file) {
 function getCompressedSize(file) {
 	return file.brotliSize ?? file.gzipSize ?? 0;
 }
-function getBudgetLimit(type, budgets) {
-	if (!budgets) return;
-	if (type === "main") return budgets.mainBytes;
-	if (type === "subPackage") return budgets.subPackageBytes;
-	if (type === "independent") return budgets.independentBytes;
-}
-function createPackageSizeMap(result) {
-	return new Map((result?.packages ?? []).map((pkg) => {
-		const totalBytes = pkg.files.reduce((sum, file) => sum + getFileSize(file), 0);
-		return [pkg.id, totalBytes];
-	}));
-}
-function createFileKey(packageId, fileName) {
-	return `${packageId}\u0000${fileName}`;
-}
-function createFileSizeMap(result) {
-	const map = /* @__PURE__ */ new Map();
-	for (const pkg of result?.packages ?? []) for (const file of pkg.files) map.set(createFileKey(pkg.id, file.file), getFileSize(file));
-	return map;
-}
-function createPackageTypeMap(result) {
-	return new Map(result.packages.map((pkg) => [pkg.id, pkg.type]));
-}
-function createModuleByteMap(result) {
-	const map = /* @__PURE__ */ new Map();
-	for (const pkg of result.packages) for (const file of pkg.files) for (const mod of file.modules ?? []) {
-		const bytes = mod.bytes ?? mod.originalBytes ?? 0;
-		map.set(mod.id, Math.max(map.get(mod.id) ?? 0, bytes));
-	}
-	return map;
-}
-function classifyIncrementCategory(source, sourceType) {
-	if (source.includes("wevu") || source.includes("@weapp-vite/dashboard")) return "WeVu / runtime";
-	if (sourceType === "node_modules" || source.includes("node_modules")) return "第三方依赖";
-	if (sourceType === "workspace") return "工作区包";
-	if (sourceType === "plugin") return "插件生成";
-	if (source.endsWith(".wxss") || source.endsWith(".css") || source.endsWith(".scss")) return "样式资源";
-	if (source.endsWith(".wxml") || source.endsWith(".json")) return "页面结构";
-	return "业务源码";
-}
-function createIncrementAdvice(item) {
-	if (item.category === "第三方依赖") return "检查依赖是否只在必要分包引用，必要时收敛到公共入口或替换轻量实现。";
-	if (item.category === "WeVu / runtime") return "确认运行时能力是否被新页面引入，优先排查组件和 API 引用边界。";
-	if (item.category === "样式资源") return "检查样式重复、原子类生成范围和组件样式裁剪。";
-	if (item.type === "new-file" || item.type === "new-module") return "确认是否为本次需求必要新增，评估分包归属和懒加载边界。";
-	return "对比本次变更，优先查看新增引用、共享模块和大对象常量。";
-}
-function createModuleSizeMap(result) {
-	const map = /* @__PURE__ */ new Map();
-	for (const pkg of result?.packages ?? []) for (const file of pkg.files) for (const module of file.modules ?? []) {
-		const bytes = module.bytes ?? module.originalBytes ?? 0;
-		const existing = map.get(module.id);
-		if (existing && existing.bytes >= bytes) continue;
-		map.set(module.id, {
-			source: module.source,
-			sourceType: module.sourceType,
-			bytes,
-			packageLabel: pkg.label,
-			file: file.file
-		});
-	}
-	return map;
-}
-function createDuplicateAdvice(sourceType, packageIds, packageTypeMap, estimatedSavingBytes) {
-	if (packageIds.some((packageId) => packageTypeMap.get(packageId) === "independent")) return estimatedSavingBytes > 0 ? "含独立分包，先确认隔离要求，再评估是否抽公共入口。" : "含独立分包，重复可能来自隔离边界。";
-	if (sourceType === "node_modules") return "依赖被多个包带入，检查引用边界或考虑主包公共入口。";
-	if (sourceType === "src" || sourceType === "workspace") return "共享源码跨包重复，优先抽公共模块或调整分包归属。";
-	if (sourceType === "plugin") return "插件生成内容跨包重复，检查插件产物输出策略。";
-	return "检查该模块是否需要在多个包内重复存在。";
-}
 function formatBudgetStatus(item) {
+	if (item.status === "unknown") return "归因或产物字节不足，无法验收";
 	if (item.status === "ok") return "正常";
 	return `${item.status === "exceeded" ? "超预算" : "接近预算"} ${(item.ratio * 100).toFixed(1)}%`;
 }
@@ -1991,124 +2029,22 @@ function createActionItems(options) {
 	if (actions.length === 0) actions.push("当前没有预算超限或高收益重复模块，保持观察即可。");
 	return actions;
 }
-function createAnalyzeBudgetCheck(result) {
-	const budgets = result.metadata?.budgets;
-	if (!budgets) return [];
-	const items = [];
-	const totalBytes = result.packages.flatMap((pkg) => pkg.files).reduce((sum, file) => sum + getFileSize(file), 0);
-	const warningRatio = budgets.warningRatio;
-	const createItem = (options) => {
-		const ratio = options.limitBytes > 0 ? options.currentBytes / options.limitBytes : 0;
-		const status = ratio >= 1 ? "exceeded" : ratio >= warningRatio ? "warning" : "ok";
-		return {
-			...options,
-			ratio,
-			status
-		};
-	};
-	items.push(createItem({
-		id: "__total__",
-		label: "总包",
-		scope: "total",
-		currentBytes: totalBytes,
-		limitBytes: budgets.totalBytes
-	}));
-	for (const pkg of result.packages) {
-		const limitBytes = getBudgetLimit(pkg.type, budgets);
-		if (!limitBytes) continue;
-		items.push(createItem({
-			id: pkg.id,
-			label: pkg.label,
-			scope: pkg.type,
-			currentBytes: pkg.files.reduce((sum, file) => sum + getFileSize(file), 0),
-			limitBytes
-		}));
-	}
-	return items.sort((a, b) => b.ratio - a.ratio || a.label.localeCompare(b.label));
-}
-function createDuplicateModuleInsights(result) {
-	const moduleByteMap = createModuleByteMap(result);
-	const packageTypeMap = createPackageTypeMap(result);
-	return result.modules.filter((module) => module.packages.length > 1).map((module) => {
-		const bytes = moduleByteMap.get(module.id) ?? 0;
-		const packageIds = module.packages.map((pkg) => pkg.packageId);
-		const estimatedSavingBytes = bytes * Math.max(module.packages.length - 1, 0);
-		return {
-			id: module.id,
-			source: module.source,
-			sourceType: module.sourceType,
-			packageCount: module.packages.length,
-			bytes,
-			estimatedSavingBytes,
-			packages: packageIds,
-			advice: createDuplicateAdvice(module.sourceType, packageIds, packageTypeMap, estimatedSavingBytes)
-		};
-	}).sort((a, b) => b.estimatedSavingBytes - a.estimatedSavingBytes || b.packageCount - a.packageCount || a.source.localeCompare(b.source));
-}
-function createAnalyzeIncrementAttribution(result, previousResult) {
-	if (!previousResult) return [];
-	const previousFiles = createFileSizeMap(previousResult);
-	const previousModules = createModuleSizeMap(previousResult);
-	const currentModules = createModuleSizeMap(result);
-	const items = [];
-	for (const pkg of result.packages) for (const file of pkg.files) {
-		const currentBytes = getFileSize(file);
-		const previousBytes = previousFiles.get(createFileKey(pkg.id, file.file)) ?? 0;
-		const deltaBytes = currentBytes - previousBytes;
-		if (deltaBytes <= 0) continue;
-		const type = previousBytes > 0 ? "increased-file" : "new-file";
-		const item = {
-			key: `file:${pkg.id}:${file.file}`,
-			type,
-			label: file.file,
-			category: classifyIncrementCategory(file.source ?? file.file),
-			packageLabel: pkg.label,
-			file: file.file,
-			currentBytes,
-			previousBytes,
-			deltaBytes,
-			advice: ""
-		};
-		items.push({
-			...item,
-			advice: createIncrementAdvice(item)
-		});
-	}
-	for (const [id, module] of currentModules) {
-		const previousBytes = previousModules.get(id)?.bytes ?? 0;
-		const deltaBytes = module.bytes - previousBytes;
-		if (deltaBytes <= 0) continue;
-		const type = previousBytes > 0 ? "increased-module" : "new-module";
-		const item = {
-			key: `module:${id}`,
-			type,
-			label: module.source,
-			category: classifyIncrementCategory(module.source, module.sourceType),
-			packageLabel: module.packageLabel,
-			file: module.file,
-			currentBytes: module.bytes,
-			previousBytes,
-			deltaBytes,
-			advice: ""
-		};
-		items.push({
-			...item,
-			advice: createIncrementAdvice(item)
-		});
-	}
-	return items.sort((a, b) => b.deltaBytes - a.deltaBytes || a.category.localeCompare(b.category) || a.label.localeCompare(b.label));
+function createReportGrowth(comparison) {
+	if (!comparison) return [];
+	return [...comparison.files, ...comparison.modules].filter((item) => item.deltaBytes !== null && item.deltaBytes > 0).sort((a, b) => b.deltaBytes - a.deltaBytes || (a.category ?? "").localeCompare(b.category ?? "") || a.label.localeCompare(b.label));
 }
 function createAnalyzeIncrementCategorySummary(items) {
 	const map = /* @__PURE__ */ new Map();
 	for (const item of items) {
-		const entry = map.get(item.category) ?? {
-			category: item.category,
+		const category = item.category ?? "";
+		const entry = map.get(category) ?? {
+			category,
 			count: 0,
 			deltaBytes: 0
 		};
 		entry.count += 1;
 		entry.deltaBytes += item.deltaBytes;
-		map.set(item.category, entry);
+		map.set(category, entry);
 	}
 	return [...map.values()].sort((a, b) => b.deltaBytes - a.deltaBytes || b.count - a.count || a.category.localeCompare(b.category));
 }
@@ -2119,8 +2055,8 @@ function createAnalyzePrMarkdownReport(result, previousResult) {
 	})));
 	const totalBytes = files.reduce((sum, item) => sum + getFileSize(item.file), 0);
 	const compressedBytes = files.reduce((sum, item) => sum + getCompressedSize(item.file), 0);
-	const previousTotalBytes = previousResult?.packages.flatMap((pkg) => pkg.files).reduce((sum, file) => sum + getFileSize(file), 0);
-	const incrementItems = createAnalyzeIncrementAttribution(result, previousResult);
+	const comparison = previousResult ? createAnalyzeComparison(result, previousResult) : void 0;
+	const incrementItems = createReportGrowth(comparison);
 	const incrementSummary = createAnalyzeIncrementCategorySummary(incrementItems);
 	const duplicateInsights = createDuplicateModuleInsights(result);
 	const budgetItems = createAnalyzeBudgetCheck(result);
@@ -2136,7 +2072,7 @@ function createAnalyzePrMarkdownReport(result, previousResult) {
 	return [
 		"## weapp-vite analyze PR 摘要",
 		"",
-		`- 总产物体积：${formatAnalyzeBytes(totalBytes)}（较上次 ${formatDelta(typeof previousTotalBytes === "number" ? totalBytes - previousTotalBytes : void 0)}）`,
+		`- 总产物体积：${formatAnalyzeBytes(totalBytes)}（较上次 ${formatDelta(comparison?.deltaBytes)}）`,
 		`- 压缩后体积：${formatAnalyzeBytes(compressedBytes)}`,
 		`- 预算告警：${budgetIssues.length}`,
 		`- 增量归因：${incrementItems.length > 0 ? `${incrementItems.length} 项正向增长` : "无正向增长"}`,
@@ -2180,11 +2116,11 @@ function createAnalyzeMarkdownReport(result, previousResult) {
 	const totalBytes = files.reduce((sum, item) => sum + getFileSize(item.file), 0);
 	const compressedBytes = files.reduce((sum, item) => sum + getCompressedSize(item.file), 0);
 	const duplicateInsights = createDuplicateModuleInsights(result);
-	const incrementItems = createAnalyzeIncrementAttribution(result, previousResult);
+	const comparison = previousResult ? createAnalyzeComparison(result, previousResult) : void 0;
+	const incrementItems = createReportGrowth(comparison);
 	const incrementSummary = createAnalyzeIncrementCategorySummary(incrementItems);
 	const budgetItems = createAnalyzeBudgetCheck(result);
-	const previousTotalBytes = previousResult?.packages.flatMap((pkg) => pkg.files).reduce((sum, file) => sum + getFileSize(file), 0);
-	const previousPackageSizes = createPackageSizeMap(previousResult);
+	const packageDeltas = new Map(comparison?.packages.map((item) => [item.packageId, item.deltaBytes]));
 	const budgets = result.metadata?.budgets;
 	const budgetIssues = budgetItems.filter((item) => item.status !== "ok");
 	const actionItems = createActionItems({
@@ -2194,9 +2130,9 @@ function createAnalyzeMarkdownReport(result, previousResult) {
 	const packageRows = result.packages.map((pkg) => {
 		const size = pkg.files.reduce((sum, file) => sum + getFileSize(file), 0);
 		const compressed = pkg.files.reduce((sum, file) => sum + getCompressedSize(file), 0);
-		const previousSize = previousPackageSizes.get(pkg.id);
+		const delta = packageDeltas.has(pkg.id) ? packageDeltas.get(pkg.id) : 0;
 		const budgetStatus = budgetItems.find((item) => item.id === pkg.id);
-		return `| ${pkg.label} | ${pkg.type} | ${formatAnalyzeBytes(size)} | ${formatAnalyzeBytes(compressed)} | ${formatDelta(typeof previousSize === "number" ? size - previousSize : void 0)} | ${budgetStatus ? formatBudgetStatus(budgetStatus) : "正常"} |`;
+		return `| ${pkg.label} | ${pkg.type} | ${formatAnalyzeBytes(size)} | ${formatAnalyzeBytes(compressed)} | ${formatDelta(delta)} | ${budgetStatus ? formatBudgetStatus(budgetStatus) : "正常"} |`;
 	}).join("\n");
 	const topFileRows = files.sort((a, b) => getFileSize(b.file) - getFileSize(a.file) || a.file.file.localeCompare(b.file.file)).slice(0, 10).map((item) => `| ${item.file.file} | ${item.pkg.label} | ${item.file.type} | ${formatAnalyzeBytes(getFileSize(item.file))} | ${formatAnalyzeBytes(getCompressedSize(item.file))} |`).join("\n");
 	const duplicateRows = duplicateInsights.slice(0, 10).map((module) => `| ${module.source} | ${module.sourceType} | ${module.packageCount} | ${formatAnalyzeBytes(module.estimatedSavingBytes)} | ${module.advice} |`).join("\n");
@@ -2212,7 +2148,7 @@ function createAnalyzeMarkdownReport(result, previousResult) {
 		"",
 		`- 总产物体积：${formatAnalyzeBytes(totalBytes)}`,
 		`- 压缩后体积：${formatAnalyzeBytes(compressedBytes)}`,
-		`- 较上次：${formatDelta(typeof previousTotalBytes === "number" ? totalBytes - previousTotalBytes : void 0)}`,
+		`- 较上次：${formatDelta(comparison?.deltaBytes)}`,
 		`- 包体数量：${result.packages.length}`,
 		`- 源码模块：${result.modules.length}`,
 		`- 跨包复用：${duplicateInsights.length}`,
@@ -2259,725 +2195,164 @@ function createAnalyzeMarkdownReport(result, previousResult) {
 	].join("\n");
 }
 //#endregion
-//#region src/cli/analyze/dashboardDevframe/artifacts.ts
-const MAX_DASHBOARD_FILE_CONTENT_BYTES = 2097152;
-/** 保留同一次分析的产物内容，不读取或改写开发构建目录。 */
-function createDashboardArtifactSnapshot() {
-	const files = /* @__PURE__ */ new Map();
-	let retainedBytes = 0;
-	return {
-		files,
-		capture(fileName, source) {
-			const key = fileName.replaceAll("\\", "/");
-			const previous = files.get(key);
-			if (previous?.content !== void 0) retainedBytes -= previous.size;
-			const size = typeof source === "string" ? Buffer.byteLength(source, "utf8") : source.byteLength;
-			if (size > 2097152) {
-				files.set(key, {
-					size,
-					error: `文件超过 ${MAX_DASHBOARD_FILE_CONTENT_BYTES} 字节，已拒绝读取。`
-				});
-				return;
-			}
-			if (retainedBytes + size > 33554432) {
-				files.set(key, {
-					size,
-					error: "分析产物内容超过快照容量上限，已拒绝读取。"
-				});
-				return;
-			}
-			const content = typeof source === "string" ? source : Buffer.from(source.buffer, source.byteOffset, source.byteLength).toString("utf8");
-			files.set(key, {
-				content,
-				size
-			});
-			retainedBytes += size;
-		}
-	};
+//#region src/cli/analyze/dashboard.ts
+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(" ")}`;
 }
-//#endregion
-//#region src/cli/analyze/dashboardDevframe/paths.ts
-function normalizeDashboardRelativePath(value) {
-	return value.replaceAll("\\", "/");
-}
-function stripDashboardFileQuery(value) {
-	const queryIndex = value.indexOf("?");
-	return queryIndex === -1 ? value : value.slice(0, queryIndex);
-}
-function addDashboardAllowedPath(paths, value) {
-	if (!value || value.includes("\0")) return;
-	const normalizedPath = normalizeDashboardRelativePath(stripDashboardFileQuery(value));
-	if (!normalizedPath || path.isAbsolute(normalizedPath)) return;
-	paths.add(normalizedPath);
-}
-function addDashboardAllowedSourcePath(paths, value, rootKind) {
-	if (!value || value.includes("\0")) return;
-	const normalizedPath = normalizeDashboardRelativePath(stripDashboardFileQuery(value));
-	if (!normalizedPath || path.isAbsolute(normalizedPath)) return;
-	const rootKinds = paths.get(normalizedPath) ?? /* @__PURE__ */ new Set();
-	rootKinds.add(rootKind);
-	paths.set(normalizedPath, rootKinds);
-}
-function resolveDashboardSourceRootKind(sourceType) {
-	if (sourceType === "plugin") return "plugin";
-	if (sourceType === "workspace" || sourceType === "node_modules") return "project";
-	return "src";
-}
-function createDashboardContentAllowlist(result) {
-	const artifactPaths = /* @__PURE__ */ new Set();
-	const sourcePaths = /* @__PURE__ */ new Map();
-	for (const packageReport of result.packages) for (const file of packageReport.files) {
-		addDashboardAllowedPath(artifactPaths, file.file);
-		const fileSourceType = file.sourceType ?? file.modules?.find((module) => module.source === file.source)?.sourceType;
-		addDashboardAllowedSourcePath(sourcePaths, file.source, resolveDashboardSourceRootKind(fileSourceType));
-		for (const module of file.modules ?? []) addDashboardAllowedSourcePath(sourcePaths, module.source, module.sourceType === "src" ? "src" : module.sourceType === "plugin" ? "plugin" : "project");
+async function startAnalyzeDashboard(result, options) {
+	const shutdown = getDevShutdownScope();
+	const resolved = resolveDashboardRoot(options);
+	if (!resolved) {
+		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)))}`);
+		return;
 	}
-	return {
-		artifactPaths,
-		sourcePaths
-	};
-}
-function resolveDashboardContentPath(root, requestPath, options) {
-	if (!root || !requestPath || requestPath.includes("\0")) return;
-	const normalizedRequestPath = normalizeDashboardRelativePath(stripDashboardFileQuery(requestPath));
-	if (path.isAbsolute(normalizedRequestPath) || !options.allowedPaths.has(normalizedRequestPath)) return;
-	const rootPath = path.resolve(root);
-	const absolutePath = path.resolve(rootPath, normalizedRequestPath);
-	const relativePath = path.relative(rootPath, absolutePath);
-	const allowParent = options.allowParent === true;
-	if (!relativePath || !allowParent && (relativePath.startsWith("..") || path.isAbsolute(relativePath))) return;
-	return {
-		absolutePath,
-		allowParent,
-		relativePath: allowParent ? normalizedRequestPath : normalizeDashboardRelativePath(relativePath),
-		rootPath
-	};
-}
-function resolveDashboardSourceContentPaths(roots, requestPath, allowedPaths) {
-	const normalizedRequestPath = normalizeDashboardRelativePath(stripDashboardFileQuery(requestPath));
-	const rootKinds = allowedPaths.get(normalizedRequestPath);
-	if (!rootKinds || rootKinds.size !== 1) return [];
-	const [rootKind] = rootKinds;
-	if (rootKind === "project") {
-		const resolved = resolveDashboardContentPath(roots.projectRoot, normalizedRequestPath, {
-			allowParent: true,
-			allowedPaths: /* @__PURE__ */ new Set([normalizedRequestPath])
-		});
-		return resolved ? [resolved] : [];
-	}
-	if (rootKind === "plugin") {
-		if (!roots.pluginRoot) return [];
-		const pluginBase = path.basename(roots.pluginRoot);
-		if (normalizedRequestPath !== pluginBase && !normalizedRequestPath.startsWith(`${pluginBase}/`)) return [];
-		const pluginRelativePath = normalizedRequestPath === pluginBase ? "" : normalizedRequestPath.slice(pluginBase.length + 1);
-		const resolved = resolveDashboardContentPath(roots.pluginRoot, pluginRelativePath, { allowedPaths: /* @__PURE__ */ new Set([pluginRelativePath]) });
-		return resolved ? [{
-			...resolved,
-			relativePath: normalizedRequestPath
-		}] : [];
-	}
-	if (!roots.srcRoot) return [];
-	const candidates = (normalizedRequestPath.startsWith("src/") ? [normalizedRequestPath, normalizedRequestPath.slice(4)] : [normalizedRequestPath]).flatMap((relativePath) => {
-		const resolved = resolveDashboardContentPath(roots.srcRoot, relativePath, { allowedPaths: /* @__PURE__ */ new Set([relativePath]) });
-		return resolved ? [{
-			...resolved,
-			relativePath: normalizedRequestPath
-		}] : [];
+	const { root, configFile } = resolved;
+	const { ANALYZE_DASHBOARD_DEVFRAME_BASE, ANALYZE_DASHBOARD_HUB_BASE, createAnalyzeDashboardViteBridge } = await import("./dashboardViteBridge-Dy3nAD4m.mjs");
+	const devframe = createAnalyzeDashboardDevframe({
+		clientAssets: options.uiHost === "hub" ? root : void 0,
+		snapshot: {
+			current: result,
+			previous: options.previousResult ?? null,
+			artifacts: options.artifacts
+		},
+		initialEvents: [{
+			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"]
+		}, ...options.initialEvents ?? []],
+		roots: {
+			pluginRoot: options.pluginRoot,
+			projectRoot: options.cwd,
+			srcRoot: options.srcRoot ?? (options.cwd ? path.resolve(options.cwd, "src") : void 0)
+		}
 	});
-	return [...new Map(candidates.map((candidate) => [candidate.absolutePath, candidate])).values()];
-}
-function resolveDashboardArtifactPath(requestPath, allowedPaths) {
-	const normalizedPath = normalizeDashboardRelativePath(stripDashboardFileQuery(requestPath));
-	if (!normalizedPath || normalizedPath.includes("\0") || path.isAbsolute(normalizedPath) || path.posix.normalize(normalizedPath).startsWith("..") || !allowedPaths.has(normalizedPath)) return;
-	return normalizedPath;
-}
-//#endregion
-//#region src/cli/analyze/dashboardDevframe/content.ts
-function isPathWithin(rootPath, targetPath) {
-	const relativePath = path.relative(rootPath, targetPath);
-	return !relativePath || !relativePath.startsWith("..") && !path.isAbsolute(relativePath);
-}
-function resolveInspectionRoot(resolved) {
-	let inspectionRoot = resolved.rootPath;
-	if (!resolved.allowParent) return inspectionRoot;
-	while (!isPathWithin(inspectionRoot, resolved.absolutePath)) {
-		const parent = path.dirname(inspectionRoot);
-		if (parent === inspectionRoot) return;
-		inspectionRoot = parent;
-	}
-	return inspectionRoot;
-}
-async function assertDashboardPathHasNoSymlink(resolved) {
-	const inspectionRoot = resolveInspectionRoot(resolved);
-	if (!inspectionRoot) throw new Error("文件路径超出允许范围。");
-	const relativePath = path.relative(inspectionRoot, resolved.absolutePath);
-	let currentPath = inspectionRoot;
-	for (const segment of relativePath.split(path.sep).filter(Boolean)) {
-		currentPath = path.join(currentPath, segment);
-		if ((await fs.promises.lstat(currentPath)).isSymbolicLink()) throw new Error("文件路径包含不允许的符号链接。");
-	}
-}
-function isSameOpenedFile(pathStat, handleStat) {
-	if (pathStat.dev !== handleStat.dev) return false;
-	return pathStat.ino === 0 || handleStat.ino === 0 || pathStat.ino === handleStat.ino;
-}
-async function openDashboardFile(resolved) {
-	await assertDashboardPathHasNoSymlink(resolved);
-	const flags = process.platform === "win32" ? fs.constants.O_RDONLY : fs.constants.O_RDONLY | fs.constants.O_NOFOLLOW;
-	const handle = await fs.promises.open(resolved.absolutePath, flags);
+	const bridge = createAnalyzeDashboardViteBridge(devframe, {
+		projectRoot: options.cwd ?? process.cwd(),
+		uiHost: options.uiHost
+	});
+	let server;
+	let onHostClose;
+	const closeResources = async () => {
+		return (await Promise.allSettled([
+			Promise.resolve().then(() => devframe.dispose()),
+			Promise.resolve().then(() => bridge.close()),
+			Promise.resolve().then(() => shutdown ? shutdown.run("cleanup", () => server?.close()) : server?.close())
+		])).filter((result) => result.status === "rejected").map((result) => result.reason);
+	};
 	try {
-		await assertDashboardPathHasNoSymlink(resolved);
-		const [pathStat, handleStat] = await Promise.all([fs.promises.stat(resolved.absolutePath), handle.stat()]);
-		if (!isSameOpenedFile(pathStat, handleStat)) throw new Error("文件路径在读取期间发生变化。");
-		return handle;
+		server = await createDevViteServer({
+			root,
+			base: ANALYZE_DASHBOARD_DEVFRAME_BASE,
+			configFile: configFile ?? false,
+			clearScreen: false,
+			appType: "spa",
+			publicDir: false,
+			plugins: [{
+				name: "weapp-vite:dashboard-lifetime",
+				enforce: "pre",
+				configureServer(createdServer) {
+					server ??= createdServer;
+					const record = getDevServerCloseRecord(createdServer);
+					const close = record.close;
+					replaceDevServerClose(createdServer, async () => {
+						try {
+							await close();
+						} finally {
+							if (server && getDevServerCloseRecord(server) === record) onHostClose?.();
+						}
+					});
+				}
+			}, bridge],
+			server: {
+				host: "127.0.0.1",
+				port: 0,
+				watch: { ignored: ["**/*"] }
+			},
+			logLevel: "error"
+		});
+		if (!shutdown?.stopping) await server.listen(0);
 	} catch (error) {
-		await handle.close();
+		const cleanupErrors = await closeResources();
+		if (cleanupErrors.length) throw new AggregateError([error, ...cleanupErrors], "Dashboard 启动及资源清理失败", { cause: error });
 		throw error;
 	}
-}
-async function readDashboardFileHandle(handle) {
-	const stat = await handle.stat();
-	if (!stat.isFile()) throw new Error("目标路径不是文件。");
-	if (stat.size > 2097152) throw new Error(`文件超过 ${MAX_DASHBOARD_FILE_CONTENT_BYTES} 字节，已拒绝读取。`);
-	let content = Buffer.allocUnsafe(Math.min(Math.max(stat.size + 1, 1), 2097153));
-	let offset = 0;
-	while (true) {
-		if (offset === content.length) {
-			if (content.length === 2097153) throw new Error(`文件超过 ${MAX_DASHBOARD_FILE_CONTENT_BYTES} 字节，已拒绝读取。`);
-			const expanded = Buffer.allocUnsafe(Math.min(content.length * 2, 2097153));
-			content.copy(expanded, 0, 0, offset);
-			content = expanded;
-		}
-		const { bytesRead } = await handle.read(content, offset, content.length - offset, offset);
-		if (bytesRead === 0) break;
-		offset += bytesRead;
-		if (offset > 2097152) throw new Error(`文件超过 ${MAX_DASHBOARD_FILE_CONTENT_BYTES} 字节，已拒绝读取。`);
-	}
-	return {
-		content: content.subarray(0, offset).toString("utf8"),
-		size: offset
+	const activeServer = server;
+	const urls = [...activeServer.resolvedUrls?.local ?? [], ...activeServer.resolvedUrls?.network ?? []];
+	const authCode = refreshTempAuthCode();
+	const authenticatedUrls = urls.map((url) => {
+		const entryUrl = options.uiHost === "hub" ? new URL(ANALYZE_DASHBOARD_HUB_BASE, url).href : url;
+		return buildOtpAuthUrl(entryUrl, authCode);
+	});
+	let closing;
+	let resolveExit;
+	const waitPromise = new Promise((resolve) => {
+		resolveExit = resolve;
+	});
+	const signals = ["SIGINT", "SIGTERM"];
+	let onExit;
+	let releaseOwnership;
+	const finish = () => {
+		for (const signal of signals) process.removeListener(signal, onExit);
+		releaseOwnership?.();
+		resolveExit();
 	};
-}
-function resolveDashboardFileLanguage(filePath) {
-	const extension = path.extname(filePath).toLowerCase();
-	if ([
-		".js",
-		".mjs",
-		".cjs",
-		".wxs",
-		".sjs"
-	].includes(extension)) return "javascript";
-	if ([
-		".ts",
-		".mts",
-		".cts"
-	].includes(extension)) return "typescript";
-	if ([".json", ".map"].includes(extension)) return "json";
-	if ([
-		".css",
-		".wxss",
-		".scss",
-		".sass",
-		".less"
-	].includes(extension)) return "css";
-	if ([
-		".vue",
-		".wxml",
-		".html"
-	].includes(extension)) return "html";
-	return "plaintext";
-}
-function normalizeDashboardFileRequest(input) {
-	if (!input || typeof input !== "object" || !("kind" in input) || !("path" in input)) throw new Error("必须传入合法的 kind 和相对路径。");
-	const kind = input.kind;
-	const requestPath = input.path;
-	if (kind !== "source" && kind !== "artifact" || typeof requestPath !== "string") throw new Error("必须传入合法的 kind 和相对路径。");
-	return {
-		kind,
-		path: requestPath
+	onHostClose = () => {
+		if (!closing) finish();
 	};
-}
-async function readAllowedDashboardFile(input, roots, allowlist, artifacts) {
-	const request = normalizeDashboardFileRequest(input);
-	if (request.kind === "artifact") {
-		const filePath = resolveDashboardArtifactPath(request.path, allowlist.artifactPaths);
-		if (!filePath) throw new Error("必须传入合法的 kind 和相对路径。");
-		const file = artifacts.get(filePath);
-		if (!file) throw new Error("分析快照中没有此产物内容。");
-		if (file.error || file.content === void 0) throw new Error(file.error ?? "分析快照中没有此产物内容。");
-		return {
-			kind: request.kind,
-			path: filePath,
-			language: resolveDashboardFileLanguage(filePath),
-			size: file.size,
-			content: file.content
-		};
+	const close = () => {
+		if (!closing) closing = closeResources().then((errors) => {
+			if (errors.length === 1) throw errors[0];
+			if (errors.length > 1) throw new AggregateError(errors, "Dashboard 资源清理失败");
+		}).finally(finish);
+		return closing;
+	};
+	onExit = async () => {
+		await close().catch((error) => logger_default.error(error));
+	};
+	if (!shutdown) for (const signal of signals) process.once(signal, onExit);
+	const handle = {
+		update: devframe.update,
+		emitRuntimeEvents: devframe.emitRuntimeEvents,
+		waitForExit: () => waitPromise,
+		close,
+		urls: authenticatedUrls
+	};
+	releaseOwnership = shutdown?.own(close);
+	if (shutdown?.stopping) {
+		await close();
+		return;
 	}
-	const resolvedCandidates = resolveDashboardSourceContentPaths(roots, request.path, allowlist.sourcePaths);
-	if (resolvedCandidates.length === 0) throw new Error("必须传入合法的 kind 和相对路径。");
-	const openedCandidates = [];
-	try {
-		for (const resolved of resolvedCandidates) try {
-			openedCandidates.push({
-				handle: await openDashboardFile(resolved),
-				resolved
-			});
-		} catch (error) {
-			if ((typeof error === "object" && error && "code" in error ? String(error.code) : "") !== "ENOENT") throw error;
+	if (options.watch) {
+		if (!options.silentStartupLog) {
+			logger_default.info("weapp-vite UI 已启动（分析视图，实时模式），按 Ctrl+C 退出。");
+			for (const url of handle.urls) logger_default.info(`  ➜  ${colors.bold(colors.cyan(url))}`);
 		}
-		if (openedCandidates.length === 0) throw new Error("文件不存在。");
-		if (openedCandidates.length > 1) throw new Error("源码路径存在多个候选文件，已拒绝读取。");
-		const [{ handle, resolved }] = openedCandidates;
-		const file = await readDashboardFileHandle(handle);
-		return {
-			kind: request.kind,
-			path: resolved.relativePath,
-			language: resolveDashboardFileLanguage(resolved.relativePath),
-			size: file.size,
-			content: file.content
-		};
-	} catch (error) {
-		if (error instanceof Error && (error.message === "文件不存在。" || error.message === "源码路径存在多个候选文件，已拒绝读取。" || error.message === "目标路径不是文件。" || error.message.startsWith("文件超过 ") || error.message.startsWith("文件路径"))) throw error;
-		throw new Error("读取文件失败。");
+		return handle;
+	}
+	if (!options.silentStartupLog) {
+		logger_default.info("weapp-vite UI 已启动（分析视图，静态模式），按 Ctrl+C 退出。");
+		for (const url of handle.urls) logger_default.info(`  ➜  ${colors.bold(colors.cyan(url))}`);
+	}
+	await waitPromise;
+}
+//#endregion
+//#region src/cli/analyze/output.ts
+/** CLI 单次分析期间保留 JSON 专用写入入口，配置、插件和清理日志走 stderr。 */
+async function withAnalyzeOutput(json, run) {
+	const stdoutWrite = process.stdout.write;
+	const writeJson = (value) => stdoutWrite.call(process.stdout, `${JSON.stringify(value, null, 2)}\n`);
+	if (json) process.stdout.write = process.stderr.write.bind(process.stderr);
+	try {
+		await run(writeJson);
 	} finally {
-		await Promise.allSettled(openedCandidates.map((candidate) => candidate.handle.close()));
+		process.stdout.write = stdoutWrite;
 	}
 }
-function createDashboardFileReader(roots, result, artifacts) {
-	let allowlist = createDashboardContentAllowlist(result);
-	let currentArtifacts = artifacts;
-	let disposed = false;
-	return {
-		read: async (input) => {
-			if (disposed) throw new Error("Dashboard 文件读取会话已关闭。");
-			return await readAllowedDashboardFile(input, roots, allowlist, currentArtifacts);
-		},
-		update(nextResult, nextArtifacts) {
-			allowlist = createDashboardContentAllowlist(nextResult);
-			currentArtifacts = nextArtifacts;
-		},
-		dispose() {
-			disposed = true;
-			currentArtifacts = /* @__PURE__ */ new Map();
-			allowlist.artifactPaths.clear();
-			allowlist.sourcePaths.clear();
-		}
-	};
-}
-//#endregion
-//#region src/cli/analyze/dashboardDevframe/index.ts
-const DEVFRAME_ID = "weapp-vite";
-const MAX_DASHBOARD_ANALYZE_PAGE_CHARACTERS = 65536;
-const STALE_DASHBOARD_ANALYZE_REVISION_MESSAGE = "Analyze revision 已变化，请重新获取 Dashboard 状态。";
-const rejectDashboardSharedStateSet = defineRpcFunction({
-	name: "devframe:rpc:server-state:set",
-	type: "action",
-	handler: () => {
-		throw new Error("Dashboard Devframe shared state 只允许服务端修改。");
-	}
-});
-const rejectDashboardSharedStatePatch = defineRpcFunction({
-	name: "devframe:rpc:server-state:patch",
-	type: "action",
-	handler: () => {
-		throw new Error("Dashboard Devframe shared state 只允许服务端修改。");
-	}
-});
-function serializeDashboardAnalyzePayload(result) {
-	const value = JSON.stringify(result);
-	return {
-		descriptor: {
-			characters: value.length,
-			hash: createHash("sha256").update(value).digest("hex"),
-			pages: Math.max(1, Math.ceil(value.length / MAX_DASHBOARD_ANALYZE_PAGE_CHARACTERS))
-		},
-		source: result,
-		value
-	};
-}
-function serializeDashboardAnalyzeSnapshot(snapshot, cached) {
-	const previous = snapshot.previous ? cached?.current.source === snapshot.previous ? cached.current : cached?.previous?.source === snapshot.previous ? cached.previous : serializeDashboardAnalyzePayload(snapshot.previous) : null;
-	return {
-		current: cached?.current.source === snapshot.current ? cached.current : serializeDashboardAnalyzePayload(snapshot.current),
-		previous
-	};
-}
-function createDashboardState(revision, snapshot, runtimeEvents) {
-	return {
-		analyze: {
-			current: snapshot.current.descriptor,
-			previous: snapshot.previous?.descriptor ?? null
-		},
-		revision,
-		runtimeEvents: [...runtimeEvents]
-	};
-}
-function normalizeAnalyzePageRequest(input) {
-	if (!input || typeof input !== "object") throw new Error("必须传入合法的 Analyze 分页请求。");
-	if (!("revision" in input) || !("target" in input) || !("index" in input)) throw new Error("必须传入合法的 Analyze 分页请求。");
-	const revision = input.revision;
-	const target = input.target;
-	const index = input.index;
-	if (typeof revision !== "number" || !Number.isSafeInteger(revision) || revision < 0 || target !== "current" && target !== "previous" || typeof index !== "number" || !Number.isSafeInteger(index) || index < 0) throw new Error("必须传入合法的 Analyze 分页请求。");
-	return {
-		revision,
-		target,
-		index
-	};
-}
-function readDashboardAnalyzePage(input, revision, snapshot) {
-	const request = normalizeAnalyzePageRequest(input);
-	if (request.revision !== revision) throw new Error(STALE_DASHBOARD_ANALYZE_REVISION_MESSAGE);
-	const payload = request.target === "current" ? snapshot.current : snapshot.previous;
-	if (!payload || request.index >= payload.descriptor.pages) throw new Error("Analyze 分页不存在。");
-	const start = request.index * MAX_DASHBOARD_ANALYZE_PAGE_CHARACTERS;
-	return {
-		content: payload.value.slice(start, start + MAX_DASHBOARD_ANALYZE_PAGE_CHARACTERS),
-		descriptor: payload.descriptor,
-		index: request.index,
-		revision,
-		target: request.target
-	};
-}
-function createAnalyzeDashboardDevframe(options) {
-	let revision = 0;
-	let disposed = false;
-	let serializedSnapshot = serializeDashboardAnalyzeSnapshot(options.getAnalyzeSnapshot());
-	let broadcastDashboardState;
-	const initialSnapshot = options.getAnalyzeSnapshot();
-	const fileReader = createDashboardFileReader(options.roots, initialSnapshot.current, initialSnapshot.artifacts);
-	const getDashboardState = defineRpcFunction({
-		name: "get-dashboard-state",
-		type: "query",
-		jsonSerializable: true,
-		handler: () => createDashboardState(revision, serializedSnapshot, options.getRuntimeEvents())
-	});
-	const getAnalyzePage = defineRpcFunction({
-		name: "get-analyze-page",
-		type: "query",
-		jsonSerializable: true,
-		handler: (input) => readDashboardAnalyzePage(input, revision, serializedSnapshot)
-	});
-	const readDashboardFile = defineRpcFunction({
-		name: "read-dashboard-file",
-		type: "query",
-		jsonSerializable: true,
-		handler: async (input) => {
-			if (!input || typeof input !== "object" || !("revision" in input) || typeof input.revision !== "number" || !Number.isSafeInteger(input.revision) || input.revision < 0) throw new Error("必须传入合法的文件读取 revision。");
-			const requestedRevision = input.revision;
-			if (disposed || requestedRevision !== revision) throw new Error(STALE_DASHBOARD_ANALYZE_REVISION_MESSAGE);
-			const content = await fileReader.read(input);
-			if (disposed || requestedRevision !== revision) throw new Error(STALE_DASHBOARD_ANALYZE_REVISION_MESSAGE);
-			return content;
-		}
-	});
-	return {
-		definition: defineDevframe({
-			id: DEVFRAME_ID,
-			name: "weapp-vite",
-			version: VERSION,
-			packageName: "weapp-vite",
-			importMetaUrl: import.meta.url,
-			homepage: "https://vite.weapp.dev/",
-			description: "weapp-vite 构建分析与小程序开发工具。",
-			icon: "ph:rocket-launch-duotone",
-			async setup(ctx) {
-				ctx.rpc.register(rejectDashboardSharedStateSet, true);
-				ctx.rpc.register(rejectDashboardSharedStatePatch, true);
-				const dashboard = ctx.scope(DEVFRAME_ID);
-				dashboard.rpc.register(getDashboardState);
-				dashboard.rpc.register(getAnalyzePage);
-				dashboard.rpc.register(readDashboardFile);
-				broadcastDashboardState = async () => {
-					await dashboard.rpc.broadcast({
-						method: "dashboard-state-updated",
-						args: [createDashboardState(revision, serializedSnapshot, options.getRuntimeEvents())],
-						event: true
-					});
-				};
-			}
-		}),
-		notifyAnalyzeUpdate() {
-			if (disposed) return;
-			revision += 1;
-			const snapshot = options.getAnalyzeSnapshot();
-			serializedSnapshot = serializeDashboardAnalyzeSnapshot(snapshot, serializedSnapshot);
-			fileReader.update(snapshot.current, snapshot.artifacts);
-			broadcastDashboardState?.();
-		},
-		syncRuntimeEvents() {
-			broadcastDashboardState?.();
-		},
-		dispose() {
-			disposed = true;
-			fileReader.dispose();
-			broadcastDashboardState = void 0;
-		}
-	};
-}
-//#endregion
-//#region src/cli/analyze/dashboardViteBridge.ts
-const ANALYZE_DASHBOARD_DEVFRAME_BASE = "/__weapp-vite/";
-function createAnalyzeDashboardViteBridge(definition) {
-	let instance;
-	let closing;
-	const closeInstance = async () => {
-		if (closing) return await closing;
-		const current = instance;
-		instance = void 0;
-		if (!current) return;
-		closing = current.close().finally(() => {
-			closing = void 0;
-		});
-		await closing;
-	};
-	return {
-		name: "weapp-vite:dashboard-devframe",
-		apply: "serve",
-		async configureServer(server) {
-			await closeInstance();
-			const httpServer = server.httpServer instanceof Server ? server.httpServer : void 0;
-			const created = initDevframe(definition, {
-				base: ANALYZE_DASHBOARD_DEVFRAME_BASE,
-				distDir: false,
-				...httpServer ? { server: httpServer } : {
-					host: "127.0.0.1",
-					ws: { sidecar: true }
-				},
-				allowedOrigins: [],
-				auth: true,
-				mcp: false
-			});
-			server.middlewares.use(created.nodeMiddleware);
-			try {
-				await created.ready;
-				instance = created;
-			} catch (error) {
-				await created.close();
-				throw error;
-			}
-			server.httpServer?.once("close", () => {
-				closeInstance();
-			});
-		},
-		async closeBundle() {
-			await closeInstance();
-		}
-	};
-}
-//#endregion
-//#region src/cli/analyze/dashboard.ts
-const ANALYZE_DASHBOARD_PACKAGE_NAME = "@weapp-vite/dashboard";
-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,
-		profile: input.profile
-	};
-}
-function readDashboardManifest(packageJsonPath) {
-	try {
-		return parseCommentJson(fs.readFileSync(packageJsonPath, "utf8"));
-	} catch {
-		return;
-	}
-}
-function resolveDashboardDistRoot(packageRoot, manifest) {
-	const distDir = manifest?.weappViteDashboard?.distDir ?? "dist";
-	const distRoot = path.resolve(packageRoot, distDir);
-	if (!fs.existsSync(distRoot)) return;
-	return { root: distRoot };
-}
-function resolveDashboardDevRoot(packageRoot, manifest) {
-	const devRoot = manifest?.weappViteDashboard?.devRoot;
-	const devConfigFile = manifest?.weappViteDashboard?.devConfigFile;
-	if (!devRoot || !devConfigFile) return;
-	const root = path.resolve(packageRoot, devRoot);
-	const configFile = path.resolve(root, devConfigFile);
-	if (!fs.existsSync(root) || !fs.existsSync(configFile)) return;
-	return {
-		root,
-		configFile
-	};
-}
-function resolveDashboardRoot(options) {
-	const resolvePaths = options?.cwd && options.cwd !== process.cwd() ? [options.cwd, process.cwd()] : options?.cwd ? [options.cwd] : void 0;
-	let dashboardPackageRoot;
-	let dashboardManifest;
-	try {
-		const dashboardPackageJsonPath = require.resolve(`${ANALYZE_DASHBOARD_PACKAGE_NAME}/package.json`, { paths: resolvePaths });
-		dashboardPackageRoot = path.dirname(dashboardPackageJsonPath);
-		dashboardManifest = readDashboardManifest(dashboardPackageJsonPath);
-	} catch {
-		dashboardPackageRoot = void 0;
-		dashboardManifest = void 0;
-	}
-	if (dashboardPackageRoot) {
-		const devResolved = resolveDashboardDevRoot(dashboardPackageRoot, dashboardManifest);
-		const distResolved = resolveDashboardDistRoot(dashboardPackageRoot, dashboardManifest);
-		const resolved = options?.watch ? devResolved ?? distResolved : distResolved ?? devResolved;
-		if (resolved) return resolved;
-	}
-	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)))}`);
-}
-async function waitForServerExit(server) {
-	let resolved = false;
-	const cleanup = async () => {
-		if (resolved) return;
-		resolved = true;
-		try {
-			await server.close();
-		} catch (error) {
-			logger_default.error(error);
-		}
-	};
-	const signals = ["SIGINT", "SIGTERM"];
-	await new Promise((resolvePromise) => {
-		const resolveOnce = async () => {
-			await cleanup();
-			signals.forEach((signal) => {
-				process.removeListener(signal, resolveOnce);
-			});
-			resolvePromise();
-		};
-		signals.forEach((signal) => {
-			process.once(signal, resolveOnce);
-		});
-		server.httpServer?.once("close", resolveOnce);
-	});
-}
-async function startAnalyzeDashboard(result, options) {
-	const resolved = resolveDashboardRoot(options);
-	if (!resolved) return;
-	const { root, configFile } = resolved;
-	const state = {
-		current: result,
-		previous: options.previousResult ?? null,
-		artifacts: options.artifacts
-	};
-	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"]
-	}), ...(options?.initialEvents ?? []).map((event) => createDashboardRuntimeEvent(event))] };
-	const devframe = createAnalyzeDashboardDevframe({
-		getAnalyzeSnapshot: () => state,
-		getRuntimeEvents: () => runtimeEvents.current,
-		roots: {
-			pluginRoot: options?.pluginRoot,
-			projectRoot: options?.cwd,
-			srcRoot: options?.srcRoot ?? (options?.cwd ? path.resolve(options.cwd, "src") : void 0)
-		}
-	});
-	const plugins = [createAnalyzeDashboardViteBridge(devframe.definition)];
-	const serverOptions = {
-		root,
-		configFile: configFile ?? false,
-		clearScreen: false,
-		appType: "spa",
-		publicDir: false,
-		plugins,
-		server: {
-			host: "127.0.0.1",
-			port: 0,
-			watch: { ignored: ["**/*"] }
-		},
-		logLevel: "error"
-	};
-	const server = await createServer(serverOptions);
-	const requestedPort = typeof serverOptions.server?.port === "number" ? serverOptions.server.port : void 0;
-	await server.listen(requestedPort);
-	const urls = (() => {
-		const resolved = server.resolvedUrls;
-		if (!resolved) return [];
-		return [...resolved.local ?? [], ...resolved.network ?? []];
-	})();
-	const authCode = refreshTempAuthCode();
-	const authenticatedUrls = urls.map((url) => buildOtpAuthUrl(url, authCode));
-	let closed = false;
-	const waitPromise = waitForServerExit(server).then(() => {
-		closed = true;
-		state.artifacts = /* @__PURE__ */ new Map();
-		devframe.dispose();
-	});
-	const emitRuntimeEvents = (events) => {
-		if (events.length === 0) return;
-		const nextEvents = events.map((event) => createDashboardRuntimeEvent(event));
-		runtimeEvents.current = [...nextEvents, ...runtimeEvents.current].slice(0, 24);
-		devframe.syncRuntimeEvents();
-	};
-	const handle = {
-		async update(nextResult, artifacts, previousResult) {
-			if (closed) return;
-			state.previous = previousResult ?? state.current;
-			state.current = nextResult;
-			state.artifacts = artifacts;
-			emitRuntimeEvents([{
-				kind: "build",
-				level: "info",
-				title: "analyze payload refreshed",
-				detail: `已推送新的 analyze 结果，当前包含 ${nextResult.packages.length} 个包与 ${nextResult.modules.length} 个模块。`,
-				tags: ["analyze", "refresh"]
-			}]);
-			devframe.notifyAnalyzeUpdate();
-		},
-		emitRuntimeEvents,
-		waitForExit: () => waitPromise,
-		close: async () => {
-			closed = true;
-			await server.close();
-		},
-		urls: authenticatedUrls
-	};
-	if (options?.watch) {
-		if (!options.silentStartupLog) {
-			logger_default.info("weapp-vite UI 已启动（分析视图，实时模式），按 Ctrl+C 退出。");
-			for (const url of handle.urls) logger_default.info(`  ➜  ${colors.bold(colors.cyan(url))}`);
-		}
-		return handle;
-	}
-	if (!options?.silentStartupLog) {
-		logger_default.info("weapp-vite UI 已启动（分析视图，静态模式），按 Ctrl+C 退出。");
-		for (const url of handle.urls) logger_default.info(`  ➜  ${colors.bold(colors.cyan(url))}`);
-	}
-	await waitPromise;
-}
-//#endregion
-//#region src/cli/processCleanup.ts
-function isSassEmbeddedChild(handle) {
-	if (!handle || typeof handle !== "object") return false;
-	const child = handle;
-	const spawnfile = typeof child.spawnfile === "string" ? child.spawnfile : "";
-	const spawnargs = Array.isArray(child.spawnargs) ? child.spawnargs : [];
-	return Boolean("kill" in handle && "spawnfile" in handle && (spawnfile.includes("sass-embedded") || spawnfile.includes("dart-sass") && spawnargs.includes("--embedded")));
-}
-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 {}
-}
 //#endregion
 //#region src/cli/commands/analyze.ts
 function normalizeDisplayPath(value) {
@@ -3071,13 +2446,17 @@ function printAnalysisSummary(result) {
 	if (duplicates.length > limit) logger_default.info(`- …其余 ${duplicates.length - limit} 项请使用 ${colors.bold(colors.green("weapp-vite analyze --json"))} 查看`);
 }
 function printBudgetCheckSummary(result) {
-	const exceededItems = createAnalyzeBudgetCheck(result).filter((item) => item.status === "exceeded");
+	const exceededItems = createAnalyzeBudgetCheck(result).filter((item) => item.status === "exceeded" || item.status === "unknown");
 	if (exceededItems.length === 0) {
 		logger_default.success("包体预算检查通过");
 		return false;
 	}
 	logger_default.error(`包体预算检查失败：${exceededItems.length} 项超限`);
-	for (const item of exceededItems) logger_default.error(`- ${item.label}：${formatAnalyzeBytes(item.currentBytes)} / ${formatAnalyzeBytes(item.limitBytes)} (${(item.ratio * 100).toFixed(1)}%)`);
+	for (const item of exceededItems) {
+		logger_default.error(`- ${item.label}：${formatAnalyzeBytes(item.currentBytes)} / ${formatAnalyzeBytes(item.limitBytes)} (${(item.ratio * 100).toFixed(1)}%)`);
+		if (item.status === "unknown") logger_default.error("  产物字节或 runtime 归因不足，无法验收预算。");
+		logger_default.error(`  文件：${item.files.join(", ") || "未知"}`);
+	}
 	return true;
 }
 function printGlassEaselCheckSummary(result) {
@@ -3253,107 +2632,111 @@ function printHmrProfileAnalysisSummary(result, configService) {
 	}
 }
 function registerAnalyzeCommand(cli) {
-	cli.command("analyze [root]", "analyze 两端包体与源码映射").option("--hmr-profile [file]", `[string | boolean] 分析 HMR JSONL profile，省略值时优先读取配置，否则回退到默认路径`).option("--json", `[boolean] 输出 JSON 结果`).option("--markdown", `[boolean] 输出 Markdown 报告`).option("--report <type>", `[string] 输出指定报告类型（pr）`).option("--budget-check", `[boolean] 检查 analyze 预算，超过预算时返回非 0 退出码`).option("--glass-easel-check", `[boolean] 检查 glass-easel 配置、模板和 SelectorQuery 迁移兼容性`).option("--preload", `[boolean] 分析静态页面跳转、实际分包体积和 preloadRule 额度`).option("--output <file>", `[string] 将分析结果写入指定文件（JSON 或 Markdown）`).option("-p, --platform <platform>", `[string] target platform (weapp | web)`).option("--project-config <path>", `[string] project config path (miniprogram only)`).action(async (root, options) => {
+	cli.command("analyze [root]", "analyze 两端包体与源码映射").option("--ui-host <host>", `[string] 启动调试 UI 并选择宿主（standalone | hub）`).option("--hmr-profile [file]", `[string | boolean] 分析 HMR JSONL profile，省略值时优先读取配置，否则回退到默认路径`).option("--json", `[boolean] 输出 JSON 结果`).option("--markdown", `[boolean] 输出 Markdown 报告`).option("--report <type>", `[string] 输出指定报告类型（pr）`).option("--budget-check", `[boolean] 检查 analyze 预算，超过预算时返回非 0 退出码`).option("--glass-easel-check", `[boolean] 检查 glass-easel 配置、模板和 SelectorQuery 迁移兼容性`).option("--preload", `[boolean] 分析静态页面跳转、实际分包体积和 preloadRule 额度`).option("--output <file>", `[string] 将分析结果写入指定文件（JSON 或 Markdown）`).option("-p, --platform <platform>", `[string] target platform (weapp | web)`).option("--project-config <path>", `[string] project config path (miniprogram only)`).action(async (root, options) => {
 		filterDuplicateOptions(options);
+		options.uiHost = parseDashboardUiHost(options.uiHost);
 		const configFile = resolveConfigFile(options);
 		const outputJson = coerceBooleanOption(options.json);
-		const outputMarkdown = coerceBooleanOption(options.markdown);
-		const reportType = typeof options.report === "string" ? options.report.trim() : "";
-		const outputPrReport = reportType === "pr";
-		if (reportType && !outputPrReport) throw new Error(`不支持的 analyze report 类型：${reportType}`);
-		const budgetCheck = coerceBooleanOption(options.budgetCheck);
-		const glassEaselCheck = coerceBooleanOption(options.glassEaselCheck);
-		const launchDashboard = !outputJson && !outputMarkdown && !outputPrReport && !budgetCheck && !glassEaselCheck;
-		const targets = resolveRuntimeTargets(options);
-		const inlineConfig = createInlineConfig(targets);
-		let ctx;
-		try {
-			ctx = await createCompilerContext({
-				cwd: root,
-				mode: options.mode ?? "production",
-				configFile,
-				inlineConfig,
-				cliPlatform: targets.rawPlatform,
-				projectConfigPath: options.projectConfig
-			});
-			logRuntimeTarget(targets, {
-				silent: outputJson || outputMarkdown,
-				resolvedConfigPlatform: ctx.configService.platform
-			});
-			const outputOption = typeof options.output === "string" ? options.output.trim() : "";
-			if (options.hmrProfile !== void 0 && options.hmrProfile !== false) {
-				const profileOption = typeof options.hmrProfile === "string" && options.hmrProfile.trim() ? options.hmrProfile.trim() : ctx.configService.weappViteConfig.hmr?.profileJson;
-				const profilePath = resolveHmrProfileJsonPath({
-					cwd: ctx.configService.cwd,
-					option: profileOption,
-					fallbackToDefault: true
+		return withAnalyzeOutput(Boolean(outputJson), async (writeJson) => {
+			const outputMarkdown = coerceBooleanOption(options.markdown);
+			const reportType = typeof options.report === "string" ? options.report.trim() : "";
+			const outputPrReport = reportType === "pr";
+			if (reportType && !outputPrReport) throw new Error(`不支持的 analyze report 类型：${reportType}`);
+			const budgetCheck = coerceBooleanOption(options.budgetCheck);
+			const glassEaselCheck = coerceBooleanOption(options.glassEaselCheck);
+			const launchDashboard = !outputJson && !outputMarkdown && !outputPrReport && !budgetCheck && !glassEaselCheck;
+			const targets = resolveRuntimeTargets(options);
+			const inlineConfig = createInlineConfig(targets);
+			let ctx;
+			try {
+				ctx = await createCompilerContext({
+					cwd: root,
+					mode: options.mode ?? "production",
+					configFile,
+					inlineConfig,
+					cliPlatform: targets.rawPlatform,
+					projectConfigPath: options.projectConfig
 				});
-				if (!profilePath) throw new Error("未找到可用的 HMR profile 文件路径");
-				const hmrProfileResult = await analyzeHmrProfile({ profilePath });
-				const writtenPath = await writeAnalyzeResult(hmrProfileResult, outputOption, ctx.configService);
-				if (outputJson) {
-					if (!writtenPath) process.stdout.write(`${JSON.stringify(hmrProfileResult, null, 2)}\n`);
-				} else printHmrProfileAnalysisSummary(hmrProfileResult, ctx.configService);
-				return;
-			}
-			if (coerceBooleanOption(options.preload)) {
-				if (targets.kind !== "miniprogram" || ctx.configService.platform !== "weapp") throw new Error("preloadRule 分析目前仅支持微信小程序平台。");
-				const packageAnalysis = await analyzeSubpackages(ctx);
-				const preloadResult = await analyzePreloadRules(ctx, { packageAnalysis });
-				const writtenPath = await writeAnalyzeResult(preloadResult, outputOption, ctx.configService);
-				if (outputJson && !writtenPath) process.stdout.write(`${JSON.stringify(preloadResult, null, 2)}\n`);
-				if (!outputJson && !writtenPath) printPreloadAnalysisSummary(preloadResult);
-				return;
-			}
-			if (getBackendForCapability(targets, "web", "analyze")) {
-				const webResult = createWebAnalyzeResult(ctx.configService, { platform: "web" });
-				const writtenPath = await writeAnalyzeResult(webResult, outputOption, ctx.configService);
-				if (outputJson) {
-					if (!writtenPath) process.stdout.write(`${JSON.stringify(webResult, null, 2)}\n`);
-				} else printWebAnalysisSummary(webResult);
-				return;
-			}
-			if (!getBackendForCapability(targets, "miniprogram", "analyze")) {
-				logger_default.warn("当前命令不支持该平台，请通过 --platform weapp 或 --platform web 指定目标。");
-				return;
-			}
-			const previousResult = await readLatestAnalyzeHistorySnapshot(ctx.configService);
-			ctx.runtimeState.glassEasel.silent = Boolean(outputJson || outputMarkdown || outputPrReport || glassEaselCheck);
-			const artifactSnapshot = launchDashboard ? createDashboardArtifactSnapshot() : void 0;
-			const result = artifactSnapshot ? await analyzeSubpackages(ctx, { onArtifact: artifactSnapshot.capture }) : await analyzeSubpackages(ctx);
-			await writeAnalyzeHistorySnapshot(result, ctx.configService);
-			const writtenPath = await writeAnalyzeResult(result, outputOption, ctx.configService, outputPrReport ? "pr" : outputMarkdown ? "markdown" : "json", previousResult);
-			if (outputPrReport) {
-				if (!writtenPath) process.stdout.write(`${createAnalyzePrMarkdownReport(result, previousResult)}\n`);
-			} else if (outputMarkdown) {
-				if (!writtenPath) process.stdout.write(`${createAnalyzeMarkdownReport(result, previousResult)}\n`);
-			} else if (outputJson) {
-				if (!writtenPath) process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
-			}
-			const budgetFailed = budgetCheck ? printBudgetCheckSummary(result) : false;
-			const glassEaselFailed = glassEaselCheck && !outputJson ? printGlassEaselCheckSummary(result) : glassEaselCheck && result.glassEasel.summary.errors > 0;
-			if (budgetFailed || glassEaselFailed) process.exitCode = 1;
-			if (budgetCheck || glassEaselCheck) return;
-			if (artifactSnapshot) {
-				printAnalysisSummary(result);
-				await startAnalyzeDashboard(result, {
-					artifacts: artifactSnapshot.files,
-					cwd: ctx.configService.cwd,
-					packageManagerAgent: ctx.configService.packageManager.agent,
-					pluginRoot: ctx.configService.absolutePluginRoot,
-					srcRoot: ctx.configService.absoluteSrcRoot,
-					previousResult
+				logRuntimeTarget(targets, {
+					silent: outputJson || outputMarkdown,
+					resolvedConfigPlatform: ctx.configService.platform
 				});
+				const outputOption = typeof options.output === "string" ? options.output.trim() : "";
+				if (options.hmrProfile !== void 0 && options.hmrProfile !== false) {
+					const profileOption = typeof options.hmrProfile === "string" && options.hmrProfile.trim() ? options.hmrProfile.trim() : ctx.configService.weappViteConfig.hmr?.profileJson;
+					const profilePath = resolveHmrProfileJsonPath({
+						cwd: ctx.configService.cwd,
+						option: profileOption,
+						fallbackToDefault: true
+					});
+					if (!profilePath) throw new Error("未找到可用的 HMR profile 文件路径");
+					const hmrProfileResult = await analyzeHmrProfile({ profilePath });
+					const writtenPath = await writeAnalyzeResult(hmrProfileResult, outputOption, ctx.configService);
+					if (outputJson) {
+						if (!writtenPath) writeJson(hmrProfileResult);
+					} else printHmrProfileAnalysisSummary(hmrProfileResult, ctx.configService);
+					return;
+				}
+				if (coerceBooleanOption(options.preload)) {
+					if (targets.kind !== "miniprogram" || ctx.configService.platform !== "weapp") throw new Error("preloadRule 分析目前仅支持微信小程序平台。");
+					const packageAnalysis = await analyzeSubpackages(ctx);
+					const preloadResult = await analyzePreloadRules(ctx, { packageAnalysis });
+					const writtenPath = await writeAnalyzeResult(preloadResult, outputOption, ctx.configService);
+					if (outputJson && !writtenPath) writeJson(preloadResult);
+					if (!outputJson && !writtenPath) printPreloadAnalysisSummary(preloadResult);
+					return;
+				}
+				if (getBackendForCapability(targets, "web", "analyze")) {
+					const webResult = createWebAnalyzeResult(ctx.configService, { platform: "web" });
+					const writtenPath = await writeAnalyzeResult(webResult, outputOption, ctx.configService);
+					if (outputJson) {
+						if (!writtenPath) writeJson(webResult);
+					} else printWebAnalysisSummary(webResult);
+					return;
+				}
+				if (!getBackendForCapability(targets, "miniprogram", "analyze")) {
+					logger_default.warn("当前命令不支持该平台，请通过 --platform weapp 或 --platform web 指定目标。");
+					return;
+				}
+				const previousResult = await readLatestAnalyzeHistorySnapshot(ctx.configService);
+				ctx.runtimeState.glassEasel.silent = Boolean(outputJson || outputMarkdown || outputPrReport || glassEaselCheck);
+				const artifactSnapshot = launchDashboard ? createDashboardArtifactSnapshot() : void 0;
+				const result = artifactSnapshot ? await analyzeSubpackages(ctx, { onArtifact: artifactSnapshot.capture }) : await analyzeSubpackages(ctx);
+				await writeAnalyzeHistorySnapshot(result, ctx.configService);
+				const writtenPath = await writeAnalyzeResult(result, outputOption, ctx.configService, outputPrReport ? "pr" : outputMarkdown ? "markdown" : "json", previousResult);
+				if (outputPrReport) {
+					if (!writtenPath) process.stdout.write(`${createAnalyzePrMarkdownReport(result, previousResult)}\n`);
+				} else if (outputMarkdown) {
+					if (!writtenPath) process.stdout.write(`${createAnalyzeMarkdownReport(result, previousResult)}\n`);
+				} else if (outputJson) {
+					if (!writtenPath) writeJson(result);
+				}
+				const budgetFailed = budgetCheck ? outputJson ? createAnalyzeBudgetCheck(result).some((item) => item.status === "exceeded" || item.status === "unknown") : printBudgetCheckSummary(result) : false;
+				const glassEaselFailed = glassEaselCheck && !outputJson ? printGlassEaselCheckSummary(result) : glassEaselCheck && result.glassEasel.summary.errors > 0;
+				if (budgetFailed || glassEaselFailed) process.exitCode = 1;
+				if (budgetCheck || glassEaselCheck) return;
+				if (artifactSnapshot) {
+					printAnalysisSummary(result);
+					await startAnalyzeDashboard(result, {
+						uiHost: options.uiHost,
+						artifacts: artifactSnapshot.files,
+						cwd: ctx.configService.cwd,
+						packageManagerAgent: ctx.configService.packageManager.agent,
+						pluginRoot: ctx.configService.absolutePluginRoot,
+						srcRoot: ctx.configService.absoluteSrcRoot,
+						previousResult
+					});
+				}
+			} catch (error) {
+				logger_default.error(error);
+				process.exitCode = 1;
+			} finally {
+				if (ctx) {
+					for (const backend of [...targets.entries].reverse()) if (backend.descriptor.capabilities.analyze) await backend.driver?.close?.(ctx);
+				}
+				terminateStaleSassEmbeddedProcess();
 			}
-		} catch (error) {
-			logger_default.error(error);
-			process.exitCode = 1;
-		} finally {
-			if (ctx) {
-				for (const backend of [...targets.entries].reverse()) if (backend.descriptor.capabilities.analyze) await backend.driver?.close?.(ctx);
-			}
-			terminateStaleSassEmbeddedProcess();
-		}
+		});
 	});
 }
 //#endregion
@@ -3453,6 +2836,631 @@ function setCommandNodeEnv(nodeEnv) {
 	process.env.NODE_ENV = nodeEnv;
 }
 //#endregion
+//#region src/cli/upload/autoMetadata.ts
+/** 只读取命令根目录的清单，不向父目录查找或修改文件。 */
+async function readPackageVersion(packagePath) {
+	let manifest;
+	try {
+		manifest = JSON.parse(await readFile(packagePath, "utf8"));
+	} catch (cause) {
+		throw new Error("--bump 无法读取命令根目录的 package.json。", { cause });
+	}
+	if (manifest === null || typeof manifest !== "object" || !("version" in manifest) || typeof manifest.version !== "string") throw new Error("--bump 要求命令根目录 package.json 的 version 为有效的 SemVer 字符串。");
+	return manifest.version;
+}
+/** 在首次编译配置求值前准备一次元数据；预演不写文件，实际版本由 npm 同步。 */
+function validateAutoUploadMetadata(options, action) {
+	const { bump, gitDesc } = options;
+	if (action === "preview" && (bump !== void 0 || gitDesc !== void 0)) throw new Error("--bump 和 --git-desc 仅支持 upload 或 build --upload，不支持 preview。");
+	if (bump !== void 0 && options.uv !== void 0) throw new Error("--bump 不能与 --uv 同时使用。");
+	if (gitDesc && options.desc !== void 0) throw new Error("--git-desc 不能与 --desc 同时使用。");
+	if (bump !== void 0 && ![
+		"patch",
+		"minor",
+		"major"
+	].includes(bump)) throw new Error("--bump 仅支持 patch、minor 或 major。");
+}
+async function captureMetadataSnapshot(root) {
+	const snapshots = [];
+	for (const name of [
+		"package.json",
+		"package-lock.json",
+		"npm-shrinkwrap.json"
+	]) {
+		const filePath = path$1.join(root, name);
+		try {
+			snapshots.push({
+				path: filePath,
+				content: await readFile(filePath, "utf8")
+			});
+		} catch (error) {
+			if (error.code !== "ENOENT") throw error;
+			snapshots.push({ path: filePath });
+		}
+	}
+	return snapshots;
+}
+async function restoreMetadataSnapshot(snapshots) {
+	for (const snapshot of snapshots) if (snapshot.content === void 0) await rm(snapshot.path, { force: true });
+	else await writeFile(snapshot.path, snapshot.content);
+}
+async function prepareAutoUploadMetadata(cwd, options, action) {
+	validateAutoUploadMetadata(options, action);
+	const { bump, gitDesc } = options;
+	if (bump === void 0 && !gitDesc) return options;
+	if (bump !== void 0 && options.uv !== void 0) throw new Error("--bump 不能与 --uv 同时使用。");
+	if (gitDesc && options.desc !== void 0) throw new Error("--git-desc 不能与 --desc 同时使用。");
+	if (bump !== void 0 && bump !== "patch" && bump !== "minor" && bump !== "major") throw new Error("--bump 仅支持 patch、minor 或 major。");
+	const root = path$1.resolve(cwd);
+	const packagePath = path$1.join(root, "package.json");
+	let currentVersion;
+	let nextVersion;
+	if (bump !== void 0) {
+		currentVersion = await readPackageVersion(packagePath);
+		nextVersion = semverInc(currentVersion, bump) ?? void 0;
+		if (!nextVersion) throw new Error("--bump 要求命令根目录 package.json 的 version 为有效的 SemVer 字符串。");
+	}
+	let desc;
+	if (gitDesc) {
+		try {
+			desc = (await x("git", [
+				"log",
+				"-1",
+				"--format=%s"
+			], {
+				nodePath: false,
+				throwOnError: true,
+				nodeOptions: { cwd: root }
+			})).stdout.trim();
+		} catch (cause) {
+			throw new Error("--git-desc 无法读取最新 Git 提交主题，请确认 Git 可用且仓库已有提交。", { cause });
+		}
+		if (!desc) throw new Error("--git-desc 要求最新 Git 提交主题非空。");
+	}
+	if (nextVersion) {
+		if (options.dryRun) logger_default.info(`[upload] dry-run：计划版本 ${currentVersion} → ${nextVersion}，未修改 package.json 或锁文件。`);
+		else {
+			try {
+				await x("npm", [
+					"version",
+					nextVersion,
+					"--no-git-tag-version",
+					"--ignore-scripts",
+					"--workspaces=false",
+					"--prefix",
+					root
+				], {
+					nodePath: false,
+					throwOnError: true,
+					nodeOptions: { cwd: root }
+				});
+			} catch (cause) {
+				throw new Error("--bump 执行 npm version 失败，请检查本地版本与锁文件后重试。", { cause });
+			}
+			if (await readPackageVersion(packagePath) !== nextVersion) throw new Error("--bump 执行 npm version 后，命令根目录的 package.json 版本未按预期更新。");
+			logger_default.info(`[upload] 版本已更新：${currentVersion} → ${nextVersion}。后续构建或上传失败不会回退；重试同一版本时请移除 --bump。`);
+		}
+	}
+	if (gitDesc) logger_default.info("[upload] 使用最新 Git 提交主题作为上传说明。");
+	const metadata = { ...options };
+	if (nextVersion !== void 0) metadata.uv = nextVersion;
+	if (desc !== void 0) metadata.desc = desc;
+	return metadata;
+}
+/** 配置尚未确认可上传时，保留 npm version 所有可能修改文件的回滚点。 */
+async function prepareAutoUploadMetadataWithRollback(cwd, options, action) {
+	validateAutoUploadMetadata(options, action);
+	const snapshots = options.bump !== void 0 && !options.dryRun ? await captureMetadataSnapshot(path$1.resolve(cwd)) : [];
+	return {
+		options: await prepareAutoUploadMetadata(cwd, options, action),
+		rollback: () => restoreMetadataSnapshot(snapshots)
+	};
+}
+//#endregion
+//#region src/cli/upload/env.ts
+/** 凭据不经过 Vite 的 env 调试日志；文件优先级和进程环境覆盖规则保持一致。 */
+async function loadUploadEnv(cwd, mode, root, envDir) {
+	if (envDir === false) return { ...process.env };
+	if (mode === "local") throw new Error("local 不能作为 mode，因为它与 .env.local 文件后缀冲突。");
+	const directory = path$1.resolve(cwd, root ?? ".", envDir ?? ".");
+	const parsed = {};
+	for (const file of [
+		".env",
+		".env.local",
+		`.env.${mode}`,
+		`.env.${mode}.local`
+	]) {
+		const content = await readFile(path$1.join(directory, file), "utf8").catch((error) => {
+			if (error.code === "ENOENT") return "";
+			throw error;
+		});
+		for (const [key, value] of Object.entries(parse$2(content))) {
+			delete parsed[key];
+			parsed[key] = value;
+		}
+	}
+	const processEnv = { ...parsed };
+	for (const [key, value] of Object.entries(process.env)) if (value !== void 0) {
+		processEnv[key] = value;
+		delete parsed[key];
+	}
+	expand({
+		parsed,
+		processEnv
+	});
+	return {
+		...parsed,
+		...process.env
+	};
+}
+//#endregion
+//#region src/cli/upload/executionError.ts
+/** 仅描述本地执行结果，不代表远端上传已取消。 */
+var UploadExecutionError = class extends Error {
+	/** timeout 为本地超时，interrupted 为本地中断，failed 为工具或传输失败。 */
+	reason;
+	/** not-started 表示尚未允许 SDK 执行；unknown 表示远端结果需要人工核实。 */
+	remoteOutcome;
+	constructor(message, reason, remoteOutcome) {
+		super(message);
+		this.name = "UploadExecutionError";
+		this.reason = reason;
+		this.remoteOutcome = remoteOutcome;
+	}
+};
+//#endregion
+//#region src/cli/upload/result.ts
+/** 只接受可展示的预览结果，文件必须由本次任务生成，不能沿用旧二维码。 */
+async function validatePreviewResult(value, context) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error("预览工具未返回二维码或预览链接。");
+	const input = value;
+	const result = {};
+	for (const key of ["qrCodeUrl", "previewUrl"]) {
+		if (input[key] === void 0) continue;
+		if (typeof input[key] !== "string" || !input[key].trim()) throw new Error("预览工具返回了无效链接。");
+		let url;
+		try {
+			url = new URL(input[key]);
+		} catch {
+			throw new Error("预览工具返回了无效链接。");
+		}
+		if (url.username || url.password || key === "qrCodeUrl" && url.protocol !== "http:" && url.protocol !== "https:" || [
+			"javascript:",
+			"data:",
+			"file:"
+		].includes(url.protocol)) throw new Error("预览工具返回了不支持的链接类型。");
+		result[key] = input[key];
+	}
+	if (input.qrCodeFile !== void 0) {
+		if (typeof input.qrCodeFile !== "string" || !context.qrCodePath || path$1.resolve(input.qrCodeFile) !== path$1.resolve(context.qrCodePath)) throw new Error("预览工具返回的二维码文件不是本次任务的输出路径。");
+		const file = await stat(input.qrCodeFile);
+		if (!file.isFile() || file.size === 0) throw new Error("预览二维码文件不存在或为空。");
+		result.qrCodeFile = input.qrCodeFile;
+	}
+	if (!result.qrCodeUrl && !result.previewUrl && !result.qrCodeFile) throw new Error("预览工具未返回二维码或预览链接。");
+	return result;
+}
+//#endregion
+//#region src/cli/upload/process.ts
+function readProgress(value, secrets) {
+	if (!value || typeof value !== "object" || !("type" in value) || ![
+		"progress",
+		"log",
+		"task-created",
+		"version-created"
+	].includes(String(value.type))) return;
+	const event = { type: value.type };
+	if ("message" in value && typeof value.message === "string") event.message = redactUploadSecrets(value.message, secrets);
+	if ("percent" in value && typeof value.percent === "number" && Number.isFinite(value.percent) && value.percent >= 0 && value.percent <= 100) event.percent = value.percent;
+	return event;
+}
+/** 强制终止可能截断日志尾部；同时隐藏已知凭据的不完整前缀，保留普通诊断。 */
+function redactDiagnostic(message, secrets) {
+	const output = message.trimEnd();
+	let end = output.length;
+	for (const value of secrets) {
+		const secret = value.trimEnd();
+		if (!secret) continue;
+		let start = output.indexOf(secret[0], Math.max(0, output.length - secret.length));
+		while (start !== -1) {
+			let offset = 0;
+			while (start + offset < output.length && output[start + offset] === secret[offset]) offset++;
+			if (start + offset === output.length) {
+				end = Math.min(end, start);
+				break;
+			}
+			start = output.indexOf(secret[0], start + 1);
+		}
+	}
+	return redactUploadSecrets(end < output.length ? `${output.slice(0, end)}[REDACTED]` : output, secrets);
+}
+/** 隔离官方 SDK；完成确认与正常退出必须同时成立，取消仅作用于本地进程。 */
+async function executeUpload(platform, context, secrets, action = "upload", options = {}) {
+	const label = `${platform} ${action === "preview" ? "预览" : "上传"}`;
+	if (options.signal?.aborted) throw new UploadExecutionError(`${label}已中断（SDK 尚未开始）。`, "interrupted", "not-started");
+	const { result, output } = await new Promise((resolve, reject) => {
+		const spawnedAt = Date.now();
+		let child;
+		try {
+			child = fork(fileURLToPath(new URL("./upload-worker.mjs", import.meta.url)), [], {
+				cwd: context.cwd,
+				env: context.env,
+				execArgv: [],
+				stdio: [
+					"pipe",
+					"pipe",
+					"pipe",
+					"ipc"
+				],
+				detached: process.platform !== "win32",
+				windowsHide: true
+			});
+		} catch (error) {
+			reject(new UploadExecutionError(redactUploadSecrets(`${label}无法启动：${String(error)}`, secrets), "failed", "not-started"));
+			return;
+		}
+		let completed = false;
+		let started = false;
+		let settled = false;
+		let result = {};
+		const captured = {
+			stdout: "",
+			stderr: ""
+		};
+		let capturedSize = 0;
+		let failure;
+		let timer;
+		let closeTimer;
+		const terminate = (descendants = true) => {
+			if (!child.pid) return;
+			const exited = child.exitCode !== null || child.signalCode !== null;
+			try {
+				if (descendants && !exited && process.platform !== "win32") terminateUploadDescendants(child.pid);
+			} catch (error) {
+				failure ??= {
+					reason: "failed",
+					detail: "无法清理本地子进程"
+				};
+				failure.detail += `；${String(error)}`;
+			}
+			try {
+				terminateUploadProcess(child.pid, {
+					processGroup: true,
+					exited,
+					lifetime: {
+						start: spawnedAt,
+						end: Date.now()
+					}
+				});
+			} catch (error) {
+				failure ??= {
+					reason: "failed",
+					detail: "无法终止本地 worker"
+				};
+				failure.detail += `；${String(error)}`;
+				if (!exited) child.kill("SIGKILL");
+			}
+		};
+		const stop = (reason, detail) => {
+			if (settled || failure) return;
+			failure = {
+				reason,
+				detail
+			};
+			clearTimeout(timer);
+			terminate();
+		};
+		const cancel = () => stop("interrupted", "本地执行已中断");
+		const onParentExit = () => terminate();
+		const collect = (stream, chunk) => {
+			if (failure) return;
+			const remaining = 4194304 - capturedSize;
+			if (chunk.length > remaining) {
+				captured.stdout = "";
+				captured.stderr = "";
+				stop("failed", "日志超限，已省略日志以保护凭据");
+				return;
+			}
+			captured[stream] += chunk;
+			capturedSize += chunk.length;
+		};
+		const onStdout = (chunk) => collect("stdout", chunk);
+		const onStderr = (chunk) => collect("stderr", chunk);
+		const onError = (error) => stop("failed", error.message);
+		const onDisconnect = () => {
+			if (!completed) stop("failed", "IPC 连接中断，未收到完成确认");
+		};
+		const onMessage = (message) => {
+			if (settled || failure || !message || typeof message !== "object" || !("action" in message) || message.action !== action || !("type" in message)) return;
+			if (message.type === "started" && !started) {
+				started = true;
+				child.send({
+					type: "run",
+					action
+				}, (error) => {
+					if (error) onError(error);
+				});
+			} else if (message.type === "progress" && "event" in message) {
+				const event = readProgress(message.event, secrets);
+				if (event) try {
+					options.onProgress?.(event);
+				} catch (error) {
+					stop("failed", `进度处理失败：${String(error)}`);
+				}
+			} else if (message.type === "completed" && started) {
+				completed = true;
+				result = "result" in message && message.result && typeof message.result === "object" ? message.result : {};
+			}
+		};
+		const onExit = () => {
+			clearTimeout(timer);
+			terminate(false);
+			closeTimer = setTimeout(() => {
+				failure ??= {
+					reason: "failed",
+					detail: "worker 已退出"
+				};
+				failure.detail += "；日志管道未关闭，本地子进程清理未确认";
+				captured.stdout = "";
+				captured.stderr = "";
+				child.stdin?.destroy();
+				child.stdout?.destroy();
+				child.stderr?.destroy();
+			}, 1e3);
+		};
+		const cleanup = () => {
+			clearTimeout(timer);
+			clearTimeout(closeTimer);
+			options.signal?.removeEventListener("abort", cancel);
+			process.off("SIGINT", cancel);
+			process.off("SIGTERM", cancel);
+			process.off("exit", onParentExit);
+			child.off("message", onMessage);
+			child.off("error", onError);
+			child.off("disconnect", onDisconnect);
+			child.off("exit", onExit);
+			child.stdout?.off("data", onStdout);
+			child.stderr?.off("data", onStderr);
+			child.stdin?.off("error", onError);
+		};
+		child.once("close", (code, signal) => {
+			settled = true;
+			cleanup();
+			const output = [redactDiagnostic(captured.stdout, secrets), redactDiagnostic(captured.stderr, secrets)].filter(Boolean).join("\n").trim();
+			if (failure || code !== 0 || !completed) {
+				const detail = failure?.detail ?? `${signal ?? code ?? "unknown"}，${completed ? "进程异常结束" : "未收到完成确认"}`;
+				reject(new UploadExecutionError(redactUploadSecrets(`${label}失败（${detail}）。${started ? "远端结果未知，请核实平台状态；未自动重试。" : "SDK 尚未开始。"}${output ? `\n${output}` : ""}`, secrets), failure?.reason ?? "failed", started ? "unknown" : "not-started"));
+				return;
+			}
+			resolve({
+				result,
+				output
+			});
+		});
+		child.on("error", onError);
+		child.on("disconnect", onDisconnect);
+		child.on("message", onMessage);
+		child.once("exit", onExit);
+		child.stdout?.setEncoding("utf8").on("data", onStdout);
+		child.stderr?.setEncoding("utf8").on("data", onStderr);
+		child.stdin?.on("error", onError);
+		process.once("exit", onParentExit);
+		if (options.signal) options.signal.addEventListener("abort", cancel, { once: true });
+		else {
+			process.once("SIGINT", cancel);
+			process.once("SIGTERM", cancel);
+		}
+		if (options.timeoutMs !== void 0) timer = setTimeout(stop, options.timeoutMs, "timeout", `本地执行超时（${options.timeoutMs}ms）`);
+		if (options.signal?.aborted) cancel();
+		else try {
+			child.stdin?.end(JSON.stringify({
+				platform,
+				context,
+				action
+			}));
+		} catch (error) {
+			stop("failed", String(error));
+		}
+	});
+	if (output) logger_default.info(output);
+	return action === "preview" ? validatePreviewResult(result, context) : result;
+}
+//#endregion
+//#region src/cli/upload/project.ts
+/** 确保官方工具读取的目录正是本次构建输出，拒绝误传旧目录或同名配置。 */
+async function validateUploadProject(options) {
+	const { projectConfigFileName } = getProjectPlatformOptions(options.platform);
+	if (options.sourceConfigPath && path$1.basename(options.sourceConfigPath) !== projectConfigFileName) throw new Error(`上传工具只读取 ${projectConfigFileName}，请使用此标准文件名，避免读取其他项目配置。`);
+	const configPath = path$1.join(options.projectPath, projectConfigFileName);
+	const config = JSON.parse(await readFile(configPath, "utf8"));
+	if (!config || typeof config !== "object" || Array.isArray(config)) throw new TypeError(`${projectConfigFileName} 必须是 JSON 对象。`);
+	const rootKey = options.platform === "swan" ? "smartProgramRoot" : "miniprogramRoot";
+	const root = config[rootKey];
+	if (typeof root !== "string" || !root.trim()) throw new Error(`${projectConfigFileName} 缺少代码目录 ${rootKey}。`);
+	const sdkRoot = path$1.resolve(options.projectPath, root);
+	const [actualRoot, outputRoot] = await Promise.all([realpath(sdkRoot), realpath(options.outDir)]);
+	if (actualRoot !== outputRoot) throw new Error(`${projectConfigFileName} 的代码目录与本次构建输出不一致，已阻止上传旧产物。请检查项目配置根目录与 build.outDir。`);
+	await access(path$1.join(outputRoot, "app.json"));
+}
+//#endregion
+//#region src/cli/upload/report.ts
+var UploadCommandError = class extends Error {
+	report;
+	constructor(report) {
+		super(report.error);
+		this.report = report;
+		this.name = "UploadCommandError";
+	}
+};
+function createFailedUploadReport(error) {
+	return {
+		schemaVersion: 1,
+		action: "upload",
+		status: "failed",
+		results: [],
+		error: error instanceof Error ? error.message : String(error)
+	};
+}
+function printUploadProgress(platform, event) {
+	const percent = event.percent === void 0 ? "" : ` ${event.percent}%`;
+	process.stderr.write(`[upload:${platform}] ${event.type}${percent}${event.message ? ` ${event.message}` : ""}\n`);
+}
+function printUploadSummary(report) {
+	const labels = {
+		"success": "上传成功",
+		"failed": "失败",
+		"not-run": "未执行",
+		"dry-run": "仅构建",
+		"unknown": "远端结果未确认"
+	};
+	for (const item of report.results) process.stderr.write(`[upload:${item.platform ?? "配置平台"}] ${labels[item.status]}${item.requestedVersion ? ` ${item.requestedVersion}` : ""} (${item.stage})\n`);
+}
+/** JSON 模式独占 stdout，构建配置及第三方工具的普通日志只进入 stderr。 */
+async function outputUploadReport(json, run) {
+	const stdoutWrite = process.stdout.write;
+	if (json) process.stdout.write = process.stderr.write.bind(process.stderr);
+	try {
+		let report;
+		try {
+			report = await run();
+		} catch (error) {
+			report = error instanceof UploadCommandError ? error.report : createFailedUploadReport(error);
+		}
+		if (json) {
+			await new Promise((resolve, reject) => {
+				stdoutWrite.call(process.stdout, `${JSON.stringify(report)}\n`, "utf8", (error) => error ? reject(error) : resolve());
+			});
+			if (report.status === "failed") process.exitCode = 1;
+		} else {
+			printUploadSummary(report);
+			if (report.status === "failed") throw new UploadCommandError(report);
+		}
+	} finally {
+		process.stdout.write = stdoutWrite;
+	}
+}
+//#endregion
+//#region src/cli/upload/builtProject.ts
+/** 仅由显式上传或预览入口读取参数，不执行构建或调用平台工具。 */
+async function createUploadTarget(config, options, action) {
+	if (config.weappLibConfig?.enabled || config.pluginOnly) throw new Error(`${action} 仅支持完整小程序项目，不支持组件库或独立插件构建。`);
+	const platform = resolveUploadPlatforms(config.platform)[0];
+	const uploadConfig = action === "upload" ? config.weappViteConfig.upload : void 0;
+	const version = (options.uv ?? uploadConfig?.version ?? config.packageJson.version)?.trim() ?? "";
+	if (action === "upload" && !version) throw new Error("请通过 --uv、weapp.upload.version 或项目 package.json 的 version 指定上传版本。");
+	const desc = (options.desc ?? uploadConfig?.desc)?.trim() || `${config.packageJson.name ?? platform}${version ? `@${version}` : ""}`;
+	const env = options.dryRun ? {} : await loadUploadEnv(config.cwd, config.mode, config.inlineConfig.root, config.inlineConfig.envDir);
+	const { projectConfigFileName } = getProjectPlatformOptions(config.platform);
+	const generatedProjectConfig = config.multiPlatform.projectConfigs !== void 0;
+	const projectPath = generatedProjectConfig ? config.outDir : config.multiPlatform.enabled ? path$1.dirname(config.outDir) : path$1.dirname(config.projectConfigPath ?? path$1.join(config.cwd, projectConfigFileName));
+	const appid = config.projectConfig.appid ?? config.projectConfig.appId;
+	const target = {
+		platform,
+		sourceConfigPath: config.projectConfigPath,
+		context: {
+			cwd: config.cwd,
+			projectPath,
+			appid: typeof appid === "string" ? appid : void 0,
+			version,
+			desc,
+			qrCodePath: action === "preview" && !options.dryRun ? path$1.join(config.cwd, ".weapp-vite", "preview", `${platform}-${randomUUID()}.png`) : void 0,
+			env: {
+				...process.env,
+				...env
+			}
+		}
+	};
+	(config.inlineConfig.plugins ??= []).push({
+		name: "weapp-vite:upload-output",
+		apply: (viteConfig) => resolveWeappViteHostMeta(viteConfig)?.runtime === "miniprogram",
+		writeBundle(output, bundle) {
+			if (output.dir && Object.hasOwn(bundle, "app.json")) {
+				target.outDir = path$1.resolve(output.dir);
+				if (generatedProjectConfig) target.context.projectPath = target.outDir;
+			}
+		}
+	});
+	return target;
+}
+/** 只消费本次构建的产物；产物校验通过前不会准备凭据或调用平台工具。 */
+async function executeUploadTarget(target, options, action, execution = {}) {
+	const { platform, context } = target;
+	if (!target.outDir) throw new Error("本次构建未写出 app.json，已阻止上传或预览旧产物。");
+	await validateUploadProject({
+		platform,
+		projectPath: context.projectPath,
+		outDir: target.outDir,
+		sourceConfigPath: target.sourceConfigPath
+	});
+	if (options.dryRun) {
+		logger_default.success(`[${action}:${platform}] dry-run：构建完成，未校验凭据或调用平台工具。项目：${path$1.relative(context.cwd, context.projectPath) || "."}`);
+		return;
+	}
+	const upload = await prepareUpload(platform, context, action);
+	execution.onUpload?.();
+	const result = await executeUpload(platform, context, upload.secrets, action, {
+		...execution,
+		onProgress: execution.onProgress ?? ((event) => printUploadProgress(platform, event))
+	});
+	if (action === "preview") {
+		if (!result) throw new Error("预览工具未返回二维码或预览链接。");
+		for (const [label, value] of [
+			["二维码图片", result.qrCodeUrl],
+			["预览链接", result.previewUrl],
+			["二维码文件", result.qrCodeFile && path$1.relative(context.cwd, result.qrCodeFile)]
+		]) if (value) logger_default.info(`[preview:${platform}] ${label}：${redactUploadSecrets(value, upload.secrets)}`);
+		logger_default.success(`[preview:${platform}] 预览已生成（未上传开发版本、未提审、未正式发布）。`);
+	} else logger_default.success(`[upload:${platform}] ${context.version} 上传完成（未提审、未正式发布）。`);
+	return result;
+}
+//#endregion
+//#region src/cli/upload/options.ts
+function readUploadMetadata(cli) {
+	for (const name of [
+		"uv",
+		"desc",
+		"bump"
+	]) {
+		const value = cli.options[name];
+		if (typeof value === "boolean" || Array.isArray(value) && value.some((item) => typeof item === "boolean")) throw new Error(`--${name} 需要指定字符串参数。`);
+	}
+	const { values } = parseArgs({
+		args: cli.rawArgs.slice(2),
+		allowPositionals: true,
+		strict: false,
+		options: {
+			uv: { type: "string" },
+			desc: { type: "string" },
+			bump: { type: "string" }
+		}
+	});
+	return {
+		uv: typeof values.uv === "string" ? values.uv : void 0,
+		desc: typeof values.desc === "string" ? values.desc : void 0,
+		bump: typeof values.bump === "string" ? values.bump : void 0
+	};
+}
+/** 超时只约束单个平台的 SDK 进程，不含构建；未指定时不改变原有等待行为。 */
+function resolveUploadTimeout(value) {
+	if (value === void 0) return;
+	const seconds = typeof value === "number" ? value : Number(value);
+	const milliseconds = Math.round(seconds * 1e3);
+	if (typeof value !== "string" && typeof value !== "number" || !Number.isFinite(milliseconds) || milliseconds / 1e3 !== seconds || milliseconds <= 0 || milliseconds > 2147483647) throw new Error("--timeout 必须为正数秒，精度不超过毫秒且不能超过 2147483.647 秒。");
+	return milliseconds;
+}
+/** 普通构建不读取上传元数据；上传必须是显式的一次性构建操作。 */
+function resolveBuildUploadOptions(cli, options) {
+	if (options.upload !== true) {
+		if (options.uv !== void 0 || options.desc !== void 0 || options.bump !== void 0 || options.gitDesc !== void 0 || options.dryRun !== void 0) throw new Error("--uv、--desc、--bump、--git-desc 和 --dry-run 仅能与 --upload 一起使用。");
+		return;
+	}
+	if (options.watch) throw new Error("--upload 不能与 --watch 一起使用，请执行一次性构建。");
+	return {
+		...options,
+		...readUploadMetadata(cli)
+	};
+}
+//#endregion
 //#region src/cli/commands/build.ts
 function emitDashboardEvents$1(handle, events) {
 	handle?.emitRuntimeEvents(events);
@@ -3488,22 +3496,36 @@ function scheduleCompletedProductionBuildExit(options, analyzeHandle) {
 	}, 0).unref?.();
 }
 function registerBuildCommand(cli) {
-	cli.command("build [root]", "build for production").option("--target <target>", `[string] transpile target (default: 'modules')`).option("--outDir <dir>", `[string] output directory (default: dist)`).option("-p, --platform <platform>", `[string] target platform (weapp | web | all)`).option("--project-config <path>", `[string] project config path (miniprogram only)`).option("--sourcemap [output]", `[boolean | "inline" | "hidden"] output source maps for build (default: false)`).option("--minify [minifier]", "[boolean | \"terser\" | \"esbuild\"] enable/disable minification, or specify minifier to use (default: esbuild)").option("--emptyOutDir", `[boolean] force empty outDir when it's outside of root`).option("-w, --watch", `[boolean] rebuilds when modules have changed on disk`).option("--skipNpm", `[boolean] if skip npm build`).option("-o, --open", `[boolean] open ide`).option("--trust-project", "[boolean] auto trust Wechat DevTools project on open", { default: true }).option("--ide-open-strategy <strategy>", "[string] IDE open strategy (cli | automator)", { default: "cli" }).option("--no-open-recovery", "[boolean] disable automatic Wechat DevTools close-and-reopen recovery").option("--ui", `[boolean] 启动调试 UI（当前提供分析视图）`, { default: false }).option("--analyze", `[boolean] 输出分包分析仪表盘`, { default: false }).option("--scope <scope>", `[string] 局部构建范围，例如 main,packages/order`).action(async (root, options) => {
+	cli.command("build [root]", "build for production").option("--target <target>", `[string] transpile target (default: 'modules')`).option("--outDir <dir>", `[string] output directory (default: dist)`).option("-p, --platform <platform>", `[string] target platform (weapp | web | all)`).option("--project-config <path>", `[string] project config path (miniprogram only)`).option("--sourcemap [output]", `[boolean | "inline" | "hidden"] output source maps for build (default: false)`).option("--minify [minifier]", "[boolean | \"terser\" | \"esbuild\"] enable/disable minification, or specify minifier to use (default: esbuild)").option("--emptyOutDir", `[boolean] force empty outDir when it's outside of root`).option("-w, --watch", `[boolean] rebuilds when modules have changed on disk`).option("--skipNpm", `[boolean] if skip npm build`).option("-o, --open", `[boolean] open ide`).option("--trust-project", "[boolean] auto trust Wechat DevTools project on open", { default: true }).option("--ide-open-strategy <strategy>", "[string] IDE open strategy (cli | automator)", { default: "cli" }).option("--no-open-recovery", "[boolean] disable automatic target-project open retry (preserves existing IDE windows)").option("--ui", `[boolean] 启动调试 UI（当前提供分析视图）`, { default: false }).option("--ui-host <host>", `[string] 启动调试 UI 并选择宿主（standalone | hub）`).option("--analyze", `[boolean] 输出分包分析仪表盘`, { default: false }).option("--scope <scope>", `[string] 局部构建范围，例如 main,packages/order`).option("--upload", "[boolean] upload the mini program after this build succeeds").option("--uv <version>", "[string] upload version override (requires --upload)").option("--desc <text>", "[string] upload description override (requires --upload)").option("--bump <release>", "[string] increment local package version (patch | minor | major; requires --upload)").option("--git-desc", "[boolean] use the latest Git commit subject (requires --upload)").option("--dry-run", "[boolean] validate upload output without credentials or SDK calls (requires --upload)").action(async (root, options) => {
 		let analyzeHandle;
+		let session;
 		let ctx;
 		let targets;
+		let uploadMetadataRollback;
 		let buildCompleted = false;
+		let buildFailed = false;
 		try {
+			options = { ...options };
 			filterDuplicateOptions(options);
+			options.uiHost = parseDashboardUiHost(options.uiHost);
+			let uploadOptions = resolveBuildUploadOptions(cli, options);
 			setCommandNodeEnv("production");
 			const cwd = root ?? process.cwd();
 			const configFile = resolveConfigFile(options);
 			targets = resolveRuntimeTargets(options);
+			if (uploadOptions) validateAutoUploadMetadata(uploadOptions, "upload");
+			if (uploadOptions && !getBackendForCapability(targets, "miniprogram", "build")) throw new Error("--upload 仅支持包含小程序目标的构建，不能用于纯 Web 构建。");
 			const inlineConfig = createInlineConfig(targets, {
 				scope: options.scope,
 				inlineConfig: createBuildInlineConfig(options)
 			});
-			ctx = await createCompilerContext({
+			if (uploadOptions) {
+				const prepared = await prepareAutoUploadMetadataWithRollback(cwd, uploadOptions, "upload");
+				uploadOptions = prepared.options;
+				uploadMetadataRollback = prepared.rollback;
+			}
+			session = new CompilerSession();
+			ctx = await session.initialize({
 				cwd,
 				mode: options.mode ?? "production",
 				configFile,
@@ -3513,7 +3535,16 @@ function registerBuildCommand(cli) {
 				emitDefaultAutoImportOutputs: false,
 				preloadAppEntry: false
 			});
+			targets = resolveConfiguredRuntimeTargets(targets, ctx.configService.options?.sourceConfig?.weapp?.platform);
+			if (uploadOptions && !getBackendForCapability(targets, "miniprogram", "build")) {
+				await uploadMetadataRollback?.();
+				uploadMetadataRollback = void 0;
+				throw new Error("--upload 仅支持包含小程序目标的构建，不能用于纯 Web 构建。");
+			}
+			uploadMetadataRollback = void 0;
+			for (const backend of targets.select("build")) session.onClose(() => backend.driver.close(ctx));
 			const { configService } = ctx;
+			const uploadTarget = uploadOptions ? await createUploadTarget(configService, uploadOptions, "upload") : void 0;
 			const miniBackend = getBackendForCapability(targets, "miniprogram", "build");
 			const webBackend = getBackendForCapability(targets, "web", "build");
 			logRuntimeTarget(targets, { resolvedConfigPlatform: configService.platform });
@@ -3521,7 +3552,7 @@ function registerBuildCommand(cli) {
 			for (const backend of targets.select("build")) {
 				if (backend.descriptor.id === "miniprogram") {
 					const miniBuildStartedAt = Date.now();
-					const output = await backend.driver.build(ctx, options);
+					const output = await session.run(() => backend.driver.build(ctx, options));
 					const miniBuildDurationMs = Date.now() - miniBuildStartedAt;
 					logger_default.success(`小程序构建完成，耗时：${colors.green(formatDuration(miniBuildDurationMs))}`);
 					if (!Array.isArray(output) && "output" in output) logBuildPackageSizeReport({
@@ -3538,6 +3569,7 @@ function registerBuildCommand(cli) {
 						const analyzeDurationMs = Date.now() - analyzeStartedAt;
 						analyzeHandle = await startAnalyzeDashboard(analyzeResult, {
 							watch: true,
+							uiHost: options.uiHost,
 							artifacts: artifactSnapshot.files,
 							cwd: configService.cwd,
 							packageManagerAgent: configService.packageManager.agent,
@@ -3567,7 +3599,7 @@ function registerBuildCommand(cli) {
 				if (backend.descriptor.id !== "web" || !webConfig?.enabled) continue;
 				const webBuildStartedAt = Date.now();
 				try {
-					await backend.driver.build(ctx, options);
+					await session.run(() => backend.driver.build(ctx, options));
 					const webBuildDurationMs = Date.now() - webBuildStartedAt;
 					logger_default.success(`Web 构建完成，输出目录：${colors.green(configService.relativeCwd(webConfig.outDir))}，耗时：${colors.green(formatDuration(webBuildDurationMs))}`);
 					emitDashboardEvents$1(analyzeHandle, [{
@@ -3591,6 +3623,7 @@ function registerBuildCommand(cli) {
 					throw error;
 				}
 			}
+			if (uploadTarget && uploadOptions) await executeUploadTarget(uploadTarget, uploadOptions, "upload");
 			if (miniBackend) logBuildAppFinish(configService, void 0, { skipWeb: !webBackend });
 			if (options.open && getBackendForCapability(targets, "miniprogram", "ide")) {
 				emitDashboardEvents$1(analyzeHandle, [{
@@ -3600,7 +3633,8 @@ function registerBuildCommand(cli) {
 					detail: "构建完成后准备打开 IDE 项目。",
 					tags: ["ide", "open"]
 				}]);
-				await openIde(configService.platform, resolveIdeProjectPath(configService.mpDistRoot), {
+				const generatedProjectConfig = configService.multiPlatform.projectConfigs !== void 0;
+				await openIde(configService.platform, resolveIdeProjectPath(generatedProjectConfig ? configService.outDir : configService.mpDistRoot, generatedProjectConfig), {
 					openRecovery: options.openRecovery,
 					trustProject: options.trustProject,
 					openStrategy: options.ideOpenStrategy
@@ -3608,9 +3642,12 @@ function registerBuildCommand(cli) {
 			}
 			if (analyzeHandle) await analyzeHandle.waitForExit();
 			buildCompleted = true;
+		} catch (error) {
+			buildFailed = true;
+			throw error;
 		} finally {
-			if (ctx && targets) for (const backend of [...targets.select("build")].reverse()) await backend.driver.close(ctx);
-			terminateStaleSassEmbeddedProcess();
+			if (buildFailed) await session?.close().catch((error) => logger_default.error(error));
+			else await session?.close();
 			if (buildCompleted) scheduleCompletedProductionBuildExit(options, analyzeHandle);
 		}
 	});
@@ -3623,6 +3660,39 @@ function registerCloseCommand(cli) {
 	});
 }
 //#endregion
+//#region src/cli/commands/doctor.ts
+function registerDoctorCommand(cli) {
+	cli.command("doctor [root]", "检查项目、源码、产物与显式选择的宿主证据").option("--targets <targets>", "编译目标，逗号分隔（默认 weapp）").option("--platform <platform>", "单个编译目标").option("--source <directory>", "静态源码目录（默认 src，不执行配置推断）").option("--artifact <directory>", "复用最终产物目录（新鲜度未验证）").option("--build", "显式执行配置和构建，使用独立输出目录").option("--runtime", "连接已打开项目的宿主探针，不启动 IDE").option("--runtime-port <port>", "已有 automator 会话的端口（默认项目派生端口）").option("--runtime-cli <path>", "只读检查所选 CLI 的可执行条件，不回退安装").option("--runtime-service-port <port>", "检查指定回环 TCP 服务监听，不推断宿主身份").option("--runtime-login", "显式运行原生登录查询，可能启动 IDE；需要 --runtime-cli").option("--format <format>", "terminal | json | sarif", { default: "terminal" }).action(async (root, options) => {
+		const { formatDoctorReport, runDoctor } = await import("./doctor.mjs");
+		const format = options.format;
+		if (![
+			"terminal",
+			"json",
+			"sarif"
+		].includes(format)) {
+			process.stderr.write("doctor: format 必须为 terminal、json 或 sarif\n");
+			process.exitCode = 2;
+			return;
+		}
+		const report = await runDoctor({
+			cwd: root,
+			targets: String(options.targets ?? options.platform ?? "weapp").split(",").map((item) => item.trim()),
+			source: options.source,
+			artifact: options.artifact,
+			build: options.build === true,
+			runtime: options.runtime === true,
+			configFile: options.config,
+			runtimePort: options.runtimePort === void 0 ? void 0 : Number(options.runtimePort),
+			runtimeCliPath: options.runtimeCli,
+			runtimeServicePort: options.runtimeServicePort === void 0 ? void 0 : Number(options.runtimeServicePort),
+			runtimeLogin: options.runtimeLogin === true ? true : void 0,
+			onBuildLog: (text) => process.stderr.write(text)
+		});
+		process.stdout.write(`${formatDoctorReport(report, format)}\n`);
+		process.exitCode = report.exitCode;
+	});
+}
+//#endregion
 //#region src/schematics.ts
 function composePath(outDir, filename) {
 	return `${outDir}${outDir ? "/" : ""}${filename}`;
@@ -3707,60 +3777,6 @@ async function generate(options) {
 	}
 }
 //#endregion
-//#region src/cli/loadConfig.ts
-async function loadConfig(configFile) {
-	const cwd = process.cwd();
-	let resolvedConfigFile = configFile;
-	if (resolvedConfigFile && !path.isAbsolute(resolvedConfigFile)) resolvedConfigFile = path.resolve(cwd, resolvedConfigFile);
-	const configEnv = {
-		command: "serve",
-		mode: "development"
-	};
-	let loaded;
-	try {
-		loaded = await loadViteConfigFile(configEnv, resolvedConfigFile, cwd, void 0, void 0, "runner");
-	} catch (error) {
-		const cjsError = createCjsConfigLoadError({
-			error,
-			configPath: resolvedConfigFile,
-			cwd
-		});
-		if (cjsError) throw cjsError;
-		throw error;
-	}
-	const weappConfigFilePath = await resolveWeappConfigFile({
-		root: cwd,
-		specified: resolvedConfigFile
-	});
-	let weappLoaded;
-	if (weappConfigFilePath) {
-		const normalizedWeappPath = path.resolve(weappConfigFilePath);
-		const normalizedLoadedPath = loaded?.path ? path.resolve(loaded.path) : void 0;
-		if (normalizedLoadedPath && normalizedLoadedPath === normalizedWeappPath) weappLoaded = loaded;
-		else try {
-			weappLoaded = await loadViteConfigFile(configEnv, weappConfigFilePath, cwd, void 0, void 0, "runner");
-		} catch (error) {
-			const cjsError = createCjsConfigLoadError({
-				error,
-				configPath: weappConfigFilePath,
-				cwd
-			});
-			if (cjsError) throw cjsError;
-			throw error;
-		}
-	}
-	if (!loaded && !weappLoaded) return;
-	const config = weappLoaded?.config ? defu(weappLoaded.config, loaded?.config ?? {}) : loaded?.config ?? {};
-	const dependencySet = /* @__PURE__ */ new Set();
-	for (const dependency of loaded?.dependencies ?? []) dependencySet.add(dependency);
-	for (const dependency of weappLoaded?.dependencies ?? []) dependencySet.add(dependency);
-	return {
-		config,
-		path: weappLoaded?.path ?? loaded?.path ?? resolvedConfigFile,
-		dependencies: Array.from(dependencySet)
-	};
-}
-//#endregion
 //#region src/cli/commands/generate.ts
 function registerGenerateCommand(cli) {
 	cli.command("g [filepath]", "generate component").alias("generate").option("-a, --app", "type app").option("-p, --page", "type app").option("-n, --name <name>", "filename").action(async (filepath, options) => {
@@ -3800,6 +3816,7 @@ const DEFAULT_FORWARD_CONSOLE_LEVELS = [
 let activeForwardConsoleSession;
 let activeForwardConsoleBridgeOptions;
 let activeForwardConsoleStart;
+let activeForwardConsoleClose;
 let forwardConsoleLifecycle = 0;
 const FORWARD_CONSOLE_RETRY_DELAY_MS = 1e3;
 const FORWARD_CONSOLE_RETRY_TIMES = 5;
@@ -3945,15 +3962,9 @@ async function pauseActiveForwardConsole() {
 		if (activeForwardConsoleStart) return await activeForwardConsoleStart;
 		if (activeForwardConsoleSession) return true;
 		const startTask = (async () => {
+			let resumedSession;
 			try {
-				const resumedSession = await startForwardConsoleBridge(bridgeOptions);
-				if (lifecycle !== forwardConsoleLifecycle) {
-					await resumedSession.close();
-					return false;
-				}
-				activeForwardConsoleSession = resumedSession;
-				activeForwardConsoleBridgeOptions = bridgeOptions;
-				return true;
+				resumedSession = await startForwardConsoleBridge(bridgeOptions);
 			} catch (error) {
 				if (lifecycle === forwardConsoleLifecycle) {
 					const message = error instanceof Error ? error.message : String(error);
@@ -3961,6 +3972,13 @@ async function pauseActiveForwardConsole() {
 				}
 				return false;
 			}
+			if (lifecycle !== forwardConsoleLifecycle) {
+				await resumedSession.close();
+				return false;
+			}
+			activeForwardConsoleSession = resumedSession;
+			activeForwardConsoleBridgeOptions = bridgeOptions;
+			return true;
 		})();
 		activeForwardConsoleStart = startTask;
 		try {
@@ -3973,21 +3991,32 @@ async function pauseActiveForwardConsole() {
 /**
 * @description 关闭当前 DevTools 日志桥并释放共享 automator 会话。
 */
-async function closeActiveForwardConsole() {
+function closeActiveForwardConsole() {
+	if (activeForwardConsoleClose) return activeForwardConsoleClose;
 	forwardConsoleLifecycle += 1;
 	const session = activeForwardConsoleSession;
 	const pendingStart = activeForwardConsoleStart;
 	activeForwardConsoleSession = void 0;
 	activeForwardConsoleBridgeOptions = void 0;
-	await session?.close();
-	await pendingStart?.catch(() => {});
+	const closing = (async () => {
+		const errors = (await Promise.allSettled([Promise.resolve().then(() => session?.close()), pendingStart])).filter((result) => result.status === "rejected").map((result) => result.reason);
+		if (errors.length === 1) throw errors[0];
+		if (errors.length > 1) throw new AggregateError(errors, "DevTools 日志桥关闭失败");
+	})();
+	activeForwardConsoleClose = closing;
+	closing.finally(() => {
+		if (activeForwardConsoleClose === closing) activeForwardConsoleClose = void 0;
+	}).catch(() => {});
+	return closing;
 }
 /**
 * @description 在 weapp 开发态按需启动控制台转发。
 */
 async function maybeStartForwardConsole(options) {
-	if (options.platform !== "weapp") return false;
-	const projectPath = resolveIdeProjectPath(options.mpDistRoot) ?? options.cwd;
+	if (options.platform !== "weapp" || activeForwardConsoleClose) return false;
+	const multiPlatform = options.weappViteConfig?.multiPlatform;
+	const generatedProjectConfig = typeof multiPlatform === "object" && multiPlatform.projectConfigs !== void 0;
+	const projectPath = resolveIdeProjectRoot(options.mpDistRoot, options.cwd, generatedProjectConfig);
 	if (!projectPath) return false;
 	if (activeForwardConsoleSession) return true;
 	if (activeForwardConsoleStart) return await activeForwardConsoleStart;
@@ -4026,7 +4055,7 @@ async function maybeStartForwardConsole(options) {
 					openedOnly: true,
 					preferOpenedSession: true
 				};
-				return await activateSession(await startForwardConsoleBridge(recoveredOptions), recoveredOptions);
+				return activateSession(await startForwardConsoleBridge(recoveredOptions), recoveredOptions);
 			} catch (recoveryError) {
 				if (lifecycle !== forwardConsoleLifecycle) return false;
 				const message = recoveryError instanceof Error ? recoveryError.message : String(recoveryError);
@@ -4035,7 +4064,7 @@ async function maybeStartForwardConsole(options) {
 			}
 		};
 		try {
-			return await activateSession(await startForwardConsoleBridge(bridgeOptions), bridgeOptions);
+			return activateSession(await startForwardConsoleBridge(bridgeOptions), bridgeOptions);
 		} catch (error) {
 			if (lifecycle !== forwardConsoleLifecycle) return false;
 			if (options.recoverAutomatorSession && isRecoverableAutomatorStartError(error)) return await recoverAutomatorSession();
@@ -4051,7 +4080,7 @@ async function maybeStartForwardConsole(options) {
 				preferOpenedSession: true
 			};
 			try {
-				return await activateSession(await startForwardConsoleBridge(fallbackOptions), fallbackOptions);
+				return activateSession(await startForwardConsoleBridge(fallbackOptions), fallbackOptions);
 			} catch (fallbackError) {
 				if (lifecycle !== forwardConsoleLifecycle) return false;
 				const message = fallbackError instanceof Error ? fallbackError.message : String(fallbackError);
@@ -4072,19 +4101,6 @@ async function maybeStartForwardConsole(options) {
 function isFiniteNumber(value) {
 	return typeof value === "number" && Number.isFinite(value);
 }
-function parseLatestHmrProfileSample(content) {
-	const lines = content.split(/\r?\n/);
-	for (let index = lines.length - 1; index >= 0; index -= 1) {
-		const trimmed = lines[index]?.trim();
-		if (!trimmed) continue;
-		try {
-			const parsed = JSON.parse(trimmed);
-			if (isFiniteNumber(parsed.totalMs)) return parsed;
-		} catch {
-			continue;
-		}
-	}
-}
 function formatPhaseHint(sample) {
 	const topPhase = [
 		{
@@ -4274,7 +4290,8 @@ async function readLatestHmrProfileSummary(options) {
 	if (!profilePath) return;
 	const content = await fs$1.readFile(profilePath, "utf8").catch(() => void 0);
 	if (!content) return;
-	const sample = parseLatestHmrProfileSample(content);
+	const { samples, skippedLineCount } = readHmrProfileLines(content);
+	const sample = samples.at(-1);
 	if (!sample || !isFiniteNumber(sample.totalMs)) return;
 	const relativeCwd = options.relativeCwd ?? ((value) => value);
 	const segments = [`[hmr] 最近一次热更新 ${sample.totalMs.toFixed(2)} ms`];
@@ -4282,7 +4299,8 @@ async function readLatestHmrProfileSummary(options) {
 	if (sample.file) segments.push(relativeCwd(sample.file));
 	const phaseHint = formatPhaseHint(sample);
 	if (phaseHint) segments.push(`主耗时 ${phaseHint}`);
-	if (isFiniteNumber(sample.loadCount) || isFiniteNumber(sample.resolveCount) || isFiniteNumber(sample.chunkEmitCount) || isFiniteNumber(sample.skippedLoadedCount)) segments.push(`load/resolve/chunk/skip ${sample.loadCount ?? 0}/${sample.resolveCount ?? 0}/${sample.chunkEmitCount ?? 0}/${sample.skippedLoadedCount ?? 0}`);
+	if (isFiniteNumber(sample.loadCount) || isFiniteNumber(sample.resolveCount) || isFiniteNumber(sample.chunkEmitCount) || isFiniteNumber(sample.skippedLoadedCount)) segments.push(`load/resolve/chunk/skip ${sample.loadCount ?? "unknown"}/${sample.resolveCount ?? "unknown"}/${sample.chunkEmitCount ?? "unknown"}/${sample.skippedLoadedCount ?? "unknown"}`);
+	if (skippedLineCount) segments.push(`忽略 ${skippedLineCount} 条不兼容、未完成或无效记录`);
 	return {
 		file: sample.file,
 		profilePath,
@@ -4335,20 +4353,19 @@ async function runIdeDoctor(projectPath, options) {
 		status: "unknown"
 	};
 	if (resolvedCli.cliPath) try {
-		await isWechatIdeLoggedIn({
-			nonInteractive: true,
-			silent: true
-		});
-		loginCheck = {
-			status: "ok",
-			value: true
+		const result = await queryWechatIdeLogin(resolvedCli.cliPath, { timeout: 3e3 });
+		loginCheck = result.status === "success" ? {
+			status: result.login ? "ok" : "warning",
+			value: result.login,
+			...result.login ? {} : { message: "原生 CLI 明确返回未登录，请打开微信开发者工具完成登录。" }
+		} : {
+			status: "unknown",
+			message: `登录查询未确认状态（${result.reason}），不能据此认定未登录。`
 		};
-	} catch (error) {
+	} catch {
 		loginCheck = {
-			fix: "打开微信开发者工具完成登录后重试，或执行 `wv ide doctor --json` 查看 CLI 错误。",
-			message: error instanceof Error ? error.message : String(error),
-			status: "warning",
-			value: false
+			message: "登录查询执行失败，登录状态仍未确认。",
+			status: "unknown"
 		};
 	}
 	const projectCheck = projectPath ? {
@@ -4377,11 +4394,20 @@ async function runIdeDoctor(projectPath, options) {
 			status: "ok",
 			value: true
 		};
-		if (typeof miniProgram.toolInfo === "function") toolCheck = {
-			status: "ok",
-			value: await miniProgram.toolInfo()
-		};
-		miniProgram.disconnect?.();
+		try {
+			if (typeof miniProgram.toolInfo === "function") toolCheck = {
+				status: "ok",
+				value: await miniProgram.toolInfo()
+			};
+		} catch {
+			toolCheck = {
+				status: "warning",
+				message: "项目自动化连接已建立，但 Tool.getInfo 未能返回工具信息；宿主版本仍未确认。",
+				fix: "确认目标项目模拟器就绪后重新运行 doctor；此结果不证明登录失效。"
+			};
+		} finally {
+			miniProgram.disconnect?.();
+		}
 	} catch (error) {
 		automatorCheck = {
 			fix: "先执行 `wv open` 打开项目；若服务端口已开启，关闭多余 DevTools 窗口后重试。",
@@ -4530,7 +4556,7 @@ async function runIdeCommand(action, root, options) {
 * @description 注册 IDE 相关子命令。
 */
 function registerIdeCommand(cli) {
-	cli.command("ide [action] [root]", "run Wechat DevTools utility actions and log bridge commands").option("-o, --open", "[boolean] open ide before attaching log bridge").option("-p, --platform <platform>", "[string] target platform (weapp | web)").option("--project-config <path>", "[string] project config path (miniprogram only)").option("--json", "[boolean] output the doctor report as JSON").option("--ticket <value>", "[string] ticket used by `ide ticket:set`").option("--trust-project", "[boolean] auto trust Wechat DevTools project on open", { default: true }).option("--ide-open-strategy <strategy>", "[string] IDE open strategy (cli | automator)", { default: "cli" }).option("--strict", "[boolean] fail when doctor finds blocking environment errors").option("--no-open-recovery", "[boolean] disable automatic Wechat DevTools close-and-reopen recovery").action(async (action, root, options) => {
+	cli.command("ide [action] [root]", "run Wechat DevTools utility actions and log bridge commands").option("-o, --open", "[boolean] open ide before attaching log bridge").option("-p, --platform <platform>", "[string] target platform (weapp | web)").option("--project-config <path>", "[string] project config path (miniprogram only)").option("--json", "[boolean] output the doctor report as JSON").option("--ticket <value>", "[string] ticket used by `ide ticket:set`").option("--trust-project", "[boolean] auto trust Wechat DevTools project on open", { default: true }).option("--ide-open-strategy <strategy>", "[string] IDE open strategy (cli | automator)", { default: "cli" }).option("--strict", "[boolean] fail when doctor finds blocking environment errors").option("--no-open-recovery", "[boolean] disable automatic target-project open retry (preserves existing IDE windows)").action(async (action, root, options) => {
 		await runIdeCommand(action, root, options);
 	});
 }
@@ -4546,405 +4572,6 @@ function registerInitCommand(cli) {
 	});
 }
 //#endregion
-//#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 ";
-const CODEX_BLOCK_END_SUFFIX = " <<<";
-const DEFAULT_HTTP_TIMEOUT_MS = 1500;
-const WORKSPACE_FOLDER_TOKEN = "${workspaceFolder}";
-const REG_CodexUrl = /^\s*url\s*=\s*"([^"]+)"/m;
-const REG_CodexCommand = /^\s*command\s*=\s*"([^"]+)"/m;
-const REG_CodexArgs = /^\s*args\s*=\s*\[([^\]]*)\]/m;
-const REG_FirstTomlString = /"([^"]+)"/;
-function resolveTargetWorkspaceRoot(target) {
-	if (target.client === "cursor") return path.dirname(path.dirname(target.configPath));
-	if (target.client === "claude-code") return path.dirname(target.configPath);
-	return process.cwd();
-}
-function escapeRegExp(value) {
-	return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-function renderTomlString(value) {
-	return JSON.stringify(value);
-}
-function sanitizeServerNameSegment(value) {
-	return value.trim().toLowerCase().replace(/[^a-z0-9-]+/g, "-").replace(/-{2,}/g, "-").replace(/^-|-$/g, "");
-}
-function resolveServerName(workspaceRoot) {
-	return `weapp-vite-${sanitizeServerNameSegment(path.basename(workspaceRoot)) || "project"}`;
-}
-function resolveNodeBinCommand() {
-	return process.execPath || "node";
-}
-function resolveProjectCliBin(workspaceRoot) {
-	return path.join(workspaceRoot, "node_modules", "weapp-vite", "bin", "weapp-vite.js");
-}
-function renderCommandArgs(args) {
-	return args.map(renderTomlString).join(", ");
-}
-function renderCodexBlock(serverName, entry) {
-	const startMarker = `${CODEX_BLOCK_PREFIX}${serverName}${CODEX_BLOCK_SUFFIX}`;
-	const endMarker = `${CODEX_BLOCK_END_PREFIX}${serverName}${CODEX_BLOCK_END_SUFFIX}`;
-	if (entry.url) return `${startMarker}
-[mcp_servers.${serverName}]
-url = ${renderTomlString(entry.url)}
-${endMarker}
-`;
-	return `${startMarker}
-[mcp_servers.${serverName}]
-command = ${renderTomlString(entry.command ?? resolveNodeBinCommand())}
-args = [${renderCommandArgs(entry.args ?? [])}]
-${endMarker}
-`;
-}
-function renderJsonPreview(serverName, entry) {
-	return `${JSON.stringify({ mcpServers: { [serverName]: entry } }, null, 2)}
-`;
-}
-function resolveCommandEntry(client, workspaceRoot) {
-	const binPath = resolveProjectCliBin(workspaceRoot);
-	if (client === "cursor") return {
-		command: "node",
-		args: [
-			`${WORKSPACE_FOLDER_TOKEN}/node_modules/weapp-vite/bin/weapp-vite.js`,
-			"mcp",
-			"--workspace-root",
-			WORKSPACE_FOLDER_TOKEN
-		]
-	};
-	return {
-		command: resolveNodeBinCommand(),
-		args: [
-			binPath,
-			"mcp",
-			"--workspace-root",
-			workspaceRoot
-		]
-	};
-}
-function resolveHttpEntry(client, url) {
-	if (client === "claude-code") return {
-		type: "http",
-		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}`;
-	return new RegExp(`${escapeRegExp(startMarker)}[\\s\\S]*?${escapeRegExp(endMarker)}\\n?`, "g");
-}
-function upsertCodexManagedBlock(content, serverName, block) {
-	const withoutExisting = content.trimEnd().replace(resolveCodexBlockPattern(serverName), "").trimEnd();
-	if (!withoutExisting) return block;
-	return `${withoutExisting}\n\n${block}`;
-}
-function parseJsonConfig(content, configPath) {
-	if (!content.trim()) return {};
-	try {
-		return JSON.parse(content);
-	} catch (error) {
-		const message = error instanceof Error ? error.message : String(error);
-		throw new Error(`无法解析 MCP 配置文件 ${configPath}：${message}`);
-	}
-}
-function resolveTarget(client, workspaceRoot) {
-	const serverName = resolveServerName(workspaceRoot);
-	if (client === "codex") return {
-		client,
-		configPath: path.join(os.homedir(), ".codex", "config.toml"),
-		displayName: "Codex",
-		serverName
-	};
-	if (client === "claude-code") return {
-		client,
-		configPath: path.join(workspaceRoot, ".mcp.json"),
-		displayName: "Claude Code",
-		serverName
-	};
-	return {
-		client,
-		configPath: path.join(workspaceRoot, ".cursor", "mcp.json"),
-		displayName: "Cursor",
-		serverName
-	};
-}
-//#endregion
-//#region src/cli/mcpClient/inspect.ts
-async function probeHttpEndpoint(url) {
-	const controller = new AbortController();
-	const timer = setTimeout$1(() => {
-		controller.abort();
-	}, DEFAULT_HTTP_TIMEOUT_MS);
-	try {
-		return (await fetch(url, {
-			method: "GET",
-			signal: controller.signal
-		})).status > 0;
-	} catch {
-		return false;
-	} finally {
-		clearTimeout$1(timer);
-		controller.abort();
-	}
-}
-async function inspectJsonConfig(target) {
-	if (!await fs$1.pathExists(target.configPath)) return {
-		configExists: false,
-		configPath: target.configPath,
-		displayName: target.displayName,
-		issues: [`未找到配置文件：${target.configPath}`],
-		serverName: target.serverName
-	};
-	const entry = parseJsonConfig(await fs$1.readFile(target.configPath, "utf8"), target.configPath).mcpServers?.[target.serverName];
-	if (!entry) return {
-		configExists: true,
-		configPath: target.configPath,
-		displayName: target.displayName,
-		issues: [`配置文件中未找到服务器 ${target.serverName}`],
-		serverName: target.serverName
-	};
-	const transport = entry.url ? "http" : "command";
-	const issues = [];
-	let httpReachable;
-	if (transport === "command") {
-		const normalizedBin = (entry.args?.[0])?.replaceAll(WORKSPACE_FOLDER_TOKEN, resolveTargetWorkspaceRoot(target));
-		if (!normalizedBin || !await fs$1.pathExists(normalizedBin)) issues.push(`未找到本地 CLI 入口：${normalizedBin ?? "缺少 args[0]"}`);
-	} else if (entry.url) {
-		httpReachable = await probeHttpEndpoint(entry.url);
-		if (!httpReachable) issues.push(`HTTP MCP 地址不可达：${entry.url}`);
-	}
-	return {
-		configExists: true,
-		configPath: target.configPath,
-		displayName: target.displayName,
-		httpReachable,
-		issues,
-		serverName: target.serverName,
-		transport
-	};
-}
-async function inspectCodexConfig(target) {
-	if (!await fs$1.pathExists(target.configPath)) return {
-		configExists: false,
-		configPath: target.configPath,
-		displayName: target.displayName,
-		issues: [`未找到配置文件：${target.configPath}`],
-		serverName: target.serverName
-	};
-	const blockMatch = (await fs$1.readFile(target.configPath, "utf8")).match(resolveCodexBlockPattern(target.serverName));
-	if (!blockMatch?.[0]) return {
-		configExists: true,
-		configPath: target.configPath,
-		displayName: target.displayName,
-		issues: [`未找到 weapp-vite 生成的 Codex 配置区块：${target.serverName}`],
-		serverName: target.serverName
-	};
-	const block = blockMatch[0];
-	const issues = [];
-	const urlMatch = block.match(REG_CodexUrl);
-	const commandMatch = block.match(REG_CodexCommand);
-	const argsMatch = block.match(REG_CodexArgs);
-	if (urlMatch?.[1]) {
-		const reachable = await probeHttpEndpoint(urlMatch[1]);
-		if (!reachable) issues.push(`HTTP MCP 地址不可达：${urlMatch[1]}`);
-		return {
-			configExists: true,
-			configPath: target.configPath,
-			displayName: target.displayName,
-			httpReachable: reachable,
-			issues,
-			serverName: target.serverName,
-			transport: "http"
-		};
-	}
-	const binPath = (argsMatch?.[1]?.match(REG_FirstTomlString))?.[1];
-	if (!commandMatch?.[1]) issues.push("Codex 配置区块缺少 command 字段");
-	if (!binPath || !await fs$1.pathExists(binPath)) issues.push(`未找到本地 CLI 入口：${binPath ?? "缺少 args[0]"}`);
-	return {
-		configExists: true,
-		configPath: target.configPath,
-		displayName: target.displayName,
-		issues,
-		serverName: target.serverName,
-		transport: "command"
-	};
-}
-async function inspectMcpClientConfig(options) {
-	const target = resolveTarget(options.client, path.resolve(options.workspaceRoot));
-	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 [
-		"在 AI 工具中接入 weapp-vite MCP：",
-		`  - Codex: wv mcp init codex${suffix}`,
-		`  - Claude Code: wv mcp init claude-code${suffix}`,
-		`  - Cursor: wv mcp init cursor${suffix}`
-	];
-}
-//#endregion
-//#region src/cli/mcpClient/index.ts
-async function writeMcpClientConfig(plan) {
-	await fs$1.ensureDir(path.dirname(plan.target.configPath));
-	const existing = await fs$1.readFile(plan.target.configPath, "utf8").catch(() => "");
-	if (plan.target.client === "codex") {
-		const nextContent = upsertCodexManagedBlock(existing, plan.target.serverName, plan.preview);
-		await fs$1.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$1.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;
-	if (typeof port === "string" && port.trim()) {
-		const parsed = Number.parseInt(port, 10);
-		if (Number.isInteger(parsed)) return parsed;
-	}
-}
-async function resolveHttpUrl(options) {
-	if (options.url?.trim()) return options.url.trim();
-	const workspaceRoot = options.workspaceRoot ? path.resolve(options.workspaceRoot) : process.cwd();
-	const originalCwd = process.cwd();
-	try {
-		if (workspaceRoot !== originalCwd) process.chdir(workspaceRoot);
-		const loaded = await loadConfig(resolveConfigFile(options));
-		const resolved = resolveWeappMcpConfig(loaded?.config?.weapp?.mcp);
-		return `http://${resolved.host}:${resolved.port}${resolved.endpoint}`;
-	} catch {
-		const resolved = resolveWeappMcpConfig(void 0);
-		return `http://${resolved.host}:${resolved.port}${resolved.endpoint}`;
-	} finally {
-		if (process.cwd() !== originalCwd) process.chdir(originalCwd);
-	}
-}
-async function confirmWrite() {
-	if (!process.stdin.isTTY || !process.stdout.isTTY) return false;
-	return await runWithSuspendedSharedInput(async () => {
-		const rl = createInterface({
-			input: process.stdin,
-			output: process.stdout
-		});
-		try {
-			const normalized = (await rl.question("是否写入配置文件？(Y/n) ")).trim().toLowerCase();
-			return normalized === "" || normalized === "y" || normalized === "yes";
-		} finally {
-			rl.close();
-		}
-	});
-}
-function resolveClientTransport(transport) {
-	return transport === "http" ? "http" : "command";
-}
-async function handlePrint(clientName, options, write = false) {
-	const client = resolveSupportedMcpClient(clientName);
-	const workspaceRoot = options.workspaceRoot ?? process.cwd();
-	const transport = resolveClientTransport(options.transport);
-	const plan = buildMcpClientConfigPlan({
-		client,
-		transport,
-		url: transport === "http" ? await resolveHttpUrl(options) : void 0,
-		workspaceRoot
-	});
-	logger_default.info(`${plan.target.displayName} 配置文件：${plan.target.configPath}`);
-	logger_default.info(`服务器名称：${plan.target.serverName}`);
-	process.stdout.write(`${plan.preview}\n`);
-	if (!write) return;
-	if (options.yes || await confirmWrite()) {
-		await writeMcpClientConfig(plan);
-		logger_default.success(`已写入 ${plan.target.displayName} MCP 配置。`);
-		logger_default.info(`请重启 ${plan.target.displayName}，然后执行：wv mcp doctor ${client}`);
-		return;
-	}
-	logger_default.info("已取消写入。");
-}
-async function handleDoctor(clientName, options) {
-	const result = await inspectMcpClientConfig({
-		client: resolveSupportedMcpClient(clientName),
-		workspaceRoot: options.workspaceRoot ?? process.cwd()
-	});
-	logger_default.info(`${result.displayName} 配置文件：${result.configPath}`);
-	logger_default.info(`服务器名称：${result.serverName}`);
-	if (!result.configExists || result.issues.length > 0) {
-		for (const issue of result.issues) logger_default.warn(issue);
-		throw new Error("MCP 客户端配置检查未通过。");
-	}
-	if (result.transport) logger_default.info(`传输模式：${result.transport}`);
-	if (result.httpReachable !== void 0) logger_default.info(`HTTP 服务可达：${result.httpReachable ? "是" : "否"}`);
-	logger_default.success("MCP 客户端配置检查通过。");
-}
-async function handleServer(options) {
-	const resolvedTransport = options.transport === "http" ? "streamable-http" : options.transport === "command" ? void 0 : options.transport;
-	await startWeappViteMcpServer({
-		endpoint: options.endpoint,
-		host: options.host,
-		port: resolvePort(options.port),
-		restEndpoint: options.rest === false ? false : options.restEndpoint,
-		transport: resolvedTransport,
-		unref: options.unref,
-		workspaceRoot: options.workspaceRoot
-	});
-	for (const line of formatMcpQuickStart({
-		httpUrl: resolvedTransport === "streamable-http" ? `http://${options.host ?? "127.0.0.1"}:${resolvePort(options.port) ?? 3088}${options.endpoint ?? "/mcp"}` : void 0,
-		transport: resolvedTransport === "streamable-http" ? "http" : "command"
-	})) logger_default.info(line);
-}
-function registerMcpCommand(cli) {
-	cli.command("mcp [...args]", "start weapp-vite MCP server or manage MCP client onboarding").option("--transport <type>", "[string] stdio | streamable-http | command | http", { default: "stdio" }).option("--host <host>", "[string] streamable-http host").option("--port <port>", "[number] streamable-http port").option("--endpoint <path>", "[string] streamable-http endpoint path").option("--rest-endpoint <path>", "[string] streamable-http REST runtime endpoint path").option("--no-rest", "[boolean] disable streamable-http REST runtime endpoints").option("--unref", "[boolean] unref HTTP server to not block process exit").option("--url <url>", "[string] explicit HTTP MCP url").option("--workspace-root <path>", "[string] workspace root path, defaults to cwd").option("-y, --yes", "[boolean] write config without prompt").action(async (args, options) => {
-		const [subcommand, client] = args;
-		if (subcommand === "init") {
-			if (!client) throw new Error("缺少客户端名称，请使用：wv mcp init <codex|claude-code|cursor>");
-			await handlePrint(client, options, true);
-			return;
-		}
-		if (subcommand === "print") {
-			if (!client) throw new Error("缺少客户端名称，请使用：wv mcp print <codex|claude-code|cursor>");
-			await handlePrint(client, options, false);
-			return;
-		}
-		if (subcommand === "doctor") {
-			if (!client) throw new Error("缺少客户端名称，请使用：wv mcp doctor <codex|claude-code|cursor>");
-			await handleDoctor(client, options);
-			return;
-		}
-		if (subcommand) throw new Error(`未知的 mcp 子命令：${subcommand}`);
-		await handleServer(options);
-	});
-}
-//#endregion
 //#region src/cli/commands/npm.ts
 function registerNpmCommand(cli) {
 	cli.command("npm").alias("build:npm").alias("build-npm").action(async () => {
@@ -5066,7 +4693,7 @@ function applyMcpCliOptions(config, options) {
 //#endregion
 //#region src/cli/commands/open.ts
 function registerOpenCommand(cli) {
-	cli.command("open [root]").option("-p, --platform <platform>", `[string] target platform (weapp | web)`).option("--trust-project", "[boolean] auto trust Wechat DevTools project on open", { default: true }).option("--ide-open-strategy <strategy>", "[string] IDE open strategy (cli | automator)", { default: "cli" }).option("--login-retry <mode>", "[string] login retry mode for Wechat DevTools (never | once | always)").option("--login-retry-timeout <ms>", "[number] login retry prompt timeout in milliseconds").option("--non-interactive", "[boolean] fail immediately when Wechat DevTools login has expired").option("--no-open-recovery", "[boolean] disable automatic Wechat DevTools close-and-reopen recovery").option("--mcp", "[boolean] auto start MCP service before opening IDE").option("--no-mcp", "[boolean] disable MCP service before opening IDE").action(async (root, options) => {
+	cli.command("open [root]").option("-p, --platform <platform>", `[string] target platform (weapp | web)`).option("--trust-project", "[boolean] auto trust Wechat DevTools project on open", { default: true }).option("--ide-open-strategy <strategy>", "[string] IDE open strategy (cli | automator)", { default: "cli" }).option("--login-retry <mode>", "[string] login retry mode for Wechat DevTools (never | once | always)").option("--login-retry-timeout <ms>", "[number] login retry prompt timeout in milliseconds").option("--non-interactive", "[boolean] fail immediately when Wechat DevTools login has expired").option("--no-open-recovery", "[boolean] disable automatic target-project open retry (preserves existing IDE windows)").option("--mcp", "[boolean] auto start MCP service before opening IDE").option("--no-mcp", "[boolean] disable MCP service before opening IDE").action(async (root, options) => {
 		filterDuplicateOptions(options);
 		const configFile = resolveConfigFile(options);
 		const targets = resolveRuntimeTargets(options);
@@ -5369,9 +4996,6 @@ function resolveRunnableHotkeyDefinition(input) {
 	return DEV_HOTKEY_DEFINITIONS.find((action) => action.run && action.key === input);
 }
 //#endregion
-//#region package.json
-var version = "7.3.0";
-//#endregion
 //#region src/cli/devHotkeys/format.ts
 const FULLWIDTH_ASCII_START = 65281;
 const FULLWIDTH_ASCII_END = 65374;
@@ -5531,6 +5155,8 @@ function startDevHotkeys(options) {
 	if (options.platform !== "weapp" || !process.stdin.isTTY) return;
 	let closed = false;
 	let running = false;
+	let closing;
+	let actionPromise;
 	let mcpHandle;
 	let onData;
 	let onKeypress;
@@ -5565,17 +5191,25 @@ function startDevHotkeys(options) {
 		}
 	});
 	const close = () => {
-		if (closed) return;
+		if (closing) return closing;
 		closed = true;
 		if (onSigcont) process.off("SIGCONT", onSigcont);
-		inputSession?.close();
+		const inputErrors = [];
+		try {
+			inputSession?.close();
+		} catch (error) {
+			inputErrors.push(error);
+		}
 		inputSession = void 0;
-		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)}`);
-		});
+		return closing = (async () => {
+			await actionPromise;
+			const handle = mcpHandle;
+			const closeHandle = handle?.close?.bind(handle);
+			mcpHandle = void 0;
+			const results = await Promise.allSettled([Promise.resolve().then(() => closeHandle?.()), Promise.resolve().then(() => closeSharedMiniProgram(options.projectPath))]);
+			const failures = [...inputErrors, ...results.filter((result) => result.status === "rejected").map((result) => result.reason)];
+			if (failures.length) throw new AggregateError(failures, "开发快捷键资源关闭失败");
+		})();
 	};
 	const printPanel = (message, force = false) => {
 		if (!force && message === lastRenderedPanel) return;
@@ -5611,36 +5245,21 @@ function startDevHotkeys(options) {
 		}
 	});
 	const resolvePendingLabel = (input) => {
-		if (input === "m") return mcpHandle?.close ? "正在关闭 MCP 服务" : "正在启动 MCP 服务";
-	};
-	const runAction = (label, pendingLabel, action) => {
-		if (running) {
-			const current = currentAction ?? "已有命令";
-			const elapsed = actionStartedAt === void 0 ? "" : `（已运行 ${Math.max(0, Date.now() - actionStartedAt)} ms）`;
-			logger_default.warn(`[dev action] 当前正在${current.replace(REG_PENDING_PREFIX, "")}${elapsed}，已忽略重复请求。`);
-			return;
-		}
-		running = true;
-		actionStartedAt = Date.now();
-		currentAction = pendingLabel;
-		printHint();
-		action().then((summary) => {
-			if (summary) lastAction = summary;
-		}).catch((error) => {
-			logger_default.error(`[dev action] ${label}失败：${error instanceof Error ? error.message : String(error)}`);
-		}).finally(() => {
-			running = false;
-			actionStartedAt = void 0;
-			currentAction = void 0;
-			if (!closed) printHint();
-		});
+		if (input === "m") return mcpHandle?.close ? "正在关闭 MCP 服务" : "正在启动 MCP 服务";
 	};
-	const runBackgroundAction = (label, pendingLabel, action) => {
-		if (running) return;
+	const runAction = (label, pendingLabel, action, quiet = false) => {
+		if (running) {
+			if (quiet) return;
+			const current = currentAction ?? "已有命令";
+			const elapsed = actionStartedAt === void 0 ? "" : `（已运行 ${Math.max(0, Date.now() - actionStartedAt)} ms）`;
+			logger_default.warn(`[dev action] 当前正在${current.replace(REG_PENDING_PREFIX, "")}${elapsed}，已忽略重复请求。`);
+			return;
+		}
 		running = true;
 		actionStartedAt = Date.now();
 		currentAction = pendingLabel;
-		action().then((summary) => {
+		if (!quiet) printHint();
+		actionPromise = action().then((summary) => {
 			if (summary) lastAction = summary;
 		}).catch((error) => {
 			logger_default.error(`[dev action] ${label}失败：${error instanceof Error ? error.message : String(error)}`);
@@ -5648,13 +5267,14 @@ function startDevHotkeys(options) {
 			running = false;
 			actionStartedAt = void 0;
 			currentAction = void 0;
+			if (!closed && !quiet) printHint();
 		});
 	};
 	const handleInput = (input) => {
 		if (closed) return;
 		const normalizedInput = normalizeInputChar(input);
 		if (normalizedInput === "") {
-			close();
+			close().catch((error) => logger_default.error(error));
 			forwardSigint();
 			return;
 		}
@@ -5664,7 +5284,7 @@ function startDevHotkeys(options) {
 		}
 		const normalized = normalizedInput.toLowerCase();
 		if (normalized === "q") {
-			close();
+			close().catch((error) => logger_default.error(error));
 			forwardSigint();
 			return;
 		}
@@ -5714,9 +5334,9 @@ function startDevHotkeys(options) {
 	};
 	process.on("SIGCONT", onSigcont);
 	if (!options.silentStartupHint) printHint();
-	if (resolvedMcp.enabled && resolvedMcp.autoStart) runBackgroundAction("MCP 自动启动", "正在启动 MCP 服务", async () => {
+	if (resolvedMcp.enabled && resolvedMcp.autoStart) runAction("MCP 自动启动", "正在启动 MCP 服务", async () => {
 		await toggleMcp({ silent: true });
-	});
+	}, true);
 	return {
 		close,
 		restore,
@@ -5724,6 +5344,127 @@ function startDevHotkeys(options) {
 	};
 }
 //#endregion
+//#region src/cli/commands/serve/shared.ts
+function startBackgroundForwardConsole(startForwardConsole, options) {
+	if (!startForwardConsole) return;
+	try {
+		startForwardConsole(options).catch((error) => {
+			const message = error instanceof Error ? error.message : String(error);
+			logger_default.warn(`[forwardConsole] 后台启动失败：${message}`);
+		});
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		logger_default.warn(`[forwardConsole] 后台启动失败：${message}`);
+	}
+}
+function resolveServeIdeOpenStrategy(options = {}, fallback = "cli") {
+	return options.openStrategy ?? (options.useAutomatorOpen ? "automator" : fallback);
+}
+function resolveWebHost(host) {
+	if (host === void 0) return;
+	if (typeof host === "boolean") return host;
+	if (typeof host === "string") return host;
+	return String(host);
+}
+/**
+* @description 为 serve 模式构造统一的小程序开发动作，供热键与命令复用。
+*/
+function createServeMiniProgramDevActions(options) {
+	const projectPath = options.projectPath ?? options.fallbackProjectPath;
+	return {
+		projectPath,
+		openIde: async (openOptions = {}) => {
+			if (!openOptions.forceOpen && await options.tryReuseForwardConsole?.()) return "已通过控制台转发复用当前开发者工具会话";
+			await options.openIde(projectPath, openOptions);
+			startBackgroundForwardConsole(options.startForwardConsole, openOptions);
+			return openOptions.forceReopen ? "已重新打开微信开发者工具项目" : "已打开或复用微信开发者工具项目";
+		},
+		rebuild: async () => {
+			await options.build();
+			return "已手动重新构建当前小程序产物";
+		}
+	};
+}
+//#endregion
+//#region src/cli/commands/serve/actions.ts
+/** 启动与热键共用动作，退出后不再创建新的 IDE 或日志消费者。 */
+function createServeDevelopmentActions(ctx, miniBackend, options, shutdown) {
+	const { configService } = ctx;
+	const generatedProjectConfig = configService.multiPlatform.projectConfigs !== void 0;
+	return createServeMiniProgramDevActions({
+		build: async () => {
+			if (!shutdown.stopping) await shutdown.run("startup", () => miniBackend?.driver.dev(ctx, options));
+		},
+		fallbackProjectPath: configService.cwd,
+		openIde: async (projectPath, openOptions) => {
+			if (shutdown.stopping) return;
+			const forceReopen = openOptions?.forceReopen === true;
+			const openStrategy = resolveServeIdeOpenStrategy(openOptions, options.ideOpenStrategy);
+			const useAutomatorOpen = openStrategy === "automator";
+			await openIde(configService.platform, projectPath, {
+				loginRetry: options.loginRetry,
+				loginRetryTimeout: options.loginRetryTimeout,
+				nonInteractive: options.nonInteractive,
+				openRecovery: false,
+				prepareAutomatorSession: useAutomatorOpen,
+				reuseOpenedProject: !forceReopen,
+				skipAutomatorCompile: !forceReopen,
+				skipPostOpenHealthCheck: true,
+				trustProject: options.trustProject,
+				openStrategy,
+				useAutomatorOpen
+			});
+			process.stdout?.write?.("\n");
+		},
+		projectPath: resolveIdeProjectRoot(configService.mpDistRoot, configService.cwd, generatedProjectConfig),
+		startForwardConsole: async (openOptions) => {
+			if (shutdown.stopping) return false;
+			if (resolveServeIdeOpenStrategy(openOptions, options.ideOpenStrategy) === "automator") return await maybeStartForwardConsole({
+				openedOnly: true,
+				preferOpenedSession: true,
+				platform: configService.platform,
+				mpDistRoot: configService.mpDistRoot,
+				cwd: configService.cwd,
+				weappViteConfig: configService.weappViteConfig
+			});
+			return await maybeStartForwardConsole({
+				platform: configService.platform,
+				mpDistRoot: configService.mpDistRoot,
+				cwd: configService.cwd,
+				preferOpenedSession: false,
+				recoverAutomatorSession: async () => {
+					if (shutdown.stopping) return;
+					const projectPath = resolveIdeProjectRoot(configService.mpDistRoot, configService.cwd, generatedProjectConfig);
+					await openIde(configService.platform, projectPath, {
+						loginRetry: options.loginRetry,
+						loginRetryTimeout: options.loginRetryTimeout,
+						nonInteractive: options.nonInteractive,
+						openRecovery: false,
+						openStrategy: "automator",
+						prepareAutomatorSession: true,
+						reuseOpenedProject: false,
+						skipAutomatorCompile: false,
+						skipPostOpenHealthCheck: true,
+						trustProject: options.trustProject,
+						useAutomatorOpen: true
+					});
+				},
+				weappViteConfig: configService.weappViteConfig
+			});
+		},
+		tryReuseForwardConsole: async () => {
+			if (shutdown.stopping) return false;
+			return await maybeStartForwardConsole({
+				openedOnly: true,
+				platform: configService.platform,
+				mpDistRoot: configService.mpDistRoot,
+				cwd: configService.cwd,
+				weappViteConfig: configService.weappViteConfig
+			});
+		}
+	});
+}
+//#endregion
 //#region src/cli/commands/serve/analyze.ts
 const REG_DIST_PAGE_ENTRY = /pages\/.+\/index\.js$/;
 const REG_DIST_POSIX_SEP = /\\/g;
@@ -5838,7 +5579,7 @@ async function analyzeUiFallback(ctx, options) {
 	};
 }
 function createAnalyzeController(options) {
-	const { configFile, ctx, options: cliOptions, targets } = options;
+	const { configFile, ctx, options: cliOptions, targets, shutdown } = options;
 	const { configService } = ctx;
 	let analyzeRunId = 0;
 	let analyzeHandle;
@@ -5889,8 +5630,8 @@ function createAnalyzeController(options) {
 		}
 		return runFallback("完整分析结果为空，已回退到 dist 文件扫描。");
 	};
-	const triggerAnalyzeUpdate = async (reason = "watch") => {
-		if (!analyzeHandle) return;
+	const runAnalyzeUpdate = async (reason) => {
+		if (!analyzeHandle || shutdown?.stopping) return;
 		emitDashboardEvents(analyzeHandle, [{
 			kind: reason === "watch" ? "hmr" : "build",
 			level: "info",
@@ -5899,6 +5640,7 @@ function createAnalyzeController(options) {
 			tags: reason === "watch" ? ["watch", "analyze"] : ["initial", "analyze"]
 		}]);
 		const next = await runAnalyze();
+		if (shutdown?.stopping) return;
 		if (next.mode === "fallback") emitDashboardEvents(analyzeHandle, [{
 			kind: "diagnostic",
 			level: "warning",
@@ -5917,6 +5659,10 @@ function createAnalyzeController(options) {
 			tags: next.mode === "fallback" ? ["analyze", "fallback"] : ["analyze", reason === "watch" ? "refresh" : "initial"]
 		}]);
 	};
+	const triggerAnalyzeUpdate = (reason = "watch") => {
+		if (shutdown?.stopping) return Promise.resolve();
+		return shutdown ? shutdown.run("startup", () => runAnalyzeUpdate(reason)) : runAnalyzeUpdate(reason);
+	};
 	const bindWatcher = (buildResult) => {
 		let initialUpdatePromise;
 		let watchUpdatePending = false;
@@ -5946,6 +5692,7 @@ function createAnalyzeController(options) {
 			return watchUpdatePromise;
 		};
 		if (analyzeHandle && buildResult && typeof buildResult.on === "function") buildResult.on("event", (event) => {
+			if (shutdown?.stopping) return;
 			if (event.code === "ERROR") {
 				emitDashboardEvents(analyzeHandle, [{
 					kind: "diagnostic",
@@ -5969,8 +5716,10 @@ function createAnalyzeController(options) {
 		getHandle: () => analyzeHandle,
 		async startDashboard(startDashboard) {
 			const initialAnalyze = await runAnalyze();
+			if (shutdown?.stopping) return;
 			analyzeHandle = await startDashboard(initialAnalyze.result, {
 				watch: true,
+				uiHost: cliOptions.uiHost,
 				artifacts: initialAnalyze.artifacts,
 				cwd: configService.cwd,
 				packageManagerAgent: configService.packageManager.agent,
@@ -6022,273 +5771,277 @@ function createAnalyzeController(options) {
 	};
 }
 //#endregion
-//#region src/cli/commands/serve/shared.ts
-function startBackgroundForwardConsole(startForwardConsole, options) {
-	if (!startForwardConsole) return;
-	try {
-		startForwardConsole(options).catch((error) => {
-			const message = error instanceof Error ? error.message : String(error);
-			logger_default.warn(`[forwardConsole] 后台启动失败：${message}`);
+//#region src/cli/commands/serve/startup.ts
+/** 启动阶段只取得资源；退出协调器负责等待在途操作并统一释放。 */
+async function startServeCommand(root, options, shutdown) {
+	if (shutdown.stopping) return;
+	filterDuplicateOptions(options);
+	options.uiHost = parseDashboardUiHost(options.uiHost);
+	setCommandNodeEnv("development");
+	const cwd = root ?? process.cwd();
+	const configFile = resolveConfigFile(options);
+	let targets = resolveRuntimeTargets(options);
+	const host = resolveWebHost(options.host);
+	const inlineConfig = createInlineConfig(targets, {
+		scope: options.scope,
+		host,
+		inlineConfig: host === void 0 ? void 0 : { server: { host } }
+	});
+	const ctx = await createCompilerContext({
+		cwd,
+		mode: options.mode ?? "development",
+		isDev: true,
+		configFile,
+		inlineConfig,
+		cliPlatform: targets.rawPlatform,
+		preloadAppEntry: false,
+		syncAutoImportSupportFiles: false,
+		projectConfigPath: options.projectConfig
+	});
+	const { configService } = ctx;
+	targets = resolveConfiguredRuntimeTargets(targets, configService.options?.sourceConfig?.weapp?.platform);
+	for (const backend of targets.select("dev")) shutdown.own(() => backend.driver.close(ctx));
+	if (shutdown.stopping) return;
+	const webBackend = getBackendForCapability(targets, "web", "dev");
+	const miniBackend = getBackendForCapability(targets, "miniprogram", "dev");
+	const aiEnvironment = await detectAiDevelopmentEnvironment();
+	if (shutdown.stopping) return;
+	const mcpConfig = applyMcpCliOptions(configService.weappViteConfig?.mcp, options);
+	logRuntimeTarget(targets, { resolvedConfigPlatform: configService.platform });
+	const enableAnalyze = Boolean(isUiEnabled(options) && miniBackend);
+	let analyzeHandle;
+	const miniProgramDevActions = createServeDevelopmentActions(ctx, miniBackend, options, shutdown);
+	const devHotkeysSession = miniBackend ? startDevHotkeys({
+		cwd: configService.cwd,
+		agentName: aiEnvironment.agentName,
+		isAgent: aiEnvironment.isAgent,
+		mcpConfig,
+		openIde: async () => await miniProgramDevActions.openIde({
+			forceOpen: true,
+			forceReopen: true
+		}),
+		platform: configService.platform,
+		projectPath: miniProgramDevActions.projectPath ?? configService.cwd,
+		rebuild: miniProgramDevActions.rebuild,
+		silentStartupHint: true,
+		weappViteConfig: configService.weappViteConfig
+	}) : void 0;
+	shutdown.own(() => devHotkeysSession?.close());
+	shutdown.own(closeActiveForwardConsole);
+	shutdown.own(() => analyzeHandle?.close());
+	const analyzeController = createAnalyzeController({
+		configFile,
+		ctx,
+		options,
+		targets,
+		shutdown
+	});
+	let webServer;
+	for (const backend of targets.select("dev")) {
+		if (shutdown.stopping) return;
+		if (backend.descriptor.id === "miniprogram") {
+			const miniBuildStartedAt = Date.now();
+			const buildResult = await backend.driver.dev(ctx, options);
+			if (shutdown.stopping) return;
+			const miniBuildDurationMs = Date.now() - miniBuildStartedAt;
+			logger_default.success(`小程序初次构建完成，耗时：${formatDuration(miniBuildDurationMs)}`);
+			shutdown.run("startup", async () => {
+				await ctx.autoImportService?.syncSupportFileResolverComponents().catch((error) => {
+					const message = error instanceof Error ? error.message : String(error);
+					logger_default.warn(`[prepare] 后台同步 .weapp-vite 支持文件失败：${message}`);
+				});
+			});
+			if (enableAnalyze) {
+				await analyzeController.startDashboard(startAnalyzeDashboard);
+				analyzeHandle = analyzeController.getHandle();
+				if (shutdown.stopping) return;
+				analyzeController.emitRuntimeEvents([{
+					kind: "build",
+					level: "success",
+					title: "mini initial build completed",
+					detail: "小程序开发态初次构建已完成，dashboard 可继续监听后续刷新。",
+					durationMs: miniBuildDurationMs,
+					tags: [
+						"dev",
+						"mini",
+						"initial"
+					]
+				}]);
+				await analyzeController.bindWatcher(buildResult).runInitialUpdate();
+				if (shutdown.stopping) return;
+			}
+			continue;
+		}
+		if (backend.descriptor.id !== "web") continue;
+		const webServerStartedAt = Date.now();
+		try {
+			webServer = await backend.driver.dev(ctx, options);
+			if (shutdown.stopping) return;
+			logger_default.success(`Web 开发服务启动完成，耗时：${formatDuration(Date.now() - webServerStartedAt)}`);
+			analyzeController.emitRuntimeEvents([{
+				kind: "system",
+				level: "success",
+				title: "web dev server started",
+				detail: "Web 开发服务器已启动，可与小程序调试 UI 并行工作。",
+				durationMs: Date.now() - webServerStartedAt,
+				tags: ["dev", "web"]
+			}]);
+		} catch (error) {
+			analyzeController.emitRuntimeEvents([{
+				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 (shutdown.stopping) return;
+	if (miniBackend) {
+		logBuildAppFinish(configService, webServer, {
+			skipWeb: !webBackend,
+			uiUrls: analyzeHandle?.urls
 		});
-	} catch (error) {
-		const message = error instanceof Error ? error.message : String(error);
-		logger_default.warn(`[forwardConsole] 后台启动失败：${message}`);
+		devHotkeysSession?.restore();
+	} else if (webBackend) logBuildAppFinish(configService, webServer, { skipMini: true });
+	if (options.open && getBackendForCapability(targets, "miniprogram", "ide")) {
+		analyzeController.emitRuntimeEvents([{
+			kind: "command",
+			level: "info",
+			title: "opening ide",
+			detail: "开发服务已就绪，准备打开 IDE 项目。",
+			tags: ["ide", "open"]
+		}]);
+		devHotkeysSession?.suspend();
+		try {
+			await miniProgramDevActions.openIde({
+				forceOpen: true,
+				forceReopen: false,
+				openStrategy: options.ideOpenStrategy ?? "cli"
+			});
+		} finally {
+			devHotkeysSession?.restore();
+		}
 	}
-}
-function resolveServeIdeOpenStrategy(options = {}, fallback = "cli") {
-	return options.openStrategy ?? (options.useAutomatorOpen ? "automator" : fallback);
-}
-function resolveWebHost(host) {
-	if (host === void 0) return;
-	if (typeof host === "boolean") return host;
-	if (typeof host === "string") return host;
-	return String(host);
-}
-/**
-* @description 为 serve 模式构造统一的小程序开发动作，供热键与命令复用。
-*/
-function createServeMiniProgramDevActions(options) {
-	const projectPath = options.projectPath ?? options.fallbackProjectPath;
 	return {
-		projectPath,
-		openIde: async (openOptions = {}) => {
-			if (!openOptions.forceOpen && await options.tryReuseForwardConsole?.()) return "已通过控制台转发复用当前开发者工具会话";
-			await options.openIde(projectPath, openOptions);
-			startBackgroundForwardConsole(options.startForwardConsole, openOptions);
-			return openOptions.forceReopen ? "已重新打开微信开发者工具项目" : "已打开或复用微信开发者工具项目";
-		},
-		rebuild: async () => {
-			await options.build();
-			return "已手动重新构建当前小程序产物";
-		}
+		watch: targets.has("dev"),
+		waitForExit: analyzeHandle ? () => analyzeController.waitForExit() : void 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);
-	});
-}
 //#endregion
 //#region src/cli/commands/serve/index.ts
-function writePostOpenSeparator() {
-	process.stdout?.write?.("\n");
-}
 function registerServeCommand(cli) {
-	cli.command("[root]", "start dev server").alias("serve").alias("dev").option("--skipNpm", `[boolean] if skip npm build`).option("-o, --open", `[boolean] open ide`).option("-p, --platform <platform>", `[string] target platform (weapp | web | all)`).option("--project-config <path>", `[string] project config path (miniprogram only)`).option("--trust-project", "[boolean] auto trust Wechat DevTools project on open", { default: true }).option("--ide-open-strategy <strategy>", "[string] IDE open strategy (cli | automator)", { default: "cli" }).option("--login-retry <mode>", "[string] login retry mode for Wechat DevTools (never | once | always)").option("--login-retry-timeout <ms>", "[number] login retry prompt timeout in milliseconds").option("--non-interactive", "[boolean] fail immediately when Wechat DevTools login has expired").option("--no-open-recovery", "[boolean] disable automatic Wechat DevTools close-and-reopen recovery").option("--mcp", "[boolean] auto start MCP service during dev").option("--no-mcp", "[boolean] disable MCP service during dev").option("--host [host]", `[string] web dev server host`).option("--ui", `[boolean] 启动调试 UI（当前提供分析视图）`, { default: false }).option("--analyze", `[boolean] 启动分包分析仪表盘 (实验特性)`, { default: false }).option("--scope <scope>", `[string] 局部构建范围，例如 main,packages/order`).action(async (root, options) => {
-		filterDuplicateOptions(options);
-		setCommandNodeEnv("development");
-		const cwd = root ?? process.cwd();
-		const configFile = resolveConfigFile(options);
-		const targets = resolveRuntimeTargets(options);
-		const webBackend = getBackendForCapability(targets, "web", "dev");
-		const host = webBackend ? resolveWebHost(options.host) : void 0;
-		const inlineConfig = createInlineConfig(targets, {
-			scope: options.scope,
-			host
-		});
-		const ctx = await createCompilerContext({
-			cwd,
-			mode: options.mode ?? "development",
-			isDev: true,
-			configFile,
-			inlineConfig,
-			cliPlatform: targets.rawPlatform,
-			preloadAppEntry: false,
-			syncAutoImportSupportFiles: false,
-			projectConfigPath: options.projectConfig
-		});
-		const { configService } = ctx;
-		const miniBackend = getBackendForCapability(targets, "miniprogram", "dev");
-		const aiEnvironment = await detectAiDevelopmentEnvironment();
-		const mcpConfig = applyMcpCliOptions(configService.weappViteConfig?.mcp, options);
-		logRuntimeTarget(targets, { resolvedConfigPlatform: configService.platform });
-		const enableAnalyze = Boolean(isUiEnabled(options) && miniBackend);
-		let analyzeHandle;
-		const miniProgramDevActions = createServeMiniProgramDevActions({
-			build: async () => {
-				await miniBackend?.driver.dev(ctx, options);
-			},
-			fallbackProjectPath: configService.cwd,
-			openIde: async (projectPath, openOptions) => {
-				const forceReopen = openOptions?.forceReopen === true;
-				const openStrategy = resolveServeIdeOpenStrategy(openOptions, options.ideOpenStrategy);
-				const useAutomatorOpen = openStrategy === "automator";
-				await openIde(configService.platform, projectPath, {
-					loginRetry: options.loginRetry,
-					loginRetryTimeout: options.loginRetryTimeout,
-					nonInteractive: options.nonInteractive,
-					openRecovery: false,
-					prepareAutomatorSession: useAutomatorOpen,
-					reuseOpenedProject: !forceReopen,
-					skipAutomatorCompile: !forceReopen,
-					skipPostOpenHealthCheck: true,
-					trustProject: options.trustProject,
-					openStrategy,
-					useAutomatorOpen
-				});
-				writePostOpenSeparator();
-			},
-			projectPath: resolveIdeProjectRoot(configService.mpDistRoot, configService.cwd),
-			startForwardConsole: async (openOptions) => {
-				if (resolveServeIdeOpenStrategy(openOptions, options.ideOpenStrategy) === "automator") return await maybeStartForwardConsole({
-					openedOnly: true,
-					preferOpenedSession: true,
-					platform: configService.platform,
-					mpDistRoot: configService.mpDistRoot,
-					cwd: configService.cwd,
-					weappViteConfig: configService.weappViteConfig
-				});
-				return await maybeStartForwardConsole({
-					platform: configService.platform,
-					mpDistRoot: configService.mpDistRoot,
-					cwd: configService.cwd,
-					preferOpenedSession: false,
-					recoverAutomatorSession: async () => {
-						const projectPath = resolveIdeProjectRoot(configService.mpDistRoot, configService.cwd);
-						await openIde(configService.platform, projectPath, {
-							loginRetry: options.loginRetry,
-							loginRetryTimeout: options.loginRetryTimeout,
-							nonInteractive: options.nonInteractive,
-							openRecovery: false,
-							openStrategy: "automator",
-							prepareAutomatorSession: true,
-							reuseOpenedProject: false,
-							skipAutomatorCompile: false,
-							skipPostOpenHealthCheck: true,
-							trustProject: options.trustProject,
-							useAutomatorOpen: true
-						});
-					},
-					weappViteConfig: configService.weappViteConfig
-				});
-			},
-			tryReuseForwardConsole: async () => {
-				return await maybeStartForwardConsole({
-					openedOnly: true,
-					platform: configService.platform,
-					mpDistRoot: configService.mpDistRoot,
-					cwd: configService.cwd,
-					weappViteConfig: configService.weappViteConfig
-				});
-			}
-		});
-		const devHotkeysSession = miniBackend ? startDevHotkeys({
-			cwd: configService.cwd,
-			agentName: aiEnvironment.agentName,
-			isAgent: aiEnvironment.isAgent,
-			mcpConfig,
-			openIde: async () => await miniProgramDevActions.openIde({
-				forceOpen: true,
-				forceReopen: true
-			}),
-			platform: configService.platform,
-			projectPath: miniProgramDevActions.projectPath ?? configService.cwd,
-			rebuild: miniProgramDevActions.rebuild,
-			silentStartupHint: true,
-			weappViteConfig: configService.weappViteConfig
-		}) : void 0;
+	cli.command("[root]", "start dev server").alias("serve").alias("dev").option("--skipNpm", `[boolean] if skip npm build`).option("-o, --open", `[boolean] open ide`).option("-p, --platform <platform>", `[string] target platform (weapp | web | all)`).option("--project-config <path>", `[string] project config path (miniprogram only)`).option("--trust-project", "[boolean] auto trust Wechat DevTools project on open", { default: true }).option("--ide-open-strategy <strategy>", "[string] IDE open strategy (cli | automator)", { default: "cli" }).option("--login-retry <mode>", "[string] login retry mode for Wechat DevTools (never | once | always)").option("--login-retry-timeout <ms>", "[number] login retry prompt timeout in milliseconds").option("--non-interactive", "[boolean] fail immediately when Wechat DevTools login has expired").option("--no-open-recovery", "[boolean] disable automatic target-project open retry (preserves existing IDE windows)").option("--mcp", "[boolean] auto start MCP service during dev").option("--no-mcp", "[boolean] disable MCP service during dev").option("--host [host]", `[string] web dev server host`).option("--ui", `[boolean] 启动调试 UI（当前提供分析视图）`, { default: false }).option("--ui-host <host>", `[string] 启动调试 UI 并选择宿主（standalone | hub）`).option("--analyze", `[boolean] 启动分包分析仪表盘 (实验特性)`, { default: false }).option("--scope <scope>", `[string] 局部构建范围，例如 main,packages/order`).action(async (root, options) => {
+		const shutdown = createDevShutdownScope({ reportError: (error) => logger_default.error(error) });
+		let failure;
 		try {
-			const analyzeController = createAnalyzeController({
-				configFile,
-				ctx,
-				options,
-				targets
-			});
-			let webServer;
-			for (const backend of targets.select("dev")) {
-				if (backend.descriptor.id === "miniprogram") {
-					const miniBuildStartedAt = Date.now();
-					const buildResult = await backend.driver.dev(ctx, options);
-					const miniBuildDurationMs = Date.now() - miniBuildStartedAt;
-					logger_default.success(`小程序初次构建完成，耗时：${formatDuration(miniBuildDurationMs)}`);
-					ctx.autoImportService?.syncSupportFileResolverComponents().catch((error) => {
-						const message = error instanceof Error ? error.message : String(error);
-						logger_default.warn(`[prepare] 后台同步 .weapp-vite 支持文件失败：${message}`);
-					});
-					if (enableAnalyze) {
-						await analyzeController.startDashboard(startAnalyzeDashboard);
-						analyzeHandle = analyzeController.getHandle();
-						analyzeController.emitRuntimeEvents([{
-							kind: "build",
-							level: "success",
-							title: "mini initial build completed",
-							detail: "小程序开发态初次构建已完成，dashboard 可继续监听后续刷新。",
-							durationMs: miniBuildDurationMs,
-							tags: [
-								"dev",
-								"mini",
-								"initial"
-							]
-						}]);
-						await analyzeController.bindWatcher(buildResult).runInitialUpdate();
-					}
-					continue;
-				}
-				if (backend.descriptor.id !== "web") continue;
-				const webServerStartedAt = Date.now();
-				try {
-					webServer = await backend.driver.dev(ctx, options);
-					logger_default.success(`Web 开发服务启动完成，耗时：${formatDuration(Date.now() - webServerStartedAt)}`);
-					analyzeController.emitRuntimeEvents([{
-						kind: "system",
-						level: "success",
-						title: "web dev server started",
-						detail: "Web 开发服务器已启动，可与小程序调试 UI 并行工作。",
-						durationMs: Date.now() - webServerStartedAt,
-						tags: ["dev", "web"]
-					}]);
-				} catch (error) {
-					analyzeController.emitRuntimeEvents([{
-						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 (miniBackend) {
-				logBuildAppFinish(configService, webServer, {
-					skipWeb: !webBackend,
-					uiUrls: analyzeHandle?.urls
-				});
-				devHotkeysSession?.restore();
-			} else if (webBackend) logBuildAppFinish(configService, webServer, { skipMini: true });
-			if (options.open && getBackendForCapability(targets, "miniprogram", "ide")) {
-				analyzeController.emitRuntimeEvents([{
-					kind: "command",
-					level: "info",
-					title: "opening ide",
-					detail: "开发服务已就绪，准备打开 IDE 项目。",
-					tags: ["ide", "open"]
-				}]);
-				devHotkeysSession?.suspend();
-				try {
-					await miniProgramDevActions.openIde({
-						forceOpen: true,
-						forceReopen: false,
-						openStrategy: options.ideOpenStrategy ?? "cli"
-					});
-				} finally {
-					devHotkeysSession?.restore();
+			const started = await shutdown.run("startup", () => startServeCommand(root, options, shutdown));
+			if (started?.waitForExit) await Promise.race([shutdown.signal, started.waitForExit()]);
+			else if (started?.watch) await shutdown.signal;
+		} catch (error) {
+			failure = error;
+		}
+		await shutdown.close(failure);
+	});
+}
+//#endregion
+//#region src/cli/commands/upload.ts
+async function buildUploadTarget(cwd, platform, options, action, item) {
+	const targets = resolveRuntimeTargets({ platform });
+	const ctx = await createCompilerContext({
+		cwd,
+		mode: options.mode ?? "production",
+		configFile: resolveConfigFile(options),
+		inlineConfig: createInlineConfig(targets),
+		cliPlatform: platform,
+		projectConfigPath: options.projectConfig,
+		emitDefaultAutoImportOutputs: false,
+		preloadAppEntry: false
+	});
+	try {
+		const target = await createUploadTarget(ctx.configService, options, action);
+		if (item) {
+			item.platform = target.platform;
+			item.requestedVersion = target.context.version;
+			item.stage = "build";
+		}
+		logger_default.info(`[${action}:${target.platform}] 构建${target.context.version ? ` ${target.context.version}` : ""}`);
+		await ctx.buildService.build({});
+		return target;
+	} finally {
+		ctx.watcherService.closeAll();
+		terminateStaleSassEmbeddedProcess();
+	}
+}
+async function runUploadCommand(root, options, action = "upload") {
+	filterDuplicateOptions(options);
+	const platforms = resolveUploadPlatforms(options.platform ?? options.p);
+	setCommandNodeEnv("production");
+	const cwd = path$1.resolve(root ?? process.cwd());
+	if (action === "preview") {
+		options = await prepareAutoUploadMetadata(cwd, options, action);
+		for (const platform of platforms) await executeUploadTarget(await buildUploadTarget(cwd, platform, options, action), options, action);
+		return;
+	}
+	const report = {
+		schemaVersion: 1,
+		action: "upload",
+		status: "success",
+		results: platforms.map((platform) => ({
+			platform: platform ?? null,
+			stage: "prepare",
+			status: "not-run"
+		}))
+	};
+	let active = report.results[0];
+	try {
+		const timeoutMs = resolveUploadTimeout(options.timeout);
+		options = await prepareAutoUploadMetadata(cwd, options, action);
+		for (const item of report.results) item.requestedVersion = options.uv?.trim();
+		for (const [index, platform] of platforms.entries()) {
+			active = report.results[index];
+			const target = await buildUploadTarget(cwd, platform, options, action, active);
+			active.stage = "validate";
+			const result = await executeUploadTarget(target, options, action, {
+				timeoutMs,
+				onUpload: () => {
+					active.stage = "upload";
 				}
-			}
-			if (analyzeHandle) await analyzeController.waitForExit();
-			else if (targets.has("dev")) await waitForServeShutdownSignal();
-		} finally {
-			devHotkeysSession?.close();
-			await closeActiveForwardConsole();
-			for (const backend of [...targets.select("dev")].reverse()) await backend.driver.close(ctx);
+			});
+			active.status = options.dryRun ? "dry-run" : "success";
+			if (!options.dryRun) active.result = result;
+		}
+		return report;
+	} catch (error) {
+		report.status = "failed";
+		report.error = error instanceof Error ? error.message : String(error);
+		active.status = "failed";
+		active.error = report.error;
+		if (error instanceof UploadExecutionError) {
+			active.remoteOutcome = error.remoteOutcome;
+			if (error.remoteOutcome === "unknown" && error.reason !== "failed") active.status = "unknown";
 		}
+		throw new UploadCommandError(report);
+	}
+}
+function registerUploadCommand(cli) {
+	cli.command("upload [root]", "build and upload mini programs (does not submit for review or publish)").option("-p, --platform <platform>", "[string] weapp | alipay | tt | xhs | jd | swan; comma-separated targets or all").option("--project-config <path>", "[string] project config path").option("--uv <version>", "[string] upload version (default: weapp.upload.version or package.json version)").option("--desc <text>", "[string] upload description (default: weapp.upload.desc or project name and version)").option("--bump <release>", "[string] increment local package version once (patch | minor | major; dry-run does not write)").option("--git-desc", "[boolean] use the latest Git commit subject as upload description").option("--dry-run", "[boolean] build without validating upload credentials or uploading").option("--json", "[boolean] write one upload report to stdout; send logs to stderr").option("--timeout <seconds>", "[number] local timeout per platform SDK invocation, excluding build").example("wv upload -p weapp").example("wv upload -p xhs,tt --bump patch --git-desc --dry-run").example("wv upload --project ./dist --version 1.2.3 --desc \"release\"  (deprecated IDE syntax; use wv ide upload to retain IDE behavior)").action(async (root, options) => {
+		return runUploadCommand(root, {
+			...options,
+			...readUploadMetadata(cli)
+		});
+	});
+}
+function registerPreviewCommand(cli) {
+	cli.command("preview [root]", "build mini programs and generate preview QR codes or links").option("-p, --platform <platform>", "[string] weapp | alipay | tt | xhs | jd | swan; comma-separated targets or all").option("--project-config <path>", "[string] project config path").option("--desc <text>", "[string] preview description").option("--dry-run", "[boolean] build without validating credentials or generating previews").action(async (root, options) => {
+		await runUploadCommand(root, {
+			...options,
+			...readUploadMetadata(cli)
+		}, "preview");
+		scheduleCompletedProductionBuildExit({}, void 0);
 	});
 }
 //#endregion
@@ -6333,6 +6086,8 @@ const WEAPP_VITE_NATIVE_COMMANDS = /* @__PURE__ */ new Set([
 	"dev",
 	"serve",
 	"build",
+	"upload",
+	"preview",
 	"close",
 	"analyze",
 	"alipay",
@@ -6343,10 +6098,72 @@ const WEAPP_VITE_NATIVE_COMMANDS = /* @__PURE__ */ new Set([
 	"build-npm",
 	"generate",
 	"g",
-	"mcp"
+	"mcp",
+	"accept"
 ]);
+const LEGACY_UPLOAD_OPTIONS = {
+	"--version": true,
+	"-v": true,
+	"--project": true,
+	"--appid": true,
+	"--ext-appid": true,
+	"--info-output": true,
+	"-i": true
+};
+const SDK_UPLOAD_OPTIONS = {
+	"--platform": true,
+	"--uv": true,
+	"--bump": true,
+	"--git-desc": true,
+	"--dry-run": true,
+	"--json": true,
+	"--timeout": true
+};
+const UPLOAD_VALUE_OPTIONS = {
+	...LEGACY_UPLOAD_OPTIONS,
+	"-p": true,
+	"--desc": true,
+	"-d": true,
+	"--platform": true,
+	"--uv": true,
+	"--bump": true,
+	"--timeout": true,
+	"--project-config": true,
+	"--port": true,
+	"--lang": true,
+	"-c": true,
+	"--config": true,
+	"--base": true,
+	"-l": true,
+	"--logLevel": true,
+	"-f": true,
+	"--filter": true,
+	"-m": true,
+	"--mode": true
+};
+/**
+* @description 仅按显式参数区分上传方言，不根据 -p 的值或文件系统猜测后端。
+*/
+function isLegacyUploadInvocation(argv) {
+	let legacyOption;
+	let sdkOption;
+	for (let index = 1; index < argv.length; index += 1) {
+		const token = argv[index];
+		if (token === "--") break;
+		const equalsIndex = token.indexOf("=");
+		const option = equalsIndex === -1 ? token : token.slice(0, equalsIndex);
+		if (LEGACY_UPLOAD_OPTIONS[option] === true) legacyOption = option;
+		if (SDK_UPLOAD_OPTIONS[option.startsWith("--no-") ? `--${option.slice(5)}` : option] === true) sdkOption = option;
+		if (legacyOption && sdkOption) throw new Error(`不能混用微信 IDE 上传参数 ${legacyOption} 与 SDK 上传参数 ${sdkOption}；请使用 wv ide upload 保留 IDE 行为，或使用 wv build --upload 迁移到 SDK。`);
+		if (equalsIndex === -1 && UPLOAD_VALUE_OPTIONS[option] === true) index += 1;
+	}
+	return legacyOption !== void 0;
+}
+function warnLegacyUpload() {
+	logger_default.warn("顶层微信 IDE 上传语法已弃用，将在未来版本移除。请迁移到 wv build --upload -p weapp --uv <version> --desc <description>（SDK 流程需要源码目录与上传凭据，并非 IDE 命令的等价替换）；或使用 wv ide upload ... 保留现有 IDE 行为。");
+}
 /**
-* @description 让 weapp-vite 在未命中自身命令时，回退到 weapp-ide-cli。
+* @description 保留旧版上传方言；其余未命中自身命令的调用回退到 weapp-ide-cli。
 */
 async function tryRunIdeCommand(argv) {
 	const command = argv[0];
@@ -6359,11 +6176,14 @@ async function tryRunIdeCommand(argv) {
 	if (command.startsWith("-")) return false;
 	if (command === "help") {
 		const target = argv[1];
-		if (!target || WEAPP_VITE_NATIVE_COMMANDS.has(target) || !isWeappIdeTopLevelCommand(target)) return false;
+		if (!target || target !== "upload" && WEAPP_VITE_NATIVE_COMMANDS.has(target) || !isWeappIdeTopLevelCommand(target)) return false;
+		if (target === "upload") warnLegacyUpload();
 		await executeWechatIdeCliCommand(argv);
 		return true;
 	}
-	if (WEAPP_VITE_NATIVE_COMMANDS.has(command) || !isWeappIdeTopLevelCommand(command)) return false;
+	const legacyUpload = command === "upload" && isLegacyUploadInvocation(argv);
+	if (!legacyUpload && WEAPP_VITE_NATIVE_COMMANDS.has(command) || !isWeappIdeTopLevelCommand(command)) return false;
+	if (legacyUpload) warnLegacyUpload();
 	if (!await dispatchWechatCliCommand(argv)) await executeWechatIdeCliCommand(argv);
 	return true;
 }
@@ -6450,17 +6270,14 @@ function handlePrepareLifecycleError(args, error) {
 //#endregion
 //#region src/cli.ts
 const cli = cac("weapp-vite");
-try {
-	checkRuntime({
-		bun: "0.0.0",
-		deno: "0.0.0",
-		node: "^20.19.0 || >=22.12.0"
-	});
-} catch {}
 cli.option("-c, --config <file>", `[string] use specified config file`).option("--base <path>", `[string] public base path (default: /)`, { type: [convertBase] }).option("-l, --logLevel <level>", `[string] info | warn | error | silent`).option("--clearScreen", `[boolean] allow/disable clear screen when logging`).option("-d, --debug [feat]", `[string | boolean] show debug logs`).option("-f, --filter <filter>", `[string] filter debug logs`).option("-m, --mode <mode>", `[string] set env mode`);
+registerAcceptCommand(cli);
 registerIdeCommand(cli);
+registerDoctorCommand(cli);
 registerAlipayCommand(cli);
 registerBuildCommand(cli);
+registerUploadCommand(cli);
+registerPreviewCommand(cli);
 registerCloseCommand(cli);
 registerAnalyzeCommand(cli);
 registerInitCommand(cli);
@@ -6479,7 +6296,9 @@ const skipManagedTsconfigBootstrapCommands = /* @__PURE__ */ new Set([
 	"init",
 	"mcp",
 	"npm",
-	"alipay"
+	"alipay",
+	"doctor",
+	"accept"
 ]);
 function resolveManagedTsconfigBootstrapRoot(args) {
 	const [firstArg, secondArg] = args;
@@ -6499,7 +6318,9 @@ function resolveManagedTsconfigBootstrapRoot(args) {
 		"dev",
 		"open",
 		"prepare",
-		"serve"
+		"preview",
+		"serve",
+		"upload"
 	].includes(firstArg)) {
 		if (secondArg && !secondArg.startsWith("-")) return path.resolve(secondArg);
 		return process.cwd();
@@ -6509,11 +6330,19 @@ function resolveManagedTsconfigBootstrapRoot(args) {
 try {
 	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();
+		const runCommand = async () => {
+			const uiHost = Array.isArray(cli.options.uiHost) ? cli.options.uiHost.at(-1) : cli.options.uiHost;
+			parseDashboardUiHost(uiHost);
+			const managedTsconfigBootstrapRoot = resolveManagedTsconfigBootstrapRoot(args);
+			if (managedTsconfigBootstrapRoot) await syncManagedTsconfigBootstrapFiles(managedTsconfigBootstrapRoot);
+			if (cli.matchedCommand?.name === "" && cli.matchedCommandName === void 0) await maybeAutoStartMcpServer(args, cli.options);
+			return cli.runMatchedCommand();
+		};
+		if (cli.matchedCommand?.name === "upload") {
+			await outputUploadReport((Array.isArray(cli.options.json) ? cli.options.json.at(-1) : cli.options.json) === true, runCommand);
+			scheduleCompletedProductionBuildExit({}, void 0);
+		} else await runCommand();
 	}
 } catch (error) {
 	if (!handlePrepareLifecycleError(process.argv.slice(2), error)) {