@GaoXiaoxiao2022 示范开源 android-ad-cleaner:用一根数据线和 AGENTS.md,让 Codex / Claude 通过 ADB 关掉国产安卓的广告开关
国产安卓把广告、热搜、资讯流开关藏得很深。开源项目 android-ad-cleaner(MIT,GitHub 约 6.0k★,作者 rddmwmddr)免 Root、免刷机:用 ADB 只拨系统/App 自带开关,可挂起广告包(需同意),带桌面客户端与 35+ 机型脚本。仓库 AGENTS.md 专给能跑命令的 AI 智能体(Codex、Claude Code、WorkBuddy 等)写清硬规则与标准流程;另有给纯聊天 AI 的逐步提示词。@GaoXiaoxiao2022 在 X 上写了「克隆仓库 → 读 AGENTS.md → 逐步征求同意」的实操口吻。我们读了 AGENTS.md/README/CHANGELOG,跑了不依赖真机的单测(渠道分类、never-suspend、入口引用等);本盒子无安卓设备与 adbutils,未对真机执行 recipe。
访问官网 android-ad-cleaner (rddmwmddr/android-ad-cleaner) ↗- 定价
- 免费
- 地区
- 国内
- 出自哪里
- 中文社区
- 上架日期
- 2026 年 11 月 4 日
- 实测日期
- 2026 年 11 月 4 日
- 用的版本
- repo main ~ac3e5fa; desktop client docs v0.3.1; 35+ recipes
- 我们实测
- 部分实测
- 成本 / 耗时
- 软件开源免费。需要一台电脑、一根数据线,以及能执行本地命令的 AI(自有 Codex/Claude 等订阅)或官方桌面客户端。
要解决的事
在不 Root、不刷机的前提下,关掉国产安卓里的系统广告、热搜、负一屏资讯流、应用商店推广和营销通知,并保留搜索、安装更新、天气/快递等正常功能。
步骤
- 手机开启开发者模式与 USB 调试,数据线连接电脑;在弹窗勾选「始终允许」。暂不支持仅用 HDC 的纯鸿蒙。
- 两条路选一条:(A)从 Releases 下桌面客户端(我们读到 v0.3.1 有 Mac/Windows 包)按界面连接→检测→勾选→执行;(B)克隆仓库,装依赖后把任务交给本地 Agent。
- Agent 路径:`git clone https://github.com/rddmwmddr/android-ad-cleaner`,读根目录 AGENTS.md,再按需 `pip3 install -r requirements.txt`。把下方提示词丢给 Codex / Claude Code / WorkBuddy 等能跑 shell 的助手。
- 标准命令序(均带 `-s <序列号>`):`run.py devices` → `check` → `backup` → `recipe` → `chan-scan` 编辑清单 → `chan-off` → 询问后 `suspend` / `quickapp off` → `finish`。每段改之前 Agent 应先说明要关什么。
- 没有能跑命令的 Agent 时,用仓库 `prompts/聊天AI提示词.md`:复制给豆包/DeepSeek 等,一次只做一步,对照品牌清单或截图操作。
提示词
请在 GitHub 查找并克隆 rddmwmddr/android-ad-cleaner 仓库,读里面的 AGENTS.md,然后帮我给连着电脑的这台手机去广告。每一步改之前告诉我要改什么,等我确认再执行;不要 root、不要卸载系统应用、不要替我点「同意」协议。
原文怎么说
@GaoXiaoxiao2022:免 Root、免刷机,一句指令让 AI 经 ADB 接管手机,把深层广告开关挨个关掉。实操三步:开 USB 调试连线 → 打开 Codex/WorkBuddy 等 → 丢提示词让它克隆仓库并读 AGENTS.md。声称效果含清空下拉热搜、负一屏资讯/福利卡、应用商店短剧入口与推销横幅、个性化广告追踪与快应用跳转;非侵入、改前征求同意、可按清单还原。
我们实测
克隆 rddmwmddr/android-ad-cleaner(最新主线含 v0.3.1 客户端说明,commit 读到 ac3e5fa 一带)。阅读 README、AGENTS.md、CHANGELOG、prompts/聊天AI提示词.md;`python3 tool/run.py --help`;运行不依赖真机的 unittest:test_channel_classification、test_never_suspend、test_entrypoint_refs、test_doc_consistency。未安装 adbutils/真机,未执行 check/recipe/chan-off。
我们亲自试下来:CLI 帮助列出完整子命令;仓库含 35+ recipes 目录。渠道分类与 never-suspend 相关用例全部通过(含「保护包装进同批则整批拒绝、不碰手机」)。test_fixtures 因缺少 adbutils 导入失败,属环境依赖而非断言失败。无设备时无法验证热搜/负一屏等 UI 效果。
怎么用上
GitHub 与 Releases 国内一般可访问;项目面向国产安卓品牌(OPPO/vivo/小米/荣耀等)。原帖中文;README 中文为主。
适合谁
被国产安卓预装广告、热搜和营销推送折磨的用户;愿意开 USB 调试、想让 Agent 代点设置的人。
踩坑提示
- 纯鸿蒙(仅 HDC)暂不支持;多设备时必须 `-s` 指定序列号。
- AGENTS.md 硬规则:不 `pm uninstall` / `pm disable-user`,不碰系统更新,不替你点同意协议,不截账号页;保护类「限制广告跟踪」开关要打开而非关掉。
- 下拉搜索、负一屏、应用商店等包在 never-suspend 列表,误挂会坏功能——单测也覆盖了整批拒绝逻辑。
- 我们未接真机:渠道分类与 never-suspend 等单测通过,但依赖 adbutils 的模块在本环境未装全;桌面客户端与机型 recipe 的真实效果要以你的品牌/系统版本为准。
同类用例
- 装 skill 前先扫一遍,再看标红的几行编程开发SkillSpectoruv开源免费;静态检查不用模型● 已实测国内
- 把常驻智能体隔离在单独机器上,再让它试着越狱自动化代理OpenClawClaude CodeOllamaOllama Cloud 每月 20 美元 + Claude 订阅○ 未实测海外
- 待办常驻终端侧栏,一件事开一个 AI 对话效率办公Today BoardcmuxClaude Code开源免费;需 macOS 和 cmux◐ 部分实测国内
- 给智能体装上 300 个搜索源调研搜索ArgoClaude CodeCodex开源免费;不配 Key 也能用◐ 部分实测国内
- 网站任务学一次,之后重放不花模型钱自动化代理DejoClaude CodePlaywright开源免费;需 Python 3.11+◐ 部分实测海外