KnifeLemon/Droidline
AI 工程用 Python、Node.js、C#、命令行、HTTP 或 Appium 驱动真实 Android 手机做自动化和测试,无需 ADB、USB 或 root。
项目介绍
Droidline 让开发者用代码控制真实 Android 手机。PC 上运行 Go 服务端,手机端安装配套 App,由手机主动连回 PC,因此不需要 ADB、USB 调试或 root。命令统一定义在 spec/commands.json,再生成到 Python、Node.js/TypeScript、C#、CLI、HTTP 和 MCP,各语言里的 touch、input、dump 含义一致。
它适合测试自己 App 并需要跨应用流程的开发者、用一排手机跑重复任务的用户,以及需要通过 MCP 看屏幕并操作手机的 AI Agent。元素按 text、id、desc 定位,而不是坐标;touch、input、wait 默认等待元素出现,exists、checked、which 则立即返回条件结果。一台 PC 可以控制多台手机:同一台手机的命令按顺序执行,不同手机可并行。
快速使用
需要一台 Windows、macOS 或 Linux PC,以及 Android 9+ 手机;首次运行让两者处于同一 Wi-Fi。详细截图步骤见安装指南。
-
从 Releases 下载对应系统的服务端压缩包,把
droidline放进PATH并启动:droidline serve -
在同一发布页安装
droidline-agent.apk。在 App 的 Setup 页开启无障碍服务、Droidline 键盘、通知权限和不限制电池使用;Android 13 及以上需先允许受限设置。 -
配对手机。在 PC 上运行:
droidline pair用 App 的 Pair 页扫二维码,或选择 Pair on this Wi-Fi 后输入 6 位码:
droidline pair 482913。 -
发送命令:
droidline launch com.android.settings droidline touch text "Network & internet"
没有真机时,每个发布包都带 droidline-fakephone,可用内置演示 App 模拟一台手机;第一个脚本教程会基于它写出完整的登录脚本。Python 端(pip install droidline,Python 3.9+)连接同一个服务端:
from droidline import connect
d = connect()
d.launch("dev.droidline.demo")
if d.exists("text", "Close ad"):
d.touch("text", "Close ad")
d.input("id", "email", "knife")
d.touch("text", "Log in")
print(d.get_text("id", "greeting"))
远程手机与 Agent 接入
手机始终主动发起连接,因此不需要开放入站端口。同一 Wi-Fi 下通过 UDP 广播发现 PC;其他方式包括转发一个 TLS 端口、用 cloudflared/ngrok 开隧道,或在 Cloudflare Workers 或 VPS 上部署自己的中继。握手之后通信使用 P-256 密钥协商和 AES-256-GCM,隧道或中继只承载密文。各条路线见远程连接文档。
面向 AI Agent,droidline mcp 通过 MCP 暴露手机能力,并在 MCP Registry 以 io.github.KnifeLemon/droidline 登记。可用 --tools dump,screenshot,touch 或 --read-only 限制 Agent 能用的工具。可选工具还包括检查器/录制器、供 Appium 客户端使用的 WebDriver 桥、pytest 插件、手机租约以及图像和文本匹配。
使用约束
Droidline 只使用普通应用可获得的权限,因此只能操作应用导出的界面:不能打开其他应用的私有页面,不能解锁 PIN、图案或密码锁屏,也不能用单条命令强制停止应用或清除数据(Settings 相关配方通过点击按钮完成,不同手机的标签可能需要调整)。游戏和自绘界面不暴露元素,只能使用坐标点击和像素颜色判断。Android 15 及以上会隐藏通知里的一次性验证码。按应用代理使用本地 VPN,每台手机一个上游,无需 root。项目当前为 0.1 版本:服务端、CLI、MCP 适配器、中继和各 SDK 已围绕手机模拟器通过测试,App 在 Android 13 模拟器上运行过,跨品牌真机测试仍待补足;STATUS.md 列出了已验证范围。许可证为 MIT。请只在自有或获准自动化的手机与账号上使用。
HotRepo 点评
仓库现有 547 个 Star 和 58 个 Fork,但 HotRepo 没有该项目的日榜名次、快照或 Hacker News 讨论记录,站内无法据此判断热度走势。从现有材料能看到的是一个落地的多语言实现:Go 服务端、Kotlin App、Python/Node.js/C# SDK 和中继都在仓库中,CI 与集成脚本会一起运行服务端、模拟手机和 SDK 示例。0.1 版本和主要依赖模拟手机的验证方式意味着,真正需要观察的是各品牌真机上 Settings 配方的表现,而不是当下的人气数字。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。
相关推荐
- ZSeven-W/dsh-android把 Android 模拟器或 USB 手机实时串流进对话,并通过 adb 驱动它完成构建、安装与 UI 操作。
- kilolonion/agent-vscreen给 Android AI Agent 一块隐形副屏,让它在后台操作 App,你继续用自己的屏幕。
- droidrun/mobilerun用自然语言驱动真实 Android 和 iOS 设备的 LLM 无关框架,可通过 CLI 或 Python API 完成点击、滑动、输入和多步任务。
- phone-harness/mcp这是一个托管 MCP 服务,让 AI 智能体在云端操控真实 iPhone 和 Android 模拟器。
- hridaya423/phonedriver让 AI 代理通过 MCP 和命令行读取并操控 Android 手机与 iPhone 屏幕,付款类操作前先向人确认。