android-ad-cleaner

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

  • 语言Python
  • 大小15.6 MB
  • 更新13 小时前
在 GitHub 打开
avatarrddmwmddr
6.8k
607196
MIT License

技术解读

以下内容由 GitRead 中文社区 编辑团队基于项目 README 与官方资料整理， 结合中文开发者的常见使用场景补充技术选型建议。具体以项目官方文档为准。

项目背景与痛点

国产 Android ROM 的广告早已不是「开屏广告」这一个形态。它渗进了系统层：负一屏的热搜榜、天气应用里的资讯流、应用商店的推荐位、日历的节日营销卡片、设置页的横幅，甚至锁屏的「猜你喜欢」。这些内容有两个共同特征：由系统应用发起，且不走普通 App 的广告 SDK，因此 DNS 屏蔽、hosts 过滤、代理规则这些常见手段几乎无效——它们要么复用系统推送通道，要么干脆是本地预置资源。

用户手里其实只有三条路：关通知（治标，广告还在，只是不弹）、刷第三方 ROM（成本高、保修没了）、root 后冻结组件（动系统分区，OTA、支付、银行类 App 的完整性检测全都要受影响）。为了关几个开关去 root，性价比太低。

android-ad-cleaner 选择了第四条路：走 ADB 的 shell 权限。开发者选项里打开 USB 调试就能拿到这个权限，不需要破解分区，所有变更都停留在用户态、可逆。这决定了它的能力边界——pm、settings、appops、am 能办的事它都能办，改 framework 的事它办不了；但恰好，国产 ROM 的广告开关绝大多数就躺在 Settings.Secure/Global/System 这三张表里。

核心技术揭秘

这个项目真正的设计思想可以概括成一句话：把「清理广告」从一串手工敲的 ADB 命令，抽象成「声明式规则 + 可回滚的执行计划」。

架构上分成三层：规则层负责描述「某机型要改哪些 key、禁用哪些包」；计划层把规则和设备当前状态做 diff，算出最小变更集；执行层下发命令并采集快照。中间那层 diff 是关键——它让操作具备幂等性，重复执行不会产生副作用，也让「只改必要的、别多碰」成为默认行为。

细节上最容易被低估的是 settings 的读写。厂商把开关藏在三张表的不同 key 下，命名毫无规律（xxx_recommend_enable、xxx_ad_switch、xxx_news_push……），而且类型混杂：settings put global 写 bool 和写 int 是两个语义，写错类型往往静默失败，命令返回 0 但值根本没生效。所以规则文件必须为每个 key 标注类型，执行后还要 settings get 回读校验。这是同类脚本最常见的坑，也是这个项目显得「工程化」的地方。

回滚能力来自快照：执行前先用 settings get 和 pm list packages 采集原始值，落盘成 journal（变更日志），回滚就是按 journal 逐条还原。对系统组件，它更可能用的是 pm disable-user --user 0 而非 pm uninstall -k --user 0——前者可逆、不动 APK，后者会把应用从当前用户空间摘掉，虽然也能 cmd package install-existing 恢复，但风险等级完全不同。

至于「AI 智能体一键执行」，本质是把 CLI 做成稳定的命令契约：结构化的状态输出（JSON）、幂等语义、明确的退出码。这样 Agent 只需要读规则清单、查当前状态、拼命令，不必理解每一条 settings key 的业务含义。幂等和快照是 Agent 场景的前置条件——LLM 会重试、会重复下发命令，没有幂等兜底就是灾难。

graph TD A[用户或 AI 智能体] --> B[CLI 入口] B --> C{"ADB 连接与授权校验"} C -->|"已授权"| D[规则加载器-机型规则集] C -->|"未授权"| E[提示开启无线调试] D --> F[变更计划生成器-计算 diff] F --> G[快照采集-记录 settings 与包状态] G --> H[执行器-逐条下发 adb shell 命令] H --> I[回读校验-确认写入生效] I --> J[变更日志落盘 journal] J --> K{"用户发起回滚"} K -->|"是"| L[按 journal 还原原始值] K -->|"否"| M[保留清理结果]

功能亮点与差异

不 root 是最大的差异化。市面上「一键去广告」的工具大多是两种：一种是黑盒优化 App，点一下不知道它改了什么；另一种是 root 模块（如各类 Magisk 模块），威力大但门槛高、不可逆、影响 OTA。这个项目落在中间地带——权限够用、变更透明、随时能退。

可还原不是口号，是数据结构。多数脚本只负责「改」，不负责「记」。有了 journal，清理就变成一次可审计的事务，而不是一次性的破坏性操作。

规则化带来社区扩展性。机型规则与执行引擎解耦，意味着新机型适配就是提一个配置文件，不需要改代码。这类项目能否活下去，几乎完全取决于规则库的覆盖度和维护活跃度。

对 Agent 友好是它区别于传统脚本的隐性优势：输出可解析、行为可预测，能嵌进自动化流程。

应用场景与落地建议

个人用户最典型的场景是换机后的首次配置：新机开箱，一次性把推荐、热搜、营销推送全关掉，然后导出 journal 留档。要提醒的是：系统 OTA 更新大概率会重置部分 settings，升级后需要复跑；而且旧 journal 里的 key 可能在新版本已不存在，回滚前应重新采集而非盲还原。

批量场景也成立：二手回收、门店整备、测试实验室需要干净的系统环境时，脚本化执行比人工点几十个开关靠谱得多。

风险提示必须说清楚：disable-user 系统组件可能引发 UI 异常（禁用负一屏后桌面滑动崩溃是经典案例）、推送通道失效、部分系统功能连锁报错。建议分批应用：先只执行 settings 类低风险开关，观察一两天，再动组件禁用。另外，adb tcpip 别在公司网络随便开，那是个实打实的攻击面。

综合评价

优点：克制而透明——不用 root 拿到刚好够用的权限；工程化到位——幂等、快照、回读校验、可回滚，这套组合在同类小工具里并不常见；规则与引擎解耦，具备社区共建的结构基础。

缺点：本质上仍是「PC 辅助工具」，脱离 ADB 就无法工作，对普通用户有门槛；效果高度依赖机型规则的维护，冷门机型大概率落在覆盖之外；对服务端下发的广告（远端配置的推荐位、动态素材）无能为力，那属于域名/流量层的事，得另配一套方案；部分 ROM 做包名混淆，规则会随版本失效。

一句话结论：它不是「广告拦截器」，而是一把可撤销的系统开关手术刀——适合那些愿意花十分钟换取长期清静、并且要求随时能退回去的开发者型用户。

内容更新时间：1 周前。 编辑团队负责选题与抽样审核，详见 编辑准则。

相关仓库

public-apis/public-apis avatar
public-apispublic-apis
2 天前
496.9k
55.5k
2.6k

免费 API 汇总列表

apipublic-apisfree+7
Python
19.5 MB
7
详情
EbookFoundation/free-programming-books avatar
free-programming-booksEbookFoundation
6 天前
401.2k
67.3k
103

免费可获取的编程书籍

bookseducationhacktoberfest+2
Python
21.7 MB
3
详情
donnemartin/system-design-primer avatar
system-design-primerdonnemartin
9月15日
377.2k
59.2k
637

学习如何设计大规模系统。为系统设计面试做准备。包含 Anki 闪卡。

designdesign-patternsdesign-system+10
Python
11.0 MB
0
详情
vinta/awesome-python avatar
awesome-pythonvinta
1 天前
333.2k
28.0k
0

回答“我想用 Python 做 X，该用哪个工具？”的权威清单

awesomeawesome-listpython+3
Python
6.8 MB
2
详情
practical-tutorials/project-based-learning avatar
project-based-learningpractical-tutorials
5 天前
289.3k
36.8k
239

精选的项目实战教程列表

tutorialprojectbeginner-project+5
Python
473 KB
1
详情
NousResearch/hermes-agent avatar
hermes-agentNousResearch
9 小时前
261.3k
57.9k
53.5k

与你共同成长的智能体

aiai-agentai-agents+10
Python
1.3 GB
3
详情
TheAlgorithms/Python avatar
PythonTheAlgorithms
5 天前
225.9k
51.3k
90

所有算法均用 Python 实现

algorithmalgorithm-competitionsalgorithms-implemented+11
Python
17.9 MB
2
详情
yt-dlp/yt-dlp avatar
yt-dlpyt-dlp
3 天前
205.9k
18.1k
2.8k

功能丰富的命令行音视频下载器

youtube-dlpythonsponsorblock+4
Python
63.5 MB
0
详情

简要分析

热度分
8014
价值分
4246
活跃状态
活跃
adbai-agentandroidcolorosdebloathyperosmagicosoriginos
GitHub

语言占比

HTML
Inno Setup
Java
JavaScript
Kotlin
Python
Shell

Release

贡献者

rikkirikkirddmwmddrrddmwmddrxunguangzlj-cloudxunguangzlj-cloudNineteen19aaaNineteen19aaaAntony232Antony232skysststskysstststutiredboystutiredboyuntiltedayuntiltedaykxyctkxyctzengyuxiuzengyuxiuxiaozhao147xiaozhao147wowbbswowbbs

README

手机去广告

关掉国产安卓手机系统里的广告、热搜、资讯推荐和营销推送。

介绍页：https://rddmwmddr.github.io/android-ad-cleaner/

如果大家有其他需求可以加VX和电报群：

https://t.me/+A5X3Mxzs-Cg3NjYx

IMG_7235

下载桌面客户端

插上手机，点几下按钮。不需要 Python，也不需要 AI 工具。

v0.3.2 · 2026-11-05：这一版修了几个机型脚本找不到入口、开关读漏的问题，新增 vivo V2309A 机型脚本；营销通知清单不再列出前台服务的常驻通知。旧版不会自动更新，0.2.7 起的客户端左下角会提示新版；请重新下载，已有备份会保留。详见 更新记录，错误日志上报说明见 这里。官网：https://ahuamiao.com/sites/other/android-ad-removal-intro.html

此前版本已处理 Windows 本地页面超时、荣耀截图越界、通知渠道误操作风险、vivo 快应用与备份问题。各 Issue 的处理范围和待验证项见 社区问题处理记录。仅支持通过 adb 连接的安卓设备，暂不支持使用 HDC 的原生鸿蒙。

电脑 下载 说明
Mac · Apple 芯片（M1 及以后） AndroidAdCleaner-0.3.2-mac-arm64.dmg 已签名、通过苹果公证，双击就能打开
Mac · Intel 芯片（macOS 11 及以上） AndroidAdCleaner-0.3.2-mac-intel.dmg 同上
Windows 10 / 11 · 安装版 AndroidAdCleaner-0.3.2-windows-setup.exe 弹「Windows 已保护你的电脑」时点「更多信息」→「仍要运行」
Windows 10 / 11 · 免安装 AndroidAdCleaner-0.3.2-windows-portable.zip 解压后双击 AndroidAdCleaner.exe

不知道 Mac 是哪种芯片：左上角苹果图标 → 关于本机，「芯片」写 Apple M 开头的选 Apple 芯片。所有版本：Releases。用法：docs/08-桌面客户端.md。
连接手机
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、数据线 下载 · 说明

用法一的开场白，复制给 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 个渠道
一加 Ace 6T（PLR110） ColorOS 17.0.0.101 / Android 17 ✅ 2026-10-31 贡献者真机九段全跑 224 秒；本仓库无该机型，未复测，见清单差异 ✅ —（未测）
OPPO Find N6（PLP120） ColorOS 16.0.9 ⚠️ 路径实测，整段待验证 ✅ ✅ 30 个渠道
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 项；见说明 ✅ ✅ 独立关闭并回读 6 个营销渠道，其他原有渠道及总开关未变
OPPO Find X9 Pro（PLG110） ColorOS 16.0.10.501(CN01) / Android 16 ✅ 2026-11-01 九段逐项实测通过，回读确认 165 项；见说明 ✅ ✅ 60 个营销渠道全部关闭并回读确认（0 遗留）
OPPO Find X10 Pro Max（PMX110） ColorOS 17.0.0.116(CN01) / Android 17 ✅ 社区实测 2026-11-05：八段整轮 540 秒、退出码 0（该机当时未装游戏中心）；2026-11-06 同机按段提速（游戏中心当天已装）：广告跟踪 1623→41 秒、游戏中心由失败转为 27 秒、视频 31→22 秒、负一屏 41→38 秒；本仓库未复跑。已关闭状态复跑，读取确认 593 项、调整 0 项，关闭路径未从开启状态验证；见说明 ✅ 搜索数据源、消息通知与卡片保留 ✅ 本次独立关闭 3 个渠道，总开关未变
OPPO Find X9 Ultra（PMA120） ColorOS 16.0.10 ❌ 页面和 N6 不同，待补 部分 ✅ 27 个渠道
OPPO Find N3 典藏版（PHN110） ColorOS 16.0.5 ❌ 待补 部分 ✅ 27 个渠道
OPPO Find N5（PKH110） ColorOS 17.0.0.103 / Android 17 ✅ 2026-10-29 七段实测通过，重跑 144 秒；负一屏需手动（设置页受权限保护） ✅ ✅ 42 个渠道
小米 18 Pro Max（M154FF） HyperOS 4.0.24 ✅ 10-25 前轮九段通过，新增兼容改动待复测 ✅ ✅
小米 17 Ultra 标准版（2512BPNDAC） HyperOS OS4.0.5.0.XPACNXM / Android 17 ✅ 10-28 九段实测通过，重跑 176 秒 ✅ ✅ 1 个渠道（商店「其他」）
小米 17（25113PN0EC） HyperOS 4 / Android 17 — 无专用脚本 ✅ 见清单 ✅ 无营销渠道；1 个候选属服务类，已跳过
小米 15（24129PN74C） HyperOS OS4.0.0.22.XOCCNXM / Android 17 ✅ 10-29 九段实测通过，重跑 164 秒 ✅ —（未跑）
小米 13 Ultra（2304FPN6DC） HyperOS OS3.0.308 / Android 16 ✅ 10-28 九段通过，复跑 3 分 16 秒 ✅ —（未跑）
小米 14 Pro（23116PN5BC） HyperOS OS3.0.308.0.WNBCNXM / Android 16 ⚠️ 10-29 社区实测：与 13 Ultra 共用脚本，安全模式下九段跑通、275 秒、19 项关闭并回读；浏览器「搜索设置」未命中，正常模式整轮待复测 ✅ ✅ 60 个渠道（64 候选，人工剔除 4 条服务类）
小米 Pad 7（2410CRP4CC） HyperOS OS2.0.208 / Android 15 ✅ 10-28 四段通过，复跑 61 秒 ✅ —（未跑）
小米 REDMI K80 至尊版（25060RK16C） HyperOS 2（BP2A.250605.031.A3）/ Android 16 ✅ 10-27 真机九段通过，重跑 3 分钟 ✅ ✅ 3 个渠道
小米 15（24129PN74C） HyperOS OS3.0.307.0.WOCCNXM / Android 16 ⚠️ 10-29 路径逐项实测、开关已实际关闭；新脚本整轮待复测、用时未测，底包同 K80 但浏览器/商店入口不同 ✅ ✅ 17 个渠道，全部关闭
小米 REDMI K90 Pro Max（25102RKBEC） HyperOS OS4.0.2.0.XPMCNXM / Android 17 ✅ 10-27 九段实测通过，重跑 169 秒 ✅ ✅ 26 个渠道
小米 REDMI K80 Pro（24122RKC7C） HyperOS OS3.0.304.0.WOMCNXM / Android 16 ✅ 10-29 九段实测，首轮关 20 项，复跑 172 秒；实测记录 ✅ ✅ 48 个渠道（54 候选）
小米 Redmi Note 14 Pro（24090RA29C） HyperOS 3.0.309.0 / Android 16 ✅ 10-26 八段实测通过，整轮约 5 分钟 ✅ ✅ 11 个渠道
小米 Redmi Note 14 5G（24094RAD4C） HyperOS OS3.0.306.0.WOQCNXM / Android 16 ✅ 10-30 八段实测：20 项新关闭（记账修复前统计，不含普通点击关掉的 4 项），复跑 291 秒、21 项回读、调整 0 项 ✅ ✅ 3 个渠道，全部关闭
小米 Redmi Note 13 海外版 / 俄区（23124RA7EO） HyperOS OS2.0.213.0.VNHRUXM / Android 15 — 无专用脚本（界面是俄语，引擎按中文找不到入口） ✅ 见清单（11-01 社区实测，adb + 手动） —（未跑）
Redmi Note 12 Turbo（23049RAD8C） HyperOS OS3.0.5.0 ✅ 实测通过，九段 3.5 分钟 ✅ ✅
Redmi K70（23113RKC6C） HyperOS 3.0.307.0 / Android 16 ⚠️ 9 段专用脚本，目标 20 项；实测记录 ✅ —（未测通知）
Redmi K70 Pro（23117RK66C） HyperOS OS3.0.306.0.WNMCNXM / Android 16 ✅ 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-10-28 报告者实测：商店入口与「个性化推荐」页失效；已按系统版本新增变体脚本，本仓库无该机型、未复测（#220） ✅ 见清单差异 —（未测）
vivo X Fold6（V2545A） OriginOS 6 Fold / Android 16 ✅ 实测通过，7 段 121 秒（合上外屏） 部分（负一屏、i 管家需手动） ⚠️ 仅 1 条候选，应用级开关已跳过
vivo（iQOO） V2324HA 原系统 Android 16（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） OriginOS 7 ✅ 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 / Android 16 ✅ 2026-10-25 路径实测、整段重跑约 85 秒 ✅ 11 个关闭，1 个受限
一加 Ace 2（PHK110） ColorOS 15.0.0.601 / Android 15 2026-10-29 手动路径实测；自动脚本尚未整段真机验证 部分路径 渠道按独立流程处理
realme GT Neo5 SE（RMX3700） ColorOS 16.0.5.1300(CN01) / Android 16 ✅ 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-off 13 条全跳过（渠道在「通知类别」子页，首层无渠道行）

表格反映当前脚本和验证范围。小米 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/归档/
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 打包）
recipes/<品牌>-<型号>/recipe.py   各机型的机型脚本
images/              文档配图
tests/               不连接手机的引擎回归测试

反馈

遇到问题、想要新功能、希望支持你的手机，到 Issues 提交，选对应的模板。

用桌面客户端的话，点左下角「反馈问题」：会自动附上客户端版本、手机型号、系统版本和最近的日志（序列号已替换，不含应用列表和通知内容），打开 GitHub 页面后点提交即可。提交需要 GitHub 账号。

还原

见 docs/05-还原.md。挂起的包和通知渠道各一条命令；App 内的开关按清单路径手动打开。

声明

本项目只调用 Android 系统和厂商 App 公开提供的设置项。各厂商的界面随系统更新变化，使用前请备份，结果以你的手机为准。使用本项目造成的任何问题由使用者自行承担。

许可证：MIT

评论

暂无评论