GitHub 热门项目推荐：android-ad-cleaner（Python｜6557 Star）

这个项目有什么用

android-ad-cleaner 是一个通过 adb 连接安卓手机、批量关闭系统广告与营销推送的 Python 工具。它面向国产安卓系统里那些难以找到入口的推广位：应用商店首页轮播、负一屏资讯卡片、天气里的营销内容、营销通知渠道等，用脚本代替手动一层层翻设置页。

它替代了哪些手工操作

• 手动在设置里逐个寻找并关闭广告、热搜、资讯推荐开关。
• 手动逐条筛选通知渠道，区分营销通知与服务类通知。
• 手动记录改过哪些项，以便日后还原。

典型使用场景

• 新买或新刷的 OPPO、小米、荣耀、vivo 等机型，开机后集中清理一遍推广位。
• 给家人长辈的手机做一次「去广告」，同时保留天气预警、快递提醒这类实用功能。
• 开发者或折腾用户想用 AI 智能体代劳，把仓库里的 AGENTS.md 交给 AI 执行。

适合愿意插线连电脑、能接受 adb 的普通用户和小团队；不适合完全不想接触命令行、也不愿安装桌面客户端的人。

核心特性

• 不 root、不解锁、不刷机：只调用系统和厂商 App 公开提供的设置项，不卸载也不停用系统应用，pm uninstall、pm disable-user 都不用，系统更新不受影响。
• 可还原：改动前可做快照，挂起的包和通知渠道各有一条命令可以还原。
• 按机型脚本执行：每个机型一份自动操作步骤，记录「打开哪个 App、点哪几个字进设置页、关哪几个开关、留哪几个」；版本对不上时引擎会提示，找不到入口的步骤会跳过，不会乱点。
• 营销通知按渠道关闭：可以列出营销通知渠道再选择性关闭，例如关掉天气的「内容与营销」，保留天气预警。
• 支持 AI 智能体一键执行：仓库提供 AGENTS.md 操作规范，可交给 WorkBuddy、Claude Code、Codex、Trae、Cursor 等工具执行。
• 提供桌面客户端：插上手机点几下按钮即可，不需要 Python，也不需要 AI 工具。

怎么安装

前提条件：一台可通过 adb 连接的安卓设备（暂不支持使用 HDC 的原生鸿蒙），以及本机已安装 Python 3 与 adb。README 未列出具体 Python 版本要求，官方文档未说明。

1. 克隆仓库：

   git clone https://github.com/rddmwmddr/android-ad-cleaner

2. 安装依赖：

   pip3 install -r requirements.txt

3. 在手机上开启开发者模式与 USB 调试。仓库提供带截图的分步教程 docs/00-打开开发者模式.md，装 adb、连电脑、无线调试见 docs/01-准备工作.md。
4. 如果不想用命令行，也可以直接下载桌面客户端：插上手机，点几下按钮，不需要 Python，也不需要 AI 工具。各平台安装包见 Releases 页面，用法见 docs/08-桌面客户端.md。Mac 用户需先确认芯片类型：左上角苹果图标 → 关于本机，「芯片」写 Apple M 开头的选 Apple 芯片。

怎么使用

最基础的流程是先确认设备被识别，再做只读检查，然后依次备份、跑脚本、处理通知渠道与快应用，最后收尾。README 给出的完整命令写法如下：

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  # 从电脑关闭开发者模式（最后一步，执行后断开）

进阶用法一：用 AI 智能体代劳。把下面这段开场白复制给 AI 即可：

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

进阶用法二：机型不在支持列表里时，可以照 docs/04-给新机型写脚本.md 自己写一份机型脚本并提 PR。同一个品牌系统小版本不同，设置页名字和层级也会变，脚本按型号和系统版本存放。

适用场景与注意事项

适合的场景：想在不动系统分区、不装模块的前提下集中清理推广位；希望保留搜索、负一屏卡片、应用商店的安装和更新、天气预警、快递提醒等功能；希望改动可回退。

不适合的场景：原生鸿蒙设备（仅支持 adb 连接，不支持 HDC）；不愿意插线连电脑的用户；期待一次性覆盖所有品牌所有系统版本的用户——机型脚本按型号和系统版本存放，同品牌参考脚本不等于专用适配。

• 项目不替你同意任何 App 的用户协议，遇到协议页会点「取消」或「以后再说」，也不截账号页和手机号页。
• 挂起广告包这一步需要机主确认，一条命令可以还原；App 内的开关需按清单路径手动打开，还原说明见 docs/05-还原.md。
• 各厂商界面随系统更新变化，使用前请备份，结果以你的手机为准；使用本项目造成的任何问题由使用者自行承担。
• 提交 Issue 需要 GitHub 账号；桌面客户端可一键附带诊断信息（序列号已替换，不含应用列表和通知内容）。
• 许可证为 MIT。

项目地址

仓库地址：https://github.com/rddmwmddr/android-ad-cleaner
作者/组织：rddmwmddr
介绍页：https://rddmwmddr.github.io/android-ad-cleaner/

这是一个以机型脚本为核心、强调不 root 与可还原的安卓广告清理工具，是否合用取决于你的机型和系统版本是否在支持范围内。