SuperAPI AI Directory

gui-popup-handler

General & other

View repository

Updated 10-16 08:44

About this skill

GUI pop-up handling skill

Core handling process

发现页面异常/操作受阻
       ↓
识别遮罩层类型
       ↓
┌──────────────────────────────────┐
│  判断遮罩类型                      │
├──────┬──────┬──────┬─────┬──────┤
│ 权限  │ 同意  │ 提示  │ 广告 │ 其他  │
│ 授权  │ 确认  │ 引导  │ 推广 │ 弹窗  │
└──┬───┴──┬───┴──┬───┴──┬──┴──┬───┘
   ↓      ↓      ↓      ↓     ↓
 选择对应处理策略
       ↓
 执行关闭/消除动作
       ↓
 验证遮罩已消除
       ↓
 继续原有操作流程

Overlay types and handling strategies

1. Ad pop-ups / promotional floating layers

Typical scenarios: In-app ads, event promotions, membership recommendations, and other pop-ups.

Identifying features:

  • Eye-catching images or promotional copy
  • Usually has a close button (×) or a "Do not show again" option
  • May have a countdown

Handling strategy:

  • If there is a close icon (×) / pop-up close button / X close button → click the close button
  • If there is a "Do not show again"/"Not interested" option → click it to avoid it popping up again
  • If there is a countdown → wait for the countdown to end, then click "Skip"/"Close"
  • Be wary of ad links disguised as close buttons; the real close button is usually in the upper right corner
  • If the ad pop-up / promotional floating layer is still there after the click action, you can try calling "Back" once

2. System notifications / update prompts

Typical scenarios: App update reminders, system notifications, version upgrade pop-ups.

Identifying features:

  • Contains keywords such as "update"/"upgrade"/"Update"
  • Usually has deferral options such as "Later"/"Later"/"Cancel"

Handling strategy:

  • Click "Later"/"Later"/"Remind me later"/"Cancel" → defer handling without affecting the current task
  • If there is only an "Update now" option → click the "Close" icon (×)
  • If the pop-up cannot be closed and updating is the only option → record the status and notify the user

3. Login/registration interception pop-ups

Typical scenarios: Login pop-ups triggered by operations while not logged in, or registration guidance.

Identifying features:

  • Contains username/password input fields or third-party login buttons
  • Contains text such as "Login"/"Register"/"Sign In"/"Sign Up"

Handling strategy:

  • Prioritize finding a close button (×) or "Later"/"Ask me later" → close the pop-up
  • If the pop-up reappears after closing → try clicking the overlay area outside the pop-up
  • If logging in is a necessary condition for completing the task → record the status and notify the user that login is required

4. Confirmation/prompt dialogs

Typical scenarios: Action confirmation boxes, information prompt boxes, warning boxes, etc.

Identifying features:

  • A concise dialog box containing prompt information
  • Contains buttons such as "OK"/"OK"/"Got it"/"Got it"

Handling strategy:

  • Read the prompt content and determine whether it affects the current task
  • If it is an ordinary information prompt → click "OK"/"OK"/"Got it"
  • If it is a dangerous operation warning (such as delete, reset) → click "Cancel"/"Cancel", and notify the user

5. App onboarding prompts / novice tutorials

Typical scenarios: Onboarding overlays when using an app for the first time or when new features are launched.

Identifying features:

  • Highlights a certain area and is accompanied by explanatory text
  • Contains buttons such as "Next"/"Skip"/"Got it"/"Got it"
  • There may be a step indicator (e.g., 1/5, 2/5)

Handling strategy:

  • Prioritize clicking "跳过"/"Skip"/"关闭" → eliminate all guidance in one step
  • If there is no "跳过" button → continuously click "下一步"/"Next" until "完成"/"Done"/"我知道了" appears
  • If there is a close icon (×) → directly click close

6. Permission authorization dialog

Typical scenarios: The browser or app requests permissions such as camera, microphone, location, notifications, clipboard, etc.

Identifying features:

  • System-level dialog, usually located at the top of the page or centered
  • Contains buttons such as "允许"/"拒绝", "Allow"/"Block", etc.
  • May have permission icons (camera, microphone, location, etc.)

Handling strategy:

  • If the permission is related to the current task → click "允许"/"Allow"
  • If the permission is unrelated to the current task → click "拒绝"/"Block"/"不允许"
  • If relevance cannot be determined → click "拒绝" by default, prioritizing privacy protection

7. Cookie / privacy policy consent prompt

Typical scenarios: A Cookie usage consent banner or popup that appears when a website is visited for the first time.

Identifying features:

  • Usually a banner/popup located at the bottom of the page or centered
  • Contains buttons such as "接受"/"同意"/"Accept"/"Accept All", etc.
  • Mentions keywords such as "Cookie", "隐私政策", "Privacy Policy", etc.

Handling strategy:

  • Prioritize clicking "全部接受"/"Accept All"/"同意" → fastest elimination
  • If there is only a "管理设置"/"Manage" option → enter settings and then click "确认"/"保存"
  • If there is a "仅必要"/"Reject All" option and no "接受" button → click "仅必要"

General close action priority

When encountering a popup of uncertain type, try to close it in the following priority order:

  1. Click the close icon (×) — usually at the upper right or lower part of the popup
  2. Click the "Close"/"popup close button"/"Close" button
  3. Click the "取消"/"Cancel" button
  4. Click the "跳过"/"Skip" button
  5. Click the "我知道了"/"Got it"/"确定"/"OK" button
  6. Click "不再显示"/"Don't show again"
  7. Click the mask area outside the popup
  8. Call the back tool

Common button text mapping

To help quickly identify actionable buttons, below are common Chinese and English button texts:

Action category Chinese text English text
Agree/Accept Agree, accept, allow, OK, okay Accept, Allow, Agree, OK, Yes
Confirm/Acknowledge Confirm, confirm, I understand, got it, understood Confirm, Got it, I understand, Understood
Skip/Ignore Skip, ignore, talk about it later, later, no thanks Skip, Ignore, Later, Not now, Dismiss
Close/Cancel Close, cancel, back, exit Close, Cancel, Back, Exit
Reject/Block Reject, do not allow, block, do not agree Deny, Block, Reject, Decline

Exception handling

Continuous popups

If a new popup appears immediately after closing one popup:

  1. Process them one by one according to the same strategy, handling at most 5 consecutive popups
  2. If there are more than 5 consecutive popups, pause the operation and notify the user that the page may be abnormal
  3. Consider whether you have entered a popup loop trap; if necessary, refresh the page or navigate to another page