@uni_toolkit/uniapp-miniprogram-devtool 0.1.1-alpha.1778855349600

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 chouchouji
+
+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/README.md

@@ -0,0 +1,176 @@
+# @uni_toolkit/uniapp-miniprogram-devtool
+
+一个用于调试 `uni-app` / `uni-app x` 编译到微信小程序产物的运行时变量观察工具。
+
+`uni-app` / `uni-app x` 在编译微信小程序时，会把模板返回值里的 key 压缩成 `a`、`b`、`c` 这类短字段。例如源码里写的是：
+
+```ts
+const message = ref('测试')
+const count = ref(1)
+```
+
+编译产物里可能变成：
+
+```js
+const __returned__ = {
+  a: common_vendor.t(common_vendor.unref(message)),
+  b: common_vendor.t(common_vendor.unref(count))
+}
+```
+
+这个工具会读取编译产物和 sourcemap，推断出：
+
+```txt
+a -> message
+b -> count
+```
+
+然后通过微信开发者工具 automator 读取当前页面运行时 `page.data`，在 Web Panel 中展示最新值。
+
+## 特性
+
+- 不修改 `app.js`、页面 JS、WXML 等编译产物。
+- 读取页面 JS、WXML、sourcemap，分析 `a/b/c` 到源码变量的映射关系。
+- 通过微信开发者工具 automator 读取运行时 `page.data`。
+- 默认启动 Web Panel，展示当前页面变量值。
+- 支持过滤、手动刷新、值变化高亮、Debug 面板。
+
+## 注意事项
+
+- `manifest.json` 里需要配置合适的 `appid`，以避免微信开发者工具连接失败
+- 使用此工具前，请先推出微信开发者工具，确保它没有在后台运行
+- 需要开启微信开发者工具的服务端口，以便 `automator` 能够连接
+
+## 安装
+
+建议全局安装，安装后会得到命令行工具 `umpd`：
+
+```bash
+npm install -g @uni_toolkit/uniapp-miniprogram-devtool
+```
+
+也可以使用其他包管理器全局安装：
+
+```bash
+pnpm add -g @uni_toolkit/uniapp-miniprogram-devtool
+yarn global add @uni_toolkit/uniapp-miniprogram-devtool
+```
+
+## 快速开始
+
+`mp-weixin` 产物目录和微信开发者工具路径都是必填参数。产物目录可以直接作为第一个参数传入，也可以用 `-p`；微信开发者工具路径推荐用 `-w`。
+
+### 配置项
+
+| 配置 | 缩写 / 别名 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| `mp-weixin` 产物目录 | 位置参数、`-p`、`--proj`、`--project` | 是 | - | `uni-app` / `uni-app x` 的微信小程序编译产物目录，一般是 `unpackage/dist/dev/mp-weixin` |
+| 微信开发者工具路径 | `-w`、`--wd`、`--wechat-devtools` | 是 | - | 微信开发者工具 `.app` 路径；工具会自动解析到 `Contents/MacOS/cli` |
+| 微信开发者工具 CLI 路径 | `--cli-path` | 否 | - | 如果已经拿到 `cli` 二进制路径，可以用它替代 `-w` |
+| Web Panel 端口 | `--port` | 否 | `17890` | 本地 Web Panel 端口；如果被占用会自动尝试后续端口 |
+| 查看帮助 | `-h`、`--help` | 否 | - | 打印命令行帮助 |
+
+### 环境变量
+
+| 环境变量 | 默认值 | 说明 |
+| --- | --- | --- |
+| `UNIAPP_MINIPROGRAM_DEVTOOL_PORT` | `17890` | 未传 `--port` 时使用的 Web Panel 端口 |
+| `UNIAPP_MINIPROGRAM_DEVTOOL_NO_OPEN` | - | 设为 `1` 时不自动打开浏览器 |
+
+启动示例：
+
+```bash
+umpd unpackage/dist/dev/mp-weixin -w /Volumes/Elements/Applications/wechatwebdevtools.app
+```
+
+这里不需要你手动去找 `cli` 文件。直接传 `.app` 路径即可，工具内部会自动解析到：
+
+```txt
+/Volumes/Elements/Applications/wechatwebdevtools.app/Contents/MacOS/cli
+```
+
+如果你确实已经拿到了微信开发者工具的 `cli` 二进制路径，也可以显式传：
+
+```bash
+umpd -p ./unpackage/dist/dev/mp-weixin --cli-path /Applications/wechatwebdevtools.app/Contents/MacOS/cli
+```
+
+## 微信开发者工具要求
+
+需要开启微信开发者工具的服务端口：
+
+```txt
+微信开发者工具 -> 设置 -> 安全设置 -> 服务端口
+```
+
+如果没有开启，automator 无法连接微信开发者工具。
+
+## Web Panel
+
+启动后会自动打开本地页面，默认地址：
+
+```txt
+http://127.0.0.1:17890
+```
+
+如果端口被占用，会自动尝试后续端口。
+
+Web Panel 当前包含：
+
+- 当前页面 route
+- 变量映射和运行时值
+- 300ms 自动刷新
+- `Refresh now` 手动刷新
+- 过滤框
+- 值变化高亮
+- Debug 面板：显示 `pageId`、`rawRoute`、`keymapPages`、原始 `page.data`
+
+## 常用参数
+
+```bash
+umpd <mp-weixin 产物目录> -w <wechatwebdevtools.app 路径>
+umpd <mp-weixin 产物目录> -w <wechatwebdevtools.app 路径> --port 17890
+umpd -p <mp-weixin 产物目录> -w <wechatwebdevtools.app 路径>
+umpd --project <mp-weixin 产物目录> --wechat-devtools <wechatwebdevtools.app 路径>
+umpd -p <mp-weixin 产物目录> --cli-path <微信开发者工具 cli 路径>
+```
+
+## 工作原理
+
+1. 读取你显式传入的 `mp-weixin` 编译产物目录。
+2. 解析页面 JS 中的 `const __returned__ = { ... }`。
+3. 从表达式中推断 `a -> message`、`b -> count` 这类映射。
+4. 读取 WXML 和 sourcemap 辅助展示。
+5. 通过 `miniprogram-automator` 连接微信开发者工具。
+6. 读取当前页面的 `page.data`。
+7. 将映射后的变量和值展示到 Web Panel。
+
+## 限制
+
+- 当前主要针对 `uni-app` / `uni-app x` 开发模式下的微信小程序产物。
+- 运行时值依赖微信开发者工具 automator 能力。
+- 工具不会修改编译产物，因此无法像注入脚本那样直接进入小程序运行时，只能通过 automator 读取数据。
+
+## 开发
+
+```bash
+pnpm install
+pnpm run build
+pnpm test
+```
+
+本地启动：
+
+```bash
+pnpm dev -- unpackage/dist/dev/mp-weixin -w /Volumes/Elements/Applications/wechatwebdevtools.app
+```
+
+本仓库里的可执行入口文件是：
+
+```txt
+bin/umpd.js
+```
+
+## License
+
+[MIT](/LICENSE)

package/bin/umpd.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+'use strict';
+try {
+  const { main } = require('../dist/cli.cjs');
+  main(process.argv.slice(2)).catch((error) => {
+    console.error(error && error.stack ? error.stack : String(error));
+    process.exitCode = 1;
+  });
+} catch (error) {
+  if (error && error.code === 'MODULE_NOT_FOUND') {
+    console.error('umpd 尚未构建，请先在项目内执行 `pnpm run build`。');
+    process.exitCode = 1;
+  } else {
+    throw error;
+  }
+}

package/dist/automator-inspector.cjs

@@ -0,0 +1,172 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/automator-inspector.ts
+const automator = require("miniprogram-automator");
+function normalizeRoute(route) {
+	const withoutQuery = route.split("?")[0] || route;
+	return withoutQuery.startsWith("/") ? withoutQuery.slice(1) : withoutQuery;
+}
+function withTimeout(promise, timeoutMs, label) {
+	return new Promise((resolve, reject) => {
+		const timer = setTimeout(() => reject(/* @__PURE__ */ new Error(`${label} timed out after ${timeoutMs}ms`)), timeoutMs);
+		promise.then((value) => {
+			clearTimeout(timer);
+			resolve(value);
+		}, (error) => {
+			clearTimeout(timer);
+			reject(error);
+		});
+	});
+}
+async function readRuntimePageState(miniProgram) {
+	const current = await miniProgram.send("App.getCurrentPage");
+	if (!current || current.pageId == null) return null;
+	const dataResult = await miniProgram.send("Page.getData", { pageId: current.pageId });
+	const rawRoute = String(current.path || "");
+	return {
+		route: normalizeRoute(rawRoute),
+		rawRoute,
+		pageId: current.pageId,
+		data: dataResult?.data || {}
+	};
+}
+function printableRows(items, data) {
+	return items.filter((item) => item.kind !== "event-handler").map((item) => ({
+		source: item.sourceName || item.generatedName || "unknown",
+		key: item.key,
+		value: data[item.key],
+		kind: item.kind,
+		confidence: item.confidence,
+		expressionSummary: item.expressionSummary,
+		wxmlUsages: item.wxmlUsages.map((usage) => usage.snippet)
+	}));
+}
+function explainAutomatorFailure(error) {
+	return [
+		"连接微信开发者工具自动化失败。",
+		error instanceof Error ? error.message : String(error),
+		"",
+		"请检查：",
+		"1. 已安装微信开发者工具。",
+		"2. 微信开发者工具 -> 设置 -> 安全设置 -> 服务端口 已开启。",
+		"3. 该 mp-weixin 编译产物可以被微信开发者工具正常打开。"
+	].join("\n");
+}
+async function startAutomatorInspector(options) {
+	const miniProgram = await automator.launch({
+		projectPath: options.projectPath,
+		cliPath: options.cliPath,
+		port: options.port || 9420,
+		timeout: 45e3,
+		trustProject: true
+	});
+	let closed = false;
+	let lastText = "";
+	let busy = false;
+	const intervalMs = options.intervalMs || 500;
+	async function poll() {
+		if (closed || busy) return;
+		busy = true;
+		try {
+			const state = await withTimeout(readRuntimePageState(miniProgram), 1500, "读取当前页面数据");
+			if (!state) {
+				options.onSnapshot?.({
+					connected: true,
+					status: "已连接，等待当前页面加载",
+					route: "",
+					rows: [],
+					updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+					debug: { keymapPages: Object.keys(options.getAnalysis().pages) },
+					templateTree: null
+				});
+				return;
+			}
+			const route = state.route;
+			const analysis = options.getAnalysis();
+			const pageAnalysis = analysis.pages[route];
+			if (!pageAnalysis) {
+				options.onSnapshot?.({
+					connected: true,
+					status: "已连接，但当前页面没有可用映射",
+					route,
+					rows: [],
+					updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+					debug: {
+						pageId: state.pageId,
+						rawRoute: state.rawRoute,
+						keymapPages: Object.keys(analysis.pages)
+					},
+					rawData: state.data,
+					templateTree: null
+				});
+				const text = `当前页面：${route}\n未找到当前页面的 key 映射。`;
+				if (!options.suppressTerminal && text !== lastText) {
+					lastText = text;
+					console.clear();
+					console.log(text);
+				}
+				return;
+			}
+			const rows = printableRows(pageAnalysis.keys, state.data || {});
+			options.onSnapshot?.({
+				connected: true,
+				status: "已连接",
+				route,
+				rows,
+				updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+				debug: {
+					pageId: state.pageId,
+					rawRoute: state.rawRoute,
+					keymapPages: Object.keys(analysis.pages)
+				},
+				rawData: state.data,
+				templateTree: pageAnalysis.templateTree
+			});
+			const text = JSON.stringify({
+				route,
+				rows
+			});
+			if (!options.suppressTerminal && text !== lastText) {
+				lastText = text;
+				console.clear();
+				console.log("已在 Web 面板中展示最新运行时变量值。");
+				console.log("当前页面：", route);
+				console.log("按 Ctrl+C 停止。");
+			}
+		} catch (error) {
+			const text = `读取运行时数据失败：${error instanceof Error ? error.message : String(error)}`;
+			options.onSnapshot?.({
+				connected: false,
+				status: text,
+				route: "",
+				rows: [],
+				updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+				debug: {
+					error: text,
+					keymapPages: Object.keys(options.getAnalysis().pages)
+				},
+				templateTree: null
+			});
+			if (!options.suppressTerminal && text !== lastText) {
+				lastText = text;
+				console.clear();
+				console.log(text);
+			}
+		} finally {
+			busy = false;
+		}
+	}
+	const timer = setInterval(() => void poll(), intervalMs);
+	await poll();
+	return () => {
+		closed = true;
+		clearInterval(timer);
+		try {
+			miniProgram.disconnect();
+		} catch (_error) {}
+	};
+}
+//#endregion
+exports.explainAutomatorFailure = explainAutomatorFailure;
+exports.startAutomatorInspector = startAutomatorInspector;
+
+//# sourceMappingURL=automator-inspector.cjs.map

package/dist/automator-inspector.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"automator-inspector.cjs","names":[],"sources":["../src/automator-inspector.ts"],"sourcesContent":["import automator = require('miniprogram-automator');\n\nimport type { KeyMapItem, ProjectAnalysis, TemplateNode } from './core';\n\ninterface InspectorOptions {\n  projectPath: string;\n  getAnalysis: () => ProjectAnalysis;\n  intervalMs?: number;\n  cliPath?: string;\n  port?: number;\n  suppressTerminal?: boolean;\n  onSnapshot?: (snapshot: {\n    connected: boolean;\n    status: string;\n    route: string;\n    rows: RuntimeRow[];\n    updatedAt: string;\n    debug?: Record<string, unknown>;\n    rawData?: Record<string, unknown>;\n    templateTree?: TemplateNode | null;\n  }) => void;\n}\n\nexport interface RuntimeRow {\n  source: string;\n  key: string;\n  value: unknown;\n  kind: string;\n  confidence: string;\n  expressionSummary: string;\n  wxmlUsages: string[];\n}\n\nfunction normalizeRoute(route: string): string {\n  const withoutQuery = route.split('?')[0] || route;\n  return withoutQuery.startsWith('/') ? withoutQuery.slice(1) : withoutQuery;\n}\n\ninterface RuntimePageState {\n  route: string;\n  rawRoute: string;\n  pageId: number | string;\n  data: Record<string, unknown>;\n}\n\nfunction withTimeout<T>(promise: Promise<T>, timeoutMs: number, label: string): Promise<T> {\n  return new Promise<T>((resolve, reject) => {\n    const timer = setTimeout(() => reject(new Error(`${label} timed out after ${timeoutMs}ms`)), timeoutMs);\n    promise.then(\n      (value) => {\n        clearTimeout(timer);\n        resolve(value);\n      },\n      (error) => {\n        clearTimeout(timer);\n        reject(error);\n      },\n    );\n  });\n}\n\nasync function readRuntimePageState(miniProgram: any): Promise<RuntimePageState | null> {\n  // Use the underlying automator protocol directly instead of cached Page objects.\n  // This tracks refresh/navigation better because App.getCurrentPage returns the latest pageId/path.\n  const current = await miniProgram.send('App.getCurrentPage');\n  if (!current || current.pageId == null) return null;\n\n  const dataResult = await miniProgram.send('Page.getData', { pageId: current.pageId });\n  const rawRoute = String(current.path || '');\n  return {\n    route: normalizeRoute(rawRoute),\n    rawRoute,\n    pageId: current.pageId,\n    data: (dataResult?.data || {}) as Record<string, unknown>,\n  };\n}\n\nfunction printableRows(items: KeyMapItem[], data: Record<string, unknown>): RuntimeRow[] {\n  return items\n    .filter((item) => item.kind !== 'event-handler')\n    .map((item) => ({\n      source: item.sourceName || item.generatedName || 'unknown',\n      key: item.key,\n      value: data[item.key],\n      kind: item.kind,\n      confidence: item.confidence,\n      expressionSummary: item.expressionSummary,\n      wxmlUsages: item.wxmlUsages.map((usage) => usage.snippet),\n    }));\n}\n\nfunction explainAutomatorFailure(error: unknown): string {\n  const message = error instanceof Error ? error.message : String(error);\n  return [\n    '连接微信开发者工具自动化失败。',\n    message,\n    '',\n    '请检查：',\n    '1. 已安装微信开发者工具。',\n    '2. 微信开发者工具 -> 设置 -> 安全设置 -> 服务端口 已开启。',\n    '3. 该 mp-weixin 编译产物可以被微信开发者工具正常打开。',\n  ].join('\\n');\n}\n\nexport async function startAutomatorInspector(options: InspectorOptions): Promise<() => void> {\n  const miniProgram = await automator.launch({\n    projectPath: options.projectPath,\n    cliPath: options.cliPath,\n    port: options.port || 9420,\n    timeout: 45_000,\n    trustProject: true,\n  });\n\n  let closed = false;\n  let lastText = '';\n  let busy = false;\n  const intervalMs = options.intervalMs || 500;\n\n  async function poll(): Promise<void> {\n    if (closed || busy) return;\n    busy = true;\n    try {\n      const state = await withTimeout(readRuntimePageState(miniProgram), 1500, '读取当前页面数据');\n      if (!state) {\n        options.onSnapshot?.({\n          connected: true,\n          status: '已连接，等待当前页面加载',\n          route: '',\n          rows: [],\n          updatedAt: new Date().toISOString(),\n          debug: { keymapPages: Object.keys(options.getAnalysis().pages) },\n          templateTree: null,\n        });\n        return;\n      }\n      const route = state.route;\n      const analysis = options.getAnalysis();\n      const pageAnalysis = analysis.pages[route];\n      if (!pageAnalysis) {\n        options.onSnapshot?.({\n          connected: true,\n          status: '已连接，但当前页面没有可用映射',\n          route,\n          rows: [],\n          updatedAt: new Date().toISOString(),\n          debug: { pageId: state.pageId, rawRoute: state.rawRoute, keymapPages: Object.keys(analysis.pages) },\n          rawData: state.data,\n          templateTree: null,\n        });\n        const text = `当前页面：${route}\\n未找到当前页面的 key 映射。`;\n        if (!options.suppressTerminal && text !== lastText) {\n          lastText = text;\n          console.clear();\n          console.log(text);\n        }\n        return;\n      }\n\n      const rows = printableRows(pageAnalysis.keys, state.data || {});\n      options.onSnapshot?.({\n        connected: true,\n        status: '已连接',\n        route,\n        rows,\n        updatedAt: new Date().toISOString(),\n        debug: { pageId: state.pageId, rawRoute: state.rawRoute, keymapPages: Object.keys(analysis.pages) },\n        rawData: state.data,\n        templateTree: pageAnalysis.templateTree,\n      });\n      const text = JSON.stringify({ route, rows });\n      if (!options.suppressTerminal && text !== lastText) {\n        lastText = text;\n        console.clear();\n        console.log('已在 Web 面板中展示最新运行时变量值。');\n        console.log('当前页面：', route);\n        console.log('按 Ctrl+C 停止。');\n      }\n    } catch (error) {\n      const text = `读取运行时数据失败：${error instanceof Error ? error.message : String(error)}`;\n      options.onSnapshot?.({\n        connected: false,\n        status: text,\n        route: '',\n        rows: [],\n        updatedAt: new Date().toISOString(),\n        debug: { error: text, keymapPages: Object.keys(options.getAnalysis().pages) },\n        templateTree: null,\n      });\n      if (!options.suppressTerminal && text !== lastText) {\n        lastText = text;\n        console.clear();\n        console.log(text);\n      }\n    } finally {\n      busy = false;\n    }\n  }\n\n  const timer = setInterval(() => void poll(), intervalMs);\n  await poll();\n\n  return () => {\n    closed = true;\n    clearInterval(timer);\n    try {\n      miniProgram.disconnect();\n    } catch (_error) {\n      // Ignore shutdown errors from the DevTools websocket.\n    }\n  };\n}\n\nexport { explainAutomatorFailure };\n"],"mappings":"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"}

package/dist/automator-inspector.d.cts

@@ -0,0 +1,35 @@
+import { ProjectAnalysis, TemplateNode } from "./core.cjs";
+
+//#region src/automator-inspector.d.ts
+interface InspectorOptions {
+  projectPath: string;
+  getAnalysis: () => ProjectAnalysis;
+  intervalMs?: number;
+  cliPath?: string;
+  port?: number;
+  suppressTerminal?: boolean;
+  onSnapshot?: (snapshot: {
+    connected: boolean;
+    status: string;
+    route: string;
+    rows: RuntimeRow[];
+    updatedAt: string;
+    debug?: Record<string, unknown>;
+    rawData?: Record<string, unknown>;
+    templateTree?: TemplateNode | null;
+  }) => void;
+}
+interface RuntimeRow {
+  source: string;
+  key: string;
+  value: unknown;
+  kind: string;
+  confidence: string;
+  expressionSummary: string;
+  wxmlUsages: string[];
+}
+declare function explainAutomatorFailure(error: unknown): string;
+declare function startAutomatorInspector(options: InspectorOptions): Promise<() => void>;
+//#endregion
+export { RuntimeRow, explainAutomatorFailure, startAutomatorInspector };
+//# sourceMappingURL=automator-inspector.d.cts.map

package/dist/chunk-CKQMccvm.cjs

@@ -0,0 +1,28 @@
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+Object.defineProperty(exports, "__toESM", {
+	enumerable: true,
+	get: function() {
+		return __toESM;
+	}
+});

package/dist/cli.cjs

@@ -0,0 +1,33 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_one_click = require("./one-click.cjs");
+//#region src/cli.ts
+function printHelp() {
+	console.log(`umpd
+
+用法:
+  umpd <mp-weixin> -w <wechatwebdevtools.app> [--port <port>]
+  umpd -p <mp-weixin> -w <wechatwebdevtools.app> [--port <port>]
+  umpd --project <mp-weixin> --wechat-devtools <wechatwebdevtools.app> [--port <port>]
+
+说明:
+  默认启动 Web Panel，并通过微信开发者工具 automator 读取当前小程序运行时 page.data。
+  mp-weixin 产物目录可直接作为第一个参数，也可用 -p / --proj / --project 指定。
+  -w / --wd / --wechat-devtools 都可以传微信开发者工具 .app 路径，工具会自动解析到 Contents/MacOS/cli。
+
+示例:
+  umpd ./unpackage/dist/dev/mp-weixin -w /Volumes/Elements/Applications/wechatwebdevtools.app
+  umpd -p ./unpackage/dist/dev/mp-weixin -w /Volumes/Elements/Applications/wechatwebdevtools.app
+  umpd --project ./unpackage/dist/dev/mp-weixin --cli-path /Applications/wechatwebdevtools.app/Contents/MacOS/cli
+`);
+}
+async function main(argv) {
+	if (argv.includes("-h") || argv.includes("--help")) {
+		printHelp();
+		return;
+	}
+	await require_one_click.main(argv);
+}
+//#endregion
+exports.main = main;
+
+//# sourceMappingURL=cli.cjs.map

package/dist/cli.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.cjs","names":["devMain"],"sources":["../src/cli.ts"],"sourcesContent":["import { main as devMain } from './one-click';\n\nfunction printHelp(): void {\n  console.log(`umpd\n\n用法:\n  umpd <mp-weixin> -w <wechatwebdevtools.app> [--port <port>]\n  umpd -p <mp-weixin> -w <wechatwebdevtools.app> [--port <port>]\n  umpd --project <mp-weixin> --wechat-devtools <wechatwebdevtools.app> [--port <port>]\n\n说明:\n  默认启动 Web Panel，并通过微信开发者工具 automator 读取当前小程序运行时 page.data。\n  mp-weixin 产物目录可直接作为第一个参数，也可用 -p / --proj / --project 指定。\n  -w / --wd / --wechat-devtools 都可以传微信开发者工具 .app 路径，工具会自动解析到 Contents/MacOS/cli。\n\n示例:\n  umpd ./unpackage/dist/dev/mp-weixin -w /Volumes/Elements/Applications/wechatwebdevtools.app\n  umpd -p ./unpackage/dist/dev/mp-weixin -w /Volumes/Elements/Applications/wechatwebdevtools.app\n  umpd --project ./unpackage/dist/dev/mp-weixin --cli-path /Applications/wechatwebdevtools.app/Contents/MacOS/cli\n`);\n}\n\nexport async function main(argv: string[]): Promise<void> {\n  if (argv.includes('-h') || argv.includes('--help')) {\n    printHelp();\n    return;\n  }\n  await devMain(argv);\n}\n"],"mappings":";;;AAEA,SAAS,YAAkB;AACzB,SAAQ,IAAI;;;;;;;;;;;;;;;;EAgBZ;;AAGF,eAAsB,KAAK,MAA+B;AACxD,KAAI,KAAK,SAAS,KAAK,IAAI,KAAK,SAAS,SAAS,EAAE;AAClD,aAAW;AACX;;AAEF,OAAMA,kBAAAA,KAAQ,KAAK"}

package/dist/cli.d.cts

@@ -0,0 +1,5 @@
+//#region src/cli.d.ts
+declare function main(argv: string[]): Promise<void>;
+//#endregion
+export { main };
+//# sourceMappingURL=cli.d.cts.map