【免费下载】 GKD订阅规则编写完全指南：从环境搭建到规则提交

前言

在移动应用生态中，广告拦截一直是用户关注的焦点。GKD订阅项目通过规则定义的方式，帮助用户自动化处理应用中的各类广告和干扰元素。本文将详细介绍如何为GKD订阅项目编写有效的规则，从环境搭建到最终提交的全流程。

一、环境准备

1.1 基础设备要求

• Android设备（系统版本建议11及以上）
• 可选：电脑（用于更高效的规则编写）

1.2 开发环境配置（电脑端）

项目基于Node.js和TypeScript技术栈，需要配置以下环境：

1. Node.js环境：建议安装LTS版本
2. 包管理工具：推荐使用pnpm，执行效率高于npm
3. 代码编辑器：Visual Studio Code是最佳选择，提供完善的TypeScript支持

安装完成后，在项目根目录执行pnpm install安装依赖。

二、快照获取与审查

2.1 设备端配置

1. 在目标应用中启用无障碍权限
2. 对于Android 11以下设备，需额外开启截屏服务
3. 建议开启悬浮窗服务，便于快速捕获快照

2.2 快照捕获方式

有三种主要方式获取应用界面快照：

1. 悬浮窗按钮：通过悬浮窗服务提供的截屏按钮
2. 控制中心快捷功能：添加"捕获快照"快捷方式
3. 网页审查工具：最推荐的方式，提供更全面的分析功能

2.3 网页审查工具使用

1. 确保设备和电脑在同一局域网
2. 在设备上启用HTTP服务
3. 通过浏览器访问审查工具界面
4. 安装必要的浏览器扩展以绕过安全限制

三、规则编写实战

3.1 快照分析

以WPS应用为例，分析广告元素的特征：

1. 定位广告关闭按钮
2. 通过审查工具查看节点属性
3. 识别唯一标识符（如ID、文本内容等）

3.2 选择器编写

选择器语法类似于CSS选择器，常用模式包括：

• 精确ID匹配：[id="com.example.ad/close"]
• 后缀匹配：[id$="/close"]（匹配以"/close"结尾的ID）
• 文本匹配：[text="关闭广告"]

3.3 规则测试

1. 在审查工具中验证选择器有效性
2. 通过"执行选择器"功能进行真机测试
3. 处理可能出现的多阶段广告（如关闭后出现的反馈弹窗）

3.4 完整规则示例

{
  id: 'cn.wps.moffice_eng',
  name: 'WPS',
  groups: [
    {
      key: 1,
      name: '分段广告-首页-文档列表广告',
      activityIds: [
        'cn.wps.moffice.main.StartPublicActivity',
        'cn.wps.moffice.main.local.HomeRootActivity'
      ],
      rules: [
        {
          matches: '[text="关闭当前广告"]',
          snapshotUrls: 'https://i.gkd.li/i/12505365'
        },
        {
          matches: '[id$="/nativeclose"]',
          snapshotUrls: [
            'https://i.gkd.li/i/12505350',
            'https://i.gkd.li/i/12505286'
          ]
        }
      ]
    }
  ]
}

四、代码提交规范

4.1 文件结构

1. 每个应用对应一个独立的TypeScript文件
2. 文件命名使用应用ID（如cn.wps.moffice_eng.ts）
3. 文件存放在指定目录下

4.2 内容规范

1. 必须包含完整的应用元信息（id和name）
2. 每个规则组需要明确分类前缀
3. 必须提供有效的快照URL作为参考
4. 示例URL建议提供完整的广告展示截图

4.3 质量检查

1. 本地运行pnpm run check验证规则有效性
2. 确保选择器语法正确
3. 验证快照URL可访问且与规则匹配

五、高级技巧

1. 多活动处理：针对应用的不同界面分别指定activityIds
2. 延迟点击：对于需要等待的元素，可配置延迟时间
3. 复合选择器：结合多个属性提高匹配精确度
4. 排除规则：定义不应当匹配的特殊情况

六、注意事项

1. 规则分类必须使用预定义的标准分类
2. 避免使用"未分类"除非特殊情况并获得许可
3. 每个规则修改应独立提交，便于审查
4. 保持规则简洁高效，避免过度匹配

结语

通过本文的指导，您应该已经掌握了为GKD订阅项目贡献规则的全流程。从环境配置到规则编写，再到最终提交，每个步骤都需要细心和耐心。高质量的规则不仅能有效拦截广告，还能确保应用的正常功能不受影响。期待您的贡献能让整个生态更加纯净。