搜索你想找的开源项目

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

分享到微信

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

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

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

ybblab/Droidance

AI 工程

一款开源安卓 AI 智能体,在后台虚拟屏里看屏幕、点应用,替你完成手机上的日常操作。

151
32
Kotlin
Apache-2.0
创建于 3 个月前

项目介绍

Droidance 是一个把多模态模型智能体放在安卓手机本地运行的应用。你用一句话描述任务,它通过截图理解界面、决定下一步,并在独立的虚拟屏里点击、输入和滑动。它面向手机上的日常事务,比如比价、点单、预约、查询、整理信息与定时执行,而不是帮人开发应用。

它不需要 Root、电脑,也不依赖无障碍服务。App 内置无线调试客户端,完成一次配对后连接手机自身的 adbd,启动 Shell 身份的 Sidecar 并创建一块虚拟显示屏;所有操作都基于截图,因此自绘控件、WebView 这类无障碍树不完整的界面也能尝试操作。Root 和 Shizuku 是可选的替代连接方式。

快速使用

准备:Android 11 及以上手机(低内存设备和 Android Go 不支持)、配对时可用的 Wi-Fi,以及一个支持图像输入和工具调用的多模态模型 API Key。

  1. 从 Releases 下载最新 APK 并安装。
  2. 在「连接设备」里选择无线调试,按引导打开「开发者选项 → 无线调试」并输入配对码,全程不需要电脑。
  3. 添加模型服务商的服务地址、API Key 和模型,然后用一句话说出任务。

任务在后台执行,顶部的运行岛可以查看进度、暂停或接手。小米设备提示输入被拦截时,开启「USB 调试(安全设置)」;OPPO、一加、realme 关闭「权限监控」后重新连接。

从源码构建需要 JDK 17 和 Android SDK 35,在 local.properties 配置 sdk.dir 后执行 ./gradlew :app:assembleDebug;scripts/verify.sh 运行公开源码检查(构建说明)。

使用约束

  • Android 11–13 为实验性支持:虚拟屏没有独立焦点,按键和文字输入会短暂占用主屏;Android 11、12 锁屏后任务停止。
  • 无线调试配对和重启后恢复需要 Wi-Fi,部分系统闲置后会关闭无线调试;Shizuku 需单独启动且重启后重新启动;Root 仅在 Android 16 + SukiSU 上做过真机验证。
  • 部分 App 会检测开发者选项或无线调试,可能拒绝运行。
  • 任务完成率和耗时取决于所选模型,智能体报告「完成」不代表业务结果一定正确。
  • 人机验证始终由你完成,但支付、登录等敏感步骤是否暂停由智能体按规则判断,并非硬性拦截,不可逆操作请自己核对。
  • 任务指令、上下文和屏幕截图会发给你配置的模型服务商;诊断记录可能含个人信息,清理只是尽力执行。API Key 保存在应用私有存储中,运行数据位于 Shell 持有目录,卸载不一定删除。
  • 自动化操作可能违反第三方 App 协议并带来账号风险。项目采用 Apache 2.0 许可。

HotRepo 点评

该仓库目前没有可用的 HotRepo 榜单名次、快照或讨论记录,站内热度方面没有可观察的结论。从技术事实看,值得关注的是它用内置 ADB 客户端和虚拟显示屏替代无障碍服务,并且对 Android 11–13、厂商系统与模型能力依赖给出了明确限制。对准备上手的用户,主要提醒是交付物是预编译 APK:安装前可核对每个 Release 附带的 .sha256 文件,并先阅读安全说明。

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

相关推荐

  1. AcidGr/agent-mobile-use在 Android 后台虚拟副屏中运行应用,让 Agent 在不打扰物理主屏的情况下操控手机。Java124
  2. guzhou079-arch/deepseek-harness-android把 DeepSeek Harness 打包成安卓 APK,免 Termux、免 root,内置读屏、虚拟屏、定时任务和 27 款技能。JavaScript110
  3. kilolonion/agent-vscreen给 Android AI Agent 一块隐形副屏,让它在后台操作 App,你继续用自己的屏幕。Kotlin117
  4. kuafuai/andee一个住进 Android 手机或 Mac 的本地智能体,借助无障碍服务像用户一样操作任意 App,无需集成或 Root。Kotlin6,150
  5. tapilot-ai/tapilot用自然语言操控 Android 手机执行跨应用任务的实验性应用,依赖视觉模型和 Android 无障碍权限。HTML138