weapp-vite 7.4.0 → 7.6.0

package/README.md

@@ -14,6 +14,20 @@
 
 <p>&nbsp;</p>
 
+## Node.js 支持范围
+
+框架及编译依赖链要求 `^22.18.0 || ^24.11.0 || >=26.0.0`：Node 22 至少 22.18.0、Node 24 至少 24.11.0，或 Node 26 及以上版本；不支持 Node 20、23、25。这是 Babel 8 与必需构建依赖支持范围的交集，不能通过关闭 engines 校验恢复旧版本支持。
+
+升级已有项目时先升级 Node.js，再重新安装依赖。CLI 会在加载编译依赖前检查实际 Node 版本；`prepare` 也会明确拒绝不支持的环境。直接通过 Vite 或程序 API 消费时同样需要遵守包的 `engines.node`。
+
+`create-weapp-vite` 自身依赖要求更高：Node 22 至少 22.22.2、Node 24 至少 24.15.0，或 Node 26 及以上版本。新建项目按脚手架要求选择 Node，不要将框架最低版本误认为脚手架最低版本。
+
+发布候选在构建环境中打包，再在独立临时消费者中以严格 engines/peer 校验安装；CI 覆盖 Linux、Windows、macOS 的 Node 22.18.0、24.11.0、26.0.0 及 22/24 当前补丁版本，验证原生和 SFC 构建、prepare 与公开类型。
+
+## 普通 Vite 与 Vite+
+
+独立项目继续使用 `wv dev/build`，不需要注册插件或安装 Vite+。采用普通 Vite / Vite+ 时，在顶层 `weapp` 配置旁注册 `weapp-vite/vite` 的 `weapp()`，使用原生 `vite dev/build` / `vp dev/build`。当前插件开放微信 TS/Vue/React 生产构建、原生 `build --watch` 与实验性 classic/stateful 开发；通过 `weapp.hmr.runtime` 选择模式，已支持普通分包、独立分包与 worker，其他高级目标仍在分阶段对齐。Vite+ 需要配套 core alias 与依赖覆盖，详见[标准插件指南](https://vite.weapp.dev/guide/vite-plugin.html)。
+
 ## 使用文档地址: [vite.weapp.dev](https://vite.weapp.dev)
 
 ## Features
@@ -64,11 +78,27 @@ wv build -p web
 
 `web` 是浏览器 runtime 的规范平台名，`h5` 仅作为向后兼容别名保留；未选择 Web 平台时不改变现有小程序构建。完整配置和兼容边界见 [Web 运行时配置](https://vite.weapp.dev/config/web) 与 [`@weapp-vite/web`](https://vite.weapp.dev/packages/web)。
 
+### 可选 Hub 工作台
+
+`wv dev --ui` / `wv build --ui` 保持独立 Dashboard。安装可选面板包 `@weapp-vite/dashboard` 后，可显式启用 DevFrame 1.2 的官方 Hub，无需安装 Vite DevTools：
+
+```bash
+wv dev --ui-host hub
+wv build --ui-host hub
+wv analyze --ui-host hub
+```
+
+`--ui-host` 只接受 `standalone` 和 `hub`，并隐式启用 UI；不传 UI 参数时，`dev` / `build` 不新增服务。Hub 入口为 `/__devframes/`，Dashboard 面板仍为 `/__weapp-vite/`，共用 loopback 服务、OTP 认证、报告控制器和原生连接。Hub 提供停靠面板与内建设置，不安装终端或其他默认工具；语言设置不自动翻译自定义 Dashboard。
+
+Dashboard dock 与 Hub 品牌使用与官网相同图案的包内 SVG 字符串，以 data URL 提供。源码入口和发布产物均无需 SVG loader、官网目录或外部图标服务。
+
+Hub 的 `/__devframes/__mcp` 聚合端点保持关闭，但与独立模式一样发布 Dashboard scoped MCP 实例，地址为 `/__weapp-vite/__mcp`，不继承其他插件的工具或 Resources。`analyze --json`、`--markdown`、`--report` 等输出选项优先级保持不变；Hub 不是离线报告导出。完整参数见 [CLI 指南](https://vite.weapp.dev/guide/cli#可选-hub-工作台)。
+
 ### Dashboard 嵌入 Vite DevTools
 
 `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'
@@ -103,12 +133,21 @@ 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。
 
 仓库内可通过 `apps/dashboard-ui-lab` 的 `dev:inspector` 与 `dev:inspector:host` 验证两种宿主，详见其 [实验说明](../../apps/dashboard-ui-lab/README.md)。
 
+### Dashboard MCP
+
+CLI 的 standalone 与 Hub 模式均向 AI 提供摘要／预算、包与产物／模块检索、重复分析、构建比较、最近事件与受限文件片段，并提供调查列表、详情和领取／提案／开始／回报四个元数据动作。页面与工具共享报告、产物及 `weapp-vite/dashboard/analyze` 纯计算，缺失基线或测量不会假造增减。实际监听后可通过 `devframe connect` 发现 scoped 实例；MCP 校验 loopback 对端与 Origin，浏览器使用 OTP。本机模式不区分本机用户，请勿通过代理、隧道或端口转发对外发布。
+
+「对象检查」以真实包 → 产物 → 模块关系浏览完整报告，选择与显式筛选分离，证据／内容／变化／调查共用一个上下文区。浏览器提交绑定报告的调查，外部 Agent 回传提案后需用户明确授权；执行仍在外部，回执不能代替更新报告上的人工复验。创建、取消、授权和复验不暴露为 Agent 工具，也不提供通用 shared-state、任意文件写入或命令执行。
+
+旧 revision 请求与旧提案授权会被拒绝。嵌入 Vite DevTools 时仍由宿主决定是否开放 MCP；现有 `wv mcp`、REST 与微信 IDE 自动化入口保持不变。客户端配置、任务版本和领取令牌用法见 [随包 MCP 指南](docs/mcp.md#dashboard-证据查询与对象调查devframe)。
+
+
 ### Vue 项目
 
 ```typescript
@@ -377,6 +416,7 @@ wv build --upload -p weapp
 # 独立 upload 命令仍支持多个小程序目标；all 在此表示六端
 wv upload --platform jd,swan
 wv upload --platform all --dry-run
+wv upload --platform xhs,tt --json --timeout 180
 
 # 内置本地自动版本演练，不修改版本或锁文件
 wv upload -p xhs,tt --mode test --bump patch --git-desc --dry-run
@@ -388,6 +428,8 @@ wv upload -p xhs,tt --mode test --bump patch --git-desc --dry-run
 
 `build -p all --upload` 保持“小程序 + Web”语义，等两个后端都构建成功后只上传小程序；独立 `wv upload -p all` 才是六端逐一构建上传，首次失败停止。`--dry-run` 只构建并校验产物，不校验凭据、不调用 SDK。
 
+独立 `upload --json` 将单个结构化报告写入 stdout，构建日志与官方进度进入 stderr；失败保留前序成功、当前错误和后续 `not-run` 条目，并以非零状态退出。`--timeout <秒>` 只限制各平台 SDK worker，不包含构建。SDK 开始后超时或中断标记远端结果未确认；终止本地进程不能取消远端任务，不自动重试。六端可选结果与进度差异见[结果、进度与本地超时](https://vite.weapp.dev/guide/upload.html#report)。这两个选项不适用于 `build --upload`、`preview` 或 IDE 上传。
+
 多个平台可用一份 `weapp.multiPlatform.projectConfigs` 映射集中配置 AppID，公共字段用对象展开复用，不必手工维护六份原生 JSON。构建器在代码输出目录内生成对应项目配置；原生文件方式仍可使用。完整配置见[一份配置与批量上传](https://vite.weapp.dev/guide/upload.html#batch)。
 
 官方工具按目标安装，凭据只使用环境变量，不在 `weapp.upload` 中配置。完整的项目配置、AppID、凭据获取与环境文件、上传、预览、批量操作、CI 与排障见[小程序上传与预览指南](https://vite.weapp.dev/guide/upload.html)：[小红书](https://vite.weapp.dev/guide/upload/xhs.html)、[抖音](https://vite.weapp.dev/guide/upload/tt.html)、[微信](https://vite.weapp.dev/guide/upload/weapp.html)、[支付宝与淘宝边界](https://vite.weapp.dev/guide/upload/alipay.html)、[京东](https://vite.weapp.dev/guide/upload/jd.html)、[百度](https://vite.weapp.dev/guide/upload/swan.html)。本地速查见 `dist/docs/upload.md`；淘宝暂不支持，不要用 `-p alipay` 替代。
@@ -443,7 +485,7 @@ wv upload -p ./dist -v 1.2.3 -d "release"
 
 每次旧顶层调用只警告一次未来移除，不要求立即改写脚本；若只想保留 IDE 行为，改为 `wv ide upload -p ./dist -v 1.2.3 -d "release"`，该显式入口不警告。若迁移到 SDK，先在**源码项目根**安装 `miniprogram-ci`、配置 AppID、代码上传私钥与 IP 白名单，再执行 `wv build --upload -p weapp --uv 1.2.3 --desc "release"`。SDK 会重新构建、使用新凭据，不复用 IDE 登录；不要把旧 `--project` 的产物目录直接作为 `[root]`。
 
-`-p` 有 `--version/-v`、`--project`、`--appid`、`--ext-appid` 或 `--info-output/-i` 等旧标记时才表示 IDE 项目目录，否则表示平台，不猜测路径。旧标记与 SDK 的 `--platform`、`--uv`、`--bump`、`--git-desc`、`--dry-run`（含其 `--no-*` 形式）混用，在 IDE、编译或版本修改前报错；SDK dry-run/自动版本不适用于 IDE。`--desc` 共用，`-d` 只在旧调用中是说明，原生命令中仍是 debug。
+`-p` 有 `--version/-v`、`--project`、`--appid`、`--ext-appid` 或 `--info-output/-i` 等旧标记时才表示 IDE 项目目录，否则表示平台，不猜测路径。旧标记与 SDK 的 `--platform`、`--uv`、`--bump`、`--git-desc`、`--dry-run`、`--json`、`--timeout`（含其 `--no-*` 形式）混用，在 IDE、编译或版本修改前报错；SDK 专属选项不适用于 IDE。`--desc` 共用，`-d` 只在旧调用中是说明，原生命令中仍是 debug。
 
 `wv upload --help` 查看 SDK 帮助；`wv help upload` 保留旧 IDE 帮助并提示未来弃用；`wv ide help upload` 不弃用、不警告。等号写法、选项值与 `--` 边界等完整规则见[旧上传兼容与迁移](https://vite.weapp.dev/guide/cli.html#legacy-upload)。
 
@@ -540,3 +582,17 @@ const artifact = await buildTestArtifact({ cwd: process.cwd() })
 [MIT](./LICENSE)
 
 <!-- "//------":""esbuild": "^0.21.3",", -->
+
+## 实验性标准 Vite 插件
+
+`weapp-vite/vite` 导出 `weapp()`，通过 `plugins: [weapp()]` 和顶层 `weapp` 配置接入原生 `vite build` / `vp build`。当前开放微信 TS/Vue/React 生产构建、原生 build watch 与实验性 classic/stateful 开发；已支持普通分包、独立分包与 worker，其他高级目标继续分阶段对齐。配置、Vite+ alias 与未开放能力见 [标准插件指南](https://vite.weapp.dev/guide/vite-plugin)。离线说明随包发布在 `dist/docs/vite-plugin.md`。
+
+## 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/bin/bootstrap.js

@@ -1,3 +1,9 @@
+import { readFileSync } from 'node:fs'
+// eslint-disable-next-line e18e/ban-dependencies -- 启动检查使用与发布 engines 完全相同的 npm semver 语义。
+import satisfies from 'semver/functions/satisfies.js'
+
+const { engines } = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'))
+
 export function isPrepareCommand(argv) {
   return Array.isArray(argv) && argv[0] === 'prepare'
 }
@@ -105,9 +111,16 @@ export function guardPrepareProcessExit(argv) {
 export async function runWeappViteCLI(options = {}) {
   const {
     argv = getGlobalProcess().argv.slice(2),
-    importer = () => import('../dist/cli.mjs'),
+    nodeVersion = getGlobalProcess().versions.node,
+    importer = () => ['accept', 'mcp'].includes(argv[0])
+      ? import('../dist/cli-acceptance.mjs')
+      : import('../dist/cli.mjs'),
     write = message => getGlobalProcess().stderr.write(`\n WARN  ${message}\n\n`),
   } = options
+  // 在加载 Babel 等依赖前校验同一份发布声明；prepare 的容错不能吞掉不受支持的运行时。
+  if (!satisfies(nodeVersion, engines.node)) {
+    throw new Error(`weapp-vite requires Node.js ${engines.node}; current version is ${nodeVersion}. Please upgrade Node.js before running this command.`)
+  }
   const restorePrepareGuard = guardPrepareProcessExit(argv)
   const restoreKnownNoiseGuard = guardKnownLocalPkgResolveNoise()
 

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 };