# Gui Popup Handler

> GUI 弹窗与遮罩层处理技能。当屏幕信息有遮罩层或出现"弹窗关闭按钮"内容时必须使用此技能

- Skill: `tencentmusic/gui-popup-handler` (Agent Skill)
- Install (CLI): `npx skillmds@latest add tencentmusic/gui-popup-handler`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tencentmusic/gui-popup-handler/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tencentmusic (https://skillmd.com/u/tencentmusic)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tencentmusic/gui-popup-handler

---


# 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"选项且无"接受"按钮 → 点击"仅必要"

## 通用关闭动作优先级

当遇到不确定类型的弹窗时，按以下优先级尝试关闭：

1. **点击关闭图标（×）** — 通常在弹窗右上角或者下方
2. **点击"关闭"/"弹窗关闭按钮"/"Close"按钮**
3. **点击"取消"/"Cancel"按钮**
4. **点击"跳过"/"Skip"按钮**
5. **点击"我知道了"/"Got it"/"确定"/"OK"按钮**
6. **点击"不再显示"/"Don't show again"**
7. **点击弹窗外部遮罩区域**
8. **调用返回工具**

## 常见按钮文本映射

为帮助快速识别可操作按钮，以下是常见的中英文按钮文本：

| 动作类别  | 中文文本              | 英文文本                                      |
|-------|-------------------|-------------------------------------------|
| 同意/接受 | 同意、接受、允许、好的、好     | 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              |

## 异常处理

### 连续弹窗

若关闭一个弹窗后立即出现新弹窗：

1. 按照相同策略逐一处理，最多处理 5 个连续弹窗
2. 若超过 5 个连续弹窗，暂停操作并通知用户页面可能存在异常
3. 考虑是否进入了循环弹窗陷阱，必要时刷新页面或导航到其他页面