| name | tv-fresh |
|---|---|
| version | 1.0.0 |
| description | 小米电视(MIUI TV)改造技能：去广告、换桌面、装代理/YouTube/影视仓、批量清理预装、远程操控电视。当用户提到小米电视/Redmi电视/电视盒子去广告、换Launcher、TVBox/影视仓配置、电视装代理或YouTube、adb 操作电视时使用。需要电视与电脑同网且开启 ADB 调试。 |
| metadata | {"requires": {"bins": ["adb"]}} |
小米电视改造（mitv-mod）
免 root 改造国内 MIUI TV。所有系统级操作均为 pm uninstall --user 0（可逆），
每个任务都附恢复命令。实测机型：MiTV-ASTP0 / Android 9 / armeabi-v7a。
前置：连接电视
adb connect <TV_IP>:5555
adb devices # device=通 / unauthorized=电视上有授权弹窗等用户点
电视侧开 ADB 的路径、以及"每次重启 ADB 被复位"的应对 → 见 references/setup-adb.md
任务路由（按用户需求读对应 reference，再动手）
| 用户想做的事 | 必读 |
|---|---|
| 去广告 / 精简系统 | references/debloat.md |
| 换桌面（开机进第三方 Launcher） | references/launcher-swap.md |
| 电视装代理（Clash Meta） | references/proxy-youtube.md |
| 电视看 YouTube | references/proxy-youtube.md |
| 装/配 影视仓、OK影视(FongMi)、TVBox | references/streaming-apps.md |
| 批量卸预装 / 修权限 | references/cleanup-permissions.md |
| 任何"在电视上输文字/点按钮/看界面"的操作 | references/remote-toolbox.md ← 强制先读 |
一键脚本
scripts/mitv-debloat.sh list|install|switchhome|restorehome|perm|debloat|restore <TV_IP>
硬性安全规则
- 系统包只用
pm uninstall --user 0（可逆），绝不用pm uninstall -k --user 0之外的彻底删除；第三方预装才用adb uninstall - 禁用/卸载任何系统包前，向用户展示清单并获确认；执行后立刻给出对应恢复命令
- 绝不动：
com.xiaomi.mitv.settings（中文设置）、com.xiaomi.mitv.systemui、com.mitv.tvplayer、com.android.packageinstaller、com.xiaomi.voicecontrol（语音）、投屏相关（miplay/smartshare/airkan/wfdsink） - 桌面操作黑屏时立即回滚：
adb shell cmd package install-existing com.mitv.tvhome - 电视上输入文字前必读 remote-toolbox（电视输入法会把 ASCII 转全角，直接
input text必产出乱码）
验证原则
- 界面状态以
uiautomator dump的 XML 为准，截图+视觉判读仅做辅助（有误读先例） - 每步操作后 dump 复核（弹窗是否关闭/字段是否正确），不凭命令返回值推断界面