CleanYourTV:让 Claude Code 给安卓电视去广告、换桌面
CleanYourTV 用提示词让 Claude Code 连上安卓电视,停用广告与预装服务,再装一个 250 KB 的 Apple TV 风格桌面,MIT。
项目资料
GitHub Ecosystem- 许可证
- MIT
- 主语言
- Java
- 星标
- 8,533
- 核查时间
- 2026-10-20
以上快照资料以核查当日为准,可能随版本或运营策略变化。

智能电视开机先放广告、进首页还是满屏推荐,这件事的常规解法是装第三方桌面或去广告插件,但往往治标不治本。CleanYourTV 换了个思路:把电视型号告诉 Claude Code 这类能执行命令的编码智能体,让它通过同一 Wi-Fi 连上电视,先停用广告、数据上报和用不上的预装服务,再装一个仿 Apple TV 的轻量桌面。整个过程不需要 Root、不用插数据线、也不卸载任何应用——停用只是关闭,随时能恢复。项目 MIT 开源,主要语言 Java,截至 2026-10-20 有 8,533 颗星。

核心功能
- 提示词驱动,不用懂安卓命令:仓库根目录的
PROMPT.md就是全部操作说明,粘进 Claude Code、Codex 或 Gemini CLI,填上电视型号即可。智能体会自己发现电视上装了哪些包,按「数据上报 / 广告与推荐 / 用不上的后台 / 预装 App / 视频 App」分类,前几类停用。 - 有安全边界:播放 HDMI 信号的服务、遥控器与蓝牙配对、输入法、应用商店这几类,提示词里写明不许碰;看名字猜不出用途的包,智能体会先查清楚再问;涉及个人习惯的(用哪些视频 App、要不要保留语音助手、投屏、系统更新)也会先问一句。
- 每步都验证:改一步就用模拟遥控器按键操作一遍,再截图看效果,有问题当场修正。
- 可完整回滚:动手前先备份完整软件列表与系统设置;停用不是删除,一条命令就能恢复:
TV_HOST=192.168.1.50 tools/restore.sh examples/<your tv>/debloat.txt。就算电脑连不上电视,也能在电视自己的设置里逐个重新打开。 - 250 KB 的桌面:新桌面参照 Apple TV,纯黑背景、底部四个常用 App、玻璃质感高亮、左上角问候语与时钟、右上角输入源与 Wi-Fi 按钮,还带一个每分钟移动位置的时钟屏保防烧屏。按 1 GB 内存的电视设计,无模糊特效、不联网。
- 现成清单可复用:仓库已收录 92 个电视型号的去广告清单,同型号可以直接用,省掉逐个排查。
典型使用场景
- 受够开机广告的安卓电视用户:不想折腾 ADB 命令,把型号和提示词交给智能体,回答三四个选择题就行。作者第一次花了一个下午,按网友反馈,有现成清单后大约 15 分钟。
- 想保留原系统、只去掉干扰的人:停用而非卸载,随时可恢复,风险比刷机低。
- 家里有低配电视的人:250 KB 的桌面比原厂启动器轻,1 GB 内存也能跑。
- 想学「让智能体操作真实设备」的开发者:PROMPT.md 是一份完整的设备操作规程,包含分类、询问、验证与回滚。
快速上手
在电视上打开开发者选项:设置 → 设备偏好设置 → 关于 → 在「版本号」上连按 7 次 → 返回 → 开发者选项 → 打开「USB 调试」(如果有「网络调试」或「ADB 调试」也一并打开),并让电视保持开机。电脑与电视连同一个 Wi-Fi,然后把仓库里的提示词交给智能体:
git clone https://github.com/Gathin23/cleanyourtv.git
# 把 PROMPT.md 的内容粘进 Claude Code / Codex / Gemini CLI,填上你的电视型号
电视上弹出「是否允许 USB 调试」时确认,然后按清单回答:平时用哪些 App、底部四个放什么、要不要保留语音助手、投屏与系统更新。之后智能体会备份、分类、停用、装桌面,并逐步截图验证。
小结
适合用安卓电视或 Google TV、受够开机广告与推荐流、又不想刷机的用户。不适合三星 Tizen 或 LG webOS 的用户——这两套系统用不了,仓库另有 webOS 移植在 SHOWCASE.md 里;Fire TV 只能用去广告那一半,因为 Fire OS 不允许第三方桌面接管 Home。部分国行 TCL 机型完全拒绝安装第三方桌面,仓库的清单里会标注。
需要注意的几点:要求电脑和电视在同一局域网,否则智能体连不上;操作依赖电视的 ADB 调试,厂商固件差异会影响可用范围;虽然项目做了备份与回滚,但改动系统设置本身仍有风险,建议先看清楚清单再执行。MIT,Java,8,533 星。同属「把闲置设备用起来」的思路,本站此前的 SideScreen 是把安卓平板变成 Mac 扩展屏,这里是把电视的广告位拿回来。