Zhou-Shilin/Aether · 上手攻略
- 仓库：Zhou-Shilin/Aether
- 链接：https://github.com/Zhou-Shilin/Aether
- 分类：AI Agent · 移动端 · 本地化
- 作者：Tom
- 更新：2026-08-27
是什么
Aether 是一款专注于移动端本地运行的通用 AI Agent 应用，支持 Android、iOS 和 macOS。开发者是 15 岁学生（baimoqilin），项目基于 Pi framework 构建，定位是"让移动设备也能拥有现代化、可扩展的本地 AI Agent 体验"。
核心特点：完全本地化运行（LLM 调用走 API 但 Agent 逻辑在设备上）、插件生态（标准 Pi Extensions 格式 + Aether 自有 Script Extensions）、 Alpine Linux 内嵌 VM（开箱即用跑 Shell 命令）、以及极重视 UI 打磨（自称设计对标 ChatGPT/Gemini/Codex CLI）。
解决什么问题
- 移动端缺好用的 Agent UI：大多数 AI Agent 工具是桌面端的，移动上体验很差。Aether 把完整 Agent 能力搬到手机。
- 本地化隐私：对话和 Agent 状态在本地，不经过第三方服务器中转（API Key 持有者当然还是需要把请求发到 LLM 提供商，但 Agent 执行逻辑在本地）。
- 扩展性：Pi 生态的 Extension 可以直接装进来，Aether 还提供了自己的 Script Extensions 和 Native Mods 系统。
- Shell 工具集成：内置 Alpine VM，无需 Termux 也能跑命令行工具；Android 还支持 Shizuku/Termux 集成做更深层设备控制。
快速安装
Android
- 前往 GitHub Releases 下载最新 arm64-v8a APK（要求 Android 8.0+）。
- 开启「安装未知来源应用」权限。
- 打开 APK 安装。
iOS / macOS
- 从 App Store 安装 TestFlight。
- 通过 TestFlight 邀请链接 加入 beta。
- 在 TestFlight 内安装。
⚠️ 注意：macOS 桌面版也在 TestFlight 阶段，App Store 正式版「即将推出」。
核心用法
1. 首次配置 LLM Provider
- 打开 Aether → 打开侧边栏 → Settings → Model Providers
- 点击 Add Provider，选择服务（OpenAI / Anthropic / Google / DeepSeek / Groq / Mistral / Cloudflare 等）
- 填入 API Key 或配置 OAuth
- 获取并启用想要的模型，保存
2. Agent Mode（Android 特有）
在作曲框菜单（指针图标）里切换 Agent Mode：
- Agent Mode 开启后，Aether 可以在独立的虚拟 Android Display 上控制 App
- Shell 命令、Skills、MCP servers、多步工具调用均可用
- 不开启 Agent Mode 时也能对话和调用工具，但无法操作设备上的 App
⚠️ Alpine VM：Alpine Linux 根文件系统随 Aether 打包，首次启用时直接解压，不是下载的。
3. 安装扩展（Extensions）
Extensions 有两种安装方式：
方式一：内置扩展 - Pi Web Access：20+ 搜索引擎、GitHub 克隆、YouTube 理解、PDF 提取 - Pi MCP Adapter：MCP gateway，支持 Stdio/Streamable HTTP/SSE/Unix socket - Pi Subagents：Claude Code 风格子 Agent，并行后台执行
方式二：第三方扩展
在 Settings → Extensions → Import extension 直接导入 zip 包。开发者文档在 aether.baimoqilin.com/docs。
4. MCP 服务器（高级）
Aether 通过 Pi MCP Adapter 支持 MCP 协议连接外部工具服务器。可用模式：
| 传输模式 | 说明 |
|---|---|
| Stdio | 本地进程通信 |
| Streamable HTTP | HTTP 长连接 |
| SSE | Server-Sent Events |
| Unix Domain Socket | 本地高效通信 |
MCP Adapter 支持 lazy loading（省 token）和交互式 OAuth 认证，有可视化服务器管理 GUI。
5. Subagents（子 Agent）
Pi Subagents 扩展提供 Claude Code 风格的多 Agent 能力：
- 并行后台执行
- 运行中可接管方向（mid-run steering）
- 实时 Widget + FleetView 卡片
- 对话覆盖查看器
- @handle 提及其他 Agent
最小可跑命令（环境校验）
# Android APK 方式：校验安装
# 1. 确认 arm64-v8a 架构（大多数现代 Android 手机）
adb shell getprop ro.product.cpu.abi # 确认包含 arm64-v8a
# 2. 确认 Android 版本 >= 8.0
adb shell getprop ro.build.version.release # 确认 >= 27
# 3. 下载 APK（假设已拿到链接，假设是 2026 年某 release）
# wget https://github.com/Zhou-Shilin/Aether/releases/download/vX.Y.Z/Aether-arm64-v8a.apk
# 4. 本地安装并启动后验证（无命令行方式，需通过 UI 操作）
# 正常启动后 Settings → Model Providers 应可配置
# iOS/TestFlight 方式：校验安装
# 1. 确认 TestFlight 安装成功（无需命令行操作）
# 2. 加入 beta 后 TestFlight 内点击安装即完成
典型适用场景
| 场景 | 为什么用 Aether |
|---|---|
| 移动端 AI 对话 | 完整 Agent 能力在手机上，不是简陋的 chatbot |
| 研究/信息搜集 | Pi Web Access 扩展集成 20+ 搜索，YouTube/PDF 理解 |
| 设备自动化 | Android Agent Mode + Shizuku 可操作 App、做截图等 |
| MCP 工具调用 | Pi MCP Adapter 提供统一 MCP gateway，连外部数据源 |
| 子 Agent 协作 | Pi Subagents 支持并行多 Agent，适合复杂任务拆解 |
| 本地优先 | Agent 逻辑本地，状态不依赖云端（API 请求本身还是要走网络） |
坑与注意
- API Key 自持：LLM 调用仍然需要有效的 API Key，设备没有 GPU 加速，靠云端 LLM。
- TestFlight 限制：iOS beta 有名额和时效限制，不是永久可用的正式版。
- Android APK 安装门槛：需要手动开启未知来源安装权限，对普通用户有摩擦。
- Subagents 并行调度有条件：mid-run steering 和实时卡片功能依赖扩展正确安装。
- Shizuku/Termux 集成仅 Android：iOS/macOS 无设备层自动化能力。
- 活跃开发中：作者是个人，项目迭代快但不保证稳定性，生产环境使用需评估。
- 文档在国内访问性：文档站
aether.baimoqilin.com在部分地区可能需考虑访问性。
与同类对比
| 项目 | 定位 | 与 Aether 的核心区别 |
|---|---|---|
| Pi（上游框架） | Agent 核心引擎 | 无 UI，命令行/库级别 |
| ChatGPT App | 对话 UI | 非本地 Agent，无插件生态 |
| Claude App | 对话 UI | 非本地 Agent，无插件生态 |
| Coze AI | Bot 构建平台 | 云端，非本地运行 |
| AstroPython/macOS Shortcuts | 本地自动化 | 非 AI Native，无 LLM 工具调用 |
| Open Interpreter | 本地代码执行 Agent | 桌面端为主，非移动优先 |
一句话：Aether 是目前少数真正把"本地 Agent"这件事做进移动端 UI 的开源项目，Pi 生态加持下扩展性有保证，但稳定性仍需自测。
一句话推荐结论
Aether = 移动端本地 AI Agent 的完整解决方案，UI 打磨出色、Pi 插件生态可扩展，适合在手机上做 AI 研究、信息搜集和轻量设备自动化的用户；正式项目使用前建议先在测试环境验证稳定性。
⚠️ 数字核验说明：Android 要求 arm64-v8a + Android 8.0+（文档自称）；iOS TestFlight 邀请链接
FaZeS81F取自官方文档；Pi Extensions 数量和功能描述基于 GitHub 文档，未做独立安装验证。