GKD 自定义规则编写完整教程

工具简介

GKD (基于无障碍服务的跳广告工具) 是一款强大的广告拦截工具，通过自定义规则实现精准跳过各类广告。它利用 Android 的无障碍服务来自动化操作，帮助用户摆脱烦人的广告干扰。

核心原理

通过精确的选择器定位广告元素，并执行相应的点击动作来跳过广告。

详细教程

第一步：准备工作

安装并启用 GKD 无障碍服务
- 在手机设置中开启无障碍服务权限
- 启动 GKD 应用并确认服务已运行
捕获广告界面快照
- 在遇到广告时，使用 GKD 的快照功能截取当前界面
- 保存快照以便后续分析
分析节点属性
- 访问 GKD 审查工具 (gkd.li/import)
- 上传快照文件分析节点结构和属性

第二步：规则 JSON 结构详解

{
  "id": "string (订阅唯一标识)",
  "name": "string (订阅名称)",
  "apps": [
    {
      "id": "string (App 包名)",
      "name": "string (App 名称)",
      "groups": [
        {
          "key": "number (组 ID)",
          "name": "string (规则组名)",
          "rules": [
            {
              "matches": "string (选择器逻辑)",
              "activityIds": "string/array (可选，限制界面)",
              "action": "string (默认 click)"
            }
          ]
        }
      ]
    }
  ]
}

第三步：选择器编写技巧

属性匹配

[text='跳过'] - 匹配文本内容为"跳过"的元素
[id*='btn_skip'] - 匹配 ID 包含"btn_skip"的元素
[desc='关闭'] - 匹配描述为"关闭"的元素

关系定位

[text='跳过'] <<n - 向上查找第 n 层父节点
View + Button - 查找相邻的按钮元素

状态过滤

[visibleToUser=true] - 仅匹配可见元素，提高准确性

第四步：进阶控制参数

actionMaximum: 限制点击次数，防止无限循环
resetMatch: 界面变化后是否重新匹配新元素
actionDelay: 设置点击延迟（毫秒），避免操作过快
snapshotUrls: 关联快照链接，便于后期调试和验证

实际应用步骤

在 GKD 设置中进入’高级配置’
找到’本地订阅’选项
粘贴编写好的 JSON 规则并保存
返回目标 App 测试运行效果

注意事项

编写规则前务必先测试快照的准确性
建议从小范围开始测试，逐步完善规则
定期更新规则以适应 App 版本更新