gkd 安装与首次启动：从 APK 落地到进入首页

GKD 的安装就是标准的 Android APK 安装流程，没有额外的引导配置。本页把首次启动前后会遇到的东西梳理一遍，避免在新手阶段卡住。

安装步骤

1. 从官网下载页、GitHub Releases 或 Google Play 获取 APK / 应用；
2. 若从浏览器下载 APK，安装时系统会提示「是否允许从此来源安装应用」，允许后继续；
3. 点击安装，等待完成，打开应用。

GKD 安装包只有 3MB 左右，安装过程通常几秒内完成。某些系统对非商店来源应用有额外限制（安装后无障碍开关灰色、提示受限等），这类问题的处理集中在授权无障碍分组。

首页有什么

打开 GKD 后进入应用首页，主要元素从上到下是：

• 服务状态：无障碍服务的总开关，显示当前是开启还是关闭状态，这是 GKD 是否工作的总闸；
• 常驻通知：开关后会在通知栏显示运行状态与统计数据，同时有助于系统不回收服务；
• 数据概览：汇总当前已开启的订阅数、全局规则/应用/规则组的数量、累计触发次数，以及最近一次触发命中的规则；
• 触发记录：进入日志页，查看每次规则命中的时间、应用与规则名；
• 了解 GKD：查阅规则文档和常见问题的入口。

底部导航分四个页签：首页、订阅、应用、设置。订阅页管理规则来源，应用页按应用查看规则覆盖，设置页存放触发提示、无障碍白名单、深色模式等选项。

启动后优先做的两件事

1. 授权无障碍权限：点击首页服务状态右侧的开关或「授权」按钮，按系统引导跳转到无障碍设置开启 GKD。完整流程与各系统差异见开启无障碍；
2. 接入一条订阅：GKD 不带任何规则，没有订阅它什么都做不了。进入「订阅」页添加远程订阅或自己写本地规则，操作见订阅页一览。

验证它真的在工作

配置完成后可以做个简单验证：打开任意一个带开屏广告的应用，如果规则命中，屏幕会出现一条简短的触发提示（文案可在设置里自定义），触发记录里也会新增一条日志。没命中时去触发记录对照排查，常见原因见排查速查。