CleanYourTV 从 ADB 连接到换 Apple TV 风格桌面完整实操（附型号清单与避坑）

背景

Gathin23/cleanyourtv 是一个基于 ADB 的 Android TV/Google TV 精简工具：通过 WiFi 远程禁用厂商广告、遥测、预装包，并替换为一个约 405KB 的极简 launcher。不 root、不卸载，所有操作可逆。截至 2026-10-21，仓库已积累 49 个品牌、147 个型号的现成 debloat.txt 清单，launcher 已支持 21 种语言。

本文梳理从零跑通的完整路径，以及几个实测容易踩的坑。

前置条件

• 电视：Android TV 或 Google TV（Xiaomi/TCL/Sony/Hisense/Philips/OnePlus/Nvidia Shield/Chromecast with Google TV）。Samsung Tizen、LG webOS 不支持。

• 电脑：macOS/Linux/Windows 均可，Python 3、JDK 17、Android SDK Platform 34。

• 同一局域网：电视和电脑连同一个 WiFi。

• 仓库：https://github.com/Gathin23/cleanyourtv

第一步：电视端开调试

1. 设置 → 系统 → 关于，连续按 7 次版本号，开启开发者选项。

2. 设置 → 开发者选项 → 打开 USB 调试；有"无线调试"开关一并打开。

3. 设置 → 网络 → 状态，记下电视 IP（192.168.x.x）。

第二步：连接与探测

git clone https://github.com/Gathin23/cleanyourtv.git
cd cleanyourtv
python3 -m venv tools/venv
export TV_HOST=192.168.x.x
tools/venv/bin/python -I tools/tv.py --probe
tools/venv/bin/python -I tools/tv.py 'pm list packages'

首次连接电视上会弹授权框，用遥控器确认。Android 11+ 无线调试需要按屏幕配对码先 pair 再 connect。

第三步：先备份，再禁用

不要跳过备份。disable.sh 会在改动前把每个包的启用状态、原 launcher、动画设置记录到 ~/.cleanyourtv/，这是后续 restore 的依据。

# 找自己型号对应的清单
ls examples/

# 以某型号为例
tools/disable.sh examples/<model>/debloat.txt

清单分组原则：

1. 遥测与 ACR（Samba TV、Alphonso 等）

2. 厂商广告与内容服务（推荐横栏、商店演示模式）

3. 后台冗余（重复投屏、清理类）

4. 预装 App

5. 询问用户后再决定（流媒体、语音助手、系统更新）

6. 绝不动：HDMI/天线输入服务、遥控器与蓝牙、输入法、Play Store 与 Play Services、com.android.location.fused（停了会开机循环）

已知品牌坑（重点）

下表来自 Mert Cobanov 的中文指南和社区实测，停错一个就可能切不了 HDMI 或者断 WiFi：

包名	看起来像	实际是	停了会怎样
com.tcl.suspension	悬浮窗/垃圾服务	遥控器信号源菜单	切不了 HDMI
com.tcl.ttvs	TTS 语音朗读	系统更新服务	更新菜单无响应
com.tcl.tv / com.tcl.tvinput	无关	HDMI/天线输入服务	完全看不到外接设备
com.tcl.providers.config / com.tcl.initsetup	无关	网络配置/开机向导	WiFi 直接断掉
com.google.android.tv.remote.service / com.tcl.tcl_bt_rcu_service / com.tcl.autopair	无关	遥控器与蓝牙配对	遥控器失灵

补充一句：国内特供版 TCL（不带 Google 服务）的包名和国际 Google TV 版本差很多，ZNDS 上玩家总结的 V8-A963T01 机芯精简清单里出现的是 com.tcl.ads、com.tcl.ota、com.tcl.usercenter 这一类，跟国际版不是一套东西。别直接照抄国际版清单上国内特供机。

第四步：构建并替换 launcher

顺序很重要：先确认新 launcher 能跑，再停旧 launcher。反过来就是黑屏。

TV_HOST=192.168.x.x launcher/build-and-install.sh

脚本会自动识别原 HOME、装新 launcher、切默认 HOME，异常时回退。装完用实体遥控器按 Home 验证，再测：信号源切换、Netflix/YouTube 启动、蓝牙遥控器、HDMI。

第五步：恢复与收尾

任何时候想还原：

tools/restore.sh examples/<model>/debloat.txt

收尾必做：

• 关闭电视的 USB/网络调试，撤销调试授权；

• 重启电视，确认端口不再开放；

• ACR（自动内容识别）是另一回事，去电视 设置 → 隐私 里单独关，比如 Sony 的 Samba Interactive TV、LG 的 Live Plus。

不支持/高风险情况

• Samsung Tizen、LG webOS：完全不支持。

• Fire TV：只能 disable，不能换 launcher（Fire OS 不让第三方 HOME 接管），可看 humblemuzzu/dumbtv。

• 国内特供 TCL 不带 Google 服务：部分固件只允许厂商签名 HOME，此时不要强行替换，只做 disable 部分。

• 任何操作中途电视变砖：物理遥控器进 设置 → 应用，手动 enable 最后一批包。

参考

• 官方仓库：https://github.com/Gathin23/cleanyourtv

• 原始方法论文：https://tv.cobanov.dev/

• Fire TV 衍生：https://github.com/humblemuzzu/dumbt

转载自 CSDN-专业IT技术社区

原文链接：https://blog.csdn.net/luzhiqiubiji/article/details/168657505