老电视救星?跟着开源项目把旧电视"翻新"一遍

原创2026-10-19 19:02:531,873 阅读
文章标签:智能硬件开发工具

老电视救星?跟着开源项目把旧电视"翻新"一遍

家里的 Android TV 电视是不是越来越难用了?开机是厂商强推的"精选内容"和广告位,遥控器翻半天找不到自己要的应用,明明配置不低却越来越卡。大多数老电视硬件本身没坏,坏的是那层越堆越厚的系统软件:预装的遥测组件、内容推荐服务、后台"管家"应用,一层层压在只有 1GB 内存的主板上。

这就是开源项目 tv-vibehack 要解决的问题。它的定位一句话说得很清楚:Your TV, minus the ads——通过 ADB 给任意 Android TV / Google TV 做系统精简(debloat),再换上一个干净、类 tvOS 风格的主屏幕。整个流程面向"下午茶时间"式的 AI 辅助开发:把项目里写好的 prompt 扔给 Claude Code 这类带 shell 权限的编码助手,回答几个问题,剩下的连接、备份、禁用、编译、装机、验证都由助手在真机上完成。本文基于仓库源码拆解这个项目,告诉你哪些老电视值得救、改造路线怎么走、动手前必须知道哪些坑。

老电视为什么需要"翻新":广告与臃肿的真相

Android TV 出厂时被塞进了大量你从未主动安装的组件。以仓库中实测的小米 Mi TV 4A(Android TV 10)为例,精简清单里被禁用的 21 个包可以分成四类:

  • 遥测与统计:com.miui.tv.analytics、com.xiaomi.statistic,持续收集使用数据;
  • 内容推荐与广告服务:com.mitv.tvhome.atv、com.mitv.tvhome.michannel、com.mitv.tvhome.mitvplus、com.xm.webcontent、com.xiaomi.floatingframe,也就是 PatchWall 那一整套推荐行和内容位;
  • 后台服务:com.xiaomi.mitv.tvmanager("TV 管家"清理应用)、com.xiaomi.mitv.smartshare、com.mitv.milinkservice(Mi 投屏)等;
  • 预装应用与默认桌面:com.google.android.tvlauncher(Google TV 桌面)连同 tvrecommendations 推荐服务一起被替换。

这些组件每时每刻在占用 CPU、内存和网络,对于只有 1GB RAM 的老机器,体验差距是肉眼可见的。tv-vibehack 的思路不是卸载(系统包也卸载不掉),而是用 pm disable-user --user 0 把它们禁用——禁用意味着不常驻、不启动、不占资源,但随时可以恢复。

改造前后的对比非常直观:

改造前广告满满的出厂桌面与改造后干净主页的并排对比

哪些老电视值得救,哪些别碰

不是所有电视都能走这条路。项目兼容性的边界在 README 里写得很明确:

  • 值得救:运行 Android TV 或 Google TV 的设备——小米/Redmi、TCL、海信、索尼、一加、Realme、Nvidia Shield 以及大多数品牌。它们都走 ADB 通道,替换桌面、禁用预装的标准手段一致;
  • 别碰:三星 Tizen、LG webOS、亚马逊 Fire TV。这些是另一套操作系统,没有 ADB 层面的桌面替换能力,强行折腾只会白费时间。

在动手前,先用 tools/tv.py 的探针模式确认机型信息:

export TV_HOST=192.168.1.50          # 电视的局域网 IP
tools/venv/bin/python -I tools/tv.py --probe

它会通过 getprop 依次打印 ro.product.model、ro.product.device、Android 版本、SDK level、固件号和厂商。这一步的价值在于:判断这台电视是否属于 Android TV 阵营、固件是否与现有样例匹配,同时拿到写 debloat 清单所需的准确型号信息。仓库的 examples/ 目录每台电视一份 debloat.txt,头部就标注了型号、Android 版本和固件 build,方便你对照自己的机器。

至于硬件门槛:项目中的 launcher 从设计上就面向 1GB RAM 的电视——代码里不引入模糊、不做视频背景、不联网轮询、不跑后台服务。也就是说,只要系统是 Android TV,即使是很老的入门机型也在目标范围内。

翻新改造路线图:从备份到上手

第一步:打开调试通道

先在电视上手动开启开发者选项:设置 → 设备偏好设置 → 关于 → 对"Build(版本号)"连续按 OK 七次 → 返回 → 开发者选项 → 打开 USB 调试。如果电视上出现"网络/无线调试"选项也一并打开。

这里有个仓库实测的细节值得注意:部分电视(小米就在其中)根本没有"无线调试"开关,但只要打开 USB 调试,5555 网络调试端口就会一并开放。电脑端只需要和电视处于同一 Wi-Fi 即可通过 TCP 连接。

第二步:让 AI 助手接管

tv-vibehack 与普通"给你一串命令你自己敲"的项目最大的不同,是它把整个流程写进了一份可复用的 prompt——PROMPT.md。把这份 prompt 粘进 Claude Code 或任何带 shell 权限的编码助手,填上电视型号,助手就会按四个阶段工作:

  1. 连接:在局域网发现电视(主机名、ARP 表或直接问你 IP),经 5555 端口建立 ADB 连接;
  2. 备份优先:在改动任何东西之前,先保存完整的包列表、已禁用包列表、getprop 输出和全部设置,并写一份可恢复的 restore 脚本;
  3. Debloat:扫描已安装应用,按"厂商遥测/广告与内容服务/后台服务/预装应用/流媒体应用"分类,禁用前三类;涉及流媒体应用、语音助手、Chromecast、Miracast 和更新服务时,先以清单式问题征求你的意见,只禁你没勾选的项;
  4. 换桌面并验证:构建并安装新的 launcher,设为默认 Home,禁用原厂桌面,然后注入遥控按键、从电视上截屏、用眼睛检查每一步的截图,出问题先修再继续。

整个交互中你大概只需回答三四个清单问题(常用哪些应用、哪四个应用进 dock、是否保留语音助手和固件更新),其余全部自动化。

第三步:理解 debloat 清单,手动也能玩

不放心交给 AI?仓库提供了完全手动的通道。清单文件的格式是一行一个包名、# 注释分组:

# Xiaomi telemetry
com.miui.tv.analytics
com.xiaomi.statistic

# PatchWall and Mi content rows / promos
com.mitv.tvhome.atv
com.mitv.tvhome.michannel
com.mitv.tvhome.mitvplus
com.xm.webcontent
com.xiaomi.floatingframe

应用与撤销各有一个脚本,读取同一个清单文件,逻辑完全对称:

TV_HOST=192.168.1.50 tools/disable.sh examples/xiaomi-mi-tv-4a/debloat.txt   # 应用
TV_HOST=192.168.1.50 tools/restore.sh examples/xiaomi-mi-tv-4a/debloat.txt   # 撤销并恢复原厂桌面

disable.sh 把清单逐行转换为 pm disable-user --user 0 <pkg>,restore.sh 则反向执行 pm enable、恢复默认 Home(cmd package set-home-activity)并把动画缩放设置回 1.0。注意 restore 脚本默认假设原厂桌面是 com.google.android.tvlauncher,如果你的电视桌面包名不同,作为第二个参数传入即可。

第四步:换上新桌面

tv-vibehack 自带一个原生 Android TV 桌面 launcher(包名 com.gathin.tvhome),代码全部在 launcher/ 目录下,纯 Java + AndroidX RecyclerView + DynamicAnimation,没有 Kotlin、没有 Compose、没有任何网络依赖。视觉风格完全对标 Apple TV 4K:

  • 纯黑背景,顶部左侧是问候语、超大细体时钟和日期,使用开源字体 Outfit(FONT-LICENSE-OFL.txt);
  • 底部是圆角浅色带里的 dock,放着你自己选的四个应用;聚焦 dock 应用时,dock 上方会以大字号显示应用名,并投射一层从该应用 banner 采样颜色的氛围光晕(采样逻辑见 AppAdapter.java 的 vividColor,把 banner 缩到 12×12 像素找饱和度最高的主色);
  • 按 Down 键,dock 上方的 4 列应用网格滑出;整个界面只有一块半透明"玻璃"高光在焦点方块之间弹跳(弹簧物理参数见 MainActivity.java:stiffness 260、damping 0.58),玻璃的渐变、高光、描边绘制都在 GlassView.java 里,纯 Canvas 手绘,没有图片资源;
  • 右上角三个磨砂胶囊按钮:Inputs(展开一个紧凑的下拉列表,列出 HDMI 端口、AV 和 Live TV,通过 TvInputManager 获取端口连接状态并切换)、Wi-Fi(直接显示当前网络名)、Settings。

电视相关的所有个性化配置集中在 config.xml 一处:dock 应用顺序(缺失的应用自动跳过)、永远不显示的应用、Live TV 包名、网格列数。改完直接一键构建安装:

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

脚本内部做的是:./gradlew assembleDebug 编译 → 用 b64push.py 把 APK 分块推送到电视 → pm install -r → 授予定位权限(Android 10 上读 Wi-Fi 名需要)→ cmd package set-home-activity 设为默认桌面 → pm disable-user 禁掉原厂桌面。按一下遥控器的 Home 键,新桌面就出现了。

改造后的 tvOS 风格主页:纯黑背景、底部 dock、顶部时钟与磨砂胶囊按钮

第五步:验证与手动运维

项目的核心理念是"在真机上验证一切":注入遥控按键、截屏、拉回电脑检查。手动操作可以用 tools/tv.py——这是一个纯 Python 的 ADB 客户端,核心依赖只有 adb_shell、rsa、cryptography 三个包:

tools/venv/bin/python -I tools/tv.py 'pm list packages'      # 单条命令
printf 'cmd1\ncmd2\n' | tools/venv/bin/python -I tools/tv.py --batch   # 批量,一条一 shell

为什么强调"一条一 shell"?仓库实测发现:用分号链式拼接的 pm 命令可能在第一条之后就静默停止,--batch 模式就是为了规避这个问题设计的。

风险提示:动手前必须知道的三件事

1. "一切可逆"是有前提的

项目反复强调 packages 是 disabled 而不是 uninstalled,restore 脚本可以一键复原,甚至工具丢了也能在电视系统设置里手动启用——这套机制是靠谱的。但有两个关键前提:

  • 顺序不能错:必须在新的 launcher 安装并生效之后,才禁用原厂桌面。反过来操作的话,按 Home 键会落进一个工厂测试应用,界面上没有退路;
  • 备份要先行:PROMPT.md 把"备份包列表、getprop、设置并生成 restore 脚本"放在任何改动之前,这不是走过场。手动操作时建议照做——把 examples/ 里其他机型验证过的清单拿来自用,本身就是风险最小的起点。

2. 真实设备上的坑比想象中多

仓库的 README 记录了作者实战中踩过的坑,每一项都值得在动手前了解:

  • macOS 上 adb connect 报 "No route to host":端口明明开着却连不上,原因是新版 macOS 把 Google 签名的 adb 当作独立应用纳入了"本地网络"隐私管控,静默拦截。所以项目干脆写了一个纯 Python 客户端 tools/tv.py 绕开 adb 二进制;
  • 大文件 push 会卡死:通过 Python 客户端推大文件(比如 APK)容易挂起,b64push.py 用 48KB 分块 + base64 编码 + md5 校验的方式绕过;
  • 换桌面后可能没有输入法:小米电视实测中,默认输入法指向了一个并未安装的百度输入法,导致搜索框打不出字,修复命令是 tools/tv.py 'ime set com.google.android.inputmethod.latin/com.android.inputmethod.latin.LatinIME';
  • 第三方 launcher 收费:不少现成的第三方桌面连"自定义壁纸"这种基础功能都要付费解锁,这正是作者选择自己写一个 launcher 的原因。

3. 功能取舍与边界要自己判断

禁用清单里有些包可能恰恰是你需要的,务必看清楚再动手:

  • com.xiaomi.mitv.updateservice 是固件更新服务,禁了就无法在线检查更新;
  • com.mitv.milinkservice 是 Mi 投屏服务(注释里特意标注了 Chromecast 不受影响);
  • com.xiaomi.amazon.alexa 是 Alexa 桥接,用智能音箱控制电视的话别禁;
  • 语音助手、Chromecast、Miracast、流媒体应用属于 PROMPT.md 明确要求"先问你再用"的类别。

此外,这个项目有自己的价值边界:CONTRIBUTING.md 明确拒绝了推荐行、内容信息流、广告和遥测这类"符合厂商利益但不符合用户利益"的功能——这也是它跟那些越做越臃肿的桌面最大的区别。如果你用的是三星、LG 或 Fire TV,或者想把这套玩法移植到电视盒子以外的设备上,这条路目前走不通,不必硬试。


老电视真正的问题往往不是硬件老,而是软件被人为地堆胖了。tv-vibehack 的价值在于它把"去广告、去臃肿、换桌面"这整条链路做成了一份可复用的 prompt 加一套可审计的工具:备份、禁用、构建、验证、恢复,每一步都有据可查、可逆可撤。如果你手里正好有一台吃灰的 Android TV,照着 PROMPT.md 走一遍,也许一个下午就能把它变成一台"看着像新电视"的设备。所有代码都是 MIT 许可,改坏了也随时能一键还原,试试的成本并不高。

登录后查看全文
cleanyourtv