返回博客

Clean Your TV GitHub 教程:不 root,清掉电视广告

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

2026年11月1日AINovaTools Team
Clean Your TV GitHub 教程:不 root,清掉电视广告

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 的说法,一共三步:

  1. 先备份。 动任何东西之前,先把已安装包列表和设置存档,并生成一份恢复脚本。
  2. 只停用,不卸载。 遥测、广告服务、臃肿软件用 pm disable-user 停用。不卸载、不刷机、不 root。
  3. 换掉桌面。 装一个原生启动器——约 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
AgentClaude 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 实操:八步走完

  1. 打开开发者选项。 电视设置里找到「关于」(Google TV 在「系统」下,多数 Android TV 在「设备偏好设置」下),对「版本号」连按 7 次确认键。

  2. 开启调试。 打开 USB 调试;如果电视单独列出「网络调试」或「ADB 调试」,一并打开。

  3. 克隆仓库,在目录里启动 Agent:

    git clone https://github.com/Gathin23/cleanyourtv
    cd cleanyourtv
    claude   # 或:opencode
    

    克隆这一步别省:提示词要求 Agent 复用仓库里带安全检查的 tools/disable.sh 和启动器构建脚本,而不是自己现场发挥 ADB 命令。

  4. 粘贴 PROMPT.md,填上你的电视型号。 整个项目的方法论就在这一个文件里。

  5. 在电视上确认调试授权。 Agent 会在局域网里找到电视、连上 ADB,然后先存备份——包列表、getprop 输出、系统设置。

  6. 回答检查清单。 家里用哪些流媒体应用、要不要语音助手、Chromecast 和系统更新保不保留,桌面 Dock 要几个格子(4 到 7 个)、放什么应用。

  7. 让它小批量干活。 包一条一条停用,每批之间截图核对。新桌面先装好并确认接管了 Home 键,旧桌面才会被停用——全程不会出现没有桌面的状态。

  8. 关门。 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 应用页。

全程约五分钟,三步:

  1. 连接。 应用在同一 Wi-Fi 里发现电视,引导你完成授权。
  2. 分析。 读取电视上装了什么,给出清理计划,此时什么都没动。
  3. 清理。 先存还原点,再停用垃圾、套上新桌面。

要求:Android 9 以上、带锁屏密码的手机,电视打开网络调试(应用会告诉你在哪开,结束后帮你关掉)。如果 150 秒内手机没确认新桌面,看门狗会自动恢复电视原有桌面。

Agent 方案(仓库)手机 App
需要电脑、JDK、Android SDK、AgentAndroid 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 再来一遍,清单就套回去了。

本文提到的工具