GKD订阅规则开发指南：从广告拦截到自动化交互

揭示规则开发的核心价值

日常应用中的广告困境

当你在通勤途中打开阅读应用，正沉浸在文章内容时，突然弹出的全屏广告打断了思路；当你在处理工作文档时，界面角落不断闪烁的推广卡片分散了注意力。这些场景不仅破坏用户体验，更降低了应用使用效率。

规则开发的实际价值

GKD订阅规则通过自动化识别和处理界面元素，实现广告拦截、弹窗关闭和界面优化，让应用回归纯粹的使用本质。一个精心编写的规则可以：

• 减少90%以上的手动操作
• 消除广告带来的注意力分散
• 提升应用加载和响应速度
• 延长设备续航时间

深入理解GKD规则引擎

规则引擎工作原理

GKD规则引擎通过监控应用界面变化，匹配预设规则并执行相应操作，其核心工作流程包括：

1. 界面监控：实时捕获应用界面元素变化
2. 规则匹配：根据选择器语法查找匹配元素
3. 动作执行：对匹配元素执行点击、滑动等操作
4. 反馈循环：根据执行结果调整后续策略

核心技术组件

组件	功能描述	技术实现
元素选择器	定位界面元素	CSS选择器语法扩展
规则解析器	解析规则定义	TypeScript类型系统
动作执行器	执行交互操作	Android无障碍服务
定时器	控制执行时机	精确时间调度系统

规则优先级机制

GKD采用多层次优先级系统确保规则正确执行：

• 应用级别：特定应用规则优先于全局规则
• 组级别：同一应用内按组定义顺序执行
• 规则级别：同一组内按规则定义顺序执行
• 匹配度：更精确的选择器优先匹配

从零开始的规则开发实践

开发环境搭建

基础环境配置

# 克隆项目仓库
git clone https://gitcode.com/gh_mirrors/gkd/GKD_subscription

# 进入项目目录
cd GKD_subscription

# 安装依赖
pnpm install

开发工具准备

• 代码编辑器：Visual Studio Code
• 辅助工具：GKD调试器、元素查看器
• 测试环境：Android设备或模拟器

规则文件结构解析

每个应用规则遵循标准化的文件结构，以cn.wps.moffice_eng.ts为例：

// 应用元信息
export default {
  id: 'cn.wps.moffice_eng',  // 应用包名
  name: 'WPS Office',        // 应用名称
  groups: [                  // 规则组集合
    // 具体规则定义
  ]
}

选择器编写基础

基础选择器类型

选择器类型	语法格式	应用场景
ID选择器	[id="com.example.ad"]	精确匹配元素ID
文本选择器	[text="关闭"]	匹配显示文本
描述选择器	[desc="广告"]	匹配元素描述
类名选择器	[class="ad-container"]	匹配元素类名

高级匹配技巧

• 模糊匹配：[text*="广告"] 匹配包含"广告"的文本
• 正则匹配：[text~=^关闭] 匹配以"关闭"开头的文本
• 复合条件：[text="关闭" && id$="ad"] 多条件同时满足

规则动作定义

规则支持多种交互动作，满足不同场景需求：

// 基础点击动作
{
  matches: '[text="关闭广告"]',
  action: 'click'  // 点击匹配元素
}

// 带延迟的点击动作
{
  matches: '[id$="ad_close"]',
  action: 'click',
  delay: 1000  // 延迟1秒执行
}

// 滑动动作
{
  matches: '[class="ad-banner"]',
  action: 'swipe',
  direction: 'left',  // 向左滑动
  distance: 300      // 滑动距离(像素)
}

场景化规则设计案例库

基础场景：简单弹窗广告

场景特征：固定位置出现的广告弹窗，带有明确关闭按钮。

解决方案：

{
  key: 1,
  name: '首页弹窗广告',
  activityIds: ['com.example.MainActivity'],
  rules: [
    {
      matches: '[text="关闭" && id$="close_btn"]',
      action: 'click',
      snapshotUrls: '规则效果截图'
    }
  ]
}

注意事项：

• 确保选择器足够精确，避免误触正常功能按钮
• 添加activityIds限制规则生效范围

中级场景：动态加载广告

场景特征：广告内容动态加载，出现时间不固定。

解决方案：

{
  key: 2,
  name: '信息流广告',
  activityIds: ['com.example.FeedActivity'],
  rules: [
    {
      matches: '[desc="广告" && class="feed-item"]',
      action: 'swipe',
      direction: 'up',
      distance: 500,
      repeat: 3,  // 重复执行3次
      interval: 2000  // 每次间隔2秒
    }
  ]
}

关键技术点：

• 使用repeat参数处理多个连续广告
• 设置合理interval等待广告加载

高级场景：复杂交互广告

场景特征：需要多步操作才能关闭的广告，如先点击关闭，再确认弹窗。

解决方案：

{
  key: 3,
  name: '两步关闭广告',
  activityIds: ['com.example.HomeActivity'],
  rules: [
    // 第一步：点击初始关闭按钮
    {
      matches: '[text="关闭广告"]',
      action: 'click',
      then: {
        // 第二步：处理确认弹窗
        matches: '[text="确认关闭"]',
        action: 'click',
        delay: 500  // 等待确认弹窗出现
      }
    }
  ]
}

实现思路：

• 使用then链式处理多步骤操作
• 合理设置延迟确保界面状态切换完成

规则质量保障体系

规则验证流程

1. 语法验证

# 运行语法检查
pnpm run check

2. 静态分析

# 执行规则静态分析
pnpm run analyze

3. 真机测试
   • 启用GKD调试模式
   • 监控规则执行日志
   • 记录元素匹配情况

常见问题诊断

规则不生效问题排查

1. 检查应用包名是否正确
2. 验证activityIds是否匹配当前界面
3. 使用调试工具确认选择器是否匹配元素
4. 检查是否存在更高优先级规则冲突

误操作风险防范

• 避免使用过于宽泛的选择器
• 对关键操作按钮添加排除规则
• 重要规则添加确认步骤

性能优化策略

• 限制规则作用范围，避免全局匹配
• 优化选择器复杂度，减少匹配计算
• 合理设置规则触发条件
• 避免不必要的重复执行

社区协作与贡献指南

规则文件规范

文件命名约定

• 采用应用包名作为文件名
• 使用小写字母和点分隔符
• 示例：com.example.app.ts

代码风格要求

• 使用TypeScript严格模式
• 遵循项目ESLint配置
• 添加必要注释说明规则意图

贡献提交流程

1. 创建分支

git checkout -b feature/add-com-example-app

2. 编写规则

   • 创建新的应用规则文件
   • 添加完整的元信息和规则组
   • 提供规则效果截图

3. 提交PR

   • 确保通过所有自动化检查
   • 填写详细的规则说明
   • 回应代码审查意见

社区最佳实践

• 规则命名规范：使用"位置-类型-描述"三段式命名
• 快照管理：为每个规则提供清晰的效果对比图
• 版本兼容：考虑不同应用版本的界面差异
• 性能考量：避免编写资源密集型规则

规则开发进阶路线

技能提升路径

1. 基础阶段

   • 掌握基本选择器编写
   • 理解规则执行流程
   • 能编写简单广告拦截规则

2. 中级阶段

   • 掌握复杂选择器组合
   • 处理动态界面和延迟加载
   • 编写多步骤交互规则

3. 高级阶段

   • 规则性能优化
   • 跨应用规则协同
   • 复杂场景解决方案设计

扩展学习资源

• 官方文档：项目内的docs/目录
• 规则示例：src/apps/目录下的优质规则
• 技术讨论：项目issue和讨论区

贡献者成长计划

• 从维护单一应用规则开始
• 参与规则审查和优化
• 开发新的规则功能和工具
• 成为特定应用领域的规则专家

通过本指南，你已经掌握了GKD订阅规则开发的核心知识和实践技巧。无论是解决个人使用中的广告困扰，还是为社区贡献通用规则，这些技能都将帮助你打造更优质的移动应用体验。记住，优秀的规则不仅要有效拦截干扰，更要确保应用功能的完整性和稳定性，这需要持续的学习和实践。