6071 字
30 分钟
Aerial 超详细拆箱:给国产电视换一块没有广告的 tvOS 风桌面(附全部安装命令)
2026-11-16

打开国产电视,先迎接你的是什么?满屏的剧集推荐、会员入口、限免角标,自己的 App 反而要翻三层才能找到。Aerial 想解决的就是这件事:它是一个参照 Apple TV(tvOS)设计的开源 Android TV 桌面,装上之后开机自动接管——没有广告,没有推荐流,只有你的 App、壁纸和航拍屏保。它不用 root,不动系统应用,随时可以还原,却能把小米、TCL、创维、索尼这些「只认自家桌面」的电视一一拿下。本文按超详细规格来拆:功能、原理、版本、部署命令、源码构建、机型名单,一次讲全。

项目地址:https://github.com/pengchujin/aerial-tv

先看清这是什么#

Aerial 的包名是 app.orchard.tv,官网在 aerial.qust.me,MIT 开源。几个关键数据(2026 年 11 月查于仓库主页):

项目数据
Star约 12.1k
Fork约 1.0k
版本发布92 个 Release
提交数948
许可证MIT
系统要求Android 5.0+(另有 4.0–4.4 的 Lite 版)
支持设备小米、TCL、雷鸟、创维、海信、索尼等电视,以及盒子、投影仪

它和普通「换个启动器」的区别在于目标定得非常明确:不是多一个桌面选项,而是让电视从开机那一刻起就只剩这块干净桌面。原厂桌面、会员体系、小爱同学、电视账号、有线电视全都保留,只是退到幕后——想用原桌面,从 App 列表里照样能进。

换与不换,差别一目了然:

电视自带桌面Aerial
首屏内容剧集推荐、会员广告、限免角标你的 App、壁纸、时钟
找 App多层菜单里翻首页玻璃底板 + 全部 App 网格
屏保厂商广告或静态图Apple TV 同款 114 段航拍影片
整理方式遥控器逐个挪遥控器长按,或手机扫码拖动
开机广告固件播的,去不掉同样去不掉(这是实话,先说清)

功能全拆解#

首页与玻璃底板#

第一排常用 App 放在屏幕下方的玻璃底板上,往下滚动是全部 App 的网格。值得一提的是,它连小米「应用中心」「米家」这类被厂商藏起来的系统 App 都能列出来——很多第三方桌面只显示普通应用,系统应用是缺的。

整理:文件夹、隐藏与开机直达#

长按 OK 键(或按菜单键)进入整理:移动位置、放进文件夹、隐藏、卸载都可以。最实用的一项是「开机时打开」:可以指定开机、待机醒来后直接进某个 App 或某个信号源——比如开机直达机顶盒的 HDMI,或者直达 Jellyfin 客户端,电视就变回一台纯粹的播放终端。

固定到主屏幕的 HDMI 信号源可以选设备类型(Apple TV、PlayStation、Switch、Xbox、电脑等),磁贴会换成对应图标,还能在手机上给它起名字。

用手机整理桌面#

在电视上扫二维码,手机里打开的就是和电视一模一样的图标网格:按住拖动排序,点一下改名、换图标、放进文件夹或隐藏,也能把 HDMI 等信号源加到主屏幕。用遥控器逐格挪图标有多痛苦,用过的人都懂,这个功能是真正的效率分水岭。

图标库#

常用 App 直接配好了 16:9 磁贴图,一个 App 可以有好几张可选,在手机上点开就能挑,每张都标注来源。图的来源有四路:社区画师 le5inioo 的一整套作品、App 自己的 tvOS 版图标、Aerial 为系统 App 自绘的图标,以及当贝桌面的图。

控制中心#

在第一排按上键、到右上角打开控制中心:信号源、网络、设置、音量、亮度、个性化都在这里。1.32 版起,新版本提示也出现在这里,点进去就能下载安装升级(后文详述)。

屏保:114 段航拍影片#

屏保是 Apple TV 标志性的航拍影片,共 114 段,电视支持时可以播 4K 或 4K 杜比视界版本,影片由 Apple 的服务器直接播放。也可以换成照片、时钟,或者从手机添加的本地视频。

壁纸#

壁纸来源有四种:必应每日精选、14 张内置壁纸、用手机扫码传的照片和视频,以及航拍模式——停在主屏幕 10 秒后,航拍会在磁贴后面自动播放,按任意键就停在当前画面当壁纸。

个性化#

每排 4、5 或 6 个 App、单排或双排布局、时钟大小和位置、App 名称显示、焦点样式、按键声音,都能改。老电视或内存小的电视从 1.48 版起会自动切换到「流畅」效果(面板纯色、去掉高光),也可以在个性化里手动选——这一点和 Home Assistant 那种「先跑起来再谈美观」的家庭设备思路一致:先保证不卡。

它怎么接管桌面:原理#

这是 Aerial 最硬核的部分。国产电视大多只认自家桌面,待机时还会清理第三方 App,光靠 Android 标准的「设为默认桌面」根本站不住。Aerial 的解法是三层:

层机制干什么
桌面守护无障碍服务只看哪个窗口在前台,原桌面一出现就切回 Aerial
复活通知使用权监听被系统清理后,靠通知监听让系统把 Aerial 重新拉起来
兜底用量统计老小米(Android 6)的桌面不报告窗口变化,改看系统用量统计判断前台

两个隐私边界写得很清楚:无障碍服务只判断哪个窗口在前台,不读屏幕内容;通知监听不读通知内容,只借它做复活通道。有些酷开、创维固件不按标准方式启动桌面,守护也专门认了它们自家的桌面组件。原生 Android TV 没有这些对抗,直接设成默认桌面即可,不需要守护。

三个版本先分清#

下载页有三个 APK,装错版本是新手最常见的坑:

版本包名用在哪备注
aerial-standard.apkapp.orchard.tvAndroid 5.0+,先装这个完整版,绝大多数电视用它
aerial-guard.apkapp.orchard.tv(守护变体)standard 装不上、提示不允许安装桌面类 App 时靠守护机制接管的版本
aerial-lite.apkapp.orchard.tv.liteAndroid 4.0–4.4 老电视、老盒子测试版(1.0),功能有删减,见后文

部署方式总览#

Aerial 的「部署」不是往服务器上装,而是往电视上装。官方给了四条路径,难度从低到高:

方式需要什么适合谁
Agent 代装一台能跑命令的电脑 + 任意编程 Agent完全不想碰命令的人
一行命令macOS / Linux 电脑有终端经验的人
手动 ADB任意电脑 + platform-tools想搞清每一步的人
U 盘安装U 盘没有电脑,或先试个水

四条路径的共同前置条件只有两个:电脑和电视连同一个网络,以及在电视上打开 ADB 调试。下面先讲前置,再逐条拆四种部署。

前置一:打开电视的 ADB 调试#

各品牌开 ADB 的入口完全不同,这是整个安装里最需要查表的一步:

电视怎么打开
小米 / Redmi设置 → 关于 → 连续按「产品型号/产品类型」进开发者模式,再到 设置 → 账号与安全,打开「ADB 调试」和「安装未知来源的应用」
TCL / 雷鸟设置 → 关于 → 本机信息,快速按遥控器「上下左右」,在底部「更多」里打开 ADB
海尔 / 模卡按机身信号源键,再用遥控器按「左左上右」,在工厂菜单里打开「ADB 调试开关」,别动其他选项
海信 / Vidda设置 → 声音关杜比全景声,在专业音响设置 → 声音平衡里快速交替按「确认」「菜单」,出现 M 后按「菜单」进工厂菜单,把 To Fac 从 U 改成 M 后重启;再连按「菜单」打开原生设置,连按版本号后在开发者选项里打开「USB 调试」和「无线调试」
OPPO(含 S1)设置 → 系统 → 关于本机 → 设备型号,按「上上右右」再确认;再到开发者选项打开「USB 调试」;IP 在 设置 → 网络 → 已连接的网络 最下面
其他 Android TV设置 → 设备偏好设置 → 关于 → 连按「内部版本号」7 次,再在开发者选项里打开「USB 调试」

电视 IP 在「设置 → 网络 → 已连接的网络」里查。第一次连接时,有 USB 调试开关的电视会弹窗问是否允许调试,选「始终允许」。更细的分品牌说明(包括打不开 ADB 的机型)在仓库的 docs/devices/adb-by-brand.md 里。

WARNING

工厂菜单是高危区:海信的 To Fac 只改一次——反复改可能让 USB 失灵、只能重置电视。其他品牌的工厂菜单也一样,只动 ADB 开关那一项,改完立刻退出,不要好奇乱翻其他选项。

前置二:只有无线调试的电视先配对#

部分 Android 11+ 电视(例如索尼 BRAVIA 的 Android 14)只有「无线调试」、没有旧式 ADB 开关,不提供明文端口,不能直接 adb connect <IP>:5555,第一次连接必须先配对。在电视上打开 设置 → 系统 → 开发者选项 → 无线调试 → 使用配对码配对设备,然后在电脑上:

Terminal window
adb pair 192.168.1.20:37115
# 提示 Enter pairing code 时,输入电视屏幕上的 6 位配对码
adb connect 192.168.1.20:39201
# 这里用的是无线调试主页面上显示的另一组 IP:端口,与配对端口不同

连上之后,建议再运行一次 adb tcpip 5555,把电视切回经典的 5555 端口模式,以后所有命令都能直接用 <电视IP>:5555,配过对的电脑不用再配对。注意:部分 TCL 固件(Q10M、Q10L、鹤 6 Ultra 等)没有配对码入口,只能先用数据线连电脑授权一次,再 adb tcpip 5555。

部署方式一:交给 Agent 装(官方推荐)#

这是官方放在第一位的安装方式:把一段现成的指令发给能在电脑上运行命令的 Agent(Claude Code、Codex、Trae、WorkBuddy、豆包电脑版、千问电脑版等),由它读官方安装说明、在你的电脑上亲自执行命令,装完按验收标准贴出原始输出:

请帮我把开源电视桌面 Aerial 装到我的电视上,并设为开机进入的桌面。
电视 IP:<电视IP>
保持 ADB 常开:要
安装说明在这里:https://aerial.qust.me/agent.md
(打不开时用 https://raw.githubusercontent.com/pengchujin/aerial-tv/main/site/agent.md )
请先完整读完安装说明再动手,然后在我的电脑上亲自运行命令,不要只把步骤告诉我。需要我在电视上操作时提醒我。
最后按说明里的「验收」,把这几条命令的原始输出原样贴给我:
- adb shell "cmd package resolve-activity --brief -a android.intent.action.MAIN -c android.intent.category.HOME"
- adb shell settings get secure enabled_accessibility_services
- 按主页键后的 adb shell "dumpsys window | grep mCurrentFocus"

三个验收点分别确认:系统默认桌面解析到了谁、无障碍守护在不在启用列表里、按主页键后前台窗口到底是谁。判断装没装好,只看最后一条的输出里有没有 app.orchard.tv。手机上的聊天 App 只会把步骤「告诉」你、不会执行,必须用电脑版或工作版 Agent。没有电脑时,有用户用手机上的甲壳虫 ADB 助手、超级小爱装成功过,但仓库没有逐一实测。

部署方式二:一行命令(macOS / Linux)#

有终端经验的人,这条最快:

Terminal window
curl -fsSL https://aerial.qust.me/install.sh | KEEP_ADB=1 TV=192.168.1.20 bash

两个环境变量的含义:

变量作用
TV电视的 IP,换成你自己的
KEEP_ADB=1保持 ADB 常开。小米待机后会关掉 ADB,加上它,Aerial 会负责重新打开,方便以后升级维护

脚本会自动判断电视的 Android 版本:发现是 4.x 会自动装 Lite 版。无线调试的电视先把配对信息 export 出来再跑同一条命令:

Terminal window
export ADB_PAIR=<配对屏 IP:端口> ADB_CODE=<6 位配对码> ADB_CONNECT=<无线调试主页 IP:端口>
curl -fsSL https://aerial.qust.me/install.sh | KEEP_ADB=1 TV=192.168.1.20 bash

部署方式三:手动 ADB(把每一步看清)#

手动方式适合想搞清原理的人。先从官网下载 aerial-standard.apk,然后逐条执行(Windows 用户建议走 Agent 方式,或查阅官网安装说明里的 Windows 步骤):

Terminal window
adb connect 192.168.1.20:5555
adb install -r aerial-standard.apk
adb shell pm grant app.orchard.tv android.permission.WRITE_SECURE_SETTINGS
adb shell cmd notification allow_listener app.orchard.tv/app.orchard.tv.guard.RevivalListener
adb shell appops set app.orchard.tv SYSTEM_ALERT_WINDOW allow
adb shell am start -n app.orchard.tv/.MainActivity
adb shell cmd package compile -m speed -f app.orchard.tv

每条命令在干什么:

命令作用
adb connect连上电视的 ADB
adb install -r安装(-r 表示覆盖安装,升级时设置不丢)
pm grant … WRITE_SECURE_SETTINGS授予写安全设置的权限,守护与亮度等功能要用
cmd notification allow_listener把 Aerial 的 RevivalListener 加入通知监听白名单,启用「复活」通道
appops set … SYSTEM_ALERT_WINDOW allow允许悬浮窗,守护切回前台要用
am start … MainActivity立刻启动 Aerial 主界面
cmd package compile -m speed提前做 AOT 编译,让 Aerial 在电视上更流畅;等界面显示出来 5 秒后再运行,要几十秒;不运行也可以,它会在下次从控制中心升级时补上

装完按主页键:原生 Android TV 一般会弹「使用哪个应用」,选 Aerial 再选「始终」就设好了。国产电视大多不弹、直接回原桌面,这时从「我的应用」打开 Aerial,它会弹出「设为主屏幕」引导你去打开桌面守护(无障碍)和通知使用权;电视设置里找不到这些入口时,Aerial 只能当普通 App 用,要接管主页键还得用上面的命令或 Agent 再设置一次(覆盖安装,不丢设置)。

电视提示不允许安装桌面类 App 时,改用守护版:一行命令最后加 -s guard,或手动下载 aerial-guard.apk 安装。

部署方式四:U 盘安装(不用电脑)#

把 APK 拷进 U 盘,插到电视上用文件管理器打开安装即可,三个版本对应前面的版本表。这条路最省事,但要注意:只装 APK 时,按主页键、开机和待机后大概率还是原桌面——接管所需的授权(无障碍、通知监听)还没设置。1.32 版起「我的应用」里有 Aerial 图标,打开后会提示怎么设为主屏幕;要完整接管,最终还是建议用命令或 Agent 补设置一次。

升级方式#

1.32 版起,有新版本时控制中心会出现「有新版本」,点进去选「下载并安装」,在电视自己的安装界面确认即可(已在小米、TCL 上验证),装完回到 Aerial,设置全部保留。电视不允许 App 内安装应用时,升级就是再运行一次安装命令;升级页上有二维码,手机扫码能直接复制这台电视的专属命令。1.31 及以前的版本没有这个按钮,第一次升级仍要跑一次安装命令,之后就有了。

还原方式#

不想要了,随时能退回去,一行命令:

Terminal window
curl -fsSL https://aerial.qust.me/install.sh | TV=192.168.1.20 bash -s restore

末尾加 --uninstall 会顺便把 Aerial 卸载干净。不能运行 bash 的 Windows 环境,官网安装说明里有逐条对应的 adb 还原命令。同样可以把还原任务交给 Agent,官方也准备了现成的还原指令文本,验收标准是还原后 mCurrentFocus 不再指向 Aerial、无障碍列表里不再有它。

Aerial Lite:给 Android 4.0–4.4 老电视的版本#

老电视、老盒子的界面框架装不了完整版(最低 Android 5.0),所以有单独的 Lite 版,包名 app.orchard.tv.lite,外观和完整版一样。目前是第一版(1.0),属于测试版:只在 Android 4.0.4 / 4.4.4 虚拟机和小米、TCL 的新电视上测过,还没在真实的 4.x 电视上验证过,官方明确说可能有不少小问题。

安装命令和完整版是同一条脚本(识别到 4.x 自动装 Lite),也可以明确指定:

Terminal window
curl -fsSL https://aerial.qust.me/install.sh | TV=192.168.1.20 bash -s lite

手动安装:

Terminal window
adb connect 192.168.1.20:5555
adb install -r aerial-lite.apk
adb shell pm grant app.orchard.tv.lite android.permission.WRITE_SECURE_SETTINGS
# 这条是给调亮度用的;Android 4.0 上会报错,可以忽略
adb shell am start -n app.orchard.tv.lite/.HomeActivity

装好后按主页键,系统问「使用哪个应用」时选 Aerial Lite 并选「始终」。不弹选择、直接回原桌面,说明固件把主页键锁死在自家桌面,Lite 只能从应用列表打开当普通 App 用——小米电视 2、华为盒子都栽在这一关,属于固件层面的无解。

和完整版的区别:没有桌面守护(无障碍接管),开机和主页键全靠系统默认桌面机制;没有航拍壁纸、「我的视频」壁纸和信号源磁贴(4.x 没有电视输入框架,信号源按钮打开的是电视自己的信号源面板);没有应用内升级(升级就是再装一次,设置保留)。航拍屏保、照片与每日一图、时钟、文件夹、长按菜单、控制中心、个性化、手机配置页都有。还原:设置 → 应用 → Aerial Lite → 清除默认设置,再按主页键选回原桌面;或 adb uninstall app.orchard.tv.lite。

源码构建与自部署(开发)#

想自己改、自己编译的人,仓库给的开发环境要求是 JDK 17 与 Android SDK 36,构建命令:

Terminal window
./gradlew assembleStandardRelease assembleGuardRelease

一次打出 standard 与 guard 两个 Release 包。编译完直接部署到电视调试:

Terminal window
BUILD=1 KEEP_ADB=1 TV=<电视IP> tools/install.sh

BUILD=1 表示用本地刚构建的包而不是下载官方 APK,其余参数与正式安装一致。仓库的结构也值得一提:app 是主应用,lite 是 Lite 版,site 是官网与安装脚本(aerial.qust.me 的内容就来自这里,仓库用 Cloudflare 的 wrangler 配置托管),tools 放安装与诊断脚本。深入之前先读两份文档:ARCHITECTURE.md 讲代码结构,HANDOFF.md 讲现状与规则,各机型的实测笔记在 docs/devices/ 目录里。仓库根目录还放了 AGENTS.md 和 CLAUDE.md——这个项目本身就是用编程 Agent 协作开发的,前面「让 Agent 装」的一键指令能成立,靠的也是这套文档化传统。

机型支持概览#

仓库维护了一份很长的实测机型表(大多来自用户反馈),这里按品牌给结论速览,细节以仓库表格为准:

品牌总体情况
小米 / Redmi支持最全:Android 5.1 到 14 大量机型实测可用,老 Android 6 机型 1.43 起支持,个别低内存机型回桌面要等几秒
TCL / 雷鸟多数可用,但固件差异大:部分机型只能 USB 线连 ADB、部分必须用 guard 版;雷鸟个别机型固件每分钟清无障碍,接管不了
索尼国行 BRAVIA 多数可用;个别老机型固件锁主页键,需要 Agent 额外写 filterHomeAlways
创维 / 酷开参半:不少机型开机先出酷开桌面几秒再切回;个别机型黑屏或拿不到焦点,不支持
海信 / Vidda多数可用,部分开机直达;开 ADB 要走工厂菜单,是门槛最高的一家
极米 / 当贝等投影与盒子大多可用;当贝部分固件按主页键会强停第三方 App,Aerial 要 7–12 秒才回来
长虹 / 坚果等有明确不支持案例:不弹 ADB 授权框、没有无障碍入口、固件不让写无障碍设置

明确不支持的平台:LG webOS、三星 Tizen、华为鸿蒙智慧屏,以及 Android 4.0 以前的系统。打不开 ADB 的老乐视、荣耀智慧屏、老康佳(看不到版本号)也基本无解。

装好了但不对劲:适配求助#

按主页键回原桌面、待机后停在原桌面、信号源开错口、亮度条没反应——这类机型适配问题有三条反馈路径:把官网 adapt.md 的指令发给 Agent 让它自检并当场修(比如信号源编号),报告经你确认后再提交;或者在电视上走控制中心 → 个性化 → 扫码,手机页底部「反馈问题」会自动把型号版本填进 GitHub 模板;电脑上也能自己跑两个官方脚本取诊断输出:

Terminal window
curl -fsSL https://aerial.qust.me/tools/report.sh | TV=<电视IP> bash
# 只读诊断
curl -fsSL https://aerial.qust.me/tools/selftest.sh | TV=<电视IP> bash
# 自检:模拟按主页键、打开设置,看 Aerial 能不能自己回来

诊断信息不含账号、IP、Wi-Fi 名称和 App 列表,可以放心贴。

排障#

创维 adb install 报 INSTALL_FAILED_USER_RESTRICTED。 先执行 adb shell settings put global verifier_verify_adb_installs 0 关掉安装校验,再重新安装(用户反馈的解法,官网安装说明有详细版)。

TCL 弹出「多屏互动」。 按遥控器「右」再按确认,选「同意」——这是 TCL 的推送安装通道,guard 版在不少 TCL 机型上正是靠它装进去的。

只用 U 盘装了 APK,按主页键还是原桌面。 正常现象:接管需要的授权还没给。用一行命令或 Agent 补跑一次设置(覆盖安装,不丢设置),或按 Aerial 里「设为主屏幕」的引导去开无障碍与通知使用权。

55V2 Pro 等机型 adb 装不上。 先 adb shell setprop persist.tcl.debug.installapk 1 再装,这是 TCL 部分固件的隐藏开关。

找不到 ADB 开关。 先查仓库 docs/devices/adb-by-brand.md 的分品牌说明;表里没有的机型,大概率藏在工厂菜单或需要遥控器暗号,别在设置里盲翻。

老电视很卡。 1.48 起低内存机型会自动切「流畅」效果;手动路径是 个性化 → 效果 → 流畅。斐讯 T1 这类老盒子切完后网格滚动会顺很多。

原来的桌面和内容还在吗。 都在。Aerial 只换桌面:原桌面在 App 列表里(小米影视、PatchWall 从「桌面」磁贴进),小爱同学、小米账号、有线电视照常使用。唯一去不掉的是开机广告——那是固件播的,和桌面无关,任何桌面都解决不了。这一点和 自建服务入门里讲的「先分清问题在哪一层」是同一个道理。

许可与数据来源#

项目本体是 MIT 许可证,可以自由使用和修改。几个组成部分的出处也交代得很清楚:界面字体 Inter 走 SIL 开放字体许可;系统 App 图标用的是 Material Symbols(Apache 2.0);图标库里的磁贴图归各自作者(le5inioo 那套是 MIT,tvOS 版图标与当贝的图归各 App 与当贝,手机页上每张都注明来源);天气用的国内城市表来自 GeoNames(CC BY 4.0),天气数据来自 Open-Meteo。航拍影片的版权归 Apple、由 Apple 服务器直接播放,必应每日精选来自必应——Aerial 与 Apple、小米、TCL 等公司无关,是独立的开源项目。这种把出处逐项列明的习惯,和它严格的机型实测表是同一种气质:可信是攒出来的。

小结#

Aerial 是那种目标单一但完成度极高的开源项目:一块干净的电视桌面。它把 tvOS 的界面语言搬进国产电视,用无障碍守护加通知复活的组合拳解决了「固件只认自家桌面」这个真正的难题,再用手机整理页、图标库和 114 段航拍屏保把体验补完整。部署上有四条路:怕命令的交给 Agent,有终端的一行命令,想看清每一步的手动 ADB,只有 U 盘的也能先装起来。装之前查一眼机型表、开 ADB 时对照分品牌说明、工厂菜单只动那一个开关,这三件事做到,基本一次成功。家里有台被广告桌面折磨的国产电视,值得一试。

Aerial 超详细拆箱:给国产电视换一块没有广告的 tvOS 风桌面(附全部安装命令)
https://www.anexns.cloudns.org/posts/selfhost-aerial-tv/
作者
Anexns
发布于
2026-11-16
许可协议
CC BY-NC-SA 4.0