术语表

术语	含义
无障碍服务（Accessibility service）	Android 的一项功能，让应用能读取屏幕上的内容并进行操作，原本是为使用屏幕阅读器或开关控制的人设计的。Droidline 应用用它来查看元素，并执行点击、滑动和输入。
活动（Activity）	Android 应用的一个界面，例如 .LoginActivity。current() 返回前台的包名和 activity。
手机端应用（Agent）	手机上的 Droidline 应用。它连接到服务器并执行命令。
批处理（Batch）	由手机一次性自行执行的一组命令，用于手机中途会离线的情况，例如开关飞行模式。参见概念。
边界（Bounds）	元素在屏幕上的位置，形式为以像素为单位的 [left, top, right, bottom]。
客户端（Client）	你这一侧：向服务器发送命令的脚本、CLI、HTTP 请求或 AI 智能体。
条件（Condition）	提出一个问题并立即回答、而且不会失败的命令，例如 exists、checked 或 get_text。
内容描述（Desc）	元素的内容描述，供屏幕阅读器使用。图标按钮往往只有这一项。
设备 ID（Device ID）	手机配对时服务器分配给它的随机标识符，例如 k7d2q9xa。手机还有一个由你选定的名称。
界面转储（Dump）	以元素树形式表示的界面，由 dump() 返回。它是挑选选择器的起点。
元素（Element）	dump 中屏幕上的一样东西：一个按钮、一段文字、一个输入框、列表中的一行。
错误码（Error code）	失败的简短名称，例如 NOT_FOUND，在所有接口中都相同。参见错误码。
输入法（IME）	Input method editor，Android 对键盘应用的称呼。Droidline 自带一个，即 Droidline 键盘。
MCP	Model Context Protocol，AI 助手使用工具的标准方式。droidline mcp 让 Droidline 成为这类工具之一。参见 AI 智能体。
nth	有多个元素匹配时使用哪一个，从 0 开始计数。
包名（Package name）	Android 应用的唯一名称，例如 com.android.chrome。droidline apps 会列出它们。
配对（Pairing）	用二维码或 6 位代码让手机和电脑互相认识，只需一次。双方交换密钥，此后就能认出对方。
中继（Relay）	你在互联网上运行的小型服务器，在你的电脑和使用移动数据的手机之间传递加密的数据行。参见远程手机。
资源 ID（Resource ID）	id 字段：应用开发者为元素起的名称，例如 com.example:id/login。不随语言变化。
线路（Route）	手机连接电脑的方式：lan（同一 Wi-Fi）、direct（转发的端口）、tunnel 或 relay。
SDK	某种编程语言的库：Python 用 PyPI 上的 droidline，Node.js 用 npm 上的 droidline。
选择器（Selector）	用来选中元素的一个字段和一个值，例如 ("text", "Log in") 或 ("id", "email")。
服务器（Server）	droidline serve，你电脑上把代码和手机连接起来的程序。
超时（Timeout）	命令在失败之前等待元素出现的时长，默认 10 秒，可以修改。
令牌（Token）	一个秘密字符串（dlc_...），让另一台机器上的客户端可以使用服务器。用 droidline token create 创建。
隧道（Tunnel）	Cloudflare Tunnel 或 ngrok 之类的服务，为你的电脑提供一个公网地址，让使用移动数据的手机能访问它。
via	回复中的一个字段，说明点击或输入的文字是以哪种方式送达的：node、parent、gesture、set_text 或 ime。