关掉国产安卓手机系统里的广告、热搜、资讯推荐和营销推送。
介绍页:https://rddmwmddr.github.io/android-ad-cleaner/
如果大家有其他需求可以加VX和电报群:
https://t.me/+A5X3Mxzs-Cg3NjYx
插上手机,点几下按钮。不需要 Python,也不需要 AI 工具。
v0.4.1 · 2026-11-09:这一版修「结果显示成功、开关没关上」:段落没走完、开关拨不动、手机锁屏,现在都记成未完成,结果页可以重试没做成的步骤。手机版执行时屏幕保持常亮,没插电也不会中途锁屏。新增红米 K90 Ultra、小米 MIX Flip 2、一加 15T 三个机型脚本。旧版不会自动更新,0.2.7 起的客户端左下角会提示新版;请重新下载,已有备份会保留。详见 更新记录,错误日志上报说明见 这里。官网:https://ahuamiao.com/sites/other/android-ad-removal-intro.html
此前版本已处理 Windows 本地页面超时、荣耀截图越界、通知渠道误操作风险、vivo 快应用与备份问题。各 Issue 的处理范围和待验证项见 社区问题处理记录。仅支持通过 adb 连接的安卓设备,暂不支持使用 HDC 的原生鸿蒙。
| 设备 | 下载 | 说明 |
|---|---|---|
| Mac · Apple 芯片(M1 及以后) | AndroidAdCleaner-0.4.1-mac-arm64.dmg | 已签名、通过苹果公证,双击就能打开 |
| Mac · Intel 芯片(macOS 11 及以上) | AndroidAdCleaner-0.4.1-mac-intel.dmg | 同上 |
| Windows 10 / 11 · 安装版 | AndroidAdCleaner-0.4.1-windows-setup.exe | 弹「Windows 已保护你的电脑」时点「更多信息」→「仍要运行」;和旧版共用安装标识,会原地升级 |
| Windows 10 / 11 · 免安装 | AndroidAdCleaner-0.4.1-windows-portable.zip | 解压后双击 AndroidAdCleaner.exe;不会替换、也不会卸载已安装的旧版 |
| 安卓手机 · 手机版(安卓 11 及以上) | AndroidAdCleaner-0.4.1-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 |
- 不 root,不解锁,不刷机,系统更新不受影响。
- 只拨系统和 App 自带的开关。挂起广告包这一步要机主点头,一条命令可以还原。
- 搜索、负一屏卡片、应用商店的安装和更新、天气预警、快递提醒,这些功能保留。
改之前:OPPO 软件商店首页。轮播图、必备、必玩、福利标签,全是推广位。
| 类别 | 例子 | 怎么处理 |
|---|---|---|
| 系统广告 | 个性化广告、广告跟踪(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 智能体替你跑 | 有电脑,想省事 | 电脑、数据线、一个能执行命令的 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 |
✅ | ✅ 8 | |
| 华为 | ALN-AL00 | HarmonyOS 4.2.0.223 Android 12 |
✅ | ||
| 荣耀 | PNM-AN10 | MagicOS 10 | ✅ | ✅ | ✅ 26 |
| 荣耀 | WKL-AN20 | MagicOS 11.0.0.111 Android 17 |
✅ | ✅ 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 |
部分 | ✅ | |
| 一加 | Ace 2 Pro(PJA110) | ColorOS 14.0.0.812 Android 14 |
部分 | ✅ 23 | |
| 一加 | 13T(PKX110) | ColorOS 16.0.10.500 Android 16 |
✅ 10-28 | ✅ | ✅ 17 |
| 一加 | Ace 6T(PLR110) | ColorOS 17.0.0.101 Android 17 |
✅ 10-31 | ✅ | — |
| 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 |
✅ | ✅ 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 |
✅ | ✅ 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 |
✅ | ✅ 19 | |
| 小米 | MIX Flip 2(2505APX7BC) | HyperOS Android 16 |
✅ | ✅ 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 | ✅ | |
| vivo | V2361A | OriginOS 16 | ✅ | — | |
| vivo(iQOO) | V1986A | Funtouch OS 13.0 Android 12 |
✅ 10-30 | ✅ | |
| 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 |
✅ | — | |
| 一加 | Ace 2(PHK110) | ColorOS 16.0.5 Android 16 |
✅ 10-25 | ✅ | |
| 一加 | Ace 2(PHK110) | ColorOS 15.0.0.601 Android 15 |
部分 | — | |
| realme | GT Neo5 SE(RMX3700) | ColorOS 16.0.5.1300 Android 16 |
✅ 11-02 | ✅ | — |
| 三星 | Galaxy Note10+ 5G(SM-N9760) | One UI 4 Android 12 |
✅ |
符号:✅ 真机跑通;
表格反映当前脚本和验证范围。小米 10、荣耀 Magic7 Pro 等反馈已修复可定位的通用缺陷,但仍需对应真机复测;同品牌参考脚本不等于专用适配,详细记录见 归档记录。
- 可先运行通用检测;通知渠道能否安全关闭取决于系统页面和权限,部分 vivo 页面会被跳过。广告跟踪入口也随品牌变化。
- 同一个品牌,系统小版本不同,设置页的名字和层级也会变。机型脚本按型号和系统版本存放,版本对不上时引擎会提示,找不到入口的步骤会跳过,不会乱点。
- 你的机型不在表里:照 docs/04-给新机型写脚本.md 做一份,欢迎提 PR。
验证记录(按表格行序,记着每台机的实测日期、用时、回读数与已知差异)
- 魅族 21 Pro(MEIZU 21 Pro):10-30 真机分段验证目标均已关闭;浏览器与应用商店两段改过待复测;从开启状态自动关闭待验证,其他版本停止。营销通知本机关闭 8 个营销渠道。
- 华为 ALN-AL00:脚本列讲的是营销通知命令行工具,需先人工审核清单,客户端不自动运行,用法;手动清单见范围与路径。营销通知本次人工审核 79 个候选:关闭 48 个、31 个原已整体屏蔽,不代表新脚本整轮成绩。
- 荣耀 PNM-AN10:实测通过,重跑 4 分钟。营销通知 26 个渠道。
- 荣耀 WKL-AN20:2026-10-28 路径逐项实测,新脚本整轮待复测、用时未测;音乐需手动开页,见说明。营销通知人工关闭 13 个渠道,其他渠道和总开关未变。
- 荣耀 Magic V Flip2(CLE-AN00):2026-11-07 电脑整轮 325 秒、13 段 12 段完成(主题未同意协议跳过);手机版 2 分 20 秒,负一屏在后台屏上进不去,也跳过。营销通知关 3 个渠道,复查仍开着 0 个。
- 一加 15T(PLZ110):2026-11-08 贡献者真机七段分段核对;专用脚本整轮未验证,商店标题匹配待 #861。手动清单只覆盖部分,见清单。营销通知本轮人工确认清单,其他渠道及总开关未变。
- 一加 Ace 2 Pro(PJA110):源码新增 3 项个性化 + 6 项商店推广位关闭并回读,没有真机整轮记录。手动清单部分,见实测记录。营销通知关闭 23 个,总开关不变;天气提醒差异见实测。
- 一加 13T(PKX110):2026-10-28 实测:广告跟踪 76 项、商店两段、小布建议;浏览器/下拉搜索/负一屏见清单差异。营销通知 17 个渠道。
- 一加 Ace 6T(PLR110):2026-10-31 贡献者真机九段全跑 224 秒;本仓库无该机型,未复测,见清单差异。营销通知未测。
- OPPO Find N6(PLP120):路径实测,整段待验证。营销通知 30 个渠道。
- OPPO Find X8s(PKT110):10-28 真机整段重跑通过:广告跟踪 96 项 + 搜索与建议等 12 项逐项回读确认。营销通知 26 个渠道。
- OPPO Find X9 Ultra(PMA110):2026-10-29 八段整轮通过,重跑 211 秒,回读确认 173 项;见说明。营销通知独立关闭并回读 6 个营销渠道,其他原有渠道及总开关未变。
- OPPO Find X9 Pro(PLG110):2026-11-01 九段逐项实测通过,回读确认 165 项;见说明。营销通知 60 个营销渠道全部关闭并回读确认(0 遗留)。
- OPPO Find X10 Pro Max(PMX110):社区实测 2026-11-05 八段整轮 540 秒、退出码 0(该机当时未装游戏中心);2026-11-06 同机按段提速(游戏中心当天已装):广告跟踪 1623→41 秒、游戏中心由失败转为 27 秒、视频 31→22 秒、负一屏 41→38 秒;2026-11-07 从开启状态整轮 485 秒,实际调整 15 项、回读 46 项,退出码 1 只因负一屏段读不到轮播单选(#801);本仓库未复跑;见说明。手动清单要保留搜索数据源、消息通知与卡片。营销通知本次独立关闭 3 个,总开关未变。
- OPPO Find X9 Ultra(PMA120):页面和 N6 不同,待补。营销通知 27 个渠道。
- OPPO Find N3 典藏版(PHN110):待补。营销通知 27 个渠道。
- OPPO Find N5(PKH110):2026-10-29 七段实测通过,重跑 144 秒;负一屏需手动(设置页受权限保护)。营销通知 42 个渠道。
- 小米 18 Pro Max(M154FF):2026-11-07 九段全过(设置页改直达,150 → 97 秒);浏览器段不再依赖首页,后台屏也能跑;见说明。
- 小米 17 Ultra 标准版(2512BPNDAC):10-28 九段实测通过,重跑 176 秒。营销通知 1 个渠道(商店「其他」)。
- 小米 17(25113PN0EC):无专用脚本。手动清单见清单。营销通知本机没有营销渠道,1 个候选属服务类,已跳过。
- 小米 15(24129PN74C)· HyperOS OS4.0.0.22.XOCCNXM:10-29 九段实测通过,重跑 164 秒。营销通知未跑。
- 小米 13 Ultra(2304FPN6DC):10-28 九段通过,复跑 3 分 16 秒。营销通知未跑。
- 小米 14 Pro(23116PN5BC):10-29 社区实测,与 13 Ultra 共用脚本:安全模式下九段跑通、275 秒、19 项关闭并回读;浏览器「搜索设置」未命中,正常模式整轮待复测。营销通知 60 个渠道(64 候选,人工剔除 4 条服务类)。
- 小米 Pad 7(2410CRP4CC):10-28 四段通过,复跑 61 秒。营销通知未跑。
- 小米 REDMI K80 至尊版(25060RK16C):底包 BP2A.250605.031.A3;10-27 真机九段通过,重跑 3 分钟。营销通知 3 个渠道。
- 小米 15(24129PN74C)· HyperOS OS3.0.307.0.WOCCNXM:10-29 路径逐项实测、开关已实际关闭;新脚本整轮待复测、用时未测,底包同 K80 但浏览器/商店入口不同。营销通知 17 个渠道,全部关闭。
- 小米 REDMI K90 Pro Max(25102RKBEC):10-27 九段实测通过,重跑 169 秒。营销通知 26 个渠道。
- 小米 REDMI K90 Ultra(M332BF):10-31 社区实测,@Sin1ery 本机九段跑通、复跑 179 秒、0 调整;按他的实测规格重写、本仓库未复跑,待其复测,见实测记录。手动清单见清单。营销通知 19 个渠道(21 候选,剔除 2 条服务类)。
- 小米 MIX Flip 2(2505APX7BC):底包 BP2A.250605.031.A3;11-05 社区实测(合盖外屏):该机借同底包参考脚本跑通六段,主题 / 浏览器 / 天气 / 日历四处入口不同;专用脚本按该机实测路径写成、本仓库未复跑、用时未测,待其复测,见说明。手动清单见清单。营销通知关闭 22 个渠道,复查仍开着 0 个。
- 小米 REDMI K80 Pro(24122RKC7C):10-29 九段实测,首轮关 20 项,复跑 172 秒;实测记录。营销通知 48 个渠道(54 候选)。
- 小米 Redmi Note 14 Pro(24090RA29C):10-26 八段实测通过,整轮约 5 分钟。营销通知 11 个渠道。
- 小米 Redmi Note 14 5G(24094RAD4C):10-30 八段实测:20 项新关闭(记账修复前统计,不含普通点击关掉的 4 项),复跑 291 秒、21 项回读、调整 0 项。营销通知 3 个渠道,全部关闭。
- 小米 Redmi Note 13 海外版 / 俄区(23124RA7EO):无专用脚本,界面是俄语,引擎按中文找不到入口。手动清单见清单(11-01 社区实测,adb + 手动)。营销通知未跑。
- Redmi Note 12 Turbo(23049RAD8C):实测通过,九段 3.5 分钟。
- Redmi K70(23113RKC6C):9 段专用脚本,目标 20 项;实测记录。营销通知未测。
- Redmi K70 Pro(23117RK66C):10-30 九段整轮 235 秒,25 项回读、0 调整、0 异常;实测记录。营销通知 17 个渠道,其他已有渠道和总开关不变。
- vivo X300 Ultra(V2547DA)· OriginOS 6:2026-10-28 实测通过,七段全通(124 秒);见适配说明。
- vivo X300 Ultra(V2547DA)· Android 17(PD2547D_A_17.1.10.2.W10):2026-11-07 七段全过(设置页改直达,91 → 62 秒);商店「个性化推荐」页仍按位置点、不靠标题(#220);见适配说明。手动清单见清单差异。营销通知未测。
- vivo X Fold6(V2545A):实测通过,7 段 121 秒(合上外屏)。手动清单部分(负一屏、i 管家需手动)。营销通知仅 1 条候选,应用级开关已跳过。
- vivo(iQOO)V2324HA:原系统(PD2324J_A_16.2.13.1.W10);2026-10-27 实测,七段全通,重跑 2.5 分钟。营销通知 5 个渠道,关 3 个、跳过 1 个。
- vivo V2361A:系统 OriginOS 16(PD2361B_A_16.2.12.2.W10);2026-10-26 路径逐页实测、开关已实际关闭,引擎整段待验证。
- vivo(iQOO)V1986A:系统 Funtouch OS 13.0 / Android 12(PD1986_A_8.21.29);2026-10-30 三段实测通过,重跑 55 秒。营销通知 11 个营销渠道人工关 8 个;本机
chan-off认不出通知页(#336),源码已按同一判据放宽认页、待报告者复测。手动清单见清单差异。 - vivo V2417A:系统 OriginOS 6 / Android 16(PD2417D_A_16.2.14.1.W10);社区实测 10-30 八段整段跑通、回读核对 32 项、幂等复跑 179 秒;11-02 浏览器升到 31.3.0.0 后入口变了,改走「我的 → 设置」,八段仍通过;维护方未在本机复跑;适配说明。营销通知通用流程关闭 5 个明确营销渠道。
- vivo X300 Ultra(V2547A):2026-10-25 实测通过,重跑 126 秒。营销通知只有应用级总开关。
- vivo(iQOO)Z11 Turbo(V2536A):系统 OriginOS 6 / Android 16(PD2536B_A_16.0.12.8.W10);无专用脚本,用
--ref安全模式实测。手动清单见清单差异。 - vivo V2309A:系统 OriginOS 6 / Android 16(PD2309E_A_16.2.15.0.W10);社区实测 11-03 从开启状态七段整段跑通,26 个开关逐个关闭、回读核对(213 秒),复跑轮调整 0 项(165 秒);维护方未在本机复跑;商店「个性化推荐」子页的开关此前读不到(同坐标去重并掉),修复已合入
main,11-04 已在该机复测通过(#531);#530。手动清单见清单差异。 - vivo V2303A:系统 OriginOS 7 / Android 17(CP2A.260605.016);2026-11-04 社区实测,七段安全模式自检关闭 25 项、逐段回读确认;维护方未在本机复跑,整轮用时未测(#579)。手动清单见清单差异。
- 一加 Ace 2(PHK110)· ColorOS 16.0.5:2026-10-25 路径实测、整段重跑约 85 秒。营销通知 11 个关闭,1 个受限。
- 一加 Ace 2(PHK110)· ColorOS 15.0.0.601:2026-10-29 手动路径实测;自动脚本尚未整段真机验证。手动清单部分路径;营销通知渠道按独立流程处理。
- realme GT Neo5 SE(RMX3700):2026-11-02 六段真机实测通过(广告跟踪、软件商店、浏览器、下拉搜索、小布建议、应用建议);下拉搜索重跑 83 秒、幂等。
- 三星 Galaxy Note10+ 5G(SM-N9760):系统 One UI 4 / Android 12(SP1A.210812.016.N9760ZCU6HZE1);只有「广告」一段;2026-11-05 社区实测,保护开关「关 → 开」并回读确认,单段执行 5 秒;维护方未在该机复跑。营销通知 13 条营销渠道人工关 10 条,3 条因应用级禁用等效关闭;
chan-off13 条全跳过(渠道在「通知类别」子页,首层无渠道行)。手动清单见清单。
命令写法:
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/归档/
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/<品牌>-<型号>/recipe.py 各机型的机型脚本
images/ 文档配图
tests/ 不连接手机的引擎回归测试
遇到问题、想要新功能、希望支持你的手机,到 Issues 提交,选对应的模板。
用桌面客户端的话,点左下角「反馈问题」:会自动附上客户端版本、手机型号、系统版本和最近的日志(序列号已替换,不含应用列表和通知内容),打开 GitHub 页面后点提交即可。提交需要 GitHub 账号。
见 docs/05-还原.md。挂起的包和通知渠道各一条命令;App 内的开关按清单路径手动打开。
本项目只调用 Android 系统和厂商 App 公开提供的设置项。各厂商的界面随系统更新变化,使用前请备份,结果以你的手机为准。使用本项目造成的任何问题由使用者自行承担。
许可证:MIT









