去广告

停用电视厂商的广告服务、广告推荐入口及相关内容行

减少开机广告、首页广告和推广内容

清理预装应用

识别并停用不需要的厂商预装应用

减少无用应用对电视界面的干扰

隐私优化

停用部分遥测及数据收集相关服务

减少不需要的后台数据收集

全新电视桌面

安装类似 Apple TV 的简洁原生启动器

替换广告较多、布局复杂的原厂首页

应用管理

自定义常用应用快捷栏、应用网格和隐藏应用

让遥控器操作更加直接

主题定制

修改背景色、壁纸、快捷栏布局和应用列数

个性化电视桌面

电视快捷入口

提供网络、系统设置和适用设备的输入源入口

减少进入系统菜单的操作

时钟与屏保

显示时间、日期、问候语，提供时钟屏保

让待机界面更简洁

遥控器优化

改进方向键导航，并为部分设备提供 Home、Input 等按键兼容处理

改善不同电视遥控器的操作体验

多语言

支持简体中文等多种桌面语言

方便不同语言用户使用

模块卡片

允许兼容的电视应用提供自定义桌面卡片，由用户决定是否启用

扩展桌面功能

恢复机制

通过恢复脚本重新启用已停用的应用，并可切回原厂桌面

降低误操作风险

Android TV

支持，视机型而定

Android 8.0 及以上通常满足项目的桌面最低版本要求

还需检查 ADB 和 APK 安装权限

Google TV

支持，视机型而定

兼容设备支持

部分系统可能限制默认桌面切换

小米电视 / Redmi 电视

有对应机型清单

取决于型号和固件

不要直接套用其他型号的清理列表

TCL 电视

部分机型有清单

部分机型可能拒绝安装第三方桌面

中国大陆版尤其需要检查具体固件

Amazon Fire TV

部分设备支持清理

通常不能直接替换默认桌面

Fire OS 有自身限制

Samsung Tizen 电视

不支持通用 Android 清理流程

不支持直接安装 Android 桌面

属于不同操作系统

LG webOS 电视

不支持通用 Android 清理流程

不支持直接安装 Android 桌面

社区移植项目不等于官方兼容

安装 ADB、Python 等环境

脚本检测依赖，AI 生成安装建议

安装软件前建议确认

克隆 CleanYourTV

自动下载官方仓库并记录版本

首次执行建议确认

连接电视

扫描指定 IP、检查 ADB 授权状态

首次配对需要电视端授权

获取电视型号

自动读取 getprop、Android 版本及厂商信息

否

检查机型配置

AI 比对官方 examples/ 与实际型号、固件

不匹配时必须停止

备份系统状态

自动导出应用列表、设置和执行记录

否

清理广告和预装应用

AI 生成候选清单，执行器校验包名

必须确认清理清单

安装新桌面

自动编译、安装并检查启动状态

首次安装建议确认

调整主题

自动执行指定主题脚本

可以设置为自动

检查遥控器、网络和 HOME

自动检查系统状态，AI 分析日志

部分功能需要人工测试

恢复原厂桌面

检测失败后执行预先批准的恢复计划

恢复动作须经过安全策略授权

输出结果

生成 Markdown 报告和执行日志

否

PROMPT.md

编程助手操作提示词

examples/

各电视机型的清理配置

launcher/

桌面应用源码和安装脚本

tools/

ADB 操作、停用、恢复及主题工具

themes/

桌面主题配置

docs/

详细说明与故障排查

SHOWCASE.md

社区衍生项目与移植作品