weapp-vite 7.4.0 → 7.6.0

package/dist/loadConfig-BWIsDXR4.mjs

@@ -0,0 +1,59 @@
+import { A as createCjsConfigLoadError, C as loadViteConfigFile, t as resolveWeappConfigFile } from "./utils-Dy51PYAC.mjs";
+import process from "node:process";
+import path from "pathe";
+import { defu } from "@weapp-core/shared";
+//#region src/cli/loadConfig.ts
+async function loadConfig(configFile) {
+	const cwd = process.cwd();
+	let resolvedConfigFile = configFile;
+	if (resolvedConfigFile && !path.isAbsolute(resolvedConfigFile)) resolvedConfigFile = path.resolve(cwd, resolvedConfigFile);
+	const configEnv = {
+		command: "serve",
+		mode: "development"
+	};
+	let loaded;
+	try {
+		loaded = await loadViteConfigFile(configEnv, resolvedConfigFile, cwd, void 0, void 0, "runner");
+	} catch (error) {
+		const cjsError = createCjsConfigLoadError({
+			error,
+			configPath: resolvedConfigFile,
+			cwd
+		});
+		if (cjsError) throw cjsError;
+		throw error;
+	}
+	const weappConfigFilePath = await resolveWeappConfigFile({
+		root: cwd,
+		specified: resolvedConfigFile
+	});
+	let weappLoaded;
+	if (weappConfigFilePath) {
+		const normalizedWeappPath = path.resolve(weappConfigFilePath);
+		const normalizedLoadedPath = loaded?.path ? path.resolve(loaded.path) : void 0;
+		if (normalizedLoadedPath && normalizedLoadedPath === normalizedWeappPath) weappLoaded = loaded;
+		else try {
+			weappLoaded = await loadViteConfigFile(configEnv, weappConfigFilePath, cwd, void 0, void 0, "runner");
+		} catch (error) {
+			const cjsError = createCjsConfigLoadError({
+				error,
+				configPath: weappConfigFilePath,
+				cwd
+			});
+			if (cjsError) throw cjsError;
+			throw error;
+		}
+	}
+	if (!loaded && !weappLoaded) return;
+	const config = weappLoaded?.config ? defu(weappLoaded.config, loaded?.config ?? {}) : loaded?.config ?? {};
+	const dependencySet = /* @__PURE__ */ new Set();
+	for (const dependency of loaded?.dependencies ?? []) dependencySet.add(dependency);
+	for (const dependency of weappLoaded?.dependencies ?? []) dependencySet.add(dependency);
+	return {
+		config,
+		path: weappLoaded?.path ?? loaded?.path ?? resolvedConfigFile,
+		dependencies: Array.from(dependencySet)
+	};
+}
+//#endregion
+export { loadConfig as t };

package/dist/loadConfig-D-BpBgsk.mjs

@@ -0,0 +1 @@
+export { t as loadConfig } from "./loadConfig-BWIsDXR4.mjs";

package/dist/logBuildAppFinish-ChjwATMv.mjs

@@ -0,0 +1,57 @@
+import { s as getProjectConfigFileName } from "./utils-Dy51PYAC.mjs";
+import { r as logger_default, t as colors } from "./logger-DGn5iEVN.mjs";
+import process from "node:process";
+import { resolveCommand } from "package-manager-detector/commands";
+//#region src/cli/commands/build/completion.ts
+function shouldScheduleCompletedProductionBuildExit(options, analyzeHandle) {
+	return process.env.VITEST !== "true" && process.env.NODE_ENV !== "test" && process.env.WEAPP_VITE_DISABLE_COMPLETED_BUILD_EXIT !== "1" && options.watch !== true && options.open !== true && analyzeHandle === void 0;
+}
+function scheduleCompletedProductionBuildExit(options, analyzeHandle) {
+	if (!shouldScheduleCompletedProductionBuildExit(options, analyzeHandle)) return;
+	setTimeout(() => {
+		if (process.exitCode === void 0 || process.exitCode === 0) process.exit(0);
+	}, 0).unref?.();
+}
+//#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) {
+	const urls = webServer?.resolvedUrls;
+	if (!urls) return [];
+	return [...urls.local ?? [], ...urls.network ?? []];
+}
+function logBuildAppFinish(configService, webServer, options = {}) {
+	if (logBuildAppFinishOnlyShowOnce) return;
+	const { skipMini = false, skipWeb = false, uiUrls = [] } = options;
+	const webUrls = skipWeb ? [] : collectServerUrls(webServer);
+	if (skipMini) {
+		logger_default.success("开发服务已就绪：");
+		if (webUrls.length > 0) logger_default.info(`Web：${colors.cyan(webUrls[0])}`);
+		else logger_default.info("Web：已启动");
+		logBuildAppFinishOnlyShowOnce = true;
+		return;
+	}
+	const { command, args } = resolveCommand(configService.packageManager.agent, "run", ["open"]) ?? {
+		command: "npm",
+		args: ["run", "open"]
+	};
+	const devCommand = `${command} ${args.join(" ")}`;
+	logger_default.success("开发服务已就绪：");
+	logger_default.info(`小程序：执行 ${colors.bold(colors.green(devCommand))}，或手动导入 ${colors.green(getProjectConfigFileName(configService.platform))}`);
+	if (uiUrls.length > 0) logger_default.info(`UI：${colors.cyan(uiUrls[0])}`);
+	else if (!skipMini) logger_default.info("UI：未启用");
+	if (webUrls.length > 0) logger_default.info(`Web：${colors.cyan(webUrls[0])}`);
+	const projectConfigFileName = getProjectConfigFileName(configService.platform);
+	if (!uiUrls.length && !webUrls.length) logger_default.info(`提示：手动打开对应平台开发者工具，导入根目录（${colors.green(projectConfigFileName)} 文件所在目录）`);
+	logBuildAppFinishOnlyShowOnce = true;
+}
+//#endregion
+export { formatDuration as n, scheduleCompletedProductionBuildExit as r, logBuildAppFinish as t };

package/dist/logger-DGn5iEVN.mjs

@@ -0,0 +1 @@
+export { configureLogger as n, default as r, colors as t } from "@weapp-core/logger";

package/dist/mcp-CYgX9HpO.mjs

@@ -0,0 +1,86 @@
+import process from "node:process";
+import path from "node:path";
+import { writeFile } from "node:fs/promises";
+//#region src/cli/commands/accept.ts
+function registerAcceptCommand(cli) {
+	cli.command("accept [root]", "run deterministic mini-program acceptance without a model").option("--init", "create acceptance configuration without overwriting").option("--inspect", "inspect acceptance prerequisites without executing project code").option("--report <jobId>", "read a saved report and check source freshness").option("--acceptance-config <file>", "select an acceptance JSON configuration").option("--trust", "authorize the reviewed configuration for this invocation").option("--json", "write protocol data only to stdout").action(async (root = ".", options) => {
+		try {
+			const directory = path.resolve(root);
+			const { defaultVerification, detectProject, safePath } = await import("@weapp-vite/acceptance");
+			if (options.init) {
+				const target = await safePath(directory, options.acceptanceConfig ?? "weapp-acceptance.config.json");
+				const config = {
+					version: 1,
+					verification: defaultVerification(await detectProject(directory)),
+					acceptance: {
+						requiredChecks: ["build", "devtools"],
+						scenarios: [],
+						timeoutMs: 6e5
+					}
+				};
+				await writeFile(target, `${JSON.stringify(config, null, 2)}\n`, { flag: "wx" });
+				process.stdout.write(`${JSON.stringify({
+					created: target,
+					modelRequired: false
+				})}\n`);
+				return;
+			}
+			const { createRuntimeAcceptanceService } = await import("@weapp-vite/mcp");
+			const { connectMiniProgram, prepareAcceptanceProject, resolveAutomatorSessionOptions } = await import("weapp-ide-cli");
+			const service = await createRuntimeAcceptanceService(directory, {
+				trust: Boolean(options.trust && !options.inspect && !options.report),
+				configFile: options.acceptanceConfig
+			}, {
+				connectMiniProgram,
+				resolveSessionOptions: resolveAutomatorSessionOptions,
+				prepareProject: prepareAcceptanceProject
+			});
+			let jobId;
+			let cancelRequested = false;
+			const cancel = () => {
+				cancelRequested = true;
+				if (jobId) service.cancel(jobId);
+			};
+			process.once("SIGINT", cancel);
+			try {
+				let result;
+				if (options.inspect) result = await service.inspect();
+				else if (options.report) result = await service.report(options.report);
+				else {
+					let report = await service.start();
+					jobId = report.jobId;
+					if (cancelRequested) await service.cancel(jobId);
+					while (report.status === "running") {
+						await new Promise((resolve) => setTimeout(resolve, 100));
+						report = await service.report(jobId);
+					}
+					result = report;
+				}
+				process.stdout.write(`${JSON.stringify(result, null, options.json ? void 0 : 2)}\n`);
+				if ("passed" in result && (!result.passed || result.snapshot.stale)) process.exitCode = 1;
+			} finally {
+				process.off("SIGINT", cancel);
+				await service.close();
+			}
+		} catch (error) {
+			const message = error instanceof Error ? error.message : String(error);
+			if (options.json) process.stdout.write(`${JSON.stringify({
+				status: "failed",
+				passed: false,
+				reason: message
+			})}\n`);
+			else process.stderr.write(`${message}\n`);
+			process.exitCode = 1;
+		}
+	});
+}
+//#endregion
+//#region src/cli/commands/mcp/index.ts
+function registerMcpCommand(cli) {
+	cli.command("mcp [...args]", "start weapp-vite MCP server or manage MCP client onboarding").option("--transport <type>", "[string] stdio | streamable-http | command | http", { default: "stdio" }).option("--host <host>", "[string] streamable-http host").option("--port <port>", "[number] streamable-http port").option("--endpoint <path>", "[string] streamable-http endpoint path").option("--rest-endpoint <path>", "[string] streamable-http REST runtime endpoint path").option("--no-rest", "[boolean] disable streamable-http REST runtime endpoints").option("--unref", "[boolean] unref HTTP server to not block process exit").option("--url <url>", "[string] explicit HTTP MCP url").option("--workspace-root <path>", "[string] workspace root path, defaults to cwd").option("-y, --yes", "[boolean] write config without prompt").action(async (args, options) => {
+		const { runMcpCommand } = await import("./action-BELcDNNv.mjs");
+		return runMcpCommand(args, options);
+	});
+}
+//#endregion
+export { registerAcceptCommand as n, registerMcpCommand as t };

package/dist/{mcp-BG6TliEg.mjs → mcp-Cj8Maqo6.mjs}

@@ -1,8 +1,7 @@
-import { r as logger_default } from "./logger-mt4mSTqV.mjs";
+import { r as logger_default } from "./logger-DGn5iEVN.mjs";
 import process from "node:process";
-import { connectMiniProgram } from "weapp-ide-cli";
+import { DEFAULT_MCP_ENDPOINT, DEFAULT_MCP_HOST, DEFAULT_MCP_PORT, DEFAULT_RUNTIME_REST_ENDPOINT } from "@weapp-core/constants";
 import { determineAgent } from "@vercel/detect-agent";
-import { DEFAULT_MCP_ENDPOINT, DEFAULT_MCP_HOST, DEFAULT_MCP_PORT, DEFAULT_RUNTIME_REST_ENDPOINT, createWeappViteMcpServer, startWeappViteMcpServer } from "@weapp-vite/mcp";
 //#region src/aiEnvironment.ts
 const AI_ENV_KEYS = [
 	"CODEX_HOME",
@@ -74,6 +73,11 @@ function resolveBooleanLikeEnv(value) {
 }
 //#endregion
 //#region src/mcp.ts
+/** 创建服务时才加载 MCP 运行时；配置解析与公开常量保持同步。 */
+async function createWeappViteMcpServer(options) {
+	const { createWeappViteMcpServer } = await import("@weapp-vite/mcp");
+	return createWeappViteMcpServer(options);
+}
 function normalizeEndpoint(input) {
 	const value = typeof input === "string" ? input.trim() : "";
 	if (!value) return DEFAULT_MCP_ENDPOINT;
@@ -115,9 +119,14 @@ function resolveWeappMcpConfig(config, options = {}) {
 		restEndpoint: record.restEndpoint === false ? false : normalizeEndpoint(record.restEndpoint ?? DEFAULT_RUNTIME_REST_ENDPOINT)
 	};
 }
-async function startWeappViteMcpServer$1(options) {
-	return startWeappViteMcpServer({
-		runtimeHooks: { connectMiniProgram },
+async function startWeappViteMcpServer(options) {
+	const [{ startWeappViteMcpServer: startMcpServer }, { connectMiniProgram, prepareAcceptanceProject, resolveAutomatorSessionOptions }] = await Promise.all([import("@weapp-vite/mcp"), import("weapp-ide-cli")]);
+	return startMcpServer({
+		runtimeHooks: {
+			connectMiniProgram,
+			resolveSessionOptions: resolveAutomatorSessionOptions,
+			prepareProject: prepareAcceptanceProject
+		},
 		...options,
 		onReady: options?.onReady ?? ((message) => {
 			logger_default.info(message);
@@ -125,4 +134,4 @@ async function startWeappViteMcpServer$1(options) {
 	});
 }
 //#endregion
-export { createWeappViteMcpServer as a, startWeappViteMcpServer$1 as c, DEFAULT_RUNTIME_REST_ENDPOINT as i, detectAiDevelopmentEnvironment as l, DEFAULT_MCP_HOST as n, resolveProjectMcpPort as o, DEFAULT_MCP_PORT as r, resolveWeappMcpConfig as s, DEFAULT_MCP_ENDPOINT as t };
+export { createWeappViteMcpServer as a, startWeappViteMcpServer as c, DEFAULT_RUNTIME_REST_ENDPOINT as i, detectAiDevelopmentEnvironment as l, DEFAULT_MCP_HOST as n, resolveProjectMcpPort as o, DEFAULT_MCP_PORT as r, resolveWeappMcpConfig as s, DEFAULT_MCP_ENDPOINT as t };

package/dist/mcp.d.mts

@@ -1,6 +1,9 @@
-import { Wt as WeappMcpConfig } from "./config-Dbvj5yK7.mjs";
-import { CreateServerOptions, DEFAULT_MCP_ENDPOINT, DEFAULT_MCP_HOST, DEFAULT_MCP_PORT, DEFAULT_RUNTIME_REST_ENDPOINT, McpServerHandle, StartMcpServerOptions, createWeappViteMcpServer } from "@weapp-vite/mcp";
+import { Ut as WeappMcpConfig } from "./config-Bf6DWhyb.mjs";
+import { DEFAULT_MCP_ENDPOINT, DEFAULT_MCP_HOST, DEFAULT_MCP_PORT, DEFAULT_RUNTIME_REST_ENDPOINT } from "@weapp-core/constants";
+import { CreateServerOptions, McpServerHandle, StartMcpServerOptions, createWeappViteMcpServer as createWeappViteMcpServer$1 } from "@weapp-vite/mcp";
 //#region src/mcp.d.ts
+/** 创建服务时才加载 MCP 运行时；配置解析与公开常量保持同步。 */
+export declare function createWeappViteMcpServer(options?: CreateServerOptions): ReturnType<typeof createWeappViteMcpServer$1>;
 export interface ResolvedWeappMcpConfig {
   agentName?: string;
   enabled: boolean;
@@ -22,4 +25,4 @@ export declare function resolveProjectMcpPort(projectRoot?: string): number;
 export declare function resolveWeappMcpConfig(config?: boolean | WeappMcpConfig, options?: ResolveWeappMcpConfigOptions): ResolvedWeappMcpConfig;
 export declare function startWeappViteMcpServer(options?: WeappViteMcpServerOptions): Promise<WeappViteMcpServerHandle>;
 //#endregion
-export { type CreateServerOptions, DEFAULT_MCP_ENDPOINT, DEFAULT_MCP_HOST, DEFAULT_MCP_PORT, DEFAULT_RUNTIME_REST_ENDPOINT, createWeappViteMcpServer };
+export { type CreateServerOptions, DEFAULT_MCP_ENDPOINT, DEFAULT_MCP_HOST, DEFAULT_MCP_PORT, DEFAULT_RUNTIME_REST_ENDPOINT };

package/dist/mcp.mjs

@@ -1,2 +1 @@
-import { a as createWeappViteMcpServer, c as startWeappViteMcpServer, i as DEFAULT_RUNTIME_REST_ENDPOINT, n as DEFAULT_MCP_HOST, o as resolveProjectMcpPort, r as DEFAULT_MCP_PORT, s as resolveWeappMcpConfig, t as DEFAULT_MCP_ENDPOINT } from "./mcp-BG6TliEg.mjs";
-export { DEFAULT_MCP_ENDPOINT, DEFAULT_MCP_HOST, DEFAULT_MCP_PORT, DEFAULT_RUNTIME_REST_ENDPOINT, createWeappViteMcpServer, resolveProjectMcpPort, resolveWeappMcpConfig, startWeappViteMcpServer };
+export { t as DEFAULT_MCP_ENDPOINT, n as DEFAULT_MCP_HOST, r as DEFAULT_MCP_PORT, i as DEFAULT_RUNTIME_REST_ENDPOINT, a as createWeappViteMcpServer, o as resolveProjectMcpPort, s as resolveWeappMcpConfig, c as startWeappViteMcpServer } from "./mcp-Cj8Maqo6.mjs";

package/dist/mcpClient-DVLvFLZv.mjs

@@ -0,0 +1,287 @@
+import process from "node:process";
+import path from "pathe";
+import { fs } from "@weapp-core/shared/fs";
+import os from "node:os";
+import { clearTimeout, setTimeout } from "node:timers";
+//#region src/cli/mcpClient/shared.ts
+const CODEX_BLOCK_PREFIX = "# >>> weapp-vite mcp ";
+const CODEX_BLOCK_SUFFIX = " >>>";
+const CODEX_BLOCK_END_PREFIX = "# <<< weapp-vite mcp ";
+const CODEX_BLOCK_END_SUFFIX = " <<<";
+const DEFAULT_HTTP_TIMEOUT_MS = 1500;
+const WORKSPACE_FOLDER_TOKEN = "${workspaceFolder}";
+const REG_CodexUrl = /^\s*url\s*=\s*"([^"]+)"/m;
+const REG_CodexCommand = /^\s*command\s*=\s*"([^"]+)"/m;
+const REG_CodexArgs = /^\s*args\s*=\s*\[([^\]]*)\]/m;
+const REG_FirstTomlString = /"([^"]+)"/;
+function resolveTargetWorkspaceRoot(target) {
+	if (target.client === "cursor") return path.dirname(path.dirname(target.configPath));
+	if (target.client === "claude-code") return path.dirname(target.configPath);
+	return process.cwd();
+}
+function escapeRegExp(value) {
+	return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function renderTomlString(value) {
+	return JSON.stringify(value);
+}
+function sanitizeServerNameSegment(value) {
+	return value.trim().toLowerCase().replace(/[^a-z0-9-]+/g, "-").replace(/-{2,}/g, "-").replace(/^-|-$/g, "");
+}
+function resolveServerName(workspaceRoot) {
+	return `weapp-vite-${sanitizeServerNameSegment(path.basename(workspaceRoot)) || "project"}`;
+}
+function resolveNodeBinCommand() {
+	return process.execPath || "node";
+}
+function resolveProjectCliBin(workspaceRoot) {
+	return path.join(workspaceRoot, "node_modules", "weapp-vite", "bin", "weapp-vite.js");
+}
+function renderCommandArgs(args) {
+	return args.map(renderTomlString).join(", ");
+}
+function renderCodexBlock(serverName, entry) {
+	const startMarker = `${CODEX_BLOCK_PREFIX}${serverName}${CODEX_BLOCK_SUFFIX}`;
+	const endMarker = `${CODEX_BLOCK_END_PREFIX}${serverName}${CODEX_BLOCK_END_SUFFIX}`;
+	if (entry.url) return `${startMarker}
+[mcp_servers.${serverName}]
+url = ${renderTomlString(entry.url)}
+${endMarker}
+`;
+	return `${startMarker}
+[mcp_servers.${serverName}]
+command = ${renderTomlString(entry.command ?? resolveNodeBinCommand())}
+args = [${renderCommandArgs(entry.args ?? [])}]
+${endMarker}
+`;
+}
+function renderJsonPreview(serverName, entry) {
+	return `${JSON.stringify({ mcpServers: { [serverName]: entry } }, null, 2)}
+`;
+}
+function resolveCommandEntry(client, workspaceRoot) {
+	const binPath = resolveProjectCliBin(workspaceRoot);
+	if (client === "cursor") return {
+		command: "node",
+		args: [
+			`${WORKSPACE_FOLDER_TOKEN}/node_modules/weapp-vite/bin/weapp-vite.js`,
+			"mcp",
+			"--workspace-root",
+			WORKSPACE_FOLDER_TOKEN
+		]
+	};
+	return {
+		command: resolveNodeBinCommand(),
+		args: [
+			binPath,
+			"mcp",
+			"--workspace-root",
+			workspaceRoot
+		]
+	};
+}
+function resolveHttpEntry(client, url) {
+	if (client === "claude-code") return {
+		type: "http",
+		url
+	};
+	return { url };
+}
+function resolveConfigEntry(client, transport, workspaceRoot, url) {
+	return transport === "http" ? resolveHttpEntry(client, url ?? "") : resolveCommandEntry(client, workspaceRoot);
+}
+function resolveCodexBlockPattern(serverName) {
+	const startMarker = `${CODEX_BLOCK_PREFIX}${serverName}${CODEX_BLOCK_SUFFIX}`;
+	const endMarker = `${CODEX_BLOCK_END_PREFIX}${serverName}${CODEX_BLOCK_END_SUFFIX}`;
+	return new RegExp(`${escapeRegExp(startMarker)}[\\s\\S]*?${escapeRegExp(endMarker)}\\n?`, "g");
+}
+function upsertCodexManagedBlock(content, serverName, block) {
+	const withoutExisting = content.trimEnd().replace(resolveCodexBlockPattern(serverName), "").trimEnd();
+	if (!withoutExisting) return block;
+	return `${withoutExisting}\n\n${block}`;
+}
+function parseJsonConfig(content, configPath) {
+	if (!content.trim()) return {};
+	try {
+		return JSON.parse(content);
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		throw new Error(`无法解析 MCP 配置文件 ${configPath}：${message}`);
+	}
+}
+function resolveTarget(client, workspaceRoot) {
+	const serverName = resolveServerName(workspaceRoot);
+	if (client === "codex") return {
+		client,
+		configPath: path.join(os.homedir(), ".codex", "config.toml"),
+		displayName: "Codex",
+		serverName
+	};
+	if (client === "claude-code") return {
+		client,
+		configPath: path.join(workspaceRoot, ".mcp.json"),
+		displayName: "Claude Code",
+		serverName
+	};
+	return {
+		client,
+		configPath: path.join(workspaceRoot, ".cursor", "mcp.json"),
+		displayName: "Cursor",
+		serverName
+	};
+}
+//#endregion
+//#region src/cli/mcpClient/inspect.ts
+async function probeHttpEndpoint(url) {
+	const controller = new AbortController();
+	const timer = setTimeout(() => {
+		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);
+}
+//#endregion
+//#region src/cli/mcpClient/plan.ts
+function resolveSupportedMcpClient(input) {
+	if (input === "codex" || input === "claude-code" || input === "cursor") return input;
+	throw new Error(`不支持的 MCP 客户端：${input}。当前仅支持 codex、claude-code、cursor。`);
+}
+function buildMcpClientConfigPlan(options) {
+	const workspaceRoot = path.resolve(options.workspaceRoot);
+	const target = resolveTarget(options.client, workspaceRoot);
+	const entry = resolveConfigEntry(options.client, options.transport, workspaceRoot, options.url);
+	if (options.transport === "http" && !entry.url) throw new Error("HTTP 模式缺少 MCP 服务地址，请使用 --url 指定或在当前项目中检测到可用地址。");
+	return {
+		entry,
+		preview: target.client === "codex" ? renderCodexBlock(target.serverName, entry) : renderJsonPreview(target.serverName, entry),
+		target,
+		transport: options.transport
+	};
+}
+function formatMcpQuickStart(options) {
+	const suffix = options.transport === "http" && options.httpUrl ? ` --transport http --url ${options.httpUrl}` : "";
+	return [
+		"在 AI 工具中接入 weapp-vite MCP：",
+		`  - Codex: wv mcp init codex${suffix}`,
+		`  - Claude Code: wv mcp init claude-code${suffix}`,
+		`  - Cursor: wv mcp init cursor${suffix}`
+	];
+}
+//#endregion
+//#region src/cli/mcpClient/index.ts
+async function writeMcpClientConfig(plan) {
+	await fs.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");
+}
+//#endregion
+export { inspectMcpClientConfig as a, resolveSupportedMcpClient as i, buildMcpClientConfigPlan as n, formatMcpQuickStart as r, writeMcpClientConfig as t };

package/dist/metadata-hwF7QRcS.mjs

@@ -0,0 +1,59 @@
+import path from "pathe";
+//#region src/analyze/subpackages/metadata.ts
+const defaultTotalBudgetBytes = 20971520;
+const defaultPackageBudgetBytes = 2097152;
+const defaultWarningRatio = .85;
+const defaultHistoryDir = ".weapp-vite/analyze-history";
+const defaultHistoryLimit = 20;
+function resolveBudgetValue(value, fallback) {
+	return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : fallback;
+}
+function resolveHistoryLimit(value) {
+	return typeof value === "number" && Number.isFinite(value) && value > 0 ? Math.floor(value) : defaultHistoryLimit;
+}
+function resolveAnalyzeBudgets(configService) {
+	const budgets = configService.weappViteConfig.analyze?.budgets;
+	const legacyPackageBudget = configService.weappViteConfig.packageSizeWarningBytes;
+	const packageFallback = resolveBudgetValue(legacyPackageBudget, defaultPackageBudgetBytes);
+	const optionalBudget = (value) => typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : void 0;
+	return {
+		totalBytes: resolveBudgetValue(budgets?.totalBytes, defaultTotalBudgetBytes),
+		mainBytes: resolveBudgetValue(budgets?.mainBytes, packageFallback),
+		subPackageBytes: resolveBudgetValue(budgets?.subPackageBytes, packageFallback),
+		independentBytes: resolveBudgetValue(budgets?.independentBytes, packageFallback),
+		runtimeBytes: optionalBudget(budgets?.runtimeBytes),
+		packageBytes: budgets?.packageBytes ? Object.fromEntries(Object.entries(budgets.packageBytes).filter(([, value]) => optionalBudget(value) !== void 0)) : void 0,
+		warningRatio: resolveBudgetValue(budgets?.warningRatio, defaultWarningRatio),
+		source: budgets ? "config" : "default"
+	};
+}
+function resolveAnalyzeHistoryMetadata(configService) {
+	const history = configService.weappViteConfig.analyze?.history;
+	if (history === false) return {
+		enabled: false,
+		dir: path.resolve(configService.cwd, defaultHistoryDir),
+		limit: defaultHistoryLimit
+	};
+	const historyConfig = typeof history === "object" && history ? history : {};
+	const rawDir = typeof historyConfig.dir === "string" && historyConfig.dir.trim() ? historyConfig.dir.trim() : defaultHistoryDir;
+	return {
+		enabled: historyConfig.enabled !== false,
+		dir: path.isAbsolute(rawDir) ? rawDir : path.resolve(configService.cwd, rawDir),
+		limit: resolveHistoryLimit(historyConfig.limit)
+	};
+}
+function createAnalyzeMetadata(configService, now = /* @__PURE__ */ new Date()) {
+	const history = resolveAnalyzeHistoryMetadata(configService);
+	const packageName = configService.packageJson?.name;
+	return {
+		projectName: typeof packageName === "string" && packageName.trim() ? packageName.trim() : path.basename(configService.cwd),
+		generatedAt: now.toISOString(),
+		budgets: resolveAnalyzeBudgets(configService),
+		history: {
+			...history,
+			dir: configService.relativeCwd(history.dir)
+		}
+	};
+}
+//#endregion
+export { resolveAnalyzeBudgets as n, resolveAnalyzeHistoryMetadata as r, createAnalyzeMetadata as t };

package/dist/nodeEnv-BmH8UZPR.mjs

@@ -0,0 +1,7 @@
+import process from "node:process";
+//#region src/cli/nodeEnv.ts
+function setCommandNodeEnv(nodeEnv) {
+	process.env.NODE_ENV = nodeEnv;
+}
+//#endregion
+export { setCommandNodeEnv as t };