VictorTran1023/android-tv-toolkit

效率与系统工具

不 root、不刷机,为愿意折腾自家电视的人提供连机、去预装、回归验收的一整套可回滚流程。

81
9
Java
MIT
上线 6 天

这不是一个开箱即用的清理 App,而是一份带脚本的操作规程:先认清设备,再授权、快照、逐条改动、重启、回归。愿意看日志、敲命令行的人能省下大量试错时间;只想要一台更快的电视、不想折腾的人,会觉得这套门禁流程太重。

解决什么问题

你想关掉首页推广、停掉常驻语音助手的唤醒锁、用不依赖 GMS 的客户端看视频,还想确认自己究竟是改好了还是把遥控器弄坏了。在未改动的电视上,麻烦集中在四处:adb unauthorized 且电视不弹窗、包校验拦住侧载、缺 GMS、厂商预装重启后复活。这个项目把这些变成一条可重复的顺序:识别设备 → 授权 → 快照 → 一次停一个包 → 重启 → 跑脚本回归。最后得到的是一台改过的电视,外加一份能回去的基线。

有什么不同

价值更多在流程纪律,而不在脚本本身。动任何东西之前,先保存包列表、已停用包、三张 settings 表、系统属性,以及当前桌面、屏保和动画值。之后每次只改一项,重启并跑 regress.ps1,它会现场探测当前桌面和设置包,而不是写死某个厂商包名。这种「先设闸门、再验收」的循环,是它和论坛里一键去预装脚本的主要区别。

第二个有辨识度的部分是 HUD:约 41 KB 的原生 Java 应用,无第三方依赖,显示 CPU、内存、VPN 状态、通过 dumpsys thermalservice 读到的温度,以及本地天气屏保;不抢遥控器焦点,10 秒自动淡出。它也诚实交代了缺口:GPU 占用列明不可得,因为厂商节点拒绝访问。tvOS 风格桌面则明确只是设计稿与交互原型,未装机、不接管 HOME,别指望装上一个新首页。

谁值得试

适合:看过 TCL T7K 案例、想要同样方法(含命令、证据、回滚记录)的 TCL / 雷鸟用户;手里是小米、索尼或海信、愿意把品牌表当作起点而非保证的人也算合理。不适合:想要点一下就清理干净的工具的用户,以及使用鸿蒙、LG webOS、三星 Tizen 的用户——README 说明它们不是 Android TV,不受支持。

使用条件与边界

脚本部分要求 Android TV 9 或更高,HUD 要求 Android 10 或更高。电脑端需要 adb,快照与回归脚本依赖 PowerShell,传统公钥授权另有一个 Python 3.9+ 脚本,具体见使用指南。电视和电脑要在同一网段,首次连接需要电视端弹出调试授权。

更大的限制是覆盖面。README 写明 TCL 是目前唯一完整实测的品牌,其他品牌在品牌与机型里标为已验证、参考或未验证。文中的 CPU 48% → 9%、温度降约 10 °C 是 TCL T7K 单个样本,不适用于其他机型。侧载通道各品牌不同,有的需要 U 盘或厂商应用商店;作者还记录了一个坑:用 pm disable-user 之后至少等 60 秒再重启,否则 PackageManager 没落盘,重启会把包全部恢复。可回滚是真的,但若靠恢复出厂找回某个功能,代价是丢掉数据。

HotRepo 点评

HotRepo 从 2026-10-24 开始记录这个仓库;2026-10-25 它以 81 个总 star 出现在新项目榜 Java 分类第 18 名。这只是两天样本,不是逐日增长序列,还判断不了热度能否持续。打算在 TCL 以外使用之前,先确认你的具体型号在品牌文档里是「已验证」还是仅「参考」。

本文由 AI 根据项目 README 生成,更新于 2026年10月25日,以项目官方文档为准。