项目概览

国产安卓机的系统广告大多不在 App 里，而在系统自己的入口：桌面搜索的热榜、负一屏资讯、浏览器信息流、应用商店的轮播和签到位、各 App 的「内容与营销」通知。这些开关都在系统设置里，只是分散在十几层页面。

android-ad-cleaner 做的事很具体：用 adb 连上手机，照着机型脚本一页页点进设置，把该关的开关关掉。v0.3.0（2026-11-01）已覆盖 ColorOS、HyperOS、MagicOS、OriginOS、Flyme，以及 HarmonyOS 4.2 上部分手动审核的路径。项目只驱动系统和厂商 App 公开提供的设置项，不 root、不解锁、不刷机，系统更新照常。

开关被逐个拨掉，广告卡片随之失效

核心功能

按类别处理，不搞一刀切。 系统广告（个性化广告、OAID 广告跟踪、智能推荐服务）关的是系统设置里的开关；热搜和资讯关各 App 内的开关，浏览器切简洁首页；推广位走商店「服务管理」；营销推送按渠道关，「内容与营销」「活动优惠」关掉、订单、快递、更新通知保留。

四步走完一台机。 连手机、检测（型号、系统版本、有没有机型脚本、快应用和广告组件）、勾选要关的项、执行。桌面客户端把这套流程做成向导，插线点几下就行，不需要 Python，也不需要 AI 工具。

连接、检测、选择、执行、完成，五步一屏走完

只挂起，不卸载。 广告组件（如 com.opos.ads、com.miui.systemAdSolution）用 pm suspend 挂起，要机主点头；快应用先检测再 quickapp off 关闭。pm uninstall、pm disable-user 一律不用，system 分区也不碰。

留退路。 改动前 backup 生成快照，挂起的包和关掉的通知渠道各一条命令就能还原，App 内的开关按清单路径手动打开。

技术实现

引擎基于 uiautomator2：抓 UI 树、按文本和层级找入口再点击，所以换机型只需换脚本，不必重写引擎。每台机型对应 recipes/<品牌>-<型号>/recipe.py，记录打开哪个 App、点哪几个字、关哪些开关、留哪些。系统版本对不上时引擎会提示并跳过找不到的步骤，不会乱点。桌面客户端用 pywebview 做界面、PyInstaller 打包，Mac 版已签名并通过公证。仓库另有不连手机的引擎回归测试。

电脑读手机 UI 树、定位开关、点击；左下是改动前的快照

快速部署

不想装客户端，用 Python：

pip3 install -r requirements.txtpython3 tool/run.py devices# 看序列号、型号、有没有机型脚本python3 tool/run.py -s <序列号> check# 只读检查python3 tool/run.py -s <序列号> backup# 改动前快照python3 tool/run.py -s <序列号> recipe# 跑机型脚本python3 tool/run.py -s <序列号> chan-scan# 列营销通知渠道python3 tool/run.py -s <序列号> finish# 收尾

客户端从 Releases 下 dmg 或 exe，Windows 弹「已保护你的电脑」时点「更多信息」→「仍要运行」。

仓库信息

GitHub ：https://github.com/rddmwmddr/android-ad-cleaner

·Star：3831

·Fork：340

·License：MIT

·主语言：Python（adb + uiautomator2）

·最新版本：v0.3.0（2026-11-01）

·创建时间：2026-10-24

·已开 Issue：202

适用场景与定位

适合手上有 ColorOS、HyperOS、MagicOS、OriginOS 或 Flyme 机器的人，也适合帮家里长辈清理手机的人——客户端向导不需要命令行基础。

系统广告、营销通知、快应用、广告组件四条通道，最后都能一键回退

边界要提前知道：只支持 adb 连接的安卓设备，原生鸿蒙走 HDC，暂不支持；同一品牌系统小版本不同，页面名称和层级会变，机型不在表里就得按 docs/04 写一份脚本；作者声明结果以你的手机为准，使用风险由使用者承担。手里机型已实测通过的话，整轮常在两三分钟内跑完。