Clean Your TV GitHub 教程:不 root,清掉电视广告
Clean Your TV 是 GitHub 爆火的开源项目:走 ADB 关掉安卓电视的广告、遥测和臃肿软件,不用 root。拆解 AI Agent 八步流程、手机 App 方案、恢复方法和风险。

Clean Your TV 是 GitHub 上的一个开源项目,专门清理 Android TV 和 Google TV 上的桌面广告、推荐位、后台遥测和预装臃肿软件。它走的是 ADB——安卓自带的调试通道,通过局域网操作,不需要 root。最特别的使用方式是:把仓库克隆下来,丢给 Claude Code 这样的 AI 编程 Agent,粘贴一段提示词,回答三四个问题,剩下的活 Agent 自己干。
项目起于 2026 年 10 月中旬:开发者把帮父母清理小米电视的前后对比发了出来,整个过程由 Claude Code 通过 Wi-Fi 完成。仓库 Gathin23/cleanyourtv 几天内就火了——一半因为谁家都有一台这样的电视,另一半因为它的「产品」本身就是一段写得极好的提示词,外加几个护栏脚本。
下面按顺序讲清楚:它到底改了什么、Agent 怎么带着你走完、没有电脑怎么办、出问题怎么救。
Clean Your TV 到底改了什么
按 README 的说法,一共三步:
- 先备份。 动任何东西之前,先把已安装包列表和设置存档,并生成一份恢复脚本。
- 只停用,不卸载。 遥测、广告服务、臃肿软件用
pm disable-user停用。不卸载、不刷机、不 root。 - 换掉桌面。 装一个原生启动器——约 572 KB 的纯 Java 应用,为 1 GB 内存的电视设计——黑色背景、底部 Dock、自己挑应用,没有广告位。
第三步才是体感所在:大部分广告本来就长在系统桌面上,只停服务,广告牌还立着。
仓库 examples/ 目录里是各机型的实测包列表,写作时已覆盖 106 个品牌的 407 个电视型号,TCL、索尼、小米最多;没收录的机型 Agent 会走得更保守。
| 会消失的 | 会保留的 |
|---|---|
| 系统桌面的推荐位和推广横幅 | YouTube 等流媒体应用内的广告 |
| 遥测与广告服务 | Play 商店和 Google Play 服务 |
| 你确认不用的预装应用 | HDMI 输入、直播电视、遥控器配对 |
| 厂商自家的内容推荐流 | 系统更新(除非你主动选择关闭) |
电视广告为什么越看越多
逻辑很直白:低价智能电视靠硬件赚不到钱,利润得从桌面上挣回来。Google TV 首屏是推荐流加赞助位,小米等厂商再叠一层自家内容推荐,后台还有遥测服务持续上报。设置菜单基本帮不上忙——Google TV 的「仅应用模式」(Apps only mode)能藏掉推荐,但会连 Google 助手一起关掉,后台服务则没有任何开关。ADB 是侧门:开发者调试手机用的那座桥,任何 Android TV 打开开发者选项后都在。
动手前要准备什么
| 条件 | 说明 |
|---|---|
| 电视 | Android TV 或 Google TV;桌面要求 Android 8.0(API 26)以上 |
| 网络 | 电脑和电视连同一个 Wi-Fi |
| 工具链 | Python 3、JDK 17-22、Android SDK platform 34 加 build-tools 34.x |
| Agent | Claude Code、Codex、Gemini CLI 或 Antigravity CLI,能读 AGENTS.md 即可 |
| 耗时 | 约 15 分钟,一次做完 |
工具链比「去个广告」听起来重,因为启动器要在你的电脑上从源码构建,项目不提供预编译 APK。注意 JDK 上限:23 及以上版本会破坏 Gradle 8.9 构建。Windows 用户有全套 PowerShell 脚本。
仓库自带 CLAUDE.md、AGENTS.md 和 GEMINI.md,Claude Code 和 Gemini CLI 会自动读取各自那份,OpenCode 则读同一份 AGENTS.md。没用过终端 Agent 的话,先看我们的 Claude Code 新手教程,装好、弄懂 plan mode 和权限再动手。
AI Agent 实操:八步走完
-
打开开发者选项。 电视设置里找到「关于」(Google TV 在「系统」下,多数 Android TV 在「设备偏好设置」下),对「版本号」连按 7 次确认键。
-
开启调试。 打开 USB 调试;如果电视单独列出「网络调试」或「ADB 调试」,一并打开。
-
克隆仓库,在目录里启动 Agent:
git clone https://github.com/Gathin23/cleanyourtv cd cleanyourtv claude # 或:opencode克隆这一步别省:提示词要求 Agent 复用仓库里带安全检查的
tools/disable.sh和启动器构建脚本,而不是自己现场发挥 ADB 命令。 -
粘贴 PROMPT.md,填上你的电视型号。 整个项目的方法论就在这一个文件里。
-
在电视上确认调试授权。 Agent 会在局域网里找到电视、连上 ADB,然后先存备份——包列表、getprop 输出、系统设置。
-
回答检查清单。 家里用哪些流媒体应用、要不要语音助手、Chromecast 和系统更新保不保留,桌面 Dock 要几个格子(4 到 7 个)、放什么应用。
-
让它小批量干活。 包一条一条停用,每批之间截图核对。新桌面先装好并确认接管了 Home 键,旧桌面才会被停用——全程不会出现没有桌面的状态。
-
关门。 Agent 会关掉调试、撤销授权,并跑
tools/adb-closed.py确认重启后 ADB 端口拒绝连接。以工具输出的 closed 为准。
Agent 可能顺带推荐广告拦截 DNS。提示词里写得很诚实:拦不住 YouTube 内部广告,还可能绕过你路由器上配的过滤规则。另外这一场建议关掉自动批准——每条 pm 命令都是独立指令,你可以逐条看完再放行。
为什么用 Agent,不用现成脚本
因为电视太乱了。固定脚本不会知道 Google TV 有个 setup 组件会抢走 Home 键、还攥着你保存的 Wi-Fi 密码,也不会知道停用一个 MediaTek 中间件服务曾把一台海尔电视刷进重启循环——这两个坑提示词里都写了。Agent 能读包列表、看截图、追问你家实际用哪些应用;脚本则是护栏,碰到核心安卓包直接拒绝执行,没有后门。
没有电脑?手机 App 五分钟搞定
如果为了清电视装一套 JDK 听着就很荒谬,有条捷径:开发者 udhaykumarbala 做了个免费开源的安卓应用,手机上直接完成,不需要电脑也不需要 Agent。它是独立的社区项目、单独的仓库,入口在 Clean Your TV 应用页。
全程约五分钟,三步:
- 连接。 应用在同一 Wi-Fi 里发现电视,引导你完成授权。
- 分析。 读取电视上装了什么,给出清理计划,此时什么都没动。
- 清理。 先存还原点,再停用垃圾、套上新桌面。
要求:Android 9 以上、带锁屏密码的手机,电视打开网络调试(应用会告诉你在哪开,结束后帮你关掉)。如果 150 秒内手机没确认新桌面,看门狗会自动恢复电视原有桌面。
| Agent 方案(仓库) | 手机 App | |
|---|---|---|
| 需要 | 电脑、JDK、Android SDK、Agent | Android 9 以上手机 |
| 耗时 | 约 15 分钟 | 约 5 分钟 |
| 覆盖机型 | 已收录 407 款,未收录谨慎处理 | 46 个品牌的 131 款 |
| 恢复 | tools/restore.sh 回放备份 | 内置还原点 |
| 适合 | 折腾党、冷门机型、自定义 Dock | 其余所有人 |
一个提醒:主项目声明自己没有发布任何应用商店版本。请从 cleanyour.tv 的链接进,别信商店搜索结果。
出问题了怎么救
最常见的故障是某个在用的应用失灵。电视设置里进「应用」,显示系统应用,把它重新启用即可,不需要电脑。
要整体还原,跑 tools/restore.sh,它会回放首次修改前记录在 ~/.cleanyourtv/ 的原始状态:
tools/restore.sh examples/你的电视型号/debloat.txt
新桌面会一直装着,直到你在设置里手动卸载。万一 Google TV 卡在没有桌面的状态,这条命令能救回来:
adb shell pm enable --user 0 com.google.android.apps.tv.launcherx
系统固件更新是长期麻烦:更新装完后,被停用的包会集体复活,桌面也变回原装。跑仓库的 tools/check.py,加 --fix 参数即可重新套用清理清单。最后的兜底永远是恢复出厂设置——什么都能回来,代价是所有登录状态。
风险说在前面
- 停错包会出事——桌面功能、信号源切换、遥控器配对,严重时无法开机。提示词维护着一张禁区清单:电视和 HDMI 输入服务、遥控与蓝牙配对、屏幕键盘、Play 商店与 Play 服务、安卓核心包。跟着项目为你这款机型整理的清单走,别自由发挥。
- 开着 ADB 是真实的安全口子,同一网络里谁都能试。收尾那步别省。
- 没有真正卸载任何东西。 不 root 的前提下,包只对默认用户停用,APK 还躺在系统分区。预期是电视变清净,不是变出存储空间。
- 保修与售后。 停用应用不等于 root,恢复出厂也能还原,但先看保修条款——售后大概率会要求你先恢复出厂再谈。
- 工厂和测试包别碰。 仓库的 Agent 规则明令禁止启动它们,因为工厂模式的标记可能不可逆。
什么人该做,什么人别碰
适合: 受不了 Android/Google TV 桌面广告牌的人;替父母做技术支持的人(这正是项目的起点);老款低内存电视用户——启动器就是为 1 GB 内存的机器设计的。
别碰: 三星、LG、Roku 用户——它们跑 Tizen、webOS 和 Roku OS,不是安卓,项目会直接把你分流走。另外,如果你喜欢 Google TV 的推荐流(原装桌面会被换掉)、电视不归你管、或者今晚还等着看球赛直播没空一口气做完,都先缓缓。
更深一层的看点:Clean Your TV 与其说是工具,不如说是给 Agent 的一份带护栏的任务书。这个模式正在扩散——Ponytail 用一个 SKILL.md 改变 Agent 写代码的方式,Reverse Engineer Anything 让 Agent 去啃二进制,day-trader-skill 把 11 个带护栏的交易技能打成包,Karpathy 的 HackerTube 则是一个周末搓出的整个油管替代品。还没选好用哪个 Agent 干活?先看我们的 最佳 AI Agent 工具盘点。
常见问题
Clean Your TV 需要 root 吗?
不需要。它用的 ADB 通道,任何 Android TV 打开开发者选项就有。包用 pm disable-user 停用,不刷机、不 root、不卸载。
跑 Clean Your TV 安全吗?
按流程走,风险可控:先备份、用项目整理好的机型清单、脚本碰到核心包会拒绝执行、桌面切换的顺序保证 Home 键永远有归属。真正的风险是停用了你这台电视恰好需要的东西,以及忘了关 ADB。
能拦截 YouTube 广告吗?
不能。它移除的是桌面广告、停用系统级广告和遥测服务,YouTube 等应用内部广告由应用自己下发,这个项目管不到,可选的拦截 DNS 也一样。
三星、LG、Roku 电视能用吗?
不能。这些电视不跑安卓系统,没有 ADB 可连。索尼、TCL、小米、飞利浦、海信等安卓系机型都在覆盖之列,具体型号去 examples/ 里查。
固件更新会把清理成果冲掉吗?
通常会。更新会让被停用的包全部恢复,桌面回到原装。重新跑 tools/check.py 加 --fix,或者让 Agent 再来一遍,清单就套回去了。



