Clean Your TV(cleanyourtv):用 AI coding agent 為 Android/Google TV 移除廣告與預載軟體

Clean Your TV 是什麼?這個開源專案讓 coding agent 透過 Wi-Fi 停用 Android/Google TV 的廣告服務與預載肥軟體,換上 Apple TV 風格桌面。安裝步驟、支援機型、一鍵還原一次講清楚。

最近更新: 2026-10-31

Clean Your TV 是什麼?

Clean Your TV(Gathin23/cleanyourtv)登上過 GitHub 趨勢榜第一(2026-10-19~25 當週,trendshift 資料),它回答的是每個 Android TV / Google TV 使用者都問過的問題:為什麼我自己的電視要給我看廣告?

這個專案做兩件事。第一,幫電視瘦身——透過 Wi-Fi 停用廠商的遙測、廣告服務、贊助內容推薦列和預載 App。第二,把塞滿廣告的桌面換成一個約 572 KB 的原生啟動器,观感與操作都像 Apple TV:純黑背景、四個常用 App 的 dock、沒有任何東西在背後偷偷上報。

TechCrunch、TechRadar、Tom's Guide、Mashable、Android Authority、XDA 等媒體都報導過它——54 個國家的 412 篇報導,社群貢獻了 103 個品牌、387 個電視型號的實測清單。

動手之前先記住一件事:官方網站是 cleanyour.tv,官方儲存庫就是上面的 GitHub 連結。cleanyourtv.com 之類的相似網域不是這個專案的。

運作原理

Android TV 和 Android 手機一樣開放除錯橋。在電視的開發人員選項裡打開 USB 偵錯、允許你的電腦一次之後,剩下的全是標準 Android 工具鏈——不需要 root,不需要傳輸線:

步驟做什麼
備份先記錄已安裝的套件清單和設定,再動任何東西。
停用用 Android 的 pm disable-user 停用廠商遙測、廣告服務、內容推薦列和預載垃圾——不是解除安裝,所以還原腳本能逐步復原。
安裝裝上小型原生啟動器並設為預設桌面。

各品牌的肥軟體程度不一樣,所以內建的提示詞會讓你的 coding agent 先在你的電視上實際探測,動到你可能還在用的東西之前先問你。

怎麼安裝執行

需要一台和電視連同一個 Wi-Fi 的電腦,裝好 Python 3、JDK 17~22、Android SDK platform 34 + build-tools 34(啟動器由 agent 在上面編譯)。整個流程約十五分鐘。

這些 coding 助手都可以:Claude Code、Codex、Gemini CLI、Antigravity CLI——這也正是和 DeepSeek Harness 相關的地方:任何能讀儲存庫提示詞、執行 shell 指令的 agent CLI 都能跑完整個流程。

  1. 電視上:設定 → 裝置偏好設定 → 關於 → 連按七次「建置」→ 返回 → 開發人員選項 → 打開「USB 偵錯」。如果有網路偵錯或 ADB 偵錯開關也一併打開。保持電視開機。
  2. 電腦上:git clone https://github.com/Gathin23/cleanyourtv,在助手裡打開這個目錄,貼上儲存庫裡的 PROMPT.md 並填上你的電視型號。
  3. 跟著走:在電視上確認「允許 USB 偵錯?」,然後回答清單:常用哪些 App、dock 大小和 App 順序、是否保留語音助理、Chromecast 和系統更新。

一定要 clone 儲存庫:agent 重用的是儲存庫自帶的 tools/disable.sh 和 launcher/build-and-install.sh——備份、桌面守衛和還原紀錄都由它們負責。

沒有 coding 助手? 儲存庫同樣提供手動指令(tools/tv.py、tools/disable.sh、tools/restore.sh);還有第三條路:社群開發的手機 App(cleanyour.tv/app),在 Android 手機上連線 → 分析 → 清理,五分鐘左右搞定,完全不用電腦。

哪些電視能用

平台支援情況
Android TV / Google TV完整支援:去肥軟體 + 啟動器。
Amazon Fire TV只能去肥軟體——Fire OS 不允許第三方啟動器接管桌面(2015 款 Fire TV Box 連這半步也失敗)。
三星(Tizen)、LG(webOS)、Roku、Vizio、Hisense VIDAA不支援——沒有 ADB。專案官網提供了這些平台的關閉追蹤指南。

安全嗎

設計上刻意做到可回復:

  • 不解除安裝任何東西。 套件都是用 pm disable-user 停用的;變更前工具會把電視狀態記錄到 ~/.cleanyourtv/。
  • 一行還原: TV_HOST=<電視IP> tools/restore.sh examples/<你的型號>/debloat.txt 就回到原廠桌面。
  • 腳本絕不會讓電視沒有桌面——只停用它們認得的官方啟動器,清單裡的桌面 App 一律跳過,直到有別的啟動器接管 HOME。
  • 韌體更新後,tools/check.py 會比對電視和已套用的清單,--fix 把被系統復原的停用項目重新停用回去。

FAQ

Clean Your TV 能用在 Google TV 上嗎? 能。Google TV 底層就是 Android TV,去肥軟體和啟動器都完整支援。Google TV 還原時要在指令裡多傳一個官方桌面包名稱(com.google.android.apps.tv.launcherx)。

一定要用 Claude Code 嗎? 不必。README 點名 Claude Code、Codex、Gemini CLI、Antigravity CLI 都可以。它本質上是一套基於標準 ADB 工具的提示詞工作流,任何夠用的 coding agent CLI 都行——和 DeepSeek Harness agent 跑 shell 自動化是同一個道理。

會 root 電視、影響保固嗎? 不 root、不接線、不解除安裝。用的是 Android 手機同款的開發人員模式除錯橋,所有變更都能用還原腳本復原。

有手機 App 嗎,不想碰命令列? 有。社群開發的 Android App(cleanyour.tv/app)用手機五分鐘左右完成清理,全程不需要電腦和 coding agent。

我的電視是三星 / LG / Roku,能用嗎? 不能直接用——這些平台不開放 ADB。專案給你的是各平台關閉追蹤的設定指南(cleanyour.tv/not-android)。

相關的 DeepSeek Harness 外掛

喜歡「讓 agent 親手做事」這個思路的話,DeepSeek Harness 生態裡有同類原生外掛:

DSH Plugins 是獨立的 DeepSeek Harness 外掛目錄,與 DeepSeek 官方無關,也不代表官方背書。第三方外掛未經安全稽核,安裝前請審查原始碼。

每週取得最新的 DeepSeek Harness 外掛,絕不濫發。