weapp-vite 6.13.3 → 6.13.4

package/README.md

@@ -95,10 +95,20 @@ function handleClick() {
 
 - 安装依赖后，优先阅读 `node_modules/weapp-vite/dist/docs/README.md`、`node_modules/weapp-vite/dist/docs/mcp.md` 等本地版本文档
 - CLI 同时支持 `weapp-vite` 与 `wv`
-- 需要做小程序截图验收时，优先使用 `weapp-vite screenshot` 或 `wv screenshot`
+- 需要做小程序截图采集时，优先使用 `weapp-vite screenshot` / `wv screenshot`
+- 需要做小程序截图对比验收时，优先使用 `weapp-vite compare` / `wv compare`
 - 不要把小程序运行时截图退化成通用浏览器截图
 - 需要看 DevTools 终端日志时，优先使用 `weapp-vite ide logs --open` 或 `wv ide logs --open`
 
+推荐把下面这组意图映射写进项目根 `AGENTS.md`，让常见 AI 更稳定命中：
+
+- 提到 `截图`、`页面快照`、`runtime screenshot`
+  - 默认使用 `weapp-vite screenshot` / `wv screenshot`
+- 提到 `截图对比`、`diff`、`baseline`、`视觉回归`、`像素对比`
+  - 默认使用 `weapp-vite compare` / `wv compare`
+- 提到 `运行时日志`、`DevTools 日志`
+  - 默认使用 `weapp-vite ide logs --open` / `wv ide logs --open`
+
 `dist/docs` 当前会内置这些文件：
 
 - `README.md`
@@ -123,6 +133,15 @@ weapp-vite screenshot --project ./dist/build/mp-weixin --page pages/index/index
 wv screenshot --project ./dist/build/mp-weixin --page pages/index/index --output .tmp/acceptance.png --json
 ```
 
+推荐的截图对比命令示例：
+
+```sh
+weapp-vite compare --project ./dist/build/mp-weixin --page pages/index/index --baseline .screenshots/baseline/index.png --diff-output .tmp/index.diff.png --max-diff-pixels 100 --json
+
+# 等价写法
+wv compare --project ./dist/build/mp-weixin --page pages/index/index --baseline .screenshots/baseline/index.png --diff-output .tmp/index.diff.png --max-diff-pixels 100 --json
+```
+
 ## DevTools 日志桥接
 
 `weapp-vite` 现在支持把微信开发者工具里的小程序 `console` 输出桥接到当前终端。

package/dist/auto-routes.mjs

@@ -1,4 +1,4 @@
-import { i as getCompilerContext, l as getRouteRuntimeGlobalKeys } from "./createContext-3UhoQl2A.mjs";
+import { i as getCompilerContext, l as getRouteRuntimeGlobalKeys } from "./createContext-Bb4OSo1-.mjs";
 //#region src/auto-routes.ts
 const ROUTE_RUNTIME_OVERRIDE_KEY = Symbol.for("weapp-vite.route-runtime");
 function createGetter(resolver) {

package/dist/cli.mjs

@@ -1,11 +1,10 @@
-import { _ as getDefaultIdeProjectRoot, b as shouldPassPlatformArgToIdeOpen, c as SHARED_CHUNK_VIRTUAL_PREFIX, d as checkRuntime, f as getProjectConfigFileName, g as DEFAULT_MP_PLATFORM, h as createCjsConfigLoadError, m as parseCommentJson, n as syncProjectSupportFiles, o as formatBytes, p as loadViteConfigFile, r as syncManagedTsconfigBootstrapFiles, s as createSharedBuildConfig, t as createCompilerContext, u as resolveWeappConfigFile, v as normalizeMiniPlatform, x as isPathInside, y as resolveMiniPlatform } from "./createContext-3UhoQl2A.mjs";
+import { _ as getDefaultIdeProjectRoot, b as shouldPassPlatformArgToIdeOpen, c as SHARED_CHUNK_VIRTUAL_PREFIX, d as checkRuntime, f as getProjectConfigFileName, g as DEFAULT_MP_PLATFORM, h as createCjsConfigLoadError, m as parseCommentJson, n as syncProjectSupportFiles, o as formatBytes, p as loadViteConfigFile, r as syncManagedTsconfigBootstrapFiles, s as createSharedBuildConfig, t as createCompilerContext, u as resolveWeappConfigFile, v as normalizeMiniPlatform, x as isPathInside, y as resolveMiniPlatform } from "./createContext-Bb4OSo1-.mjs";
 import { r as logger_default, t as colors } from "./logger-gutcwWKE.mjs";
-import { p as VERSION } from "./file-BAUXs16l.mjs";
+import { p as VERSION } from "./file-Cf3pf5w7.mjs";
 import { resolveWeappMcpConfig, startWeappViteMcpServer } from "./mcp.mjs";
 import { createRequire } from "node:module";
-import { defu } from "@weapp-core/shared";
+import { defu, fs } from "@weapp-core/shared";
 import path, { posix } from "pathe";
-import fs from "fs-extra";
 import process from "node:process";
 import fs$1 from "node:fs/promises";
 import { build, createServer } from "vite";
@@ -857,6 +856,14 @@ function registerAnalyzeCommand(cli) {
 	});
 }
 //#endregion
+//#region src/cli/formatDuration.ts
+/**
+* 将毫秒耗时格式化为适合 CLI 展示的文本。
+*/
+function formatDuration(durationMs) {
+	return `${durationMs}ms`;
+}
+//#endregion
 //#region src/cli/logBuildAppFinish.ts
 let logBuildAppFinishOnlyShowOnce = false;
 function collectServerUrls(webServer) {
@@ -942,6 +949,13 @@ function logBuildPackageSizeReport(options) {
 //#endregion
 //#region src/cli/openIde.ts
 const execFileAsync = promisify(execFile);
+async function openWechatIdeByAutomator(projectPath) {
+	const { Launcher } = await import("@weapp-vite/miniprogram-automator");
+	(await new Launcher().launch({
+		projectPath,
+		trustProject: true
+	})).disconnect();
+}
 /**
 * @description 执行 IDE 打开流程，并在登录失效时允许按键重试。
 */
@@ -1001,7 +1015,14 @@ function resolveIdeProjectPath(mpDistRoot) {
 function resolveIdeProjectRoot(mpDistRoot, cwd) {
 	return resolveIdeProjectPath(mpDistRoot) ?? cwd;
 }
-async function openIde(platform, projectPath) {
+async function openIde(platform, projectPath, options = {}) {
+	if (platform === "weapp" && projectPath && options.trustProject !== false) try {
+		await openWechatIdeByAutomator(projectPath);
+		return;
+	} catch (error) {
+		logger_default.warn("通过 automator 启动微信开发者工具并自动信任项目失败，回退到普通 open 流程。");
+		logger_default.error(error);
+	}
 	const argv = ["open", "-p"];
 	if (projectPath) argv.push(projectPath);
 	if (shouldPassPlatformArgToIdeOpen(platform)) argv.push("--platform", platform);
@@ -1085,7 +1106,7 @@ function emitDashboardEvents$1(handle, events) {
 	handle?.emitRuntimeEvents(events);
 }
 function registerBuildCommand(cli) {
-	cli.command("build [root]", "build for production").option("--target <target>", `[string] transpile target (default: 'modules')`).option("--outDir <dir>", `[string] output directory (default: dist)`).option("-p, --platform <platform>", `[string] target platform (weapp | h5 | all)`).option("--project-config <path>", `[string] project config path (miniprogram only)`).option("--sourcemap [output]", `[boolean | "inline" | "hidden"] output source maps for build (default: false)`).option("--minify [minifier]", "[boolean | \"terser\" | \"esbuild\"] enable/disable minification, or specify minifier to use (default: esbuild)").option("--emptyOutDir", `[boolean] force empty outDir when it's outside of root`).option("-w, --watch", `[boolean] rebuilds when modules have changed on disk`).option("--skipNpm", `[boolean] if skip npm build`).option("-o, --open", `[boolean] open ide`).option("--ui", `[boolean] 启动调试 UI（当前提供分析视图）`, { default: false }).option("--analyze", `[boolean] 输出分包分析仪表盘`, { default: false }).action(async (root, options) => {
+	cli.command("build [root]", "build for production").option("--target <target>", `[string] transpile target (default: 'modules')`).option("--outDir <dir>", `[string] output directory (default: dist)`).option("-p, --platform <platform>", `[string] target platform (weapp | h5 | all)`).option("--project-config <path>", `[string] project config path (miniprogram only)`).option("--sourcemap [output]", `[boolean | "inline" | "hidden"] output source maps for build (default: false)`).option("--minify [minifier]", "[boolean | \"terser\" | \"esbuild\"] enable/disable minification, or specify minifier to use (default: esbuild)").option("--emptyOutDir", `[boolean] force empty outDir when it's outside of root`).option("-w, --watch", `[boolean] rebuilds when modules have changed on disk`).option("--skipNpm", `[boolean] if skip npm build`).option("-o, --open", `[boolean] open ide`).option("--trust-project", "[boolean] auto trust Wechat DevTools project on open", { default: true }).option("--ui", `[boolean] 启动调试 UI（当前提供分析视图）`, { default: false }).option("--analyze", `[boolean] 输出分包分析仪表盘`, { default: false }).action(async (root, options) => {
 		filterDuplicateOptions(options);
 		const configFile = resolveConfigFile(options);
 		const targets = resolveRuntimeTargets(options);
@@ -1105,6 +1126,8 @@ function registerBuildCommand(cli) {
 		if (targets.runMini) {
 			const miniBuildStartedAt = Date.now();
 			const output = await buildService.build(options);
+			const miniBuildDurationMs = Date.now() - miniBuildStartedAt;
+			logger_default.success(`小程序构建完成，耗时：${colors.green(formatDuration(miniBuildDurationMs))}`);
 			if (!Array.isArray(output) && "output" in output) logBuildPackageSizeReport({
 				output,
 				subPackageMap: ctx.scanService?.subPackageMap,
@@ -1122,7 +1145,7 @@ function registerBuildCommand(cli) {
 					level: "success",
 					title: "mini build completed",
 					detail: `生产构建已完成，当前 analyze 结果包含 ${analyzeResult.packages.length} 个包。`,
-					durationMs: Date.now() - miniBuildStartedAt,
+					durationMs: miniBuildDurationMs,
 					tags: ["build", "mini"]
 				}]);
 			}
@@ -1132,13 +1155,14 @@ function registerBuildCommand(cli) {
 			const webBuildStartedAt = Date.now();
 			try {
 				await webService?.build();
-				logger_default.success(`Web 构建完成，输出目录：${colors.green(configService.relativeCwd(webConfig.outDir))}`);
+				const webBuildDurationMs = Date.now() - webBuildStartedAt;
+				logger_default.success(`Web 构建完成，输出目录：${colors.green(configService.relativeCwd(webConfig.outDir))}，耗时：${colors.green(formatDuration(webBuildDurationMs))}`);
 				emitDashboardEvents$1(analyzeHandle, [{
 					kind: "build",
 					level: "success",
 					title: "web build completed",
 					detail: `Web 构建已完成，输出目录 ${configService.relativeCwd(webConfig.outDir)}。`,
-					durationMs: Date.now() - webBuildStartedAt,
+					durationMs: webBuildDurationMs,
 					tags: ["build", "web"]
 				}]);
 			} catch (error) {
@@ -1163,7 +1187,7 @@ function registerBuildCommand(cli) {
 				detail: "构建完成后准备打开 IDE 项目。",
 				tags: ["ide", "open"]
 			}]);
-			await openIde(configService.platform, resolveIdeProjectPath(configService.mpDistRoot));
+			await openIde(configService.platform, resolveIdeProjectPath(configService.mpDistRoot), { trustProject: options.trustProject });
 		}
 		if (analyzeHandle) await analyzeHandle.waitForExit();
 		ctx.watcherService?.closeAll();
@@ -1486,12 +1510,25 @@ function sleep(ms) {
 }
 //#endregion
 //#region src/cli/commands/ide.ts
-/**
-* @description 注册 IDE 相关子命令。
-*/
-function registerIdeCommand(cli) {
-	cli.command("ide [action] [root]", "forward Wechat DevTools console logs to terminal").option("-o, --open", "[boolean] open ide before attaching log bridge").option("-p, --platform <platform>", "[string] target platform (weapp | h5)").option("--project-config <path>", "[string] project config path (miniprogram only)").action(async (action, root, options) => {
-		await runIdeCommand(action, root, options);
+async function waitForTermination(cleanup) {
+	await new Promise((resolve) => {
+		const signals = ["SIGINT", "SIGTERM"];
+		let cleaning = false;
+		const handlers = /* @__PURE__ */ new Map();
+		const teardown = async () => {
+			if (cleaning) return;
+			cleaning = true;
+			for (const signal of signals) process.off(signal, handlers.get(signal));
+			await cleanup();
+			resolve();
+		};
+		for (const signal of signals) {
+			const handler = () => {
+				teardown();
+			};
+			handlers.set(signal, handler);
+			process.on(signal, handler);
+		}
 	});
 }
 /**
@@ -1511,7 +1548,7 @@ async function runIdeCommand(action, root, options) {
 	});
 	if (resolved.platform !== "weapp") throw new Error("`weapp-vite ide logs` 当前仅支持微信小程序平台。");
 	if (!resolved.projectPath) throw new Error("无法解析微信开发者工具项目目录，请显式传入 root 或检查 project.config.json。");
-	if (options.open) await openIde(resolved.platform, resolved.projectPath);
+	if (options.open) await openIde(resolved.platform, resolved.projectPath, { trustProject: options.trustProject });
 	const forwardConsoleOptions = await resolveForwardConsoleOptions({
 		...resolved.weappViteConfig,
 		forwardConsole: resolved.weappViteConfig?.forwardConsole === false ? { enabled: true } : {
@@ -1531,25 +1568,12 @@ async function runIdeCommand(action, root, options) {
 		await session.close();
 	});
 }
-async function waitForTermination(cleanup) {
-	await new Promise((resolve) => {
-		const signals = ["SIGINT", "SIGTERM"];
-		let cleaning = false;
-		const teardown = async () => {
-			if (cleaning) return;
-			cleaning = true;
-			for (const signal of signals) process.off(signal, handlers.get(signal));
-			await cleanup();
-			resolve();
-		};
-		const handlers = /* @__PURE__ */ new Map();
-		for (const signal of signals) {
-			const handler = () => {
-				teardown();
-			};
-			handlers.set(signal, handler);
-			process.on(signal, handler);
-		}
+/**
+* @description 注册 IDE 相关子命令。
+*/
+function registerIdeCommand(cli) {
+	cli.command("ide [action] [root]", "forward Wechat DevTools console logs to terminal").option("-o, --open", "[boolean] open ide before attaching log bridge").option("-p, --platform <platform>", "[string] target platform (weapp | h5)").option("--project-config <path>", "[string] project config path (miniprogram only)").option("--trust-project", "[boolean] auto trust Wechat DevTools project on open", { default: true }).action(async (action, root, options) => {
+		await runIdeCommand(action, root, options);
 	});
 }
 //#endregion
@@ -1599,7 +1623,7 @@ function registerNpmCommand(cli) {
 //#endregion
 //#region src/cli/commands/open.ts
 function registerOpenCommand(cli) {
-	cli.command("open [root]").option("-p, --platform <platform>", `[string] target platform (weapp | h5)`).action(async (root, options) => {
+	cli.command("open [root]").option("-p, --platform <platform>", `[string] target platform (weapp | h5)`).option("--trust-project", "[boolean] auto trust Wechat DevTools project on open", { default: true }).action(async (root, options) => {
 		filterDuplicateOptions(options);
 		const configFile = resolveConfigFile(options);
 		const targets = resolveRuntimeTargets(options);
@@ -1610,7 +1634,7 @@ function registerOpenCommand(cli) {
 			projectPath: root,
 			cliPlatform: targets.rawPlatform
 		});
-		await openIde(platform, projectPath ?? resolveIdeProjectRoot(mpDistRoot, process.cwd()));
+		await openIde(platform, projectPath ?? resolveIdeProjectRoot(mpDistRoot, process.cwd()), { trustProject: options.trustProject });
 	});
 }
 //#endregion
@@ -1730,7 +1754,7 @@ async function analyzeUiFallback(ctx) {
 	};
 }
 function registerServeCommand(cli) {
-	cli.command("[root]", "start dev server").alias("serve").alias("dev").option("--skipNpm", `[boolean] if skip npm build`).option("-o, --open", `[boolean] open ide`).option("-p, --platform <platform>", `[string] target platform (weapp | h5 | all)`).option("--project-config <path>", `[string] project config path (miniprogram only)`).option("--host [host]", `[string] web dev server host`).option("--ui", `[boolean] 启动调试 UI（当前提供分析视图）`, { default: false }).option("--analyze", `[boolean] 启动分包分析仪表盘 (实验特性)`, { default: false }).action(async (root, options) => {
+	cli.command("[root]", "start dev server").alias("serve").alias("dev").option("--skipNpm", `[boolean] if skip npm build`).option("-o, --open", `[boolean] open ide`).option("-p, --platform <platform>", `[string] target platform (weapp | h5 | all)`).option("--project-config <path>", `[string] project config path (miniprogram only)`).option("--trust-project", "[boolean] auto trust Wechat DevTools project on open", { default: true }).option("--host [host]", `[string] web dev server host`).option("--ui", `[boolean] 启动调试 UI（当前提供分析视图）`, { default: false }).option("--analyze", `[boolean] 启动分包分析仪表盘 (实验特性)`, { default: false }).action(async (root, options) => {
 		filterDuplicateOptions(options);
 		const configFile = resolveConfigFile(options);
 		const targets = resolveRuntimeTargets(options);
@@ -1852,7 +1876,9 @@ function registerServeCommand(cli) {
 			}]);
 		};
 		if (targets.runMini) {
+			const miniBuildStartedAt = Date.now();
 			const buildResult = await buildService.build(options);
+			logger_default.success(`小程序初次构建完成，耗时：${formatDuration(Date.now() - miniBuildStartedAt)}`);
 			if (enableAnalyze) {
 				const initialAnalyze = await runAnalyze();
 				analyzeHandle = await startAnalyzeDashboard(initialAnalyze.result, {
@@ -1901,6 +1927,7 @@ function registerServeCommand(cli) {
 			const webServerStartedAt = Date.now();
 			try {
 				webServer = await webService?.startDevServer();
+				logger_default.success(`Web 开发服务启动完成，耗时：${formatDuration(Date.now() - webServerStartedAt)}`);
 				emitDashboardEvents(analyzeHandle, [{
 					kind: "system",
 					level: "success",
@@ -1940,7 +1967,7 @@ function registerServeCommand(cli) {
 				mpDistRoot: configService.mpDistRoot,
 				cwd: configService.cwd,
 				weappViteConfig: configService.weappViteConfig
-			})) await openIde(configService.platform, resolveIdeProjectRoot(configService.mpDistRoot, configService.cwd));
+			})) await openIde(configService.platform, resolveIdeProjectRoot(configService.mpDistRoot, configService.cwd), { trustProject: options.trustProject });
 		}
 		if (analyzeHandle) await analyzeHandle.waitForExit();
 	});

package/dist/{config-Dec415jY.d.mts → config-CiuNcUYK.d.mts}

@@ -1290,6 +1290,7 @@ interface RuntimeState {
   };
   wxml: {
     depsMap: Map<string, Set<string>>;
+    importerMap: Map<string, Set<string>>;
     tokenMap: Map<string, ScanWxmlResult>;
     componentsMap: Map<string, ComponentsMap>;
     cache: FileCache<ScanWxmlResult>;
@@ -1298,6 +1299,7 @@ interface RuntimeState {
   scan: {
     subPackageMap: Map<string, SubPackageMetaValue>;
     independentSubPackageMap: Map<string, SubPackageMetaValue>;
+    warnedMessages: Set<string>;
     appEntry?: AppEntry;
     pluginJson?: Plugin;
     pluginJsonPath?: string;
@@ -1355,9 +1357,13 @@ interface WebService {
 //#region src/runtime/wxmlPlugin.d.ts
 interface WxmlService {
   depsMap: Map<string, Set<string>>;
+  importerMap: Map<string, Set<string>>;
   tokenMap: Map<string, ScanWxmlResult>;
   wxmlComponentsMap: Map<string, ComponentsMap>;
   addDeps: (filepath: string, deps?: string[]) => Promise<void>;
+  setDeps: (filepath: string, deps?: string[]) => Promise<void>;
+  collectDepsFromToken: (filepath: string, deps?: ScanWxmlResult['deps']) => string[];
+  getImporters: (filepath: string) => Set<string>;
   getAllDeps: () => Set<string>;
   clearAll: () => void;
   analyze: (wxml: string) => ScanWxmlResult;

package/dist/config.d.mts

@@ -1,2 +1,2 @@
-import { An as createWeappViteHostMeta, Dn as WeappViteHostMeta, En as WEAPP_VITE_HOST_NAME, Mn as resolveWeappViteHostMeta, On as WeappViteRuntime, _ as definePageJson, a as UserConfigFnNoEnvPlain, c as UserConfigFnPromise, d as Component, f as Page, g as defineComponentJson, h as defineAppJson, i as UserConfigFnNoEnv, jn as isWeappViteHost, kn as applyWeappViteHostMeta, l as defineConfig, m as Theme, n as UserConfigExport, nt as WeappViteConfig, o as UserConfigFnObject, p as Sitemap, r as UserConfigFn, s as UserConfigFnObjectPlain, t as UserConfig, u as App, v as defineSitemapJson, y as defineThemeJson } from "./config-Dec415jY.mjs";
+import { An as createWeappViteHostMeta, Dn as WeappViteHostMeta, En as WEAPP_VITE_HOST_NAME, Mn as resolveWeappViteHostMeta, On as WeappViteRuntime, _ as definePageJson, a as UserConfigFnNoEnvPlain, c as UserConfigFnPromise, d as Component, f as Page, g as defineComponentJson, h as defineAppJson, i as UserConfigFnNoEnv, jn as isWeappViteHost, kn as applyWeappViteHostMeta, l as defineConfig, m as Theme, n as UserConfigExport, nt as WeappViteConfig, o as UserConfigFnObject, p as Sitemap, r as UserConfigFn, s as UserConfigFnObjectPlain, t as UserConfig, u as App, v as defineSitemapJson, y as defineThemeJson } from "./config-CiuNcUYK.mjs";
 export { App, Component, Page, Sitemap, Theme, UserConfig, UserConfigExport, UserConfigFn, UserConfigFnNoEnv, UserConfigFnNoEnvPlain, UserConfigFnObject, UserConfigFnObjectPlain, UserConfigFnPromise, WEAPP_VITE_HOST_NAME, WeappViteConfig, WeappViteHostMeta, WeappViteRuntime, applyWeappViteHostMeta, createWeappViteHostMeta, defineAppJson, defineComponentJson, defineConfig, definePageJson, defineSitemapJson, defineThemeJson, isWeappViteHost, resolveWeappViteHostMeta };