weapp-vite 7.5.0 → 7.6.0

package/README.md

@@ -98,7 +98,7 @@ Hub 的 `/__devframes/__mcp` 聚合端点保持关闭，但与独立模式一样
 
 `weapp-vite/dashboard` 是 Node 端共享核心；CLI 独立工作台与 Vite DevTools 复用同一个 `DevframeDefinition` 和 `@weapp-vite/dashboard` 面板。可选适配器位于 `weapp-vite/dashboard/vite`，使用官方 `createPluginFromDevframe`，不会由普通包入口或 CLI 自动加载。
 
-接入方安装 `@weapp-vite/dashboard`、`@vitejs/devtools` 和 `@vitejs/devtools-kit`。当前接入按 Vite `8.3.0`、DevTools / Kit `0.7.6`、Devframe `1.1.0` 验证；Kit 是可选 peer，宿主依赖不进入小程序产物。
+接入方安装 `@weapp-vite/dashboard`、`@vitejs/devtools` 和 `@vitejs/devtools-kit`。当前接入使用 Vite `8.3.4`、DevTools / Kit `0.8.0`、Devframe `1.2.5`；Kit 是可选 peer，宿主依赖不进入小程序产物。
 
 ```ts
 import type { DevToolsConfig } from '@vitejs/devtools/config'
@@ -133,7 +133,7 @@ export function createDashboardHost(snapshot: DashboardAnalyzeSnapshot, roots: D
 
 每个控制器只同时挂载到一个逻辑宿主。适配器记录成功安装的 Vite 配置身份，并仅在该配置拥有的环境关闭时释放核心。成功重启将所有权移交给新配置，旧实例和未安装的失败候选的清理都不会误释放当前控制器；替换前的资源校验失败时，旧宿主仍可查询和更新。首次 setup 失败或 SDK 安装开始后的失败会释放核心，不承诺回滚部分安装。自行使用 `dashboard.definition` 对接其他 Devframe 宿主时，调用方必须负责最终关闭和启动失败时的 `dashboard.dispose()`。核心不启动服务器，也不拥有外部宿主的认证、Origin 或 MCP 策略；共享宿主不是只读沙箱。
 
-DevTools `0.7.6` 自身存在程序化重启边界：重复使用同一个 `DevTools()` 返回值时，旧实例关闭可能同时关闭新实例的 WebSocket；不安装 Dashboard 也能复现。应在每次重载的 Vite 配置中重新调用 `DevTools()`，不要把该 SDK 插件实例长期缓存在复用的 inline 配置里。上述重启验证使用重新创建的 SDK 宿主和保留的 Dashboard 控制器，不代表修复了上游传输问题。
+DevTools 自身存在程序化重启边界：重复使用同一个 `DevTools()` 返回值时，旧实例关闭可能同时关闭新实例的 WebSocket；不安装 Dashboard 也能复现。应在每次重载的 Vite 配置中重新调用 `DevTools()`，不要把该 SDK 插件实例长期缓存在复用的 inline 配置里。上述重启验证使用重新创建的 SDK 宿主和保留的 Dashboard 控制器，不代表修复了上游传输问题。
 
 面板默认位于 `/__weapp-vite/`，自定义目录与应用 `base` 独立。前端复用宿主连接或从页面相对位置发现元数据，复制视图链接保留目录和查询参数但排除认证 fragment。适配器只在开发模式挂载，生产构建不要求可选面板资源，也不导出报告。以上入口仅用于 Node 开发 / 构建宿主，不应导入小程序 AppService。
 
@@ -590,3 +590,9 @@ const artifact = await buildTestArtifact({ cwd: process.cwd() })
 ## AI 改动验收
 
 通过 `wv accept --inspect --json` 检查环境；审阅配置后运行 `wv accept --trust --json`。现有 MCP 同时提供验收启动、状态、取消和报告工具，无需模型 Key。[接入指南](https://vite.weapp.dev/guide/acceptance)。独立 `weapp-agent` CLI 同仓维护并保留原命令。
+
+## 微信开发者工具多版本
+
+默认使用本机已安装的最新 Stable。用 `wv ide devtools list` 查看安装，`wv ide devtools add "<path-to-cli>"` 登记自定义位置；`wv open --devtools-channel=nightly` 或 `wv build --open --devtools-channel=rc --devtools-version=<version>` 明确选择测试版本。旧 `cliPath` 和路径环境变量继续固定安装，显式渠道/版本可覆盖继承配置。官方版本查询不阻塞默认选择，`--require-official-latest` 可启用严格检查。
+
+仓库包可用 `pnpm e2e:ide:matrix --targets=stable,rc,nightly --suite=ide-smoke` 串行测试已有安装。矩阵记录实际 IDE、基础库和资源清理结果；缺失、未登录、失败或未完成项返回非零。安装与登录由用户完成。同一账号切换安装后可能需要重新扫码；矩阵以非交互模式记录“需要重新登录”并继续其他版本，无需预备多个账号。完整 CLI、编程接口和 MCP 用法见 [weapp-ide-cli 文档](https://vite.weapp.dev/packages/weapp-ide-cli)。

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,60 @@
+# 第三方软件声明
+
+weapp-vite 的 JavaScript 产物包含以下 MIT 许可的软件，完整许可证保留如下。
+
+## Chokidar 5.0.0
+
+此副本包含本地监听生命周期修补：目录注册与扫描的资源归属、删除重建的节流释放、
+文件订阅的异步结果隔离，以及同步关闭或取消监听时的资源清理。
+
+```text
+The MIT License (MIT)
+
+Copyright (c) 2012 Paul Miller (https://paulmillr.com), Elan Shanker
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the “Software”), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+```
+
+## readdirp 5.1.1
+
+此依赖随 Chokidar 打包，保留上游实现。
+
+```text
+MIT License
+
+Copyright (c) 2012-2019 Thorsten Lorenz, Paul Miller (https://paulmillr.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```

package/dist/action-B3YZMA-h.mjs

@@ -0,0 +1,255 @@
+import { c as getBackendForCapability } from "./createCompilerContextInstance-aYwi8wQt.mjs";
+import { t as VERSION } from "./constants-DEZdcsMn.mjs";
+import { r as logger_default } from "./logger-DGn5iEVN.mjs";
+import { i as resolveRuntimeTargets } from "./runtime-CLUhQsdA.mjs";
+import { n as openIde, r as resolveIdeCommandContext } from "./openIde-CroqOgk5.mjs";
+import { o as resolveConfigFile, r as filterDuplicateOptions } from "./options-jqFwfD1G.mjs";
+import { a as startForwardConsoleBridge, i as resolveForwardConsoleOptions, o as readLatestHmrProfileSummary } from "./forwardConsole-B0Reo8Lf.mjs";
+import process from "node:process";
+import { bootstrapWechatDevtoolsSettings, connectOpenedAutomator, defaultCustomConfigFilePath, detectWechatDevtoolsServicePort, getWechatIdeTestAccounts, getWechatIdeTicket, getWechatIdeToolInfo, queryWechatIdeLogin, refreshWechatIdeTicket, resolveCliPath, resolveProjectAutomatorPort, setWechatIdeTicket } from "weapp-ide-cli";
+//#region src/cli/commands/ide/action.ts
+async function runIdeDoctor(projectPath, options) {
+	const resolvedCli = await resolveCliPath();
+	const servicePort = await detectWechatDevtoolsServicePort().then((result) => ({
+		...result,
+		error: void 0
+	})).catch((error) => ({
+		servicePortEnabled: void 0,
+		servicePort: void 0,
+		error
+	}));
+	const cliCheck = resolvedCli.cliPath ? {
+		status: "ok",
+		value: {
+			path: resolvedCli.cliPath,
+			source: resolvedCli.source
+		}
+	} : {
+		fix: "执行 `weapp config set cliPath <path-to-cli>` 配置微信开发者工具 CLI。",
+		message: "未找到可用的微信开发者工具 CLI。",
+		status: "failed",
+		value: { source: resolvedCli.source }
+	};
+	const servicePortCheck = servicePort.servicePortEnabled === false ? {
+		fix: "在微信开发者工具中打开：设置 -> 安全设置 -> 服务端口。",
+		message: "微信开发者工具服务端口已关闭。",
+		status: "failed",
+		value: servicePort
+	} : servicePort.error ? {
+		fix: "执行 `wv ide doctor --json` 查看底层错误，并确认微信开发者工具已安装。",
+		message: servicePort.error instanceof Error ? servicePort.error.message : String(servicePort.error),
+		status: "warning"
+	} : {
+		status: servicePort.servicePortEnabled === true ? "ok" : "unknown",
+		value: {
+			enabled: servicePort.servicePortEnabled ?? null,
+			port: servicePort.servicePort ?? null
+		}
+	};
+	let loginCheck = {
+		fix: "打开微信开发者工具完成登录后重试。",
+		message: "暂未确认登录状态。",
+		status: "unknown"
+	};
+	if (resolvedCli.cliPath) try {
+		const result = await queryWechatIdeLogin(resolvedCli.cliPath, { timeout: 3e3 });
+		loginCheck = result.status === "success" ? {
+			status: result.login ? "ok" : "warning",
+			value: result.login,
+			...result.login ? {} : { message: "原生 CLI 明确返回未登录，请打开微信开发者工具完成登录。" }
+		} : {
+			status: "unknown",
+			message: `登录查询未确认状态（${result.reason}），不能据此认定未登录。`
+		};
+	} catch {
+		loginCheck = {
+			message: "登录查询执行失败，登录状态仍未确认。",
+			status: "unknown"
+		};
+	}
+	const projectCheck = projectPath ? {
+		status: "ok",
+		value: projectPath
+	} : {
+		fix: "在项目目录执行命令，或显式传入 `wv ide doctor <project-root>`。",
+		message: "未解析到微信开发者工具项目目录。",
+		status: "warning"
+	};
+	let automatorCheck = {
+		message: projectPath ? "当前项目没有可连接的已打开 automator 会话。" : "缺少项目目录，跳过 automator 检查。",
+		status: "unknown"
+	};
+	let toolCheck = {
+		message: "当前没有可读取的 DevTools Tool.getInfo。",
+		status: "unknown"
+	};
+	if (projectPath) try {
+		const miniProgram = await connectOpenedAutomator({
+			projectPath,
+			port: resolveProjectAutomatorPort(projectPath),
+			timeout: 3e3
+		});
+		automatorCheck = {
+			status: "ok",
+			value: true
+		};
+		try {
+			if (typeof miniProgram.toolInfo === "function") toolCheck = {
+				status: "ok",
+				value: await miniProgram.toolInfo()
+			};
+		} catch {
+			toolCheck = {
+				status: "warning",
+				message: "项目自动化连接已建立，但 Tool.getInfo 未能返回工具信息；宿主版本仍未确认。",
+				fix: "确认目标项目模拟器就绪后重新运行 doctor；此结果不证明登录失效。"
+			};
+		} finally {
+			miniProgram.disconnect?.();
+		}
+	} catch (error) {
+		automatorCheck = {
+			fix: "先执行 `wv open` 打开项目；若服务端口已开启，关闭多余 DevTools 窗口后重试。",
+			message: error instanceof Error ? error.message : String(error),
+			status: "warning"
+		};
+	}
+	const report = {
+		checks: {
+			automator: automatorCheck,
+			cli: cliCheck,
+			login: loginCheck,
+			project: projectCheck,
+			servicePort: servicePortCheck,
+			tool: toolCheck
+		},
+		configFile: defaultCustomConfigFilePath,
+		nodeVersion: process.version,
+		platform: process.platform,
+		weappViteVersion: VERSION
+	};
+	const output = JSON.stringify(report, null, 2);
+	if (options.json) process.stdout.write(`${output}\n`);
+	else logger_default.info(output);
+	if (options.strict && Object.values(report.checks).some((check) => check.status === "failed")) throw new Error("微信开发者工具环境诊断未通过，请根据 doctor 输出修复失败项后重试。");
+	return report;
+}
+async function waitForTermination(cleanup) {
+	await new Promise((resolve) => {
+		const signals = ["SIGINT", "SIGTERM"];
+		let cleaning = false;
+		const handlers = /* @__PURE__ */ new Map();
+		const teardown = async () => {
+			if (cleaning) return;
+			cleaning = true;
+			for (const signal of signals) process.off(signal, handlers.get(signal));
+			await cleanup();
+			resolve();
+		};
+		for (const signal of signals) {
+			const handler = () => {
+				teardown();
+			};
+			handlers.set(signal, handler);
+			process.on(signal, handler);
+		}
+	});
+}
+function formatIdeOutput(data, options) {
+	if (options.json) return JSON.stringify(data, null, 2);
+	return JSON.stringify(data, null, 2);
+}
+/**
+* @description 执行 ide 子命令。
+*/
+async function runIdeCommand(action, root, options) {
+	if (action !== "logs" && action !== "setup" && action !== "info" && action !== "test-accounts" && action !== "ticket" && action !== "ticket:set" && action !== "ticket:refresh" && action !== "doctor") throw new Error(`未知 ide 子命令: ${action ?? "(empty)"}`);
+	filterDuplicateOptions(options);
+	const configFile = resolveConfigFile(options);
+	const targets = resolveRuntimeTargets(options);
+	const ideBackend = getBackendForCapability(targets, "miniprogram", "ide");
+	if (!ideBackend) throw new Error("`weapp-vite ide` 当前仅支持小程序平台。");
+	const resolved = await resolveIdeCommandContext({
+		configFile,
+		mode: options.mode ?? "development",
+		platform: ideBackend.platform,
+		projectPath: root,
+		cliPlatform: targets.rawPlatform
+	});
+	if (action !== "doctor" && resolved.platform !== "weapp") throw new Error("`weapp-vite ide logs` 当前仅支持微信小程序平台。");
+	if (action === "doctor") {
+		await runIdeDoctor(resolved.projectPath, options);
+		return;
+	}
+	const projectPath = resolved.projectPath;
+	if (!projectPath) throw new Error("无法解析微信开发者工具项目目录，请显式传入 root 或检查 project.config.json。");
+	if (action === "setup") {
+		const result = await bootstrapWechatDevtoolsSettings({
+			projectPath,
+			trustProject: options.trustProject
+		});
+		logger_default.info(`已完成微信开发者工具配置预热：扫描实例 ${result.touchedInstanceCount} 个，检测服务端口配置 ${result.detectedSecurityCount} 处，写入项目信任 ${result.trustedProjectCount} 处。`);
+		return;
+	}
+	if (options.open) await openIde(resolved.platform, projectPath, {
+		openRecovery: options.openRecovery,
+		trustProject: options.trustProject,
+		openStrategy: options.ideOpenStrategy
+	});
+	if (action === "info") {
+		const result = await getWechatIdeToolInfo({ projectPath });
+		logger_default.info(formatIdeOutput(result, options));
+		return;
+	}
+	if (action === "test-accounts") {
+		const result = await getWechatIdeTestAccounts({ projectPath });
+		logger_default.info(formatIdeOutput(result, options));
+		return;
+	}
+	if (action === "ticket") {
+		const result = await getWechatIdeTicket({ projectPath });
+		logger_default.info(formatIdeOutput(result, options));
+		return;
+	}
+	if (action === "ticket:set") {
+		if (!options.ticket) throw new Error("`weapp-vite ide ticket:set` 需要提供 --ticket。");
+		await setWechatIdeTicket({
+			projectPath,
+			ticket: options.ticket
+		});
+		logger_default.info(`已设置微信开发者工具 ticket：${options.ticket}`);
+		return;
+	}
+	if (action === "ticket:refresh") {
+		await refreshWechatIdeTicket({ projectPath });
+		logger_default.info("已刷新微信开发者工具 ticket。");
+		return;
+	}
+	const forwardConsoleOptions = await resolveForwardConsoleOptions({
+		...resolved.weappViteConfig,
+		forwardConsole: resolved.weappViteConfig?.forwardConsole === false ? { enabled: true } : {
+			...typeof resolved.weappViteConfig?.forwardConsole === "object" ? resolved.weappViteConfig.forwardConsole : {},
+			enabled: true
+		}
+	});
+	const latestHmrSummary = await readLatestHmrProfileSummary({
+		cwd: resolved.cwd ?? process.cwd(),
+		relativeCwd: (value) => resolved.cwd ? value.replace(`${resolved.cwd}/`, "") : value,
+		weappViteConfig: resolved.weappViteConfig
+	});
+	if (latestHmrSummary) logger_default.info(latestHmrSummary.line);
+	const session = await startForwardConsoleBridge({
+		projectPath,
+		port: resolveProjectAutomatorPort(projectPath),
+		agentName: void 0,
+		logLevels: forwardConsoleOptions.logLevels,
+		unhandledErrors: forwardConsoleOptions.unhandledErrors,
+		onReadyMessage: "[forwardConsole] 已进入持续监听模式，按 Ctrl+C 退出。"
+	});
+	await waitForTermination(async () => {
+		logger_default.info("[forwardConsole] 正在关闭日志桥接...");
+		await session.close();
+	});
+}
+//#endregion
+export { runIdeCommand };

package/dist/action-BELcDNNv.mjs

@@ -0,0 +1,139 @@
+import { r as logger_default } from "./logger-DGn5iEVN.mjs";
+import { o as resolveConfigFile } from "./options-jqFwfD1G.mjs";
+import { c as startWeappViteMcpServer, s as resolveWeappMcpConfig } from "./mcp-Cj8Maqo6.mjs";
+import { a as inspectMcpClientConfig, i as resolveSupportedMcpClient, n as buildMcpClientConfigPlan, r as formatMcpQuickStart, t as writeMcpClientConfig } from "./mcpClient-DVLvFLZv.mjs";
+import process from "node:process";
+import path from "pathe";
+import { runWithSuspendedSharedInput } from "weapp-ide-cli";
+import { createInterface } from "node:readline/promises";
+//#region src/cli/commands/mcp/action.ts
+function resolvePort(port) {
+	if (typeof port === "number" && Number.isInteger(port)) return port;
+	if (typeof port === "string" && port.trim()) {
+		const parsed = Number.parseInt(port, 10);
+		if (Number.isInteger(parsed)) return parsed;
+	}
+}
+async function resolveHttpUrl(options) {
+	if (options.url?.trim()) return options.url.trim();
+	const workspaceRoot = options.workspaceRoot ? path.resolve(options.workspaceRoot) : process.cwd();
+	const originalCwd = process.cwd();
+	try {
+		if (workspaceRoot !== originalCwd) process.chdir(workspaceRoot);
+		const configFile = resolveConfigFile(options);
+		const { loadConfig } = await import("./loadConfig-D-BpBgsk.mjs");
+		const loaded = await loadConfig(configFile);
+		const resolved = resolveWeappMcpConfig(loaded?.config?.weapp?.mcp);
+		return `http://${resolved.host}:${resolved.port}${resolved.endpoint}`;
+	} catch {
+		const resolved = resolveWeappMcpConfig(void 0);
+		return `http://${resolved.host}:${resolved.port}${resolved.endpoint}`;
+	} finally {
+		if (process.cwd() !== originalCwd) process.chdir(originalCwd);
+	}
+}
+async function confirmWrite() {
+	if (!process.stdin.isTTY || !process.stdout.isTTY) return false;
+	return await runWithSuspendedSharedInput(async () => {
+		const rl = createInterface({
+			input: process.stdin,
+			output: process.stdout
+		});
+		try {
+			const normalized = (await rl.question("是否写入配置文件？(Y/n) ")).trim().toLowerCase();
+			return normalized === "" || normalized === "y" || normalized === "yes";
+		} finally {
+			rl.close();
+		}
+	});
+}
+function resolveClientTransport(transport) {
+	return transport === "http" ? "http" : "command";
+}
+async function handlePrint(clientName, options, write = false) {
+	const client = resolveSupportedMcpClient(clientName);
+	const workspaceRoot = options.workspaceRoot ?? process.cwd();
+	const transport = resolveClientTransport(options.transport);
+	const httpUrl = transport === "http" ? await resolveHttpUrl(options) : void 0;
+	const plan = buildMcpClientConfigPlan({
+		client,
+		transport,
+		url: httpUrl,
+		workspaceRoot
+	});
+	logger_default.info(`${plan.target.displayName} 配置文件：${plan.target.configPath}`);
+	logger_default.info(`服务器名称：${plan.target.serverName}`);
+	process.stdout.write(`${plan.preview}\n`);
+	if (!write) return;
+	if (options.yes || await confirmWrite()) {
+		await writeMcpClientConfig(plan);
+		logger_default.success(`已写入 ${plan.target.displayName} MCP 配置。`);
+		logger_default.info(`请重启 ${plan.target.displayName}，然后执行：wv mcp doctor ${client}`);
+		return;
+	}
+	logger_default.info("已取消写入。");
+}
+async function handleDoctor(clientName, options) {
+	const client = resolveSupportedMcpClient(clientName);
+	const result = await inspectMcpClientConfig({
+		client,
+		workspaceRoot: options.workspaceRoot ?? process.cwd()
+	});
+	logger_default.info(`${result.displayName} 配置文件：${result.configPath}`);
+	logger_default.info(`服务器名称：${result.serverName}`);
+	if (!result.configExists || result.issues.length > 0) {
+		for (const issue of result.issues) logger_default.warn(issue);
+		throw new Error("MCP 客户端配置检查未通过。");
+	}
+	if (result.transport) logger_default.info(`传输模式：${result.transport}`);
+	if (result.httpReachable !== void 0) logger_default.info(`HTTP 服务可达：${result.httpReachable ? "是" : "否"}`);
+	logger_default.success("MCP 客户端配置检查通过。");
+}
+async function handleServer(options) {
+	const resolvedTransport = options.transport === "http" ? "streamable-http" : options.transport === "command" ? void 0 : options.transport;
+	const handle = await startWeappViteMcpServer({
+		endpoint: options.endpoint,
+		host: options.host,
+		port: resolvePort(options.port),
+		restEndpoint: options.rest === false ? false : options.restEndpoint,
+		transport: resolvedTransport,
+		unref: options.unref,
+		workspaceRoot: options.workspaceRoot
+	});
+	const shutdown = async () => {
+		process.off("SIGINT", shutdown);
+		process.off("SIGTERM", shutdown);
+		process.stdin.off("end", shutdown);
+		await handle.close?.();
+	};
+	process.once("SIGINT", shutdown);
+	process.once("SIGTERM", shutdown);
+	if (resolvedTransport !== "streamable-http") process.stdin.once("end", shutdown);
+	for (const line of formatMcpQuickStart({
+		httpUrl: resolvedTransport === "streamable-http" ? `http://${options.host ?? "127.0.0.1"}:${resolvePort(options.port) ?? 3088}${options.endpoint ?? "/mcp"}` : void 0,
+		transport: resolvedTransport === "streamable-http" ? "http" : "command"
+	})) logger_default.info(line);
+}
+/** 执行 MCP 子命令，注册与帮助阶段不加载服务依赖。 */
+async function runMcpCommand(args, options) {
+	const [subcommand, client] = args;
+	if (subcommand === "init") {
+		if (!client) throw new Error("缺少客户端名称，请使用：wv mcp init <codex|claude-code|cursor>");
+		await handlePrint(client, options, true);
+		return;
+	}
+	if (subcommand === "print") {
+		if (!client) throw new Error("缺少客户端名称，请使用：wv mcp print <codex|claude-code|cursor>");
+		await handlePrint(client, options, false);
+		return;
+	}
+	if (subcommand === "doctor") {
+		if (!client) throw new Error("缺少客户端名称，请使用：wv mcp doctor <codex|claude-code|cursor>");
+		await handleDoctor(client, options);
+		return;
+	}
+	if (subcommand) throw new Error(`未知的 mcp 子命令：${subcommand}`);
+	await handleServer(options);
+}
+//#endregion
+export { runMcpCommand };