Skip to content
Back to search

tv-fresh

SkillWorks with Claude CodeGitHub

"小米电视(MIUI TV)改造技能:去广告、换桌面、装代理/YouTube/影视仓、批量清理预装、远程操控电视。当用户提到小米电视/Redmi电视/电视盒子去广告、换Launcher、TVBox/影视仓配置、电视装代理或YouTube、adb 操作电视时使用。需要电视与电脑同网且开启 ADB 调试。"

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/wangrongding--tv-fresh/badge.svg)](/listings/wangrongding--tv-fresh)

HTML

<a href="/listings/wangrongding--tv-fresh"><img src="/api/listings/wangrongding--tv-fresh/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 52 lines
  1. ---
  2. name: tv-fresh
  3. version: 1.0.0
  4. description: "小米电视(MIUI TV)改造技能:去广告、换桌面、装代理/YouTube/影视仓、批量清理预装、远程操控电视。当用户提到小米电视/Redmi电视/电视盒子去广告、换Launcher、TVBox/影视仓配置、电视装代理或YouTube、adb 操作电视时使用。需要电视与电脑同网且开启 ADB 调试。"
  5. metadata:
  6. requires:
  7. bins: ["adb"]
  8. ---
  9. # 小米电视改造(mitv-mod)
  10. 免 root 改造国内 MIUI TV。所有系统级操作均为 `pm uninstall --user 0`(可逆),
  11. 每个任务都附恢复命令。实测机型:MiTV-ASTP0 / Android 9 / armeabi-v7a。
  12. ## 前置:连接电视
  13. ```bash
  14. adb connect <TV_IP>:5555
  15. adb devices # device=通 / unauthorized=电视上有授权弹窗等用户点
  16. ```
  17. 电视侧开 ADB 的路径、以及"每次重启 ADB 被复位"的应对 → 见 [`references/setup-adb.md`](references/setup-adb.md)
  18. ## 任务路由(按用户需求读对应 reference,再动手)
  19. | 用户想做的事 | 必读 |
  20. |---|---|
  21. | 去广告 / 精简系统 | [`references/debloat.md`](references/debloat.md) |
  22. | 换桌面(开机进第三方 Launcher) | [`references/launcher-swap.md`](references/launcher-swap.md) |
  23. | 电视装代理(Clash Meta) | [`references/proxy-youtube.md`](references/proxy-youtube.md) |
  24. | 电视看 YouTube | [`references/proxy-youtube.md`](references/proxy-youtube.md) |
  25. | 装/配 影视仓、OK影视(FongMi)、TVBox | [`references/streaming-apps.md`](references/streaming-apps.md) |
  26. | 批量卸预装 / 修权限 | [`references/cleanup-permissions.md`](references/cleanup-permissions.md) |
  27. | **任何"在电视上输文字/点按钮/看界面"的操作** | [`references/remote-toolbox.md`](references/remote-toolbox.md) ← 强制先读 |
  28. | **安装任何 APK 之前** | [`references/app-sources.md`](references/app-sources.md) ← 只用实测源+装后核对包名 |
  29. ## 一键脚本
  30. [`scripts/mitv-debloat.sh`](scripts/mitv-debloat.sh) `list|install|switchhome|restorehome|perm|debloat|restore <TV_IP>`
  31. ## 硬性安全规则
  32. 1. **系统包只用 `pm uninstall --user 0`**(可逆),绝不用 `pm uninstall -k --user 0` 之外的彻底删除;第三方预装才用 `adb uninstall`
  33. 2. **禁用/卸载任何系统包前,向用户展示清单并获确认**;执行后立刻给出对应恢复命令
  34. 3. **绝不动**:`com.xiaomi.mitv.settings`(中文设置)、`com.xiaomi.mitv.systemui`、`com.mitv.tvplayer`、`com.android.packageinstaller`、`com.xiaomi.voicecontrol`(语音)、投屏相关(miplay/smartshare/airkan/wfdsink)
  35. 4. 桌面操作黑屏时立即回滚:`adb shell cmd package install-existing com.mitv.tvhome`
  36. 5. 电视上输入文字前必读 remote-toolbox(电视输入法会把 ASCII 转全角,直接 `input text` 必产出乱码)
  37. ## 验证原则
  38. - 界面状态以 `uiautomator dump` 的 XML 为准,截图+视觉判读仅做辅助(有误读先例)
  39. - 每步操作后 dump 复核(弹窗是否关闭/字段是否正确),不凭命令返回值推断界面
README.md · README · 282 lines
  1. # 小米电视去广告 + 换开源桌面完全攻略(推荐 Projectivy)
  2. > 适用于国内版 MIUI TV(实测机型 MiTV-ASTP0 / Android 9,2026-10 成功)
  3. > 免 root、全程可逆(所有操作都有对应还原命令)。
  4. > 原理:ADB 调试 + `pm uninstall --user 0`(只对当前用户卸载,系统分区不动,
  5. > `cmd package install-existing <包名>` 一条命令可还原)。
  6. ![改造后的电视桌面(Projectivy Launcher + 无广告 + CMFA/SmartTube/影视仓全家桶)](docs/desktop-home.jpg)
  7. # 作为 Agent Skill 使用(推荐)
  8. 本仓库同时是一个可安装的 agent 技能(含 `SKILL.md` + 分任务 reference + 一键脚本),
  9. 你的 AI 助手装上后即可按流程安全地改造小米电视:
  10. ```bash
  11. # omp 等 agent 的技能目录(其它 agent 放各自的 skills 目录即可)
  12. git clone https://github.com/wangrongding/tv-fresh ~/.agents/skills/tv-fresh
  13. ```
  14. ## 安装后的使用示范(复制即用)
  15. **一键全家桶**(复刻本仓库作者的完整改造效果):
  16. ```text
  17. 我的小米电视(MIUI TV)要全面改造,按 tv-fresh 技能流程来:
  18. 1. 去广告:清掉广告/推送/统计组件,OTA 复活了要能重跑
  19. 2. 换桌面:装 Projectivy Launcher,开机直达无广告,PatchWall 禁用但保留可恢复
  20. 3. 装代理:Clash Meta(CMFA),配置文件在 <你的配置路径/URL>,规则要国内直连、节点挂了不影响电视
  21. 4. 装 YouTube 客户端 SmartTube
  22. 5. 装影视仓 + OK影视(FongMi),配置源用 http://肥猫.net/tv
  23. 6. 清理预装:先给我编号清单我挑,别自作主张删
  24. 电视 IP 是 192.168.1.4(不对就扫 5555 端口找)。
  25. 删除/禁用系统包前列清单等我确认,全程用可逆操作并附恢复命令。
  26. ```
  27. > 需要遥控器配合的只有三处:电视开 ADB、授权弹窗点允许、CMFA 的 VPN 授权——其余 agent 全自动。
  28. **单任务短句**(技能自动路由):
  29. ```text
  30. 帮我把小米电视的开机广告去掉 → debloat
  31. 电视换个第三方桌面,要可回滚 → launcher-swap
  32. 电视上装个能看 YouTube 的 → proxy-youtube
  33. 给 TVBox 配一个能自动更新的接口 → streaming-apps
  34. 电视输入法打网址全是全角符号,帮我填个配置地址 → remote-toolbox
  35. ```
  36. ## 成果
  37. | 项 | 结果 |
  38. |---|---|
  39. | 广告/推送/统计组件 | 全部移除,重启存活 |
  40. | 开机桌面 | PatchWall(瀑布流+广告)→ **Projectivy**(开源、可自定义,实测在用) |
  41. | HOME 键 | 始终回到 Projectivy |
  42. | 系统设置 | 不受影响(`com.xiaomi.mitv.settings`) |
  43. ---
  44. # Part 1 · 去广告(基础篇)
  45. ## 一、解锁开发者模式并开启 ADB
  46. 1. **设置 → 关于 → 「产品型号」**(或「版本号」)**连按遥控器"确定"5-7 次** → 提示"已开启开发者模式"
  47. 2. **设置 → 账号与安全 → ADB 调试 → 允许**(部分固件在 设置 → 通用设置 → 开发者选项)
  48. 3. 首次连接时电视会弹 RSA 授权框,遥控器选"允许"(勾选"一律允许")
  49. > 注意:部分固件(如 MiTV-ASTP0)**每次重启 ADB 开关会被复位**,需重新开启。
  50. > 没有桌面时可用语音键说"打开设置"进入。
  51. ## 二、电脑端连接
  52. ```bash
  53. adb connect <电视IP>:5555
  54. adb devices # 确认 device 状态(unauthorized=电视上有弹窗没点)
  55. ```
  56. 电视与电脑同一路由器即可(2.4G/5G 任意,同网段互通;不要用访客网络)。
  57. ## 三、去广告组件清单(按固件实测调整)
  58. 社区通用清单(部分固件只有其中几项):
  59. | 包名 | 作用 |
  60. |---|---|
  61. | `com.miui.systemAdSolution` | 系统广告引擎(横幅/开屏,核心) |
  62. | `com.duokan.videodaily` | 今日头屏 |
  63. | `com.xiaomi.mitv.tvpush`(.tvpushservice) | 消息推送弹窗 |
  64. | `com.xiaomi.mitv.advertise` | 广告服务 |
  65. | `com.mitv.tvad` | 电视广告 |
  66. | `com.mitv.analysis` / `com.miui.analytics` / `com.miui.tv.analytics` | 行为统计 |
  67. | `com.xiaomi.mistat.analyticstracker` | 埋点上报 |
  68. | `com.xiaomi.tv.musicadapter` | 音乐卡片 |
  69. | `com.xiaomi.mitv.tvmanager` | 电视管家 |
  70. | `com.mitv.shoplugin` | 商城插件 |
  71. ```bash
  72. adb shell pm uninstall --user 0 com.miui.analytics
  73. # ...逐个执行;先 pm list packages 确认存在再删
  74. ```
  75. **不要碰**:`com.android.packageinstaller`、`com.mitv.tvplayer` 等核心组件。
  76. **OTA 升级可能复活组件**:重跑一遍即可。
  77. ## 四、路由器层辅助(可选)
  78. 屏蔽 `ad.xiaomi.com`、`ad1.xiaomi.com`、`ad.mi.com`。
  79. ---
  80. # Part 2 · 换桌面(进阶篇 · 逆向实录)
  81. ## 目标
  82. 开机不进 PatchWall,直接进 **[Projectivy](https://projectivylauncher.com/)**(开源、可自定义壁纸/分组/屏保,作者在用)。方法对任意带 HOME 过滤器的桌面通用。
  83. ## 踩坑记录(排除法)
  84. | 尝试 | 结果 |
  85. |---|---|
  86. | `cmd package set-home-activity` | 返回 Success 但**无效**(首选记录写入了,解析不认) |
  87. | `pm uninstall --user 0 com.mitv.tvhome` | 黑屏 → 落在系统兜底页 FallbackHome |
  88. | `settings put system tvservice_forground_app` | 该键与桌面解析无关 |
  89. | 重打包目标桌面加 `android:priority="1000"` | PMS 解析后 priority 仍为 **0**(被钳制) |
  90. | `setprop sys.fallbackhome_exit` | 无 root 不可写 |
  91. ## 逆向过程
  92. 工具链(全部本地可复现):
  93. 1. **`vdexExtractor`**(源码编译)——这固件 `framework.jar`/`services.jar` 是 183 字节壳,真代码在:
  94. - `/system/framework/boot-framework.vdex`(21MB,framework)
  95. - `/system/framework/oat/arm/services.vdex`(10MB,system_server)
  96. 2. 提取得到 cdex(compact dex)→ baksmali 2.5.2 **不支持 cdex001** → 改用 `vdexExtractor --dis` 内置反汇编(输出 386MB 日志)
  97. 3. `jadx` 反编译普通 APK(TvSettings.apk 里的 FallbackHome 是标准 dex)
  98. ## 根因(三重夹击)
  99. 1. **AOSP 规则**:`set-home-activity` 写入的首选记录 `mAlways=false`;当其它候选的查询 match(0x108000)高于首选记录的 mMatch(0x100000)时,**首选被跳过**
  100. 2. **MIUI PMS 补丁**:第三方桌面 HOME intent-filter 的 priority 被钳制为 0(manifest 写 1000 也无效)
  101. 3. **兜底页**:`com.android.tv.settings/.system.FallbackHome`(系统特权应用)在 PatchWall 缺席时永远赢得解析;它自己的逻辑是"解析结果不是我就每 20 秒重试"——死循环黑屏
  102. 关键证据:
  103. ```
  104. $ adb shell cmd package resolve-activity -a android.intent.action.MAIN -c android.intent.category.HOME
  105. priority=-1000 match=0x108000 isDefault=true
  106. com.android.tv.settings.system.FallbackHome # PatchWall 被禁时
  107. $ adb shell dumpsys package | grep -A6 'Preferred Activities'
  108. com.spocky.projengmenu/.ui.home.MainActivity
  109. mMatch=0x100000 mAlways=false # 首选在但被规则跳过
  110. ```
  111. ## 最终解法 ✅
  112. ```bash
  113. adb connect <TV_IP>:5555
  114. # 1. 装 Projectivy(armeabi-v7a 版)
  115. adb install ProjectivyLauncher-*-xda-release.apk
  116. # 2. 注册首选桌面
  117. adb shell cmd package set-home-activity com.spocky.projengmenu/com.spocky.projengmenu.ui.home.MainActivity
  118. # 3. 禁用 PatchWall(保留在系统分区,可随时还原)
  119. adb shell pm uninstall --user 0 com.mitv.tvhome
  120. # 4. 关键一步:禁用兜底页宿主(AOSP 设置包)
  121. adb shell pm disable-user --user 0 com.android.tv.settings
  122. # 5. 验证:HOME 键应落在 Projectivy
  123. adb shell input keyevent 3 && adb shell dumpsys window windows | grep mCurrentFocus
  124. ```
  125. > 第 4 步安全性说明:国内 MIUI TV 用户看到的中文「设置」是 `com.xiaomi.mitv.settings`,
  126. > AOSP 的 `com.android.tv.settings` 只承载兜底页(和英文设置入口),禁用不影响日常使用。
  127. ## 一键回滚
  128. ```bash
  129. adb shell cmd package install-existing com.mitv.tvhome # 恢复 PatchWall
  130. adb shell pm enable com.android.tv.settings # 恢复兜底页
  131. adb shell pm uninstall com.spocky.projengmenu # (可选)卸载 Projectivy
  132. ```
  133. ## 其它注意事项
  134. - **ADB 每次重启被复位**:语音"打开设置" → 账号与安全 → ADB 调试
  135. - 想换其它桌面(当贝等):同样三步即可,但**当贝闭源且带内容推荐位**,介意请保持 Projectivy
  136. - 开机广告由固件启动流程加载,删 `com.mitv.tvad`(在装的前提下)多数固件可跳过
  137. ---
  138. # Part 3 · 电视完全体(代理 / YouTube / 影视仓 / 清理)
  139. > 换桌面之后的进阶玩法,全部实测于 MiTV-ASTP0 / Android 9 / armeabi-v7a。
  140. ## 一、电视独立代理(Clash Meta for Android)
  141. 1. 侧载 [CMFA](https://github.com/MetaCubeX/ClashMetaForAndroid/releases)(armeabi-v7a 包)
  142. 2. 生成 mihomo 配置(节点 + `GEOIP,CN,DIRECT` 分流规则,**国内应用零影响,节点挂了关 VPN 即可**)
  143. 3. 导入技巧:配置文件放电脑上 `python3 -m http.server 18972`,
  144. 然后 `adb reverse tcp:18972 tcp:18972`,电视端 CMFA 用深链导入:
  145. ```bash
  146. adb shell am start -a android.intent.action.VIEW \
  147. -d "clash://install-config?url=http%3A%2F%2F127.0.0.1%3A18972%2Fconfig.yaml"
  148. ```
  149. > adb reverse 完美绕开"电脑防火墙拦局域网"的问题;若要真局域网分发记得
  150. > `ufw allow from 192.168.1.0/24 to any port 18972 proto tcp`。
  151. ## 二、YouTube = SmartTube
  152. [SmartTube](https://github.com/yuliskov/SmartTube)(开源、无广告、免谷歌服务、遥控器友好)。
  153. 官方 YouTube 装不了:强依赖 GMS + 设备认证 + Widevine,国产电视三座大山全撞。
  154. ## 三、影视仓 / OK影视(FongMi):TVBox 配置的其它玩家
  155. - 常用接口源(社区维护,时活时死,装前先 `curl -A 'okhttp/3.15' <url>` 验证返回 JSON 且含 sites):
  156. | 接口 | 实测(2026-10) |
  157. |---|---|
  158. | `http://肥猫.net/tv` | ✅ 可用(40站) |
  159. | `http://www.饭太硬.net/tv` | ⚠️ 返回图片页,非直连配置 |
  160. | `http://fty.xxooo.cf/tv` / `http://我不是.摸鱼儿.top` | ❌ 失效中 |
  161. - 影视仓:瀑布流内容墙(翻着看);FongMi:搜索型(搜着看);各有所长
  162. - 饭太硬接口死因诊断样本:域名被 DNS 污染解析到 Facebook IP 段(157.240.x.x)
  163. ## 四、批量清理预装 & 权限修复
  164. ```bash
  165. # 第三方预装直接卸载
  166. adb shell uninstall com.cibn.tv com.newtv.cboxtv com.ktcp.video ...
  167. # 系统包用 --user 0(可逆)
  168. adb shell pm uninstall --user 0 com.mitv.shoplugin
  169. # 存储权限曾被"拒绝且不再询问"(USER_FIXED)的,系统层直接改判:
  170. adb shell pm grant com.github.tvbox.osc.tk android.permission.READ_EXTERNAL_STORAGE
  171. adb shell pm grant com.github.tvbox.osc.tk android.permission.WRITE_EXTERNAL_STORAGE
  172. ```
  173. > 陷阱:`com.xiaoji.tvbox` 名字像 TVBox 分支,实际是街机模拟器(com.xiaoji.emu.mame),
  174. > 别按名字想当然归类。
  175. ---
  176. # Part 4 · 远程操控电视的正确姿势(血泪工具箱)
  177. ## 1. uiautomator dump = 坐标与文本的唯一可信来源
  178. 视觉判读会错(本人实测把"未保存"看成"已保存"),XML 不会:
  179. ```bash
  180. adb shell uiautomator dump /sdcard/ui.xml && adb pull /sdcard/ui.xml .
  181. # 解析出所有 text + bounds + focused,点击/校验全靠它
  182. ```
  183. ## 2. 电视输入法会把 ASCII 打成全角
  184. `input text 'http://a.b/c'` → 字段里变成 `http://a。b/c`(搜狗TV输入法的"功劳",
  185. `fm` 甚至能变`父母`)。解法 = [ADBKeyboard](https://github.com/senzhk/ADBKeyboard):
  186. ```bash
  187. adb install ADBKeyboard.apk
  188. adb shell ime set com.android.adbkeyboard/.AdbIME
  189. adb shell am broadcast -a ADB_CLEAR_TEXT # 清空当前输入框
  190. adb shell am broadcast -a ADB_INPUT_TEXT --es msg 'https://...' # 原样注入(支持中文)
  191. adb shell ime set com.sohu.inputmethod.sogou.tv/.SogouIME # 用完恢复搜狗
  192. ```
  193. ## 3. 很多 TV 按钮不认 tap,只认 D-pad
  194. 影视仓的"确定"点击 7 次无效,键盘导航一次过。通用套路:
  195. ```bash
  196. adb shell input keyevent 61 # TAB 在输入框/按钮间移动焦点
  197. adb shell input keyevent 21/22/20/21 # 左右上下微调焦点
  198. adb shell input keyevent 23 # 确定键激活
  199. ```
  200. ## 4. 其它碎片经验
  201. - `pm clear` 后应用丢权限,先补授权再走配置流程
  202. - 弹窗布局会因输入法收起而**重排**,坐标要用完就取,别缓存
  203. - 截图 + 视觉模型判读:内容含敏感词会被审查接口 400(聚合源的成人站分类中招过)
  204. - Herdr 用户可把视觉判读派给副 pane 的轻量模型,主流程只信 XML

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.