让 AI 帮你安装

让 AI 编程智能体完成电脑端的安装、启动服务器、显示配对二维码并检查设置,你只需在手机上安装应用并打开权限。

本页为译文。如与英文版不一致,以英文版为准。 English

如果你使用能在电脑上执行命令的 AI 编程智能体,例如 Claude Code、Codex、Cursor 的智能体或 Gemini CLI,可以把安装中电脑端的部分交给它。手机端仍需要你亲手操作,因为 Android 只允许人来安装应用并授予这些权限。

谁做什么

电脑上(智能体)手机上(你)
下载适合你系统的 droidline 并加入 PATH从发布页面安装 droidline-agent.apk
启动 droidline serve 并保持运行在应用的设置标签页中打开权限
运行 droidline pair 并显示二维码扫描二维码,或点击在此 Wi-Fi 下配对并告诉它 6 位代码
运行 droidline doctor 和 droidline devices 检查结果保持应用打开,直到手机显示已连接
安装你所用语言的 SDK

1. 准备手机

完成安装指南的第 3、4 步:安装应用并打开所有必需权限。Android 13 及以上请先按指南允许“受限设置”。

2. 把电脑端交给智能体

在任意文件夹中打开智能体,粘贴下面的请求。把最后一行的语言换成你使用的语言。

在这台电脑上安装 Droidline,让我能用代码控制我的安卓手机。

请按照官方指南 https://droidline.dev/zh/docs/install/ 操作,面向 AI 的摘要在 https://droidline.dev/llms.txt。不要编造指南里没有的命令。

1. 从 https://github.com/KnifeLemon/Droidline/releases/latest 下载适合这台电脑系统和 CPU 的最新 droidline,解压到你选择的文件夹,并把 droidline 加入 PATH。
2. 在另一个终端或后台运行 "droidline serve",并保持运行。
3. 运行 "droidline pair" 并把二维码给我看,我用 Droidline 应用扫描。如果我给你 6 位代码,就运行 "droidline pair <代码>"。
4. 我说配对好了之后,运行 "droidline devices" 和 "droidline doctor",告诉我结果。
5. 安装 Python 版 Droidline SDK。

如果需要修改防火墙或网络设置,先问我。

智能体会在第 3 步停下来等你。用应用的配对标签页扫描二维码,或点击在此 Wi-Fi 下配对,把手机上显示的代码告诉智能体。

3. 检查结果

droidline devices 显示手机在线,就说明安装完成了。让智能体执行第一条命令,例如打开设置:

运行 "droidline launch com.android.settings",告诉我发生了什么。

如果出了问题,让智能体运行 droidline doctor 并按照故障排除处理。Windows 防火墙提示和网络配置文件的更改需要你亲自确认。

没有终端的聊天应用

Claude Desktop、ChatGPT 等聊天应用只能通过 MCP 连接 Droidline,而 MCP 工具特意不包含配对,因此智能体无法配对新手机,也无法更改谁能控制手机。使用这类应用时,请先按照安装指南和快速开始自己安装并配对一次,再把 Droidline 添加为 MCP 服务器。之后智能体就可以使用已配对的手机。

开始之前

能使用终端的智能体会在你的电脑上执行命令,配对后还能操作你真实的手机。批准之前先看清它要做什么,保持客户端的批准提示开启,试用期间使用测试手机或没有银行应用的手机。