mclhm8182/tvhome-zh

如果你有一台原生桌面塞满推荐位的电视盒子，又不想装 JDK 编译，这个分支可以直接装；但签名冲突和与上游的关系会决定它适不适合你。

解决什么问题

你希望电视开机就是一个干净、好认的桌面：底部 Dock、应用网格，给家里老人再加个时钟和日期。原厂桌面会插入广告磁贴和推荐内容，增删应用还要在层层设置里翻找。这个分支把流程改成：Dock、壁纸、每行图标数和天气都在电视上用遥控器打开面板设置，桌面本身以编译好的 APK 安装，不需要自己编译。最终得到一个设置一次、重启后仍然有效的主屏幕。

有什么不同

上游 Gathin23/tv-vibehack（现名 CleanYourTV）围绕提示词和脚本、配合 AI 助手在你的电视上执行；本分支的核心改动是把这些配置步骤搬到遥控器可操作的面板里。比如编辑 Dock 不再改 config.xml 再重编译，而是长按图标或按菜单键勾选；壁纸可以用必应每日图，也可以从电视里选本地图片。它使用 targetSdk 29，作者称这样在 Android 11 上不会因包可见性限制而只显示少数应用，这对停留在 Android 11 的国产盒子有实际意义。小米国内固件切信号源会走厂商播放器，自动识别，不用改设置。代价是功能落后于上游：主题推送、模块磁贴、AOT 预编译等几项没有，release APK 带调试签名性质，且签名密钥换过一次。

谁值得试

适合：想换桌面但不想搭编译环境的人，尤其是需要简体中文界面，或者希望电视开机就能给家里人直接看的场景。不适合：需要上游完整功能的人，或者期待在部分 TCL 中国区固件上装任何第三方桌面的人——README 记录这类固件会拒绝签名不同的桌面，文档给出的办法是关闭安装验证，而有些机型可能关不掉。如果你愿意自己编译，直接用上游更合适。

使用条件与边界

安装方式是拷 APK 到电视或用 adb install；如果电视设置里没有“默认桌面”入口，设为桌面可能需要 ADB，README 给了对应命令。从 v1.2.0 升级要先卸载一次，因为签名密钥变了，Dock 和壁纸需要重设；之后的版本可以直接覆盖升级。Home 键回顶和菜单键浮层需要开启随附的无障碍服务。个别 ROM 会在启动瞬间残留一个透明占位窗，导致遥控器没反应，需要先强制停止应用；必应壁纸和文件选择器分别依赖网络和系统文件选择组件。

HotRepo 点评

HotRepo 首次记录时仓库只有 5 天：一次新项目榜（java 分类，共 217 星，第 10 名，观察于 2026-10-25），这不是总榜，也不是单日新增。只有两个日期的样本，无法判断热度能否持续。安装前先确认 release 里哪个 APK 对应你的设备，以及你的电视型号能否关闭安装验证；兼容性说明在 README 里有写。