weapp-ide-cli 5.2.0 → 5.2.2

package/dist/{cli-DXJCUYYI.js → cli-1zieDX-6.js}

@@ -1,9 +1,9 @@
-import { A as createCustomConfig, B as isOperatingSystemSupported, D as resolveCliPath, H as colors, I as defaultCustomConfigFilePath, L as resolvePath, M as overwriteCustomConfig, N as readCustomConfig, P as removeCustomConfigKey, S as validateLocaleOption, U as logger_default, V as operatingSystemName, _ as tap, a as input, b as configureLocaleFromArgv, c as pageData, d as redirectTo, f as remote, h as systemInfo, i as currentPage, j as createLocaleConfig, k as getConfiguredLocale, l as pageStack, m as switchTab, n as captureScreenshotBuffer, o as navigateBack, p as scrollTo, s as navigateTo, t as audit, u as reLaunch, v as connectMiniProgram, x as i18nText } from "./commands-BfdE1eYN.js";
-import { fs } from "@weapp-core/shared";
+import { B as createLocaleConfig, C as configureLocaleFromArgv, G as defaultCustomConfigFilePath, H as readCustomConfig, I as resolveCliPath, K as resolvePath, Q as logger_default, R as getConfiguredLocale, T as validateLocaleOption, U as removeCustomConfigKey, V as overwriteCustomConfig, X as operatingSystemName, Y as isOperatingSystemSupported, Z as colors, a as navigateBack, c as pageStack, d as remote, f as scrollTo, g as tap, i as input, l as reLaunch, m as systemInfo, n as captureScreenshotBuffer, o as navigateTo, p as switchTab, r as currentPage, s as pageData, t as audit, u as redirectTo, w as i18nText, y as connectMiniProgram, z as createCustomConfig } from "./commands-38LzU5ML.js";
+import fs from "node:fs/promises";
+import { fs as fs$1 } from "@weapp-core/shared";
 import process, { stdin, stdout } from "node:process";
-import fs$1 from "node:fs/promises";
-import pixelmatch from "pixelmatch";
 import { PNG } from "pngjs";
+import pixelmatch from "pixelmatch";
 import { createInterface } from "node:readline/promises";
 import { inspect } from "node:util";
 import { emitKeypressEvents } from "node:readline";
@@ -122,20 +122,20 @@ function readPng(buffer, label) {
 async function comparePngWithBaseline(options) {
 	let baselineBuffer;
 	try {
-		baselineBuffer = await fs$1.readFile(options.baselinePath);
+		baselineBuffer = await fs.readFile(options.baselinePath);
 	} catch (error) {
 		throw new Error(i18nText(`无法读取基准图: ${options.baselinePath}`, `Failed to read baseline image: ${options.baselinePath}`), { cause: error });
 	}
 	const baselinePng = readPng(baselineBuffer, i18nText("基准图", "Baseline image"));
 	const currentPng = readPng(options.currentPngBuffer, i18nText("当前截图", "Current screenshot"));
 	if (baselinePng.width !== currentPng.width || baselinePng.height !== currentPng.height) throw new Error(i18nText("基准图与当前截图尺寸不一致", "Baseline image size does not match current screenshot"));
-	if (options.currentOutputPath) await fs$1.writeFile(options.currentOutputPath, options.currentPngBuffer);
+	if (options.currentOutputPath) await fs.writeFile(options.currentOutputPath, options.currentPngBuffer);
 	const diffPng = new PNG({
 		width: currentPng.width,
 		height: currentPng.height
 	});
 	const diffPixels = pixelmatch(baselinePng.data, currentPng.data, diffPng.data, currentPng.width, currentPng.height, { threshold: options.threshold });
-	if (options.diffOutputPath) await fs$1.writeFile(options.diffOutputPath, PNG.sync.write(diffPng));
+	if (options.diffOutputPath) await fs.writeFile(options.diffOutputPath, PNG.sync.write(diffPng));
 	return {
 		baselinePath: options.baselinePath,
 		currentPath: options.currentOutputPath,
@@ -178,6 +178,7 @@ ${colors.bold("参数:")}
       --current-output <path>    当前截图输出路径
       --diff-output <path>       diff 图片输出路径
       --page <path>              对比前先跳转页面
+      --full-page                对比时使用整页长截图
       --threshold <number>       pixelmatch threshold（默认：0.1）
       --max-diff-pixels <count>  最大允许差异像素数
       --max-diff-ratio <number>  最大允许差异占比（0-1）
@@ -192,6 +193,8 @@ ${colors.bold("规则:")}
   - baseline 与当前截图尺寸不一致时直接失败
 
 ${colors.bold("示例:")}
+  weapp compare -p ./dist/build/mp-weixin --page pages/index/index --full-page --baseline .screenshots/baseline/index.full.png --current-output .screenshots/current/index.full.png --diff-output .screenshots/diff/index.full.diff.png --max-diff-pixels 100 --json
+
   weapp compare -p ./dist/build/mp-weixin --page pages/index/index --baseline .screenshots/baseline/index.png --current-output .screenshots/current/index.png --diff-output .screenshots/diff/index.diff.png --max-diff-pixels 100 --json
 
   weapp compare -p ./dist/build/mp-weixin --baseline .screenshots/baseline/index.png --max-diff-ratio 0.001
@@ -204,6 +207,7 @@ ${colors.bold("Options:")}
       --current-output <path>    Output file path for current screenshot
       --diff-output <path>       Output file path for diff image
       --page <path>              Navigate to page before comparison
+      --full-page                Use stitched full-page screenshots for comparison
       --threshold <number>       Pixelmatch threshold (default: 0.1)
       --max-diff-pixels <count>  Maximum allowed diff pixels
       --max-diff-ratio <number>  Maximum allowed diff ratio (0-1)
@@ -218,6 +222,8 @@ ${colors.bold("Rules:")}
   - Baseline and current screenshot must have identical dimensions
 
 ${colors.bold("Examples:")}
+  weapp compare -p ./dist/build/mp-weixin --page pages/index/index --full-page --baseline .screenshots/baseline/index.full.png --current-output .screenshots/current/index.full.png --diff-output .screenshots/diff/index.full.diff.png --max-diff-pixels 100 --json
+
   weapp compare -p ./dist/build/mp-weixin --page pages/index/index --baseline .screenshots/baseline/index.png --current-output .screenshots/current/index.png --diff-output .screenshots/diff/index.diff.png --max-diff-pixels 100 --json
 
   weapp compare -p ./dist/build/mp-weixin --baseline .screenshots/baseline/index.png --max-diff-ratio 0.001
@@ -238,6 +244,7 @@ function parseCompareArgs(argv) {
 		projectPath: parsed.projectPath,
 		timeout: parsed.timeout,
 		page: readOptionValue(argv, "--page"),
+		fullPage: argv.includes("--full-page"),
 		baselinePath,
 		currentOutputPath: readOptionValue(argv, "--current-output"),
 		diffOutputPath: readOptionValue(argv, "--diff-output"),
@@ -318,6 +325,7 @@ ${colors.bold("参数:")}
   -p, --project <path>   项目路径（默认：当前目录）
   -o, --output <path>    截图输出文件路径
       --page <path>      截图前先跳转页面
+      --full-page        输出整页长截图
   -t, --timeout <ms>     连接超时时间（默认：30000）
       --json             以 JSON 格式输出
       --lang <lang>      语言切换：zh | en（默认：zh）
@@ -333,6 +341,9 @@ ${colors.bold("示例:")}
   # 先跳转页面再截图
   weapp screenshot -p /path/to/project --page pages/index/index
 
+  # 输出整页长截图
+  weapp screenshot -p /path/to/project --page pages/index/index --full-page -o full.png
+
   # 以 JSON 输出便于脚本解析
   weapp screenshot -p /path/to/project --json
 `, `
@@ -342,6 +353,7 @@ ${colors.bold("Options:")}
   -p, --project <path>   Project path (default: current directory)
   -o, --output <path>    Output file path for screenshot
       --page <path>      Navigate to page before taking screenshot
+      --full-page        Capture a stitched full-page screenshot
   -t, --timeout <ms>     Connection timeout in milliseconds (default: 30000)
       --json             Output as JSON format
       --lang <lang>      Language: zh | en (default: zh)
@@ -357,6 +369,9 @@ ${colors.bold("Examples:")}
   # Navigate to page first
   weapp screenshot -p /path/to/project --page pages/index/index
 
+  # Capture a stitched full-page screenshot
+  weapp screenshot -p /path/to/project --page pages/index/index --full-page -o full.png
+
   # JSON output for parsing
   weapp screenshot -p /path/to/project --json
 `));
@@ -366,11 +381,15 @@ ${colors.bold("Examples:")}
 */
 function parseScreenshotArgs(argv) {
 	const parsed = parseAutomatorArgs(argv);
+	const outputPath = readOptionValue(argv, "-o") || readOptionValue(argv, "--output");
+	const page = readOptionValue(argv, "--page");
+	const fullPage = argv.includes("--full-page");
 	return {
 		projectPath: parsed.projectPath,
-		timeout: parsed.timeout,
-		outputPath: readOptionValue(argv, "-o") || readOptionValue(argv, "--output"),
-		page: readOptionValue(argv, "--page")
+		...parsed.timeout ? { timeout: parsed.timeout } : {},
+		...outputPath ? { outputPath } : {},
+		...page ? { page } : {},
+		...fullPage ? { fullPage: true } : {}
 	};
 }
 /**
@@ -383,7 +402,7 @@ async function runScreenshot(argv) {
 	}
 	const options = parseScreenshotArgs(argv);
 	const isJsonOutput = argv.includes("--json");
-	const { takeScreenshot } = await import("./commands-BfdE1eYN.js").then((n) => n.r);
+	const { takeScreenshot } = await import("./commands-msx1PSZ8.js");
 	const result = await takeScreenshot(options);
 	if (isJsonOutput) {
 		console.log(JSON.stringify(result, null, 2));
@@ -787,7 +806,7 @@ async function promptForCliPath() {
 		try {
 			const normalizedPath = await createCustomConfig({ cliPath });
 			logger_default.info(`全局配置存储位置：${colors.green(defaultCustomConfigFilePath)}`);
-			if (!await fs.pathExists(normalizedPath)) logger_default.warn("在当前路径未找到微信web开发者命令行工具，请确认路径是否正确。");
+			if (!await fs$1.pathExists(normalizedPath)) logger_default.warn("在当前路径未找到微信web开发者命令行工具，请确认路径是否正确。");
 			return normalizedPath;
 		} catch (error) {
 			const reason = error instanceof Error ? error.message : String(error);
@@ -859,7 +878,7 @@ async function handleConfigCommand(argv) {
 	}
 	if (action === "doctor") {
 		const rawConfig = await readCustomConfig();
-		const hasConfigFile = await fs.pathExists(defaultCustomConfigFilePath);
+		const hasConfigFile = await fs$1.pathExists(defaultCustomConfigFilePath);
 		const resolvedCli = await resolveCliPath();
 		const hasCustomCli = typeof rawConfig.cliPath === "string" && rawConfig.cliPath.length > 0;
 		const hasValidCli = Boolean(resolvedCli.cliPath);
@@ -882,7 +901,7 @@ async function handleConfigCommand(argv) {
 		const outputPath = argv[1];
 		const config = await readCustomConfig();
 		if (outputPath) {
-			await fs.writeJSON(outputPath, config, {
+			await fs$1.writeJSON(outputPath, config, {
 				spaces: 2,
 				encoding: "utf8"
 			});
@@ -895,7 +914,7 @@ async function handleConfigCommand(argv) {
 	if (action === "import") {
 		const inputPath = argv[1];
 		if (!inputPath) throw new Error(i18nText("请提供导入文件路径，例如：weapp config import ./weapp-config.json", "Please provide import file path, e.g. weapp config import ./weapp-config.json"));
-		const imported = await fs.readJSON(inputPath);
+		const imported = await fs$1.readJSON(inputPath);
 		if (!imported || typeof imported !== "object") throw new Error(i18nText("导入文件格式无效：应为 JSON 对象", "Invalid import file format: expected a JSON object"));
 		const candidate = imported;
 		await overwriteCustomConfig({

package/dist/cli.js

@@ -1,18 +1,15 @@
-import { U as logger_default } from "./commands-BfdE1eYN.js";
-import { n as parse } from "./cli-DXJCUYYI.js";
+import { Q as logger_default } from "./commands-38LzU5ML.js";
+import { n as parse } from "./cli-1zieDX-6.js";
 import process from "node:process";
 //#region src/cli.ts
-parse(process.argv.slice(2)).catch((err) => {
+const argv = process.argv.slice(2);
+try {
+	await parse(argv);
+} catch (err) {
 	logger_default.error(err);
-	if (typeof err?.exitCode === "number") {
-		process.exitCode = err.exitCode;
-		return;
-	}
-	if (typeof err?.code === "number") {
-		process.exitCode = err.code;
-		return;
-	}
-	process.exitCode = 1;
-});
+	if (typeof err?.exitCode === "number") process.exitCode = err.exitCode;
+	else if (typeof err?.code === "number") process.exitCode = err.code;
+	else process.exitCode = 1;
+}
 //#endregion
 export {};

package/dist/{commands-BfdE1eYN.js → commands-38LzU5ML.js}

@@ -1,23 +1,13 @@
+import { Buffer } from "node:buffer";
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
 import { Launcher } from "@weapp-vite/miniprogram-automator";
-import { fs } from "@weapp-core/shared";
+import { fs as fs$1 } from "@weapp-core/shared";
 import logger, { colors } from "@weapp-core/logger";
-import os from "node:os";
 import process from "node:process";
-import path from "pathe";
-import { Buffer as Buffer$1 } from "node:buffer";
-import fs$1 from "node:fs/promises";
-//#region \0rolldown/runtime.js
-var __defProp = Object.defineProperty;
-var __exportAll = (all, no_symbols) => {
-	let target = {};
-	for (var name in all) __defProp(target, name, {
-		get: all[name],
-		enumerable: true
-	});
-	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
-	return target;
-};
-//#endregion
+import path$1 from "pathe";
+import { PNG } from "pngjs";
 //#region src/logger.ts
 var logger_default = logger;
 //#endregion
@@ -42,11 +32,11 @@ function isOperatingSystemSupported(osName = os.type()) {
 */
 const operatingSystemName = os.type();
 async function getFirstBinaryPath(command) {
-	const pathDirs = (process.env.PATH || "").split(path.delimiter);
+	const pathDirs = (process.env.PATH || "").split(path$1.delimiter);
 	for (const dir of pathDirs) {
-		const fullPath = path.join(dir, command);
+		const fullPath = path$1.join(dir, command);
 		try {
-			await fs.access(fullPath, fs.constants.X_OK);
+			await fs$1.access(fullPath, fs$1.constants.X_OK);
 			return fullPath;
 		} catch {
 			continue;
@@ -96,8 +86,8 @@ async function getDefaultCliPath(targetOs = operatingSystemName) {
 * @description 解析为绝对路径（基于当前工作目录）
 */
 function resolvePath(filePath) {
-	if (path.isAbsolute(filePath)) return filePath;
-	return path.resolve(process.cwd(), filePath);
+	if (path$1.isAbsolute(filePath)) return filePath;
+	return path$1.resolve(process.cwd(), filePath);
 }
 //#endregion
 //#region src/config/paths.ts
@@ -105,11 +95,11 @@ const homedir = os.homedir();
 /**
 * @description 默认自定义配置目录
 */
-const defaultCustomConfigDirPath = path.join(homedir, ".weapp-ide-cli");
+const defaultCustomConfigDirPath = path$1.join(homedir, ".weapp-ide-cli");
 /**
 * @description 默认自定义配置文件路径
 */
-const defaultCustomConfigFilePath = path.join(defaultCustomConfigDirPath, "config.json");
+const defaultCustomConfigFilePath = path$1.join(defaultCustomConfigDirPath, "config.json");
 //#endregion
 //#region src/config/custom.ts
 const JSON_OPTIONS = {
@@ -117,9 +107,9 @@ const JSON_OPTIONS = {
 	spaces: 2
 };
 async function readCustomConfig() {
-	if (!await fs.pathExists(defaultCustomConfigFilePath)) return {};
+	if (!await fs$1.pathExists(defaultCustomConfigFilePath)) return {};
 	try {
-		const config = await fs.readJSON(defaultCustomConfigFilePath);
+		const config = await fs$1.readJSON(defaultCustomConfigFilePath);
 		if (!config || typeof config !== "object") return {};
 		const candidate = config;
 		const next = {};
@@ -135,8 +125,8 @@ async function writeCustomConfig(patch, options = {}) {
 		...options.replace ? {} : await readCustomConfig(),
 		...patch
 	};
-	await fs.ensureDir(defaultCustomConfigDirPath);
-	await fs.writeJSON(defaultCustomConfigFilePath, nextConfig, JSON_OPTIONS);
+	await fs$1.ensureDir(defaultCustomConfigDirPath);
+	await fs$1.writeJSON(defaultCustomConfigFilePath, nextConfig, JSON_OPTIONS);
 }
 /**
 * @description 写入自定义 CLI 路径配置
@@ -176,12 +166,16 @@ async function overwriteCustomConfig(config) {
 }
 //#endregion
 //#region src/config/resolver.ts
+function isCustomConfigJson(value) {
+	return typeof value === "object" && value !== null;
+}
 /**
 * @description 读取并解析 CLI 配置（自定义优先）
 */
 async function getConfig() {
-	if (await fs.pathExists(defaultCustomConfigFilePath)) try {
-		const config = await fs.readJSON(defaultCustomConfigFilePath);
+	if (await fs$1.pathExists(defaultCustomConfigFilePath)) try {
+		const rawConfig = await fs$1.readJSON(defaultCustomConfigFilePath);
+		const config = isCustomConfigJson(rawConfig) ? rawConfig : {};
 		const cliPath = typeof config.cliPath === "string" ? config.cliPath.trim() : "";
 		const locale = config.locale === "zh" || config.locale === "en" ? config.locale : void 0;
 		if (cliPath) {
@@ -228,7 +222,7 @@ async function resolveCliPath() {
 		source: config.source
 	};
 	return {
-		cliPath: await fs.pathExists(config.cliPath) ? config.cliPath : null,
+		cliPath: await fs$1.pathExists(config.cliPath) ? config.cliPath : null,
 		source: config.source
 	};
 }
@@ -242,6 +236,10 @@ const LOGIN_REQUIRED_CN_RE = /需要重新登录/;
 const LOGIN_REQUIRED_EN_RE = /need\s+re-?login|re-?login/i;
 const LOGIN_REQUIRED_CODE_RE = /code\s*[:=]\s*(\d+)/i;
 const DEVTOOLS_HTTP_PORT_ERROR = "Failed to launch wechat web devTools, please make sure http port is open";
+const DEVTOOLS_EXTENSION_CONTEXT_INVALIDATED_RE = /Extension context invalidated/i;
+const AUTOMATOR_LAUNCH_TIMEOUT_RE = /Wait timed out after \d+ ms/i;
+const AUTOMATOR_WS_CONNECT_RE = /Failed connecting to ws:\/\/127\.0\.0\.1:\d+/i;
+const DEVTOOLS_PROTOCOL_TIMEOUT_RE = /DevTools did not respond to protocol method (\S+) within \d+ms/i;
 const DEVTOOLS_INFRA_ERROR_PATTERNS = [
 	/listen EPERM/i,
 	/operation not permitted 0\.0\.0\.0/i,
@@ -249,6 +247,8 @@ const DEVTOOLS_INFRA_ERROR_PATTERNS = [
 	/ECONNREFUSED/i,
 	/connect ECONNREFUSED/i
 ];
+const DEFAULT_WECHAT_DEVTOOLS_WS_ENDPOINT = "ws://127.0.0.1:9420";
+const AUTOMATOR_SESSION_DIR = path.join(os.tmpdir(), "weapp-vite-automator-sessions");
 const DEVTOOLS_LOGIN_REQUIRED_PATTERNS = [
 	/code\s*[:=]\s*10/i,
 	/需要重新登录/,
@@ -268,6 +268,38 @@ function extractErrorText(error) {
 		candidate.stdout
 	].filter((value) => typeof value === "string" && value.trim().length > 0).join("\n");
 }
+function resolveAutomatorSessionFilePath(projectPath) {
+	const normalizedProjectPath = path.resolve(projectPath);
+	const encodedProjectPath = Buffer.from(normalizedProjectPath).toString("base64url");
+	return path.join(AUTOMATOR_SESSION_DIR, `${encodedProjectPath}.json`);
+}
+async function persistAutomatorSession(projectPath, wsEndpoint) {
+	const filePath = resolveAutomatorSessionFilePath(projectPath);
+	const payload = {
+		projectPath: path.resolve(projectPath),
+		updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+		wsEndpoint
+	};
+	await fs.mkdir(path.dirname(filePath), { recursive: true });
+	await fs.writeFile(filePath, JSON.stringify(payload, null, 2), "utf8");
+}
+async function readPersistedAutomatorSession(projectPath) {
+	const filePath = resolveAutomatorSessionFilePath(projectPath);
+	try {
+		const raw = await fs.readFile(filePath, "utf8");
+		const payload = JSON.parse(raw);
+		if (payload.projectPath !== path.resolve(projectPath) || typeof payload.wsEndpoint !== "string" || !payload.wsEndpoint.trim()) return null;
+		return payload;
+	} catch {
+		return null;
+	}
+}
+async function removePersistedAutomatorSession(projectPath) {
+	const filePath = resolveAutomatorSessionFilePath(projectPath);
+	try {
+		await fs.rm(filePath, { force: true });
+	} catch {}
+}
 /**
 * @description 提取登录失效时最适合展示给用户的一行信息。
 */
@@ -288,6 +320,40 @@ function isDevtoolsHttpPortError(error) {
 	return message.includes(DEVTOOLS_HTTP_PORT_ERROR) || DEVTOOLS_INFRA_ERROR_PATTERNS.some((pattern) => pattern.test(message));
 }
 /**
+* @description 判断错误是否属于开发者工具 automator 扩展上下文尚未就绪。
+*/
+function isDevtoolsExtensionContextInvalidatedError(error) {
+	const message = error instanceof Error ? error.message : String(error);
+	return DEVTOOLS_EXTENSION_CONTEXT_INVALIDATED_RE.test(message);
+}
+/**
+* @description 判断错误是否属于可重试的 automator 启动抖动。
+*/
+function isRetryableAutomatorLaunchError(error) {
+	const message = error instanceof Error ? error.message : String(error);
+	return DEVTOOLS_EXTENSION_CONTEXT_INVALIDATED_RE.test(message) || AUTOMATOR_LAUNCH_TIMEOUT_RE.test(message) || AUTOMATOR_WS_CONNECT_RE.test(message);
+}
+/**
+* @description 判断错误是否属于开发者工具 websocket 连接失败。
+*/
+function isAutomatorWsConnectError(error) {
+	const message = error instanceof Error ? error.message : String(error);
+	return AUTOMATOR_WS_CONNECT_RE.test(message);
+}
+/**
+* @description 判断错误是否属于开发者工具协议调用超时。
+*/
+function isAutomatorProtocolTimeoutError(error) {
+	const message = error instanceof Error ? error.message : String(error);
+	return DEVTOOLS_PROTOCOL_TIMEOUT_RE.test(message);
+}
+/**
+* @description 提取协议超时的方法名。
+*/
+function getAutomatorProtocolTimeoutMethod(error) {
+	return (error instanceof Error ? error.message : String(error)).match(DEVTOOLS_PROTOCOL_TIMEOUT_RE)?.[1];
+}
+/**
 * @description 判断错误是否属于开发者工具登录失效。
 */
 function isAutomatorLoginError(error) {
@@ -312,13 +378,40 @@ function formatAutomatorLoginError(error) {
 * @description 基于当前配置解析 CLI 路径，并通过现代化 automator 入口启动会话。
 */
 async function launchAutomator(options) {
-	const { cliPath, projectPath, timeout = 3e4 } = options;
+	const { cliPath, projectPath, timeout = 3e4, trustProject = false } = options;
 	const resolvedCliPath = cliPath ?? (await resolveCliPath()).cliPath ?? void 0;
-	return await new Launcher().launch({
-		cliPath: resolvedCliPath,
-		projectPath,
-		timeout
-	});
+	const launcher = new Launcher();
+	let lastError = null;
+	for (let attempt = 0; attempt < 2; attempt += 1) try {
+		const miniProgram = await launcher.launch({
+			cliPath: resolvedCliPath,
+			projectPath,
+			timeout,
+			trustProject
+		});
+		const sessionMetadata = Reflect.get(miniProgram, "__WEAPP_VITE_SESSION_METADATA");
+		if (typeof sessionMetadata?.wsEndpoint === "string" && sessionMetadata.wsEndpoint) await persistAutomatorSession(projectPath, sessionMetadata.wsEndpoint);
+		return miniProgram;
+	} catch (error) {
+		lastError = error;
+		if (!isRetryableAutomatorLaunchError(error) || attempt === 1) throw error;
+	}
+	throw lastError instanceof Error ? lastError : new Error(String(lastError));
+}
+/**
+* @description 连接当前项目已打开的开发者工具自动化会话，不触发新的 IDE 拉起。
+*/
+async function connectOpenedAutomator(options) {
+	const { projectPath } = options;
+	const launcher = new Launcher();
+	const persistedSession = await readPersistedAutomatorSession(projectPath);
+	const wsEndpoint = persistedSession?.wsEndpoint ?? DEFAULT_WECHAT_DEVTOOLS_WS_ENDPOINT;
+	try {
+		return await launcher.connect({ wsEndpoint });
+	} catch (error) {
+		if (persistedSession) await removePersistedAutomatorSession(projectPath);
+		throw error;
+	}
 }
 //#endregion
 //#region src/i18n.ts
@@ -387,6 +480,7 @@ function readLangOption(argv) {
 }
 //#endregion
 //#region src/cli/automator-session.ts
+const sharedMiniProgramSessions = /* @__PURE__ */ new Map();
 function normalizeMiniProgramConnectionError(error) {
 	if (isAutomatorLoginError(error)) {
 		logger_default.error(i18nText("检测到微信开发者工具登录状态失效，请先登录后重试。", "Wechat DevTools login has expired. Please login and retry."));
@@ -398,22 +492,106 @@ function normalizeMiniProgramConnectionError(error) {
 		logger_default.warn(i18nText("请在微信开发者工具中：设置 -> 安全设置 -> 开启服务端口", "Please enable service port in Wechat DevTools: Settings -> Security -> Service Port"));
 		return /* @__PURE__ */ new Error("DEVTOOLS_HTTP_PORT_ERROR");
 	}
+	if (isDevtoolsExtensionContextInvalidatedError(error)) {
+		logger_default.error(i18nText("微信开发者工具自动化上下文尚未就绪，通常是刚启动或正在重载。", "Wechat DevTools automation context is not ready yet, usually because the IDE has just started or is still reloading."));
+		logger_default.warn(i18nText("请稍后重试；若持续失败，关闭多余的开发者工具窗口后重试。", "Please retry shortly. If it keeps failing, close extra DevTools windows and try again."));
+		return /* @__PURE__ */ new Error("DEVTOOLS_EXTENSION_CONTEXT_INVALIDATED");
+	}
+	if (isAutomatorWsConnectError(error)) {
+		logger_default.error(i18nText("无法连接到当前项目的微信开发者工具自动化 websocket。", "Cannot connect to the Wechat DevTools automation websocket for the current project."));
+		logger_default.warn(i18nText("请确认当前打开的是目标项目；若之前跑过其他 e2e / screenshot 任务，关闭多余的微信开发者工具窗口，或结束残留的 `wechatwebdevtools cli auto --project ...` 进程后重试。", "Please confirm the current DevTools window is the target project. If you recently ran other e2e or screenshot tasks, close extra DevTools windows or stop stale `wechatwebdevtools cli auto --project ...` processes and retry."));
+		return /* @__PURE__ */ new Error("DEVTOOLS_WS_CONNECT_ERROR");
+	}
+	if (isAutomatorProtocolTimeoutError(error)) {
+		const method = getAutomatorProtocolTimeoutMethod(error) ?? "unknown";
+		logger_default.error(i18nText(`微信开发者工具在协议调用 ${method} 上超时，未按预期返回结果。`, `Wechat DevTools timed out while executing protocol method ${method} and did not return a result.`));
+		logger_default.warn(i18nText("这通常表示当前 DevTools 自动化会话已卡住、窗口不在目标项目、或当前 DevTools 版本对该协议调用无响应。请重开目标项目窗口后重试；若仍复现，优先记录当前 DevTools 版本与协议方法名继续排查。", "This usually means the current DevTools automation session is stuck, the window is not on the target project, or the current DevTools version is not responding to that protocol method. Reopen the target project window and retry. If it still reproduces, record the current DevTools version and protocol method name for follow-up debugging."));
+		return /* @__PURE__ */ new Error("DEVTOOLS_PROTOCOL_TIMEOUT");
+	}
 	return error instanceof Error ? error : new Error(String(error));
 }
 /**
 * @description 建立 automator 会话，并统一处理常见连接错误提示。
 */
 async function connectMiniProgram(options) {
-	try {
+	if (options.preferOpenedSession === false) try {
 		return await launchAutomator(options);
 	} catch (error) {
 		throw normalizeMiniProgramConnectionError(error);
 	}
+	try {
+		return await connectOpenedAutomator(options);
+	} catch (error) {
+		const normalizedOpenSessionError = normalizeMiniProgramConnectionError(error);
+		if (normalizedOpenSessionError instanceof Error && normalizedOpenSessionError.message === "DEVTOOLS_PROTOCOL_TIMEOUT") throw normalizedOpenSessionError;
+		try {
+			return await launchAutomator(options);
+		} catch (launchError) {
+			throw normalizeMiniProgramConnectionError(launchError);
+		}
+	}
+}
+/**
+* @description 获取指定项目的共享 automator 会话；若不存在则自动创建。
+*/
+async function acquireSharedMiniProgram(options) {
+	const existing = sharedMiniProgramSessions.get(options.projectPath);
+	if (existing) {
+		existing.refs += 1;
+		return await existing.session;
+	}
+	const session = connectMiniProgram(options);
+	const entry = {
+		refs: 1,
+		session
+	};
+	sharedMiniProgramSessions.set(options.projectPath, entry);
+	try {
+		return await session;
+	} catch (error) {
+		sharedMiniProgramSessions.delete(options.projectPath);
+		throw error;
+	}
+}
+/**
+* @description 释放指定项目的共享会话引用；会话对象会继续缓存，直到显式关闭或重置。
+*/
+function releaseSharedMiniProgram(projectPath) {
+	const entry = sharedMiniProgramSessions.get(projectPath);
+	if (!entry) return;
+	entry.refs = Math.max(0, entry.refs - 1);
+}
+/**
+* @description 关闭并移除指定项目的共享 automator 会话。
+*/
+async function closeSharedMiniProgram(projectPath) {
+	const entry = sharedMiniProgramSessions.get(projectPath);
+	if (!entry) return;
+	sharedMiniProgramSessions.delete(projectPath);
+	(await entry.session.catch(() => null))?.disconnect();
+}
+/**
+* @description 获取当前共享会话数量，供测试断言使用。
+*/
+function getSharedMiniProgramSessionCount() {
+	return sharedMiniProgramSessions.size;
 }
 /**
 * @description 统一管理 automator 会话生命周期。
 */
 async function withMiniProgram(options, runner) {
+	if (options.miniProgram) return await runner(options.miniProgram);
+	if (options.sharedSession) {
+		const miniProgram = await acquireSharedMiniProgram(options);
+		try {
+			return await runner(miniProgram);
+		} catch (error) {
+			await closeSharedMiniProgram(options.projectPath);
+			throw normalizeMiniProgramConnectionError(error);
+		} finally {
+			releaseSharedMiniProgram(options.projectPath);
+		}
+	}
 	let miniProgram = null;
 	try {
 		miniProgram = await connectMiniProgram(options);
@@ -425,25 +603,121 @@ async function withMiniProgram(options, runner) {
 	}
 }
 //#endregion
+//#region src/cli/fullPageScreenshot.ts
+function decodeScreenshotBuffer(raw) {
+	const buffer = typeof raw === "string" ? Buffer.from(raw, "base64") : Buffer.from(raw);
+	if (buffer.length === 0) throw new Error("Failed to capture screenshot");
+	return buffer;
+}
+function toPositiveNumber(value) {
+	return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : void 0;
+}
+function createScrollPositions(totalHeight, viewportHeight) {
+	if (totalHeight <= viewportHeight) return [0];
+	const positions = [];
+	const lastStart = Math.max(totalHeight - viewportHeight, 0);
+	for (let scrollTop = 0; scrollTop < lastStart; scrollTop += viewportHeight) positions.push(scrollTop);
+	if (positions.at(-1) !== lastStart) positions.push(lastStart);
+	return positions;
+}
+function cropPngRows(source, startRow, rowCount) {
+	const cropped = new PNG({
+		width: source.width,
+		height: rowCount
+	});
+	const bytesPerRow = source.width * 4;
+	for (let row = 0; row < rowCount; row += 1) {
+		const sourceStart = (startRow + row) * bytesPerRow;
+		const sourceEnd = sourceStart + bytesPerRow;
+		cropped.data.set(source.data.subarray(sourceStart, sourceEnd), row * bytesPerRow);
+	}
+	return cropped;
+}
+async function restoreScrollPosition(miniProgram, page, scrollTop) {
+	await miniProgram.pageScrollTo(scrollTop);
+	await page.waitFor(150);
+}
+/**
+* @description 通过多次滚动和拼接生成整页长截图。
+*/
+async function captureFullPageScreenshotBuffer(options) {
+	const { miniProgram, timeoutMs, runWithTimeout, screenshotTimeoutMessage } = options;
+	const page = await miniProgram.currentPage();
+	const pageSize = await page.size();
+	const systemInfo = await miniProgram.systemInfo();
+	const initialScrollTop = typeof page.scrollTop === "function" ? await page.scrollTop() : 0;
+	const pageHeight = toPositiveNumber(pageSize.height);
+	const viewportHeight = toPositiveNumber(systemInfo.windowHeight);
+	if (!pageHeight || !viewportHeight) return decodeScreenshotBuffer(await runWithTimeout(miniProgram.screenshot(), timeoutMs, screenshotTimeoutMessage, "DEVTOOLS_SCREENSHOT_TIMEOUT"));
+	const segments = [];
+	const positions = createScrollPositions(pageHeight, viewportHeight);
+	let coveredUntil = 0;
+	let scale = 1;
+	try {
+		for (const scrollTop of positions) {
+			await miniProgram.pageScrollTo(scrollTop);
+			await page.waitFor(150);
+			const rawScreenshot = await runWithTimeout(miniProgram.screenshot(), timeoutMs, screenshotTimeoutMessage, "DEVTOOLS_SCREENSHOT_TIMEOUT");
+			const png = PNG.sync.read(decodeScreenshotBuffer(rawScreenshot));
+			if (viewportHeight > 0) scale = png.height / viewportHeight;
+			const visibleEnd = Math.min(scrollTop + viewportHeight, pageHeight);
+			const cropTopCss = Math.max(coveredUntil - scrollTop, 0);
+			const segmentHeightCss = Math.max(visibleEnd - scrollTop - cropTopCss, 0);
+			if (segmentHeightCss <= 0) continue;
+			const cropTopRows = Math.min(Math.max(Math.round(cropTopCss * scale), 0), png.height);
+			const segmentRows = Math.min(Math.max(Math.round(segmentHeightCss * scale), 1), png.height - cropTopRows);
+			segments.push(cropPngRows(png, cropTopRows, segmentRows));
+			coveredUntil = visibleEnd;
+		}
+	} finally {
+		await restoreScrollPosition(miniProgram, page, initialScrollTop);
+	}
+	if (segments.length === 0) throw new Error("Failed to capture screenshot");
+	const width = segments[0].width;
+	const merged = new PNG({
+		width,
+		height: segments.reduce((sum, segment) => sum + segment.height, 0)
+	});
+	const bytesPerRow = width * 4;
+	let offsetY = 0;
+	for (const segment of segments) {
+		if (segment.width !== width) throw new Error("Full-page screenshots have inconsistent widths");
+		for (let row = 0; row < segment.height; row += 1) {
+			const sourceStart = row * bytesPerRow;
+			const sourceEnd = sourceStart + bytesPerRow;
+			merged.data.set(segment.data.subarray(sourceStart, sourceEnd), (offsetY + row) * bytesPerRow);
+		}
+		offsetY += segment.height;
+	}
+	return PNG.sync.write(merged);
+}
+//#endregion
 //#region src/cli/commands.ts
-var commands_exports = /* @__PURE__ */ __exportAll({
-	audit: () => audit,
-	captureScreenshotBuffer: () => captureScreenshotBuffer,
-	currentPage: () => currentPage,
-	input: () => input,
-	navigateBack: () => navigateBack,
-	navigateTo: () => navigateTo,
-	pageData: () => pageData,
-	pageStack: () => pageStack,
-	reLaunch: () => reLaunch,
-	redirectTo: () => redirectTo,
-	remote: () => remote,
-	scrollTo: () => scrollTo,
-	switchTab: () => switchTab,
-	systemInfo: () => systemInfo,
-	takeScreenshot: () => takeScreenshot,
-	tap: () => tap
-});
+function createTimeoutError(message, code) {
+	const error = new Error(message);
+	error.code = code;
+	return error;
+}
+function normalizePagePath(page) {
+	return page.startsWith("/") ? page : `/${page}`;
+}
+function sleep(ms) {
+	return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function withCommandTimeout(task, timeoutMs, message, code) {
+	return new Promise((resolve, reject) => {
+		const timeout = setTimeout(() => {
+			reject(createTimeoutError(message, code));
+		}, timeoutMs);
+		task.then((value) => {
+			clearTimeout(timeout);
+			resolve(value);
+		}).catch((error) => {
+			clearTimeout(timeout);
+			reject(error);
+		});
+	});
+}
 async function runRouteCommand(options, startMessage, successMessage, action) {
 	await withMiniProgram(options, async (miniProgram) => {
 		logger_default.info(startMessage);
@@ -581,7 +855,7 @@ async function audit(options) {
 		logger_default.info(i18nText("正在执行体验审计...", "Running experience audit..."));
 		const result = await miniProgram.stopAudits();
 		if (options.outputPath) {
-			await fs$1.writeFile(options.outputPath, JSON.stringify(result, null, 2));
+			await fs.writeFile(options.outputPath, JSON.stringify(result, null, 2));
 			logger_default.success(i18nText(`审计报告已保存到 ${colors.cyan(options.outputPath)}`, `Audit report saved to ${colors.cyan(options.outputPath)}`));
 			return result;
 		}
@@ -594,14 +868,27 @@ async function audit(options) {
 */
 async function captureScreenshotBuffer(options) {
 	return await withMiniProgram(options, async (miniProgram) => {
-		logger_default.info(i18nText(`正在连接 DevTools：${colors.cyan(options.projectPath)}...`, `Connecting to DevTools at ${colors.cyan(options.projectPath)}...`));
+		const commandTimeout = options.timeout ?? 3e4;
+		const screenshotTimeoutMessage = i18nText(`截图请求在 ${commandTimeout}ms 内未收到 DevTools 回包，请检查当前微信开发者工具是否仍停留在目标项目；若近期执行过其他 e2e / screenshot 任务，关闭多余窗口并清理残留 automator 会话后重试。`, `Screenshot request did not receive a DevTools response within ${commandTimeout}ms. Check that the current Wechat DevTools window is still the target project. If you recently ran other e2e or screenshot tasks, close extra windows and clean up stale automator sessions before retrying.`);
+		if (!options.miniProgram) logger_default.info(i18nText(`正在连接 DevTools：${colors.cyan(options.projectPath)}...`, `Connecting to DevTools at ${colors.cyan(options.projectPath)}...`));
 		if (options.page) {
-			logger_default.info(i18nText(`正在跳转页面 ${colors.cyan(options.page)}...`, `Navigating to page ${colors.cyan(options.page)}...`));
-			await miniProgram.reLaunch(options.page);
+			const normalizedPage = normalizePagePath(options.page);
+			logger_default.info(i18nText(`正在跳转页面 ${colors.cyan(normalizedPage)}...`, `Navigating to page ${colors.cyan(normalizedPage)}...`));
+			await miniProgram.reLaunch(normalizedPage);
+			if (options.fullPage) await sleep(1e3);
+		}
+		if (options.fullPage) {
+			logger_default.info(i18nText("正在生成整页长截图...", "Capturing full-page screenshot..."));
+			return await captureFullPageScreenshotBuffer({
+				miniProgram,
+				timeoutMs: commandTimeout,
+				runWithTimeout: withCommandTimeout,
+				screenshotTimeoutMessage
+			});
 		}
 		logger_default.info(i18nText("正在截图...", "Taking screenshot..."));
-		const screenshot = await miniProgram.screenshot();
-		const buffer = typeof screenshot === "string" ? Buffer$1.from(screenshot, "base64") : Buffer$1.from(screenshot);
+		const screenshot = await withCommandTimeout(miniProgram.screenshot(), commandTimeout, screenshotTimeoutMessage, "DEVTOOLS_SCREENSHOT_TIMEOUT");
+		const buffer = typeof screenshot === "string" ? Buffer.from(screenshot, "base64") : Buffer.from(screenshot);
 		if (buffer.length === 0) throw new Error(i18nText("截图失败", "Failed to capture screenshot"));
 		return buffer;
 	});
@@ -610,10 +897,23 @@ async function captureScreenshotBuffer(options) {
 * @description 获取当前小程序截图。
 */
 async function takeScreenshot(options) {
-	const screenshotBuffer = await captureScreenshotBuffer(options);
+	let screenshotBuffer;
+	try {
+		screenshotBuffer = await captureScreenshotBuffer(options);
+	} catch (error) {
+		const isProtocolTimeout = error instanceof Error && error.message === "DEVTOOLS_PROTOCOL_TIMEOUT";
+		if (!Boolean(options.sharedSession && !options.miniProgram && isProtocolTimeout)) throw error;
+		await closeSharedMiniProgram(options.projectPath);
+		logger_default.warn(i18nText("当前共享 DevTools 会话截图超时，正在改用全新自动化会话重试一次...", "The current shared DevTools session timed out while capturing screenshot. Retrying once with a fresh automation session..."));
+		screenshotBuffer = await captureScreenshotBuffer({
+			...options,
+			preferOpenedSession: false,
+			sharedSession: false
+		});
+	}
 	const base64 = screenshotBuffer.toString("base64");
 	if (options.outputPath) {
-		await fs$1.writeFile(options.outputPath, screenshotBuffer);
+		await fs.writeFile(options.outputPath, screenshotBuffer);
 		logger_default.success(i18nText(`截图已保存到 ${colors.cyan(options.outputPath)}`, `Screenshot saved to ${colors.cyan(options.outputPath)}`));
 		return { path: options.outputPath };
 	}
@@ -631,4 +931,4 @@ async function remote(options) {
 	});
 }
 //#endregion
-export { createCustomConfig as A, isOperatingSystemSupported as B, formatAutomatorLoginError as C, resolveCliPath as D, launchAutomator as E, defaultCustomConfigDirPath as F, colors as H, defaultCustomConfigFilePath as I, resolvePath as L, overwriteCustomConfig as M, readCustomConfig as N, getConfig as O, removeCustomConfigKey as P, SupportedPlatformsMap as R, validateLocaleOption as S, isDevtoolsHttpPortError as T, logger_default as U, operatingSystemName as V, tap as _, input as a, configureLocaleFromArgv as b, pageData as c, redirectTo as d, remote as f, takeScreenshot as g, systemInfo as h, currentPage as i, createLocaleConfig as j, getConfiguredLocale as k, pageStack as l, switchTab as m, captureScreenshotBuffer as n, navigateBack as o, scrollTo as p, commands_exports as r, navigateTo as s, audit as t, reLaunch as u, connectMiniProgram as v, isAutomatorLoginError as w, i18nText as x, withMiniProgram as y, getDefaultCliPath as z };
+export { isAutomatorProtocolTimeoutError as A, createLocaleConfig as B, configureLocaleFromArgv as C, formatAutomatorLoginError as D, connectOpenedAutomator as E, launchAutomator as F, defaultCustomConfigFilePath as G, readCustomConfig as H, resolveCliPath as I, getDefaultCliPath as J, resolvePath as K, getConfig as L, isDevtoolsExtensionContextInvalidatedError as M, isDevtoolsHttpPortError as N, getAutomatorProtocolTimeoutMethod as O, isRetryableAutomatorLaunchError as P, logger_default as Q, getConfiguredLocale as R, withMiniProgram as S, validateLocaleOption as T, removeCustomConfigKey as U, overwriteCustomConfig as V, defaultCustomConfigDirPath as W, operatingSystemName as X, isOperatingSystemSupported as Y, colors as Z, acquireSharedMiniProgram as _, navigateBack as a, getSharedMiniProgramSessionCount as b, pageStack as c, remote as d, scrollTo as f, tap as g, takeScreenshot as h, input as i, isAutomatorWsConnectError as j, isAutomatorLoginError as k, reLaunch as l, systemInfo as m, captureScreenshotBuffer as n, navigateTo as o, switchTab as p, SupportedPlatformsMap as q, currentPage as r, pageData as s, audit as t, redirectTo as u, closeSharedMiniProgram as v, i18nText as w, releaseSharedMiniProgram as x, connectMiniProgram as y, createCustomConfig as z };

package/dist/commands-msx1PSZ8.js

@@ -0,0 +1,2 @@
+import { h as takeScreenshot } from "./commands-38LzU5ML.js";
+export { takeScreenshot };

package/dist/index.d.ts

@@ -1,18 +1,41 @@
-import { Element, MiniProgram, Page } from "@weapp-vite/miniprogram-automator";
 import { Buffer } from "node:buffer";
-import * as cac$1 from "cac";
-import * as execa from "execa";
+import * as _$_weapp_vite_miniprogram_automator0 from "@weapp-vite/miniprogram-automator";
+import { Element, MiniProgram, Page } from "@weapp-vite/miniprogram-automator";
+import * as _$cac from "cac";
+import * as _$execa from "execa";
 
 //#region src/cli/automator.d.ts
 interface AutomatorOptions {
   projectPath: string;
   timeout?: number;
   cliPath?: string;
+  trustProject?: boolean;
+  preferOpenedSession?: boolean;
 }
 /**
  * @description 判断错误是否属于开发者工具服务端口不可用。
  */
 declare function isDevtoolsHttpPortError(error: unknown): boolean;
+/**
+ * @description 判断错误是否属于开发者工具 automator 扩展上下文尚未就绪。
+ */
+declare function isDevtoolsExtensionContextInvalidatedError(error: unknown): boolean;
+/**
+ * @description 判断错误是否属于可重试的 automator 启动抖动。
+ */
+declare function isRetryableAutomatorLaunchError(error: unknown): boolean;
+/**
+ * @description 判断错误是否属于开发者工具 websocket 连接失败。
+ */
+declare function isAutomatorWsConnectError(error: unknown): boolean;
+/**
+ * @description 判断错误是否属于开发者工具协议调用超时。
+ */
+declare function isAutomatorProtocolTimeoutError(error: unknown): boolean;
+/**
+ * @description 提取协议超时的方法名。
+ */
+declare function getAutomatorProtocolTimeoutMethod(error: unknown): string | undefined;
 /**
  * @description 判断错误是否属于开发者工具登录失效。
  */
@@ -25,6 +48,10 @@ declare function formatAutomatorLoginError(error: unknown): string;
  * @description 基于当前配置解析 CLI 路径，并通过现代化 automator 入口启动会话。
  */
 declare function launchAutomator(options: AutomatorOptions): Promise<any>;
+/**
+ * @description 连接当前项目已打开的开发者工具自动化会话，不触发新的 IDE 拉起。
+ */
+declare function connectOpenedAutomator(options: AutomatorOptions): Promise<_$_weapp_vite_miniprogram_automator0.MiniProgram>;
 //#endregion
 //#region src/cli/automator-argv.d.ts
 interface ParsedAutomatorArgs {
@@ -47,10 +74,6 @@ declare function readOptionValue(argv: readonly string[], optionName: string): s
 declare function removeOption(argv: readonly string[], optionName: string): string[];
 //#endregion
 //#region src/cli/automator-session.d.ts
-interface AutomatorSessionOptions {
-  projectPath: string;
-  timeout?: number;
-}
 interface MiniProgramEventMap {
   console: (payload: unknown) => void;
   exception: (payload: unknown) => void;
@@ -60,10 +83,33 @@ type MiniProgramPage = InstanceType<typeof Page>;
 type MiniProgramElement = InstanceType<typeof Element> & {
   input?: (value: string) => Promise<void>;
 };
+interface AutomatorSessionOptions {
+  miniProgram?: MiniProgramLike;
+  preferOpenedSession?: boolean;
+  projectPath: string;
+  sharedSession?: boolean;
+  timeout?: number;
+}
 /**
  * @description 建立 automator 会话，并统一处理常见连接错误提示。
  */
 declare function connectMiniProgram(options: AutomatorSessionOptions): Promise<MiniProgramLike>;
+/**
+ * @description 获取指定项目的共享 automator 会话；若不存在则自动创建。
+ */
+declare function acquireSharedMiniProgram(options: AutomatorSessionOptions): Promise<MiniProgramLike>;
+/**
+ * @description 释放指定项目的共享会话引用；会话对象会继续缓存，直到显式关闭或重置。
+ */
+declare function releaseSharedMiniProgram(projectPath: string): void;
+/**
+ * @description 关闭并移除指定项目的共享 automator 会话。
+ */
+declare function closeSharedMiniProgram(projectPath: string): Promise<void>;
+/**
+ * @description 获取当前共享会话数量，供测试断言使用。
+ */
+declare function getSharedMiniProgramSessionCount(): number;
 /**
  * @description 统一管理 automator 会话生命周期。
  */
@@ -106,6 +152,7 @@ interface AuditOptions extends AutomatorCommandOptions {
 interface ScreenshotOptions extends AutomatorCommandOptions {
   outputPath?: string;
   page?: string;
+  fullPage?: boolean;
 }
 interface ScreenshotResult {
   base64?: string;
@@ -286,7 +333,7 @@ declare function formatRetryHotkeyPrompt(timeoutMs?: number): string;
 /**
  * @description 基于 cac 注册顶层命令，用于统一识别入口。
  */
-declare function createCli(): cac$1.CAC;
+declare function createCli(): _$cac.CAC;
 /**
  * @description CLI 入口解析与分发。
  */
@@ -452,7 +499,7 @@ interface ExecuteOptions {
 /**
  * @description 执行 CLI 命令并透传输出
  */
-declare function execute(cliPath: string, argv: string[], options?: ExecuteOptions): Promise<execa.Result<{}>>;
+declare function execute(cliPath: string, argv: string[], options?: ExecuteOptions): Promise<_$execa.Result<{}>>;
 //#endregion
 //#region src/utils/path.d.ts
 /**
@@ -460,4 +507,4 @@ declare function execute(cliPath: string, argv: string[], options?: ExecuteOptio
  */
 declare function resolvePath(filePath: string): string;
 //#endregion
-export { AUTOMATOR_COMMAND_NAMES, ArgvTransform, AuditOptions, AutomatorCommandOptions, AutomatorOptions, AutomatorSessionOptions, type BaseConfig, CONFIG_COMMAND_NAME, type ConfigSource, ForwardConsoleEvent, ForwardConsoleLogLevel, ForwardConsoleOptions, ForwardConsoleSession, InputOptions, LoginRetryMode, MINIDEV_NAMESPACE_COMMAND_NAMES, MiniProgramElement, MiniProgramEventMap, MiniProgramLike, MiniProgramPage, NavigateOptions, PageDataOptions, PageInfoOptions, ParsedAutomatorArgs, RemoteOptions, type ResolvedConfig, RetryKeypressOptions, RetryPromptResult, type ScreenshotOptions, type ScreenshotResult, ScrollOptions, SelectorOptions, SupportedPlatform, SupportedPlatformsMap, TapOptions, WEAPP_IDE_TOP_LEVEL_COMMAND_NAMES, WECHAT_CLI_COMMAND_NAMES, audit, captureScreenshotBuffer, connectMiniProgram, createAlias, createCli, createCustomConfig, createLocaleConfig, createPathCompat, createWechatIdeLoginRequiredExitError, currentPage, defaultCustomConfigDirPath, defaultCustomConfigFilePath, execute, extractExecutionErrorText, formatAutomatorLoginError, formatRetryHotkeyPrompt, formatWechatIdeLoginRequiredError, getAutomatorCommandHelp, getConfig, getConfiguredLocale, getDefaultCliPath, handleConfigCommand, input, isAutomatorCommand, isAutomatorLoginError, isDevtoolsHttpPortError, isOperatingSystemSupported, isWeappIdeTopLevelCommand, isWechatIdeLoginRequiredError, launchAutomator, navigateBack, navigateTo, operatingSystemName, overwriteCustomConfig, pageData, pageStack, parse, parseAutomatorArgs, parseCompareArgs, parseScreenshotArgs, printCompareHelp, printScreenshotHelp, promptForCliPath, reLaunch, readCustomConfig, readOptionValue, redirectTo, remote, removeCustomConfigKey, removeOption, resolveCliPath, resolvePath, runAutomatorCommand, runMinidev, runWechatCliWithRetry, scrollTo, startForwardConsole, switchTab, systemInfo, takeScreenshot, tap, transformArgv, validateWechatCliCommandArgs, waitForRetryKeypress, withMiniProgram };
+export { AUTOMATOR_COMMAND_NAMES, ArgvTransform, AuditOptions, AutomatorCommandOptions, AutomatorOptions, AutomatorSessionOptions, type BaseConfig, CONFIG_COMMAND_NAME, type ConfigSource, ForwardConsoleEvent, ForwardConsoleLogLevel, ForwardConsoleOptions, ForwardConsoleSession, InputOptions, LoginRetryMode, MINIDEV_NAMESPACE_COMMAND_NAMES, MiniProgramElement, MiniProgramEventMap, MiniProgramLike, MiniProgramPage, NavigateOptions, PageDataOptions, PageInfoOptions, ParsedAutomatorArgs, RemoteOptions, type ResolvedConfig, RetryKeypressOptions, RetryPromptResult, type ScreenshotOptions, type ScreenshotResult, ScrollOptions, SelectorOptions, SupportedPlatform, SupportedPlatformsMap, TapOptions, WEAPP_IDE_TOP_LEVEL_COMMAND_NAMES, WECHAT_CLI_COMMAND_NAMES, acquireSharedMiniProgram, audit, captureScreenshotBuffer, closeSharedMiniProgram, connectMiniProgram, connectOpenedAutomator, createAlias, createCli, createCustomConfig, createLocaleConfig, createPathCompat, createWechatIdeLoginRequiredExitError, currentPage, defaultCustomConfigDirPath, defaultCustomConfigFilePath, execute, extractExecutionErrorText, formatAutomatorLoginError, formatRetryHotkeyPrompt, formatWechatIdeLoginRequiredError, getAutomatorCommandHelp, getAutomatorProtocolTimeoutMethod, getConfig, getConfiguredLocale, getDefaultCliPath, getSharedMiniProgramSessionCount, handleConfigCommand, input, isAutomatorCommand, isAutomatorLoginError, isAutomatorProtocolTimeoutError, isAutomatorWsConnectError, isDevtoolsExtensionContextInvalidatedError, isDevtoolsHttpPortError, isOperatingSystemSupported, isRetryableAutomatorLaunchError, isWeappIdeTopLevelCommand, isWechatIdeLoginRequiredError, launchAutomator, navigateBack, navigateTo, operatingSystemName, overwriteCustomConfig, pageData, pageStack, parse, parseAutomatorArgs, parseCompareArgs, parseScreenshotArgs, printCompareHelp, printScreenshotHelp, promptForCliPath, reLaunch, readCustomConfig, readOptionValue, redirectTo, releaseSharedMiniProgram, remote, removeCustomConfigKey, removeOption, resolveCliPath, resolvePath, runAutomatorCommand, runMinidev, runWechatCliWithRetry, scrollTo, startForwardConsole, switchTab, systemInfo, takeScreenshot, tap, transformArgv, validateWechatCliCommandArgs, waitForRetryKeypress, withMiniProgram };

package/dist/index.js

@@ -1,3 +1,3 @@
-import { A as createCustomConfig, B as isOperatingSystemSupported, C as formatAutomatorLoginError, D as resolveCliPath, E as launchAutomator, F as defaultCustomConfigDirPath, I as defaultCustomConfigFilePath, L as resolvePath, M as overwriteCustomConfig, N as readCustomConfig, O as getConfig, P as removeCustomConfigKey, R as SupportedPlatformsMap, T as isDevtoolsHttpPortError, V as operatingSystemName, _ as tap, a as input, c as pageData, d as redirectTo, f as remote, g as takeScreenshot, h as systemInfo, i as currentPage, j as createLocaleConfig, k as getConfiguredLocale, l as pageStack, m as switchTab, n as captureScreenshotBuffer, o as navigateBack, p as scrollTo, s as navigateTo, t as audit, u as reLaunch, v as connectMiniProgram, w as isAutomatorLoginError, y as withMiniProgram, z as getDefaultCliPath } from "./commands-BfdE1eYN.js";
-import { A as parseCompareArgs, C as isWeappIdeTopLevelCommand, D as runAutomatorCommand, E as isAutomatorCommand, M as parseAutomatorArgs, N as readOptionValue, O as parseScreenshotArgs, P as removeOption, S as WECHAT_CLI_COMMAND_NAMES, T as getAutomatorCommandHelp, _ as handleConfigCommand, a as createWechatIdeLoginRequiredExitError, b as MINIDEV_NAMESPACE_COMMAND_NAMES, c as formatWechatIdeLoginRequiredError, d as runMinidev, f as execute, g as startForwardConsole, h as transformArgv, i as runWechatCliWithRetry, j as printCompareHelp, k as printScreenshotHelp, l as isWechatIdeLoginRequiredError, m as createPathCompat, n as parse, o as extractExecutionErrorText, p as createAlias, r as validateWechatCliCommandArgs, s as formatRetryHotkeyPrompt, t as createCli, u as waitForRetryKeypress, v as promptForCliPath, w as AUTOMATOR_COMMAND_NAMES, x as WEAPP_IDE_TOP_LEVEL_COMMAND_NAMES, y as CONFIG_COMMAND_NAME } from "./cli-DXJCUYYI.js";
-export { AUTOMATOR_COMMAND_NAMES, CONFIG_COMMAND_NAME, MINIDEV_NAMESPACE_COMMAND_NAMES, SupportedPlatformsMap, WEAPP_IDE_TOP_LEVEL_COMMAND_NAMES, WECHAT_CLI_COMMAND_NAMES, audit, captureScreenshotBuffer, connectMiniProgram, createAlias, createCli, createCustomConfig, createLocaleConfig, createPathCompat, createWechatIdeLoginRequiredExitError, currentPage, defaultCustomConfigDirPath, defaultCustomConfigFilePath, execute, extractExecutionErrorText, formatAutomatorLoginError, formatRetryHotkeyPrompt, formatWechatIdeLoginRequiredError, getAutomatorCommandHelp, getConfig, getConfiguredLocale, getDefaultCliPath, handleConfigCommand, input, isAutomatorCommand, isAutomatorLoginError, isDevtoolsHttpPortError, isOperatingSystemSupported, isWeappIdeTopLevelCommand, isWechatIdeLoginRequiredError, launchAutomator, navigateBack, navigateTo, operatingSystemName, overwriteCustomConfig, pageData, pageStack, parse, parseAutomatorArgs, parseCompareArgs, parseScreenshotArgs, printCompareHelp, printScreenshotHelp, promptForCliPath, reLaunch, readCustomConfig, readOptionValue, redirectTo, remote, removeCustomConfigKey, removeOption, resolveCliPath, resolvePath, runAutomatorCommand, runMinidev, runWechatCliWithRetry, scrollTo, startForwardConsole, switchTab, systemInfo, takeScreenshot, tap, transformArgv, validateWechatCliCommandArgs, waitForRetryKeypress, withMiniProgram };
+import { A as isAutomatorProtocolTimeoutError, B as createLocaleConfig, D as formatAutomatorLoginError, E as connectOpenedAutomator, F as launchAutomator, G as defaultCustomConfigFilePath, H as readCustomConfig, I as resolveCliPath, J as getDefaultCliPath, K as resolvePath, L as getConfig, M as isDevtoolsExtensionContextInvalidatedError, N as isDevtoolsHttpPortError, O as getAutomatorProtocolTimeoutMethod, P as isRetryableAutomatorLaunchError, R as getConfiguredLocale, S as withMiniProgram, U as removeCustomConfigKey, V as overwriteCustomConfig, W as defaultCustomConfigDirPath, X as operatingSystemName, Y as isOperatingSystemSupported, _ as acquireSharedMiniProgram, a as navigateBack, b as getSharedMiniProgramSessionCount, c as pageStack, d as remote, f as scrollTo, g as tap, h as takeScreenshot, i as input, j as isAutomatorWsConnectError, k as isAutomatorLoginError, l as reLaunch, m as systemInfo, n as captureScreenshotBuffer, o as navigateTo, p as switchTab, q as SupportedPlatformsMap, r as currentPage, s as pageData, t as audit, u as redirectTo, v as closeSharedMiniProgram, x as releaseSharedMiniProgram, y as connectMiniProgram, z as createCustomConfig } from "./commands-38LzU5ML.js";
+import { A as parseCompareArgs, C as isWeappIdeTopLevelCommand, D as runAutomatorCommand, E as isAutomatorCommand, M as parseAutomatorArgs, N as readOptionValue, O as parseScreenshotArgs, P as removeOption, S as WECHAT_CLI_COMMAND_NAMES, T as getAutomatorCommandHelp, _ as handleConfigCommand, a as createWechatIdeLoginRequiredExitError, b as MINIDEV_NAMESPACE_COMMAND_NAMES, c as formatWechatIdeLoginRequiredError, d as runMinidev, f as execute, g as startForwardConsole, h as transformArgv, i as runWechatCliWithRetry, j as printCompareHelp, k as printScreenshotHelp, l as isWechatIdeLoginRequiredError, m as createPathCompat, n as parse, o as extractExecutionErrorText, p as createAlias, r as validateWechatCliCommandArgs, s as formatRetryHotkeyPrompt, t as createCli, u as waitForRetryKeypress, v as promptForCliPath, w as AUTOMATOR_COMMAND_NAMES, x as WEAPP_IDE_TOP_LEVEL_COMMAND_NAMES, y as CONFIG_COMMAND_NAME } from "./cli-1zieDX-6.js";
+export { AUTOMATOR_COMMAND_NAMES, CONFIG_COMMAND_NAME, MINIDEV_NAMESPACE_COMMAND_NAMES, SupportedPlatformsMap, WEAPP_IDE_TOP_LEVEL_COMMAND_NAMES, WECHAT_CLI_COMMAND_NAMES, acquireSharedMiniProgram, audit, captureScreenshotBuffer, closeSharedMiniProgram, connectMiniProgram, connectOpenedAutomator, createAlias, createCli, createCustomConfig, createLocaleConfig, createPathCompat, createWechatIdeLoginRequiredExitError, currentPage, defaultCustomConfigDirPath, defaultCustomConfigFilePath, execute, extractExecutionErrorText, formatAutomatorLoginError, formatRetryHotkeyPrompt, formatWechatIdeLoginRequiredError, getAutomatorCommandHelp, getAutomatorProtocolTimeoutMethod, getConfig, getConfiguredLocale, getDefaultCliPath, getSharedMiniProgramSessionCount, handleConfigCommand, input, isAutomatorCommand, isAutomatorLoginError, isAutomatorProtocolTimeoutError, isAutomatorWsConnectError, isDevtoolsExtensionContextInvalidatedError, isDevtoolsHttpPortError, isOperatingSystemSupported, isRetryableAutomatorLaunchError, isWeappIdeTopLevelCommand, isWechatIdeLoginRequiredError, launchAutomator, navigateBack, navigateTo, operatingSystemName, overwriteCustomConfig, pageData, pageStack, parse, parseAutomatorArgs, parseCompareArgs, parseScreenshotArgs, printCompareHelp, printScreenshotHelp, promptForCliPath, reLaunch, readCustomConfig, readOptionValue, redirectTo, releaseSharedMiniProgram, remote, removeCustomConfigKey, removeOption, resolveCliPath, resolvePath, runAutomatorCommand, runMinidev, runWechatCliWithRetry, scrollTo, startForwardConsole, switchTab, systemInfo, takeScreenshot, tap, transformArgv, validateWechatCliCommandArgs, waitForRetryKeypress, withMiniProgram };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "weapp-ide-cli",
   "type": "module",
-  "version": "5.2.0",
+  "version": "5.2.2",
   "description": "让微信开发者工具，用起来更加方便！",
   "author": "ice breaker <1324318532@qq.com>",
   "license": "MIT",
@@ -69,7 +69,7 @@
     "pngjs": "^7.0.0",
     "@weapp-core/logger": "^3.1.1",
     "@weapp-core/shared": "^3.0.3",
-    "@weapp-vite/miniprogram-automator": "1.0.1"
+    "@weapp-vite/miniprogram-automator": "1.0.2"
   },
   "scripts": {
     "dev": "tsdown -w --sourcemap",