miniprogram-auto-testlisted
Install: claude install-skill Zi-Yi-Ming/miniprogram-auto-test
# miniprogram-auto-test — AI 辅助微信小程序自动化测试
## 这是什么
把「手写小程序自动化测试脚本」变成「一句话生成」。开发者指一个页面 + 说要测什么流程,本 skill 引导你(AI)读懂页面的 WXML/JS,生成一个能直接跑的测试脚本,并在微信开发者工具里执行、出报告。
> ⚠️ 这是 AI 辅助生成脚本的工具,不是实时看屏幕自己决定点哪的 GUI agent。那种是未来方向,本 skill 不做。
## 🔴 先读这段:官方 SDK 的两个坑,本 skill 的做法和官方文档不一样
微信官方 SDK 是 `miniprogram-automator`(npm,latest `0.12.1`,**2023-11 后未更新**)。它是唯一的技术地基,但**官方文档教的主要用法在当前版本开发者工具上是死的**。以下两条都是实测确诊,不是推测:
**① `Page.*` 协议整族不响应**(DevTools 2.01.2510290 / 基础库 3.17.0 实测)
`page.data()` / `page.setData()` / `page.callMethod()` / `page.$()` / `page.$$()` / xpath 系列**全部超时**;`Element.*` 因为拿不到 element handle 而整族不可达。也就是官方文档首页那个 `page.$('.btn').tap()`,跑不通。
活着的是 `App.*` 和 `Tool.*` 两族 —— 其中 `miniProgram.evaluate()` 能在小程序运行时里执行任意代码。**所以正确做法是把元素层能力全部重建在 `evaluate` 之上。**
**② `launch()` 在 Windows + Node ≥18.20 上必抛 `spawn EINVAL`**
Node 修了 CVE-2024-27980(BatBadBut)之后,不带 `shell:true` 地 spawn `.bat` 会抛 `EINVAL(-4071)`。官方 `Launcher` 正好这么干,而且把它错报成「`cliPath` 不对」,害你去查一个没问题的路径。
**结论:生成脚本时用 `miniprogram-automator-next`**(本项目提供,把上面两条都修了,并把 `tap`/`query`/`setData` 重建在 `evaluate` 上)。它以 `miniprogram-automator` 为 peerDependency,底层还是官方 SDK。
> 适用范围声明:以上结论在 **DevTools 2.01.2510290 / 基础库 3.17.0 / Node v24.12.0 / Windows 11** 上实测。
>
> **嫌疑变量是开发者工具版本,不是基础库。** 判据:`evaluate` 是在基础库运行时里执行 JS 的,它 5-9ms 正常返回 —— 基础库运行时和 WS 通道都健康。死掉的是按**协议域**切分的 `Page.*`/`Element.*` 两族(协议域是工具那一侧的实现边界),更像 SDK ↔ 工具 的版本错配。**不过这是推断不是实测**(没在别的工具版本上跑过对照)。所以要重测就换**工具版本**,换基础库大概率白费 —— 判据见文末「怎么自己重测 Page.* 是否复活」。
## 前置环境(缺一不可)
| 依赖 | 说明 | 怎么确认 |
|---|-