weapp-vite 7.5.0 → 7.7.0

package/README.md

@@ -16,13 +16,15 @@
 
 ## 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 校验恢复旧版本支持。
+框架及编译依赖链的官方支持范围为 `^22.23.4 || ^24.22.1 || >=26.12.1`：Node 22 至少 22.23.4、Node 24 至少 24.22.1，或 Node 26.12.1 及以上版本。Node 20、23、25 及低于上述最低版本的环境不在官方支持范围内。
 
-升级已有项目时先升级 Node.js，再重新安装依赖。CLI 会在加载编译依赖前检查实际 Node 版本；`prepare` 也会明确拒绝不支持的环境。直接通过 Vite 或程序 API 消费时同样需要遵守包的 `engines.node`。
+CLI（含 `prepare`）与 Tailwind 集成发现实际 Node 版本超出该范围时，会提示升级并继续尝试执行，不会仅因版本号退出。旧版 Node 若缺少依赖所需的语法或 API，仍可能导致加载或执行失败；直接通过 Vite 或程序 API 消费时也受实际依赖兼容性限制。
 
-`create-weapp-vite` 自身依赖要求更高：Node 22 至少 22.22.2、Node 24 至少 24.15.0，或 Node 26 及以上版本。新建项目按脚手架要求选择 Node，不要将框架最低版本误认为脚手架最低版本。
+建议升级至受支持 LTS 分支的最新安全补丁版本，再安装或更新依赖。包的 `engines.node` 声明保持不变；如果项目或团队启用了严格 engines 校验，包管理器仍可能拒绝安装。
 
-发布候选在构建环境中打包，再在独立临时消费者中以严格 engines/peer 校验安装；CI 覆盖 Linux、Windows、macOS 的 Node 22.18.0、24.11.0、26.0.0 及 22/24 当前补丁版本，验证原生和 SFC 构建、prepare 与公开类型。
+`create-weapp-vite` 与框架采用相同的 Node 支持范围；Vite+ 模板要求 `^24.22.1 || >=26.12.1`。
+
+发布候选在构建环境中打包，再在独立临时消费者中以严格 engines/peer 校验安装；CI 覆盖 Linux、Windows、macOS 的 Node 22.23.4、24.22.1、26.12.1 及 22/24 当前补丁版本，验证原生和 SFC 构建、prepare 与公开类型。
 
 ## 普通 Vite 与 Vite+
 
@@ -98,7 +100,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 +135,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 +592,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 6.0.0
+
+此副本保留 Chokidar 6 的监听后端与生命周期模型，并包含本地修补：缺失目录的
+Windows 注册恢复，以及目录扫描和文件读取的异步归属隔离。
+
+```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,6 +1,9 @@
 import { readFileSync } from 'node:fs'
+// 安装生命周期早于 workspace 构建，启动阶段直接使用日志包同源的轻量染色实现。
+import colors from 'picocolors'
 // eslint-disable-next-line e18e/ban-dependencies -- 启动检查使用与发布 engines 完全相同的 npm semver 语义。
 import satisfies from 'semver/functions/satisfies.js'
+import { formatNodeVersionWarning } from './nodeVersionWarning.js'
 
 const { engines } = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'))
 
@@ -115,11 +118,13 @@ export async function runWeappViteCLI(options = {}) {
     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`),
+    write = message => getGlobalProcess().stderr.write(`\n ${colors.bold(colors.yellow('警告'))}  ${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.`)
+  // Bun 的 versions.node 只是兼容标识；真实 Node 在加载依赖前提示升级，不因版本号阻断命令。
+  const bunVersion = getGlobalProcess().versions.bun
+  const isBun = typeof bunVersion === 'string' && bunVersion.length > 0
+  if (!isBun && !satisfies(nodeVersion, engines.node)) {
+    write(formatNodeVersionWarning('weapp-vite', nodeVersion, engines.node))
   }
   const restorePrepareGuard = guardPrepareProcessExit(argv)
   const restoreKnownNoiseGuard = guardKnownLocalPkgResolveNoise()

package/bin/bootstrap.test.ts

@@ -1,9 +1,23 @@
-import { afterEach, describe, expect, it, vi } from 'vitest'
+import realProcess from 'node:process'
+import { stripVTControlCharacters } from 'node:util'
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
+import { runBootstrapFixture } from '../test/helpers/bootstrapFixture'
 import { formatPrepareSkipMessage, guardKnownLocalPkgResolveNoise, guardPrepareProcessExit, runWeappViteCLI } from './bootstrap.js'
 
 describe('bin bootstrap', () => {
+  beforeEach(() => {
+    vi.stubGlobal('process', {
+      ...realProcess,
+      exitCode: undefined,
+      exit: vi.fn(),
+      on: vi.fn(),
+      off: vi.fn(),
+    })
+  })
+
   afterEach(() => {
     vi.restoreAllMocks()
+    vi.unstubAllGlobals()
   })
 
   it('guards process exit state for prepare at bin level', () => {
@@ -90,3 +104,70 @@ describe('bin bootstrap', () => {
     expect(consoleErrorSpy.mock.calls[0]?.[0]?.message).toBe('boom')
   })
 })
+
+describe('cold CLI bootstrap without workspace dist', () => {
+  it('never reports a child terminated by a signal as successful', async () => {
+    const outcome = await runBootstrapFixture(['--eval', 'process.kill(process.pid, "SIGTERM")']).then(
+      result => ({ kind: 'exit' as const, result }),
+      (error: unknown) => ({ kind: 'signal' as const, error }),
+    )
+    if (outcome.kind === 'exit') {
+      // Windows 可能将强制终止表示为非零退出码，Unix 则通过 signal 报告。
+      expect(outcome.result.exitCode).not.toBe(0)
+    }
+    else {
+      expect(outcome.error).toMatchObject({ signal: 'SIGTERM' })
+    }
+  })
+
+  it('keeps prepare successful and reports the missing CLI artifact in Chinese on stderr', async () => {
+    const result = await runBootstrapFixture(['bin/weapp-vite.js', 'prepare'])
+
+    expect(result.exitCode).toBe(0)
+    expect(result.stdout).toBe('')
+    expect(result.stderr).toContain('警告')
+    expect(result.stderr).toContain('[prepare] 跳过 .weapp-vite 支持文件预生成：')
+    expect(result.stderr.replaceAll('\\', '/')).toContain('dist/cli.mjs')
+    expect(result.stderr).not.toContain('@weapp-core/logger')
+  })
+
+  it.each([
+    ['build', 'cli.mjs'],
+    ['dev', 'cli.mjs'],
+    ['accept', 'cli-acceptance.mjs'],
+    ['mcp', 'cli-acceptance.mjs'],
+  ])('preserves the missing artifact failure for %s', async (command, artifact) => {
+    const result = await runBootstrapFixture(['bin/weapp-vite.js', command])
+
+    expect(result.exitCode).not.toBe(0)
+    expect(result.stdout).toBe('')
+    expect(result.stderr).toContain('ERR_MODULE_NOT_FOUND')
+    expect(result.stderr.replaceAll('\\', '/')).toContain(`dist/${artifact}`)
+    expect(result.stderr).not.toContain('@weapp-core/logger')
+  })
+
+  it.each([
+    { name: 'forced colors', env: { FORCE_COLOR: '1' }, colored: true },
+    { name: 'disabled colors', env: { NO_COLOR: '1' }, colored: false },
+    { name: 'NO_COLOR precedence', env: { FORCE_COLOR: '1', NO_COLOR: '1' }, colored: false },
+  ])('keeps the Chinese Node warning on stderr with $name', async ({ env, colored }) => {
+    const result = await runBootstrapFixture([
+      '--input-type=module',
+      '--eval',
+      `
+        const { runWeappViteCLI } = await import('./bin/bootstrap.js')
+        await runWeappViteCLI({ argv: ['build'], nodeVersion: '20.19.0', importer: async () => {} })
+      `,
+    ], env)
+
+    expect(result.exitCode).toBe(0)
+    expect(result.stdout).toBe('')
+    expect(result.stderr).toContain('警告')
+    expect(result.stderr).toContain('当前 Node.js 版本')
+    expect(result.stderr).toContain('20.19.0')
+    expect(result.stderr).toContain('推荐版本：')
+    expect(result.stderr).toContain('为获得安全修复，建议升级至受支持 LTS 分支的最新补丁版本。')
+    expect(result.stderr).toContain('本次将继续运行；若遇到依赖兼容问题，请先升级 Node.js。')
+    expect(stripVTControlCharacters(result.stderr) !== result.stderr).toBe(colored)
+  })
+})

package/bin/nodeVersionWarning.js

@@ -0,0 +1,17 @@
+// 此格式器也用于尚无 workspace 构建产物的安装阶段，不能依赖日志包的 dist。
+import colors from 'picocolors'
+
+/**
+ * 格式化 Node.js 版本升级提示，供 CLI 与构建插件共用。
+ * @param {string} name 发出提示的工具名称
+ * @param {string} nodeVersion 当前 Node.js 版本
+ * @param {string} nodeRange 官方支持的版本范围
+ */
+export function formatNodeVersionWarning(name, nodeVersion, nodeRange) {
+  return [
+    `${name} 检测到当前 Node.js 版本 ${colors.bold(colors.yellow(nodeVersion))} 不在官方支持范围内。`,
+    `  推荐版本：${colors.bold(colors.cyan(nodeRange))}`,
+    '  为获得安全修复，建议升级至受支持 LTS 分支的最新补丁版本。',
+    `  ${colors.dim('本次将继续运行；若遇到依赖兼容问题，请先升级 Node.js。')}`,
+  ].join('\n')
+}

package/bin/nodeVersionWarning.test.ts

@@ -0,0 +1,30 @@
+import { stripVTControlCharacters } from 'node:util'
+import { describe, expect, it } from 'vitest'
+import { runBootstrapFixture } from '../test/helpers/bootstrapFixture'
+
+describe('cold Node version warning formatter without workspace dist', () => {
+  it.each([
+    { name: 'forced colors', env: { FORCE_COLOR: '1' }, colored: true },
+    { name: 'disabled colors', env: { NO_COLOR: '1' }, colored: false },
+    { name: 'NO_COLOR precedence', env: { FORCE_COLOR: '1', NO_COLOR: '1' }, colored: false },
+  ])('formats the Chinese warning with $name using only registry dependencies', async ({ env, colored }) => {
+    const result = await runBootstrapFixture([
+      '--input-type=module',
+      '--eval',
+      `
+        const { formatNodeVersionWarning } = await import('./bin/nodeVersionWarning.js')
+        process.stdout.write(formatNodeVersionWarning('weapp.tailwindcss', '20.19.0', '^22.23.4 || ^24.22.1 || >=26.12.1'))
+      `,
+    ], env)
+
+    expect(result.exitCode).toBe(0)
+    expect(result.stdout).toContain('weapp.tailwindcss 检测到当前 Node.js 版本')
+    expect(result.stdout).toContain('20.19.0')
+    expect(result.stdout).toContain('推荐版本：')
+    expect(result.stdout).toContain('^22.23.4 || ^24.22.1 || >=26.12.1')
+    expect(result.stdout).toContain('为获得安全修复，建议升级至受支持 LTS 分支的最新补丁版本。')
+    expect(result.stdout).toContain('本次将继续运行；若遇到依赖兼容问题，请先升级 Node.js。')
+    expect(result.stderr).toBe('')
+    expect(stripVTControlCharacters(result.stdout) !== result.stdout).toBe(colored)
+  })
+})

package/dist/action-BD56SQh4.mjs

@@ -0,0 +1,254 @@
+import { c as getBackendForCapability } from "./createCompilerContextInstance-BXSdH2E8.mjs";
+import { t as VERSION } from "./constants-BOe8mgqL.mjs";
+import { r as logger_default } from "./logger-DGn5iEVN.mjs";
+import { i as resolveRuntimeTargets } from "./runtime-CKtMVERT.mjs";
+import { n as openIde, r as resolveIdeCommandContext } from "./openIde-QoYKhuuM.mjs";
+import { o as resolveConfigFile, r as filterDuplicateOptions } from "./options-Cz8vZ-0w.mjs";
+import { a as startForwardConsoleBridge, i as resolveForwardConsoleOptions, o as readLatestHmrProfileSummary } from "./forwardConsole-D2Q0RIqc.mjs";
+import process from "node:process";
+import { bootstrapWechatDevtoolsSettings, connectOpenedAutomator, defaultCustomConfigFilePath, detectWechatDevtoolsServicePort, getWechatIdeTestAccounts, getWechatIdeTicket, getWechatIdeToolInfo, queryWechatIdeLogin, refreshWechatIdeTicket, resolveCliPath, resolveProjectAutomatorPort, setWechatIdeTicket } from "weapp-ide-cli";
+// 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();
+	});
+}
+export { runIdeCommand };

package/dist/action-CPtgEl6p.mjs

@@ -0,0 +1,94 @@
+import { r as logger_default } from "./logger-DGn5iEVN.mjs";
+import { t as createCompilerContext } from "./createContext-W0TeXxbo.mjs";
+import { i as resolveRuntimeTargets, t as createInlineConfig } from "./runtime-CKtMVERT.mjs";
+import { o as resolveConfigFile, r as filterDuplicateOptions } from "./options-Cz8vZ-0w.mjs";
+import { t as setCommandNodeEnv } from "./nodeEnv-zq1EymWj.mjs";
+import { o as resolveUploadTimeout, t as UploadCommandError } from "./report-PJVyo-UZ.mjs";
+import { n as resolveUploadPlatforms } from "./upload-Chal5b3w.mjs";
+import { t as terminateStaleSassEmbeddedProcess } from "./processCleanup-DzB64WI8.mjs";
+import { i as prepareAutoUploadMetadata, n as executeUploadTarget, r as UploadExecutionError, t as createUploadTarget } from "./builtProject-B145uOt5.mjs";
+import process from "node:process";
+import path from "node:path";
+// src/cli/commands/upload/action.ts
+async function buildUploadTarget(cwd, platform, options, action, item) {
+	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);
+		if (item) {
+			item.platform = target.platform;
+			item.requestedVersion = target.context.version;
+			item.stage = "build";
+		}
+		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.resolve(root ?? process.cwd());
+	if (action === "preview") {
+		options = await prepareAutoUploadMetadata(cwd, options, action);
+		for (const platform of platforms) {
+			const target = await buildUploadTarget(cwd, platform, options, action);
+			await executeUploadTarget(target, options, action);
+		}
+		return;
+	}
+	const report = {
+		schemaVersion: 1,
+		action: "upload",
+		status: "success",
+		results: platforms.map((platform) => ({
+			platform: platform ?? null,
+			stage: "prepare",
+			status: "not-run"
+		}))
+	};
+	let active = report.results[0];
+	try {
+		const timeoutMs = resolveUploadTimeout(options.timeout);
+		options = await prepareAutoUploadMetadata(cwd, options, action);
+		for (const item of report.results) item.requestedVersion = options.uv?.trim();
+		for (const [index, platform] of platforms.entries()) {
+			active = report.results[index];
+			const target = await buildUploadTarget(cwd, platform, options, action, active);
+			active.stage = "validate";
+			const result = await executeUploadTarget(target, options, action, {
+				timeoutMs,
+				onUpload: () => {
+					active.stage = "upload";
+				}
+			});
+			active.status = options.dryRun ? "dry-run" : "success";
+			if (!options.dryRun) active.result = result;
+		}
+		return report;
+	} catch (error) {
+		report.status = "failed";
+		report.error = error instanceof Error ? error.message : String(error);
+		active.status = "failed";
+		active.error = report.error;
+		if (error instanceof UploadExecutionError) {
+			active.remoteOutcome = error.remoteOutcome;
+			if (error.remoteOutcome === "unknown" && error.reason !== "failed") active.status = "unknown";
+		}
+		throw new UploadCommandError(report);
+	}
+}
+export { runUploadCommand };