手机去广告
关掉国产安卓手机系统里的广告、热搜、资讯推荐和营销推送。
介绍页：https://rddmwmddr.github.io/android-ad-cleaner/
下载桌面客户端
插上手机，点几下按钮。不需要 Python，也不需要 AI 工具。
v0.2.9 · 2026-10-30：新增 10 个社区机型脚本（OPPO Find X10 Pro Max、Find X9 Ultra、Find N5，小米 15 的 HyperOS 3 / 4 各一份，REDMI K80 Pro、K70 Pro，iQOO Z9 Turbo+、vivo V1986A，魅族 21 Pro，一加 Ace 2 安卓 15）；同一型号可按系统版本自动选脚本；华为同名渠道行再修一次；手机连接部分重构。旧版不会自动更新，0.2.7 起的客户端左下角会提示新版；请重新下载，已有备份会保留。详见 更新记录，错误日志上报说明见 这里。官网：https://ahuamiao.com/sites/other/android-ad-removal-intro.html
此前版本已处理 Windows 本地页面超时、荣耀截图越界、通知渠道误操作风险、vivo 快应用与备份问题。各 Issue 的处理范围和待验证项见 社区问题处理记录。仅支持通过 adb 连接的安卓设备，暂不支持使用 HDC 的原生鸿蒙。
不知道 Mac 是哪种芯片：左上角苹果图标 → 关于本机，「芯片」写 Apple M 开头的选 Apple 芯片。所有版本：Releases。用法：docs/08-桌面客户端.md。
| |
|---|
| 1 连接手机：插线即认出手机，内置开启 USB 调试的图文教程 | 2 检测：型号、系统版本、机型脚本、快应用、广告组件 |
| 3 选择要关的：营销通知按渠道勾选，服务类默认不勾 | 4 执行：进度条和实时日志 |
| 5 完成：每一步的结果，最后提醒关闭开发者模式 | 反馈：自动附诊断信息，一键提交 GitHub Issue |
- 不 root，不解锁，不刷机，系统更新不受影响。
- 只拨系统和 App 自带的开关。挂起广告包这一步要机主点头，一条命令可以还原。
- 搜索、负一屏卡片、应用商店的安装和更新、天气预警、快递提醒，这些功能保留。
处理哪些东西
| 类别 | 例子 | 怎么处理 |
|---|
| 系统广告 | 个性化广告、广告跟踪（OAID）、智能推荐服务 | 系统设置里的开关 |
| 热搜和资讯 | 下拉搜索的热榜、负一屏资讯、浏览器信息流 | 各 App 设置里的开关，浏览器切到简洁首页 |
| 推广位 | 商店的轮播、开屏、悬浮活动、签到福利 | 商店「服务管理」里的开关 |
| 营销推送 | 各 App 的「内容与营销」「活动优惠」通知 | 按渠道关，同一个 App 的订单、快递、更新通知保留 |
| 广告组件 | com.opos.ads、com.miui.systemAdSolution 等 | pm suspend 挂起，要机主同意 |
| 快应用 | 广告里一点就跳进去的「免安装小程序」 | quickapp 检测，quickapp off 关闭，见 docs/07-快应用.md |
不做的事
- 不卸载、不停用系统应用（
pm uninstall、pm disable-user 都不用）。
- 不改 system 分区，不装模块。
- 不替你同意任何 App 的用户协议。遇到协议页，点「取消」或「以后再说」。
- 不截账号页和手机号页。
四种用法
用法一要先在手机上打开开发者模式和 USB 调试，带截图的教程：docs/00-打开开发者模式.md。
用法一的开场白，复制给 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 | ⚠️ 营销通知命令行工具，需先人工审核清单，客户端不自动运行；用法 | 范围与路径 | 本次人工审核 79 个候选：关闭 48 个、31 个原已整体屏蔽；不代表新脚本整轮成绩 |
| 荣耀 | PNM-AN10 | MagicOS 10 | ✅ 实测通过，重跑 4 分钟 | ✅ | ✅ 26 个渠道 |
| 荣耀 | WKL-AN20 | MagicOS 11.0.0.111 / Android 17 | ⚠️ 2026-10-28 路径逐项实测，新脚本整轮待复测、用时未测；音乐需手动开页，见说明 | ✅ | ✅ 人工关闭 13 个渠道，其他渠道和总开关未变 |
| 一加 | Ace 2 Pro（PJA110） | ColorOS 14.0.0.812 / Android 14 | 源码新增：3 项个性化 + 6 项商店推广位关闭并回读 | 部分，见实测记录 | ✅ 23 个，总开关不变；天气提醒差异见实测 |
| 一加 | 13T（PKX110） | ColorOS 16.0.10.500 / Android 16 | ✅ 2026-10-28 实测：广告跟踪 76 项、商店两段、小布建议；浏览器/下拉搜索/负一屏见清单差异 | ✅ | ✅ 17 个渠道 |
| OPPO | Find N6（PLP120） | ColorOS 16.0.9 | ⚠️ 路径实测，整段待验证 | ✅ | ✅ 30 个渠道 |
| OPPO | Find X10 Pro Max（PMX110） | ColorOS 17 | — | ✅ | ✅ |
| OPPO | Find X8s（PKT110） | ColorOS 17.0.0.102(CN01) / Android 17 | ✅ 10-28 真机整段重跑通过：广告跟踪 96 项 + 搜索与建议等 12 项逐项回读确认 | ✅ | ✅ 26 个渠道 |
| OPPO | Find X9 Ultra（PMA110） | ColorOS 17.0.0.106(CN01) / Android 17 | ✅ 2026-10-29 八段整轮通过，重跑 211 秒，回读确认 173 项；见说明 |
表格反映当前脚本和验证范围。小米 10、荣耀 Magic7 Pro 等反馈已修复可定位的通用缺陷，但仍需对应真机复测；同品牌参考脚本不等于专用适配，详细记录见 更新记录。
- 可先运行通用检测；通知渠道能否安全关闭取决于系统页面和权限，部分 vivo 页面会被跳过。广告跟踪入口也随品牌变化。
- 同一个品牌，系统小版本不同，设置页的名字和层级也会变。机型脚本按型号和系统版本存放，版本对不上时引擎会提示，找不到入口的步骤会跳过，不会乱点。
- 你的机型不在表里：照 docs/04-给新机型写脚本.md 做一份，欢迎提 PR。
一次完整的流程
命令写法：
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 <序列号> 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/
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 处理范围及待验证项
清单/ 各品牌的手动清单
prompts/ 复制给聊天 AI 的提示词
tool/
run.py 总入口
fast.py 读屏、找入口、拨开关的引擎（uiautomator2）
chan_fast.py 营销通知渠道
explore.py 新机型探路（实验）
gui/ 桌面客户端（pywebview 界面 + PyInstaller 打包）
recipes/<品牌>-<型号>/recipe.py 各机型的机型脚本
images/ 文档配图
tests/ 不连接手机的引擎回归测试
反馈
遇到问题、想要新功能、希望支持你的手机，到 Issues 提交，选对应的模板。
用桌面客户端的话，点左下角「反馈问题」：会自动附上客户端版本、手机型号、系统版本和最近的日志（序列号已替换，不含应用列表和通知内容），打开 GitHub 页面后点提交即可。提交需要 GitHub 账号。
还原
见 docs/05-还原.md。挂起的包和通知渠道各一条命令；App 内的开关按清单路径手动打开。
声明
本项目只调用 Android 系统和厂商 App 公开提供的设置项。各厂商的界面随系统更新变化，使用前请备份，结果以你的手机为准。使用本项目造成的任何问题由使用者自行承担。
许可证：MIT
