安卓电视去广告完整指南：CleanYourTV 一键换掉广告桌面，全程可逆
【免费下载链接】cleanyourtvDebloat any Android or Google TV over Wi-Fi and get an Apple TV-style home.项目地址: https://gitcode.com/gh_mirrors/tv/cleanyourtv
CleanYourTV 是开源的安卓电视去广告工具包：通过网络 ADB 连接电视，批量禁用广告推送、厂商遥测和预装垃圾应用，再装上一个 Apple TV 风格的迷你启动器当新桌面。全程只用"禁用"不卸载，一条脚本就能全部还原，1GB 内存的老电视也跑得动。
为什么值得折腾
原装 Google TV 的首页顶部常年挂着 "Sponsored" 广告横幅，下面跟着刷不完的推荐内容位。电视芯片内存普遍只有 1GB，广告服务和推荐流在后台一直轮询，越用越卡。
CleanYourTV 的思路很直接：把广告服务、推荐行、厂商遥测和用不上的预装应用统统关掉，再把首页换成一个只有约 532 KB 的本地启动器——没有广告位，也没有网络请求。
✋ 动手前的准备
先做四件事，都围绕"让电脑能碰到电视"：
- 把电脑和电视连到同一个 Wi-Fi，电视保持开机
- 在电视的"设置 → 网络"里记下它的 IP 地址
- 开启开发者选项：电视上依次进设置 → 设备偏好 → 关于，在 "Build（版本）" 上连按OK 键 7 次解锁；返回进入开发者选项，打开USB 调试（如果看到 "网络 / ADB 调试"，一并打开）
- 在电脑上克隆仓库并建好 Python 虚拟环境：
git clone https://gitcode.com/gh_mirrors/tv/cleanyourtv cd cleanyourtv python3 -m venv tools/venv && tools/venv/bin/pip install -r tools/requirements.txt export TV_HOST=192.168.1.50 # 换成你家电视的 IP💡 两个容易卡住的点：部分电视打开 USB 调试后会切断 USB 口供电，插着的 USB 网卡会掉线，所以建议一口气做完；少数 Google TV 设备只有"无线调试"，需要先配对接入，仓库自带排错文档 docs/TROUBLESHOOTING.md 里有配对步骤。
🧹 去广告三步走
工具都是纯 Python，不依赖 adb 二进制——tools/tv.py 直接以纯代码实现 ADB 协议（ADB 是电脑与电视之间的远程调试通道），顺便绕开了 macOS 对 adb 的拦截。
第一步：探测电视
tools/venv/bin/python -I tools/tv.py --probe跑完会打印电视型号、Android 版本和固件，先确认连对了设备。它也能执行单条 shell 命令，比如tools/venv/bin/python -I tools/tv.py 'pm list packages'列出电视上全部应用。
第二步：应用去广告清单
tools/disable.sh examples/xiaomi-mi-tv-4a/debloat.txt清单每行一个包名，脚本逐条用pm disable-user（Android 包管理命令行，效果等同于在系统"设置 → 应用"里点禁用）关掉它们。动手前它会把电视当前状态记录到~/.cleanyourtv/，这就是后面还原的依据。examples/ 下每个电视型号一个文件夹，xiaomi-mi-tv-4a/debloat.txt 按厂商遥测、PatchWall 广告、预装应用分组并带注释，想保留哪条就注释哪一行。
第三步：拉截图验证
tools/venv/bin/python -I tools/tv.py --screenshot before.png命令会把电视当前画面抓下来存到电脑，打开看一眼：横幅没了、推荐位没了，就算这一步过关。
省力分支：不想敲命令，就在仓库目录里打开任意能执行命令的编程助手（Claude Code、Gemini CLI 均可），粘贴 PROMPT.md 的提示词并填上电视型号，电视上点"允许 USB 调试"，再回答几道勾选题（常用哪些应用、dock 放几个、要不要留语音助手和 Chromecast），助手会自己跑完备份 → 禁用 → 编译安装启动器 → 截图验证。
🏠 把桌面做减法
启动器装在 launcher/，一条命令编译、安装并切换首页，切换失败会自动回滚：
TV_HOST=192.168.1.50 launcher/build-and-install.sh（电脑需要 JDK 17 和 Android SDK，电视需 Android 8.0 及以上。）
装上后是这样：纯黑背景、大号细体时钟和日期、底部圆角 dock 放 4 个自选应用、按"下"键滑出完整应用网格、一块半透明玻璃高亮在图标间弹跳，右上角是输入源 / Wi-Fi / 设置的三个毛玻璃按钮。没有模糊、没有视频、没有后台服务。
个性化只改一个文件 launcher/app/src/main/res/values/config.xml：dock_apps定 dock 顺序、hidden_apps定隐藏应用、live_tv_package定直播包名、网格列数 4~7 任选，改完重新构建安装即可。懒一点也行——tools/theme.sh themes/aurora把主题直接推到电视上，换个壁纸和配色不用重新编译。
🎛️ 避坑速查表
| 症状 | 怎么处理 |
|---|---|
macOS 上adb connect报 "No route to host" | 电视没掉线，是新版 macOS 的本地网络隐私策略在拦 adb 程序。别和它纠缠，直接用纯 Python 的 tools/tv.py |
| 换完首页，搜索框里没有键盘 | 部分机型默认输入法指向了一个被禁用的预装键盘。执行tools/tv.py 'ime set com.google.android.inputmethod.latin/com.android.inputmethod.latin.LatinIME'指回 Gboard |
| 按 Home 键进了工厂测试页 | 顺序反了：新启动器还没就位就关了旧的。先构建安装新启动器，再处理清单里的旧启动器，脚本已内置这个保护 |
一行连着写多条pm命令，只有第一条生效 | pm命令一条一个 shell 调用，连写会静默停在第一条。仓库内脚本已按这个方式处理 |
适用范围与安全性
- 支持：任何 Android TV / Google TV（Xiaomi、TCL、Hisense、Sony、OnePlus、Nvidia Shield 等均有现成清单）；Fire TV 只能做去广告的一半，因为 Fire OS 不肯把首页交给第三方启动器。
- 不支持：Samsung Tizen、LG webOS、Roku、Vizio、Hisense VIDAA——这些系统没有 ADB，整套 Google TV 去广告流程用不上。
安全性的底牌在于：不 root、不刷机、不卸载，所有 ADB 禁用预装应用的动作都是pm disable-user，和你在应用设置里点"禁用"是同一个开关。tools/restore.sh 读取 tools/disable.sh 留下的记录，一条命令就能还原所有设置：
TV_HOST=192.168.1.50 tools/restore.sh examples/xiaomi-mi-tv-4a/debloat.txt电视上原来被禁用的应用保持原样，首页交还给原装启动器；连电脑都够不着时，电视自己的"设置 → 应用"页也能逐个重新启用。固件更新把广告刷回来？tools/check.py对比清单并可用--fix一键补回。
广告清空了，桌面归你了，反悔也只是一条 restore 命令的事。去 examples/ 里翻翻有没有你的电视型号，没有的话，那份清单就是留给你的位置。
【免费下载链接】cleanyourtvDebloat any Android or Google TV over Wi-Fi and get an Apple TV-style home.项目地址: https://gitcode.com/gh_mirrors/tv/cleanyourtv
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
