Skip to content
Mangi-11Public

About

System-level Android AI Agent with direct OS access. | Android 系统级 AI Agent——越过沙盒,让模型访问底层API、屏幕、终端与你的数据

Topics

Resources

Stars

3.0k stars

Watchers

15 watching

Forks

Repository files navigation

Eta

简体中文 | English

GitHub Stars GitHub Releases 累计下载量 minSdk 34 Deep integrations for ColorOS and HyperOS GPL-3.0 License

Eta · Trendshift Kotlin 日榜

大模型时代的 Android 系统级 AI 助手与移动设备 Agent。

Eta 是面向手机与移动设备设计的 AI Agent,结合了 Codex 这类 Coding Agent 的自主规划与执行能力,以及豆包手机助手的跨应用 GUI 操作体验。

Eta 对标手机厂商预装的一方系统助手,围绕 Android 系统服务、厂商 ROM 与个人数据做了深度适配,目标是做出大模型时代真正的 AI 手机体验:

  • 全方位的手机个人上下文:直连系统与厂商底层数据及小布记忆(含一键闪记或收藏的小红书、抖音、B站图文与视频摘要),按需检索通知、短信验证码、通话、相册(文字与画面搜图)、录音摘要、便签、健康、剪贴板、聊天图片,以及账单收支、行程与外卖快递订单等等。
  • 系统与一方应用原生操作:直接调用 Android API 与一方应用原生接口读写日历日程、管理闹钟与计时器、操作便签并控制各类系统开关;跨应用任务可在后台受信任虚拟屏静默执行。
  • 原生数字助理与系统入口:将系统默认数字助理切换为 Eta 后,长按电源键即可带屏直唤(早期曾通过 Xposed 接管小布助手与超级小爱,现已演进为原生数字助理),支持 Android 16+ 实时活动(Live Updates / 流体云),并在适配 ROM 上支持电源键路由(唤起 Eta 或 Gemini)与解锁 Google 一圈即搜。
  • 完整的 Agent Runtime 与扩展:独立实现 Agent Runtime 与 Agent Loop,内置并发 Subagent、定时任务、移动端 PTY 终端与 Linux、AI 生图、长期记忆、Skills、MCP 与酒馆角色陪伴。

支持自备 API Key(BYOK) 及 Codex(ChatGPT)/ Grok 订阅登录,模型由你自由选择。支持 Android 14+ 设备,不限品牌,基础功能免 Root;Root 与 LSPosed 可进一步解锁后台虚拟屏、深层个人上下文与系统入口增强。

下载 APK · 使用场景 · 核心能力 · 权限分层 · 快速开始 · 为什么做 Eta

你可以直接对 Eta 说

  • 电源键看屏问答与当前页代办 — 长按电源键直接针对当前屏幕提问,或让 Eta 原地帮你填表单信息、写外卖好评并提交等。
  • 真机玩机与模块制作 — “检查我这台手机当前的系统环境和配置,帮我写一个 Magisk 模块,打包好直接刷入。”
  • 手机疑难杂症与排错分析 — 遇到异常耗电、通知不响、权限冲突或 App 闪退等手机疑难杂症,直接让 Eta 查系统状态、抓最近的 logcat 日志或分析安装包,快速定位并处理。
  • 手机上自由 Vibe Coding — 随时随地在完整 Linux 环境与 Android 自身 Root Shell 里写代码、建项目、拉仓库、跑测试,或在触控 PTY 终端里直接运行 Claude Code、Codex;开发 Android 应用或系统模块时,还能直接查看真机状态、系统底层并反编译系统组件,贴着真实环境开发调试。
  • 打通小布记忆与个人数据 — “翻一下我小布记忆里一键闪记或收藏的小红书攻略、抖音视频摘要、账单和机票订单,整理成下周出行计划写进日历,再定好出发当天的闹钟。”
  • 后台静默跨应用办事 — 在新装或不常用的 App 里省去翻菜单的麻烦——例如“去机票软件里帮我找到换座位并选个靠窗位置,我在看视频别打扰我,到确认页再交给我”。
  • 定时值守与多路调研 — “每天早上 8 点整理昨天的通知和今日日程,有重要变化再提醒我;或者同时开几个 Subagent 并行调研资料。”
  • 情感陪伴与角色互动 — 创建专属角色或导入酒馆(SillyTavern)角色卡,在世界书与独立剧情记忆中日常陪伴;结合手机里全方位的个人上下文,角色更懂你的日常,也能直接帮你查日程、定闹钟、操作手机。

界面预览

原生电源键全局唤醒 后台虚拟屏运行 虚拟屏实时预览与接管
原生电源键全局唤醒 后台虚拟屏运行 虚拟屏实时预览与接管
全方位个人上下文 手机端 Vibe Coding 触控 PTY 终端
全方位个人上下文 手机端 Vibe Coding 触控 PTY 终端
设置 接管小布(历史演示) 角色与情感陪伴
设置 接管小布(历史演示) 角色与情感陪伴

核心能力

系统级助手与个人生态

  • 全方位个人上下文:按需检索通知历史、日历、位置、短信验证码、通话与通讯录、相册(文字 OCR 与画面搜图)、录音、剪贴板、健康汇总与聊天图片;ColorOS 上更直接打通小布记忆与 ColorOS 聚合搜索服务(DMP),将平时一键闪记或收藏的小红书 / 抖音 / B站图文与视频摘要、随口记灵感、记忆合集、账单、行程、外卖快递、便签、录音摘要及收藏地点,全部开放给你自选的大模型调用。
  • 系统与一方原生操作:直接调用 Android 与一方应用原生接口读写日历、管理闹钟与计时器、操作便签,并控制亮度、音量、勿扰、手电筒、Wi-Fi、蓝牙、热点、NFC、应用冻结等系统能力。
  • 原生数字助理与系统入口:设为系统默认数字助理即可长按电源键带屏直唤(早期曾通过 Xposed 接管小布与超级小爱,现已演进为原生方案);支持 Android 16+ 实时活动(Live Updates / 流体云 / 超级岛)、聊天长按语音输入(千问 / 豆包 / MiMo / DeepSeek)与多引擎播报;适配 ROM 支持长按电源键路由(唤起 Eta、Gemini 或系统默认助手,并自动校正默认助理)与解锁 Google 一圈即搜(手势条长按 / 双指识屏)。
  • GUI 与后台虚拟屏:结合无障碍与原图视觉跨应用操作;支持主屏原地接管,具备 Root 或 LSPosed 时跨应用任务默认在后台受信任虚拟屏静默运行,顶部胶囊内置实时微缩预览与随时接管,到达收银台或二维码页时一键移交主屏。

自主编排与移动工具箱

  • 并发 Subagent:在独立上下文中同时运行多个子任务(内置 explore、coder、plan 及自定义模板),可单独配置轻量副模型并在聊天中实时查看步骤。
  • 定时任务:支持单次、周期与 Cron 后台自动运行,支持仅在有变化时提醒或静默归档,对话中即可让 Eta 创建与管理。
  • 移动端终端、Linux 与 Vibe Coding:具备与桌面端 Coding Agent 同样完整的读写文件、代码编辑、搜索与命令执行能力,搭配 Alpine / Debian 完整 Linux 环境(免 Root PRoot / Root chroot),可在手机上自由写代码、做项目;同时提供为移动触控设备独立重新设计实现的 PTY 控制台,可直接运行 Claude Code、Codex 等 TUI,并支持后台常驻任务与文件管理。
  • 网页浏览与 AI 生图:提供网页搜索与可随时接管的内置浏览器;原生接入 Gemini、OpenAI、xAI、豆包、通义千问、硅基流动六大渠道文生图与图生图,聊天内直接出图并归档画廊。

模型、扩展与交互体验

  • 模型生态:支持 OpenAI(Chat Completions / Responses)、Anthropic、Gemini(含 Google Cloud Vertex AI)协议;内置 12 家主流服务商,支持自定义服务、models.dev 目录导入及 Codex(ChatGPT)/ Grok 订阅登录。
  • 情感陪伴与酒馆生态:支持创建角色并兼容酒馆(SillyTavern)生态,支持 PNG / JSON 角色卡导入导出、用户人设、内嵌世界书、独立剧情记忆与回复原位编辑重生成;角色会话同样可结合手机个人上下文并调用工具,兼顾情感陪伴与实际办事。
  • 记忆与扩展:支持 MEMORY.md 长期记忆、GitHub / ZIP 安装 Skills 与 Streamable HTTP MCP 远程工具。
  • 日常体验:支持运行中排队与实时插话(Steer)、对话分支、原生 LaTeX 数学公式渲染、Miuix / COUI 双原生界面风格与简/繁/英三语界面。

Eta 的定位

目前的手机端 AI 工具大致走向两个方向:

  • 手机厂商预装的系统助手拥有电源键入口、一方接口与私有数据生态,但模型和扩展能力相对封闭,通常绑定自家模型与预设场景。
  • 常见第三方移动 Agent在模型自由度、Linux 沙盒、Skills 与标准系统权限上已经很成熟,但大多停留在通用接口与独立 App 形态,较少深入 Android 系统底层、厂商 ROM 生态与系统级入口。

Eta 试图把这两边打通:一方面保留自由模型与完整 Agent 能力(并发 Subagent、定时任务、触控 PTY 终端与 Linux、AI 生图、Skills、MCP 与酒馆陪伴);另一方面围绕 Android 系统服务、一方应用与厂商 ROM 做深度适配,将原生数字助理入口、后台受信任虚拟屏、全方位个人上下文与 Root 级真机控制真正接进同一个 Runtime。

想了解项目背后的思考、手机 AI 生态边界与长期愿景,欢迎阅读:《为什么做 Eta》。

权限与设备支持

  • 普通设备(免 Root):完整对话与模型、情感陪伴与酒馆角色卡、AI 生图、Subagent、定时任务、记忆 / Skills / MCP、网页与浏览器、普通终端与 PRoot Linux、日历 / 通知 / 位置 / 应用使用统计、主屏 GUI Agent、Eta 原生数字助理。
  • Root 设备:后台虚拟屏、系统开关与一方应用原生操作(闹钟管理 / 便签等)、应用管理、深层个人上下文(短信 / 通话 / 相册搜图 / 健康 / 聊天图片等)、Root Shell & chroot。
  • LSPosed + 适配 ROM:后台虚拟屏、ColorOS / HyperOS 电源键路由(唤起 Eta 或 Gemini)、小布记忆直连查询、解锁 Google 一圈即搜(手势条长按 / 双指识屏)。

完整权限与机型说明见 设备支持与权限边界。

快速开始

  1. 从 Releases 下载安装 APK,在「模型提供商」配置 API Key(或登录 Codex / Grok 订阅)并添加模型。
  2. 打开「权限健康」页面按需授予系统与工具权限,并在系统中为 Eta 开启自启动与后台锁定。
  3. (可选)进入「Linux 工具环境」安装发行版与常用工具。
  4. (可选,Root / LSPosed 设备)授予 Eta Root 权限,并在 LSPosed 管理器中激活 Eta 模块、勾选对应作用域后重启手机。

隐私提示:任务所需的上下文、图片与工具结果会发送至你配置的模型服务;敏感工具与 MCP 的原始结果不会写入本地聊天记录,并支持对话导出与整库备份迁移。

更多文档

关于 PR 与贡献

本项目已关闭外部 PR,只接受协作者提交。

AI 时代下,处理外部 PR 变得比以往更加困难:大量由 AI 生成的 PR 中,模型能力与提交者水平参差不齐,容易混入不少 AI slop。加上处理流程繁琐,不仅要来回沟通、对齐项目架构,还要自己 Review 代码、跑测试验证——实在太累了,成本远高于拿到 Issue 后直接在内部用 AI 实现,还不如自己写。

新功能需求、问题反馈或功能贡献,欢迎直接在 Issues 及评论区提交你的思路或 Prompt,方便 AI 直接读取上下文完成实现。谢谢大家的理解与支持!

Star History

Eta Star History

参考与致谢

  • Pi Coding Agent:Eta Agent Runtime 的核心参考,包括 Agent Loop、Tool Calling、steering 与 transcript 状态管理。
  • OmniBot:Android AI Agent 方向的参考项目。
  • libxposed API:现代 Xposed API。
  • Miuix 与 COUI:UI 组件库。

许可证

Copyright © 2026 蛮吉 (Mangi-11)

本项目基于 GPL-3.0 开源,详情请参阅 LICENSE。

社区:LINUX DO

About

System-level Android AI Agent with direct OS access. | Android 系统级 AI Agent——越过沙盒,让模型访问底层API、屏幕、终端与你的数据

Topics

Resources

Stars

3.0k stars

Watchers

15 watching

Forks

Releases

Contributors

Languages