android-ad-cleaner README

项目的 README,来自 github.com/rddmwmddr/android-ad-cleaner。合并为一个 markdown 文件:README.md。

肉呆去广告

关掉国产安卓手机系统里的广告、热搜、资讯推荐和营销推送。

介绍页:https://rddmwmddr.github.io/android-ad-cleaner/

如果大家有其他需求可以加VX和电报群:

https://t.me/+A5X3Mxzs-Cg3NjYx

IMG_7235

下载桌面客户端

插上手机,点几下按钮。不需要 Python,也不需要 AI 工具。

v0.4.4 · 2026-11-13:这一版给一加 16 与真我 GT5 Pro 补了机型脚本,修好了长列表页只关最后一段、vivo 锁屏段一直没生效等几处问题;引擎里把各机型脚本里重复的段体与导航收成共用一份,用起来不变。0.4.1 及以前没有应用内更新,要先手动装一次 0.4.2;从 0.4.2 起可以在 App 里检查、下载并安装更新,手机版仍需在系统弹窗里确认;0.2.7 起的客户端左下角会提示新版;请重新下载,已有备份会保留。详见 更新记录,错误日志上报说明见 这里。官网:https://ahuamiao.com/sites/other/android-ad-removal-intro.html

此前版本已处理 Windows 本地页面超时、荣耀截图越界、通知渠道误操作风险、vivo 快应用与备份问题。各 Issue 的处理范围和待验证项见 社区问题处理记录。0.4.2 起 Mac / Windows 客户端也能连纯血鸿蒙手机,这条通道还没有在鸿蒙真机上复测,见 鸿蒙接入说明。

设备 下载 说明
Mac · Apple 芯片(M1 及以后) AndroidAdCleaner-0.4.4-mac-arm64.dmg 已签名、通过苹果公证,双击就能打开
Mac · Intel 芯片(macOS 11 及以上) AndroidAdCleaner-0.4.4-mac-intel.dmg 同上
Windows 10 / 11 · 安装版 AndroidAdCleaner-0.4.4-windows-setup.exe 弹「Windows 已保护你的电脑」时点「更多信息」→「仍要运行」;和旧版共用安装标识,会原地升级
Windows 10 / 11 · 免安装 AndroidAdCleaner-0.4.4-windows-portable.zip 解压后双击 AndroidAdCleaner.exe;不会替换、也不会卸载已安装的旧版
安卓手机 · 手机版(安卓 11 及以上) AndroidAdCleaner-0.4.4-android-arm64.apk 不用连电脑,安装和授权见手机版教程

不知道 Mac 是哪种芯片:左上角苹果图标 → 关于本机,「芯片」写 Apple M 开头的选 Apple 芯片。所有版本:Releases;国内下载走 Gitee,不用登录(Windows 安装版只在 GitHub 上)。国内走 Gitee 时拿到的是 Windows 免安装版,它不会替换已安装的旧版:要顶掉旧版,用安装版覆盖安装,或先在 Windows「设置」的应用列表里卸载旧的「安卓去广告」(0.3.2 及更早版本装的名字)再删掉旧快捷方式;卸载只删程序目录,数据与备份保留;免安装版启动时若发现旧版还在,也会在界面里提示一次。用法:docs/08-桌面客户端.md。

手机版是不用连电脑的安卓 App(见下面用法五):安装包在上面的表里,安装、授权与还原步骤见手机版教程;想自己构建看 android/。

连接手机
1 连接手机:插线即认出手机,内置开启 USB 调试的图文教程
检测
2 检测:型号、系统版本、机型脚本、快应用、广告组件
选择
3 选择要关的:营销通知按渠道勾选,服务类默认不勾
执行
4 执行:进度条和实时日志
完成
5 完成:每一步的结果,最后提醒关闭开发者模式
反馈
反馈:自动附诊断信息,一键提交 GitHub Issue

改之前:软件商店首页满屏推荐

改之前:OPPO 软件商店首页。轮播图、必备、必玩、福利标签,全是推广位。


处理哪些东西

类别 例子 怎么处理
系统广告 个性化广告、广告跟踪(OAID)、智能推荐服务 系统设置里的开关
热搜和资讯 下拉搜索的热榜、负一屏资讯、浏览器信息流 各 App 设置里的开关,浏览器切到简洁首页
推广位 商店的轮播、开屏、悬浮活动、签到福利 商店「服务管理」里的开关
营销推送 各 App 的「内容与营销」「活动优惠」通知 按渠道关,同一个 App 的订单、快递、更新通知保留
广告组件 com.opos.ads、com.miui.systemAdSolution 等 pm suspend 挂起,要机主同意
快应用 广告里一点就跳进去的「免安装小程序」 quickapp 检测,quickapp off 关闭,见 docs/07-快应用.md

不做的事


五种用法

用法示意

用法一要先在手机上打开开发者模式和 USB 调试,带截图的教程:docs/00-打开开发者模式.md。

用法 适合谁 要准备什么 文档
一:AI 智能体替你跑 有电脑,想省事 电脑、数据线、一个能执行命令的 AI 工具 docs/02-用AI智能体.md
二:聊天 AI 带你点 只有手机 DeepSeek、豆包、ChatGPT 任意一个 docs/03-用聊天AI.md
三:照清单手动关 想自己掌握每一步 只要手机 docs/清单/
四:桌面客户端 不想敲命令 Mac(Apple / Intel 芯片)或 Windows 10/11、数据线 下载 · 说明
五:手机版 App 不想连电脑 安卓 11 及以上、Wi-Fi;安装包在下载表里 教程

用法一的开场白,复制给 AI:

请克隆 https://github.com/rddmwmddr/android-ad-cleaner ,读仓库里的 AGENTS.md,
然后帮我给连着电脑的这台手机去广告。每一步改之前告诉我要改什么。

实测过的机型

机型脚本:一台机型的自动操作步骤,记着「打开哪个 App、点哪几个字进设置页、关哪几个开关、留哪几个」。电脑照着它在手机上点,几分钟做完。设置页因型号和系统版本而不同,所以每个机型一份。

品牌 机型(型号) 系统 脚本 清单 营销通知
魅族 21 Pro(MEIZU 21 Pro) Flyme 12.6.0.0A
Android 16
⚠️ 10-30 ✅ ✅ 8
华为 ALN-AL00 HarmonyOS 4.2.0.223
Android 12
⚠️ ✅ ⚠️ 48
荣耀 PNM-AN10 MagicOS 10 ✅ ✅ ✅ 26
荣耀 WKL-AN20 MagicOS 11.0.0.111
Android 17
⚠️ 10-28 ✅ ✅ 13
荣耀 Magic V Flip2(CLE-AN00) MagicOS 10.0.0.175
Android 16
✅ 11-07 ✅ ✅ 3
一加 15T(PLZ110) ColorOS 17.0.0.107
Android 17
⚠️ 11-08 部分 ✅
一加 Ace 2 Pro(PJA110) ColorOS 14.0.0.812
Android 14
⚠️ 部分 ✅ 23
一加 Ace 2 Pro(PJA110) ColorOS 16.0.5.1201
Android 16
⚠️ 部分 —
一加 13T(PKX110) ColorOS 16.0.10.500
Android 16
✅ 10-28 ✅ ✅ 17
一加 Ace 6T(PLR110) ColorOS 17.0.0.101
Android 17
✅ 10-31 ✅ —
一加 一加 16(PYB110) ColorOS 17.0.0.157
Android 17
✅ 11-15 ✅ —
OPPO Find N6(PLP120) ColorOS 16.0.9 ⚠️ ✅ ✅ 30
OPPO Find X8s(PKT110) ColorOS 17.0.0.102
Android 17
✅ 10-28 ✅ ✅ 26
OPPO Find X9 Ultra(PMA110) ColorOS 17.0.0.106
Android 17
✅ 10-29 ✅ ✅ 6
OPPO Find X9 Pro(PLG110) ColorOS 16.0.10.501
Android 16
✅ 11-01 ✅ ✅ 60
OPPO Find X10 Pro Max(PMX110) ColorOS 17.0.0.116
Android 17
✅ 11-07 部分 ✅ 3
OPPO Find X9 Ultra(PMA120) ColorOS 16.0.10 ❌ 部分 ✅ 27
OPPO Find N3 典藏版(PHN110) ColorOS 16.0.5 ❌ 部分 ✅ 27
OPPO Find N5(PKH110) ColorOS 17.0.0.103
Android 17
✅ 10-29 ✅ ✅ 42
小米 18 Pro Max(M154FF) HyperOS 4.0.24 ✅ 11-07 ✅ ✅
小米 17 Ultra 标准版(2512BPNDAC) HyperOS OS4.0.5.0.XPACNXM
Android 17
✅ 10-28 ✅ ✅ 1
小米 17(25113PN0EC) HyperOS 4
Android 17
— ✅ ✅
小米 15(24129PN74C) HyperOS OS4.0.0.22.XOCCNXM
Android 17
✅ 10-29 ✅ —
小米 13 Ultra(2304FPN6DC) HyperOS OS3.0.308
Android 16
✅ 10-28 ✅ —
小米 14 Pro(23116PN5BC) HyperOS OS3.0.308.0.WNBCNXM
Android 16
⚠️ 10-29 ✅ ✅ 60
小米 Pad 7(2410CRP4CC) HyperOS OS2.0.208
Android 15
✅ 10-28 ✅ —
小米 REDMI K80 至尊版(25060RK16C) HyperOS 2
Android 16
✅ 10-27 ✅ ✅ 3
小米 15(24129PN74C) HyperOS OS3.0.307.0.WOCCNXM
Android 16
⚠️ 10-29 ✅ ✅ 17
小米 REDMI K90 Pro Max(25102RKBEC) HyperOS OS4.0.2.0.XPMCNXM
Android 17
✅ 10-27 ✅ ✅ 26
小米 REDMI K90 Ultra(M332BF) HyperOS OS4.0.4.0.XHPCNXM
Android 17
⚠️ 10-31 ✅ ✅ 19
小米 REDMI K90(2510DRK44C) HyperOS OS4.0.5.0.XPKCNXM
Android 17
⚠️ 11-10 ✅ ✅ 8
小米 MIX Flip 2(2505APX7BC) HyperOS
Android 16
⚠️ 11-05 ✅ ✅ 22
小米 REDMI K80 Pro(24122RKC7C) HyperOS OS3.0.304.0.WOMCNXM
Android 16
✅ 10-29 ✅ ✅ 48
小米 Redmi Note 14 Pro(24090RA29C) HyperOS 3.0.309.0
Android 16
✅ 10-26 ✅ ✅ 11
小米 Redmi Note 14 5G(24094RAD4C) HyperOS OS3.0.306.0.WOQCNXM
Android 16
✅ 10-30 ✅ ✅ 3
小米 Redmi Note 13(23124RA7EO) HyperOS OS2.0.213.0.VNHRUXM
Android 15
— ✅ —
Redmi Note 12 Turbo(23049RAD8C) HyperOS OS3.0.5.0 ✅ ✅ ✅
Redmi K70(23113RKC6C) HyperOS 3.0.307.0
Android 16
⚠️ ✅ —
Redmi K70 Pro(23117RK66C) HyperOS OS3.0.306.0.WNMCNXM
Android 16
✅ 10-30 ✅ ✅ 17
vivo X300 Ultra(V2547DA) OriginOS 6 ✅ 10-28 ✅ ✅
vivo X300 Ultra(V2547DA) Android 17 ✅ 11-07 ✅ —
vivo X Fold6(V2545A) OriginOS 6 Fold
Android 16
✅ 部分 ⚠️
vivo(iQOO) V2324HA Android 16 ✅ 10-27 ✅ ⚠️ 3
vivo V2361A OriginOS 16 ⚠️ 10-26 ✅ —
vivo(iQOO) V1986A Funtouch OS 13.0
Android 12
✅ 10-30 ✅ ⚠️ 8
vivo V2417A OriginOS 6
Android 16
✅ 10-30 ✅ ✅ 5
vivo X300 Ultra(V2547A) OriginOS 7 ✅ 10-25 ✅ ⚠️
vivo(iQOO) Z11 Turbo(V2536A) OriginOS 6
Android 16
— ✅ —
vivo V2309A OriginOS 6
Android 16
✅ 11-03 ✅ —
vivo V2303A OriginOS 7
Android 17
⚠️ 11-04 ✅ —
一加 Ace 2(PHK110) ColorOS 16.0.5
Android 16
✅ 10-25 ✅ ⚠️ 11
一加 Ace 2(PHK110) ColorOS 15.0.0.601
Android 15
⚠️ 10-29 部分 —
realme GT Neo5 SE(RMX3700) ColorOS 16.0.5.1300
Android 16
✅ 11-02 ✅ —
realme 真我 GT5 Pro(RMX3888) ColorOS 15.0.0.420
Android 15
⚠️ ✅ ✅ 12
三星 Galaxy Note10+ 5G(SM-N9760) One UI 4
Android 12
⚠️ 11-05 ✅ ⚠️ 10

符号:✅ 真机跑通;⚠️ 只跑到部分段落、待复测,营销通知列还表示有渠道没关;❌ 未适配;— 无专用脚本、没有渠道,或这一项没跑过。清单列的「部分」表示有专属清单但要手动补几项。脚本列的日期是最近一次真机实测,没有日期表示只做了路径级核对;每份脚本的覆盖度与证据来源另记在 recipes/verified.toml,python3 tool/verify_ledger.py 可列。营销通知列是最后确认关闭的渠道数,✅ 不带数字表示当时没记数。

表格反映当前脚本和验证范围。小米 10、荣耀 Magic7 Pro 等反馈已修复可定位的通用缺陷,但仍需对应真机复测;同品牌参考脚本不等于专用适配,详细记录见 归档记录。

验证记录(按表格行序,记着每台机的实测日期、用时、回读数与已知差异)


一次完整的流程

处理流程

命令写法:

pip3 install -r requirements.txt
python3 tool/run.py devices                 # 看序列号、型号、有没有机型脚本
python3 tool/run.py -s <序列号> check        # 只读检查
python3 tool/run.py -s <序列号> backup       # 改动前快照
python3 tool/run.py -s <序列号> suspend <包…> # 可选:机主同意后挂起广告组件,要排在跑机型脚本之前
python3 tool/run.py -s <序列号> recipe       # 跑机型脚本
python3 tool/run.py -s <序列号> chan-scan    # 列营销通知渠道
python3 tool/run.py -s <序列号> chan-off backups/<型号>-<时间>/channels.tsv
python3 tool/run.py -s <序列号> quickapp     # 检测快应用;quickapp off 关闭
python3 tool/run.py -s <序列号> finish       # 收尾,提醒关闭开发者模式
python3 tool/run.py -s <序列号> dev-off --yes  # 从电脑关闭开发者模式(最后一步,执行后断开)

营销通知渠道关掉后的样子

营销通知按渠道关:天气的「内容与营销」关掉,天气预警保留。


仓库结构

AGENTS.md            给用户侧 AI 智能体的操作手册(产品契约)
CHANGELOG.md         本版起的变更记录(一条一行);详细历史见 docs/归档/
docs/
  00-打开开发者模式.md 带截图的分步教程
  01-准备工作.md      装 adb、连电脑、无线调试
  02-用AI智能体.md    WorkBuddy、Claude Code、Codex、Trae、Cursor
  03-用聊天AI.md      DeepSeek、豆包、ChatGPT
  04-给新机型写脚本.md
  05-还原.md
  06-常见问题.md
  07-快应用.md        什么是快应用、怎么检测和关闭
  08-桌面客户端.md     Mac / Windows 客户端的用法、数据位置、打包
  09-社区问题处理.md   Issue / PR 处理范围及待验证项
  清单/               各品牌的手动清单
  手机版教程/         手机版(APK)的分步教程:截图 + 视频
prompts/             复制给聊天 AI 的提示词
tool/
  run.py             总入口
  fast.py            读屏、找入口、拨开关的引擎(uiautomator2)
  chan_fast.py       营销通知渠道
  explore.py         新机型探路(实验)
gui/                 桌面客户端(pywebview 界面 + PyInstaller 打包)
android/             手机版 APK(引擎与桌面版同一份,界面是 Compose)
recipes/<家族>/<型号>/<型号>.toml   各机型的机型脚本
images/              文档配图
tests/               不连接手机的引擎回归测试

反馈

遇到问题、想要新功能、希望支持你的手机,到 Issues 提交,选对应的模板。

用桌面客户端的话,点左下角「反馈问题」:会自动附上客户端版本、手机型号、系统版本和最近的日志(序列号已替换,不含应用列表和通知内容),打开 GitHub 页面后点提交即可。提交需要 GitHub 账号。

还原

见 docs/05-还原.md。挂起的包和通知渠道各一条命令;App 内的开关按清单路径手动打开。

声明

本项目只调用 Android 系统和厂商 App 公开提供的设置项。各厂商的界面随系统更新变化,使用前请备份,结果以你的手机为准。使用本项目造成的任何问题由使用者自行承担。

许可证:MIT

android-ad-cleaner (rddmwmddr/android-ad-cleaner)

正在搜索数据库…

这是什么?AndroidAdCleaner 可以关闭国产安卓手机(OPPO、一加、小米、荣耀、vivo)内置的广告、热搜榜单、资讯信息流以及营销类推送通知。无需 root,所有改动都可以撤销,还能通过 AI 智能体一键驱动。
这个工具会在我的手机上安装任何东西吗,还是在电脑上运行?它在电脑上运行,通过 adb 与手机通信;不会在设备上安装任何东西。它只支持通过 adb 连接的安卓设备,不支持依赖 HDC 的鸿蒙设备。
我该怎么让它跑起来?最简单的方式是使用桌面客户端:从 Releases 下载对应操作系统的版本,用 USB 线连接手机并开启 USB 调试,然后依次点击“检测”、“选择”和“执行”。此外还有另外三种方式:由 AI 智能体替你执行命令、由聊天 AI(DeepSeek、豆包、ChatGPT)一步步指导你操作,或者按手动清单逐项完成。
我需要给手机 root 或先安装 Python 吗?不需要 root、解锁或刷机,桌面客户端本身也无需 Python 或任何 AI 工具。AI 智能体模式和聊天 AI 模式则分别需要能执行命令的 AI 工具,或 DeepSeek、豆包、ChatGPT 等聊天 AI。
这些手机品牌的支持都稳定吗?不同机型的支持程度差异很大:荣耀 PNM-AN10 和小米 18 Pro Max 等设备已完整验证,脚本可正常工作;而多款 OPPO 和 vivo 机型被标记为未验证,或仍缺少脚本。若脚本与已安装的系统版本不匹配,引擎会发出警告,并跳过无法定位的步骤,而不会盲目点击。
桌面客户端支持哪些电脑平台?提供经过 Apple 公证和签名的版本,适用于 Apple 芯片和 Intel 芯片的 Mac;Windows 10/11 则提供安装程序和免安装的便携压缩包。手机端只需是能通过 adb 连接的安卓设备即可。
哪些内容是刻意保留不动的?搜索、负一屏、应用商店的安装和更新功能、天气预警,以及快递和订单通知都会继续正常工作;只会关闭营销推送和广告组件。
广告组件究竟是怎样被关闭的?像 com.opos.ads 和 com.miui.systemAdSolution 这类已知广告包,会通过 pm suspend 被暂停。这需要设备所有者确认,并且只需一条命令即可撤销;系统层面不会卸载或禁用任何东西。
目前测试过哪些手机品牌和机型?README 中列出了在荣耀(MagicOS)、一加/OPPO(ColorOS)、小米(HyperOS)和 vivo(OriginOS)设备上的实际测试记录。由于不同品牌和系统版本的设置页面各不相同,每个机型都对应单独的脚本。
以后怎么撤销这些改动?被暂停的软件包和通知渠道的改动,都可以各用一条命令还原,具体步骤记录在 docs/05-还原.md 中;应用内部的开关则需要手动切回。
作者
rddmwmddr
大小
29.2 MB
星标
8.3K
时长
25天
提交 · 90 天