Karate Robot 基于图像识别点击按钮出现间歇性失效问题

我正在使用Karate Robot通过图像识别的方式点击按钮，相关实现代码如下：

• robot { app: '^Chrome', highlight: true }
• robot.input('OracleDriver')
• delay(2000)
• robot.click('delete.png')

运行过程中，通过delete.png识别并点击删除按钮时，有时可正常完成点击操作，有时则无法成功触发，该问题为间歇性出现。

• 图像匹配阈值波动：Karate Robot默认采用像素相似度匹配，默认相似度阈值下，只要目标区域和基准图的匹配度达到要求就会识别成功。实际运行时浏览器的抗锯齿渲染、按钮hover状态的边框变化、临时的高亮反馈，都会导致像素匹配度在阈值上下浮动，就会出现时成时败的情况
• 固定硬等待的场景适配缺陷：写死的2秒延迟无法覆盖所有运行场景——如果页面接口响应慢、按钮还没渲染完成就发起识别，自然找不到目标；如果按钮的淡入动画还在播放，识别到的半透明状态和基准图的实色状态有像素差，也会识别失败
• 窗口焦点/元素遮挡问题：Karate Robot需要前台窗口具备操作权限，运行时如果系统通知、其他悬浮弹窗刚好挡住了删除按钮的识别区域，或者Chrome窗口失焦没在前台，就会导致识别流程被阻断
• 运行环境的DPI/分辨率波动：如果系统开了动态缩放、外接显示器热插拔导致分辨率临时变化，实际界面上的按钮尺寸和你截取delete.png基准图时的比例不匹配，就会间歇性出现识别错位

• 校准基准截图与匹配参数：在和运行环境完全一致的分辨率、缩放比例下重新截取delete.png的基准图，根据实际渲染的像素差适当调整识别相似度阈值，不要把阈值设得过高
• 替换固定硬延迟为显式图像等待逻辑：去掉写死的2秒delay(2000)，改用Karate Robot内置的图像等待方法，持续轮询识别目标图像直到稳定匹配后再执行点击，覆盖页面加载速度波动的问题
• 优化运行流程的前置校验：每次执行点击操作前，先激活目标Chrome窗口的前台焦点，关闭系统级悬浮通知的遮挡，确认无其他悬浮元素挡住识别区域再发起识别
• 固定运行环境配置：关闭系统动态缩放、自动切换分辨率的功能，避免运行过程中界面像素比例临时变化导致的识别偏差

内容的提问来源于stack exchange，提问作者Bibhuti Bhusan Sahoo