weapp-vite 6.16.1 → 6.16.3

package/dist/cli.mjs

@@ -1,7 +1,7 @@
-import { C as isPathInside, S as shouldPassPlatformArgToIdeOpen, _ as createCjsConfigLoadError, b as normalizeMiniPlatform, c as createSharedBuildConfig, f as resolveWeappConfigFile, g as parseCommentJson, h as loadViteConfigFile, l as SHARED_CHUNK_VIRTUAL_PREFIX, m as getProjectConfigFileName, n as syncProjectSupportFiles, p as checkRuntime, r as syncManagedTsconfigBootstrapFiles, s as formatBytes, t as createCompilerContext, u as resolveHmrProfileJsonPath, v as DEFAULT_MP_PLATFORM, x as resolveMiniPlatform, y as getDefaultIdeProjectRoot } from "./createContext-C-05IQc1.mjs";
+import { C as isPathInside, S as shouldPassPlatformArgToIdeOpen, _ as createCjsConfigLoadError, b as normalizeMiniPlatform, c as createSharedBuildConfig, f as resolveWeappConfigFile, g as parseCommentJson, h as loadViteConfigFile, l as SHARED_CHUNK_VIRTUAL_PREFIX, m as getProjectConfigFileName, n as syncProjectSupportFiles, p as checkRuntime, r as syncManagedTsconfigBootstrapFiles, s as formatBytes, t as createCompilerContext, u as resolveHmrProfileJsonPath, v as DEFAULT_MP_PLATFORM, x as resolveMiniPlatform, y as getDefaultIdeProjectRoot } from "./createContext-C775dw5P.mjs";
 import { r as logger_default, t as colors } from "./logger-CgxdNjvb.mjs";
-import { h as VERSION } from "./file-BC_RNbAI.mjs";
-import { a as resolveWeappMcpConfig, o as startWeappViteMcpServer } from "./mcp-BzcrPiku.mjs";
+import { h as VERSION } from "./file-CueQM5Yi.mjs";
+import { o as resolveWeappMcpConfig, s as startWeappViteMcpServer } from "./mcp-DV3K2AVD.mjs";
 import { createRequire } from "node:module";
 import path, { posix } from "pathe";
 import { defu } from "@weapp-core/shared";
@@ -14,6 +14,7 @@ import os from "node:os";
 import { execFile } from "node:child_process";
 import { Buffer } from "node:buffer";
 import { cac } from "cac";
+import { brotliCompressSync, gzipSync } from "node:zlib";
 import { resolveCommand } from "package-manager-detector/commands";
 import { RETRY_CANCEL_KEYS, RETRY_CONFIRM_KEYS, bootstrapWechatDevtoolsSettings, buildWechatIdeNpm, clearWechatIdeCache, clearWechatIdeCacheByAutomator, closeSharedMiniProgram, closeWechatIdeProject, compileWechatIdeByAutomator, connectOpenedAutomator, createSharedInputSession, dispatchWechatCliCommand, formatAutomatorLoginError, getConfig, getWechatIdeTestAccounts, getWechatIdeTicket, getWechatIdeToolInfo, isAutomatorLoginError, isWeappIdeTopLevelCommand, isWechatIdeLoginRequiredError, launchAutomator, openWechatIdeProjectByHttp, parse, promptRetryKeypress, promptWechatIdeLoginRetry, quitWechatIde, refreshWechatIdeTicket, resetWechatIdeFileUtilsByHttp, runRetryableCommand, runWechatIdeEngineBuild, runWithSuspendedSharedInput, setWechatIdeTicket, startForwardConsole, takeScreenshot } from "weapp-ide-cli";
 import { promisify } from "node:util";
@@ -122,6 +123,223 @@ async function analyzeHmrProfile(options) {
 	};
 }
 //#endregion
+//#region src/analyze/components/suggestions.ts
+function createComponentSuggestion(usage) {
+	if (usage.componentPackage !== "__main__" || usage.crossPackageUsageCount === 0) return;
+	if (usage.crossPackageUsageCount === usage.placeholderCoveredCrossPackageUsageCount) return;
+	const pagePackages = Array.from(new Set(Array.from(usage.pages.values()).map((page) => page.packageId))).sort((left, right) => {
+		if (left === "__main__") return -1;
+		if (right === "__main__") return 1;
+		return left.localeCompare(right);
+	});
+	const subPackageIds = pagePackages.filter((packageId) => packageId !== "__main__");
+	const usedByMain = pagePackages.includes("__main__");
+	if (subPackageIds.length === 1 && !usedByMain) {
+		const targetPackage = subPackageIds[0];
+		return {
+			kind: "move-to-subpackage",
+			component: usage.component,
+			componentPackage: usage.componentPackage,
+			targetPackage,
+			pagePackages,
+			message: `主包组件 ${usage.component} 仅被分包 ${targetPackage} 使用，建议评估移动到该分包。`
+		};
+	}
+	if (subPackageIds.length > 1) return {
+		kind: "shared-subpackage-or-placeholder",
+		component: usage.component,
+		componentPackage: usage.componentPackage,
+		pagePackages,
+		message: `主包组件 ${usage.component} 被多个分包使用，建议评估分包归属、共享策略或 componentPlaceholder。`
+	};
+	if (usedByMain && subPackageIds.length > 0) return {
+		kind: "split-or-async",
+		component: usage.component,
+		componentPackage: usage.componentPackage,
+		pagePackages,
+		message: `主包组件 ${usage.component} 同时被主包和分包使用，建议评估组件拆分、归属或异步化策略。`
+	};
+}
+//#endregion
+//#region src/analyze/components/index.ts
+function normalizeRoute(value) {
+	return posix.normalize(value.replace(/\\/g, "/").replace(/^\/+/, "").replace(/\.json$/, ""));
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function toStringArray(value) {
+	return Array.isArray(value) ? value.filter((item) => typeof item === "string" && item.trim() !== "") : [];
+}
+function readUsingComponents(config) {
+	if (!isRecord(config) || !isRecord(config.usingComponents)) return [];
+	return Object.entries(config.usingComponents).filter((entry) => typeof entry[1] === "string" && entry[1].trim() !== "");
+}
+function readComponentPlaceholder(config) {
+	if (!isRecord(config) || !isRecord(config.componentPlaceholder)) return /* @__PURE__ */ new Set();
+	return new Set(Object.keys(config.componentPlaceholder));
+}
+function resolveComponentRoute(owner, request) {
+	const normalizedRequest = request.replace(/\\/g, "/").trim();
+	if (!normalizedRequest || normalizedRequest.startsWith("plugin://")) return;
+	if (normalizedRequest.startsWith(".")) return normalizeRoute(posix.join(posix.dirname(owner), normalizedRequest));
+	if (normalizedRequest.startsWith("/")) return normalizeRoute(normalizedRequest);
+	return normalizeRoute(normalizedRequest);
+}
+function resolvePackageId(route, subPackages) {
+	return subPackages.map((item) => item.root).filter(Boolean).sort((left, right) => right.length - left.length).find((root) => route === root || route.startsWith(`${root}/`)) ?? "__main__";
+}
+function collectAppPages(configs) {
+	const appJson = configs.get("app");
+	if (!isRecord(appJson)) return /* @__PURE__ */ new Set();
+	const pages = /* @__PURE__ */ new Set();
+	for (const page of toStringArray(appJson.pages)) pages.add(normalizeRoute(page));
+	const subPackages = Array.isArray(appJson.subPackages) ? appJson.subPackages : Array.isArray(appJson.subpackages) ? appJson.subpackages : [];
+	for (const item of subPackages) {
+		if (!isRecord(item) || typeof item.root !== "string") continue;
+		for (const page of toStringArray(item.pages)) pages.add(normalizeRoute(posix.join(item.root, page)));
+	}
+	return pages;
+}
+function registerUsage(usageMap, edge, page, pagePackage, componentPackage) {
+	const usage = usageMap.get(edge.component) ?? {
+		component: edge.component,
+		componentPackage,
+		totalUsageCount: 0,
+		pages: /* @__PURE__ */ new Map(),
+		crossPackageUsageCount: 0,
+		placeholderCoveredCrossPackageUsageCount: 0
+	};
+	usage.totalUsageCount += 1;
+	const pageUsage = usage.pages.get(page) ?? {
+		page,
+		packageId: pagePackage,
+		usageCount: 0
+	};
+	pageUsage.usageCount += 1;
+	usage.pages.set(page, pageUsage);
+	if (pagePackage !== componentPackage) {
+		usage.crossPackageUsageCount += 1;
+		if (edge.placeholderCovered) usage.placeholderCoveredCrossPackageUsageCount += 1;
+	}
+	usageMap.set(edge.component, usage);
+}
+function collectAnalyzeComponentJsonConfigs(output) {
+	if (!output) return [];
+	const configs = [];
+	for (const item of output.output ?? []) {
+		if (item.type !== "asset" || !item.fileName.endsWith(".json")) continue;
+		const asset = item;
+		if (typeof asset.source !== "string") continue;
+		try {
+			configs.push({
+				file: normalizeRoute(asset.fileName),
+				config: JSON.parse(asset.source)
+			});
+		} catch {}
+	}
+	return configs;
+}
+function analyzeComponentUsage(options) {
+	const configs = /* @__PURE__ */ new Map();
+	for (const item of options.jsonConfigs) configs.set(normalizeRoute(item.file), item.config);
+	const pages = collectAppPages(configs);
+	const graph = /* @__PURE__ */ new Map();
+	const packageMap = /* @__PURE__ */ new Map();
+	for (const route of configs.keys()) packageMap.set(route, resolvePackageId(route, options.subPackages));
+	for (const [owner, config] of configs) {
+		const placeholders = readComponentPlaceholder(config);
+		const edges = readUsingComponents(config).map(([name, request]) => {
+			const component = resolveComponentRoute(owner, request);
+			return component && configs.has(component) ? {
+				owner,
+				component,
+				placeholderCovered: placeholders.has(name)
+			} : void 0;
+		}).filter((edge) => Boolean(edge));
+		if (edges.length > 0) graph.set(owner, edges);
+	}
+	const usageMap = /* @__PURE__ */ new Map();
+	const visit = (owner, page, stack) => {
+		for (const edge of graph.get(owner) ?? []) {
+			const componentPackage = packageMap.get(edge.component) ?? "__main__";
+			registerUsage(usageMap, edge, page, packageMap.get(page) ?? "__main__", componentPackage);
+			if (stack.has(edge.component)) continue;
+			const nextStack = new Set(stack);
+			nextStack.add(edge.component);
+			visit(edge.component, page, nextStack);
+		}
+	};
+	for (const page of pages) visit(page, page, new Set([page]));
+	return Array.from(usageMap.values()).map((usage) => {
+		const pages = Array.from(usage.pages.values()).sort((left, right) => left.page.localeCompare(right.page));
+		const suggestions = [createComponentSuggestion(usage)].filter((item) => Boolean(item));
+		return {
+			component: usage.component,
+			componentPackage: usage.componentPackage,
+			totalUsageCount: usage.totalUsageCount,
+			pageUsageCount: pages.length,
+			pages,
+			suggestions
+		};
+	}).sort((left, right) => {
+		const usageDelta = right.totalUsageCount - left.totalUsageCount;
+		return usageDelta !== 0 ? usageDelta : left.component.localeCompare(right.component);
+	});
+}
+//#endregion
+//#region src/analyze/subpackages/metadata.ts
+const defaultTotalBudgetBytes = 20 * 1024 * 1024;
+const defaultPackageBudgetBytes = 2 * 1024 * 1024;
+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);
+	return {
+		generatedAt: now.toISOString(),
+		budgets: resolveAnalyzeBudgets(configService),
+		history: {
+			...history,
+			dir: configService.relativeCwd(history.dir)
+		}
+	};
+}
+//#endregion
 //#region src/analyze/subpackages/classifier.ts
 const VIRTUAL_MODULE_INDICATOR = "\0";
 const VIRTUAL_PREFIX = `${SHARED_CHUNK_VIRTUAL_PREFIX}/`;
@@ -139,6 +357,10 @@ function resolvePluginAssetAbsolute(normalizedFileName, pluginRoot) {
 	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";
@@ -148,8 +370,8 @@ function classifyPackage(fileName, origin, context) {
 			type: "virtual"
 		};
 	}
-	const rootCandidate = fileName.split("/")[0] ?? "";
-	if (rootCandidate && context.subPackageRoots.has(rootCandidate)) {
+	const rootCandidate = resolveSubPackageRoot$1(fileName, context);
+	if (rootCandidate) {
 		const isIndependent = context.independentRoots.has(rootCandidate);
 		return {
 			id: rootCandidate,
@@ -231,9 +453,17 @@ function registerModuleInPackage(modules, moduleId, source, sourceType, packageI
 }
 //#endregion
 //#region src/analyze/subpackages/output.ts
-function getAssetSize(asset) {
-	if (typeof asset.source === "string") return Buffer.byteLength(asset.source, "utf8");
-	if (asset.source instanceof Uint8Array) return asset.source.byteLength;
+function getAssetBuffer(asset) {
+	if (typeof asset.source === "string") return Buffer.from(asset.source, "utf8");
+	if (asset.source instanceof Uint8Array) return Buffer.from(asset.source);
+}
+function getCompressedSizes$1(content) {
+	if (content === void 0) return {};
+	const buffer = typeof content === "string" ? Buffer.from(content, "utf8") : Buffer.from(content);
+	return {
+		gzipSize: gzipSync(buffer).byteLength,
+		brotliSize: brotliCompressSync(buffer).byteLength
+	};
 }
 function processChunk(chunk, origin, ctx, classifierContext, packages, modules) {
 	const classification = classifyPackage(chunk.fileName, origin, classifierContext);
@@ -243,6 +473,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,
+		...getCompressedSizes$1(chunk.code),
 		isEntry: chunk.isEntry,
 		modules: []
 	};
@@ -267,11 +498,13 @@ function processChunk(chunk, origin, ctx, classifierContext, packages, modules)
 function processAsset(asset, origin, ctx, classifierContext, packages, modules) {
 	const classification = classifyPackage(asset.fileName, origin, classifierContext);
 	const packageEntry = ensurePackage(packages, classification);
+	const assetBuffer = getAssetBuffer(asset);
 	const entry = {
 		file: asset.fileName,
 		type: "asset",
 		from: origin,
-		size: getAssetSize(asset)
+		size: assetBuffer?.byteLength,
+		...getCompressedSizes$1(assetBuffer)
 	};
 	const assetSource = resolveAssetSource(asset.fileName, ctx);
 	if (assetSource) {
@@ -411,22 +644,470 @@ async function analyzeSubpackages(ctx) {
 	const mainOutputs = Array.isArray(mainResult) ? mainResult : [mainResult];
 	const packages = /* @__PURE__ */ new Map();
 	const modules = /* @__PURE__ */ new Map();
-	for (const output of mainOutputs) processOutput(output, "main", ctx, classifierContext, packages, modules);
-	for (const root of independentRoots) processOutput(buildService.getIndependentOutput(root), "independent", ctx, classifierContext, packages, modules);
+	const componentJsonConfigs = [];
+	for (const output of mainOutputs) {
+		processOutput(output, "main", ctx, classifierContext, packages, modules);
+		componentJsonConfigs.push(...collectAnalyzeComponentJsonConfigs(output));
+	}
+	for (const root of independentRoots) {
+		const output = buildService.getIndependentOutput(root);
+		processOutput(output, "independent", ctx, classifierContext, packages, modules);
+		componentJsonConfigs.push(...collectAnalyzeComponentJsonConfigs(output));
+	}
 	expandVirtualModulePlacements(modules, packages, classifierContext);
+	const subPackages = summarizeSubPackages(subPackageMetas);
 	return {
+		metadata: createAnalyzeMetadata(ctx.configService),
 		packages: summarizePackages(packages),
 		modules: summarizeModules(modules),
-		subPackages: summarizeSubPackages(subPackageMetas)
+		subPackages,
+		components: analyzeComponentUsage({
+			jsonConfigs: componentJsonConfigs,
+			subPackages
+		})
 	};
 }
 //#endregion
+//#region src/analyze/subpackages/history.ts
+const jsonExtension = ".json";
+function createSnapshotFileName(date = /* @__PURE__ */ new Date()) {
+	return `${date.toISOString().replace(/[:.]/g, "-")}${jsonExtension}`;
+}
+function isAnalyzeResult(value) {
+	return Boolean(value && typeof value === "object" && Array.isArray(value.packages) && Array.isArray(value.modules) && Array.isArray(value.subPackages));
+}
+async function listSnapshotFiles(dir) {
+	try {
+		return (await fs$2.readdir(dir, { withFileTypes: true })).filter((entry) => entry.isFile() && entry.name.endsWith(jsonExtension)).map((entry) => path.join(dir, entry.name)).sort((a, b) => b.localeCompare(a));
+	} catch {
+		return [];
+	}
+}
+async function trimSnapshotFiles(dir, limit) {
+	const staleFiles = (await listSnapshotFiles(dir)).slice(limit);
+	await Promise.all(staleFiles.map(async (file) => {
+		try {
+			await fs$2.unlink(file);
+		} catch {}
+	}));
+}
+async function readLatestAnalyzeHistorySnapshot(configService) {
+	const history = resolveAnalyzeHistoryMetadata(configService);
+	if (!history.enabled) return null;
+	const files = await listSnapshotFiles(history.dir);
+	for (const file of files) try {
+		const parsed = JSON.parse(await fs$2.readFile(file, "utf8"));
+		if (isAnalyzeResult(parsed)) return parsed;
+	} catch {}
+	return null;
+}
+async function writeAnalyzeHistorySnapshot(result, configService, now = /* @__PURE__ */ new Date()) {
+	const history = resolveAnalyzeHistoryMetadata(configService);
+	if (!history.enabled) return;
+	await fs$2.mkdir(history.dir, { recursive: true });
+	const snapshotPath = path.join(history.dir, createSnapshotFileName(now));
+	if (result.metadata) result.metadata = {
+		...result.metadata,
+		history: {
+			...history,
+			dir: configService.relativeCwd(history.dir),
+			latestSnapshot: configService.relativeCwd(snapshotPath)
+		}
+	};
+	await fs$2.writeFile(snapshotPath, `${JSON.stringify(result, null, 2)}\n`, "utf8");
+	await trimSnapshotFiles(history.dir, history.limit);
+	return snapshotPath;
+}
+//#endregion
+//#region src/analyze/subpackages/report.ts
+function formatAnalyzeBytes(bytes) {
+	if (!bytes || Number.isNaN(bytes)) return "0 B";
+	const units = [
+		"B",
+		"KB",
+		"MB",
+		"GB"
+	];
+	let value = bytes;
+	let unitIndex = 0;
+	while (value >= 1024 && unitIndex < units.length - 1) {
+		value /= 1024;
+		unitIndex++;
+	}
+	return `${value.toFixed(value >= 100 || unitIndex === 0 ? 0 : 2)} ${units[unitIndex]}`;
+}
+function formatDelta(bytes) {
+	if (typeof bytes !== "number" || Number.isNaN(bytes) || bytes === 0) return "无变化";
+	return `${bytes > 0 ? "+" : "-"}${formatAnalyzeBytes(Math.abs(bytes))}`;
+}
+function getFileSize(file) {
+	return file.size ?? 0;
+}
+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 === "ok") return "正常";
+	return `${item.status === "exceeded" ? "超预算" : "接近预算"} ${(item.ratio * 100).toFixed(1)}%`;
+}
+function createActionItems(options) {
+	const actions = [];
+	const exceededItems = options.budgetItems.filter((item) => item.status === "exceeded");
+	const warningItems = options.budgetItems.filter((item) => item.status === "warning");
+	const topDuplicate = options.duplicateInsights.find((item) => item.estimatedSavingBytes > 0);
+	if (exceededItems.length > 0) actions.push(`处理 ${exceededItems[0].label} 预算超限：当前 ${formatAnalyzeBytes(exceededItems[0].currentBytes)}，限制 ${formatAnalyzeBytes(exceededItems[0].limitBytes)}。`);
+	else if (warningItems.length > 0) actions.push(`关注 ${warningItems[0].label} 预算接近阈值：当前 ${(warningItems[0].ratio * 100).toFixed(1)}%。`);
+	if (topDuplicate) actions.push(`优先处理重复模块 ${topDuplicate.source}，估算可节省 ${formatAnalyzeBytes(topDuplicate.estimatedSavingBytes)}。`);
+	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 createAnalyzeIncrementCategorySummary(items) {
+	const map = /* @__PURE__ */ new Map();
+	for (const item of items) {
+		const entry = map.get(item.category) ?? {
+			category: item.category,
+			count: 0,
+			deltaBytes: 0
+		};
+		entry.count += 1;
+		entry.deltaBytes += item.deltaBytes;
+		map.set(item.category, entry);
+	}
+	return [...map.values()].sort((a, b) => b.deltaBytes - a.deltaBytes || b.count - a.count || a.category.localeCompare(b.category));
+}
+function createAnalyzePrMarkdownReport(result, previousResult) {
+	const files = result.packages.flatMap((pkg) => pkg.files.map((file) => ({
+		pkg,
+		file
+	})));
+	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 incrementSummary = createAnalyzeIncrementCategorySummary(incrementItems);
+	const duplicateInsights = createDuplicateModuleInsights(result);
+	const budgetItems = createAnalyzeBudgetCheck(result);
+	const budgetIssues = budgetItems.filter((item) => item.status !== "ok");
+	const actionItems = createActionItems({
+		budgetItems,
+		duplicateInsights
+	}).slice(0, 3);
+	const budgetRows = budgetIssues.slice(0, 5).map((item) => `| ${item.label} | ${formatAnalyzeBytes(item.currentBytes)} | ${formatAnalyzeBytes(item.limitBytes)} | ${formatBudgetStatus(item)} |`).join("\n");
+	const incrementRows = incrementItems.slice(0, 8).map((item) => `| ${item.label} | ${item.category} | ${item.packageLabel} | ${formatAnalyzeBytes(item.deltaBytes)} | ${item.advice} |`).join("\n");
+	const sourceRows = incrementSummary.slice(0, 6).map((item) => `| ${item.category} | ${item.count} | ${formatAnalyzeBytes(item.deltaBytes)} |`).join("\n");
+	const duplicateRows = duplicateInsights.slice(0, 5).map((module) => `| ${module.source} | ${module.packageCount} | ${formatAnalyzeBytes(module.estimatedSavingBytes)} | ${module.advice} |`).join("\n");
+	return [
+		"## weapp-vite analyze PR 摘要",
+		"",
+		`- 总产物体积：${formatAnalyzeBytes(totalBytes)}（较上次 ${formatDelta(typeof previousTotalBytes === "number" ? totalBytes - previousTotalBytes : void 0)}）`,
+		`- 压缩后体积：${formatAnalyzeBytes(compressedBytes)}`,
+		`- 预算告警：${budgetIssues.length}`,
+		`- 增量归因：${incrementItems.length > 0 ? `${incrementItems.length} 项正向增长` : "无正向增长"}`,
+		`- 跨包复用：${duplicateInsights.length}`,
+		"",
+		"### 建议动作",
+		"",
+		...actionItems.map((item) => `- ${item}`),
+		"",
+		"### 预算状态",
+		"",
+		"| 对象 | 当前体积 | 预算 | 状态 |",
+		"| --- | ---: | ---: | --- |",
+		budgetRows || "| - | 0 B | 0 B | 正常 |",
+		"",
+		"### 增量来源",
+		"",
+		"| 来源 | 项数 | 增量 |",
+		"| --- | ---: | ---: |",
+		sourceRows || "| - | 0 | 0 B |",
+		"",
+		"### Top 增量",
+		"",
+		"| 文件/模块 | 来源 | 包 | 增量 | 建议 |",
+		"| --- | --- | --- | ---: | --- |",
+		incrementRows || "| - | - | - | 0 B | - |",
+		"",
+		"### 重复模块",
+		"",
+		"| 模块 | 包数量 | 估算可节省 | 建议 |",
+		"| --- | ---: | ---: | --- |",
+		duplicateRows || "| - | 0 | 0 B | - |",
+		""
+	].join("\n");
+}
+function createAnalyzeMarkdownReport(result, previousResult) {
+	const files = result.packages.flatMap((pkg) => pkg.files.map((file) => ({
+		pkg,
+		file
+	})));
+	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 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 budgets = result.metadata?.budgets;
+	const budgetIssues = budgetItems.filter((item) => item.status !== "ok");
+	const actionItems = createActionItems({
+		budgetItems,
+		duplicateInsights
+	});
+	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 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) : "正常"} |`;
+	}).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");
+	const budgetRows = budgetIssues.map((item) => `| ${item.label} | ${item.scope} | ${formatAnalyzeBytes(item.currentBytes)} | ${formatAnalyzeBytes(item.limitBytes)} | ${formatBudgetStatus(item)} |`).join("\n");
+	const incrementRows = incrementItems.slice(0, 10).map((item) => `| ${item.label} | ${item.category} | ${item.packageLabel} | ${formatAnalyzeBytes(item.deltaBytes)} | ${item.advice} |`).join("\n");
+	const incrementSummaryRows = incrementSummary.slice(0, 8).map((item) => `| ${item.category} | ${item.count} | ${formatAnalyzeBytes(item.deltaBytes)} |`).join("\n");
+	return [
+		"# weapp-vite analyze 报告",
+		"",
+		`生成时间：${result.metadata?.generatedAt ?? (/* @__PURE__ */ new Date()).toISOString()}`,
+		"",
+		"## 本次变化摘要",
+		"",
+		`- 总产物体积：${formatAnalyzeBytes(totalBytes)}`,
+		`- 压缩后体积：${formatAnalyzeBytes(compressedBytes)}`,
+		`- 较上次：${formatDelta(typeof previousTotalBytes === "number" ? totalBytes - previousTotalBytes : void 0)}`,
+		`- 包体数量：${result.packages.length}`,
+		`- 源码模块：${result.modules.length}`,
+		`- 跨包复用：${duplicateInsights.length}`,
+		`- 预算来源：${budgets?.source === "config" ? "配置" : "默认"}`,
+		"",
+		"## 预算告警",
+		"",
+		"| 对象 | 范围 | 当前体积 | 预算 | 状态 |",
+		"| --- | --- | ---: | ---: | --- |",
+		budgetRows || "| - | - | 0 B | 0 B | 正常 |",
+		"",
+		"## 建议动作",
+		"",
+		...actionItems.map((item) => `- ${item}`),
+		"",
+		"## 增量归因",
+		"",
+		"| 来源 | 项数 | 增量 |",
+		"| --- | ---: | ---: |",
+		incrementSummaryRows || "| - | 0 | 0 B |",
+		"",
+		"| 文件/模块 | 来源 | 包 | 增量 | 建议 |",
+		"| --- | --- | --- | ---: | --- |",
+		incrementRows || "| - | - | - | 0 B | - |",
+		"",
+		"## 包体预算",
+		"",
+		"| 包 | 类型 | 体积 | 压缩后 | 较上次 | 预算 |",
+		"| --- | --- | ---: | ---: | ---: | --- |",
+		packageRows || "| - | - | 0 B | 0 B | 无变化 | 正常 |",
+		"",
+		"## Top 文件",
+		"",
+		"| 文件 | 包 | 类型 | 体积 | 压缩后 |",
+		"| --- | --- | --- | ---: | ---: |",
+		topFileRows || "| - | - | - | 0 B | 0 B |",
+		"",
+		"## 重复模块",
+		"",
+		"| 模块 | 来源 | 包数量 | 估算可节省 | 建议 |",
+		"| --- | --- | ---: | ---: | --- |",
+		duplicateRows || "| - | - | 0 | 0 B | - |",
+		""
+	].join("\n");
+}
+//#endregion
 //#region src/cli/analyze/dashboard.ts
 const ANALYZE_GLOBAL_KEY = "__WEAPP_VITE_ANALYZE_RESULT__";
+const PREVIOUS_ANALYZE_GLOBAL_KEY = "__WEAPP_VITE_PREVIOUS_ANALYZE_RESULT__";
 const DASHBOARD_EVENTS_GLOBAL_KEY = "__WEAPP_VITE_DASHBOARD_EVENTS__";
 const ANALYZE_DASHBOARD_PACKAGE_NAME = "@weapp-vite/dashboard";
 const ANALYZE_SSE_PATH = "/__weapp_vite_analyze";
+const FILE_CONTENT_PATH = "/__weapp_vite_file_content";
 const DASHBOARD_EVENT_NAME = "weapp-dashboard:event";
+const MAX_FILE_CONTENT_BYTES = 2 * 1024 * 1024;
 const require = createRequire(import.meta.url);
 function createInstallCommand(agent) {
 	const resolved = resolveCommand(agent ?? "npm", "install", [ANALYZE_DASHBOARD_PACKAGE_NAME]);
@@ -462,6 +1143,18 @@ function resolveDashboardDistRoot(packageRoot, manifest) {
 	if (!fs$1.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$1.existsSync(root) || !fs$1.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;
@@ -475,18 +1168,121 @@ function resolveDashboardRoot(options) {
 		dashboardManifest = void 0;
 	}
 	if (dashboardPackageRoot) {
+		const devResolved = resolveDashboardDevRoot(dashboardPackageRoot, dashboardManifest);
+		if (devResolved) return devResolved;
 		const distResolved = resolveDashboardDistRoot(dashboardPackageRoot, dashboardManifest);
 		if (distResolved) return distResolved;
 	}
 	logger_default.warn(`[weapp-vite ui] 未安装可选仪表盘包 ${colors.bold(colors.green(ANALYZE_DASHBOARD_PACKAGE_NAME))}，已自动降级关闭 dashboard 能力。`);
 	logger_default.info(`如需启用，请执行 ${colors.bold(colors.green(createInstallCommand(options?.packageManagerAgent)))}`);
 }
-function createAnalyzeHtmlPlugin(state, runtimeEvents, onServerInstance, onBroadcastReady) {
+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 createDashboardContentAllowlist(result) {
+	const artifactPaths = /* @__PURE__ */ new Set();
+	const sourcePaths = /* @__PURE__ */ new Set();
+	for (const packageReport of result.packages) for (const file of packageReport.files) {
+		addDashboardAllowedPath(artifactPaths, file.file);
+		addDashboardAllowedPath(sourcePaths, file.source);
+		for (const module of file.modules ?? []) addDashboardAllowedPath(sourcePaths, module.source);
+	}
+	return {
+		artifactPaths,
+		sourcePaths
+	};
+}
+function resolveDashboardContentPath(root, requestPath, options) {
+	if (!root || !requestPath || requestPath.includes("\0")) return;
+	const normalizedRequestPath = normalizeDashboardRelativePath(stripDashboardFileQuery(requestPath));
+	if (path.isAbsolute(normalizedRequestPath)) return;
+	if (!options.allowedPaths.has(normalizedRequestPath)) return;
+	const resolvedRoot = path.resolve(root);
+	const absolutePath = path.resolve(resolvedRoot, normalizedRequestPath);
+	const relativePath = path.relative(resolvedRoot, absolutePath);
+	if (!relativePath) return;
+	if (!options.allowParent && (relativePath.startsWith("..") || path.isAbsolute(relativePath))) return;
+	return {
+		absolutePath,
+		relativePath: options.allowParent ? normalizedRequestPath : normalizeDashboardRelativePath(relativePath)
+	};
+}
+function resolveDashboardFileLanguage(filePath) {
+	const extension = path.extname(filePath).toLowerCase();
+	if (extension === ".js" || extension === ".mjs" || extension === ".cjs" || extension === ".wxs" || extension === ".sjs") return "javascript";
+	if (extension === ".ts" || extension === ".mts" || extension === ".cts") return "typescript";
+	if (extension === ".json" || extension === ".map") return "json";
+	if (extension === ".css" || extension === ".wxss" || extension === ".scss" || extension === ".sass" || extension === ".less") return "css";
+	if (extension === ".vue" || extension === ".wxml" || extension === ".html") return "html";
+	return "plaintext";
+}
+function sendDashboardJson(res, statusCode, payload) {
+	res.statusCode = statusCode;
+	res.setHeader("Content-Type", "application/json; charset=utf-8");
+	res.end(JSON.stringify(payload));
+}
+async function sendDashboardFileContent(res, roots, allowlist, kind, requestPath) {
+	const resolved = resolveDashboardContentPath(kind === "artifact" ? roots.artifactRoot : kind === "source" ? roots.sourceRoot : void 0, requestPath, {
+		allowParent: kind === "source",
+		allowedPaths: kind === "artifact" ? allowlist.artifactPaths : allowlist.sourcePaths
+	});
+	if (!resolved || kind !== "source" && kind !== "artifact") {
+		sendDashboardJson(res, 400, {
+			error: "invalid_request",
+			message: "必须传入合法的 kind 和相对路径。"
+		});
+		return;
+	}
+	try {
+		const stat = await fs$1.promises.stat(resolved.absolutePath);
+		if (!stat.isFile()) {
+			sendDashboardJson(res, 400, {
+				error: "not_file",
+				message: "目标路径不是文件。"
+			});
+			return;
+		}
+		if (stat.size > MAX_FILE_CONTENT_BYTES) {
+			sendDashboardJson(res, 413, {
+				error: "file_too_large",
+				message: `文件超过 ${MAX_FILE_CONTENT_BYTES} 字节，已拒绝读取。`
+			});
+			return;
+		}
+		sendDashboardJson(res, 200, {
+			kind,
+			path: resolved.relativePath,
+			language: resolveDashboardFileLanguage(resolved.relativePath),
+			size: stat.size,
+			content: await fs$1.promises.readFile(resolved.absolutePath, "utf8")
+		});
+	} catch (error) {
+		const code = typeof error === "object" && error && "code" in error ? String(error.code) : "";
+		sendDashboardJson(res, code === "ENOENT" ? 404 : 500, {
+			error: code === "ENOENT" ? "not_found" : "read_failed",
+			message: code === "ENOENT" ? "文件不存在。" : "读取文件失败。"
+		});
+	}
+}
+function createAnalyzeHtmlPlugin(state, runtimeEvents, contentRoots, contentAllowlist, onServerInstance, onBroadcastReady) {
 	const sseClients = /* @__PURE__ */ new Set();
 	const hotBridgeScript = `
     const applyAnalyzePayload = (payload) => {
-      window.${ANALYZE_GLOBAL_KEY} = payload
-      window.dispatchEvent(new CustomEvent('weapp-analyze:update', { detail: payload }))
+      const current = payload?.current ?? payload
+      const previous = payload?.previous ?? window.${PREVIOUS_ANALYZE_GLOBAL_KEY} ?? null
+      window.${ANALYZE_GLOBAL_KEY} = current
+      window.${PREVIOUS_ANALYZE_GLOBAL_KEY} = previous
+      window.dispatchEvent(new CustomEvent('weapp-analyze:update', { detail: { current, previous } }))
     }
     const applyDashboardEvents = (payload) => {
       const events = Array.isArray(payload) ? payload : [payload]
@@ -532,6 +1328,11 @@ function createAnalyzeHtmlPlugin(state, runtimeEvents, onServerInstance, onBroad
 						children: `window.${ANALYZE_GLOBAL_KEY} = ${JSON.stringify(state.current)}`,
 						injectTo: "head-prepend"
 					},
+					{
+						tag: "script",
+						children: `window.${PREVIOUS_ANALYZE_GLOBAL_KEY} = ${JSON.stringify(state.previous)}`,
+						injectTo: "head-prepend"
+					},
 					{
 						tag: "script",
 						children: `window.${DASHBOARD_EVENTS_GLOBAL_KEY} = ${JSON.stringify(runtimeEvents.current)}`,
@@ -557,7 +1358,12 @@ function createAnalyzeHtmlPlugin(state, runtimeEvents, onServerInstance, onBroad
 		configureServer(server) {
 			onServerInstance(server);
 			server.middlewares.use((req, res, next) => {
-				if (req.url !== ANALYZE_SSE_PATH) {
+				const url = new URL(req.url ?? "/", "http://127.0.0.1");
+				if (url.pathname === FILE_CONTENT_PATH) {
+					sendDashboardFileContent(res, contentRoots, contentAllowlist.current, url.searchParams.get("kind"), url.searchParams.get("path"));
+					return;
+				}
+				if (url.pathname !== ANALYZE_SSE_PATH) {
 					next();
 					return;
 				}
@@ -565,7 +1371,7 @@ function createAnalyzeHtmlPlugin(state, runtimeEvents, onServerInstance, onBroad
 				res.setHeader("Content-Type", "text/event-stream");
 				res.setHeader("Cache-Control", "no-cache, no-transform");
 				res.setHeader("Connection", "keep-alive");
-				res.write(`data: ${JSON.stringify(state.current)}\n\n`);
+				res.write(`data: ${JSON.stringify(state)}\n\n`);
 				sseClients.add(res);
 				req.on("close", () => {
 					sseClients.delete(res);
@@ -604,17 +1410,24 @@ async function startAnalyzeDashboard(result, options) {
 	const resolved = resolveDashboardRoot(options);
 	if (!resolved) return;
 	const { root, configFile } = resolved;
-	const state = { current: result };
+	const state = {
+		current: result,
+		previous: options?.previousResult ?? null
+	};
+	const contentAllowlist = { current: createDashboardContentAllowlist(result) };
 	const runtimeEvents = { current: [createDashboardRuntimeEvent({
 		kind: "command",
 		level: "success",
 		title: options?.watch ? "dashboard watch session started" : "dashboard static session started",
 		detail: options?.watch ? "weapp-vite UI 已进入实时分析模式，后续 analyze 结果会继续推送到 dashboard。" : "weapp-vite UI 已进入静态分析模式，当前页面展示的是一次性分析结果。",
 		tags: options?.watch ? ["watch", "analyze"] : ["static", "analyze"]
-	})] };
+	}), ...(options?.initialEvents ?? []).map((event) => createDashboardRuntimeEvent(event))] };
 	let serverRef;
 	let broadcastAnalyzeResult;
-	const plugins = [createAnalyzeHtmlPlugin(state, runtimeEvents, (server) => {
+	const plugins = [createAnalyzeHtmlPlugin(state, runtimeEvents, {
+		artifactRoot: options?.artifactRoot ?? (options?.cwd ? path.resolve(options.cwd, "dist") : void 0),
+		sourceRoot: options?.cwd
+	}, contentAllowlist, (server) => {
 		serverRef = server;
 	}, (broadcast) => {
 		broadcastAnalyzeResult = broadcast;
@@ -648,7 +1461,7 @@ async function startAnalyzeDashboard(result, options) {
 		serverRef.ws.send({
 			type: "custom",
 			event: "weapp-analyze:update",
-			data: state.current
+			data: state
 		});
 		serverRef.ws.send({
 			type: "custom",
@@ -656,7 +1469,7 @@ async function startAnalyzeDashboard(result, options) {
 			data: runtimeEvents.current
 		});
 	}
-	broadcastAnalyzeResult?.(state.current);
+	broadcastAnalyzeResult?.(state);
 	const emitRuntimeEvents = (events) => {
 		if (events.length === 0) return;
 		const nextEvents = events.map((event) => createDashboardRuntimeEvent(event));
@@ -668,8 +1481,10 @@ async function startAnalyzeDashboard(result, options) {
 		});
 	};
 	const handle = {
-		async update(nextResult) {
+		async update(nextResult, previousResult) {
+			state.previous = previousResult ?? state.current;
 			state.current = nextResult;
+			contentAllowlist.current = createDashboardContentAllowlist(nextResult);
 			emitRuntimeEvents([{
 				kind: "build",
 				level: "info",
@@ -680,9 +1495,9 @@ async function startAnalyzeDashboard(result, options) {
 			if (serverRef) serverRef.ws.send({
 				type: "custom",
 				event: "weapp-analyze:update",
-				data: nextResult
+				data: state
 			});
-			broadcastAnalyzeResult?.(nextResult);
+			broadcastAnalyzeResult?.(state);
 		},
 		emitRuntimeEvents,
 		waitForExit: () => waitPromise,
@@ -870,6 +1685,13 @@ function printAnalysisSummary(result) {
 			logger_default.info(`- ${segments.join("，")}`);
 		}
 	}
+	const componentUsages = result.components ?? [];
+	if (componentUsages.length > 0) {
+		const suggestions = componentUsages.flatMap((component) => component.suggestions);
+		logger_default.info(`组件依赖：${componentUsages.length} 个组件，${suggestions.length} 条分包优化建议`);
+		for (const suggestion of suggestions.slice(0, 5)) logger_default.info(`- ${suggestion.message}`);
+		if (suggestions.length > 5) logger_default.info(`- …其余 ${suggestions.length - 5} 条组件建议请使用 ${colors.bold(colors.green("weapp-vite analyze --json"))} 查看`);
+	}
 	const duplicates = result.modules.filter((module) => module.packages.length > 1);
 	if (duplicates.length === 0) {
 		logger_default.info("未检测到跨包复用的源码模块。");
@@ -886,6 +1708,16 @@ 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");
+	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)}%)`);
+	return true;
+}
 function printWebAnalysisSummary(result) {
 	logger_default.success("Web 静态分析完成");
 	logger_default.info(`- 配置状态：${result.web.enabled ? "已启用 weapp.web" : "未启用 weapp.web"}`);
@@ -899,12 +1731,13 @@ function printWebAnalysisSummary(result) {
 	logger_default.warn(`- 未支持范围：${result.unsupportedScopes.join("；")}`);
 	for (const limitation of result.limitations) logger_default.warn(`- 限制：${limitation}`);
 }
-async function writeAnalyzeResult(result, outputOption, configService) {
+async function writeAnalyzeResult(result, outputOption, configService, format = "json", previousResult) {
 	if (!outputOption) return;
 	const baseDir = configService.cwd;
 	const resolvedOutputPath = path.isAbsolute(outputOption) ? outputOption : path.resolve(baseDir, outputOption);
 	await fs.ensureDir(path.dirname(resolvedOutputPath));
-	await fs.writeFile(resolvedOutputPath, `${JSON.stringify(result, null, 2)}\n`, "utf8");
+	const content = format === "markdown" && "packages" in result ? createAnalyzeMarkdownReport(result, previousResult) : format === "pr" && "packages" in result ? createAnalyzePrMarkdownReport(result, previousResult) : JSON.stringify(result, null, 2);
+	await fs.writeFile(resolvedOutputPath, `${content}\n`, "utf8");
 	const relativeOutput = configService.relativeCwd(resolvedOutputPath);
 	logger_default.success(`分析结果已写入 ${colors.green(relativeOutput)}`);
 	return resolvedOutputPath;
@@ -944,10 +1777,15 @@ 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("--output <file>", `[string] 将分析结果写入指定文件（JSON）`).option("-p, --platform <platform>", `[string] target platform (weapp | h5)`).option("--project-config <path>", `[string] project config path (miniprogram only)`).action(async (root, options) => {
+	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("--output <file>", `[string] 将分析结果写入指定文件（JSON 或 Markdown）`).option("-p, --platform <platform>", `[string] target platform (weapp | h5)`).option("--project-config <path>", `[string] project config path (miniprogram only)`).action(async (root, options) => {
 		filterDuplicateOptions(options);
 		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 targets = resolveRuntimeTargets(options);
 		const inlineConfig = createInlineConfig(targets.mpPlatform);
 		try {
@@ -960,7 +1798,7 @@ function registerAnalyzeCommand(cli) {
 				projectConfigPath: options.projectConfig
 			});
 			logRuntimeTarget(targets, {
-				silent: outputJson,
+				silent: outputJson || outputMarkdown,
 				resolvedConfigPlatform: ctx.configService.platform
 			});
 			const outputOption = typeof options.output === "string" ? options.output.trim() : "";
@@ -991,15 +1829,26 @@ function registerAnalyzeCommand(cli) {
 				logger_default.warn("当前命令不支持该平台，请通过 --platform weapp 或 --platform h5 指定目标。");
 				return;
 			}
+			const previousResult = await readLatestAnalyzeHistorySnapshot(ctx.configService);
 			const result = await analyzeSubpackages(ctx);
-			const writtenPath = await writeAnalyzeResult(result, outputOption, ctx.configService);
-			if (outputJson) {
+			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`);
-			} else {
+			}
+			if (budgetCheck ? printBudgetCheckSummary(result) : false) process.exitCode = 1;
+			if (budgetCheck) return;
+			if (!outputPrReport && !outputMarkdown && !outputJson) {
 				printAnalysisSummary(result);
 				await startAnalyzeDashboard(result, {
+					artifactRoot: ctx.configService.outDir,
 					cwd: ctx.configService.cwd,
-					packageManagerAgent: ctx.configService.packageManager.agent
+					packageManagerAgent: ctx.configService.packageManager.agent,
+					previousResult
 				});
 			}
 		} catch (error) {
@@ -1541,20 +2390,33 @@ function registerBuildCommand(cli) {
 				warningBytes: configService.weappViteConfig.packageSizeWarningBytes
 			});
 			if (enableAnalyze) {
+				const analyzeStartedAt = Date.now();
+				const previousAnalyzeResult = await readLatestAnalyzeHistorySnapshot(configService);
 				const analyzeResult = await analyzeSubpackages(ctx);
+				await writeAnalyzeHistorySnapshot(analyzeResult, configService);
+				const analyzeDurationMs = Date.now() - analyzeStartedAt;
 				analyzeHandle = await startAnalyzeDashboard(analyzeResult, {
 					watch: true,
+					artifactRoot: configService.outDir,
 					cwd: configService.cwd,
-					packageManagerAgent: configService.packageManager.agent
+					packageManagerAgent: configService.packageManager.agent,
+					previousResult: previousAnalyzeResult,
+					initialEvents: [{
+						kind: "build",
+						level: "success",
+						title: "mini build completed",
+						detail: `生产构建已完成，当前 analyze 结果包含 ${analyzeResult.packages.length} 个包。`,
+						durationMs: miniBuildDurationMs,
+						tags: ["build", "mini"]
+					}, {
+						kind: "build",
+						level: "success",
+						title: "analyze completed",
+						detail: `分析已完成，当前包含 ${analyzeResult.packages.length} 个包与 ${analyzeResult.modules.length} 个模块。`,
+						durationMs: analyzeDurationMs,
+						tags: ["build", "analyze"]
+					}]
 				}) ?? void 0;
-				emitDashboardEvents$1(analyzeHandle, [{
-					kind: "build",
-					level: "success",
-					title: "mini build completed",
-					detail: `生产构建已完成，当前 analyze 结果包含 ${analyzeResult.packages.length} 个包。`,
-					durationMs: miniBuildDurationMs,
-					tags: ["build", "mini"]
-				}]);
 			}
 		}
 		const webConfig = configService.weappWebConfig;
@@ -2479,6 +3341,7 @@ async function handleServer(options) {
 		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
@@ -2489,7 +3352,7 @@ async function handleServer(options) {
 	})) 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("--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) => {
+	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>");
@@ -2554,18 +3417,24 @@ function resolvePrepareRoot(input) {
 function formatPrepareSkipMessage$1(error) {
 	return `跳过 .weapp-vite 支持文件预生成：${error instanceof Error ? error.message : String(error)}`;
 }
+function resolvePreparePlatform(options) {
+	return typeof options.platform === "string" ? options.platform : typeof options.p === "string" ? options.p : void 0;
+}
 function registerPrepareCommand(cli) {
-	cli.command("prepare [...input]", "generate .weapp-vite support files").action(async (input, options) => {
+	cli.command("prepare [...input]", "generate .weapp-vite support files").option("-p, --platform <platform>", `[string] target platform (weapp | h5)`).action(async (input, options) => {
 		try {
 			filterDuplicateOptions(options);
+			const cwd = path.resolve(resolvePrepareRoot(input));
+			const cliPlatform = resolvePreparePlatform(options);
 			await syncProjectSupportFiles(await createCompilerContext({
-				cwd: path.resolve(resolvePrepareRoot(input)),
+				cwd,
 				isDev: false,
 				mode: typeof options.mode === "string" ? options.mode : "development",
 				configFile: resolveConfigFile(options),
 				configLoader: "native",
 				syncSupportFiles: false,
-				preloadAppEntry: false
+				preloadAppEntry: false,
+				...cliPlatform ? { cliPlatform } : {}
 			}));
 			logger_default.info("已生成 .weapp-vite 支持文件。");
 		} catch (error) {
@@ -2784,7 +3653,7 @@ function resolveRunnableHotkeyDefinition(input) {
 }
 //#endregion
 //#region package.json
-var version = "6.16.1";
+var version = "6.16.3";
 //#endregion
 //#region src/cli/devHotkeys/format.ts
 const FULLWIDTH_ASCII_START = 65281;
@@ -2889,6 +3758,7 @@ function createToggleMcpAction(options) {
 			endpoint: resolvedMcp.endpoint,
 			host: resolvedMcp.host,
 			port: resolvedMcp.port,
+			restEndpoint: resolvedMcp.restEndpoint,
 			transport: "streamable-http",
 			unref: false,
 			workspaceRoot: cwd
@@ -3099,6 +3969,12 @@ async function collectOutputFiles(root) {
 	}
 	return files;
 }
+function getCompressedSizes(content) {
+	return {
+		gzipSize: gzipSync(content).byteLength,
+		brotliSize: brotliCompressSync(content).byteLength
+	};
+}
 async function analyzeUiFallback(ctx) {
 	const { configService, scanService } = ctx;
 	await scanService.loadAppEntry();
@@ -3136,16 +4012,19 @@ async function analyzeUiFallback(ctx) {
 		const relativeFile = path.relative(distRoot, absoluteFile).replace(REG_DIST_POSIX_SEP, "/");
 		const packageInfo = classifyPackage(relativeFile);
 		const stat = await fs$2.stat(absoluteFile);
+		const content = await fs$2.readFile(absoluteFile);
 		ensurePackage(packageInfo.id, packageInfo.type).files.push({
 			file: relativeFile,
 			type: relativeFile.endsWith(".js") ? "chunk" : "asset",
 			from: packageInfo.type === "independent" ? "independent" : "main",
 			size: stat.size,
+			...getCompressedSizes(content),
 			isEntry: relativeFile === "app.js" || REG_DIST_PAGE_ENTRY.test(relativeFile),
 			source: relativeFile.endsWith(".js") ? void 0 : relativeFile
 		});
 	}
 	return {
+		metadata: createAnalyzeMetadata(configService),
 		packages: Array.from(packages.values()).sort((a, b) => {
 			if (a.id === "__main__") return -1;
 			if (b.id === "__main__") return 1;
@@ -3166,6 +4045,7 @@ function createAnalyzeController(options) {
 	let analyzeHandle;
 	const runAnalyze = async () => {
 		const startedAt = Date.now();
+		const previousResult = await readLatestAnalyzeHistorySnapshot(configService);
 		try {
 			const result = await analyzeSubpackages(await createCompilerContext({
 				key: `serve-ui-analyze:${process.pid}:${++analyzeRunId}`,
@@ -3178,23 +4058,33 @@ function createAnalyzeController(options) {
 				projectConfigPath: cliOptions.projectConfig,
 				syncSupportFiles: false
 			}));
-			if (hasAnalyzeData(result)) return {
-				result,
-				durationMs: Date.now() - startedAt,
-				mode: "full"
-			};
+			if (hasAnalyzeData(result)) {
+				await writeAnalyzeHistorySnapshot(result, configService);
+				return {
+					result,
+					previousResult,
+					durationMs: Date.now() - startedAt,
+					mode: "full"
+				};
+			}
 		} catch (error) {
 			const message = error instanceof Error ? error.message : String(error);
 			logger_default.warn(`[ui] 完整分析失败，已回退到 dist 文件扫描：${message}`);
+			const result = await analyzeUiFallback(ctx);
+			await writeAnalyzeHistorySnapshot(result, configService);
 			return {
-				result: await analyzeUiFallback(ctx),
+				result,
+				previousResult,
 				durationMs: Date.now() - startedAt,
 				mode: "fallback",
 				fallbackReason: message
 			};
 		}
+		const result = await analyzeUiFallback(ctx);
+		await writeAnalyzeHistorySnapshot(result, configService);
 		return {
-			result: await analyzeUiFallback(ctx),
+			result,
+			previousResult,
 			durationMs: Date.now() - startedAt,
 			mode: "fallback",
 			fallbackReason: "完整分析结果为空，已回退到 dist 文件扫描。"
@@ -3218,7 +4108,7 @@ function createAnalyzeController(options) {
 			durationMs: next.durationMs,
 			tags: ["analyze", "fallback"]
 		}]);
-		await analyzeHandle.update(next.result);
+		await analyzeHandle.update(next.result, next.previousResult);
 		emitDashboardEvents(analyzeHandle, [{
 			kind: next.mode === "fallback" ? "diagnostic" : "build",
 			level: next.mode === "fallback" ? "warning" : "success",
@@ -3251,9 +4141,23 @@ function createAnalyzeController(options) {
 			const initialAnalyze = await runAnalyze();
 			analyzeHandle = await startDashboard(initialAnalyze.result, {
 				watch: true,
+				artifactRoot: configService.outDir,
 				cwd: configService.cwd,
 				packageManagerAgent: configService.packageManager.agent,
-				silentStartupLog: true
+				silentStartupLog: true,
+				previousResult: initialAnalyze.previousResult,
+				initialEvents: [{
+					kind: initialAnalyze.mode === "fallback" ? "diagnostic" : "build",
+					level: initialAnalyze.mode === "fallback" ? "warning" : "success",
+					title: initialAnalyze.mode === "fallback" ? "initial analyze fallback completed" : "initial analyze completed",
+					detail: initialAnalyze.mode === "fallback" ? initialAnalyze.fallbackReason ?? "完整分析不可用，已回退到 dist 文件扫描。" : `开发态首份 analyze 结果已生成，包含 ${initialAnalyze.result.packages.length} 个包与 ${initialAnalyze.result.modules.length} 个模块。`,
+					durationMs: initialAnalyze.durationMs,
+					tags: initialAnalyze.mode === "fallback" ? [
+						"analyze",
+						"fallback",
+						"initial"
+					] : ["analyze", "initial"]
+				}]
 			}) ?? void 0;
 			emitDashboardEvents(analyzeHandle, [{
 				kind: "command",
@@ -3413,10 +4317,23 @@ function registerServeCommand(cli) {
 			if (targets.runMini) {
 				const miniBuildStartedAt = Date.now();
 				const buildResult = await buildService.build(options);
-				logger_default.success(`小程序初次构建完成，耗时：${formatDuration(Date.now() - miniBuildStartedAt)}`);
+				const miniBuildDurationMs = Date.now() - miniBuildStartedAt;
+				logger_default.success(`小程序初次构建完成，耗时：${formatDuration(miniBuildDurationMs)}`);
 				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();
 				}
 			}
@@ -3583,6 +4500,7 @@ async function maybeAutoStartMcpServer(argv, cliOptions) {
 			endpoint: resolvedMcp.endpoint,
 			host: resolvedMcp.host,
 			port: resolvedMcp.port,
+			restEndpoint: resolvedMcp.restEndpoint,
 			quiet: true,
 			transport: "streamable-http",
 			unref: true,
@@ -3592,6 +4510,7 @@ async function maybeAutoStartMcpServer(argv, cliOptions) {
 		const mcpUrl = `http://${resolvedMcp.host}:${resolvedMcp.port}${resolvedMcp.endpoint}`;
 		logger_default.success("MCP 服务已自动启动：");
 		logger_default.info(`  ➜  ${colors.cyan(mcpUrl)}`);
+		if (resolvedMcp.restEndpoint !== false) logger_default.info(`  REST ➜  ${colors.cyan(`http://${resolvedMcp.host}:${resolvedMcp.port}${resolvedMcp.restEndpoint}`)}`);
 		for (const line of formatMcpQuickStart({
 			httpUrl: mcpUrl,
 			transport: "http"