Minium 测试用例修复技能

📖 描述

自动修复 Minium 测试用例中的元素定位错误。当测试用例因元素找不到而失败时，本技能自动分析错误日志、读取 WXML 快照、找到正确的元素定位并修复代码。

核心能力:

• - ✅ 分析 WXML 找到正确元素
• ✅ 修复元素定位问题
• ✅ 验证修复后测试通过

🎯 触发条件

核心触发场景：用户提供 Minium 测试错误报告，要求修复用例

触发词：

• - "修复用例"
• "测试报错了"
• "元素找不到"
• "帮我看看这个错误"
• 直接粘贴错误日志/错误报告

支持的报告格式：

1. 1. 本地运行日志 - 直接粘贴终端输出
2. 云测平台报告 - 粘贴云测平台的错误日志
3. 错误截图 - 描述错误信息

⚡ 核心规则（必须遵守！）

🚨 规则 1：先运行测试，获取最新 WXML

当用户提供错误报告时，禁止直接修复！

正确流程：
CODEBLOCK0

错误示范（禁止！）：

• - ❌ 用户给错误报告 → 直接修改代码（未运行测试）
• ❌ 假设元素定位（未查看 WXML）
• ❌ 覆盖用户原有代码（未确认）

🚨 规则 2：页面有多个相同元素时，使用 get_elements()[0]

核心问题：页面里有多个同样的元素，直接点击会失败

正确做法：
CODEBLOCK1

适用场景：

• - feed 列表中的多个相同按钮
• 商品列表中的多个相同操作按钮
• 任何重复出现的元素

🚨 规则 3：优先使用文本定位，避免长 XPath

核心问题：长 XPath 依赖页面结构索引，页面结构变化就会失效

对比：
CODEBLOCK2

定位优先级：

1. 1. 文本定位（最稳定）：INLINECODE0
2. CSS selector（较稳定）：INLINECODE1
3. XPath 属性（中等）：INLINECODE2
4. 长 XPath（最不稳定，禁止使用）

🚨 规则 4：无法识别时直接问

当以下情况无法确定元素时：

1. 1. 原定位路径在 WXML 中找不到
2. 变量名无意义（如 element_1）
3. 没有注释说明元素用途
4. WXML 中有多个相似元素

正确做法：
CODEBLOCK3

错误做法：

• - ❌ 瞎猜一个文本
• ❌ 随便选一个相似的
• ❌ 不确认就直接修改

🚨 规则 5：已存在目录 → 先阅读现有代码结构！

当修复用例时，禁止直接修改！

正确流程：

第 1 步：读取现有 Page Object 文件
→ 查看元素定义风格（CSS selector 还是 xpath）
→ 查看方法命名规范

第 2 步：总结现有规则
→ Page Object 命名规则
→ 元素定位规则
→ 测试用例结构

第 3 步：按现有规则修复
→ 新 Page Object 遵循已有命名和结构
→ 新测试用例遵循已有风格和格式
→ 不引入与现有代码冲突的规范

🚨 规则 6：先阅读用户基类代码，再决定使用什么方法！

Page Object 核心规则：

1. 1. 先阅读用户的基类代码（如 basedef.py）

1. 2. 检查用户的封装方式

1. 3. 不要照搬录制脚本的等待时间！

🚨 规则 7：修复后必须在本地验证！

核心原则：改完之后一定要在本地先自己跑一遍确认没有报错

正确流程：
CODEBLOCK5

错误示范（禁止！）：

• - ❌ 修改代码后不验证就直接报告完成
• ❌ 只依赖云测平台验证（来回浪费时间）
• ❌ 假设修复成功（不运行测试）

正确示范：

✅ 修复完成！
本地验证结果：
====================case num:1, failed num:0, error num:0====================

主人，本地测试已通过！你可以在云测平台重新运行了！

📋 完整修复流程

步骤 1：运行测试用例（开发者工具保持前台）

方法 A：使用窗口标题激活（推荐）
CODEBLOCK7

方法 B：使用进程名激活
CODEBLOCK8

注意：

• - 运行测试前，确保微信开发者工具已打开
• 使用 AppActivate 直接激活指定窗口（比 Alt+Tab 更可靠）
• 测试运行期间不要切换到其他窗口

步骤 2：读取错误日志

测试失败后，查看错误堆栈：

CODEBLOCK9

提取关键信息：

• - 失败文件：INLINECODE19
• 失败行号：399
• 失败元素：INLINECODE20

步骤 3：查找当前元素定义

CODEBLOCK10

示例输出：

element_name = "//*[text()='按钮文本']"

步骤 4：读取 WXML 文件

CODEBLOCK12

在 WXML 中搜索正确元素：

CODEBLOCK13

步骤 5：提供修复方案

向用户展示：

CODEBLOCK14python
element_name = "//*[text()='按钮文本']"

**WXML 中实际结构**：

**建议修复方案**：

**方案 1**：使用 class 定位

**方案 2**：使用 text 包含

---

**主人，确认这个修改吗？** 🔧

步骤 6：用户确认后更新代码

CODEBLOCK19

步骤 7：重新运行测试验证（必须！）

⚠️ 重要：修复后必须在本地验证！

CODEBLOCK20

确认测试通过：
CODEBLOCK21

只有看到上述输出才算修复完成！

如果还有报错：

1. 1. 读取新的错误日志
2. 继续修复下一个元素
3. 重新运行测试
4. 直到完全通过

💡 踩坑总结

坑 1：页面有多个相同元素

现象：元素定位正确，但点击失败

原因：页面里有多个同样的元素，tap_icon() 不知道点哪个

解决：使用 get_elements()[0].tap() 获取第一个

案例：

# feed_statistic 等按钮在 feed 列表中重复出现
self.get_elements(self.feed_statistic)[0].tap()
self.get_elements(self.feed_order_manage)[0].tap()
self.get_elements(self.feed_wait_thaw_payment)[0].tap()

坑 2：长 XPath 定位不稳定

现象：今天能跑，明天就失败

原因：XPath 依赖页面结构索引，页面结构一变就失效

解决：使用文本定位 INLINECODE23

案例：

# ❌ 错误做法
element_name = "/page-wrapper/view/view/view[1]/view[3]/view[4]/view[3]/view[1]/home-sequence-list/view/view/view[6]/view[1]/view[2]"

# ✅ 正确做法
element_name = "//*[text()='按钮文本']"

坑 3：开发者工具不在前台

现象：页面跳转超时 INLINECODE24

原因：微信开发者工具在后台，页面加载慢或卡住

解决：运行测试前用 AppActivate 激活开发者工具

案例：

$wshell = New-Object -ComObject wscript.shell
$wshell.AppActivate("微信开发者工具")
Start-Sleep -Milliseconds 2000

坑 4：元素定义乱码

现象：修改后元素定义变成乱码

原因：PowerShell 字符串转义问题

解决：使用 Python 脚本修改文件

案例：

# fix_elements.py
import re
content = open('file.py', 'r', encoding='utf8').read()
content = re.sub(r'element_name = ".*?"', 'element_name = "//*[text()=\'按钮文本\']"', content)
open('file.py', 'w', encoding='utf8').write(content)

🧪 使用示例

示例 1：用户提供错误报告

用户：
CODEBLOCK26

技能响应：

🦞 收到，我来帮你修复！

**第 1 步：运行测试获取最新 WXML**

[运行测试...]

**第 2 步：分析错误**
- 失败元素：`element_name`
- 当前定位：`//*[text()='按钮文本']`

**第 3 步：查找 WXML**
[搜索 WXML...]

**第 4 步：修复方案**
[提供方案...]

主人，确认修改吗？

示例 2：云测平台报告

用户：
CODEBLOCK29

技能响应：

🦞 收到云测报告，我来帮你修复！

**分析云测报告**：
- 失败文件：`pages/pages/xxx/xxx.py`
- 失败行号：169
- 失败方法：`xxx_method`
- 失败元素：`self.element_name`

**第 1 步：本地运行测试获取 WXML**

[运行测试...]

**第 2 步：在 WXML 中搜索元素**
[搜索 WXML...]

**第 3 步：提供修复方案**
[提供方案...]

主人，确认修改吗？

示例 3：用户说"修复用例"

用户：
CODEBLOCK32

技能响应：

🦞 好的，我来运行测试并修复！

**运行测试**：

[等待测试失败 → 读取错误 → 查找 WXML → 提供方案]

📊 技能统计

🚀 快速开始

当你有 Minium 测试用例报错时，直接说：

CODEBLOCK35

或者粘贴错误日志，我会自动帮你分析修复！