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 отключает рекламу, горячие поисковые тренды, новостные ленты и маркетинговые push-уведомления, встроенные в китайские Android-телефоны (OPPO, OnePlus, Xiaomi, Honor, vivo). Работает без получения root-прав, любое изменение можно откатить, а ИИ-агент может запустить всё одним нажатием.
Это что-то устанавливает на мой телефон или работает с компьютера?Программа работает на компьютере и общается с телефоном через adb; на устройство ничего не устанавливается. Поддерживаются только Android-устройства, подключённые через adb, а не устройства HarmonyOS, которым нужен HDC.
Как это запустить?Проще всего через десктопный клиент: скачайте сборку для вашей ОС со страницы Releases, подключите телефон по USB с включённой отладкой USB и пройдите шаги: обнаружить, выбрать, выполнить. Есть также три других режима: ИИ-агент, который выполняет команды за вас, чат-ИИ (DeepSeek, Doubao, ChatGPT), который ведёт вас по шагам, или ручной чек-лист.
Нужно ли получать root-права или сначала ставить Python?Root-права, разблокировка загрузчика и перепрошивка не требуются, а сам десктопный клиент не нуждается ни в Python, ни в ИИ-инструментах. Для режимов с ИИ-агентом и чат-ИИ нужен ИИ-инструмент, умеющий выполнять команды, или чат-ИИ вроде DeepSeek, Doubao или ChatGPT.
Поддержка надёжная на всех этих марках телефонов?Охват сильно зависит от модели: устройства Honor PNM-AN10 и Xiaomi 18 Pro Max полностью проверены и работают со скриптами, а несколько моделей OPPO и vivo помечены как непроверенные или пока без скриптов. Если скрипт не соответствует установленной версии ОС, движок выдаёт предупреждение и пропускает шаги, которые не может найти, вместо того чтобы нажимать наугад.
Какие платформы компьютеров поддерживает десктопный клиент?Для Mac на Apple Silicon и Intel выпускаются подписанные сборки, прошедшие нотаризацию Apple, а для Windows 10/11 есть установщик и портативный zip-архив. На стороне телефона нужно только Android-устройство, доступное по adb.
Что намеренно не трогается?Поиск, экран «минус один», функции установки и обновления приложений в магазине, погодные оповещения и уведомления о доставке и заказах продолжают работать; отключаются только маркетинговые push-уведомления и рекламные компоненты.
Как именно отключаются рекламные компоненты?Известные рекламные пакеты, такие как com.opos.ads и com.miui.systemAdSolution, приостанавливаются командой pm suspend. Для этого требуется подтверждение владельца устройства, а отменить приостановку можно одной командой. Ничего не удаляется и не отключается на системном уровне.
Какие марки и модели телефонов уже тестировались?В README перечислены реальные тестовые прогоны на устройствах Honor (MagicOS), OnePlus/OPPO (ColorOS), Xiaomi (HyperOS) и vivo (OriginOS). Для каждой модели свой отдельный скрипт, потому что страницы настроек отличаются в зависимости от марки и версии ОС.
Как потом отменить изменения?Приостановленные пакеты и изменения каналов уведомлений можно вернуть каждый одной командой, она описана в docs/05-还原.md; переключатели внутри отдельных приложений нужно вернуть вручную.
Автор
rddmwmddr
Размер
29.2 MB
Звёзды
8.3K
Возраст
25 д
Коммиты · 90 дней