| name | gui-popup-handler |
| description | GUI 弹窗与遮罩层处理技能。当屏幕信息有遮罩层或出现"弹窗关闭按钮"内容时必须使用此技能 |
GUI 弹窗处理技能
核心处理流程
发现页面异常/操作受阻
↓
识别遮罩层类型
↓
┌──────────────────────────────────┐
│ 判断遮罩类型 │
├──────┬──────┬──────┬─────┬──────┤
│ 权限 │ 同意 │ 提示 │ 广告 │ 其他 │
│ 授权 │ 确认 │ 引导 │ 推广 │ 弹窗 │
└──┬───┴──┬───┴──┬───┴──┬──┴──┬───┘
↓ ↓ ↓ ↓ ↓
选择对应处理策略
↓
执行关闭/消除动作
↓
验证遮罩已消除
↓
继续原有操作流程
遮罩层类型与处理策略
1. 广告弹窗 / 推广浮层
典型场景： 应用内广告、活动推广、会员推荐等弹窗。
识别特征：
- 醒目的图片或促销文案
- 通常有关闭按钮（×）或"不再显示"选项
- 可能有倒计时
处理策略：
- 如有关闭图标（×）/ 弹窗关闭按钮 / X close button → 点击关闭按钮
- 如有"不再显示"/"不感兴趣"选项 → 点击以避免再次弹出
- 如有倒计时 → 等待倒计时结束后点击"跳过"/"关闭"
- 警惕伪装成关闭按钮的广告链接，真正的关闭按钮通常在右上角
- 如果操作点击后，广告弹窗 / 推广浮层还在，可以尝试调用"返回"一次
2. 系统通知 / 更新提示
典型场景： 应用更新提醒、系统通知、版本升级弹窗。
识别特征：
- 包含"更新"/"升级"/"Update" 等关键词
- 通常有"稍后"/"Later"/"取消" 等延迟选项
处理策略：
- 点击"稍后"/"Later"/"稍后提醒"/"取消" → 延迟处理不影响当前任务
- 如只有"立即更新"选项 → 点击"关闭"图标（×）
- 如弹窗无法关闭且只能更新 → 记录状态并通知用户
3. 登录/注册拦截弹窗
典型场景： 未登录状态下操作触发的登录弹窗，或注册引导。
识别特征：
- 包含用户名/密码输入框或第三方登录按钮
- 包含"登录"/"注册"/"Sign In"/"Sign Up" 等文字
处理策略：
- 优先寻找关闭按钮（×）或"稍后"/"以后再说" → 关闭弹窗
- 如弹窗关闭后重复出现 → 尝试点击弹窗外的遮罩区域
- 如登录是完成任务的必要条件 → 记录状态并通知用户需要登录
4. 确认/提示对话框
典型场景： 操作确认框、信息提示框、警告框等。
识别特征：
- 简洁的对话框，包含提示信息
- 包含"确定"/"OK"/"我知道了"/"Got it" 等按钮
处理策略：
- 阅读提示内容，判断是否影响当前任务
- 若为普通信息提示 → 点击"确定"/"OK"/"我知道了"
- 若为危险操作警告（如删除、重置） → 点击"取消"/"Cancel"，并通知用户
5. 应用引导提示 / 新手教程
典型场景： 首次使用应用或新功能上线时的引导浮层。
识别特征：
- 高亮某个区域并配有说明文字
- 包含"下一步"/"跳过"/"我知道了"/"Got it" 等按钮
- 可能有步骤指示器（如 1/5、2/5）
处理策略：
- 优先点击"跳过"/"Skip"/"关闭" → 一步到位消除所有引导
- 如无"跳过"按钮 → 连续点击"下一步"/"Next" 直到出现"完成"/"Done"/"我知道了"
- 如有关闭图标（×） → 直接点击关闭
6. 权限授权对话框
典型场景： 浏览器或应用请求摄像头、麦克风、定位、通知、剪贴板等权限。
识别特征：
- 系统级对话框，通常位于页面顶部或居中
- 包含"允许"/"拒绝"、"Allow"/"Block" 等按钮
- 可能带有权限图标（摄像头、麦克风、定位等）
处理策略：
- 若权限与当前任务相关 → 点击"允许"/"Allow"
- 若权限与当前任务无关 → 点击"拒绝"/"Block"/"不允许"
- 若无法判断相关性 → 默认点击"拒绝"，优先保护隐私
7. Cookie / 隐私政策同意提示
典型场景： 网站首次访问时弹出的 Cookie 使用同意横幅或弹窗。
识别特征：
- 通常位于页面底部或居中的横幅/弹窗
- 包含"接受"/"同意"/"Accept"/"Accept All" 等按钮
- 提及"Cookie"、"隐私政策"、"Privacy Policy" 等关键词
处理策略：
- 优先点击"全部接受"/"Accept All"/"同意" → 最快消除
- 如仅有"管理设置"/"Manage"选项 → 进入设置后点击"确认"/"保存"
- 如有"仅必要"/"Reject All"选项且无"接受"按钮 → 点击"仅必要"
通用关闭动作优先级
当遇到不确定类型的弹窗时，按以下优先级尝试关闭：
- 点击关闭图标（×） — 通常在弹窗右上角或者下方
- 点击"关闭"/"弹窗关闭按钮"/"Close"按钮
- 点击"取消"/"Cancel"按钮
- 点击"跳过"/"Skip"按钮
- 点击"我知道了"/"Got it"/"确定"/"OK"按钮
- 点击"不再显示"/"Don't show again"
- 点击弹窗外部遮罩区域
- 调用返回工具
常见按钮文本映射
为帮助快速识别可操作按钮，以下是常见的中英文按钮文本：
| 动作类别 | 中文文本 | 英文文本 |
|---|
| 同意/接受 | 同意、接受、允许、好的、好 | Accept, Allow, Agree, OK, Yes |
| 确认/知晓 | 确定、确认、我知道了、知道了、了解 | Confirm, Got it, I understand, Understood |
| 跳过/忽略 | 跳过、忽略、以后再说、稍后、不了 | Skip, Ignore, Later, Not now, Dismiss |
| 关闭/取消 | 关闭、取消、返回、退出 | Close, Cancel, Back, Exit |
| 拒绝/阻止 | 拒绝、不允许、阻止、不同意 | Deny, Block, Reject, Decline |
异常处理
连续弹窗
若关闭一个弹窗后立即出现新弹窗：
- 按照相同策略逐一处理，最多处理 5 个连续弹窗
- 若超过 5 个连续弹窗，暂停操作并通知用户页面可能存在异常
- 考虑是否进入了循环弹窗陷阱，必要时刷新页面或导航到其他页面
