基础认知
这个工具到底做了什么？
它用 Android 官方的 adb 调试接口，替你点击那些藏在设置深处的广告开关，并按通知渠道关闭营销推送、挂起没有界面开关的系统广告组件。它不安装模块、不修改系统文件、不注入进程。所有改动都能还原。
需要 root 吗？
不需要。系统广告的开关大多对普通用户开放，只是位置分散。「去广告必须 root」是十年前的情况。工具只用 adb 权限，不动 system 分区，系统更新照常。
会清除所有广告吗？
不会。它处理的是**系统级广告**：设置里的个性化推荐、应用商店推广位、负一屏卡片、锁屏推荐、通知栏营销推送、快应用跳转。App 内部信息流里的原生广告、视频前贴片不属于系统广告，工具不碰。
对手机有风险吗？
工具只做两件事：模拟点击官方开关、挂起广告组件。挂起是可逆的（pm unsuspend），不使用卸载命令。唯一需要注意的是不要在系统更新中途执行，以及操作前先备份。
会影响系统更新和保修吗？
不会。adb 是 Android 官方提供的开发者功能，使用它不修改系统完整性校验。挂起应用包不改变 system 分区，OTA 更新可以正常进行。
使用流程
第一次用应该按什么顺序操作？
四步：① 开启开发者选项与 USB 调试 → ② 跑只读检测（check）看清机型、构建号、脚本匹配情况 → ③ 保存快照（backup）→ ④ 执行机型脚本（recipe）或按清单手动操作。跳过后两步中的任一步都会让出问题时难以定位。
检测和执行的差别是什么？
检测完全只读：读取型号、构建号、广告组件、通知渠道数量，不写任何东西。执行才会拨开关、关渠道、挂起包。检测是让你在动手前知道会发生什么。
提示「构建号不匹配」还要继续吗？
可以继续，但引擎会进入安全模式：只执行能确认存在的入口，找不到就跳过，不会盲点相似但不相同的按钮。执行后提示「部分完成」并列出跳过的步骤，你再用同品牌手动清单补齐就行。少关一个开关，好过点错一页设置。
要多久？
检测约 10 秒。机型脚本按段执行，完整跑一遍通常 2–5 分钟。手动按清单操作约 10–15 分钟，具体取决于机型 App 数量。
必须用电脑吗？
是。adb 需要一台主机，手机无法给自己开调试权限。如果手里没有电脑，可以按[手动清单](/guides/manual-checklist)直接在手机上操作，能覆盖大部分系统开关，只是通知渠道和系统广告组件那部分做不了。
兼容与机型
支持哪些品牌？
已收录 7 个品牌：小米 / Redmi / POCO、OPPO / 一加、vivo / iQOO、荣耀、华为、三星、realme，共 38 个机型条目。其中 3 个有真机实测记录，其余为同系参考或待验证。
我的机型不在列表里怎么办？
先用只读检测看能不能识别。同一品牌同一系统底包的机型，设置路径高度相似，可以按品牌清单手动操作。如果确实不同，可以在 GitHub 提 issue 附上构建号和路径，或按[写脚本指南](/guides/write-recipe)贡献一份。
原生鸿蒙 NEXT 支持吗？
不支持。HarmonyOS NEXT（5.0 起）使用 HDC 协议而非 adb，工具无法连接。HarmonyOS 4 及更早版本基于 AOSP，adb 可用。
iPhone 能用吗？
iOS 无法作为主机连接安卓设备，所以 iOS 客户端提供的是机型清单速查与操作核对，不执行自动操作。iOS 系统本身也没有这类需要处理的系统广告入口。
系统升级后要重做吗？
建议重跑一次检测。大版本升级可能新增广告入口、调整设置层级，也可能让之前挂起的包被重新激活。重跑前先备份，这样旧快照还能用来对比。
同一台手机可以给多台设备用吗？
工具一次连接一台设备，通过序列号区分。多设备可以轮流连接，每台设备分别备份。快照与型号、构建号绑定，不能跨设备套用。
故障排查
提示读屏失败 / 无法读取页面怎么办？
最常见的原因是其它自动化工具占用了 UiAutomation：GKD、自动记账、Shizuku 相关功能。临时停用其中一个再重试，而不是全部关掉。其次检查 USB 调试（安全设置）是否开启。详见[读屏失败排查](/guides/troubleshooting)。
手机连不上电脑？
按顺序排查：① 换一根支持数据传输的线（很多原装线只供电）；② 换 USB 口，优先主板直出；③ adb kill-server 后重连；④ 在开发者选项里「撤销 USB 调试授权」再插；⑤ Windows 上确认 USB 驱动已装。
关掉之后广告还在？
先分类：如果是通知栏推送，跑 channels --apply；如果点开是「没有地址栏的页面」，那是快应用，见[快应用](/guides/quickapp)；如果是 App 内的信息流广告，那不属于系统广告，工具不处理。系统广告组件相关见[msa 与 opos.ads](/guides/system-ad-package)。
执行到一半失败了怎么办？
工具失败即停，不会继续盲点。已完成的部分有效，未完成的部分跳过。先跑 backup 存一个当前状态，再按失败步骤名用[手动清单](/guides/manual-checklist)补齐。提 issue 时带上这一步的名字和完整诊断。
想全部还原怎么做？
restore --all 按快照回滚挂起的包、通知渠道和快应用状态。App 内的开关系统不提供读取接口，需要按清单原路手动打开。详见[完整还原](/guides/restore)。
隐私与安全
工具会上传我的数据吗？
不会。没有遥测、没有账号体系、没有联网上报。日志只写本地文件。失败时提供的「完整诊断」包含异常堆栈和系统版本，序列号与用户目录会脱敏，是否发送由你自己决定。
会读取短信、通讯录、相册吗？
不会。工具只读取当前界面（你用 adb 也能做同样的事），遇到登录页、支付页、验证码页会直接跳过，不读取也不截图。
会替我同意用户协议吗？
不会。遇到协议页或隐私政策页，脚本点「取消」并跳过该段。这是刻意的约束，写在了执行引擎里。
代码可以自己审吗？
可以。仓库是 https://github.com/miounet11/android-ad-cleaner，MIT 协议。核心执行逻辑、机型脚本、安全模式判定都在里面。发现问题欢迎提 issue。