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 都能跑完整個流程。
- 電視上:設定 → 裝置偏好設定 → 關於 → 連按七次「建置」→ 返回 → 開發人員選項 → 打開「USB 偵錯」。如果有網路偵錯或 ADB 偵錯開關也一併打開。保持電視開機。
- 電腦上:
git clone https://github.com/Gathin23/cleanyourtv,在助手裡打開這個目錄,貼上儲存庫裡的PROMPT.md並填上你的電視型號。 - 跟著走:在電視上確認「允許 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 agent 驅動的桌面自動化、螢幕控制與系統工具。
- 實用工具——包括 ArtCraft 創意套件橋接、知識圖譜工具等。
- Agent 與自動化工作流——排程任務與多步 agent 工作流。
