weapp-vite 6.14.0 → 6.14.2

package/README.md

@@ -209,7 +209,21 @@ wv ide preview --project ./dist/build/mp-weixin
 `weapp-vite` 已集成 `@weapp-vite/mcp`：
 
 - 默认不自动启动 MCP 服务（可通过配置开启自动启动）
-- 也可以手动启动 MCP Server
+- 优先推荐直接生成客户端配置，而不是手写 MCP 地址
+
+```sh
+wv mcp init codex
+wv mcp init claude-code
+wv mcp init cursor
+```
+
+检查配置是否可用：
+
+```sh
+wv mcp doctor codex
+```
+
+仍然需要手动启动 MCP Server 时：
 
 ```sh
 weapp-vite mcp

package/dist/auto-import-components/resolvers.d.mts

@@ -1,2 +1,2 @@
-import { a as ExternalMetadataFileCandidates, c as Resolver, d as ResolverObject, f as ResolverSupportFilesStrategy, i as CreateResolver, l as ResolverFn, n as VantResolver, o as Options, r as TDesignResolver, s as ResolvedValue, t as WeuiResolver, u as ResolverMeta } from "../index-hN5mdpQ_.mjs";
+import { a as ExternalMetadataFileCandidates, c as Resolver, d as ResolverObject, f as ResolverSupportFilesStrategy, i as CreateResolver, l as ResolverFn, n as VantResolver, o as Options, r as TDesignResolver, s as ResolvedValue, t as WeuiResolver, u as ResolverMeta } from "../index-6QUk3Zbc.mjs";
 export { CreateResolver, ExternalMetadataFileCandidates, Options, ResolvedValue, Resolver, ResolverFn, ResolverMeta, ResolverObject, ResolverSupportFilesStrategy, TDesignResolver, VantResolver, WeuiResolver };

package/dist/auto-import-components/resolvers.mjs

@@ -109,6 +109,7 @@ const TDesignResolver = (opts) => {
 	}, {});
 	return {
 		components: Object.freeze({ ...map }),
+		componentLookupStrategy: "static",
 		supportFilesStrategy,
 		resolve(componentName) {
 			const from = map[componentName];
@@ -241,6 +242,7 @@ const VantResolver = (opts) => {
 	}, {});
 	return {
 		components: Object.freeze({ ...map }),
+		componentLookupStrategy: "static",
 		supportFilesStrategy,
 		resolve(componentName) {
 			const from = map[componentName];
@@ -311,6 +313,7 @@ const WeuiResolver = (opts) => {
 	}, {});
 	return {
 		components: Object.freeze({ ...map }),
+		componentLookupStrategy: "static",
 		supportFilesStrategy,
 		resolve(componentName) {
 			const from = map[componentName];

package/dist/auto-routes.mjs

@@ -1,4 +1,4 @@
-import { i as getCompilerContext, u as getRouteRuntimeGlobalKeys } from "./createContext-BolxgJjC.mjs";
+import { i as getCompilerContext, u as getRouteRuntimeGlobalKeys } from "./createContext-utz68GiW.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,6 +1,6 @@
-import { S as isPathInside, _ as DEFAULT_MP_PLATFORM, b as resolveMiniPlatform, c as createSharedBuildConfig, d as resolveWeappConfigFile, f as checkRuntime, g as createCjsConfigLoadError, h as parseCommentJson, l as SHARED_CHUNK_VIRTUAL_PREFIX, m as loadViteConfigFile, n as syncProjectSupportFiles, p as getProjectConfigFileName, r as syncManagedTsconfigBootstrapFiles, s as formatBytes, t as createCompilerContext, v as getDefaultIdeProjectRoot, x as shouldPassPlatformArgToIdeOpen, y as normalizeMiniPlatform } from "./createContext-BolxgJjC.mjs";
+import { S as isPathInside, _ as DEFAULT_MP_PLATFORM, b as resolveMiniPlatform, c as createSharedBuildConfig, d as resolveWeappConfigFile, f as checkRuntime, g as createCjsConfigLoadError, h as parseCommentJson, l as SHARED_CHUNK_VIRTUAL_PREFIX, m as loadViteConfigFile, n as syncProjectSupportFiles, p as getProjectConfigFileName, r as syncManagedTsconfigBootstrapFiles, s as formatBytes, t as createCompilerContext, v as getDefaultIdeProjectRoot, x as shouldPassPlatformArgToIdeOpen, y as normalizeMiniPlatform } from "./createContext-utz68GiW.mjs";
 import { r as logger_default, t as colors } from "./logger-CgxdNjvb.mjs";
-import { m as VERSION } from "./file-Ej-4GoYg.mjs";
+import { m as VERSION } from "./file-PUFdKeUd.mjs";
 import { a as resolveWeappMcpConfig, o as startWeappViteMcpServer } from "./mcp-DRlj32v4.mjs";
 import { createRequire } from "node:module";
 import { defu, fs } from "@weapp-core/shared";
@@ -8,6 +8,7 @@ import path, { posix } from "pathe";
 import process from "node:process";
 import fs$1 from "node:fs/promises";
 import { build, createServer } from "vite";
+import os from "node:os";
 import { execFile } from "node:child_process";
 import { Buffer } from "node:buffer";
 import fs$2 from "node:fs";
@@ -18,6 +19,8 @@ import { closeSharedMiniProgram, connectOpenedAutomator, formatRetryHotkeyPrompt
 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, setTimeout as setTimeout$1 } from "node:timers";
 import { emitKeypressEvents } from "node:readline";
 //#region src/analyze/subpackages/classifier.ts
 const VIRTUAL_MODULE_INDICATOR = "\0";
@@ -1133,7 +1136,10 @@ function registerBuildCommand(cli) {
 			configFile,
 			inlineConfig,
 			cliPlatform: targets.rawPlatform,
-			projectConfigPath: options.projectConfig
+			projectConfigPath: options.projectConfig,
+			emitDefaultAutoImportOutputs: false,
+			syncSupportFiles: false,
+			preloadAppEntry: false
 		});
 		const { buildService, configService, webService } = ctx;
 		logRuntimeTarget(targets, { resolvedConfigPlatform: configService.platform });
@@ -1604,6 +1610,278 @@ function registerInitCommand(cli) {
 	});
 }
 //#endregion
+//#region src/cli/mcpClient.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 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
+	};
+}
+function resolveSupportedMcpClient(input) {
+	if (input === "codex" || input === "claude-code" || input === "cursor") return input;
+	throw new Error(`不支持的 MCP 客户端：${input}。当前仅支持 codex、claude-code、cursor。`);
+}
+function buildMcpClientConfigPlan(options) {
+	const workspaceRoot = path.resolve(options.workspaceRoot);
+	const target = resolveTarget(options.client, workspaceRoot);
+	const entry = options.transport === "http" ? resolveHttpEntry(options.client, options.url ?? "") : resolveCommandEntry(options.client, workspaceRoot);
+	if (options.transport === "http" && !entry.url) throw new Error("HTTP 模式缺少 MCP 服务地址，请使用 --url 指定或在当前项目中检测到可用地址。");
+	return {
+		entry,
+		preview: target.client === "codex" ? renderCodexBlock(target.serverName, entry) : renderJsonPreview(target.serverName, entry),
+		target,
+		transport: options.transport
+	};
+}
+async function writeMcpClientConfig(plan) {
+	await fs.ensureDir(path.dirname(plan.target.configPath));
+	const existing = await fs.readFile(plan.target.configPath, "utf8").catch(() => "");
+	if (plan.target.client === "codex") {
+		const nextContent = upsertCodexManagedBlock(existing, plan.target.serverName, plan.preview);
+		await fs.writeFile(plan.target.configPath, nextContent, "utf8");
+		return;
+	}
+	const parsed = parseJsonConfig(existing, plan.target.configPath);
+	const nextConfig = {
+		...parsed,
+		mcpServers: {
+			...parsed.mcpServers ?? {},
+			[plan.target.serverName]: plan.entry
+		}
+	};
+	await fs.writeFile(plan.target.configPath, `${JSON.stringify(nextConfig, null, 2)}\n`, "utf8");
+}
+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(timer);
+		controller.abort();
+	}
+}
+async function inspectJsonConfig(target) {
+	if (!await fs.pathExists(target.configPath)) return {
+		configExists: false,
+		configPath: target.configPath,
+		displayName: target.displayName,
+		issues: [`未找到配置文件：${target.configPath}`],
+		serverName: target.serverName
+	};
+	const entry = parseJsonConfig(await fs.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.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.pathExists(target.configPath)) return {
+		configExists: false,
+		configPath: target.configPath,
+		displayName: target.displayName,
+		issues: [`未找到配置文件：${target.configPath}`],
+		serverName: target.serverName
+	};
+	const blockMatch = (await fs.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.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);
+}
+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/commands/mcp.ts
 function resolvePort(port) {
 	if (typeof port === "number" && Number.isInteger(port)) return port;
@@ -1612,17 +1890,109 @@ function resolvePort(port) {
 		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 resolved = resolveWeappMcpConfig((await loadConfig(resolveConfigFile(options)))?.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;
+	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;
+	await startWeappViteMcpServer({
+		endpoint: options.endpoint,
+		host: options.host,
+		port: resolvePort(options.port),
+		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", "start weapp-vite MCP server").option("--transport <type>", "[string] stdio | streamable-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("--workspace-root <path>", "[string] workspace root path, defaults to auto detect from cwd").action(async (options) => {
-		const { startWeappViteMcpServer } = await import("./mcp.mjs");
-		await startWeappViteMcpServer({
-			endpoint: options.endpoint,
-			host: options.host,
-			port: resolvePort(options.port),
-			transport: options.transport,
-			unref: options.unref,
-			workspaceRoot: options.workspaceRoot
-		});
+	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) => {
+		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
@@ -1682,10 +2052,10 @@ function registerPrepareCommand(cli) {
 }
 //#endregion
 //#region package.json
-var version = "6.14.0";
+var version = "6.14.2";
 //#endregion
 //#region src/cli/devHotkeys.ts
-const DEV_SCREENSHOT_DIR = ".tmp/weapp-vite-dev-screenshots";
+const DEV_SCREENSHOT_DIR = ".weapp-vite/dev-screenshots";
 const DEFAULT_SCREENSHOT_TIMEOUT = 3e4;
 const REG_PENDING_PREFIX = /^正在/;
 const FULLWIDTH_ASCII_START = 65281;
@@ -1917,6 +2287,10 @@ function startDevHotkeys(options) {
 			workspaceRoot: options.cwd
 		});
 		logger_default.success(`[dev action] MCP 服务已启动：${colors.cyan(url)}`);
+		for (const line of formatMcpQuickStart({
+			httpUrl: url,
+			transport: "http"
+		})) logger_default.info(line);
 		return `MCP 已启动 (${url})`;
 	};
 	const runAction = (label, pendingLabel, action) => {
@@ -2467,6 +2841,10 @@ async function maybeAutoStartMcpServer(argv, cliOptions) {
 		const mcpUrl = `http://${resolvedMcp.host}:${resolvedMcp.port}${resolvedMcp.endpoint}`;
 		logger_default.success("MCP 服务已自动启动：");
 		logger_default.info(`  ➜  ${colors.cyan(mcpUrl)}`);
+		for (const line of formatMcpQuickStart({
+			httpUrl: mcpUrl,
+			transport: "http"
+		})) logger_default.info(line);
 	} catch (error) {
 		const message = error instanceof Error ? error.message : String(error);
 		if (REG_EADDRINUSE.test(message)) {

package/dist/{config-bkgtM4wZ.d.mts → config-BHVrIbhx.d.mts}

@@ -1,4 +1,4 @@
-import { c as Resolver, s as ResolvedValue } from "./index-hN5mdpQ_.mjs";
+import { c as Resolver, s as ResolvedValue } from "./index-6QUk3Zbc.mjs";
 import { t as AutoRoutes } from "./routes-DiEBrMtj.mjs";
 import { LRUCache } from "lru-cache";
 import { LoggerConfig } from "@weapp-core/logger";
@@ -351,6 +351,7 @@ interface ScanWxmlOptions {
  * @description WXML 处理阶段配置
  */
 interface HandleWxmlOptions {
+  defineImportMetaEnv?: Record<string, any>;
   removeComment?: boolean;
   transformEvent?: boolean;
   scriptModuleExtension?: string;
@@ -413,7 +414,7 @@ interface WeappInjectWeapiConfig {
   replaceWx?: boolean;
   globalName?: string;
 }
-type WeappInjectRequestGlobalsTarget = 'fetch' | 'Headers' | 'Request' | 'Response' | 'AbortController' | 'AbortSignal' | 'XMLHttpRequest';
+type WeappInjectRequestGlobalsTarget = 'fetch' | 'Headers' | 'Request' | 'Response' | 'AbortController' | 'AbortSignal' | 'XMLHttpRequest' | 'WebSocket';
 /**
  * @description 请求相关全局对象注入配置
  */
@@ -1022,6 +1023,7 @@ interface LoadConfigOptions {
   cwd: string;
   isDev: boolean;
   mode: string;
+  emitDefaultAutoImportOutputs?: boolean;
   pluginOnly?: boolean;
   inlineConfig?: InlineConfig;
   configFile?: string;
@@ -1037,6 +1039,7 @@ interface LoadConfigResult {
   cwd: string;
   isDev: boolean;
   mode: string;
+  emitDefaultAutoImportOutputs: boolean;
   chunksConfigured?: boolean;
   projectConfig: Record<string, any>;
   projectConfigPath?: string;
@@ -1085,6 +1088,7 @@ interface ConfigService {
   readonly defineImportMetaEnv: Record<string, any>;
   readonly cwd: string;
   readonly isDev: boolean;
+  readonly emitDefaultAutoImportOutputs: boolean;
   readonly mpDistRoot: string;
   readonly outDir: string;
   readonly inlineConfig: InlineConfig;
@@ -1202,7 +1206,18 @@ interface RemovalRange {
   end: number;
 }
 interface WxmlToken {
+  /**
+   * @description 参与常规组件分析的标签集合。
+   * 会应用 `excludeComponent` 过滤，通常会排除宿主内置组件，
+   * 供原有的 `usingComponents` 推断与模板依赖聚合使用。
+   */
   components: ComponentsMap;
+  /**
+   * @description 供自动导入使用的完整标签集合。
+   * 不会因为“这是宿主内置组件名”而被提前过滤，
+   * 用来支持“本地组件与内置组件重名时仍优先命中用户组件”的场景。
+   */
+  autoImportComponents?: ComponentsMap;
   deps: WxmlDep[];
   removalRanges: RemovalRange[];
   commentTokens: Token[];
@@ -1269,6 +1284,7 @@ interface RuntimeState {
     resolvedResolverComponents: Map<string, string>;
     matcher?: (input: string) => boolean;
     matcherKey: string;
+    version: number;
   };
   build: {
     queue: PQueue;
@@ -1279,10 +1295,15 @@ interface RuntimeState {
   };
   json: {
     cache: FileCache<any>;
+    emittedSource: Map<string, string>;
+  };
+  asset: {
+    emittedBuffer: Map<string, Buffer>;
   };
   css: {
     importerToDependencies: Map<string, Set<string>>;
     dependencyToImporters: Map<string, Set<string>>;
+    emittedSource: Map<string, string>;
   };
   watcher: {
     rollupWatcherMap: Map<string, WatcherInstance>;
@@ -1293,6 +1314,8 @@ interface RuntimeState {
     importerMap: Map<string, Set<string>>;
     tokenMap: Map<string, ScanWxmlResult>;
     componentsMap: Map<string, ComponentsMap>;
+    aggregatedComponentsMap: Map<string, ComponentsMap>;
+    templatePathMap: Map<string, string>;
     cache: FileCache<ScanWxmlResult>;
     emittedCode: Map<string, string>;
   };
@@ -1359,12 +1382,23 @@ interface WxmlService {
   depsMap: Map<string, Set<string>>;
   importerMap: Map<string, Set<string>>;
   tokenMap: Map<string, ScanWxmlResult>;
+  /**
+   * @description 常规组件索引缓存。
+   * 这里沿用历史行为，只保留“应参与 usingComponents 推断”的组件标签。
+   */
   wxmlComponentsMap: Map<string, ComponentsMap>;
+  /**
+   * @description 常规组件聚合缓存。
+   * 会递归合并 import/include 进来的模板组件，但仍遵循内置组件过滤规则。
+   */
+  aggregatedComponentsMap: 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>;
+  getAggregatedComponents: (filepathOrBaseName: string) => ComponentsMap | undefined;
+  getAggregatedAutoImportComponents: (filepathOrBaseName: string) => ComponentsMap | undefined;
   clearAll: () => void;
   analyze: (wxml: string) => ScanWxmlResult;
   scan: (filepath: string) => Promise<ScanWxmlResult | undefined>;
@@ -1379,6 +1413,8 @@ interface ResolverAutoImportMatch {
 type AutoImportMatch = LocalAutoImportMatch | ResolverAutoImportMatch;
 interface AutoImportService {
   reset: () => void;
+  getVersion: () => number;
+  runInBatch: <T>(task: () => T | Promise<T>) => Promise<T>;
   registerPotentialComponent: (filePath: string) => Promise<void>;
   removePotentialComponent: (filePath: string) => void;
   resolve: (componentName: string, importerBaseName?: string) => AutoImportMatch | undefined;

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-bkgtM4wZ.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-BHVrIbhx.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 };

package/dist/config.mjs

@@ -1,4 +1,4 @@
-import { a as defineThemeJson, i as defineSitemapJson, n as defineComponentJson, r as definePageJson, t as defineAppJson } from "./json-D0HkutE0.mjs";
-import { a as resolveWeappViteHostMeta, i as isWeappViteHost, n as applyWeappViteHostMeta, r as createWeappViteHostMeta, t as WEAPP_VITE_HOST_NAME } from "./pluginHost-SJdl15d3.mjs";
-import { t as defineConfig } from "./config-DJjSbpNX.mjs";
+import { a as defineThemeJson, i as defineSitemapJson, n as defineComponentJson, r as definePageJson, t as defineAppJson } from "./json-wnfVS9jE.mjs";
+import { a as resolveWeappViteHostMeta, i as isWeappViteHost, n as applyWeappViteHostMeta, r as createWeappViteHostMeta, t as WEAPP_VITE_HOST_NAME } from "./pluginHost-BzPJL4F-.mjs";
+import { t as defineConfig } from "./config-B2xtjEug.mjs";
 export { WEAPP_VITE_HOST_NAME, applyWeappViteHostMeta, createWeappViteHostMeta, defineAppJson, defineComponentJson, defineConfig, definePageJson, defineSitemapJson, defineThemeJson, isWeappViteHost, resolveWeappViteHostMeta };