tv-fresh README

项目的 README,来自 github.com/wangrongding/tv-fresh。合并为一个 markdown 文件:README.md。

小米电视去广告 + 换开源桌面完全攻略(推荐 Projectivy)

适用于国内版 MIUI TV(实测机型 MiTV-ASTP0 / Android 9,2026-10 成功) 免 root、全程可逆(所有操作都有对应还原命令)。 原理:ADB 调试 + pm uninstall --user 0(只对当前用户卸载,系统分区不动, cmd package install-existing <包名> 一条命令可还原)。 改造后的电视桌面(Projectivy Launcher + 无广告 + CMFA/SmartTube/影视仓全家桶)

作为 Agent Skill 使用(推荐)

本仓库同时是一个可安装的 agent 技能(含 SKILL.md + 分任务 reference + 一键脚本), 你的 AI 助手装上后即可按流程安全地改造小米电视:

# omp 等 agent 的技能目录(其它 agent 放各自的 skills 目录即可)
git clone https://github.com/wangrongding/tv-fresh ~/.agents/skills/tv-fresh

安装后的使用示范(复制即用)

一键全家桶(复刻本仓库作者的完整改造效果):

我的小米电视(MIUI TV)要全面改造,按 tv-fresh 技能流程来:
1. 去广告:清掉广告/推送/统计组件,OTA 复活了要能重跑
2. 换桌面:装 Projectivy Launcher,开机直达无广告,PatchWall 禁用但保留可恢复
3. 装代理:Clash Meta(CMFA),配置文件在 <你的配置路径/URL>,规则要国内直连、节点挂了不影响电视
4. 装 YouTube 客户端 SmartTube
5. 装影视仓 + OK影视(FongMi),配置源用 http://肥猫.net/tv
6. 清理预装:先给我编号清单我挑,别自作主张删
电视 IP 是 192.168.1.4(不对就扫 5555 端口找)。
删除/禁用系统包前列清单等我确认,全程用可逆操作并附恢复命令。

需要遥控器配合的只有三处:电视开 ADB、授权弹窗点允许、CMFA 的 VPN 授权——其余 agent 全自动。

单任务短句(技能自动路由):

帮我把小米电视的开机广告去掉                    → debloat
电视换个第三方桌面,要可回滚                    → launcher-swap
电视上装个能看 YouTube 的                       → proxy-youtube
给 TVBox 配一个能自动更新的接口                 → streaming-apps
电视输入法打网址全是全角符号,帮我填个配置地址   → remote-toolbox

成果

项 结果
广告/推送/统计组件 全部移除,重启存活
开机桌面 PatchWall(瀑布流+广告)→ Projectivy(开源、可自定义,实测在用)
HOME 键 始终回到 Projectivy
系统设置 不受影响(com.xiaomi.mitv.settings)

Part 1 · 去广告(基础篇)

一、解锁开发者模式并开启 ADB

  1. 设置 → 关于 → 「产品型号」(或「版本号」)连按遥控器"确定"5-7 次 → 提示"已开启开发者模式"
  2. 设置 → 账号与安全 → ADB 调试 → 允许(部分固件在 设置 → 通用设置 → 开发者选项)
  3. 首次连接时电视会弹 RSA 授权框,遥控器选"允许"(勾选"一律允许")

注意:部分固件(如 MiTV-ASTP0)每次重启 ADB 开关会被复位,需重新开启。 没有桌面时可用语音键说"打开设置"进入。

二、电脑端连接

adb connect <电视IP>:5555
adb devices   # 确认 device 状态(unauthorized=电视上有弹窗没点)

电视与电脑同一路由器即可(2.4G/5G 任意,同网段互通;不要用访客网络)。

三、去广告组件清单(按固件实测调整)

社区通用清单(部分固件只有其中几项):

包名 作用
com.miui.systemAdSolution 系统广告引擎(横幅/开屏,核心)
com.duokan.videodaily 今日头屏
com.xiaomi.mitv.tvpush(.tvpushservice) 消息推送弹窗
com.xiaomi.mitv.advertise 广告服务
com.mitv.tvad 电视广告
com.mitv.analysis / com.miui.analytics / com.miui.tv.analytics 行为统计
com.xiaomi.mistat.analyticstracker 埋点上报
com.xiaomi.tv.musicadapter 音乐卡片
com.xiaomi.mitv.tvmanager 电视管家
com.mitv.shoplugin 商城插件
adb shell pm uninstall --user 0 com.miui.analytics
# ...逐个执行;先 pm list packages 确认存在再删

不要碰:com.android.packageinstaller、com.mitv.tvplayer 等核心组件。 OTA 升级可能复活组件:重跑一遍即可。

四、路由器层辅助(可选)

屏蔽 ad.xiaomi.com、ad1.xiaomi.com、ad.mi.com。


Part 2 · 换桌面(进阶篇 · 逆向实录)

目标

开机不进 PatchWall,直接进 Projectivy(开源、可自定义壁纸/分组/屏保,作者在用)。方法对任意带 HOME 过滤器的桌面通用。

踩坑记录(排除法)

尝试 结果
cmd package set-home-activity 返回 Success 但无效(首选记录写入了,解析不认)
pm uninstall --user 0 com.mitv.tvhome 黑屏 → 落在系统兜底页 FallbackHome
settings put system tvservice_forground_app 该键与桌面解析无关
重打包目标桌面加 android:priority="1000" PMS 解析后 priority 仍为 0(被钳制)
setprop sys.fallbackhome_exit 无 root 不可写

逆向过程

工具链(全部本地可复现):

  1. vdexExtractor(源码编译)——这固件 framework.jar/services.jar 是 183 字节壳,真代码在:
    • /system/framework/boot-framework.vdex(21MB,framework)
    • /system/framework/oat/arm/services.vdex(10MB,system_server)
  2. 提取得到 cdex(compact dex)→ baksmali 2.5.2 不支持 cdex001 → 改用 vdexExtractor --dis 内置反汇编(输出 386MB 日志)
  3. jadx 反编译普通 APK(TvSettings.apk 里的 FallbackHome 是标准 dex)

根因(三重夹击)

  1. AOSP 规则:set-home-activity 写入的首选记录 mAlways=false;当其它候选的查询 match(0x108000)高于首选记录的 mMatch(0x100000)时,首选被跳过
  2. MIUI PMS 补丁:第三方桌面 HOME intent-filter 的 priority 被钳制为 0(manifest 写 1000 也无效)
  3. 兜底页:com.android.tv.settings/.system.FallbackHome(系统特权应用)在 PatchWall 缺席时永远赢得解析;它自己的逻辑是"解析结果不是我就每 20 秒重试"——死循环黑屏

关键证据:

$ adb shell cmd package resolve-activity -a android.intent.action.MAIN -c android.intent.category.HOME
priority=-1000 match=0x108000 isDefault=true
com.android.tv.settings.system.FallbackHome      # PatchWall 被禁时

$ adb shell dumpsys package | grep -A6 'Preferred Activities'
  com.spocky.projengmenu/.ui.home.MainActivity
   mMatch=0x100000 mAlways=false                  # 首选在但被规则跳过

最终解法 ✅

adb connect <TV_IP>:5555
# 1. 装 Projectivy(armeabi-v7a 版)
adb install ProjectivyLauncher-*-xda-release.apk
# 2. 注册首选桌面
adb shell cmd package set-home-activity com.spocky.projengmenu/com.spocky.projengmenu.ui.home.MainActivity
# 3. 禁用 PatchWall(保留在系统分区,可随时还原)
adb shell pm uninstall --user 0 com.mitv.tvhome
# 4. 关键一步:禁用兜底页宿主(AOSP 设置包)
adb shell pm disable-user --user 0 com.android.tv.settings
# 5. 验证:HOME 键应落在 Projectivy
adb shell input keyevent 3 && adb shell dumpsys window windows | grep mCurrentFocus

第 4 步安全性说明:国内 MIUI TV 用户看到的中文「设置」是 com.xiaomi.mitv.settings, AOSP 的 com.android.tv.settings 只承载兜底页(和英文设置入口),禁用不影响日常使用。

一键回滚

adb shell cmd package install-existing com.mitv.tvhome   # 恢复 PatchWall
adb shell pm enable com.android.tv.settings               # 恢复兜底页
adb shell pm uninstall com.spocky.projengmenu            # (可选)卸载 Projectivy

其它注意事项


Part 3 · 电视完全体(代理 / YouTube / 影视仓 / 清理)

换桌面之后的进阶玩法,全部实测于 MiTV-ASTP0 / Android 9 / armeabi-v7a。

一、电视独立代理(Clash Meta for Android)

  1. 侧载 CMFA(armeabi-v7a 包)
  2. 生成 mihomo 配置(节点 + GEOIP,CN,DIRECT 分流规则,国内应用零影响,节点挂了关 VPN 即可)
  3. 导入技巧:配置文件放电脑上 python3 -m http.server 18972, 然后 adb reverse tcp:18972 tcp:18972,电视端 CMFA 用深链导入:
adb shell am start -a android.intent.action.VIEW \
  -d "clash://install-config?url=http%3A%2F%2F127.0.0.1%3A18972%2Fconfig.yaml"

adb reverse 完美绕开"电脑防火墙拦局域网"的问题;若要真局域网分发记得 ufw allow from 192.168.1.0/24 to any port 18972 proto tcp。

二、YouTube = SmartTube

SmartTube(开源、无广告、免谷歌服务、遥控器友好)。 官方 YouTube 装不了:强依赖 GMS + 设备认证 + Widevine,国产电视三座大山全撞。

三、影视仓 / OK影视(FongMi):TVBox 配置的其它玩家

四、批量清理预装 & 权限修复

# 第三方预装直接卸载
adb shell uninstall com.cibn.tv com.newtv.cboxtv com.ktcp.video ...
# 系统包用 --user 0(可逆)
adb shell pm uninstall --user 0 com.mitv.shoplugin
# 存储权限曾被"拒绝且不再询问"(USER_FIXED)的,系统层直接改判:
adb shell pm grant com.github.tvbox.osc.tk android.permission.READ_EXTERNAL_STORAGE
adb shell pm grant com.github.tvbox.osc.tk android.permission.WRITE_EXTERNAL_STORAGE

陷阱:com.xiaoji.tvbox 名字像 TVBox 分支,实际是街机模拟器(com.xiaoji.emu.mame), 别按名字想当然归类。


Part 4 · 远程操控电视的正确姿势(血泪工具箱)

1. uiautomator dump = 坐标与文本的唯一可信来源

视觉判读会错(本人实测把"未保存"看成"已保存"),XML 不会:

adb shell uiautomator dump /sdcard/ui.xml && adb pull /sdcard/ui.xml .
# 解析出所有 text + bounds + focused,点击/校验全靠它

2. 电视输入法会把 ASCII 打成全角

input text 'http://a.b/c' → 字段里变成 http://a。b/c(搜狗TV输入法的"功劳", fm 甚至能变父母)。解法 = ADBKeyboard:

adb install ADBKeyboard.apk
adb shell ime set com.android.adbkeyboard/.AdbIME
adb shell am broadcast -a ADB_CLEAR_TEXT                      # 清空当前输入框
adb shell am broadcast -a ADB_INPUT_TEXT --es msg 'https://...'  # 原样注入(支持中文)
adb shell ime set com.sohu.inputmethod.sogou.tv/.SogouIME     # 用完恢复搜狗

3. 很多 TV 按钮不认 tap,只认 D-pad

影视仓的"确定"点击 7 次无效,键盘导航一次过。通用套路:

adb shell input keyevent 61   # TAB 在输入框/按钮间移动焦点
adb shell input keyevent 21/22/20/21 # 左右上下微调焦点
adb shell input keyevent 23   # 确定键激活

4. 其它碎片经验

tv-fresh (wangrongding/tv-fresh)

正在搜索数据库…

这是什么?tv-fresh 是一套工具(也可以作为 AI 智能体技能安装),用于精简中国大陆市场的小米 MIUI 电视:它会移除广告和追踪组件,把自带的 PatchWall 启动器换成开源的 Projectivy,设置 Clash Meta 代理,并安装替代的流媒体应用,全程无需 root 设备。
这只是个 bash 脚本,还是我的 AI 助手会把它当作技能来安装?两者都支持:这个仓库是 GitHub 项目,你可以克隆下来手动运行;它也附带了 SKILL.md、针对具体任务的参考文档和一键脚本,因此 AI 智能体可以自行安装,并通过 ADB 驱动整个流程。
我该如何在电视上开始?在电视上进入「设置 > 关于」,连续点击型号/版本号 5-7 次以解锁开发者模式,然后在「账号与安全」中开启 ADB 调试,并从与电视处于同一 Wi-Fi 网络的电脑上连接;之后,AI 智能体技能或脚本会通过 ADB 命令完成移除广告应用和替换启动器的操作。
我需要给电视 root 或使用特殊硬件吗?不需要 root。所有操作都通过 `adb` 和 `pm uninstall --user 0` 完成,它只会为当前用户移除应用,不会改动系统分区,因此完全可以还原。
精简设置在重启和固件更新后还能保留吗?大多数情况下可以,但在某些固件(例如 MiTV-ASTP0)上,ADB 调试开关每次重启后都会重置,需要重新打开;OTA 更新也可能让已移除的广告组件重新出现,这时只需重新运行脚本即可。
这个方法能保证在任何小米电视上都能用吗?它已于 2026 年 10 月确认可在中国大陆 MIUI 电视固件(MiTV-ASTP0,Android 9)上运行;广告应用列表以及部分逆向工程得出的步骤,在其他型号或固件版本上可能有所不同。
为什么我不能直接安装官方 YouTube 应用?官方 YouTube 应用需要 Google 移动服务、设备认证和 Widevine DRM,而国产 MIUI 电视都不具备这些,因此项目改用 SmartTube——一款无需任何 Google 服务即可运行的开源无广告客户端。
作者是如何在无 root 的情况下找到替换启动器的方法的?作者用 vdexExtractor 和 jadx 对固件中的 framework.jar/services.jar 进行提取和反编译(这两个文件只是 183 字节的存根,真正的代码位于 boot-framework.vdex 和 services.vdex 中),由此追踪到 MIUI 的 PackageManagerService 会将第三方启动器的优先级钳制为 0,并找到了绕过方法。
设置代理会影响国内应用吗?不会。Clash Meta for Android 的配置使用 GEOIP,CN,DIRECT 分流规则,因此只有非中国大陆的流量才会经过代理节点,国内应用不受影响。
精简之后,我用什么看盗版电影和剧集?指南涵盖了影视仓(内容墙风格)和 FongMi/OK影视(搜索风格),这两款都兼容 TVBox,依赖社区维护的 API 源列表,而这些源经常失效或遭到 DNS 污染。
大小
0.3 MB
星标
794
更新
提交Oct 25
时长
25天
提交 · 90 天