关掉国产安卓手机系统里的广告、热搜、资讯推荐和营销推送。不 root，可还原，支持 AI 智能体一键执行。

Android 广告清理器 — 项目功能

一款工具，用于关闭中国安卓手机（如OPPO、小米、荣耀、vivo、一加）内置的广告、热搜、新闻推送和营销通知。

核心方法

无需root、无需解锁引导加载程序、无需刷机 — 系统更新仍可正常进行。
仅翻转系统和应用在其自身设置中已暴露的开关。
挂起广告包（如 com.opos.ads 或 com.miui.systemAdSolution）需要您的明确确认，并可通过一条命令撤销。
保留有用功能：搜索、主屏幕卡片、应用商店安装/更新、天气警报、快递提醒。

目标内容

类别	示例	处理方式
系统广告	个性化广告、广告跟踪（OAID）、智能推荐服务	系统设置中的开关
热搜与新闻	搜索页热搜列表、负一屏新闻、浏览器信息流	各应用设置中的开关；浏览器切换为简洁主页
推广位	商店轮播、启动屏、悬浮活动、签到奖励	商店“服务管理”中的开关
营销通知	“内容与营销”、“促销”通知	按渠道关闭 — 同一应用中的订单、快递和更新通知保持开启
广告组件	`com.opos.ads`、`com.miui.systemAdSolution`	通过 `pm suspend` 挂起（需您的同意）
快应用	点击广告时启动的迷你应用	通过 `quickapp off` 检测并禁用

拒绝执行的操作

不会卸载或禁用系统应用（不使用 pm uninstall、不使用 pm disable-user）。
不会修改系统分区或安装模块。
不会代表您接受任何应用的用户协议 — 如果出现同意页面，将取消或推迟。
不会截取账户页面或手机号码页面的截图。

四种使用方式

AI代理为您执行 — 需要电脑、USB数据线和能执行命令的AI工具。
聊天AI指导 — 仅手机；适用于DeepSeek、豆包或ChatGPT。
手动清单 — 仅手机；按品牌逐步操作。
桌面客户端 — Mac（Apple或Intel芯片）或Windows 10/11；连接手机并点击按钮。无需Python或AI工具。

桌面客户端（v0.2.3）

提供Mac（Apple Silicon和Intel）的签名、公证DMG，以及Windows的安装程序或便携ZIP。
工作流程：连接手机 → 检测（型号、操作系统版本、脚本、快应用、广告组件） → 选择要关闭的内容（按渠道的营销通知；服务通知默认不勾选） → 运行并显示进度条和实时日志 → 查看结果并提醒禁用开发者模式。
反馈按钮自动附加诊断信息（客户端版本、手机型号、操作系统版本、最近日志 — 序列号已替换，不包含应用列表或通知内容）并打开GitHub问题。
已知限制：仅支持通过adb连接的Android设备；不支持HarmonyOS NEXT（HDC）。

已测试设备

项目维护设备脚本 — 针对特定手机型号的自动化逐步说明，记录要打开的应用、要点击的菜单项、要翻转的开关以及要保留的开关。这些是必需的，因为设置页面因型号和操作系统版本而异。

已测试：荣耀PNM-AN10（MagicOS 10）、一加Ace 2 Pro（ColorOS 14）、OPPO Find N6 / Find X10 Pro Max / Find X9 Ultra / Find N3（ColorOS 16/17）、小米18 Pro Max（HyperOS 4.0）、vivo X300 Ultra（OriginOS 6）。有些已完全验证，有些部分验证 — README中标记了每个的状态。

如果您的手机未列出，您可以按照指南为其编写脚本并提交拉取请求。

命令行流程

对于熟悉终端的用户，完整流程如下：

pip3 install -r requirements.txt
python3 tool/run.py devices                 # 列出已连接的手机，检查脚本
python3 tool/run.py -s <serial> check        # 只读检查
python3 tool/run.py -s <serial> backup       # 更改前快照
python3 tool/run.py -s <serial> recipe       # 运行设备脚本
python3 tool/run.py -s <serial> chan-scan    # 列出营销通知渠道
python3 tool/run.py -s <serial> chan-off backups/<model>-<time>/channels.tsv
python3 tool/run.py -s <serial> quickapp     # 检测快应用；`quickapp off` 禁用
python3 tool/run.py -s <serial> finish       # 收尾，提醒禁用开发者模式
python3 tool/run.py -s <serial> dev-off --yes  # 从电脑禁用开发者模式（最后一步）

安全与恢复

更改前，会进行备份快照。
挂起的包和通知渠道均可通过一条命令恢复。
应用内开关通过遵循清单路径手动恢复。
工具跳过找不到的步骤，而不是盲目点击。
如果屏幕阅读器服务冲突（例如GKD或自动记账应用），工具会检测到，重试一次，如果仍被阻止，则提供恢复步骤并跳过。

许可证

MIT。项目声明仅使用Android和厂商应用公开暴露的设置；用户应在使用前备份并自行承担结果责任。

项目结构（关键部分）

tool/run.py — 主入口点
tool/fast.py — 读取屏幕、查找菜单项、翻转开关的引擎（使用uiautomator2）
recipes/<brand>-<model>/recipe.py — 每台设备的自动化脚本
gui/ — 桌面客户端（pywebview + PyInstaller）
docs/ — 教程、故障排除、恢复指南、快应用说明
prompts/ — 为聊天AI准备的现成提示词
AGENTS.md — AI代理的操作规则

rddmwmddr/android-ad-cleaner