17 天 50,040 Star：CleanYourTV 把智能电视的广告“禁“掉，凭什么是 GitHub 周榜第一

数据说明本文所有 Star/Fork 数字均取自 2026 年 11 月 3 日 GitHub API 实测快照功能与流程描述以 CleanYourTV 仓库 README 原文为准未作任何虚构。打开最近的 GitHub 榜单你会发现一个耐人寻味的现象涨星最快的不再是新的 AI 框架而是一批帮你的电视戒掉广告的工具。其中最猛的是Gathin23/cleanyourtv——10 月 17 日创建到 11 月 3 日 Star 已达 50,040日均涨星约 2,900拿下 trendshift 10 月 19–25 当周第一还被 TechCrunch、XDA 等 54 个国家的 412 篇媒体报道。任何一个买过智能电视的人对它的动机都不会陌生开机先看十几秒广告桌面首屏塞着赞助位推荐内容行里混着推广内容卸载不掉、关不干净。CleanYourTV 的 README 显示它已覆盖 416 个电视型号、106 个品牌正文翻译成近十种语言还有独立开发者基于它的清理清单做了手机、Mac 和 Windows 上的社区应用。一个 Python 工具仓库为什么能让全球开发者如此上头这篇文章把它的原理、命令和工程设计拆开看看中间有几处值得写脚本的人抄作业。一、不是孤例四个去广告项目同时在飞先看数据均为 2026-11-03 API 快照项目语言StarFork创建日期日均涨星(估算)一句话定位Gathin23/cleanyourtvPython50,0406,2992026-10-17≈2,944Wi-Fi 瘦身安卓/Google TV附 tvOS 风格桌面pengchujin/aerial-tvKotlin8,9877642026-10-20≈642参照 tvOS 的开源 Android TV 桌面无广告开机接管rddmwmddr/android-ad-cleanerPython5,8805302026-10-24≈588关闭国产安卓手机系统广告不 root、可还原simbasjungles/free-my-tvJava5,7269872026-10-19≈382Google TV / webOS / Tizen 的无广告主屏四个项目诞生时间集中在两周内诉求高度一致不 root、不动系统分区、随时可还原。它们瞄准的对象略有分工——cleanyourtv 和 aerial-tv、free-my-tv 主攻电视大屏android-ad-cleaner 清理手机HyperOS、ColorOS、OriginOS、MagicOS 都在其支持列表。而把它们串起来的技术底座只有一个词adb。二、原理拆解adb 直连 pm disable-userCleanYourTV 的核心洞察非常朴素Android TV 和手机用的是同一套调试桥。在电视的开发者选项里打开 USB 调试网络调试开关也一并打开电脑与电视处于同一 Wi-Fiadb 走 5555 端口直连接下来的操作就是标准 Android 工具链的活了。整个流程分三步README 原文给出的对应关系是步骤做什么备份记录当前安装的包列表和系统设置禁用用pm disable-user停用厂商的遥测、广告服务、内容推荐位和预装垃圾安装装一个小体积原生启动器572 KB支持 31 种语言并设为默认桌面最值得注意的设计决策是禁用而非卸载。这里先解释一下 Android 的机制系统给每个用户建了独立的包状态pm disable-user --user 0只是把包在主用户下标记为 disabledAPK 本体原封不动留在系统分区里。对比卸载路线——卸系统应用需要 root或用pm uninstall --user 0硬删、失败后难挽回——禁用的好处是天然的不需要任何提权随时可以用pm enable恢复restore 脚本因此能逐条精确撤销。它的本质就是你在手机上敲过的这条命令# 连上电视后本质等价于包名以工具生成的清单为准adb shell pm disable-user--user0广告服务包名把 README 里三步走背后的通用 adb 操作翻译出来大致就是下面这张表——理解了这一层这套思路完全可以迁移到手机、盒子上意图通用 adb 命令网络连接电视adb connect 192.168.1.50:5555列出全部包adb shell pm list packages禁用某包adb shell pm disable-user --user 0 包名恢复某包adb shell pm enable 包名另外各品牌电视的臃肿组件不一样所以工具不会一刀切按 README 的描述它先在你的电视上探测实际装了什么对你可能要用的应用会先询问再动手。所谓臃肿组件也不只是广告 SDK还包括遥测上报、首屏内容推荐行这类你现在大概率想关掉的东西。三、手动实操五条命令搞定一台电视不借助编码助手也能全手动完成。前置环境Python 3任意 3.x跑工具脚本JDK 17–22 加 Android SDK platform 34、build-tools 34 用于编译启动器——注意 README 特意提醒JDK 23 及以上版本会卡死 Gradle 8.9平台必须是 34更新的平台不能替代它。没有这些环境还有docker-build.shDocker 里构建内置 JDK 17 SDK 34本机只需要 Docker。gitclone https://github.com/Gathin23/cleanyourtvcdcleanyourtv python3-mvenv tools/venvtools/venv/bin/pipinstall-rtools/requirements.txtexportTV_HOST192.168.1.50# 电视的 IPtools/venv/bin/python-Itools/tv.py--probe# 探测型号、安卓版本、固件tools/venv/bin/python-Itools/tv.pypm list packages# 列出电视上的包tools/disable.sh examples/xiaomi-mi-tv-4a/debloat.txt# 按清单禁用以你的型号清单为准tools/restore.sh examples/xiaomi-mi-tv-4a/debloat.txt# 一行还原恢复原生桌面几个实现细节很见功力tools/tv.py是一个纯 Python 实现的 ADB 客户端shell、批量命令、push/pull、截图都支持在系统 adb 二进制被限制的环境里照样能跑Chromecast with Google TV 这类强制加密配对的设备先用官方 adb 配对再adb tcpip 5555即可接入往电视传 APK 的b64push.py用 base64 分块上传并校验绕开了直传的限制。官方口径下配合编码助手走完整个流程约 15 分钟。四、可回滚性是它的工程灵魂这项目最值得开发者学的不是 adb 技巧而是它把撤销做成了头等公民动手前先记录disable.sh改任何东西之前先把电视的原状写进~/.cleanyourtv/还原是重放记录restore.sh按记录逐条恢复你自己手动禁用的包不会被误启用桌面回到原来归属的组件固件升级后的漂移检测OTA 会把禁用的包原样装回来、桌面被厂商抢回去还会冒出新预装。这时check.py对比当前状态与清单--fix一键修正——这就是基础设施领域常见的 drift detection 思路被搬到了客厅设备上。对写运维脚本的人来说这三件套备份记录 → 幂等执行 → 漂移检测修复几乎可以直接套用到任何批量变更场景。它背后其实是两条朴素原则其一任何批量变更都应该是幂等的——同一份清单跑一遍和跑十遍结果应当一致这决定了--fix可以放心地反复执行其二外部环境是会漂移的——固件升级、配置变更、他人操作都会把系统状态拉离你的预期与其假设设过一次就永远生效不如像监控证书过期那样把复查差异做成周期性动作。README 甚至专门写了固件升级的故障恢复文档把什么时候会失效、怎么发现、怎么修复讲在前面这种坦诚在工具类项目里并不多见。五、给开发者的可操作建议网络 adb 是被严重低估的万能口。电视、盒子、手机、部分车机都暴露这套接口无需 root 就能做禁用、备份、截屏等大量操作。下次面对设备上不好删的东西先想想 adb。写自动化脚本先回答怎么撤销。备份先行、disable优于delete、操作记录落盘到用户目录——CleanYourTV 的 star 数证明随时能全身而退是用户敢用的前提。学它的 PROMPT.md 范式。这个仓库本身不是 AI 项目却把 vibe-coding 玩得很规范让编码助手复用仓库现成的disable.sh、build-and-install.sh而不是让 AI 现场发挥写一套。把仓库当上下文、把工具脚本当接口是眼下用 AI 做一次性运维任务的可靠姿势。风险要有预期。一是固件升级会翻旧账需要定期跑check.py二是给电视开 USB 调试属于官方开发者功能但部分厂商的保修条款未必友好动手前自行确认三是清理清单要过目别把自己在用的应用禁掉。顺手把隐私也收回来。被禁用的不只是广告位还有厂商的遥测上报服务。对隐私敏感的用户来说这可能比去掉开机广告更有价值。另外三星、LG、Roku、Vizio 和 Hisense VIDAA 这类非安卓系统跑不了这套方案但 CleanYourTV 官网给出了对应机型用遥控器关闭跟踪设置的指引同样值得一读。六、结语50,040 Star、两周内四个同类项目同时起飞说明买回来的硬件被广告围剿是真实的全球性痛点也说明开发者社区完全有能力用标准工具链给出体面的答案。CleanYourTV 没有任何黑科技它的成功公式是一个所有人都会的协议adb 一份克制的工程纪律可禁用、可备份、可还原、可检测漂移。如果你的智能电视还在开机推送广告不妨按上面五条命令试试如果你在写自动化工具不妨把可回滚三个字钉在显示器边上。本文数据为 2026-11-03 快照Star 数会继续变化工具用法请以仓库最新 README 为准。