- Автор
- rddmwmddr
- Размер
- 29.2 MB
- Звёзды
- 8.3K
- Обновлён
- КоммитNov 17Релизv0.4.4Nov 13
- Возраст
- 25 д
- Коммиты · 90 дней
README проекта с github.com/rddmwmddr/android-ad-cleaner. Одним файлом markdown: README.md.
关掉国产安卓手机系统里的广告、热搜、资讯推荐和营销推送。
介绍页:https://rddmwmddr.github.io/android-ad-cleaner/
如果大家有其他需求可以加VX和电报群:
https://t.me/+A5X3Mxzs-Cg3NjYx
插上手机,点几下按钮。不需要 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 |
pm uninstall、pm disable-user 都不用)。
用法一要先在手机上打开开发者模式和 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 等反馈已修复可定位的通用缺陷,但仍需对应真机复测;同品牌参考脚本不等于专用适配,详细记录见 归档记录。
验证记录(按表格行序,记着每台机的实测日期、用时、回读数与已知差异)
APP_SETTINGS 直达,负一屏的个性化开关挪到了「隐私」里,见清单差异。营销通知未测。com.miui.systemAdSolution 后主题段补关 2 项,累计 18 项。已按本型号登记进 recipes/xiaomi/M154FF,本仓库未在该机复跑。手动清单见清单。营销通知 8 个第三方渠道全部关闭并回读确认(系统 App 的 msa 营销渠道是系统锁定、不可关闭)。chan-off 认不出通知页(#336),源码已按同一判据放宽认页、待报告者复测。手动清单见清单差异。--ref 安全模式实测。手动清单见清单差异。main,11-04 已在该机复测通过(#531);#530。手动清单见清单差异。chan-off 全关、复查「仍开着 0 个」。chan-off 13 条全跳过(渠道在「通知类别」子页,首层无渠道行)。手动清单见清单。
命令写法:
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