CleanYourTV：让 AI 助手帮你清理安卓电视的广告和预装应用

开机先看一段广告，主页一半位置是推荐的影视剧，设置里还有一堆叫不出名字的后台服务。用过国产安卓电视的人，大概都对这个界面不陌生。

CleanYourTV 就是冲着这个来的。它通过局域网连上电视，把广告、推荐内容、数据上报服务和用不到的预装应用停掉，再装一个只放常用应用的桌面。整个过程不用 root，也不用刷机，电脑和电视在同一个 Wi-Fi 下就行。

Gathin23

cleanyourtv

Debloat any Android or Google TV over Wi-Fi and get an Apple TV-style home.

—

NOASSERTION

Python

它到底做了什么#

流程很简单：先把电视上每个应用的状态和默认桌面记下来，然后用 pm disable-user 停掉列表里的应用，最后编译安装它自己的桌面，设成默认主屏幕。

我觉得最关键的是第二步用”停用”而没用”卸载”。系统应用还在，只是不跑了，想要回来随时能启用。项目自带的 tools/restore.sh 会照着第一步的记录，把应用一个个恢复。

停用列表是按机型整理的纯文本。拿小米电视 4A 那份来看，一共 42 行，按用途分了组：

1
# Xiaomi telemetry
2
com.miui.tv.analytics
3
com.xiaomi.statistic
4

5
# PatchWall and Mi content rows / promos
6
com.mitv.tvhome.atv
7
com.mitv.tvhome.michannel
8
...
9
com.xiaomi.mitv.updateservice          # re-enable to check for firmware updates

开头两行是小米的数据统计，接着是 PatchWall 桌面的推荐内容。系统更新服务也在里面，注释写着想检查固件更新时再打开。哪一行不想停，前面加个 # 就行。

最特别的地方：让 AI 助手来操作#

这个项目推荐的用法，是把活交给 Claude Code、Codex、Gemini CLI 这类能跑终端命令的编程助手。

仓库里有一份 PROMPT.md，是写给 AI 助手的完整操作说明。你把它发给助手，填上电视型号，助手会先在局域网里找到电视、用 ADB 连上，动手前备份应用列表和系统设置。然后它会问你平时看哪些应用、要不要留着语音助手和投屏，再照你的回答去停用，每做一步都从电视上截一张图确认。最后编译桌面、装上、设成默认。

仓库根目录还放着 CLAUDE.md、AGENTS.md、GEMINI.md，分别写给不同的助手。可以看出作者一开始就打算让人只管回答问题，具体操作交给 AI。

我觉得这个思路挺对路。每台电视的预装应用都不一样，同一个牌子换个固件，包名也会变，很难写出一个通吃的脚本。让助手现场看、现场判断，反而更靠谱。说明里还专门交代助手优先用仓库里的 tools/disable.sh，别自己另写，因为备份和保护默认桌面的逻辑都在这个脚本里。

不过让 AI 在电视上执行命令，我还是会盯着它每一步在干什么，尤其是它要停用一个你没听说过的系统组件时。

支持哪些电视#

只支持 Android TV 和 Google TV。三星 Tizen、LG webOS、Roku 都不是安卓，用不了。Fire TV 只能参考它的清单自己手动弄。

examples/ 目录里有 443 个机型的停用列表，都是社区拿真机验证后提交的。我数了一下国内常见的牌子：

品牌	收录机型数
TCL	80
小米	42
海信	16
创维	14
海尔	6
酷开	2
长虹、康佳	0

收录得多，不代表一定能用。README 特意提醒，部分国行电视会拒绝装第三方 APK，或者不让换默认桌面，TCL 就有这样的型号。这种电视还能停掉广告和预装应用，新桌面就未必装得上了。具体要看型号和固件，光看牌子判断不了。

另外，桌面要求 Android 8.0 以上。有些老电视在清单里，系统版本却不够，桌面一样装不了。

换上的桌面长什么样#

深色背景，底部一排常用应用，默认 4 个。焦点移到哪个应用上，就显示它的名字，背景颜色也跟着这个应用的横幅或图标变。往下按是更多应用，每行可以放 4 到 7 个。

用遥控器就能调整顺序：长按设置按钮进入排序模式，方向键挪位置。仓库里有 21 套主题，换颜色、壁纸、列数都不用重新编译。还有 30 多个扩展卡片，天气、世界时钟、睡眠定时、蓝牙开关都有，别的应用想往桌面上放卡片，得你点头才会出现。电视的屏保设置里也能选它自带的时钟屏保。

界面有简体中文，跟着系统语言走。

门槛在于仓库没有现成的 APK，桌面得在自己电脑上编译，要装 JDK 17 和 Android SDK。用 AI 助手的话，这一步也可以让它代劳。

动手前要注意什么#

用完一定要把调试关掉。这个项目走的是网络 ADB，默认 5555 端口，连接是明文的，有些电视固件甚至不检查授权。调试一直开着，同一个网络里的任何设备都可能控制你的电视。

Warning

别为了远程操作，在路由器上把电视的 5555 端口映射到公网。要远程帮家里人弄，README 推荐用 Tailscale 这类私有网络。

停用也可能停出问题。东西虽然没删，停错了照样出故障。README 里记了一个例子：Google TV 停掉原桌面后，系统的设置向导可能会占掉主屏幕。稳妥的做法是分批停，每停一批就重启看看，遥控器、输入源切换、常用应用都正常再继续。

很多停用列表会关掉厂商的系统更新服务，所以之后想升级固件，得先把它重新打开。

还有个容易踩的坑：PROMPT.md 里提到，有些电视盒子开了 USB 调试会切断 USB 口供电，插在上面的 U 盘、音箱、USB 网卡都会失灵。如果你的电视靠 USB 网卡上网，最好一口气做完，别分两次。

上手步骤#

有两种用法，交给 AI 助手，或者自己敲命令。电视这边的准备工作是一样的。

第一步：电视上打开调试#

打开「设置 → 设备偏好设置 → 关于」，在「版本号」（有的叫 Build）上连按七次确定，会提示已进入开发者模式
返回上一级，进「开发者选项」，打开「USB 调试」。如果还有「网络调试」或「ADB 调试」开关，也一起打开
到网络设置里记下电视的局域网 IP，比如 192.168.1.50

每个牌子的菜单名称都不太一样，找不到就在设置里搜”开发者”。

Tip

有些 Google TV 只有「无线调试」，要先用配对码配对，才能走 5555 端口。用 AI 助手的话它会处理；自己操作的话，看仓库 PROMPT.md 里连接那一节。

第二步（方式一）：交给 AI 助手#

我更推荐这种。电脑和电视连同一个网络，然后：

1
git clone https://github.com/Gathin23/cleanyourtv
2
cd cleanyourtv
3
claude   # 或者 codex、gemini

一定要在仓库目录里启动助手。这样它会直接用仓库里的 tools/disable.sh 和 launcher/build-and-install.sh，备份、保护默认桌面、恢复的逻辑都在里面，它就不会自己另写一套。

接着把 PROMPT.md 整段发给它，把里面的 <MODEL NAME HERE> 换成你的电视型号。之后助手会一步步往下走，你只需要做几件事：

电视弹出「允许 USB 调试吗」时点允许，助手会提前告诉你什么时候弹
回答它的问题：平时看哪些应用、底部快捷栏放哪几个、语音助手和投屏要不要留、还要不要收系统更新
最后自己检查一遍，常用应用能不能打开，遥控器每个键是否正常，HDMI 等输入源能不能切

第二步（方式二）：自己敲命令#

需要 Python 3。下面的命令都在仓库根目录里跑，IP 换成你电视的。

准备连接工具，看看电视的信息#

1
python3 -m venv tools/venv
2
tools/venv/bin/pip install -r tools/requirements.txt
3
export TV_HOST=192.168.1.50
4

5
# 读取型号、Android 版本和固件
6
tools/venv/bin/python -I tools/tv.py --probe
7

8
# 列出已安装的应用
9
tools/venv/bin/python -I tools/tv.py 'pm list packages'

停用应用#

先在 examples/ 里找到型号和固件都对得上的目录，读一下里面的 README，再执行：

1
tools/disable.sh examples/你的机型/debloat.txt

别直接拿其他机型的列表来用。不想停的应用，在那一行前面加 #。脚本会把停用前的状态记到电脑上的 ~/.cleanyourtv/ 目录里，之后恢复要靠它。

编译并安装桌面#

需要 JDK 17、Android SDK Platform 34 和 Build Tools 34.0.0。macOS 上可以这样装：

1
brew install openjdk@17 android-commandlinetools
2
sdkmanager "platforms;android-34" "build-tools;34.0.0"

然后一条命令编译、安装、切换默认桌面：

1
TV_HOST=192.168.1.50 launcher/build-and-install.sh

脚本会先确认新桌面能启动，再把它设成默认，同时停掉原来的桌面。想留着原桌面，就加上 STOCK_LAUNCHER=none。注意这只是不停用原桌面，默认桌面照样会换成新的：

1
TV_HOST=192.168.1.50 STOCK_LAUNCHER=none launcher/build-and-install.sh

换个主题（可选）#

1
TV_HOST=192.168.1.50 tools/theme.sh themes/aurora    # 换主题
2
TV_HOST=192.168.1.50 tools/theme.sh --reset          # 恢复默认

Windows 用户用仓库里对应的 .ps1 脚本，用法见 README 的 Windows 一节。

第三步：关掉调试#

全部弄完后，回到「开发者选项」，关掉 USB 调试和网络调试，再撤销已经授权过的电脑。5555 端口的连接是明文的，一直开着不安全。

后悔了怎么恢复#

用停用时的同一份列表：

1
TV_HOST=192.168.1.50 tools/restore.sh examples/你的机型/debloat.txt

脚本会照着 ~/.cleanyourtv/ 里的记录，把应用和原来的默认桌面恢复回去。停用之前本来就关着的应用，恢复后还是关着。

新桌面不会被恢复脚本卸载，要删就去电视的「设置 → 应用」里删。连不上 ADB 的时候，也可以直接在电视的应用设置里，把停掉的应用一个个重新启用。

最后#

如果你的电视是安卓系统，开机广告和推荐内容让你烦，又不想刷机，可以先去 examples/ 里搜一下自己的型号。有收录的话，读完那个目录里的说明和已知问题再动手。没收录也能用，助手会现场检查你的电视，只是要多花点时间确认哪些能停、哪些不能停。

CleanYourTV：让 AI 助手帮你清理安卓电视的广告和预装应用

它到底做了什么#

最特别的地方：让 AI 助手来操作#

支持哪些电视#

换上的桌面长什么样#

动手前要注意什么#

上手步骤#

第一步：电视上打开调试#

第二步（方式一）：交给 AI 助手#

第二步（方式二）：自己敲命令#

准备连接工具，看看电视的信息#

停用应用#

编译并安装桌面#

换个主题（可选）#

第三步：关掉调试#

后悔了怎么恢复#

最后#

文章分享