CleanYourTV 电视去广告完整指南：Wi-Fi 下禁用广告包并一键还原的操作教程
【免费下载链接】cleanyourtvDebloat any Android or Google TV over Wi-Fi and get an Apple TV-style home.项目地址: https://gitcode.com/gh_mirrors/tv/cleanyourtv
想让电视不再弹赞助行、后台不再回传遥测，又不想插线也不想卸载任何东西，CleanYourTV 提供的方案就落在这几行命令上：全程走 Wi-Fi 调试通道，只调pm disable-user把广告与预装包在用户 0 里禁掉，不 root、不碰系统分区，一条还原命令就能退回去。风险集中在"禁错包"这一点上，而仓库脚本把这类拦截做成了硬性拒绝，翻车概率压得很低。
能不能用：适用与排除清单
- ✅ Android TV 与 Google TV 全系：去广告和换桌面都支持，
examples/里已有 345 个机型的实测清单可直接起步。 - ⚠️ Fire TV：Fire OS 不认第三方启动器，只能做到去广告这一半；2015 年 Fire TV Box（Fire OS 5）连
pm命令都会拒绝，这半边也做不了。 - ⚠️ 少数中国市场的 TCL 机型：固件拒绝安装任何第三方启动器，清单头部有标注，只能去广告。
- ⚠️ 安卓老机型：新桌面要求 Android 8.0（minSdk 26），更老的机器只能保留原生桌面做去广告。
- ❌ 三星 Tizen、LG webOS、Roku、无 ADB 通道的盒子：系统不通，本方案进不去。
前置自检：环境与连通性
电视侧
- 设置 → 设备偏好 → 关于，用遥控器确认键连点 7 次"版本"，返回后"开发者选项"解锁；
- 打开 USB 调试；有"网络/ADB 调试"开关的话一并打开——小米等机型没有独立开关也正常，开了 USB 调试，5555 端口的网络 ADB 会自动放行；
- 记下电视 IP（设置 → 网络 里可见），确保电脑与电视同网段。
电脑侧
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 tools/venv/bin/python -I tools/tv.py --probetv.py是纯 Python 的 ADB 客户端，不依赖 adb 二进制，绕开了部分系统对 adb 的本地网络拦截。跑--probe时电视会弹"允许 USB 调试？"，用遥控器确认；成功后终端打印出型号、Android 版本和 SDK 号，链路即通。
主线操作：最短可复现路径
第 1 步：挑一份禁用清单。做什么：examples/下每机型一个文件夹，先看有没有你的型号；没有就用相近机型的debloat.txt做底稿。 你会看到：清单里一行一个包名，#注释按"遥测 / 广告内容 / 预装杂包"分组，想留哪个就注释掉哪行。没有现成清单时先跑一次隐私审计，它把语音、ACR、遥测候选连同证据列出来，--write直接生成一份disable.sh认得的清单：
TV_HOST=192.168.1.50 tools/venv/bin/python -I tools/privacy.py --write第 2 步：批量禁用。做什么：把清单交给disable.sh，脚本逐包下发pm disable-user --user 0 <包名>，并自动回读电视核验。 你会看到：三类硬性拦截——清单里混入 Android 核心包时整单拒绝且电视零改动；清单想禁掉当前唯一 Home 且新桌面还没装时，跳过启动器那一条（此时禁掉它，Home 键会掉进厂测界面或黑屏）；请求TV_INPUT_HARDWARE的包照禁会让 HDMI 口"认线不出图"，也会被跳过。脚本末尾列出"仍被固件拒绝"的包名，全空即成功。
TV_HOST=192.168.1.50 tools/disable.sh examples/xiaomi-mi-tv-4a/debloat.txt第 3 步：装新桌面。做什么：build-and-install.sh编译约 530 KB 的启动器 APK，推送安装并把 Home 切到com.gathin.tvhome，Home 没接管会自动回滚。它要求本机有 JDK 17 和 Android SDK 34。 你会看到：电视回到一个纯黑、底部 dock 固定四个应用的新界面。
TV_HOST=192.168.1.50 launcher/build-and-install.sh装完再跑一遍第 2 步的同一条命令，把原生启动器补禁掉。想换配色不重编译：
TV_HOST=192.168.1.50 tools/theme.sh themes/aurora核验：怎么确认改对了
TV_HOST=192.168.1.50 tools/venv/bin/python -I tools/check.py examples/xiaomi-mi-tv-4a/debloat.txt以退出码和漂移明细为准：输出被重新启用的包和 Home 归属变化，退出 0 表示电视与清单完全一致；pm list packages -d --user 0的-d输出是最终裁决。
回退：不满意如何还原
TV_HOST=192.168.1.50 tools/restore.sh examples/xiaomi-mi-tv-4a/debloat.txt还原依赖disable.sh动手前写入~/.cleanyourtv/的状态记录，所以必须传当初那份清单——你本来就禁着的包不会被误开，Home 归还原持有者，动画参数也一并复位；新启动器仍留在电视上，想删掉就进 设置 → 应用 卸载它。两个已知边界：清理中途电视地址变过（DHCP 重分、改网），记录按地址存档，还原会找不到旧档，先回旧地址跑；还原后再应用清单若出现"选择 Home 应用"提示，重跑build-and-install.sh即可。
高频坑速查
| 现象 | 原因 | 处理 |
|---|---|---|
macOS 报No route to host，路由器却能通 | 系统"本地网络"隐私策略拦的是你的终端 App | 系统设置 → 隐私与安全性 → 本地网络 允许终端，关掉重开再试 |
| Home 键落黑屏或厂测界面 | 新桌面未接管就禁了原生启动器 | 先跑build-and-install.sh，再补跑disable.sh |
| Google TV 黑屏、system_server 反复重启 | setupwraith 抢答 HOME 并进入恢复界面 | 先把com.google.android.tungsten.setupwraith禁掉；它持有已存 Wi-Fi 时先去设置遗忘再重连该网络 |
| 换桌面后搜索框不出键盘（小米常见） | 默认输入法指向未安装的百度 IME | tools/tv.py 'ime set com.google.android.inputmethod.latin/com.android.inputmethod.latin.LatinIME' |
| 5555 端口始终连不上 | 机型只有 Wireless debugging 配对模式 | adb pair <ip>:<端口> <码>配对一次，再adb tcpip 5555，之后tv.py照常工作 |
| 固件更新后广告行复活 | 更新把禁用的包重新启用 | check.py <清单>看漂移，加--fix重新执行一遍 |
延伸资源
- 完整故障清单：docs/TROUBLESHOOTING.md
- 桌面逐项设置与构建：docs/launcher.md
- 还原机制细节：docs/restore.md
- 固件更新后的例行检查：docs/firmware-updates.md
- 隐私审计说明：docs/privacy.md、tools/privacy.py
- 主题目录：themes/；插件目录：addons/
- 机型清单索引：examples/README.md
【免费下载链接】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），仅供参考