CleanYourTV 设置指南
让 Android TV 或 Google TV 首页更清爽的起点。
CleanYourTV 是 Gathin23 开发的开源项目。本网站是介绍其操作流程的独立免费指南。源码包包含项目 README、提示词、设备示例、主题、故障排查说明和安全说明。
先确认你的电视型号
在解压后的源码包中打开 examples/ 里的设备报告，确认型号、地区和固件。Android TV 和 Google TV 是支持的起点。安装提示词不支持 Fire TV、Samsung Tizen 或 LG webOS。
准备电视
让电视和电脑连接到同一个局域网。打开「设置」，进入「关于」，连续按七次 Build 项目以解锁「开发者选项」。如果有这些选项，请开启 USB 调试和网络/ADB 调试。只允许自己信任的电脑发起调试请求。
在电视的网络或 Wi-Fi 设置中找到 IPv4 地址，并提供给助手。本网站的设置表单可以把这个地址放进初始提示词，但不会扫描或连接你的网络。
部分 Google TV 使用带配对码和独立连接端口的无线调试。如果普通连接不成功，请按安装提示词中的配对流程操作，不要默认 5555 端口一定开放。连接故障排查指南说明了需要检查的内容。
按项目当前流程操作
打开安装提示词，把全文复制到能访问终端的编程助手中，并告诉它准确的电视型号。要求它分阶段确认后再继续。项目本身免费，但部分编程助手会单独收取使用费。
修改前，先保存软件包列表、已禁用软件包的状态、设置和设备信息。确认要保留哪些流媒体应用、语音助手、投屏服务和系统更新。不要禁用未知软件包，也不要禁用输入、遥控器、音频、键盘或 Play 服务等必要组件。
桌面启动器需要从源码编译。下载完整源码 ZIP并解压。保留整个项目文件夹：编译脚本还需要 tools/ 和 launcher/ 中的文件。
准备 Python 3、JDK 17、Android SDK Platform 34 和 Android Build Tools 34.0.0。解压后的 README.md 中有手动配置细节。下载对应的 Windows 编译脚本或 macOS/Linux 编译脚本，放入解压后的 launcher/ 目录，并从该目录运行；它们是源码编译脚本，不是现成 APK 下载文件。
在新启动器成为 Home 启动器之前，保持原启动器启用，直到替代启动器成功打开。要在电视上按 Home 键验证，不要只相信命令显示成功。
部分固件会阻止侧载应用或第三方 Home 启动器。如果设备因验证限制或厂商签名限制拒绝安装，请停止安装启动器并阅读准确型号的说明。反复尝试安装不能证明兼容。
验证并收尾
检查 Home、遥控器的快捷键和设置键、HDMI 输入、声音以及投屏。关闭调试、撤销授权、重启，然后使用可下载的 ADB 关闭验证工具确认 ADB 端口拒绝连接。超时或路由错误不等于已经确认拒绝连接。
自定义启动器
基础设置成功后，可以在启动器设置中排列应用行，并决定是否保留动画。解压后的 themes/README.md 说明了如何更换背景、颜色和 Dock。应用主题前先阅读说明，完成后再次检查遥控器和 Home 键。
恢复或排查问题
把原始软件包列表和状态记录保存在电脑上。下载对应的 Windows 恢复脚本或 macOS/Linux 恢复脚本，放入解压后的 tools/ 目录，并使用你实际应用过的那份列表。这些脚本只能恢复已记录的状态，不是完整的系统镜像。遇到型号专属问题或需要安全建议时，请阅读解压源码包中的 docs/TROUBLESHOOTING.md 和 SECURITY.md。