gkd 中文文档 下载 App

gkd 全局规则写法:跨应用生效的自动点击规则

应用规则绑定单个包名,全局规则则相反:它挂在订阅的全局层,对所有应用生效。「跳过所有开屏广告」这类跨应用场景,用全局规则一条就能覆盖。

入口位置

全局规则的编辑入口在:首页 → 订阅 → 本地订阅 → 全局规则。点开是独立的规则列表,与某个具体应用无关。

GKD 本地订阅的全局规则界面
全局规则添加界面

一条官方示例的逐行解读

官方文档给出的全局规则示例,正是一条通用的开屏广告跳过规则:

{
  key: 0,
  name: '开屏广告',
  fastQuery: true,
  matchTime: 10000,
  actionMaximum: 1,
  resetMatch: 'app',
  rules: [
    {
      key: 0,
      matches: '[text*="跳过"][text.length<10][visibleToUser=true]',
    },
  ],
}

重点在规则组上的几个控制参数——它们是全局规则防误触、防耗电的关键:

参数值作用
matchTime10000只在应用启动后 10 秒内匹配,广告期过了就不再扫屏
actionMaximum1最多执行 1 次点击,防止反复触发
resetMatchapp切换应用后重置计数,下次开屏重新生效
fastQuerytrue使用快速查询通道,降低匹配开销

选择器本身的含义:找可见的、文字包含「跳过」且文字长度小于 10 的节点。加上长度限制是为了避免点到「跳过本集片头」这类正常按钮。

全局规则 vs 应用规则

全局规则应用规则
作用域所有应用指定包名
写法重心参数控制 + 宽匹配包名 + 精确选择器
风险误触范围大,参数必须收紧影响面小,可写得更精确

经验法则:能用应用规则精确解决的,不要提升到全局。全局规则里每个宽松的选择器都会在所有应用的每次界面变化时跑一遍,这是耗电与误触的双重来源。

全局规则也要分类管理

全局规则同样可以挂到订阅的分类体系下(开屏广告、更新提示等),在订阅页按类别启停,管理方式见规则分类。写完规则后,去触发记录看它的实际命中情况,判断参数是否收放得当。