微信开发者工具自动化

解决问题

微信开发者工具自动化经常依赖临时 UI 点击，遇到宿主小程序、子包、多目标、端口复用、骨架屏和批量冒烟时容易不稳定。该技能把流程收敛到 miniprogram-automator 和 JSON 驱动的 runner，先判断项目形态，再启动或连接开发者工具，最后执行可解析的动作序列。

核心工作方式

• 项目形态解析：优先区分 standalone-miniprogram、hosted-subpackage 与 unknown。子包场景会检查 package.json、.mps.config.js、config/index.js，返回 devtoolsProjectPath、subpackageRoot、devScript 等字段；多目标时必须让用户选择。
• 会话引导：优先用 cli auto 加 connect，避免重复打开同一项目；launch 只作为一次性 fallback。端口可按项目稳定推导，降低跨项目会话复用问题。
• JSON 动作流：把动作计划写入临时 JSON，通过 run_automator.cjs 执行，输出单个 JSON 对象，便于脚本解析。支持 reLaunch、tap、waitForSelector、data、screenshot 等稳定 API。
• 就绪检查：长批处理前可先跑 preflight，用业务选择器而不是根容器判断页面已离开 skeleton。批量入口 run_wechat_batch.cjs 会生成顶层 report.json 和每个 case 的子报告。

适用边界

该技能适合本地小程序、宿主子包、路由冒烟、截图取证和批量检查；不适合作为任意 JS 执行器。选择器应偏稳定，失败时先收集 data() 或截图，不要把一次环境阻塞解释成多个产品回归。连接完成后应断开 websocket，不要关闭用户自己的 DevTools 窗口。沙箱里端口可能监听但 WebSocket 不可达，需要重新探测后再改流程。