搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

kuafuai/andee

AI 工程

一个住进 Android 手机或 Mac 的本地智能体,借助无障碍服务像用户一样操作任意 App,无需集成或 Root。

6,150
291
Kotlin
NOASSERTION
创建于 2 个月前

项目介绍

Andee 是一个常驻 Android 手机/平板或 Mac 的个人智能体,用类似用户的方式操作其他 App。Android 端通过无障碍服务读取界面元素或截图,完成点击、滑动、输入和通知归类;Mac 端增加任意 App 的无障碍树、真实鼠标键盘事件、屏幕捕获和受沙箱约束的终端。智能体循环、提示词、笔记本格式、场景和安全规则都放在共享的 core/ 模块里,手机和桌面各自实现一个 BrainHost 接口。它面向希望跨任意 App 工作、不想做 SDK 对接或 Root 的用户。

模型后端可以用任意 OpenAI 兼容接口,设备记忆和密码库被描述为只留在本地。它还支持两台设备扫码配对,让一台把任务委托给另一台。首次使用方面,README 推荐通过 CodeFlying 这个独立商业服务一键构建预配置模型与语音密钥的安装包,新账户有一定免费额度,之后需要购买;也可以使用发布包并自备密钥,或从源码构建。

快速使用

按安装说明,Android 最短路径如下:

  1. 打开 CodeFlying 构建页,点击构建并扫码下载安装包(在线构建)。
  2. 安装 APK。
  3. 授予“显示在其他应用上层”权限,然后启用 Andee 的无障碍服务,悬浮球随之出现。
  4. 点击悬浮球并允许麦克风提示,即可对话。

如果从 GitHub 下载发布包,可安装 andee-<version>-en-android-arm64-v8a.apk,然后在 ⚙ → Backend 填入自己的 CodeFlying 密钥或 OpenAI 兼容模型密钥,或切换到 On-device 模式(最新发布)。

在 Android 上从源码构建需要 JDK 17–20、Gradle 8.4、Android SDK Platform 34、Build-Tools 34,以及包含 sdk.dir= 的 local.properties;然后执行 ./gradlew assembleDebug,再用 adb install -r app/build/outputs/apk/debug/app-arm64-v8a-debug.apk 安装(构建步骤)。Mac 桌面版执行 ./gradlew :desktop:createDistributable,把生成的 Andee.app 复制到 Applications,macOS 会请求辅助功能和屏幕录制权限。

权限与平台要求

Android 8.1(API 27)即可安装和聊天,但读屏、可视化点击目标和截图需要 Android 11(API 30)或更新版本。Mac 版要求 macOS 14 以上,且构建产物与架构绑定:Apple 芯片的包不能在 Intel Mac 上启动,反之亦然。

它申请的权限组合并不常见,README 也直言这一点:悬浮窗、无障碍、通知访问、短信、通话记录、联系人和已安装应用列表按需在每次敏感操作前申请,被拒时降级返回,但部分能力是全部或全无。屏幕操作完全依赖无障碍服务,在未 Root 的设备上这是真实触摸事件的唯一途径。ASR 和 TTS 走公网,唤醒词完全离线。

已知限制

  • 机器狗 USB dongle 的固件和接线图不在仓库里;如果 dongle 在运动中断电,手机无法发送停止指令,狗会完成最后一个动作,因为狗端固件没有断联停止行为。
  • 调试用 WebSocket 服务当前绑定 0.0.0.0:9008 且不认证客户端,在不完全可控的网络上需要注意(SECURITY.md)。
  • Mac 版每次未签名重新构建都会丢失辅助功能和屏幕录制授权;仓库提供了固定本地签名身份的说明(签名说明)。
  • 项目仍处于 pre-1.0(v0.15.0)。许可证是 Apache-2.0 附加条件:不允许多租户 SaaS、不允许去除品牌的贴牌、未经书面许可不得嵌入其他产品(许可证)。捆绑的 ML Kit 和 play-services-* 组件并非开源。

HotRepo 点评

HotRepo 目前没有该仓库的日榜名次、快照或讨论记录,因此 6,150 Star、291 Fork 只能视为当前总数,不能当作趋势。材料中最有辨识度的是工程取舍:Android 端不用 Compose,界面完全基于 WindowManager 和 AccessibilityService;共享的 core/ 同时服务手机和 Mac;安全边界放在调度器而非提示词里。这也正是需要谨慎看待它的原因——一个申请无障碍、短信和联系人权限的智能体,在清单层面与恶意软件难以区分,项目自己也承认这点。读者真正要做的信任判断落在可安装的 APK 和 DMG 上,能核查的是公开源码和权限文档。

进一步阅读

README 详细描述了调用架构、通知归类、场景、本地笔记本和好友配对(项目 README),另有中文权限说明页(权限说明)。

本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。

相关推荐

  1. phone-harness/mcp这是一个托管 MCP 服务,让 AI 智能体在云端操控真实 iPhone 和 Android 模拟器。Python812
  2. kilolonion/agent-vscreen给 Android AI Agent 一块隐形副屏,让它在后台操作 App,你继续用自己的屏幕。Kotlin117
  3. droidrun/mobilerun用自然语言驱动真实 Android 和 iOS 设备的 LLM 无关框架,可通过 CLI 或 Python API 完成点击、滑动、输入和多步任务。Python10,059
  4. KnifeLemon/Droidline用 Python、Node.js、C#、命令行、HTTP 或 Appium 驱动真实 Android 手机做自动化和测试,无需 ADB、USB 或 root。Go547
  5. X-PLUG/MobileAgent通过截图和自然语言指令操作桌面、手机与浏览器应用的 GUI Agent 与 GUI-Owl 模型系列。Python9,385