五种安装方式

Aerial 提供五种安装方式，按推荐程度排序：让 AI Agent 自动装（最省事）、一行命令（macOS/Linux）、手动 ADB、仅手机、U 盘。任选一种，装完都要做「验收」。

方式 1：让 AI Agent 装（推荐）

把下面这段提示词发给能在电脑上运行命令的 Agent（WorkBuddy、豆包电脑版、千问电脑版、Trae、Claude Code、Codex 等）：

请帮我把开源电视桌面 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"

注意：手机上的豆包、网页版聊天只会把步骤告诉你，不会执行；要用能跑命令的电脑版 / 工作版（豆包电脑版或豆包工作版、WorkBuddy、千问电脑版、Trae、Claude Code、Codex 等）。Agent 说装好了，看它贴出的 mCurrentFocus 输出里有没有 app.orchard.tv。

方式 2：一行命令（macOS / Linux）

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

把 192.168.1.20 换成你电视的 IP。只有无线调试的电视先配好 ADB_PAIR、ADB_CODE、ADB_CONNECT 三个变量再跑；没有配对码入口的（TCL Q10M、Q10L、鹤 6 Ultra 等）先按分品牌说明用数据线连一次、运行 adb tcpip 5555，之后照常跑。

方式 3：手动 ADB 安装

下载 aerial-standard.apk，然后：

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

最后一条让 Aerial 在电视上更流畅：等 Aerial 显示出来、过 5 秒再运行，要几十秒。不运行的话，Aerial 要等到下次从控制中心升级时才会编译。Windows 用户建议用 Agent 装，或照安装说明里的 Windows 步骤。

方式 4：仅手机

有用户用手机上的「甲壳虫 ADB 助手」「超级小爱」装成功过。步骤：手机连同一 Wi-Fi → 连到 <电视IP>:5555 → 电视上选「始终允许」→ 在工具里安装 APK、授予权限。本仓库没有逐一实测，装好后建议再用电脑跑一遍验收。

方式 5：U 盘（不用电脑）

下载 APK 拷进 U 盘，用电视的文件管理器打开安装：

装好后：激活主页

装好 Aerial 后按遥控器的主页键：

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

升级

1.32 起，有新版本时控制中心会出现「有新版本」，点进去选「下载并安装」，在电视自己的安装界面确认（小米、TCL 上验证过），装完回到 Aerial，设置都保留。电视不让 App 安装应用时，升级就是再运行一次安装命令：升级页上有二维码，手机扫码能直接复制这台电视的命令，或者交给 Agent。1.31 及以前没有这个按钮，还是要再运行一次安装命令。

还原（完全卸载）

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

最后加 --uninstall（bash -s restore --uninstall）会顺便卸载 Aerial。不能运行 bash（Windows）时，逐条的 adb 命令见安装说明的「还原」。想交给 AI 还原：把 agent.md 里「还原」一节的提示词发给 Agent，让它亲自在电脑上跑命令。

内容来源：Aerial 官方 GitHub 仓库 README 与官网 https://aerial.qust.me/