手把手ADB电视优化教程:tv-vibehack手动去广告全流程,从探测到禁用命令全清单
手把手ADB电视优化教程:tv-vibehack手动去广告全流程,从探测到禁用命令全清单
tv-vibehack 是一个通过 ADB 为任意 Android TV / Google TV 去广告、去预装(debloat)并换上 tvOS 风格桌面的开源项目。本教程带你完全手动走一遍全流程:开启 USB 调试 → 探测电视型号 → 列出安装包 → 用 pm disable-user 禁用命令清掉厂商遥测和 PatchWall 广告 → 安装无广告桌面,最后随时一键还原。所有操作只"禁用"不"卸载",风险可控。
优化前后对比:电视桌面去广告效果一览
先看最终效果——左侧是带赞助商横幅、Shop 购物行和推荐信息流的 Google TV 原生桌面,右侧是 tv-vibehack 的纯黑 tvOS 风格桌面,只有你自己选的 4 个应用:
💡 适合机型:小米/红米、TCL、海信、索尼、一加、Realme、Nvidia Shield 等一切 Android TV / Google TV 电视。不适用三星 Tizen、LG webOS、亚马逊 Fire TV。
第一步:在电视上开启 USB 调试(ADB 调试开关路径)
- 电视端进入:设置 → 设备偏好 → 关于,用遥控器的 OK 键连续按 7 次 Build(版本),返回后进入 开发者选项;
- 打开 USB 调试;如果菜单里有"网络/ADB 调试"开关,也一并打开(部分电视如小米没有该开关,仅开 USB 调试也会自动开放 5555 端口的网络 ADB);
- 记下电视 IP:设置 → 网络里能看到,或让电视与电脑连同一个 Wi-Fi 后用
arp -a查找。
第二步:探测电视——确认型号、系统版本和固件
项目自带纯 Python 的 ADB 客户端 tools/tv.py,不需要 adb 二进制(macOS 新版本会因本地网络隐私策略静默拦截 adb,报 No route to host)。先初始化环境:
python3 -m venv tools/venv && tools/venv/bin/pip install -r tools/requirements.txt
export TV_HOST=192.168.1.50 # 换成你电视的 IP
然后执行探测命令,它会打印型号、Android 版本、SDK 和固件信息:
tools/venv/bin/python -I tools/tv.py --probe
首次连接时电视会弹出 "允许 USB 调试?" 对话框,点允许即可。
第三步:列出安装包,找出要禁用的广告与遥测包
tools/venv/bin/python -I tools/tv.py 'pm list packages'
把输出按以下几类整理(这正是 PROMPT.md 里给 AI 助手的核心清单):
| 分类 | 典型包名示例 | 是否禁用 |
|---|---|---|
| 厂商遥测/统计 | com.xiaomi.statistic、com.miui.tv.analytics |
✅ 直接禁 |
| 厂商内容与广告服务(PatchWall、推荐位) | com.mitv.tvhome.atv、com.mitv.tvhome.michannel、com.google.android.tvrecommendations |
✅ 直接禁 |
| 后台杂项服务(电视管家、智能分享、更新服务、语音桥接) | com.xiaomi.mitv.tvmanager、com.mitv.milinkservice |
✅ 按需禁 |
| 预装应用 | com.xiaomi.mimusic2、com.google.android.play.games |
✅ 按需禁 |
| 流媒体 / 语音助手 / Chromecast / 系统更新 | — | ⚠️ 先用勾选清单确认,只禁你不用的 |
仓库已提供按机型整理好的禁用清单作为起点,例如小米 Mi TV 4A 的 examples/xiaomi-mi-tv-4a/debloat.txt,格式为"一行一个包名 + # 注释分组",保留的包把那行注释掉即可。
第四步:禁用命令全清单——pm disable-user 怎么写
核心原则:只用 pm disable-user --user 0 <包名> 禁用,绝不卸载系统包。手动执行时注意一个坑:
⚠️ 一条 shell 调用只跑一条
pm命令。 链式写法pm disable a; pm disable b可能在第一条后静默中断。
手写清单文件后,用批处理模式逐条执行(每条单独一次 shell 调用,共用一条连接):
printf 'pm disable-user --user 0 com.xiaomi.statistic\npm disable-user --user 0 com.mitv.tvhome.michannel\n' | tools/venv/bin/python -I tools/tv.py --batch
禁用完成后跑 pm list packages -d 可核对已禁用列表。
第五步:一键应用去广告清单(disable.sh 用法)
如果懒得手敲,tools/disable.sh 会读取清单文件并逐条禁用,最后打印禁用结果:
TV_HOST=192.168.1.50 tools/disable.sh examples/xiaomi-mi-tv-4a/debloat.txt
它内部就是生成 pm disable-user --user 0 <包名> 命令 + pm list packages -d 验证,通过 tv.py --batch 下发,等价于上一步的手动流程。
第六步:换上无广告 tvOS 风格桌面
禁用原生启动器后,装上项目自带的原生 Android TV 桌面 launcher/(包名 com.gathin.tvhome,专为 1GB 内存电视设计:无模糊、无视频、无网络轮询、无后台服务)。
配置很简单,编辑 launcher/app/src/main/res/values/config.xml 设置 dock 的 4 个应用、隐藏应用、Live TV 包名和列数,然后构建安装(需 JDK 17 + Android SDK platform 34):
TV_HOST=192.168.1.50 launcher/build-and-install.sh
两个关键注意点:
- 必须先装好新桌面再禁用原生启动器,否则 Home 键会落到厂测界面;
- 多个应用争抢 HOME 时,用
cmd package set-home-activity --user 0 com.gathin.tvhome设默认。
第七步:随时一键还原(restore.sh 用法)
所有操作可逆。用 tools/restore.sh 传入同一份清单即可重新启用全部包、恢复原生启动器为 Home 并重置动画缩放:
TV_HOST=192.168.1.50 tools/restore.sh examples/xiaomi-mi-tv-4a/debloat.txt
它执行的命令序列是:逐条 pm enable <包名> → pm enable <原生启动器> → cmd package set-home-activity → 三项动画 scale 归位 → pm list packages -d 复核。
常见坑位与快速排查
| 现象 | 原因与解法 |
|---|---|
macOS 上 adb connect 报 No route to host 但端口是通的 |
新版 macOS 按本地网络隐私策略拦截 Google 签名的 adb,直接用 tools/tv.py 替代,别纠结 |
| 大文件 push 卡死 | Python 客户端传大文件(如 APK)请用 tools/b64push.py:base64 分块 + md5 校验 |
| 换桌面后搜索框没有软键盘(小米) | 默认输入法指向未安装的百度 IME,执行 tools/tv.py 'ime set com.google.android.inputmethod.latin/com.android.inputmethod.latin.LatinIME' |
| 想检查固件更新 | 把 com.xiaomi.mitv.updateservice 那行注释掉(重新启用) |
| 禁用后想找回某个应用 | 电视 设置 → 应用 里也能重新启用,工具不在也能救 |
相关文件索引
- 禁用/还原脚本:tools/disable.sh、tools/restore.sh
- 纯 Python ADB 客户端:tools/tv.py、tools/b64push.py
- 各机型去广告清单:examples/xiaomi-mi-tv-4a/debloat.txt
- 桌面配置:launcher/app/src/main/res/values/config.xml
- 一键式 AI 助手流程提示词:PROMPT.md(不想手动操作的话,把它交给 Claude Code 即可完成上述全部步骤)
🎉 走到这里,你的电视就已经"去广告"完成了——全程只禁用、可一键还原,随时可回退到出厂桌面。

