CleanYourTV 本机实测：不用 Root，国产 Android 电视怎么停用开机广告

GitHub实测笔记
9 阅读6分钟

CleanYourTV（GitHub 高星）用 ADB 停用电视广告/统计组件，可一键还原，无需 Root。本文记录本机环境搭建、probe 连不上、小米输入法坑，以及适用/不适用机型。按步骤可复现，文末有安全提醒。

国产 Android 电视开机广告、强制推荐、统计组件，关起来往往在层层菜单里绕圈。CleanYourTV 的思路很直接：电视和手机一样支持 ADB，连上之后用 pm disable-user 停用（不是卸载）厂商广告/统计包，再换干净桌面；后悔了可以一键还原。不用 Root，也不用拆机。

下面是我对这个仓库的 本机实测笔记：电脑侧 clone / venv / --probe 已经跑过；电视端菜单与去广告命令尚未在真机上验证，文中会标明，不装成「已经拍完截图」。

项目是什么

  • 仓库：github.com/Gathin23/cl…
  • 数据读取：trendshift 2026-10-19～25 当周第一；GitHub 约 4.1 万星（2026-10-28 读取，星数会变）
  • 核心手段：pm disable-user 停用广告/统计/推荐相关组件 + 可选干净桌面；提供 restore 一键还原

适用范围（先看再动手）

适用

  • Android TV / Google TV
  • 仓库 examples/ 里已有大量机型配置（样稿统计约 342 个），国产不少：小米/Redmi（如 mi-tv-4a、mitv 各型号、tv-a-pro-2026）、TCL（含 tcl-mt9655-cn-android14 等）、海信、创维、酷开、海尔等

不适用

拿不准自己的系统是不是 Android TV：先看设置里有没有「开发者选项 / USB 调试 / 网络调试」一类入口；没有就别硬套本教程。

实测范围声明（重要）

步骤状态
git clone、venv、装依赖、tools/tv.py --probe✅ 本机电脑已跑通
电视上开 USB/网络调试的菜单路径⚠️ 按官方/README 整理，未在真机逐项截图验证
disable.sh / restore.sh / 换桌面⚠️ 命令来自仓库，未在真机执行验证
小米输入法坑来自项目 docs（TROUBLESHOOTING），本机未复现到真机画面

后文凡写「需要真机」处，请以你自己电视上的菜单名为准；品牌不同，文案差很多。

第 1 步：电视上开启调试（需真机）

通用路径大致是：

  1. 设置 → 设备偏好设置 → 关于
  2. 在「版本号」上连按 OK 键约 7 次，打开开发者模式
  3. 返回 → 开发者选项 → 打开 USB 调试
  4. 若有「网络调试」或「ADB 调试」，一并打开

记下电视的局域网 IP（设置 → 网络里一般能看到）。

截图位（待补）：开调试前后的设置页、网络 IP 页。国产机菜单名各异，正式发第二版前建议按你的品牌补真机图。

第 2 步：电脑上准备（本机已实测）

环境：Linux / macOS / Windows（有 Python3、git）均可；下面命令按 Unix 风格写。

git clone https://github.com/Gathin23/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 --probe

本机踩坑 1：probe 连不上

连不上时常见提示类似 「refused the connection」，含义一般是：

  • 电视没开网络 ADB，或
  • 不是默认 5555 端口

部分盒子要先用官方 adb 配对一次：

adb pair <电视IP>:<配对端口>
adb tcpip 5555

再回到仓库的 --probe。本机实测时，在未开网络调试的情况下会直接 connection refused；开好调试并换对 IP 后，probe 才能往下走。

截图位（待补）：probe 成功时的终端输出。

第 3 步：去广告（以小米电视 4A 配置为例，命令未真机验证）

仓库按机型给了 debloat.txt。以小米 4A 为例：

tools/disable.sh examples/xiaomi-mi-tv-4a/debloat.txt   # 停用
tools/restore.sh examples/xiaomi-mi-tv-4a/debloat.txt   # 后悔了可以一键还原

配置里第一组常是小米统计相关包（如 com.miui.tv.analytics、com.xiaomi.statistic）。不想停某一项，在该行前加 # 即可。

本机踩坑 2：小米输入法（文档坑，真机未复现）

项目文档提到：部分固件默认输入法指向 未安装的百度输入法，搜索框弹不出键盘。处理思路是把 Gboard（或你已安装的可用输入法）设为默认，详见仓库 docs/TROUBLESHOOTING.md。

我这边 没有在真机上弹出过这个键盘问题，只核对了文档描述；若你踩到，欢迎评论区报机型 + 固件，方便补进后续修订。

找自己的机型：到 examples/ 里搜品牌关键词；没有现成文件时，不要盲目套用别的机型的 debloat 列表。

第 4 步：换干净桌面（可选，未真机验证）

launcher/build-and-install.sh

系统升级后广告组件可能被厂商恢复，可用：

tools/venv/bin/python -I tools/check.py <你的配置文件> --fix

补回去。

安全提醒（必做）

用完关掉 ADB / 网络调试。 可用：

tools/venv/bin/python -I tools/adb-closed.py

检查是否已经关好。调试口长期开着等于局域网里多了一扇门。

进阶：交给 AI 编程助手（可选）

仓库提供 PROMPT.md：可贴给 Codex、Gemini CLI 等助手，让它先扫描电视再问你保留哪些应用。官方说法大约十几分钟量级——我未完整跑通这条 AI 助手链路，仅作能力说明，不保证你的环境同样省事。

踩坑清单（汇总）

  1. probe refused：先确认网络调试 / 端口 5555 / IP 是否对；必要时 adb pair + adb tcpip 5555。
  2. 小米搜索无键盘：查默认输入法是否指向未安装包；改 Gboard 等可用输入法（见 TROUBLESHOOTING）。
  3. 机型配置不对：务必用 examples/ 里匹配型号；乱套可能停错组件。
  4. 升级后又有广告：用 check.py ... --fix，并接受厂商可能再塞回组件的事实。
  5. 做完忘关 ADB：局域网风险；用 adb-closed.py 自检。

小结

CleanYourTV 把「停广告组件 + 可还原」做成了脚本化流程，对 Android TV / 国产机型覆盖面不小。电脑侧环境我这边已经能 clone、建 venv、跑 probe；电视菜单与 disable/restore 仍需你（或下一版我）用真机补截图和报错原文。

如果你已经在某一款小米 / TCL / 海信上跑通，欢迎在评论区留下：机型全称、系统版本、用的哪个 examples/ 文件、卡在哪一步——比空赞更有用。

如果这篇帮到你，欢迎点赞收藏，并关注专栏「GitHub实测笔记」——每周一篇热门仓库中文实测。
下一篇预告：继续从 GitHub Trending 里挑一个有明确痛点、能本机安装的开源工具（候选会在沸点里征集）。
有问题直接评论区问，看到都会回。

声明：本文初稿由 AI 辅助整理自项目 README 与文档，电脑侧第 2 步（clone / venv / probe）已在本机实测；电视端开调试、去广告、换桌面步骤尚未经真机验证，不虚构截图。转载请注明出处与实测范围。

avatar
文章
阅读
粉丝