一句话说清这个项目

CleanYourTV 是一个开源工具，做的事情可以用一句大白话概括：通过家里的 Wi-Fi，给你的安卓电视（Android TV / Google TV）"打扫卫生"——把用不到的预装软件停用掉，再换上一个大字、大图、没广告的苹果风格首页。全程不需要 Root、不需要刷机、不卸载任何应用，一条命令就能全部恢复原样。

它的作者把项目放在 GitHub 上，名字叫 Gathin23/cleanyourtv，采用 MIT 许可，任何人都可以免费使用、修改和分发。2026 年 10 月，这个项目在开发者社区火了起来：10 月 19 日到 25 日那一周，它登上了 GitHub Trending 榜首；TechCrunch、TechRadar、Tom's Guide、XDA 等科技媒体先后报道了它。

对一个个人开源项目来说，这种关注度并不常见。它击中的痛点足够普遍：全世界的电视用户都在忍受同一套臃肿的首页，而 CleanYourTV 提供了一条普通人也走得通的路。

项目名片：先把基本数据摆在桌上

在深入细节之前，先把项目的关键数据整理成一张表。这些数字后面会反复出现，值得先有个印象：

项目 数据 说明
仓库地址 GitHub: Gathin23/cleanyourtv 项目唯一的官方代码托管地
开源许可 MIT 最宽松的许可之一，可自由使用、修改
已验证电视型号 433 款 社区实测列表，不是口头承诺
覆盖品牌 114 个 主流电视与盒子品牌基本覆盖
界面语言 31 种 含简体中文、希伯来语等，支持 RTL 镜像
新首页体积 约 572KB 一个安装包的大小，极其轻量
知名度峰值 GitHub Trending 周榜第一（2026 年 10 月） 同期获多家国际媒体报道
支持的系统 Android TV / Google TV 需 Android 11 以上（无线调试依赖新版系统）
不支持的系统 Fire TV、Tizen、webOS、VIDAA 官方在 cleanyour.tv/not-android 页面明确列出

两个数字值得多说一句。"433 款已验证型号"意味着项目不是纸上谈兵，而是有大量真实用户在不同品牌、不同年份的电视上跑通过；"launcher 仅 572KB"则说明这个新首页没有捆绑任何私货——它不收集数据、不带广告 SDK，就是一块干干净净的界面。

它到底做什么：两件事

CleanYourTV 的全部功能可以拆成两件事：减法和换装。

减法，指的是"去预装"（debloat）。 它会先列出电视上安装的全部软件包，生成一份清单。你对照清单勾选：视频专区、游戏中心、购物入口这些用不到的，标记为停用；自己装的应用、系统关键组件，保留。确认之后，一条命令批量执行，被停用的应用从界面上消失，后台也不再活动。

注意，这里是"停用"而不是"卸载"。被停用的应用文件还在电视里，只是被系统切断了活动。这个区别是 CleanYourTV 安全设计的核心，下一篇会专门讲原理。

换装，指的是替换首页（launcher）。 安卓电视的"首页"技术上叫启动器， CleanYourTV 自带一个全新的启动器，风格明显致敬 Apple TV：纯黑背景、底部 dock 栏放四个常用应用、顶部大字号显示当前打开的应用名、应用网格排列、毛玻璃质感的按钮、还有时钟屏保。遥控器按一下，界面响应干净利落，没有推荐流，没有开屏广告。

两件事合起来，才构成完整的体验：光减不换，首页还是那个广告商城；光换不减，后台还跑着一堆用不到的服务。这也是 CleanYourTV 区别于单一"去广告工具"或单一"第三方桌面"的地方。

项目的组成部分

打开 GitHub 仓库，你会看到一个结构清晰的目录。用一张导图把主要部分串起来：

---
markmap:
  colorFreezeLevel: 2
---
# CleanYourTV 仓库

## 启动器（launcher）
- 新首页界面
- 21 套主题
- 31 种语言
- 体积约 572KB

## tools 工具链
- tv.py 纯 Python ADB 客户端
- disable.sh / restore.sh
- recovery.py 恢复记录
- check.py 固件升级核对
- b64push.py / relay.py
- docker-build.sh / theme.sh

## 文档与辅助
- README 使用说明
- PROMPT.md 给 AI 助手的任务书
- 兼容性验证列表

对普通用户来说，最常用的只有两个入口：一是仓库里的 PROMPT.md——一份写给 AI 编程助手的"任务书"，照着它，让 AI 带着你走完全流程，大约十五分钟；二是 tools/ 目录里的脚本工具，适合愿意在电脑上敲命令的用户，本书第 4 章会逐一详解。

新首页长什么样：先看个轮廓

既然"换装"是这个项目的半壁江山，在往下讲之前，先给新首页画个轮廓，让大家心里有个预期。它的设计语言明显借鉴 Apple TV：

界面元素 样子与作用
背景 纯黑打底，突出内容本身，OLED 电视上还能省电
底部 dock 四个常用应用排成圆角横带，一键直达，顺序可自定义
顶部 Shelf 大字号显示当前打开的应用名，带环境光效
应用网格 自己安装的应用整齐排布，没有推荐流
玻璃按钮 Inputs（信号源）、Wi-Fi、Settings 三个毛玻璃质感按钮
时钟与屏保 Outfit 字体时钟，待机时化身屏幕保护
主题 内置 21 套主题，随心切换
模块卡片与 App 资源库 快捷功能卡片，配合资源库找回被隐藏的应用
语言 31 种界面语言，含希伯来语 RTL 镜像布局

这些特性在本书第 5 章会逐一详解，这里点到为止：CleanYourTV 换掉的不是"一个桌面壁纸"，而是一整套电视的交互门面。

生态位：它在"精简电视"地图的哪一格

"让电视变干净"这个需求，市面上并非没有产品。把 CleanYourTV 放进整个方案地图里，它的位置就很清楚了：

方案 代表 原理 代价
换盒子 Apple TV、国际版盒子 绕过电视系统 花钱，且 HDMI 输入切换麻烦
Root 各类 Root 工具 获取最高权限后删除 变砖风险、丢保修、部分 App 拒运行
刷第三方固件 精简版系统包 整体替换系统 需对应型号包、门槛高、风险大
去广告盒子/软路由 旁路屏蔽 网络层拦截广告域名 需要额外硬件和技术
CleanYourTV 本项目 Wi-Fi + ADB + 系统停用开关 低风险、可撤销、免费，但只支持安卓电视

可以看到，CleanYourTV 占据的是一个独特的格子：比 Root 和刷机安全得多，比换盒子和旁路拦截便宜得多，而且效果立竿见影。 它的边界也很清晰——只支持 Android TV / Google TV，其他系统（Fire TV、Tizen、webOS、VIDAA）用不了，这一点我们会在兼容性一篇里细说。

用一个更形象的比喻：Root 和刷机像是"拆房子重修"，CleanYourTV 像是"大扫除加软装"——东西没扔，都规整到储物间了，随时可以拿回来。

MIT 许可与开源模式

CleanYourTV 采用 MIT 许可，这是最宽松的开源许可之一。它对普通用户意味着三件事：

第一，免费。不需要付费，不需要激活码，不存在"基础版免费、高级功能订阅"的套路。

第二，可追溯。所有代码公开在 GitHub 上，任何人都能审查它到底对你的电视做了什么。一个只用系统自带开关的工具，没必要藏着掖着。

第三，可延续。即使作者某天不再维护，任何人都可以 fork（复制）代码继续改进，项目不会随作者沉寂而消失。

开源模式还带来一个隐性好处：433 款验证型号、31 种语言，都是社区用户一点点试出来、翻出来的。你在使用中发现的型号兼容信息，提交给项目，就能帮到下一个人。

它不是什么

最后，有必要澄清三个常见的误解，避免带着错误预期入门：

  • 它不是病毒软件。 它不删除系统文件，不注入代码，只用系统提供给机主的停用接口。仓库里也不含任何厂商固件或 APK。
  • 它不是万能去广告器。 它能停用预装应用、换掉推广首页，但视频 App 片头自带的贴片广告、内容平台自己的推广位，不在它的能力范围内。
  • 它不是"破解工具"。 它不绕过任何锁、DRM 或拷贝保护，只是把一个本就属于你的开关批量拨动。

一句话总结：CleanYourTV 是一个"用正规军手段打游击"的项目——用的全是系统明面上允许的操作，达成的却是过去只有刷机才能实现的效果。

认识了这个项目是什么，下一篇我们钻进它的工作原理，看看 ADB、无线调试和 pm disable-user 这三者是如何在不 Root 的前提下完成协作的。