CleanYourTV：用Claude Code安全精简你的电视

智能电视的广告和遥测数据收集让很多人头疼，但手动精简系统又门槛太高。最近，一个名为 CleanYourTV 的开源项目尝试用 AI 编程助手 Claude Code 来自动化这个过程：通过 Wi-Fi 连接 Android TV，用一组提示词加脚本剥离广告和遥测组件。听上去很美好，但实际可靠吗？本文拆解它的工作原理、潜在风险，并给出一份安全操作清单。

CleanYourTV 项目来源截图

一、CleanYourTV 是什么：提示词驱动的电视精简方案

CleanYourTV 并不是一个现成的 APK 或一键工具，而是一套「提示词 + 脚本」的组合。它的核心思路是让 Claude Code 扮演执行者：用户把项目提供的提示词输入 Claude Code，后者根据提示生成并执行一系列 ADB 命令，通过 Wi-Fi 连接到同一网络下的 Android TV，逐步禁用广告服务、遥测上报组件和预装 bloatware。

这种设计的好处是透明——每一步操作都以命令形式呈现，理论上用户可以审查后再执行。相比网上流传的来路不明的「一键去广告脚本」，CleanYourTV 至少把逻辑摊开在了提示词里。但它也继承了 AI 生成命令的固有风险：Claude Code 可能对特定电视型号的包名判断失误，或者执行了超出预期的系统级操作。

二、它是怎么工作的：ADB、包名与 AI 的三角配合

连接与识别

整个流程的第一步是通过 ADB over Wi-Fi 建立连接。用户需要在电视上开启开发者选项和网络调试，然后在电脑端运行 Claude Code 并加载项目提示词。Claude Code 会先执行设备识别命令，获取电视的型号、Android 版本和已安装包列表，作为后续操作的基础。

ADB（Android Debug Bridge） 是 Android SDK 中的命令行工具，用于与设备进行调试通信。ADB over Wi-Fi 允许开发者无需 USB 线缆，通过 TCP/IP 连接设备。要在电视上启用此功能，需先进入「开发者选项」（通常连续点击系统版本号激活），然后开启「USB 调试」和「网络调试」。连接时，电脑端执行 adb connect <电视IP>:5555，电视端会弹出授权对话框，确认后即可建立连接。ADB 提供了安装应用、执行 shell 命令、查看日志等能力，是系统级操作的入口。

禁用而非卸载

据项目说明，CleanYourTV 主要采用 pm disable-user 这类禁用命令，而不是直接卸载系统应用。这是一个相对保守的选择：禁用的应用可以从设置中重新启用，降低了变砖的概率。但禁用某些与系统 UI 深度绑定的包，仍可能导致启动器异常或设置菜单缺失。

pm disable-user 是 Android Package Manager（pm）的一个子命令，用于将指定应用标记为对当前用户禁用。与 pm uninstall 不同，禁用不会删除应用数据或系统分区中的 APK，只是让系统在用户空间忽略该应用。被禁用的应用不会出现在启动器中，也无法运行，但可以通过 pm enable <包名> 重新启用。这种机制常用于临时停用预装软件，保留了恢复的可能性。不过，禁用某些与系统 UI 紧密耦合的包（如启动器、设置提供者）仍可能导致界面崩溃或功能缺失。

遥测与广告的剥离逻辑

脚本会依据包名关键词（如 ad、analytics、telemetry、tracking）筛选目标，再结合 Claude Code 对包列表的语义判断决定禁用清单。这里既有规则匹配的效率，也有 AI 推断的灵活性，但同样意味着结果不完全可预测——不同品牌电视的包名规范差异很大，同一套提示词在不同设备上的效果可能相去甚远。

包名（Package Name） 是 Android 应用的唯一标识符，通常采用反向域名格式（如 com.example.app）。不同厂商的定制系统会使用不同的包名命名习惯，例如索尼的电视服务可能以 com.sony 开头，而小米的则可能包含 com.xiaomi。广告和遥测组件的包名往往包含 ad、analytics、telemetry、tracking 等关键词，但并非绝对——有些系统诊断服务也可能含有类似词汇。因此，单纯依赖关键词匹配存在误判风险，需要结合 AI 的语义理解进行二次筛选。

三、风险在哪里：项目自己承认的断点

原始素材明确提到要讨论「where it breaks」，说明项目作者对局限性有清醒认识。综合来看，主要风险集中在三处。

误禁关键系统包。 AI 根据包名关键词判断时，可能把某些名字含「analytics」但实际承担系统诊断功能的服务一并禁用，导致部分设置项失效或系统更新异常。

不同厂商的兼容性差异。 索尼、TCL、小米等品牌的 Android TV 定制程度不同，包名体系各异。CleanYourTV 的提示词很难覆盖所有变体，在非目标机型上执行可能产生意外结果。

恢复成本高。 虽然禁用可逆，但如果电视的 ADB 连接在操作中途断开，或启动器被误禁导致无法进入设置界面，恢复就需要借助恢复模式甚至重新刷机。这对普通用户来说是不小的门槛。

四、安全运行清单：动手前先做这几件事

如果你仍想尝试 CleanYourTV，以下清单可以显著降低翻车概率。

先备份包列表。 在禁用任何应用前，用 adb shell pm list packages 导出完整列表并保存，必要时可对照恢复。
逐条审查命令。 不要一次性放行 Claude Code 的所有操作，要求它每次执行前展示命令，确认包名含义后再继续。
从非关键包开始。 优先禁用明确的广告 SDK 和第三方预装应用，把系统级服务留到最后，观察电视运行是否正常再决定是否继续。
保持 ADB 连接稳定。 使用有线网络或稳定的 Wi-Fi，避免操作中途断连；不要在禁用过程中断电。
记录每一步改动。 用文本记录被禁用的包名和对应功能，出问题时可以快速定位并重新启用。

五、值得尝试吗：AI 工具进入系统维护领域的信号

CleanYourTV 的意义不止于「去广告」本身。它展示了一种新的工具形态：把 AI 编程助手当作系统运维的执行代理，用自然语言提示词替代记忆复杂的 ADB 命令。对于有一定技术基础、愿意逐步审查的用户，这套方案提供了比手动折腾更高效的路径。

但它也暴露了当前 AI 代理的边界——对设备状态的判断依赖有限信息，出错后的恢复责任仍落在用户身上。把它当作「辅助脚本生成器」而非「全自动精简工具」，是更务实的心态。在厂商持续加码电视广告的背景下，这类开源尝试会越来越多，而安全性和可逆性，将是区分它们优劣的关键标尺。

背景补充

系统诊断服务 是 Android 系统的一部分，用于收集设备运行状态、崩溃日志和性能指标，以帮助厂商改进系统稳定性。这类服务可能以 analytics 或 diagnostics 命名，但与广告 SDK 不同，禁用它们可能导致系统无法上报错误，影响后续更新或故障排查。在精简电视时，需仔细区分商业遥测与系统诊断，避免一刀切。