手把手ADB电视优化教程:tv-vibehack手动去广告全流程,从探测到禁用命令全清单

原创2026-10-19 22:31:524,924 阅读
文章标签:智能硬件开发工具

手把手ADB电视优化教程:tv-vibehack手动去广告全流程,从探测到禁用命令全清单

tv-vibehack 是一个通过 ADB 为任意 Android TV / Google TV 去广告、去预装(debloat)并换上 tvOS 风格桌面的开源项目。本教程带你完全手动走一遍全流程:开启 USB 调试 → 探测电视型号 → 列出安装包 → 用 pm disable-user 禁用命令清掉厂商遥测和 PatchWall 广告 → 安装无广告桌面,最后随时一键还原。所有操作只"禁用"不"卸载",风险可控。

优化前后对比:电视桌面去广告效果一览

先看最终效果——左侧是带赞助商横幅、Shop 购物行和推荐信息流的 Google TV 原生桌面,右侧是 tv-vibehack 的纯黑 tvOS 风格桌面,只有你自己选的 4 个应用:

tv-vibehack Android TV去广告优化前后桌面对比图:左侧原生桌面含Sponsored广告横幅,右侧为无广告tvOS风格桌面

💡 适合机型:小米/红米、TCL、海信、索尼、一加、Realme、Nvidia Shield 等一切 Android TV / Google TV 电视。不适用三星 Tizen、LG webOS、亚马逊 Fire TV。

第一步:在电视上开启 USB 调试(ADB 调试开关路径)

  1. 电视端进入:设置 → 设备偏好 → 关于,用遥控器的 OK 键连续按 7 次 Build(版本),返回后进入 开发者选项;
  2. 打开 USB 调试;如果菜单里有"网络/ADB 调试"开关,也一并打开(部分电视如小米没有该开关,仅开 USB 调试也会自动开放 5555 端口的网络 ADB);
  3. 记下电视 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 内存电视设计:无模糊、无视频、无网络轮询、无后台服务)。

tv-vibehack 去广告后安装完成的tvOS风格Android TV桌面:纯黑背景、底部四应用dock、顶部时钟与输入/网络/设置胶囊按钮

配置很简单,编辑 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

两个关键注意点:

  1. 必须先装好新桌面再禁用原生启动器,否则 Home 键会落到厂测界面;
  2. 多个应用争抢 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 那行注释掉(重新启用)
禁用后想找回某个应用 电视 设置 → 应用 里也能重新启用,工具不在也能救

相关文件索引

🎉 走到这里,你的电视就已经"去广告"完成了——全程只禁用、可一键还原,随时可回退到出厂桌面。

登录后查看全文
cleanyourtv