weapp-vite 7.3.0 → 7.4.0

package/dist/cli.mjs

@@ -1,30 +1,39 @@
-import { A as getDefaultIdeProjectRoot, C as collectPreloadPages, D as loadViteConfigFile, E as suggestPreloadRules, M as isPathInside, O as createCjsConfigLoadError, S as getProjectConfigFileName, T as resolvePreloadPackageIdentifier, _ as SHARED_CHUNK_VIRTUAL_PREFIX, a as formatBytes, b as resolveWeappConfigFile, d as getBackendForCapability, f as resolveBackendExecution, g as createSharedBuildConfig, h as createGlassEaselAnalyzeResult, j as shouldPassPlatformArgToIdeOpen, k as parseCommentJson, m as syncManagedTsconfigBootstrapFiles, p as syncProjectSupportFiles, t as createCompilerContext, v as resolveHmrProfileJsonPath, w as findPreloadRuleKey, x as checkRuntime } from "./createContext-cqr9Y4EV.mjs";
-import { f as VERSION, i as findJsEntry, o as findTemplateEntry, s as findVueEntry } from "./file-CKB0Tn8Z.mjs";
+import { a as resolveWeappViteHostMeta } from "./pluginHost--CaeyWpA.mjs";
+import { C as collectPreloadPages, D as loadViteConfigFile, E as suggestPreloadRules, O as createCjsConfigLoadError, S as getProjectConfigFileName, T as resolvePreloadPackageIdentifier, _ as SHARED_CHUNK_VIRTUAL_PREFIX, a as formatBytes, b as resolveWeappConfigFile, d as getBackendForCapability, f as resolveBackendExecution, g as createSharedBuildConfig, h as createGlassEaselAnalyzeResult, k as isPathInside, m as syncManagedTsconfigBootstrapFiles, p as syncProjectSupportFiles, t as createCompilerContext, v as resolveHmrProfileJsonPath, w as findPreloadRuleKey, x as checkRuntime } from "./createContext-UOEgeYnA.mjs";
+import { l as getProjectPlatformOptions, n as getDefaultIdeProjectRoot, w as shouldPassPlatformArgToIdeOpen } from "./platform-DTWs5QRi.mjs";
+import { i as findJsEntry, o as findTemplateEntry, s as findVueEntry } from "./file-giE9UMZa.mjs";
+import { t as VERSION } from "./constants-WOsG3Eqd.mjs";
 import { r as logger_default, t as colors } from "./logger-mt4mSTqV.mjs";
+import { a as createDashboardArtifactSnapshot, i as resolveDashboardRoot, n as ANALYZE_DASHBOARD_PACKAGE_NAME, t as createAnalyzeDashboardDevframe } from "./dashboard-BzaVesmQ.mjs";
+import { n as resolveUploadPlatforms, r as redactUploadSecrets, t as prepareUpload } from "./upload-D0RcEWrq.mjs";
 import { c as startWeappViteMcpServer, l as detectAiDevelopmentEnvironment, s as resolveWeappMcpConfig } from "./mcp-BG6TliEg.mjs";
-import { createRequire } from "node:module";
-import fs from "node:fs";
 import path, { posix } from "pathe";
+import fs from "node:fs";
+import { fileURLToPath } from "node:url";
 import path$1 from "node:path";
 import { defu } from "@weapp-core/shared";
 import { fs as fs$1 } from "@weapp-core/shared/fs";
 import process from "node:process";
 import { parse } from "vue/compiler-sfc";
-import fs$2, { mkdir, writeFile } from "node:fs/promises";
+import fs$2, { access, mkdir, readFile, realpath, stat, writeFile } from "node:fs/promises";
 import { build, createServer } from "vite";
-import { createHash } from "node:crypto";
-import { promisify } from "node:util";
+import { randomUUID } from "node:crypto";
+import { parseArgs, parseEnv, promisify } from "node:util";
 import os from "node:os";
-import { execFile, spawn } from "node:child_process";
+import { execFile, fork, spawn } from "node:child_process";
 import { Buffer } from "node:buffer";
 import { cac } from "cac";
 import { RETRY_CANCEL_KEYS, RETRY_CONFIRM_KEYS, bootstrapWechatDevtoolsSettings, buildWechatIdeNpm, clearWechatIdeCache, clearWechatIdeCacheByAutomator, closeSharedMiniProgram, closeWechatIdeProject, compileWechatIdeByAutomator, connectOpenedAutomator, createSharedInputSession, createWechatIdeLoginRequiredExitError, defaultCustomConfigFilePath, detectWechatDevtoolsServicePort, dispatchWechatCliCommand, formatAutomatorLoginError, getConfig, getWechatIdeTestAccounts, getWechatIdeTicket, getWechatIdeToolInfo, isAutomatorLoginError, isRetryableAutomatorLaunchError, isWeappIdeTopLevelCommand, isWechatIdeEngineBuildEndpointMissingError, isWechatIdeLoggedIn, isWechatIdeLoginRequiredError, isWechatIdeLoginRequiredExitError, launchAutomator, parse as parse$1, promptRetryKeypress, promptWechatIdeLoginRetry, quitWechatIde, refreshWechatIdeTicket, resetWechatIdeFileUtilsByHttp, resolveCliPath, resolveProjectAutomatorPort, runRetryableCommand, runWechatIdeEngineBuild, runWithSuspendedSharedInput, setWechatIdeTicket, startForwardConsole, takeScreenshot } from "weapp-ide-cli";
 import { brotliCompressSync, gzipSync } from "node:zlib";
+import { defineRpcFunction } from "devframe";
 import { buildOtpAuthUrl, refreshTempAuthCode } from "devframe/node/auth";
 import { resolveCommand } from "package-manager-detector/commands";
-import { defineDevframe, defineRpcFunction } from "devframe";
 import { Server } from "node:http";
+import { DEVFRAME_CONNECTION_META_FILENAME, DEVFRAME_SSE_ROUTE, DEVFRAME_WS_ROUTE } from "devframe/constants";
 import { initDevframe } from "devframe/initiate";
+import semverInc from "semver/functions/inc.js";
+import { x } from "tinyexec";
+import { expand } from "dotenv-expand";
 import { generateJs, generateJson, generateWxml, generateWxss } from "@weapp-core/schematics";
 import { determineAgent } from "@vercel/detect-agent";
 import { initConfig } from "@weapp-core/init";
@@ -449,10 +458,11 @@ async function runWechatIdeOpenWithRetry(argv) {
 	});
 }
 /**
-* @description 根据 mpDistRoot 推导 IDE 项目目录（目录内应包含 project/mini 配置）
+* @description 根据代码输出目录推导 IDE 项目目录；内联项目配置与 app.json 同目录。
 */
-function resolveIdeProjectPath(mpDistRoot) {
+function resolveIdeProjectPath(mpDistRoot, generatedProjectConfig = false) {
 	if (!mpDistRoot || !mpDistRoot.trim()) return;
+	if (generatedProjectConfig) return mpDistRoot;
 	const parent = path.dirname(mpDistRoot);
 	if (!parent || parent === "." || parent === "/") return;
 	return parent;
@@ -460,8 +470,9 @@ function resolveIdeProjectPath(mpDistRoot) {
 /**
 * @description 结合 mpDistRoot 与配置根目录解析最终 IDE 项目目录。
 */
-function resolveIdeProjectRoot(mpDistRoot, cwd) {
-	return resolveIdeProjectPath(mpDistRoot) ?? cwd;
+function resolveIdeProjectRoot(mpDistRoot, cwd, generatedProjectConfig = false) {
+	const projectPath = resolveIdeProjectPath(mpDistRoot, generatedProjectConfig);
+	return generatedProjectConfig && projectPath && cwd ? path.resolve(cwd, projectPath) : projectPath ?? cwd;
 }
 async function closeIde() {
 	return await closeIde$1();
@@ -722,7 +733,7 @@ async function resolveIdeCommandContext(options) {
 			cliPlatform: options.cliPlatform
 		});
 		platform ??= ctx.configService.platform;
-		if (!projectPath) projectPath = resolveIdeProjectRoot(ctx.configService.mpDistRoot, ctx.configService.cwd);
+		if (!projectPath) projectPath = resolveIdeProjectRoot(ctx.configService.mpDistRoot, ctx.configService.cwd, ctx.configService.multiPlatform.projectConfigs !== void 0);
 		return {
 			cwd: ctx.configService.cwd,
 			platform,
@@ -2259,316 +2270,7 @@ function createAnalyzeMarkdownReport(result, previousResult) {
 	].join("\n");
 }
 //#endregion
-//#region src/cli/analyze/dashboardDevframe/artifacts.ts
-const MAX_DASHBOARD_FILE_CONTENT_BYTES = 2097152;
-/** 保留同一次分析的产物内容，不读取或改写开发构建目录。 */
-function createDashboardArtifactSnapshot() {
-	const files = /* @__PURE__ */ new Map();
-	let retainedBytes = 0;
-	return {
-		files,
-		capture(fileName, source) {
-			const key = fileName.replaceAll("\\", "/");
-			const previous = files.get(key);
-			if (previous?.content !== void 0) retainedBytes -= previous.size;
-			const size = typeof source === "string" ? Buffer.byteLength(source, "utf8") : source.byteLength;
-			if (size > 2097152) {
-				files.set(key, {
-					size,
-					error: `文件超过 ${MAX_DASHBOARD_FILE_CONTENT_BYTES} 字节，已拒绝读取。`
-				});
-				return;
-			}
-			if (retainedBytes + size > 33554432) {
-				files.set(key, {
-					size,
-					error: "分析产物内容超过快照容量上限，已拒绝读取。"
-				});
-				return;
-			}
-			const content = typeof source === "string" ? source : Buffer.from(source.buffer, source.byteOffset, source.byteLength).toString("utf8");
-			files.set(key, {
-				content,
-				size
-			});
-			retainedBytes += size;
-		}
-	};
-}
-//#endregion
-//#region src/cli/analyze/dashboardDevframe/paths.ts
-function normalizeDashboardRelativePath(value) {
-	return value.replaceAll("\\", "/");
-}
-function stripDashboardFileQuery(value) {
-	const queryIndex = value.indexOf("?");
-	return queryIndex === -1 ? value : value.slice(0, queryIndex);
-}
-function addDashboardAllowedPath(paths, value) {
-	if (!value || value.includes("\0")) return;
-	const normalizedPath = normalizeDashboardRelativePath(stripDashboardFileQuery(value));
-	if (!normalizedPath || path.isAbsolute(normalizedPath)) return;
-	paths.add(normalizedPath);
-}
-function addDashboardAllowedSourcePath(paths, value, rootKind) {
-	if (!value || value.includes("\0")) return;
-	const normalizedPath = normalizeDashboardRelativePath(stripDashboardFileQuery(value));
-	if (!normalizedPath || path.isAbsolute(normalizedPath)) return;
-	const rootKinds = paths.get(normalizedPath) ?? /* @__PURE__ */ new Set();
-	rootKinds.add(rootKind);
-	paths.set(normalizedPath, rootKinds);
-}
-function resolveDashboardSourceRootKind(sourceType) {
-	if (sourceType === "plugin") return "plugin";
-	if (sourceType === "workspace" || sourceType === "node_modules") return "project";
-	return "src";
-}
-function createDashboardContentAllowlist(result) {
-	const artifactPaths = /* @__PURE__ */ new Set();
-	const sourcePaths = /* @__PURE__ */ new Map();
-	for (const packageReport of result.packages) for (const file of packageReport.files) {
-		addDashboardAllowedPath(artifactPaths, file.file);
-		const fileSourceType = file.sourceType ?? file.modules?.find((module) => module.source === file.source)?.sourceType;
-		addDashboardAllowedSourcePath(sourcePaths, file.source, resolveDashboardSourceRootKind(fileSourceType));
-		for (const module of file.modules ?? []) addDashboardAllowedSourcePath(sourcePaths, module.source, module.sourceType === "src" ? "src" : module.sourceType === "plugin" ? "plugin" : "project");
-	}
-	return {
-		artifactPaths,
-		sourcePaths
-	};
-}
-function resolveDashboardContentPath(root, requestPath, options) {
-	if (!root || !requestPath || requestPath.includes("\0")) return;
-	const normalizedRequestPath = normalizeDashboardRelativePath(stripDashboardFileQuery(requestPath));
-	if (path.isAbsolute(normalizedRequestPath) || !options.allowedPaths.has(normalizedRequestPath)) return;
-	const rootPath = path.resolve(root);
-	const absolutePath = path.resolve(rootPath, normalizedRequestPath);
-	const relativePath = path.relative(rootPath, absolutePath);
-	const allowParent = options.allowParent === true;
-	if (!relativePath || !allowParent && (relativePath.startsWith("..") || path.isAbsolute(relativePath))) return;
-	return {
-		absolutePath,
-		allowParent,
-		relativePath: allowParent ? normalizedRequestPath : normalizeDashboardRelativePath(relativePath),
-		rootPath
-	};
-}
-function resolveDashboardSourceContentPaths(roots, requestPath, allowedPaths) {
-	const normalizedRequestPath = normalizeDashboardRelativePath(stripDashboardFileQuery(requestPath));
-	const rootKinds = allowedPaths.get(normalizedRequestPath);
-	if (!rootKinds || rootKinds.size !== 1) return [];
-	const [rootKind] = rootKinds;
-	if (rootKind === "project") {
-		const resolved = resolveDashboardContentPath(roots.projectRoot, normalizedRequestPath, {
-			allowParent: true,
-			allowedPaths: /* @__PURE__ */ new Set([normalizedRequestPath])
-		});
-		return resolved ? [resolved] : [];
-	}
-	if (rootKind === "plugin") {
-		if (!roots.pluginRoot) return [];
-		const pluginBase = path.basename(roots.pluginRoot);
-		if (normalizedRequestPath !== pluginBase && !normalizedRequestPath.startsWith(`${pluginBase}/`)) return [];
-		const pluginRelativePath = normalizedRequestPath === pluginBase ? "" : normalizedRequestPath.slice(pluginBase.length + 1);
-		const resolved = resolveDashboardContentPath(roots.pluginRoot, pluginRelativePath, { allowedPaths: /* @__PURE__ */ new Set([pluginRelativePath]) });
-		return resolved ? [{
-			...resolved,
-			relativePath: normalizedRequestPath
-		}] : [];
-	}
-	if (!roots.srcRoot) return [];
-	const candidates = (normalizedRequestPath.startsWith("src/") ? [normalizedRequestPath, normalizedRequestPath.slice(4)] : [normalizedRequestPath]).flatMap((relativePath) => {
-		const resolved = resolveDashboardContentPath(roots.srcRoot, relativePath, { allowedPaths: /* @__PURE__ */ new Set([relativePath]) });
-		return resolved ? [{
-			...resolved,
-			relativePath: normalizedRequestPath
-		}] : [];
-	});
-	return [...new Map(candidates.map((candidate) => [candidate.absolutePath, candidate])).values()];
-}
-function resolveDashboardArtifactPath(requestPath, allowedPaths) {
-	const normalizedPath = normalizeDashboardRelativePath(stripDashboardFileQuery(requestPath));
-	if (!normalizedPath || normalizedPath.includes("\0") || path.isAbsolute(normalizedPath) || path.posix.normalize(normalizedPath).startsWith("..") || !allowedPaths.has(normalizedPath)) return;
-	return normalizedPath;
-}
-//#endregion
-//#region src/cli/analyze/dashboardDevframe/content.ts
-function isPathWithin(rootPath, targetPath) {
-	const relativePath = path.relative(rootPath, targetPath);
-	return !relativePath || !relativePath.startsWith("..") && !path.isAbsolute(relativePath);
-}
-function resolveInspectionRoot(resolved) {
-	let inspectionRoot = resolved.rootPath;
-	if (!resolved.allowParent) return inspectionRoot;
-	while (!isPathWithin(inspectionRoot, resolved.absolutePath)) {
-		const parent = path.dirname(inspectionRoot);
-		if (parent === inspectionRoot) return;
-		inspectionRoot = parent;
-	}
-	return inspectionRoot;
-}
-async function assertDashboardPathHasNoSymlink(resolved) {
-	const inspectionRoot = resolveInspectionRoot(resolved);
-	if (!inspectionRoot) throw new Error("文件路径超出允许范围。");
-	const relativePath = path.relative(inspectionRoot, resolved.absolutePath);
-	let currentPath = inspectionRoot;
-	for (const segment of relativePath.split(path.sep).filter(Boolean)) {
-		currentPath = path.join(currentPath, segment);
-		if ((await fs.promises.lstat(currentPath)).isSymbolicLink()) throw new Error("文件路径包含不允许的符号链接。");
-	}
-}
-function isSameOpenedFile(pathStat, handleStat) {
-	if (pathStat.dev !== handleStat.dev) return false;
-	return pathStat.ino === 0 || handleStat.ino === 0 || pathStat.ino === handleStat.ino;
-}
-async function openDashboardFile(resolved) {
-	await assertDashboardPathHasNoSymlink(resolved);
-	const flags = process.platform === "win32" ? fs.constants.O_RDONLY : fs.constants.O_RDONLY | fs.constants.O_NOFOLLOW;
-	const handle = await fs.promises.open(resolved.absolutePath, flags);
-	try {
-		await assertDashboardPathHasNoSymlink(resolved);
-		const [pathStat, handleStat] = await Promise.all([fs.promises.stat(resolved.absolutePath), handle.stat()]);
-		if (!isSameOpenedFile(pathStat, handleStat)) throw new Error("文件路径在读取期间发生变化。");
-		return handle;
-	} catch (error) {
-		await handle.close();
-		throw error;
-	}
-}
-async function readDashboardFileHandle(handle) {
-	const stat = await handle.stat();
-	if (!stat.isFile()) throw new Error("目标路径不是文件。");
-	if (stat.size > 2097152) throw new Error(`文件超过 ${MAX_DASHBOARD_FILE_CONTENT_BYTES} 字节，已拒绝读取。`);
-	let content = Buffer.allocUnsafe(Math.min(Math.max(stat.size + 1, 1), 2097153));
-	let offset = 0;
-	while (true) {
-		if (offset === content.length) {
-			if (content.length === 2097153) throw new Error(`文件超过 ${MAX_DASHBOARD_FILE_CONTENT_BYTES} 字节，已拒绝读取。`);
-			const expanded = Buffer.allocUnsafe(Math.min(content.length * 2, 2097153));
-			content.copy(expanded, 0, 0, offset);
-			content = expanded;
-		}
-		const { bytesRead } = await handle.read(content, offset, content.length - offset, offset);
-		if (bytesRead === 0) break;
-		offset += bytesRead;
-		if (offset > 2097152) throw new Error(`文件超过 ${MAX_DASHBOARD_FILE_CONTENT_BYTES} 字节，已拒绝读取。`);
-	}
-	return {
-		content: content.subarray(0, offset).toString("utf8"),
-		size: offset
-	};
-}
-function resolveDashboardFileLanguage(filePath) {
-	const extension = path.extname(filePath).toLowerCase();
-	if ([
-		".js",
-		".mjs",
-		".cjs",
-		".wxs",
-		".sjs"
-	].includes(extension)) return "javascript";
-	if ([
-		".ts",
-		".mts",
-		".cts"
-	].includes(extension)) return "typescript";
-	if ([".json", ".map"].includes(extension)) return "json";
-	if ([
-		".css",
-		".wxss",
-		".scss",
-		".sass",
-		".less"
-	].includes(extension)) return "css";
-	if ([
-		".vue",
-		".wxml",
-		".html"
-	].includes(extension)) return "html";
-	return "plaintext";
-}
-function normalizeDashboardFileRequest(input) {
-	if (!input || typeof input !== "object" || !("kind" in input) || !("path" in input)) throw new Error("必须传入合法的 kind 和相对路径。");
-	const kind = input.kind;
-	const requestPath = input.path;
-	if (kind !== "source" && kind !== "artifact" || typeof requestPath !== "string") throw new Error("必须传入合法的 kind 和相对路径。");
-	return {
-		kind,
-		path: requestPath
-	};
-}
-async function readAllowedDashboardFile(input, roots, allowlist, artifacts) {
-	const request = normalizeDashboardFileRequest(input);
-	if (request.kind === "artifact") {
-		const filePath = resolveDashboardArtifactPath(request.path, allowlist.artifactPaths);
-		if (!filePath) throw new Error("必须传入合法的 kind 和相对路径。");
-		const file = artifacts.get(filePath);
-		if (!file) throw new Error("分析快照中没有此产物内容。");
-		if (file.error || file.content === void 0) throw new Error(file.error ?? "分析快照中没有此产物内容。");
-		return {
-			kind: request.kind,
-			path: filePath,
-			language: resolveDashboardFileLanguage(filePath),
-			size: file.size,
-			content: file.content
-		};
-	}
-	const resolvedCandidates = resolveDashboardSourceContentPaths(roots, request.path, allowlist.sourcePaths);
-	if (resolvedCandidates.length === 0) throw new Error("必须传入合法的 kind 和相对路径。");
-	const openedCandidates = [];
-	try {
-		for (const resolved of resolvedCandidates) try {
-			openedCandidates.push({
-				handle: await openDashboardFile(resolved),
-				resolved
-			});
-		} catch (error) {
-			if ((typeof error === "object" && error && "code" in error ? String(error.code) : "") !== "ENOENT") throw error;
-		}
-		if (openedCandidates.length === 0) throw new Error("文件不存在。");
-		if (openedCandidates.length > 1) throw new Error("源码路径存在多个候选文件，已拒绝读取。");
-		const [{ handle, resolved }] = openedCandidates;
-		const file = await readDashboardFileHandle(handle);
-		return {
-			kind: request.kind,
-			path: resolved.relativePath,
-			language: resolveDashboardFileLanguage(resolved.relativePath),
-			size: file.size,
-			content: file.content
-		};
-	} catch (error) {
-		if (error instanceof Error && (error.message === "文件不存在。" || error.message === "源码路径存在多个候选文件，已拒绝读取。" || error.message === "目标路径不是文件。" || error.message.startsWith("文件超过 ") || error.message.startsWith("文件路径"))) throw error;
-		throw new Error("读取文件失败。");
-	} finally {
-		await Promise.allSettled(openedCandidates.map((candidate) => candidate.handle.close()));
-	}
-}
-function createDashboardFileReader(roots, result, artifacts) {
-	let allowlist = createDashboardContentAllowlist(result);
-	let currentArtifacts = artifacts;
-	let disposed = false;
-	return {
-		read: async (input) => {
-			if (disposed) throw new Error("Dashboard 文件读取会话已关闭。");
-			return await readAllowedDashboardFile(input, roots, allowlist, currentArtifacts);
-		},
-		update(nextResult, nextArtifacts) {
-			allowlist = createDashboardContentAllowlist(nextResult);
-			currentArtifacts = nextArtifacts;
-		},
-		dispose() {
-			disposed = true;
-			currentArtifacts = /* @__PURE__ */ new Map();
-			allowlist.artifactPaths.clear();
-			allowlist.sourcePaths.clear();
-		}
-	};
-}
-//#endregion
-//#region src/cli/analyze/dashboardDevframe/index.ts
-const DEVFRAME_ID = "weapp-vite";
-const MAX_DASHBOARD_ANALYZE_PAGE_CHARACTERS = 65536;
-const STALE_DASHBOARD_ANALYZE_REVISION_MESSAGE = "Analyze revision 已变化，请重新获取 Dashboard 状态。";
+//#region src/cli/analyze/dashboardPolicy.ts
 const rejectDashboardSharedStateSet = defineRpcFunction({
 	name: "devframe:rpc:server-state:set",
 	type: "action",
@@ -2583,145 +2285,30 @@ const rejectDashboardSharedStatePatch = defineRpcFunction({
 		throw new Error("Dashboard Devframe shared state 只允许服务端修改。");
 	}
 });
-function serializeDashboardAnalyzePayload(result) {
-	const value = JSON.stringify(result);
-	return {
-		descriptor: {
-			characters: value.length,
-			hash: createHash("sha256").update(value).digest("hex"),
-			pages: Math.max(1, Math.ceil(value.length / MAX_DASHBOARD_ANALYZE_PAGE_CHARACTERS))
-		},
-		source: result,
-		value
-	};
-}
-function serializeDashboardAnalyzeSnapshot(snapshot, cached) {
-	const previous = snapshot.previous ? cached?.current.source === snapshot.previous ? cached.current : cached?.previous?.source === snapshot.previous ? cached.previous : serializeDashboardAnalyzePayload(snapshot.previous) : null;
-	return {
-		current: cached?.current.source === snapshot.current ? cached.current : serializeDashboardAnalyzePayload(snapshot.current),
-		previous
-	};
-}
-function createDashboardState(revision, snapshot, runtimeEvents) {
-	return {
-		analyze: {
-			current: snapshot.current.descriptor,
-			previous: snapshot.previous?.descriptor ?? null
-		},
-		revision,
-		runtimeEvents: [...runtimeEvents]
-	};
-}
-function normalizeAnalyzePageRequest(input) {
-	if (!input || typeof input !== "object") throw new Error("必须传入合法的 Analyze 分页请求。");
-	if (!("revision" in input) || !("target" in input) || !("index" in input)) throw new Error("必须传入合法的 Analyze 分页请求。");
-	const revision = input.revision;
-	const target = input.target;
-	const index = input.index;
-	if (typeof revision !== "number" || !Number.isSafeInteger(revision) || revision < 0 || target !== "current" && target !== "previous" || typeof index !== "number" || !Number.isSafeInteger(index) || index < 0) throw new Error("必须传入合法的 Analyze 分页请求。");
-	return {
-		revision,
-		target,
-		index
-	};
-}
-function readDashboardAnalyzePage(input, revision, snapshot) {
-	const request = normalizeAnalyzePageRequest(input);
-	if (request.revision !== revision) throw new Error(STALE_DASHBOARD_ANALYZE_REVISION_MESSAGE);
-	const payload = request.target === "current" ? snapshot.current : snapshot.previous;
-	if (!payload || request.index >= payload.descriptor.pages) throw new Error("Analyze 分页不存在。");
-	const start = request.index * MAX_DASHBOARD_ANALYZE_PAGE_CHARACTERS;
+/** 独立宿主在开放 RPC 前禁止全局共享状态写入，不影响嵌入宿主的策略。 */
+function withStandaloneDashboardPolicy(definition) {
 	return {
-		content: payload.value.slice(start, start + MAX_DASHBOARD_ANALYZE_PAGE_CHARACTERS),
-		descriptor: payload.descriptor,
-		index: request.index,
-		revision,
-		target: request.target
-	};
-}
-function createAnalyzeDashboardDevframe(options) {
-	let revision = 0;
-	let disposed = false;
-	let serializedSnapshot = serializeDashboardAnalyzeSnapshot(options.getAnalyzeSnapshot());
-	let broadcastDashboardState;
-	const initialSnapshot = options.getAnalyzeSnapshot();
-	const fileReader = createDashboardFileReader(options.roots, initialSnapshot.current, initialSnapshot.artifacts);
-	const getDashboardState = defineRpcFunction({
-		name: "get-dashboard-state",
-		type: "query",
-		jsonSerializable: true,
-		handler: () => createDashboardState(revision, serializedSnapshot, options.getRuntimeEvents())
-	});
-	const getAnalyzePage = defineRpcFunction({
-		name: "get-analyze-page",
-		type: "query",
-		jsonSerializable: true,
-		handler: (input) => readDashboardAnalyzePage(input, revision, serializedSnapshot)
-	});
-	const readDashboardFile = defineRpcFunction({
-		name: "read-dashboard-file",
-		type: "query",
-		jsonSerializable: true,
-		handler: async (input) => {
-			if (!input || typeof input !== "object" || !("revision" in input) || typeof input.revision !== "number" || !Number.isSafeInteger(input.revision) || input.revision < 0) throw new Error("必须传入合法的文件读取 revision。");
-			const requestedRevision = input.revision;
-			if (disposed || requestedRevision !== revision) throw new Error(STALE_DASHBOARD_ANALYZE_REVISION_MESSAGE);
-			const content = await fileReader.read(input);
-			if (disposed || requestedRevision !== revision) throw new Error(STALE_DASHBOARD_ANALYZE_REVISION_MESSAGE);
-			return content;
-		}
-	});
-	return {
-		definition: defineDevframe({
-			id: DEVFRAME_ID,
-			name: "weapp-vite",
-			version: VERSION,
-			packageName: "weapp-vite",
-			importMetaUrl: import.meta.url,
-			homepage: "https://vite.weapp.dev/",
-			description: "weapp-vite 构建分析与小程序开发工具。",
-			icon: "ph:rocket-launch-duotone",
-			async setup(ctx) {
-				ctx.rpc.register(rejectDashboardSharedStateSet, true);
-				ctx.rpc.register(rejectDashboardSharedStatePatch, true);
-				const dashboard = ctx.scope(DEVFRAME_ID);
-				dashboard.rpc.register(getDashboardState);
-				dashboard.rpc.register(getAnalyzePage);
-				dashboard.rpc.register(readDashboardFile);
-				broadcastDashboardState = async () => {
-					await dashboard.rpc.broadcast({
-						method: "dashboard-state-updated",
-						args: [createDashboardState(revision, serializedSnapshot, options.getRuntimeEvents())],
-						event: true
-					});
-				};
-			}
-		}),
-		notifyAnalyzeUpdate() {
-			if (disposed) return;
-			revision += 1;
-			const snapshot = options.getAnalyzeSnapshot();
-			serializedSnapshot = serializeDashboardAnalyzeSnapshot(snapshot, serializedSnapshot);
-			fileReader.update(snapshot.current, snapshot.artifacts);
-			broadcastDashboardState?.();
-		},
-		syncRuntimeEvents() {
-			broadcastDashboardState?.();
-		},
-		dispose() {
-			disposed = true;
-			fileReader.dispose();
-			broadcastDashboardState = void 0;
+		...definition,
+		async setup(ctx, info) {
+			ctx.rpc.register(rejectDashboardSharedStateSet, true);
+			ctx.rpc.register(rejectDashboardSharedStatePatch, true);
+			await definition.setup?.(ctx, info);
 		}
 	};
 }
 //#endregion
 //#region src/cli/analyze/dashboardViteBridge.ts
 const ANALYZE_DASHBOARD_DEVFRAME_BASE = "/__weapp-vite/";
-function createAnalyzeDashboardViteBridge(definition) {
+const transportPaths = /* @__PURE__ */ new Set([
+	`${ANALYZE_DASHBOARD_DEVFRAME_BASE}${DEVFRAME_CONNECTION_META_FILENAME}`,
+	`${ANALYZE_DASHBOARD_DEVFRAME_BASE}${DEVFRAME_SSE_ROUTE}`,
+	`${ANALYZE_DASHBOARD_DEVFRAME_BASE}${DEVFRAME_WS_ROUTE}`
+]);
+function createAnalyzeDashboardViteBridge(controller) {
 	let instance;
 	let closing;
 	const closeInstance = async () => {
+		controller.dispose();
 		if (closing) return await closing;
 		const current = instance;
 		instance = void 0;
@@ -2735,9 +2322,8 @@ function createAnalyzeDashboardViteBridge(definition) {
 		name: "weapp-vite:dashboard-devframe",
 		apply: "serve",
 		async configureServer(server) {
-			await closeInstance();
 			const httpServer = server.httpServer instanceof Server ? server.httpServer : void 0;
-			const created = initDevframe(definition, {
+			const created = initDevframe(withStandaloneDashboardPolicy(controller.definition), {
 				base: ANALYZE_DASHBOARD_DEVFRAME_BASE,
 				distDir: false,
 				...httpServer ? { server: httpServer } : {
@@ -2748,12 +2334,19 @@ function createAnalyzeDashboardViteBridge(definition) {
 				auth: true,
 				mcp: false
 			});
-			server.middlewares.use(created.nodeMiddleware);
 			try {
+				server.middlewares.use((request, response, next) => {
+					const url = request.url ?? "/";
+					const queryIndex = url.indexOf("?");
+					const pathname = queryIndex < 0 ? url : url.slice(0, queryIndex);
+					if (transportPaths.has(pathname)) created.nodeMiddleware(request, response, next);
+					else next();
+				});
 				await created.ready;
 				instance = created;
 			} catch (error) {
-				await created.close();
+				controller.dispose();
+				await created.close().catch(() => {});
 				throw error;
 			}
 			server.httpServer?.once("close", () => {
@@ -2767,195 +2360,109 @@ function createAnalyzeDashboardViteBridge(definition) {
 }
 //#endregion
 //#region src/cli/analyze/dashboard.ts
-const ANALYZE_DASHBOARD_PACKAGE_NAME = "@weapp-vite/dashboard";
-const require = createRequire(import.meta.url);
 function createInstallCommand(agent) {
 	const resolved = resolveCommand(agent ?? "npm", "install", [ANALYZE_DASHBOARD_PACKAGE_NAME]);
 	if (!resolved) return `npm install ${ANALYZE_DASHBOARD_PACKAGE_NAME}`;
 	return `${resolved.command} ${resolved.args.join(" ")}`;
 }
-function formatEventTimestamp(date = /* @__PURE__ */ new Date()) {
-	return date.toLocaleTimeString("zh-CN", { hour12: false });
-}
-function createDashboardRuntimeEvent(input) {
-	return {
-		id: `dashboard:${Date.now()}:${Math.random().toString(36).slice(2, 8)}`,
-		kind: input.kind,
-		level: input.level,
-		title: input.title,
-		detail: input.detail,
-		timestamp: formatEventTimestamp(),
-		source: input.source ?? "weapp-vite",
-		durationMs: input.durationMs,
-		tags: input.tags,
-		profile: input.profile
-	};
-}
-function readDashboardManifest(packageJsonPath) {
-	try {
-		return parseCommentJson(fs.readFileSync(packageJsonPath, "utf8"));
-	} catch {
-		return;
-	}
-}
-function resolveDashboardDistRoot(packageRoot, manifest) {
-	const distDir = manifest?.weappViteDashboard?.distDir ?? "dist";
-	const distRoot = path.resolve(packageRoot, distDir);
-	if (!fs.existsSync(distRoot)) return;
-	return { root: distRoot };
-}
-function resolveDashboardDevRoot(packageRoot, manifest) {
-	const devRoot = manifest?.weappViteDashboard?.devRoot;
-	const devConfigFile = manifest?.weappViteDashboard?.devConfigFile;
-	if (!devRoot || !devConfigFile) return;
-	const root = path.resolve(packageRoot, devRoot);
-	const configFile = path.resolve(root, devConfigFile);
-	if (!fs.existsSync(root) || !fs.existsSync(configFile)) return;
-	return {
-		root,
-		configFile
-	};
-}
-function resolveDashboardRoot(options) {
-	const resolvePaths = options?.cwd && options.cwd !== process.cwd() ? [options.cwd, process.cwd()] : options?.cwd ? [options.cwd] : void 0;
-	let dashboardPackageRoot;
-	let dashboardManifest;
-	try {
-		const dashboardPackageJsonPath = require.resolve(`${ANALYZE_DASHBOARD_PACKAGE_NAME}/package.json`, { paths: resolvePaths });
-		dashboardPackageRoot = path.dirname(dashboardPackageJsonPath);
-		dashboardManifest = readDashboardManifest(dashboardPackageJsonPath);
-	} catch {
-		dashboardPackageRoot = void 0;
-		dashboardManifest = void 0;
-	}
-	if (dashboardPackageRoot) {
-		const devResolved = resolveDashboardDevRoot(dashboardPackageRoot, dashboardManifest);
-		const distResolved = resolveDashboardDistRoot(dashboardPackageRoot, dashboardManifest);
-		const resolved = options?.watch ? devResolved ?? distResolved : distResolved ?? devResolved;
-		if (resolved) return resolved;
-	}
-	logger_default.warn(`[weapp-vite ui] 未安装可选仪表盘包 ${colors.bold(colors.green(ANALYZE_DASHBOARD_PACKAGE_NAME))}，已自动降级关闭 dashboard 能力。`);
-	logger_default.info(`如需启用，请执行 ${colors.bold(colors.green(createInstallCommand(options?.packageManagerAgent)))}`);
-}
-async function waitForServerExit(server) {
-	let resolved = false;
-	const cleanup = async () => {
-		if (resolved) return;
-		resolved = true;
-		try {
-			await server.close();
-		} catch (error) {
-			logger_default.error(error);
-		}
-	};
-	const signals = ["SIGINT", "SIGTERM"];
-	await new Promise((resolvePromise) => {
-		const resolveOnce = async () => {
-			await cleanup();
-			signals.forEach((signal) => {
-				process.removeListener(signal, resolveOnce);
-			});
-			resolvePromise();
-		};
-		signals.forEach((signal) => {
-			process.once(signal, resolveOnce);
-		});
-		server.httpServer?.once("close", resolveOnce);
-	});
-}
 async function startAnalyzeDashboard(result, options) {
 	const resolved = resolveDashboardRoot(options);
-	if (!resolved) return;
+	if (!resolved) {
+		logger_default.warn(`[weapp-vite ui] 未安装可选仪表盘包 ${colors.bold(colors.green(ANALYZE_DASHBOARD_PACKAGE_NAME))}，已自动降级关闭 dashboard 能力。`);
+		logger_default.info(`如需启用，请执行 ${colors.bold(colors.green(createInstallCommand(options.packageManagerAgent)))}`);
+		return;
+	}
 	const { root, configFile } = resolved;
-	const state = {
-		current: result,
-		previous: options.previousResult ?? null,
-		artifacts: options.artifacts
-	};
-	const runtimeEvents = { current: [createDashboardRuntimeEvent({
-		kind: "command",
-		level: "success",
-		title: options?.watch ? "dashboard watch session started" : "dashboard static session started",
-		detail: options?.watch ? "weapp-vite UI 已进入实时分析模式，后续 analyze 结果会继续推送到 dashboard。" : "weapp-vite UI 已进入静态分析模式，当前页面展示的是一次性分析结果。",
-		tags: options?.watch ? ["watch", "analyze"] : ["static", "analyze"]
-	}), ...(options?.initialEvents ?? []).map((event) => createDashboardRuntimeEvent(event))] };
 	const devframe = createAnalyzeDashboardDevframe({
-		getAnalyzeSnapshot: () => state,
-		getRuntimeEvents: () => runtimeEvents.current,
+		snapshot: {
+			current: result,
+			previous: options.previousResult ?? null,
+			artifacts: options.artifacts
+		},
+		initialEvents: [{
+			kind: "command",
+			level: "success",
+			title: options.watch ? "dashboard watch session started" : "dashboard static session started",
+			detail: options.watch ? "weapp-vite UI 已进入实时分析模式，后续 analyze 结果会继续推送到 dashboard。" : "weapp-vite UI 已进入静态分析模式，当前页面展示的是一次性分析结果。",
+			tags: options.watch ? ["watch", "analyze"] : ["static", "analyze"]
+		}, ...options.initialEvents ?? []],
 		roots: {
-			pluginRoot: options?.pluginRoot,
-			projectRoot: options?.cwd,
-			srcRoot: options?.srcRoot ?? (options?.cwd ? path.resolve(options.cwd, "src") : void 0)
+			pluginRoot: options.pluginRoot,
+			projectRoot: options.cwd,
+			srcRoot: options.srcRoot ?? (options.cwd ? path.resolve(options.cwd, "src") : void 0)
 		}
 	});
-	const plugins = [createAnalyzeDashboardViteBridge(devframe.definition)];
-	const serverOptions = {
-		root,
-		configFile: configFile ?? false,
-		clearScreen: false,
-		appType: "spa",
-		publicDir: false,
-		plugins,
-		server: {
-			host: "127.0.0.1",
-			port: 0,
-			watch: { ignored: ["**/*"] }
-		},
-		logLevel: "error"
-	};
-	const server = await createServer(serverOptions);
-	const requestedPort = typeof serverOptions.server?.port === "number" ? serverOptions.server.port : void 0;
-	await server.listen(requestedPort);
-	const urls = (() => {
-		const resolved = server.resolvedUrls;
-		if (!resolved) return [];
-		return [...resolved.local ?? [], ...resolved.network ?? []];
-	})();
+	let server;
+	try {
+		server = await createServer({
+			root,
+			base: ANALYZE_DASHBOARD_DEVFRAME_BASE,
+			configFile: configFile ?? false,
+			clearScreen: false,
+			appType: "spa",
+			publicDir: false,
+			plugins: [{
+				name: "weapp-vite:dashboard-lifetime",
+				enforce: "pre",
+				configureServer(createdServer) {
+					server = createdServer;
+				}
+			}, createAnalyzeDashboardViteBridge(devframe)],
+			server: {
+				host: "127.0.0.1",
+				port: 0,
+				watch: { ignored: ["**/*"] }
+			},
+			logLevel: "error"
+		});
+		await server.listen(0);
+	} catch (error) {
+		devframe.dispose();
+		await server?.close().catch((closeError) => logger_default.error(closeError));
+		throw error;
+	}
+	const activeServer = server;
+	const urls = [...activeServer.resolvedUrls?.local ?? [], ...activeServer.resolvedUrls?.network ?? []];
 	const authCode = refreshTempAuthCode();
 	const authenticatedUrls = urls.map((url) => buildOtpAuthUrl(url, authCode));
-	let closed = false;
-	const waitPromise = waitForServerExit(server).then(() => {
-		closed = true;
-		state.artifacts = /* @__PURE__ */ new Map();
-		devframe.dispose();
+	let closing;
+	let resolveExit;
+	const waitPromise = new Promise((resolve) => {
+		resolveExit = resolve;
 	});
-	const emitRuntimeEvents = (events) => {
-		if (events.length === 0) return;
-		const nextEvents = events.map((event) => createDashboardRuntimeEvent(event));
-		runtimeEvents.current = [...nextEvents, ...runtimeEvents.current].slice(0, 24);
-		devframe.syncRuntimeEvents();
+	const signals = ["SIGINT", "SIGTERM"];
+	let onExit;
+	const close = () => {
+		if (!closing) {
+			devframe.dispose();
+			closing = Promise.resolve().then(() => activeServer.close()).finally(() => {
+				for (const signal of signals) process.removeListener(signal, onExit);
+				activeServer.httpServer?.removeListener("close", onExit);
+				resolveExit();
+			});
+		}
+		return closing;
+	};
+	onExit = async () => {
+		await close().catch((error) => logger_default.error(error));
 	};
+	for (const signal of signals) process.once(signal, onExit);
+	activeServer.httpServer?.once("close", onExit);
 	const handle = {
-		async update(nextResult, artifacts, previousResult) {
-			if (closed) return;
-			state.previous = previousResult ?? state.current;
-			state.current = nextResult;
-			state.artifacts = artifacts;
-			emitRuntimeEvents([{
-				kind: "build",
-				level: "info",
-				title: "analyze payload refreshed",
-				detail: `已推送新的 analyze 结果，当前包含 ${nextResult.packages.length} 个包与 ${nextResult.modules.length} 个模块。`,
-				tags: ["analyze", "refresh"]
-			}]);
-			devframe.notifyAnalyzeUpdate();
-		},
-		emitRuntimeEvents,
+		update: devframe.update,
+		emitRuntimeEvents: devframe.emitRuntimeEvents,
 		waitForExit: () => waitPromise,
-		close: async () => {
-			closed = true;
-			await server.close();
-		},
+		close,
 		urls: authenticatedUrls
 	};
-	if (options?.watch) {
+	if (options.watch) {
 		if (!options.silentStartupLog) {
 			logger_default.info("weapp-vite UI 已启动（分析视图，实时模式），按 Ctrl+C 退出。");
 			for (const url of handle.urls) logger_default.info(`  ➜  ${colors.bold(colors.cyan(url))}`);
 		}
 		return handle;
 	}
-	if (!options?.silentStartupLog) {
+	if (!options.silentStartupLog) {
 		logger_default.info("weapp-vite UI 已启动（分析视图，静态模式），按 Ctrl+C 退出。");
 		for (const url of handle.urls) logger_default.info(`  ➜  ${colors.bold(colors.cyan(url))}`);
 	}
@@ -3453,6 +2960,335 @@ function setCommandNodeEnv(nodeEnv) {
 	process.env.NODE_ENV = nodeEnv;
 }
 //#endregion
+//#region src/cli/upload/autoMetadata.ts
+/** 只读取命令根目录的清单，不向父目录查找或修改文件。 */
+async function readPackageVersion(packagePath) {
+	let manifest;
+	try {
+		manifest = JSON.parse(await readFile(packagePath, "utf8"));
+	} catch (cause) {
+		throw new Error("--bump 无法读取命令根目录的 package.json。", { cause });
+	}
+	if (manifest === null || typeof manifest !== "object" || !("version" in manifest) || typeof manifest.version !== "string") throw new Error("--bump 要求命令根目录 package.json 的 version 为有效的 SemVer 字符串。");
+	return manifest.version;
+}
+/** 在首次编译配置求值前准备一次元数据；预演不写文件，实际版本由 npm 同步。 */
+async function prepareAutoUploadMetadata(cwd, options, action) {
+	const { bump, gitDesc } = options;
+	if (action === "preview" && (bump !== void 0 || gitDesc !== void 0)) throw new Error("--bump 和 --git-desc 仅支持 upload 或 build --upload，不支持 preview。");
+	if (bump === void 0 && !gitDesc) return options;
+	if (bump !== void 0 && options.uv !== void 0) throw new Error("--bump 不能与 --uv 同时使用。");
+	if (gitDesc && options.desc !== void 0) throw new Error("--git-desc 不能与 --desc 同时使用。");
+	if (bump !== void 0 && bump !== "patch" && bump !== "minor" && bump !== "major") throw new Error("--bump 仅支持 patch、minor 或 major。");
+	const root = path$1.resolve(cwd);
+	const packagePath = path$1.join(root, "package.json");
+	let currentVersion;
+	let nextVersion;
+	if (bump !== void 0) {
+		currentVersion = await readPackageVersion(packagePath);
+		nextVersion = semverInc(currentVersion, bump) ?? void 0;
+		if (!nextVersion) throw new Error("--bump 要求命令根目录 package.json 的 version 为有效的 SemVer 字符串。");
+	}
+	let desc;
+	if (gitDesc) {
+		try {
+			desc = (await x("git", [
+				"log",
+				"-1",
+				"--format=%s"
+			], {
+				nodePath: false,
+				throwOnError: true,
+				nodeOptions: { cwd: root }
+			})).stdout.trim();
+		} catch (cause) {
+			throw new Error("--git-desc 无法读取最新 Git 提交主题，请确认 Git 可用且仓库已有提交。", { cause });
+		}
+		if (!desc) throw new Error("--git-desc 要求最新 Git 提交主题非空。");
+	}
+	if (nextVersion) {
+		if (options.dryRun) logger_default.info(`[upload] dry-run：计划版本 ${currentVersion} → ${nextVersion}，未修改 package.json 或锁文件。`);
+		else {
+			try {
+				await x("npm", [
+					"version",
+					nextVersion,
+					"--no-git-tag-version",
+					"--ignore-scripts",
+					"--workspaces=false",
+					"--prefix",
+					root
+				], {
+					nodePath: false,
+					throwOnError: true,
+					nodeOptions: { cwd: root }
+				});
+			} catch (cause) {
+				throw new Error("--bump 执行 npm version 失败，请检查本地版本与锁文件后重试。", { cause });
+			}
+			if (await readPackageVersion(packagePath) !== nextVersion) throw new Error("--bump 执行 npm version 后，命令根目录的 package.json 版本未按预期更新。");
+			logger_default.info(`[upload] 版本已更新：${currentVersion} → ${nextVersion}。后续构建或上传失败不会回退；重试同一版本时请移除 --bump。`);
+		}
+	}
+	if (gitDesc) logger_default.info("[upload] 使用最新 Git 提交主题作为上传说明。");
+	const metadata = { ...options };
+	if (nextVersion !== void 0) metadata.uv = nextVersion;
+	if (desc !== void 0) metadata.desc = desc;
+	return metadata;
+}
+//#endregion
+//#region src/cli/upload/env.ts
+/** 凭据不经过 Vite 的 env 调试日志；文件优先级和进程环境覆盖规则保持一致。 */
+async function loadUploadEnv(cwd, mode, root, envDir) {
+	if (envDir === false) return { ...process.env };
+	if (mode === "local") throw new Error("local 不能作为 mode，因为它与 .env.local 文件后缀冲突。");
+	const directory = path$1.resolve(cwd, root ?? ".", envDir ?? ".");
+	const parsed = {};
+	for (const file of [
+		".env",
+		".env.local",
+		`.env.${mode}`,
+		`.env.${mode}.local`
+	]) {
+		const content = await readFile(path$1.join(directory, file), "utf8").catch((error) => {
+			if (error.code === "ENOENT") return "";
+			throw error;
+		});
+		Object.assign(parsed, parseEnv(content));
+	}
+	const processEnv = { ...parsed };
+	for (const [key, value] of Object.entries(process.env)) if (value !== void 0) processEnv[key] = value;
+	expand({
+		parsed,
+		processEnv
+	});
+	return {
+		...parsed,
+		...process.env
+	};
+}
+//#endregion
+//#region src/cli/upload/result.ts
+/** 只接受可展示的预览结果，文件必须由本次任务生成，不能沿用旧二维码。 */
+async function validatePreviewResult(value, context) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error("预览工具未返回二维码或预览链接。");
+	const input = value;
+	const result = {};
+	for (const key of ["qrCodeUrl", "previewUrl"]) {
+		if (input[key] === void 0) continue;
+		if (typeof input[key] !== "string" || !input[key].trim()) throw new Error("预览工具返回了无效链接。");
+		let url;
+		try {
+			url = new URL(input[key]);
+		} catch {
+			throw new Error("预览工具返回了无效链接。");
+		}
+		if (url.username || url.password || key === "qrCodeUrl" && url.protocol !== "http:" && url.protocol !== "https:" || [
+			"javascript:",
+			"data:",
+			"file:"
+		].includes(url.protocol)) throw new Error("预览工具返回了不支持的链接类型。");
+		result[key] = input[key];
+	}
+	if (input.qrCodeFile !== void 0) {
+		if (typeof input.qrCodeFile !== "string" || !context.qrCodePath || path$1.resolve(input.qrCodeFile) !== path$1.resolve(context.qrCodePath)) throw new Error("预览工具返回的二维码文件不是本次任务的输出路径。");
+		const file = await stat(input.qrCodeFile);
+		if (!file.isFile() || file.size === 0) throw new Error("预览二维码文件不存在或为空。");
+		result.qrCodeFile = input.qrCodeFile;
+	}
+	if (!result.qrCodeUrl && !result.previewUrl && !result.qrCodeFile) throw new Error("预览工具未返回二维码或预览链接。");
+	return result;
+}
+//#endregion
+//#region src/cli/upload/process.ts
+/** 隔离官方 SDK 的日志和进程级副作用，主进程通过 stdin 传入上下文。 */
+async function executeUpload(platform, context, secrets, action = "upload") {
+	let result;
+	const output = await new Promise((resolve, reject) => {
+		const child = fork(fileURLToPath(new URL("./upload-worker.mjs", import.meta.url)), [], {
+			cwd: context.cwd,
+			env: context.env,
+			execArgv: [],
+			stdio: [
+				"pipe",
+				"pipe",
+				"pipe",
+				"ipc"
+			]
+		});
+		let completed = false;
+		let exceeded = false;
+		let captured = "";
+		let cancelled = false;
+		const cancel = () => {
+			cancelled = true;
+			child.kill();
+		};
+		process.once("SIGINT", cancel);
+		process.once("SIGTERM", cancel);
+		const collect = (chunk) => {
+			if (exceeded) return;
+			captured += chunk;
+			if (captured.length > 4194304) {
+				exceeded = true;
+				child.kill();
+			}
+		};
+		child.stdout?.setEncoding("utf8").on("data", collect);
+		child.stderr?.setEncoding("utf8").on("data", collect);
+		child.on("message", (message) => {
+			if (message !== null && typeof message === "object" && "type" in message && message.type === "completed" && "action" in message && message.action === action) {
+				completed = true;
+				result = "result" in message ? message.result : void 0;
+			}
+		});
+		child.once("error", reject);
+		child.once("close", (code, signal) => {
+			process.off("SIGINT", cancel);
+			process.off("SIGTERM", cancel);
+			const safeOutput = redactUploadSecrets(captured, secrets).trim();
+			if (code !== 0 || !completed || exceeded || cancelled) {
+				reject(/* @__PURE__ */ new Error(`${platform} ${action === "preview" ? "预览" : "上传"}失败（${exceeded ? "日志超限" : signal ?? code ?? "unknown"}，${completed ? "进程异常结束" : "未收到完成确认"}）${safeOutput ? `\n${safeOutput}` : ""}`));
+				return;
+			}
+			resolve(safeOutput);
+		});
+		child.stdin?.on("error", () => {});
+		child.stdin?.end(JSON.stringify({
+			platform,
+			context,
+			action
+		}));
+	});
+	if (output) logger_default.info(output);
+	return action === "preview" ? validatePreviewResult(result, context) : void 0;
+}
+//#endregion
+//#region src/cli/upload/project.ts
+/** 确保官方工具读取的目录正是本次构建输出，拒绝误传旧目录或同名配置。 */
+async function validateUploadProject(options) {
+	const { projectConfigFileName } = getProjectPlatformOptions(options.platform);
+	if (options.sourceConfigPath && path$1.basename(options.sourceConfigPath) !== projectConfigFileName) throw new Error(`上传工具只读取 ${projectConfigFileName}，请使用此标准文件名，避免读取其他项目配置。`);
+	const configPath = path$1.join(options.projectPath, projectConfigFileName);
+	const config = JSON.parse(await readFile(configPath, "utf8"));
+	if (!config || typeof config !== "object" || Array.isArray(config)) throw new TypeError(`${projectConfigFileName} 必须是 JSON 对象。`);
+	const rootKey = options.platform === "swan" ? "smartProgramRoot" : "miniprogramRoot";
+	const root = config[rootKey];
+	if (typeof root !== "string" || !root.trim()) throw new Error(`${projectConfigFileName} 缺少代码目录 ${rootKey}。`);
+	const sdkRoot = path$1.resolve(options.projectPath, root);
+	const [actualRoot, outputRoot] = await Promise.all([realpath(sdkRoot), realpath(options.outDir)]);
+	if (actualRoot !== outputRoot) throw new Error(`${projectConfigFileName} 的代码目录与本次构建输出不一致，已阻止上传旧产物。请检查项目配置根目录与 build.outDir。`);
+	await access(path$1.join(outputRoot, "app.json"));
+}
+//#endregion
+//#region src/cli/upload/builtProject.ts
+/** 仅由显式上传或预览入口读取参数，不执行构建或调用平台工具。 */
+async function createUploadTarget(config, options, action) {
+	if (config.weappLibConfig?.enabled || config.pluginOnly) throw new Error(`${action} 仅支持完整小程序项目，不支持组件库或独立插件构建。`);
+	const platform = resolveUploadPlatforms(config.platform)[0];
+	const uploadConfig = action === "upload" ? config.weappViteConfig.upload : void 0;
+	const version = (options.uv ?? uploadConfig?.version ?? config.packageJson.version)?.trim() ?? "";
+	if (action === "upload" && !version) throw new Error("请通过 --uv、weapp.upload.version 或项目 package.json 的 version 指定上传版本。");
+	const desc = (options.desc ?? uploadConfig?.desc)?.trim() || `${config.packageJson.name ?? platform}${version ? `@${version}` : ""}`;
+	const env = options.dryRun ? {} : await loadUploadEnv(config.cwd, config.mode, config.inlineConfig.root, config.inlineConfig.envDir);
+	const { projectConfigFileName } = getProjectPlatformOptions(config.platform);
+	const generatedProjectConfig = config.multiPlatform.projectConfigs !== void 0;
+	const projectPath = generatedProjectConfig ? config.outDir : config.multiPlatform.enabled ? path$1.dirname(config.outDir) : path$1.dirname(config.projectConfigPath ?? path$1.join(config.cwd, projectConfigFileName));
+	const appid = config.projectConfig.appid ?? config.projectConfig.appId;
+	const target = {
+		platform,
+		sourceConfigPath: config.projectConfigPath,
+		context: {
+			cwd: config.cwd,
+			projectPath,
+			appid: typeof appid === "string" ? appid : void 0,
+			version,
+			desc,
+			qrCodePath: action === "preview" && !options.dryRun ? path$1.join(config.cwd, ".weapp-vite", "preview", `${platform}-${randomUUID()}.png`) : void 0,
+			env: {
+				...process.env,
+				...env
+			}
+		}
+	};
+	(config.inlineConfig.plugins ??= []).push({
+		name: "weapp-vite:upload-output",
+		apply: (viteConfig) => resolveWeappViteHostMeta(viteConfig)?.runtime === "miniprogram",
+		writeBundle(output, bundle) {
+			if (output.dir && Object.hasOwn(bundle, "app.json")) {
+				target.outDir = path$1.resolve(output.dir);
+				if (generatedProjectConfig) target.context.projectPath = target.outDir;
+			}
+		}
+	});
+	return target;
+}
+/** 只消费本次构建的产物；产物校验通过前不会准备凭据或调用平台工具。 */
+async function executeUploadTarget(target, options, action) {
+	const { platform, context } = target;
+	if (!target.outDir) throw new Error("本次构建未写出 app.json，已阻止上传或预览旧产物。");
+	await validateUploadProject({
+		platform,
+		projectPath: context.projectPath,
+		outDir: target.outDir,
+		sourceConfigPath: target.sourceConfigPath
+	});
+	if (options.dryRun) {
+		logger_default.success(`[${action}:${platform}] dry-run：构建完成，未校验凭据或调用平台工具。项目：${path$1.relative(context.cwd, context.projectPath) || "."}`);
+		return;
+	}
+	const upload = await prepareUpload(platform, context, action);
+	const result = await executeUpload(platform, context, upload.secrets, action);
+	if (action === "preview") {
+		if (!result) throw new Error("预览工具未返回二维码或预览链接。");
+		for (const [label, value] of [
+			["二维码图片", result.qrCodeUrl],
+			["预览链接", result.previewUrl],
+			["二维码文件", result.qrCodeFile && path$1.relative(context.cwd, result.qrCodeFile)]
+		]) if (value) logger_default.info(`[preview:${platform}] ${label}：${redactUploadSecrets(value, upload.secrets)}`);
+		logger_default.success(`[preview:${platform}] 预览已生成（未上传开发版本、未提审、未正式发布）。`);
+	} else logger_default.success(`[upload:${platform}] ${context.version} 上传完成（未提审、未正式发布）。`);
+}
+//#endregion
+//#region src/cli/upload/options.ts
+function readUploadMetadata(cli) {
+	for (const name of [
+		"uv",
+		"desc",
+		"bump"
+	]) {
+		const value = cli.options[name];
+		if (typeof value === "boolean" || Array.isArray(value) && value.some((item) => typeof item === "boolean")) throw new Error(`--${name} 需要指定字符串参数。`);
+	}
+	const { values } = parseArgs({
+		args: cli.rawArgs.slice(2),
+		allowPositionals: true,
+		strict: false,
+		options: {
+			uv: { type: "string" },
+			desc: { type: "string" },
+			bump: { type: "string" }
+		}
+	});
+	return {
+		uv: typeof values.uv === "string" ? values.uv : void 0,
+		desc: typeof values.desc === "string" ? values.desc : void 0,
+		bump: typeof values.bump === "string" ? values.bump : void 0
+	};
+}
+/** 普通构建不读取上传元数据；上传必须是显式的一次性构建操作。 */
+function resolveBuildUploadOptions(cli, options) {
+	if (options.upload !== true) {
+		if (options.uv !== void 0 || options.desc !== void 0 || options.bump !== void 0 || options.gitDesc !== void 0 || options.dryRun !== void 0) throw new Error("--uv、--desc、--bump、--git-desc 和 --dry-run 仅能与 --upload 一起使用。");
+		return;
+	}
+	if (options.watch) throw new Error("--upload 不能与 --watch 一起使用，请执行一次性构建。");
+	return {
+		...options,
+		...readUploadMetadata(cli)
+	};
+}
+//#endregion
 //#region src/cli/commands/build.ts
 function emitDashboardEvents$1(handle, events) {
 	handle?.emitRuntimeEvents(events);
@@ -3488,17 +3324,21 @@ function scheduleCompletedProductionBuildExit(options, analyzeHandle) {
 	}, 0).unref?.();
 }
 function registerBuildCommand(cli) {
-	cli.command("build [root]", "build for production").option("--target <target>", `[string] transpile target (default: 'modules')`).option("--outDir <dir>", `[string] output directory (default: dist)`).option("-p, --platform <platform>", `[string] target platform (weapp | web | all)`).option("--project-config <path>", `[string] project config path (miniprogram only)`).option("--sourcemap [output]", `[boolean | "inline" | "hidden"] output source maps for build (default: false)`).option("--minify [minifier]", "[boolean | \"terser\" | \"esbuild\"] enable/disable minification, or specify minifier to use (default: esbuild)").option("--emptyOutDir", `[boolean] force empty outDir when it's outside of root`).option("-w, --watch", `[boolean] rebuilds when modules have changed on disk`).option("--skipNpm", `[boolean] if skip npm build`).option("-o, --open", `[boolean] open ide`).option("--trust-project", "[boolean] auto trust Wechat DevTools project on open", { default: true }).option("--ide-open-strategy <strategy>", "[string] IDE open strategy (cli | automator)", { default: "cli" }).option("--no-open-recovery", "[boolean] disable automatic Wechat DevTools close-and-reopen recovery").option("--ui", `[boolean] 启动调试 UI（当前提供分析视图）`, { default: false }).option("--analyze", `[boolean] 输出分包分析仪表盘`, { default: false }).option("--scope <scope>", `[string] 局部构建范围，例如 main,packages/order`).action(async (root, options) => {
+	cli.command("build [root]", "build for production").option("--target <target>", `[string] transpile target (default: 'modules')`).option("--outDir <dir>", `[string] output directory (default: dist)`).option("-p, --platform <platform>", `[string] target platform (weapp | web | all)`).option("--project-config <path>", `[string] project config path (miniprogram only)`).option("--sourcemap [output]", `[boolean | "inline" | "hidden"] output source maps for build (default: false)`).option("--minify [minifier]", "[boolean | \"terser\" | \"esbuild\"] enable/disable minification, or specify minifier to use (default: esbuild)").option("--emptyOutDir", `[boolean] force empty outDir when it's outside of root`).option("-w, --watch", `[boolean] rebuilds when modules have changed on disk`).option("--skipNpm", `[boolean] if skip npm build`).option("-o, --open", `[boolean] open ide`).option("--trust-project", "[boolean] auto trust Wechat DevTools project on open", { default: true }).option("--ide-open-strategy <strategy>", "[string] IDE open strategy (cli | automator)", { default: "cli" }).option("--no-open-recovery", "[boolean] disable automatic Wechat DevTools close-and-reopen recovery").option("--ui", `[boolean] 启动调试 UI（当前提供分析视图）`, { default: false }).option("--analyze", `[boolean] 输出分包分析仪表盘`, { default: false }).option("--scope <scope>", `[string] 局部构建范围，例如 main,packages/order`).option("--upload", "[boolean] upload the mini program after this build succeeds").option("--uv <version>", "[string] upload version override (requires --upload)").option("--desc <text>", "[string] upload description override (requires --upload)").option("--bump <release>", "[string] increment local package version (patch | minor | major; requires --upload)").option("--git-desc", "[boolean] use the latest Git commit subject (requires --upload)").option("--dry-run", "[boolean] validate upload output without credentials or SDK calls (requires --upload)").action(async (root, options) => {
 		let analyzeHandle;
 		let ctx;
 		let targets;
 		let buildCompleted = false;
 		try {
+			options = { ...options };
 			filterDuplicateOptions(options);
+			let uploadOptions = resolveBuildUploadOptions(cli, options);
 			setCommandNodeEnv("production");
 			const cwd = root ?? process.cwd();
 			const configFile = resolveConfigFile(options);
 			targets = resolveRuntimeTargets(options);
+			if (uploadOptions && !getBackendForCapability(targets, "miniprogram", "build")) throw new Error("--upload 仅支持包含小程序目标的构建，不能用于纯 Web 构建。");
+			if (uploadOptions) uploadOptions = await prepareAutoUploadMetadata(cwd, uploadOptions, "upload");
 			const inlineConfig = createInlineConfig(targets, {
 				scope: options.scope,
 				inlineConfig: createBuildInlineConfig(options)
@@ -3514,6 +3354,7 @@ function registerBuildCommand(cli) {
 				preloadAppEntry: false
 			});
 			const { configService } = ctx;
+			const uploadTarget = uploadOptions ? await createUploadTarget(configService, uploadOptions, "upload") : void 0;
 			const miniBackend = getBackendForCapability(targets, "miniprogram", "build");
 			const webBackend = getBackendForCapability(targets, "web", "build");
 			logRuntimeTarget(targets, { resolvedConfigPlatform: configService.platform });
@@ -3591,6 +3432,7 @@ function registerBuildCommand(cli) {
 					throw error;
 				}
 			}
+			if (uploadTarget && uploadOptions) await executeUploadTarget(uploadTarget, uploadOptions, "upload");
 			if (miniBackend) logBuildAppFinish(configService, void 0, { skipWeb: !webBackend });
 			if (options.open && getBackendForCapability(targets, "miniprogram", "ide")) {
 				emitDashboardEvents$1(analyzeHandle, [{
@@ -3600,7 +3442,8 @@ function registerBuildCommand(cli) {
 					detail: "构建完成后准备打开 IDE 项目。",
 					tags: ["ide", "open"]
 				}]);
-				await openIde(configService.platform, resolveIdeProjectPath(configService.mpDistRoot), {
+				const generatedProjectConfig = configService.multiPlatform.projectConfigs !== void 0;
+				await openIde(configService.platform, resolveIdeProjectPath(generatedProjectConfig ? configService.outDir : configService.mpDistRoot, generatedProjectConfig), {
 					openRecovery: options.openRecovery,
 					trustProject: options.trustProject,
 					openStrategy: options.ideOpenStrategy
@@ -3987,7 +3830,9 @@ async function closeActiveForwardConsole() {
 */
 async function maybeStartForwardConsole(options) {
 	if (options.platform !== "weapp") return false;
-	const projectPath = resolveIdeProjectPath(options.mpDistRoot) ?? options.cwd;
+	const multiPlatform = options.weappViteConfig?.multiPlatform;
+	const generatedProjectConfig = typeof multiPlatform === "object" && multiPlatform.projectConfigs !== void 0;
+	const projectPath = resolveIdeProjectRoot(options.mpDistRoot, options.cwd, generatedProjectConfig);
 	if (!projectPath) return false;
 	if (activeForwardConsoleSession) return true;
 	if (activeForwardConsoleStart) return await activeForwardConsoleStart;
@@ -5370,7 +5215,7 @@ function resolveRunnableHotkeyDefinition(input) {
 }
 //#endregion
 //#region package.json
-var version = "7.3.0";
+var version = "7.4.0";
 //#endregion
 //#region src/cli/devHotkeys/format.ts
 const FULLWIDTH_ASCII_START = 65281;
@@ -6110,6 +5955,7 @@ function registerServeCommand(cli) {
 		logRuntimeTarget(targets, { resolvedConfigPlatform: configService.platform });
 		const enableAnalyze = Boolean(isUiEnabled(options) && miniBackend);
 		let analyzeHandle;
+		const generatedProjectConfig = configService.multiPlatform.projectConfigs !== void 0;
 		const miniProgramDevActions = createServeMiniProgramDevActions({
 			build: async () => {
 				await miniBackend?.driver.dev(ctx, options);
@@ -6134,7 +5980,7 @@ function registerServeCommand(cli) {
 				});
 				writePostOpenSeparator();
 			},
-			projectPath: resolveIdeProjectRoot(configService.mpDistRoot, configService.cwd),
+			projectPath: resolveIdeProjectRoot(configService.mpDistRoot, configService.cwd, generatedProjectConfig),
 			startForwardConsole: async (openOptions) => {
 				if (resolveServeIdeOpenStrategy(openOptions, options.ideOpenStrategy) === "automator") return await maybeStartForwardConsole({
 					openedOnly: true,
@@ -6150,7 +5996,7 @@ function registerServeCommand(cli) {
 					cwd: configService.cwd,
 					preferOpenedSession: false,
 					recoverAutomatorSession: async () => {
-						const projectPath = resolveIdeProjectRoot(configService.mpDistRoot, configService.cwd);
+						const projectPath = resolveIdeProjectRoot(configService.mpDistRoot, configService.cwd, generatedProjectConfig);
 						await openIde(configService.platform, projectPath, {
 							loginRetry: options.loginRetry,
 							loginRetryTimeout: options.loginRetryTimeout,
@@ -6292,6 +6138,56 @@ function registerServeCommand(cli) {
 	});
 }
 //#endregion
+//#region src/cli/commands/upload.ts
+async function buildUploadTarget(cwd, platform, options, action) {
+	const targets = resolveRuntimeTargets({ platform });
+	const ctx = await createCompilerContext({
+		cwd,
+		mode: options.mode ?? "production",
+		configFile: resolveConfigFile(options),
+		inlineConfig: createInlineConfig(targets),
+		cliPlatform: platform,
+		projectConfigPath: options.projectConfig,
+		emitDefaultAutoImportOutputs: false,
+		preloadAppEntry: false
+	});
+	try {
+		const target = await createUploadTarget(ctx.configService, options, action);
+		logger_default.info(`[${action}:${target.platform}] 构建${target.context.version ? ` ${target.context.version}` : ""}`);
+		await ctx.buildService.build({});
+		return target;
+	} finally {
+		ctx.watcherService.closeAll();
+		terminateStaleSassEmbeddedProcess();
+	}
+}
+async function runUploadCommand(root, options, action = "upload") {
+	filterDuplicateOptions(options);
+	const platforms = resolveUploadPlatforms(options.platform ?? options.p);
+	setCommandNodeEnv("production");
+	const cwd = path$1.resolve(root ?? process.cwd());
+	options = await prepareAutoUploadMetadata(cwd, options, action);
+	for (const platform of platforms) await executeUploadTarget(await buildUploadTarget(cwd, platform, options, action), options, action);
+}
+function registerUploadCommand(cli) {
+	cli.command("upload [root]", "build and upload mini programs (does not submit for review or publish)").option("-p, --platform <platform>", "[string] weapp | alipay | tt | xhs | jd | swan; comma-separated targets or all").option("--project-config <path>", "[string] project config path").option("--uv <version>", "[string] upload version (default: weapp.upload.version or package.json version)").option("--desc <text>", "[string] upload description (default: weapp.upload.desc or project name and version)").option("--bump <release>", "[string] increment local package version once (patch | minor | major; dry-run does not write)").option("--git-desc", "[boolean] use the latest Git commit subject as upload description").option("--dry-run", "[boolean] build without validating upload credentials or uploading").example("wv upload -p weapp").example("wv upload -p xhs,tt --bump patch --git-desc --dry-run").example("wv upload --project ./dist --version 1.2.3 --desc \"release\"  (deprecated IDE syntax; use wv ide upload to retain IDE behavior)").action(async (root, options) => {
+		await runUploadCommand(root, {
+			...options,
+			...readUploadMetadata(cli)
+		});
+		scheduleCompletedProductionBuildExit({}, void 0);
+	});
+}
+function registerPreviewCommand(cli) {
+	cli.command("preview [root]", "build mini programs and generate preview QR codes or links").option("-p, --platform <platform>", "[string] weapp | alipay | tt | xhs | jd | swan; comma-separated targets or all").option("--project-config <path>", "[string] project config path").option("--desc <text>", "[string] preview description").option("--dry-run", "[boolean] build without validating credentials or generating previews").action(async (root, options) => {
+		await runUploadCommand(root, {
+			...options,
+			...readUploadMetadata(cli)
+		}, "preview");
+		scheduleCompletedProductionBuildExit({}, void 0);
+	});
+}
+//#endregion
 //#region src/cli/error.ts
 const watchLimitErrorCodes = /* @__PURE__ */ new Set(["EMFILE", "ENOSPC"]);
 const watchLimitMessagePattern = /EMFILE|ENOSPC|unable to start FSEvent stream/i;
@@ -6333,6 +6229,8 @@ const WEAPP_VITE_NATIVE_COMMANDS = /* @__PURE__ */ new Set([
 	"dev",
 	"serve",
 	"build",
+	"upload",
+	"preview",
 	"close",
 	"analyze",
 	"alipay",
@@ -6345,8 +6243,66 @@ const WEAPP_VITE_NATIVE_COMMANDS = /* @__PURE__ */ new Set([
 	"g",
 	"mcp"
 ]);
+const LEGACY_UPLOAD_OPTIONS = {
+	"--version": true,
+	"-v": true,
+	"--project": true,
+	"--appid": true,
+	"--ext-appid": true,
+	"--info-output": true,
+	"-i": true
+};
+const SDK_UPLOAD_OPTIONS = {
+	"--platform": true,
+	"--uv": true,
+	"--bump": true,
+	"--git-desc": true,
+	"--dry-run": true
+};
+const UPLOAD_VALUE_OPTIONS = {
+	...LEGACY_UPLOAD_OPTIONS,
+	"-p": true,
+	"--desc": true,
+	"-d": true,
+	"--platform": true,
+	"--uv": true,
+	"--bump": true,
+	"--project-config": true,
+	"--port": true,
+	"--lang": true,
+	"-c": true,
+	"--config": true,
+	"--base": true,
+	"-l": true,
+	"--logLevel": true,
+	"-f": true,
+	"--filter": true,
+	"-m": true,
+	"--mode": true
+};
+/**
+* @description 仅按显式参数区分上传方言，不根据 -p 的值或文件系统猜测后端。
+*/
+function isLegacyUploadInvocation(argv) {
+	let legacyOption;
+	let sdkOption;
+	for (let index = 1; index < argv.length; index += 1) {
+		const token = argv[index];
+		if (token === "--") break;
+		const equalsIndex = token.indexOf("=");
+		const option = equalsIndex === -1 ? token : token.slice(0, equalsIndex);
+		if (LEGACY_UPLOAD_OPTIONS[option] === true) legacyOption = option;
+		if (SDK_UPLOAD_OPTIONS[option.startsWith("--no-") ? `--${option.slice(5)}` : option] === true) sdkOption = option;
+		if (legacyOption && sdkOption) throw new Error(`不能混用微信 IDE 上传参数 ${legacyOption} 与 SDK 上传参数 ${sdkOption}；请使用 wv ide upload 保留 IDE 行为，或使用 wv build --upload 迁移到 SDK。`);
+		if (equalsIndex === -1 && UPLOAD_VALUE_OPTIONS[option] === true) index += 1;
+	}
+	return legacyOption !== void 0;
+}
+function warnLegacyUpload() {
+	logger_default.warn("顶层微信 IDE 上传语法已弃用，将在未来版本移除。请迁移到 wv build --upload -p weapp --uv <version> --desc <description>（SDK 流程需要源码目录与上传凭据，并非 IDE 命令的等价替换）；或使用 wv ide upload ... 保留现有 IDE 行为。");
+}
 /**
-* @description 让 weapp-vite 在未命中自身命令时，回退到 weapp-ide-cli。
+* @description 保留旧版上传方言；其余未命中自身命令的调用回退到 weapp-ide-cli。
 */
 async function tryRunIdeCommand(argv) {
 	const command = argv[0];
@@ -6359,11 +6315,14 @@ async function tryRunIdeCommand(argv) {
 	if (command.startsWith("-")) return false;
 	if (command === "help") {
 		const target = argv[1];
-		if (!target || WEAPP_VITE_NATIVE_COMMANDS.has(target) || !isWeappIdeTopLevelCommand(target)) return false;
+		if (!target || target !== "upload" && WEAPP_VITE_NATIVE_COMMANDS.has(target) || !isWeappIdeTopLevelCommand(target)) return false;
+		if (target === "upload") warnLegacyUpload();
 		await executeWechatIdeCliCommand(argv);
 		return true;
 	}
-	if (WEAPP_VITE_NATIVE_COMMANDS.has(command) || !isWeappIdeTopLevelCommand(command)) return false;
+	const legacyUpload = command === "upload" && isLegacyUploadInvocation(argv);
+	if (!legacyUpload && WEAPP_VITE_NATIVE_COMMANDS.has(command) || !isWeappIdeTopLevelCommand(command)) return false;
+	if (legacyUpload) warnLegacyUpload();
 	if (!await dispatchWechatCliCommand(argv)) await executeWechatIdeCliCommand(argv);
 	return true;
 }
@@ -6461,6 +6420,8 @@ cli.option("-c, --config <file>", `[string] use specified config file`).option("
 registerIdeCommand(cli);
 registerAlipayCommand(cli);
 registerBuildCommand(cli);
+registerUploadCommand(cli);
+registerPreviewCommand(cli);
 registerCloseCommand(cli);
 registerAnalyzeCommand(cli);
 registerInitCommand(cli);
@@ -6499,7 +6460,9 @@ function resolveManagedTsconfigBootstrapRoot(args) {
 		"dev",
 		"open",
 		"prepare",
-		"serve"
+		"preview",
+		"serve",
+		"upload"
 	].includes(firstArg)) {
 		if (secondArg && !secondArg.startsWith("-")) return path.resolve(secondArg);
 		return process.cwd();
@@ -6512,7 +6475,7 @@ try {
 		const managedTsconfigBootstrapRoot = resolveManagedTsconfigBootstrapRoot(args);
 		if (managedTsconfigBootstrapRoot) await syncManagedTsconfigBootstrapFiles(managedTsconfigBootstrapRoot);
 		cli.parse(process.argv, { run: false });
-		await maybeAutoStartMcpServer(args, cli.options);
+		if (cli.matchedCommand?.name === "" && cli.matchedCommandName === void 0) await maybeAutoStartMcpServer(args, cli.options);
 		await cli.runMatchedCommand();
 	}
 } catch (error) {