常见问题（FAQ）

我的电视能用吗？

见「支持的机型」一节。不确定就用机型适配模板反馈（控制中心 → 个性化 → 扫二维码 → 手机页最下面「反馈问题 → 去 GitHub 反馈」）。

只用 U 盘装了 APK，为什么按主页键没反应？

1.32 起「我的应用」里有 Aerial 的图标，打开后会提示怎么设为主屏幕。只装 APK 时按主页键、开机和待机后还是原桌面，要用「五种安装方式」一节的命令或 Agent 再设置一次（会覆盖安装，不丢设置）。

装好了，但有地方不对？

按主页键回到原桌面、待机或开机后停在原桌面、信号源打开的口不对、亮度条没反应。选一种方式：

1. 交给 Agent（最省事）：发给能在电脑上运行命令的 Agent，它会自检并整理成报告，你看过再提交：

请按 https://aerial.qust.me/adapt.md 给我的电视做 Aerial 适配。
电视 IP：<电视IP>
哪里不对：<比如：按主页键回到原桌面 / HDMI 2 打开的是 HDMI 1 / 待机后停在原桌面>

请先完整读完说明再动手，在我的电脑上亲自运行命令，不要只把步骤告诉我。
待机测试、重启电视之前先问我；不要卸载或停用任何系统应用。
最后把整理好的报告给我看，我同意后再提交到 GitHub。

2. 用手机提交：控制中心 → 个性化，扫二维码，手机页最下面「反馈问题 → 显示诊断信息 → 去 GitHub 反馈」。型号和版本会自动填进机型适配模板，诊断信息自动复制，粘贴进去就行。

能不能从网页直接安装？

不能。浏览器无法访问电视的 ADB。建议使用 Agent 提示词或一行命令。

会弄坏电视吗？怎么撤销？

不会。Aerial 不修改系统应用。撤销方法：把提示词粘贴给 AI 执行「Undo」操作，或运行：

curl -fsSL https://aerial.qust.me/install.sh | TV=<电视IP> bash -s restore

加 --uninstall 可完全卸载。

固件禁止安装主页应用？

安装不声明为主页的构建版本：添加 -s guard 参数，或下载 aerial-guard.apk 手动安装。

订阅 / 小爱同学 / 有线电视受影响吗？

不受影响。Aerial 只替换主页界面，所有原有服务、账号、订阅均正常工作。旧主页仍可从应用列表进入。

小米视频 / PatchWall 内容去哪了？

主页的「桌面」磁贴会打开 PatchWall，保留其推荐和订阅内容。开机广告来自固件，Aerial 无法移除。

Agent 说装好了但没变化？

要求 Agent 提供「Check」部分的原始输出，特别是 dumpsys window | grep mCurrentFocus，确认焦点是否指向 Aerial（app.orchard.tv）。

能用手机安装吗？

可以。有用户用「甲壳虫 ADB 助手」「超级小爱」成功安装，但官方未测试所有工具，建议电脑操作更可靠。

如何更新？

1.32 版本后，控制中心会显示「有新版本」。否则重新运行安装命令（设置、布局、壁纸会保留）。

使用什么权限？

• WRITE_SECURE_SETTINGS（保活 Home Guard）
• 通知监听（仅重启 Aerial，不读取内容）
• 无障碍（仅检测前台窗口，不读屏幕内容）
• 位置（仅显示 Wi-Fi 名称）

空中电影数据来源？

直接从 Apple 服务器流媒体播放，1080p，约 15–20 Mbps。加载失败时自动切换为照片息屏。

KEEP_ADB=1 是什么？

小米待机后会关掉 ADB，加上它 Aerial 会重新打开，方便以后升级。

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