1

_DEL/weixin-devtools/POWER.md

@@ -0,0 +1,116 @@
+---
+name: "weixin-devtools"
+displayName: "微信开发者工具自动化"
+description: "通过 weixin-devtools-mcp 控制微信开发者工具，支持页面导航、元素快照、截图、表单操作、JS 执行、网络监控、Console 日志等小程序自动化操作"
+keywords: ["微信开发者工具", "小程序调试", "devtools", "wechat", "miniprogram", "截图", "screenshot", "页面快照", "snapshot", "元素点击", "click", "表单", "form", "navigate", "console", "网络请求", "network", "evaluate", "自动化测试", "UI验证"]
+author: "NeoZQYY"
+---
+
+# 微信开发者工具自动化 Power
+
+通过 weixin-devtools-mcp 控制微信开发者工具，用于小程序 UI 调试、页面验证、自动化测试。
+
+## 可用 Server
+
+### weixin-devtools
+连接本地微信开发者工具实例，提供完整的小程序自动化能力。
+
+前置条件：
+- 微信开发者工具已打开并加载项目
+- 自动化端口 9420 已启用（设置 → 安全 → 服务端口）
+
+## 工具分类速查
+
+### 连接管理
+| 工具 | 说明 |
+|------|------|
+| `connect_devtools` | 连接开发者工具（支持 auto/launch/connect 策略） |
+| `disconnect_devtools` | 断开连接并清理状态 |
+| `reconnect_devtools` | 重连（可复用上次参数） |
+| `get_connection_status` | 查看连接状态 |
+| `check_environment` | 检查自动化环境配置 |
+| `diagnose_connection` | 诊断连接问题 |
+| `debug_connection_flow` | 调试连接流程 |
+
+### 页面导航
+| 工具 | 说明 |
+|------|------|
+| `navigate_to` | 跳转到指定页面（支持参数） |
+| `navigate_back` | 返回上一页 |
+| `switch_tab` | 切换 TabBar 页面 |
+| `relaunch` | 重启小程序并跳转 |
+| `get_current_page` | 获取当前页面信息 |
+
+### 元素操作
+| 工具 | 说明 |
+|------|------|
+| `get_page_snapshot` | 获取页面元素快照（含 uid） |
+| `$` | CSS 选择器查找元素 |
+| `click` | 点击元素（支持双击） |
+| `input_text` | 输入文本 |
+| `set_form_control` | 设置表单控件值（picker/switch/slider） |
+| `get_value` | 获取元素值或文本 |
+| `debug_page_elements` | 调试元素获取问题 |
+
+### 断言验证
+| 工具 | 说明 |
+|------|------|
+| `assert_text` | 断言元素文本（精确/包含/正则） |
+| `assert_state` | 断言元素状态（可见/启用/选中/聚焦） |
+| `assert_attribute` | 断言元素属性值 |
+
+### JS 执行
+| 工具 | 说明 |
+|------|------|
+| `evaluate_script` | 在 AppService 上下文执行 JS |
+
+### 监控与调试
+| 工具 | 说明 |
+|------|------|
+| `screenshot` | 页面截图（base64 或保存文件） |
+| `list_console_messages` | 列表查询 console 消息 |
+| `get_console_message` | 获取单条 console 详情 |
+| `get_network_requests` | 获取网络请求记录 |
+| `clear_network_requests` | 清空网络请求记录 |
+| `stop_network_monitoring` | 停止网络监听 |
+
+### 等待
+| 工具 | 说明 |
+|------|------|
+| `waitFor` | 等待条件满足（元素出现/消失/文本匹配/延时） |
+
+## 典型工作流
+
+### 1. 连接 → 导航 → 验证
+```
+connect_devtools → navigate_to → get_page_snapshot → assert_text
+```
+
+### 2. 表单填写 → 提交 → 检查结果
+```
+navigate_to → get_page_snapshot → input_text → click → waitFor → assert_text
+```
+
+### 3. 截图对比（配合 pixel-audit）
+```
+navigate_to → screenshot → 用 image-compare 对比 H5 截图
+```
+
+### 4. 数据验证
+```
+evaluate_script（读取页面 data）→ 对比预期值
+```
+
+## Steering
+
+| 文件 | 内容 |
+|------|------|
+| `workflow.md` | 连接策略、页面导航模式、元素操作最佳实践、常见问题排查 |
+
+加载：激活 Power → `readSteering("workflow.md")`
+
+## 注意事项
+- 操作元素前必须先 `get_page_snapshot` 获取 uid
+- `navigate_to` 不能跳转 TabBar 页面，用 `switch_tab`
+- `evaluate_script` 在 AppService 上下文执行，可访问 `wx`、`getApp()`、`getCurrentPages()`
+- 截图默认返回 base64，传 `path` 参数可保存到文件