Mangi-11/Eta

Eta – Android 级别的 AI 助手

它是什么

• Eta 是一款 Android 应用，可将手机变为系统级 AI 代理。您配置的大语言模型（LLM）（如 OpenAI、Anthropic、Kimi 等）可以发出工具调用，与设备进行交互：设置闹钟、控制媒体、读取通知、运行 shell 命令、编辑文件，甚至通过无障碍服务操作其他应用（“GUI 代理”）。
• 核心是代理运行时：循环运行——模型接收用户提示，决定调用哪个工具，应用执行该工具，将结果反馈给模型，然后重复，直到任务完成。

主要功能

类别	Eta 能做什么
系统 API	直接调用 Android API：闹钟、音量、媒体、应用信息、权限、日志（仅限 root）。
GUI 代理	使用无障碍树定位 UI 元素，点击、滚动、输入、拍摄全分辨率截图。
终端	提供类 Linux shell（通过 PRoot/chroot 提供 Alpine 或 Debian）。模型可运行 terminal、terminal_job、terminal_daemon 命令，查看输出，并保持后台任务。
文件工具	读写文件、搜索、编辑（带大小限制）、查看元数据，并将 Android 目录暴露为 /workspace/mounts/。
浏览器	内置 WebView，可加载页面、读取文本、操作 DOM 并捕获截图。
个人上下文	获取最近的未读通知、应用使用情况、联系人、日历、照片、短信、健康数据（部分需要 root 或 OEM 支持）。
记忆	本地 MEMORY.md 文件存储长期对话上下文；应用可编辑、清除或禁用。
技能和 MCP	从 GitHub 或 ZIP 文件安装可重用的“技能”包；通过 HTTP 和 Bearer 令牌（MCP）连接远程工具。
角色	加载角色卡（PNG/JSON）为助手赋予人格；角色特定的记忆与正常聊天分开存储。

工作原理

1. 模型选择 – 在设置中添加提供商（OpenAI、Anthropic 等）并提供 API 密钥（BYOK）。应用支持许多提供商，并允许添加自定义的 OpenAI 兼容端点。
2. 工具调用 – LLM 接收每个工具的模式（例如 set_alarm(time)、read_file(path)）。当它决定需要某个工具时，Eta 会调用相应的 Android 或 Linux 实现，检查权限，执行操作，并返回结构化结果。
3. 运行时循环 – 代理运行时管理流式响应、转向、取消和增量转录。所有操作都在本地记录；除非您导出对话，否则不会持久化敏感的工具参数。
4. 入口点 – 可通过长按电源键启动，或通过劫持 OEM 助手（“小布”/“超级小爱”的 Xposed 模块）启动。深度系统集成需要 LSPosed。

安装与使用

• 从 Releases 页面下载 APK，在 Android 13+ 上安装。
• 配置模型提供商，并启用您需要的工具（GUI 的无障碍服务、通知权限、位置等）。
• 开始聊天，输入或说出请求（例如“安排明天会议，并将议程发送给我的联系人”）。Eta 会调用适当的工具，在状态胶囊中显示进度，并返回最终答案。

目标用户

• 希望在手机上拥有可编程、跨应用助手的超级用户。
• 希望无需 root 即可尝试 Android 上 LLM 驱动的自动化的开发者（root 可提供额外功能）。
• 愿意为自己的语言模型提供 API 密钥的人。

限制

• AI 部分在外部服务上运行；Eta 不内置本地模型。
• 某些个人数据（短信、日历、健康）需要 root 或 OEM 特定的钩子。
• Xposed/LSPosed 集成是可选的；没有它，您将失去系统助手的入口点。
• 许可证为非商业用途，未经作者许可不得出售或重新分发本应用。

为什么重要 Eta 弥补了桌面级编码代理（拥有完整文件系统和 shell 访问权限）与通常仅限于简单问答的移动助手之间的差距。通过向 LLM 暴露 Android API 和 Linux 终端，它能在手机上实现真正的代理式工作流——例如自动从多个应用收集数据、用脚本处理数据、并根据结果采取行动，整个过程由自然语言提示驱动。

---

以上信息全部直接来自仓库的 README。