@weapp-vite/miniprogram-automator 1.2.14 → 1.2.16

package/dist/index.d.mts

@@ -269,7 +269,7 @@ declare class Page {
   $(selector: string, options?: PageQueryOptions): Promise<Element | null>;
   $$(selector: string, options?: PageQueryOptions): Promise<any>;
   getElementByXpath(selector: string, options?: PageQueryOptions): Promise<Element | null>;
-  getElementsByXpath(selector: string, options?: PageQueryOptions): Promise<any>;
+  getElementsByXpath(selector: string, options?: PageQueryOptions): Promise<Element[]>;
   xpath(selector: string): Promise<Element | null>;
   wxml(): Promise<any>;
   renderedNodes(selector: string, options?: PageQueryOptions): Promise<RenderedNodeSnapshot[]>;
@@ -351,10 +351,10 @@ declare class MiniProgram extends EventEmitter {
   close(): Promise<void>;
   remote(auto?: boolean): Promise<void>;
   disconnect(): void;
-  enableLog(): Promise<void>;
+  enableLog(timeout?: number): Promise<void>;
   on(event: string | symbol, listener: (...args: any[]) => void): this;
   exposeFunction(name: string, bindingFunction: AutomatorCallable): Promise<void>;
-  checkVersion(): Promise<void>;
+  checkVersion(timeout?: number): Promise<void>;
   /**
    * @description 等待小程序 App 域协议可用，避免返回半就绪自动化会话。
    */

package/dist/index.mjs

@@ -217,10 +217,6 @@ function cmpVersion(versionA, versionB) {
 	}
 	return 0;
 }
-/** toStr 的方法封装。 */
-function toStr(value) {
-	return value == null ? "" : String(value);
-}
 //#endregion
 //#region src/pageRouteSnapshot.ts
 const ROUTE_ELEMENT_SNAPSHOT_TIMEOUT = 5e3;
@@ -946,7 +942,7 @@ var Connection = class Connection extends EventEmitter {
 //#endregion
 //#region src/headless.ts
 async function launchHeadlessAutomator(options) {
-	return await (await import("./launch-DKcPk1N2.mjs")).launch({ projectPath: options.projectPath });
+	return await (await import("./launch-Dqnd-Lqe.mjs")).launch({ projectPath: options.projectPath });
 }
 //#endregion
 //#region src/launcher/portLease.ts
@@ -1044,8 +1040,64 @@ async function acquireAutomatorPortLease(preferredPort) {
 	return createLease(await getPort(0, "127.0.0.1"));
 }
 //#endregion
+//#region src/launcher/wechatCliFallback.ts
+const WECHAT_DEVTOOLS_SERVICE_PORT_RE = /listening\s+on\s+http:\/\/127\.0\.0\.1:(\d{2,5})/i;
+function extractWechatDevtoolsServicePort(output) {
+	const port = Number(output.match(WECHAT_DEVTOOLS_SERVICE_PORT_RE)?.[1]);
+	return Number.isInteger(port) && port > 0 && port <= 65535 ? port : void 0;
+}
+async function enableAutomatorViaHttp(options) {
+	const endpoint = new URL("/auto", `http://127.0.0.1:${options.servicePort}`);
+	endpoint.searchParams.set("project", options.projectPath);
+	endpoint.searchParams.set("port", String(options.autoPort));
+	endpoint.searchParams.set("autoPort", String(options.autoPort));
+	if (options.account) endpoint.searchParams.set("account", options.account);
+	if (options.ticket) endpoint.searchParams.set("ticket", options.ticket);
+	if (options.trustProject) endpoint.searchParams.set("trustProject", "true");
+	const response = await fetch(endpoint, { redirect: "follow" });
+	const body = await response.text();
+	if (!response.ok) throw new Error(`WeChat DevTools HTTP automator fallback failed with status ${response.status}${body.trim() ? `: ${body.trim().slice(0, 400)}` : ""}`);
+	let result;
+	try {
+		result = JSON.parse(body);
+	} catch (error) {
+		throw new Error("WeChat DevTools HTTP automator fallback returned invalid JSON", { cause: error });
+	}
+	if (result && typeof result === "object" && "autoPort" in result) {
+		const autoPort = Number(result.autoPort);
+		if (!Number.isInteger(autoPort) || autoPort <= 0 || autoPort > 65535) throw new Error(`WeChat DevTools HTTP automator fallback returned invalid autoPort: ${String(result.autoPort)}`);
+		return autoPort;
+	}
+	if (typeof result === "string" && /^s\d+$/.test(result)) return options.autoPort;
+	throw new Error(`WeChat DevTools HTTP automator fallback returned unsupported response: ${body.trim().slice(0, 400)}`);
+}
+const AUTOMATOR_VALUE_OPTIONS = /* @__PURE__ */ new Set([
+	"--auto-account",
+	"--auto-port",
+	"--autoAccount",
+	"--autoPort",
+	"--project",
+	"--test-ticket",
+	"--ticket"
+]);
+const AUTOMATOR_FLAG_OPTIONS = /* @__PURE__ */ new Set(["--trust-project"]);
+function resolveWechatDevtoolsBootstrapArgs(args) {
+	const bootstrapArgs = [];
+	for (let index = 0; index < args.length; index += 1) {
+		const arg = args[index];
+		if (AUTOMATOR_VALUE_OPTIONS.has(arg)) {
+			index += 1;
+			continue;
+		}
+		if (AUTOMATOR_FLAG_OPTIONS.has(arg) || arg === "auto") continue;
+		bootstrapArgs.push(arg);
+	}
+	bootstrapArgs.push("islogin");
+	return bootstrapArgs;
+}
+//#endregion
 //#region package.json
-var version = "1.2.14";
+var version = "1.2.16";
 //#endregion
 //#region src/Native.ts
 /** Native 的实现。 */
@@ -1400,7 +1452,8 @@ var Page = class Page {
 		}
 	}
 	async getElementsByXpath(selector, options = {}) {
-		const { elements } = await this.send("Page.getElementsByXpath", { selector }, { timeout: options.timeout ?? PAGE_QUERY_TIMEOUT });
+		const elements = (await this.send("Page.getElementsByXpath", { selector }, { timeout: options.timeout ?? PAGE_QUERY_TIMEOUT }))?.elements;
+		if (!Array.isArray(elements)) throw new TypeError("DevTools Page.getElementsByXpath 返回了无效响应：缺少 elements 数组。");
 		return elements.map((element) => {
 			return Element.create(this.connection, {
 				...element,
@@ -2447,8 +2500,9 @@ var MiniProgram = class extends EventEmitter {
 	disconnect() {
 		this.connection.dispose();
 	}
-	async enableLog() {
-		await this.send("App.enableLog");
+	async enableLog(timeout) {
+		if (timeout === void 0) await this.send("App.enableLog");
+		else await this.send("App.enableLog", {}, { timeout });
 		this.logEnabled = true;
 	}
 	on(event, listener) {
@@ -2461,8 +2515,8 @@ var MiniProgram = class extends EventEmitter {
 		this.appBindings.set(name, bindingFunction);
 		await this.send("App.addBinding", { name });
 	}
-	async checkVersion() {
-		const toolInfo = await this.send("Tool.getInfo");
+	async checkVersion(timeout) {
+		const toolInfo = timeout === void 0 ? await this.send("Tool.getInfo") : await this.send("Tool.getInfo", {}, { timeout });
 		this.connection.configureToolInfo(toolInfo);
 		const sdkVersion = toolInfo.SDKVersion;
 		if (typeof sdkVersion !== "string" || !sdkVersion.trim()) return;
@@ -2474,12 +2528,16 @@ var MiniProgram = class extends EventEmitter {
 	async waitForAppReady(timeout = APP_READY_TIMEOUT) {
 		const startedAt = Date.now();
 		let lastError;
-		while (Date.now() - startedAt <= timeout) try {
-			await this.send("App.captureScreenshot", {}, { timeout: APP_READY_PROBE_TIMEOUT });
-			return;
-		} catch (error) {
-			lastError = error;
-			await sleep(APP_READY_POLL_DELAY);
+		while (Date.now() - startedAt < timeout) {
+			const remainingTimeout = timeout - (Date.now() - startedAt);
+			try {
+				await this.send("App.captureScreenshot", {}, { timeout: Math.min(APP_READY_PROBE_TIMEOUT, remainingTimeout) });
+				return;
+			} catch (error) {
+				lastError = error;
+				const remainingAfterProbe = timeout - (Date.now() - startedAt);
+				if (remainingAfterProbe > 0) await sleep(Math.min(APP_READY_POLL_DELAY, remainingAfterProbe));
+			}
 		}
 		throw lastError instanceof Error ? lastError : /* @__PURE__ */ new Error(`Timed out waiting App domain readiness after ${timeout}ms`);
 	}
@@ -3128,6 +3186,7 @@ var SwanLauncher = class {
 * @file 开发者工具启动与连接流程。
 */
 const DEFAULT_TIMEOUT = 3e4;
+const VERSION_CHECK_TIMEOUT = 3e4;
 const AUTOMATOR_LAUNCH_RETRIES = 3;
 const DEFAULT_RUNTIME_PROVIDER_ENV = "WEAPP_VITE_AUTOMATOR_RUNTIME_PROVIDER";
 const LEGACY_RUNTIME_PROVIDER_ENV = "WEAPP_VITE_E2E_RUNTIME_PROVIDER";
@@ -3243,24 +3302,23 @@ var Launcher = class {
 			let processError = null;
 			let processExitCode = null;
 			let processSignal = null;
-			args = [
-				...args,
-				"auto",
-				"--project",
-				resolvedProjectPath,
-				"--auto-port",
-				toStr(port)
-			];
-			if (account) args.push("--auto-account", account);
-			else if (ticket) args.push("--ticket", ticket);
-			if (trustProject) args.push("--trust-project");
+			let successfulCliExitSettled = false;
+			let httpFallbackAttempted = false;
+			let httpFallbackError = null;
+			let targetPort = port;
+			const cliOutput = [];
+			args = resolveWechatDevtoolsBootstrapArgs(args);
 			try {
 				const spawnTarget = shouldUseWindowsCommandShell(cliPath) ? resolveWindowsBatchSpawn(cliPath, args) : {
 					file: cliPath,
 					args
 				};
 				const child = spawn(spawnTarget.file, spawnTarget.args, {
-					stdio: "ignore",
+					stdio: [
+						"ignore",
+						"pipe",
+						"pipe"
+					],
 					cwd: cwd || void 0,
 					...shouldUseWindowsCommandShell(cliPath) ? {
 						windowsHide: true,
@@ -3270,10 +3328,17 @@ var Launcher = class {
 				child.on("error", (error) => {
 					processError = error;
 				});
+				child.stdout?.on("data", (chunk) => {
+					cliOutput.push(String(chunk));
+				});
+				child.stderr?.on("data", (chunk) => {
+					cliOutput.push(String(chunk));
+				});
 				child.on("exit", (code, signal) => {
 					processExitCode = code;
 					processSignal = signal;
 					if (code !== 0 || signal) processError = /* @__PURE__ */ new Error(`DevTools cli exited unexpectedly with code ${code ?? "null"}${signal ? ` and signal ${signal}` : ""}`);
+					else successfulCliExitSettled = true;
 				});
 				child.unref();
 			} catch (error) {
@@ -3281,16 +3346,51 @@ var Launcher = class {
 			}
 			let miniProgram = null;
 			let lastConnectError = null;
+			const readinessStartedAt = Date.now();
+			const resolveRemainingTimeout = () => Math.max(0, timeout - (Date.now() - readinessStartedAt));
 			await waitUntil(async () => {
 				try {
 					if (processError) return true;
+					if (successfulCliExitSettled && !httpFallbackAttempted) {
+						const servicePort = extractWechatDevtoolsServicePort(cliOutput.join("\n"));
+						if (servicePort) {
+							httpFallbackAttempted = true;
+							try {
+								targetPort = await enableAutomatorViaHttp({
+									account,
+									autoPort: port,
+									projectPath: resolvedProjectPath,
+									servicePort,
+									ticket,
+									trustProject
+								});
+							} catch (error) {
+								httpFallbackError = error;
+								return true;
+							}
+						}
+					}
+					const connectTimeout = resolveRemainingTimeout();
+					if (connectTimeout <= 0) return false;
 					const candidate = await this.connectTool({
-						timeout: 3e3,
-						wsEndpoint: `ws://127.0.0.1:${port}`
+						timeout: Math.min(3e3, connectTimeout),
+						wsEndpoint: `ws://127.0.0.1:${targetPort}`
 					});
 					try {
-						await candidate.checkVersion();
-						if (typeof candidate.waitForAppReady === "function") await candidate.waitForAppReady(timeout);
+						const checkVersionTimeout = resolveRemainingTimeout();
+						if (checkVersionTimeout <= 0) {
+							candidate.disconnect();
+							return false;
+						}
+						await candidate.checkVersion(Math.min(VERSION_CHECK_TIMEOUT, checkVersionTimeout));
+						if (typeof candidate.waitForAppReady === "function") {
+							const appReadyTimeout = resolveRemainingTimeout();
+							if (appReadyTimeout <= 0) {
+								candidate.disconnect();
+								return false;
+							}
+							await candidate.waitForAppReady(appReadyTimeout);
+						}
 					} catch (error) {
 						candidate.disconnect();
 						lastConnectError = error;
@@ -3305,6 +3405,7 @@ var Launcher = class {
 				}
 			}, timeout, 1e3);
 			if (!miniProgram) {
+				if (httpFallbackError) throw httpFallbackError;
 				if (processError) throw new Error("Failed to launch wechat web devTools, please make sure cliPath is correctly specified");
 				if (lastConnectError) throw lastConnectError;
 				if (processExitCode !== null || processSignal) throw new Error("Failed to launch wechat web devTools, please make sure http port is open");
@@ -3312,9 +3413,9 @@ var Launcher = class {
 			}
 			const resolvedMiniProgram = miniProgram;
 			Reflect.set(resolvedMiniProgram, "__WEAPP_VITE_SESSION_METADATA", {
-				port,
+				port: targetPort,
 				projectPath: resolvedProjectPath,
-				wsEndpoint: `ws://127.0.0.1:${port}`
+				wsEndpoint: `ws://127.0.0.1:${targetPort}`
 			});
 			releasePortLeaseOnExit = !retainPortLeaseUntilSessionClose(resolvedMiniProgram, portLease);
 			await sleep$1(5e3);
@@ -3326,7 +3427,7 @@ var Launcher = class {
 	async connect(options) {
 		if (normalizePlatform(options.platform) === "swan") return await new SwanLauncher().connect(options);
 		const miniProgram = await this.connectTool(options);
-		await miniProgram.checkVersion();
+		await miniProgram.checkVersion(options.timeout);
 		return miniProgram;
 	}
 	async extendProjectConfig(projectConfig, projectPath) {

package/dist/{launch-DKcPk1N2.mjs → launch-Dqnd-Lqe.mjs}

@@ -12036,6 +12036,42 @@ function resolveTemplateData(node, source) {
 	return resolved && typeof resolved === "object" ? resolved : {};
 }
 //#endregion
+//#region ../../mpcore/packages/simulator/src/project/plugins.ts
+const HEADLESS_PLUGIN_VIRTUAL_ROOT = "__plugins__";
+const PLUGIN_URL_RE = /^plugin:\/\/([^/]+)\/(.+)$/;
+function createPluginVirtualRoot(alias) {
+	return `${HEADLESS_PLUGIN_VIRTUAL_ROOT}/${alias}`;
+}
+function resolvePluginRequest(plugins, request, kind) {
+	const match = PLUGIN_URL_RE.exec(request);
+	if (!match) return;
+	const [, alias, publicName] = match;
+	const plugin = plugins.find((item) => item.alias === alias);
+	const registry = kind === "page" ? plugin?.config.pages : plugin?.config.publicComponents;
+	const resourcePath = registry && typeof registry === "object" && !Array.isArray(registry) ? registry[publicName] : void 0;
+	if (!plugin || typeof resourcePath !== "string" || !resourcePath) return;
+	return {
+		plugin,
+		publicName,
+		resourcePath: `${plugin.virtualRoot}/${resourcePath}`
+	};
+}
+function createPluginArtifactSource(fallback, miniprogramRootPath, plugins) {
+	function resolvePhysicalPath(filePath) {
+		const normalizedPath = path.resolve(filePath);
+		for (const plugin of plugins) {
+			const virtualRootPath = path.resolve(miniprogramRootPath, plugin.virtualRoot);
+			const relativePath = path.relative(virtualRootPath, normalizedPath);
+			if (!relativePath.startsWith("..") && !path.isAbsolute(relativePath)) return path.resolve(plugin.rootPath, relativePath);
+		}
+		return normalizedPath;
+	}
+	return {
+		has: (filePath) => fallback.has(resolvePhysicalPath(filePath)),
+		readText: (filePath) => fallback.readText(resolvePhysicalPath(filePath))
+	};
+}
+//#endregion
 //#region ../../mpcore/packages/simulator/src/view/eventBinding.ts
 const LEGACY_EVENT_NAME_RE = /^\w+$/;
 const EVENT_BINDING_PREFIXES = [
@@ -14583,11 +14619,12 @@ function isMustacheOnly(value) {
 function toDatasetKey$3(attributeName) {
 	return attributeName.slice(5).replace(DATASET_NAME_RE$3, (_match, char) => char.toUpperCase());
 }
-function collectDataset$3(node) {
+function collectDataset$3(node, source) {
 	const dataset = {};
 	for (const [key, value] of Object.entries(node.attribs ?? {})) {
 		if (!key.startsWith("data-") || key === "data-sim-scope" || key === "data-sim-tap" || key === "data-sim-component") continue;
-		dataset[toDatasetKey$3(key)] = String(value);
+		const resolvedValue = source && isMustacheOnly(value) ? resolveTemplateExpression(source, value) : value;
+		dataset[toDatasetKey$3(key)] = String(resolvedValue ?? "");
 	}
 	return dataset;
 }
@@ -14698,7 +14735,7 @@ function createLoopScope(scope, itemName, indexName, item, index) {
 //#endregion
 //#region ../../mpcore/packages/simulator/src/runtime/render/component.ts
 function resolveComponentRegistryEntry(context, ownerJsonPath, ownerFilePath, alias, genericComponentBasePath) {
-	const usingComponents = resolveUsingComponents(context.artifactSource, ownerJsonPath, ownerFilePath);
+	const usingComponents = resolveUsingComponents(context, ownerJsonPath, ownerFilePath);
 	const componentBasePath = genericComponentBasePath ?? usingComponents.get(alias);
 	if (!componentBasePath) return null;
 	const filePath = `${componentBasePath}.js`;
@@ -14720,14 +14757,14 @@ function readComponentConfig(artifactSource, jsonPath) {
 		return {};
 	}
 }
-function resolveUsingComponents(artifactSource, ownerJsonPath, ownerFilePath) {
+function resolveUsingComponents(context, ownerJsonPath, ownerFilePath) {
 	try {
-		const usingComponents = readComponentConfig(artifactSource, ownerJsonPath).usingComponents;
+		const usingComponents = readComponentConfig(context.artifactSource, ownerJsonPath).usingComponents;
 		if (!usingComponents || typeof usingComponents !== "object" || Array.isArray(usingComponents)) return /* @__PURE__ */ new Map();
 		const resolved = /* @__PURE__ */ new Map();
 		for (const [alias, rawPath] of Object.entries(usingComponents)) {
 			if (typeof rawPath !== "string") continue;
-			const basePath = rawPath.startsWith("/") ? rawPath.replace(LEADING_SLASH_RE$4, "") : path.posix.normalize(path.posix.join(path.posix.dirname(ownerFilePath), rawPath));
+			const basePath = resolvePluginRequest(context.project.plugins, rawPath, "publicComponent")?.resourcePath ?? (rawPath.startsWith("/") ? rawPath.replace(LEADING_SLASH_RE$4, "") : path.posix.normalize(path.posix.join(path.posix.dirname(ownerFilePath), rawPath)));
 			resolved.set(alias, basePath.replace(LEADING_SLASH_RE$4, ""));
 		}
 		return resolved;
@@ -14739,7 +14776,7 @@ function resolveComponentGenerics(context, hostNode, ownerJsonPath, ownerFilePat
 	const componentJsonPath = path.resolve(context.project.miniprogramRootPath, `${componentFilePath.replace(JS_FILE_RE, "")}.json`);
 	const componentGenerics = readComponentConfig(context.artifactSource, componentJsonPath).componentGenerics;
 	if (!componentGenerics || typeof componentGenerics !== "object" || Array.isArray(componentGenerics)) return;
-	const ownerComponents = resolveUsingComponents(context.artifactSource, ownerJsonPath, ownerFilePath);
+	const ownerComponents = resolveUsingComponents(context, ownerJsonPath, ownerFilePath);
 	const resolved = /* @__PURE__ */ new Map();
 	for (const [genericName, definition] of Object.entries(componentGenerics)) {
 		const selectedAlias = hostNode.attribs?.[`generic:${genericName}`];
@@ -14764,9 +14801,10 @@ function buildComponentTrigger(componentScopeId, context, hostNode) {
 	return (instance, eventName, detail, triggerOptions) => {
 		const interactionTarget = instance.__lastInteractionEvent__?.target;
 		const interactionCurrentTarget = instance.__lastInteractionEvent__?.currentTarget;
+		const componentDataset = context.componentScopes.get(componentScopeId)?.dataset ?? hostDataset;
 		const interactionMark = instance.__lastInteractionEvent__?.mark;
 		const target = {
-			dataset: interactionTarget?.dataset ?? hostDataset,
+			dataset: interactionTarget?.dataset ?? componentDataset,
 			id: interactionTarget?.id ?? hostId
 		};
 		let currentScopeId = componentScopeId;
@@ -14822,7 +14860,7 @@ function createComponentScope(clonedNode, scope, componentScopeId, componentInst
 		alias: clonedNode.name,
 		classList: String(clonedNode.attribs?.class ?? "").split(CLASS_SPLIT_RE).map((item) => item.trim()).filter(Boolean),
 		data: createMergedScopeData(scope.data, componentInstance.properties, componentInstance.data),
-		dataset: collectDataset$3(clonedNode),
+		dataset: collectDataset$3(clonedNode, scope.data),
 		eventBindings: collectComponentEventBindings(clonedNode),
 		getMethod: (methodName) => {
 			const method = componentInstance?.[methodName];
@@ -15051,7 +15089,8 @@ function renderNodeTree(node, scope, context, ownerJsonPath, ownerFilePath, inst
 }
 function renderRuntimePageTree(context, page) {
 	const route = page.route.replace(LEADING_SLASH_RE$4, "");
-	const templatePath = path.resolve(context.project.miniprogramRootPath, `${route}.wxml`);
+	const resourcePath = context.project.routes.find((item) => item.route === route)?.resourcePath ?? route;
+	const templatePath = path.resolve(context.project.miniprogramRootPath, `${resourcePath}.wxml`);
 	const document = parseTemplateDocument(readTemplateSource(context.artifactSource, templatePath));
 	const pageScopeId = `page:${route}`;
 	const pageScope = {
@@ -15068,7 +15107,7 @@ function renderRuntimePageTree(context, page) {
 	const seenComponentScopes = /* @__PURE__ */ new Set();
 	const root = (document.children ?? [])[0] ?? document;
 	const templateRenderState = createTemplateRenderState(root);
-	const renderedRoot = renderNodeTree(root, pageScope, context, path.resolve(context.project.miniprogramRootPath, `${route}.json`), `${route}.js`, pageScopeId, seenComponentScopes, templateRenderState);
+	const renderedRoot = renderNodeTree(root, pageScope, context, path.resolve(context.project.miniprogramRootPath, `${resourcePath}.json`), `${resourcePath}.js`, pageScopeId, seenComponentScopes, templateRenderState);
 	for (const [scopeId, instance] of [...context.componentCache.entries()]) if (!seenComponentScopes.has(scopeId)) {
 		runComponentLifecycle(instance, "detached");
 		context.componentCache.delete(scopeId);
@@ -15819,7 +15858,7 @@ function pushRoute(records, seen, record) {
 	seen.add(record.route);
 	records.push(record);
 }
-function resolveRoutesFromAppConfig(config) {
+function resolveRoutesFromAppConfig(config, plugins = []) {
 	const records = [];
 	const seen = /* @__PURE__ */ new Set();
 	if (Array.isArray(config.pages)) for (const page of config.pages) {
@@ -15849,6 +15888,19 @@ function resolveRoutesFromAppConfig(config) {
 			});
 		}
 	}
+	for (const plugin of plugins) {
+		const pages = plugin.config.pages;
+		if (!pages || typeof pages !== "object" || Array.isArray(pages)) continue;
+		for (const resourcePath of Object.values(pages)) {
+			if (typeof resourcePath !== "string" || !resourcePath) continue;
+			pushRoute(records, seen, {
+				kind: "page",
+				resourcePath: `${plugin.virtualRoot}/${resourcePath}`,
+				route: `plugin-private://${plugin.provider}/${resourcePath}`,
+				source: "plugin"
+			});
+		}
+	}
 	return records;
 }
 //#endregion
@@ -15860,9 +15912,10 @@ function createProjectDescriptor(options) {
 		appConfigPath: options.appConfigPath,
 		miniprogramRoot: options.miniprogramRoot,
 		miniprogramRootPath: options.miniprogramRootPath,
+		plugins: options.plugins ?? [],
 		projectPath: options.projectPath,
 		projectConfigFiles: options.projectConfigFiles ?? [],
-		routes: resolveRoutesFromAppConfig(options.appConfig)
+		routes: resolveRoutesFromAppConfig(options.appConfig, options.plugins ?? [])
 	};
 }
 //#endregion
@@ -15979,6 +16032,36 @@ function resolveMiniprogramRoot(projectPath, configFiles) {
 	}
 	throw new Error(`Failed to resolve miniprogramRoot for headless runtime project: ${projectPath}. Expected project.config.json or project.private.config.json to define miniprogramRoot.`);
 }
+function resolveConfiguredRoot(configFiles, key) {
+	for (const configFile of [...configFiles].reverse()) {
+		const value = configFile.value[key];
+		if (typeof value === "string" && value.trim()) return value.trim();
+	}
+}
+function resolveLocalPlugins(projectPath, projectConfigFiles, appConfig) {
+	const pluginRoot = resolveConfiguredRoot(projectConfigFiles, "pluginRoot");
+	const configuredPlugins = appConfig.plugins;
+	if (!pluginRoot || !configuredPlugins || typeof configuredPlugins !== "object" || Array.isArray(configuredPlugins)) return [];
+	const rootPath = path.resolve(projectPath, pluginRoot);
+	const pluginConfig = readJsonObject$1(path.resolve(rootPath, "plugin.json"));
+	if (!pluginConfig) return [];
+	const plugins = [];
+	const projectAppId = resolveConfiguredRoot(projectConfigFiles, "appid");
+	for (const [alias, definition] of Object.entries(configuredPlugins)) {
+		if (!definition || typeof definition !== "object" || Array.isArray(definition)) continue;
+		const provider = definition.provider;
+		const isLocalPlugin = definition.version === "dev" || projectAppId && provider === projectAppId;
+		if (typeof provider !== "string" || !provider || !isLocalPlugin) continue;
+		plugins.push({
+			alias,
+			config: pluginConfig,
+			provider,
+			rootPath,
+			virtualRoot: createPluginVirtualRoot(alias)
+		});
+	}
+	return plugins;
+}
 function ensureFileExists(filePath, label) {
 	if (fs.existsSync(filePath)) return;
 	throw new Error(`Missing ${label} for headless runtime project: ${normalize(filePath)}`);
@@ -15997,11 +16080,15 @@ function loadProject(projectPath) {
 	ensureFileExists(miniprogramRootPath, "miniprogramRoot directory");
 	const appConfigPath = path.resolve(miniprogramRootPath, "app.json");
 	ensureFileExists(appConfigPath, "built app.json");
+	const appConfig = loadAppConfig(appConfigPath);
+	const plugins = resolveLocalPlugins(normalizedProjectPath, projectConfigFiles, appConfig);
 	return createProjectDescriptor({
-		appConfig: loadAppConfig(appConfigPath),
+		appConfig,
 		appConfigPath,
+		artifactSource: createPluginArtifactSource(createFileSystemArtifactSource(), miniprogramRootPath, plugins),
 		miniprogramRoot,
 		miniprogramRootPath,
+		plugins,
 		projectPath: normalizedProjectPath,
 		projectConfigFiles
 	});
@@ -17371,6 +17458,12 @@ function createModuleLoader(registries, getCurrentPages, getApp, wxDriver, optio
 			registries.currentLoadContext = previousLoadContext;
 		}
 	}
+	executionContext.requirePlugin = (alias) => {
+		const plugin = options.plugins.find((item) => item.alias === alias);
+		if (!plugin) throw new Error(`Unknown local plugin "${alias}" in headless runtime.`);
+		const main = typeof plugin.config.main === "string" && plugin.config.main ? plugin.config.main : "index.js";
+		return executeModule(path.resolve(options.miniprogramRootPath, plugin.virtualRoot, main), null).exports;
+	};
 	return {
 		close() {
 			moduleCache.clear();
@@ -19283,7 +19376,9 @@ var HeadlessSession = class {
 			artifactSource: this.project.artifactSource,
 			globals: options.globals,
 			kernel: this.kernel,
-			onConsole: (entry) => this.emit("console", entry)
+			miniprogramRootPath: this.project.miniprogramRootPath,
+			onConsole: (entry) => this.emit("console", entry),
+			plugins: this.project.plugins
 		});
 	}
 	assertActive() {
@@ -19902,8 +19997,9 @@ var HeadlessSession = class {
 		});
 	}
 	createFreshPage(target) {
-		const pageModulePath = path.resolve(this.project.miniprogramRootPath, `${target.routeRecord.route}.js`);
-		const pageConfigPath = path.resolve(this.project.miniprogramRootPath, `${target.routeRecord.route}.json`);
+		const resourcePath = target.routeRecord.resourcePath ?? target.routeRecord.route;
+		const pageModulePath = path.resolve(this.project.miniprogramRootPath, `${resourcePath}.js`);
+		const pageConfigPath = path.resolve(this.project.miniprogramRootPath, `${resourcePath}.json`);
 		const pageDefinition = this.moduleLoader.executePageModule(pageModulePath, target.routeRecord.route);
 		const pageConfig = readJsonObject(this.project, pageConfigPath);
 		const pageInstance = createPageInstance(`/${target.routeRecord.route}`, pageDefinition, target.query, {
@@ -19938,7 +20034,9 @@ var HeadlessSession = class {
 	}
 	resolveNavigationTarget(url) {
 		const { pathname, query } = parseNavigationUrl(url);
-		const normalizedRoute = resolveNavigationPath(pathname, this.currentPageInstance ? stripLeadingSlash(this.currentPageInstance.route) : void 0);
+		const baseRoute = this.currentPageInstance ? stripLeadingSlash(this.currentPageInstance.route) : void 0;
+		const pluginRequest = resolvePluginRequest(this.project.plugins, pathname, "page");
+		const normalizedRoute = pluginRequest ? `plugin-private://${pluginRequest.plugin.provider}/${pluginRequest.resourcePath.slice(pluginRequest.plugin.virtualRoot.length + 1)}` : resolveNavigationPath(pathname, baseRoute);
 		const routeRecord = this.project.routes.find((item) => item.route === normalizedRoute);
 		if (!routeRecord) {
 			this.bootstrap(createAppLaunchOptions(normalizedRoute, query));

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@weapp-vite/miniprogram-automator",
   "type": "module",
-  "version": "1.2.14",
+  "version": "1.2.16",
   "description": "完全兼容微信 miniprogram-automator 的现代化替代实现",
   "author": "ice breaker <1324318532@qq.com>",
   "license": "MIT",
@@ -43,7 +43,7 @@
   "dependencies": {
     "obug": "^2.1.4",
     "ws": "^8.21.3",
-    "@weapp-vite/qr": "1.1.1"
+    "@weapp-vite/qr": "1.1.2"
   },
   "publishConfig": {
     "access": "public",
@@ -51,7 +51,7 @@
   },
   "devDependencies": {
     "@types/ws": "^8.18.1",
-    "sharp": "^0.35.3"
+    "sharp": "^0.35.4"
   },
   "scripts": {
     "dev": "tsdown -w --sourcemap",