gkd README

The project's README from github.com/gkd-kit/gkd. As one markdown file: README.md.

gkd

GKD.LI

基于 高级选择器 + 订阅规则 + 快照审查 的自定义屏幕点击 Android 应用

通过自定义规则,在指定界面,满足指定条件(如屏幕上存在特定文字)时,点击特定的节点或位置或执行其他操作

免责声明

本项目遵循 GPL-3.0-only 开源,项目仅供学习交流,禁止用于商业或非法用途

安装

Download from GKD.LIDownload from Google PlayDownload from GitHub releases

如遇问题请先查看 疑难解答

截图

img img img img
img img img img

订阅

GKD 默认不提供规则,需自行添加本地规则,或者通过订阅链接的方式获取远程规则

也可通过 subscription-template 快速构建自己的远程订阅

第三方订阅列表可在 https://github.com/topics/gkd-subscription 查看

要加入此列表, 需点击仓库主页右上角设置图标后在 Topics 中添加 gkd-subscription

示例图片 - 添加至 Topics (点击展开)

image

选择器

一个类似 CSS 选择器的选择器, 能联系节点上下文信息, 更容易也更精确找到目标节点

https://gkd.li/guide/selector

@[vid="menu"] < [vid="menu_container"] - [vid="dot_text_layout"] > [text^="广告"]

示例图片 - 选择器路径视图 (点击展开)

image

衍生

开发过程中的衍生项目,它们正在被 gkd 使用,也许对你有帮助

捐赠

如果 GKD 对你有用, 可以通过以下链接支持该项目

https://github.com/lisonge/sponsor

或前往 Google Play 给个好评

gkd (gkd-kit/gkd)

Searching Database…

43K ·GitHub
What is this?GKD is an Android app that taps the screen automatically: it watches for specific on-screen conditions (like certain text appearing) using Android's Accessibility service, then clicks the matching node or location based on your own custom selector rules.
Is this only the Android app, or is there a web tool too?The main product is the Android APK, but the matching engine (gkd-selector) is also compiled as a cross-platform Kotlin/JS and WebAssembly library, powering a browser-based selector tester separate from the phone app.
How do I get it running on my phone?Install the APK from the project's GitHub Releases (or Google Play), then enable GKD under Android's Accessibility settings so it's allowed to read screen content and perform taps.
Do I need to write my own automation rules?Yes by default — GKD ships with no built-in rules, so you either write local rules with its selector syntax or subscribe to a remote rule list via a subscription link; a 'subscription-template' repo helps you build your own feed.
Is there a catch with how I can use this?Its usefulness depends entirely on the rules you write or subscribe to, and the project's own license explicitly limits it to personal or educational use, prohibiting commercial or illegal use.
What are the 'quick actions' and 'skip flows' features for?Quick actions automate repetitive multi-step tasks, like auto-confirming a PC login from your phone, while skip flows auto-dismiss the annoying startup screens some apps show on launch.
What is the 'snapshot review' feature for?It captures the exact screen node hierarchy GKD saw when a rule triggered, so you can inspect, debug, and refine your selectors against real matched data.
What side projects came out of building GKD?While building GKD the team spun off several reusable libraries, including kotlin-json5, kotlin-codeorigin, android-api-diff, remap, and priv-kit.
Creator
gkd-kit
Size
7.1 MB
Stars
43K
Age
3y
Commits · 90 Days