GKD订阅规则编写完全指南：从环境搭建到规则提交
项目地址: https://gitcode.com/gh_mirrors/gkd/GKD_subscription 前言
在移动应用生态中，广告拦截一直是用户关注的焦点。GKD订阅项目通过规则定义的方式，帮助用户自动化处理应用中的各类广告和干扰元素。本文将详细介绍如何为GKD订阅项目编写有效的规则，从环境搭建到最终提交的全流程。
一、环境准备
1.1 基础设备要求
- Android设备（系统版本建议11及以上）
- 可选：电脑（用于更高效的规则编写）
1.2 开发环境配置（电脑端）
项目基于Node.js和TypeScript技术栈，需要配置以下环境：
- Node.js环境：建议安装LTS版本
- 包管理工具：推荐使用pnpm，执行效率高于npm
- 代码编辑器：Visual Studio Code是最佳选择，提供完善的TypeScript支持
安装完成后，在项目根目录执行pnpm install安装依赖。
二、快照获取与审查
2.1 设备端配置
- 在目标应用中启用无障碍权限
- 对于Android 11以下设备，需额外开启截屏服务
- 建议开启悬浮窗服务，便于快速捕获快照
2.2 快照捕获方式
有三种主要方式获取应用界面快照：
- 悬浮窗按钮：通过悬浮窗服务提供的截屏按钮
- 控制中心快捷功能：添加"捕获快照"快捷方式
- 网页审查工具：最推荐的方式，提供更全面的分析功能
2.3 网页审查工具使用
- 确保设备和电脑在同一局域网
- 在设备上启用HTTP服务
- 通过浏览器访问审查工具界面
- 安装必要的浏览器扩展以绕过安全限制
三、规则编写实战
3.1 快照分析
以WPS应用为例，分析广告元素的特征：
- 定位广告关闭按钮
- 通过审查工具查看节点属性
- 识别唯一标识符（如ID、文本内容等）
3.2 选择器编写
选择器语法类似于CSS选择器，常用模式包括：
- 精确ID匹配：
[id="com.example.ad/close"] - 后缀匹配：
[id$="/close"]（匹配以"/close"结尾的ID） - 文本匹配：
[text="关闭广告"]
3.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 文件结构
- 每个应用对应一个独立的TypeScript文件
- 文件命名使用应用ID（如
cn.wps.moffice_eng.ts） - 文件存放在指定目录下
4.2 内容规范
- 必须包含完整的应用元信息（id和name）
- 每个规则组需要明确分类前缀
- 必须提供有效的快照URL作为参考
- 示例URL建议提供完整的广告展示截图
4.3 质量检查
- 本地运行
pnpm run check验证规则有效性 - 确保选择器语法正确
- 验证快照URL可访问且与规则匹配
五、高级技巧
- 多活动处理：针对应用的不同界面分别指定activityIds
- 延迟点击：对于需要等待的元素，可配置延迟时间
- 复合选择器：结合多个属性提高匹配精确度
- 排除规则：定义不应当匹配的特殊情况
六、注意事项
- 规则分类必须使用预定义的标准分类
- 避免使用"未分类"除非特殊情况并获得许可
- 每个规则修改应独立提交，便于审查
- 保持规则简洁高效，避免过度匹配
结语
通过本文的指导，您应该已经掌握了为GKD订阅项目贡献规则的全流程。从环境配置到规则编写，再到最终提交，每个步骤都需要细心和耐心。高质量的规则不仅能有效拦截广告，还能确保应用的正常功能不受影响。期待您的贡献能让整个生态更加纯净。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
