技能名称: droidrun-agent

详细描述:

Droidrun Agent

提供两个异步客户端（PortalHTTPClient 和 PortalWSClient）、一个配置辅助类（PortalConfig）以及一个内置的 MCP 服务器，用于与运行 DroidRun Portal 的 Android 设备通信。所有客户端方法均为 async 并支持 async with 上下文管理器。

安装

bash
cd droidrun-agent && uv sync # 仅核心功能
cd droidrun-agent && uv sync --extra mcp # 包含 MCP 服务器支持

PortalHTTPClient

使用 Bearer 令牌认证与 Portal 的 HTTP 服务器（默认端口 8080）通信。

python
from droidrun_agent import PortalHTTPClient

async with PortalHTTPClient(baseurl=http://192.168.1.100:8080, token=YOURTOKEN) as client:
await client.ping()
state = await client.getstatefull()
await client.tap(200, 400)
png = await client.take_screenshot()

查询方法（GET）

操作方法（POST）

PortalWSClient

使用 JSON-RPC 风格消息与 Portal 的 WebSocket 服务器（默认端口 8081）通信。当在断开的连接上调用方法时自动重连。

python
from droidrun_agent import PortalWSClient

async with PortalWSClient(ws://192.168.1.100:8081, token=YOUR_TOKEN) as ws:
await ws.tap(200, 400)
state = await ws.get_state()
png = await ws.take_screenshot()
timems = await ws.gettime()

方法

支持 PortalHTTPClient 的所有操作方法（tap、swipe、globalaction、startapp、stopapp、inputtext、clearinput、presskey、setoverlayoffset、setsocketport、take_screenshot），签名相同。

查询方法：

WebSocket 截图自动解析二进制帧并直接返回 PNG bytes。

异常

所有异常继承自 PortalError：

完整使用示例

python
import asyncio
from droidrun_agent import PortalHTTPClient, PortalWSClient

async def demo_http():
async with PortalHTTPClient(http://localhost:8080, token=YOUR_TOKEN) as client:
print(await client.ping())
print(Version:, await client.get_version())
print(Packages:, len(await client.get_packages()))

await client.tap(500, 800)
await client.swipe(500, 1500, 500, 500, duration=300)
await client.input_text(Hello World)
await client.press_key(66) # 回车

state = await client.getstatefull()
png = await client.take_screenshot()
print(fScreenshot: {len(png)} bytes)

async def demo_ws():
async with PortalWSClient(ws://localhost:8081, token=YOUR_TOKEN) as ws:
print(Version:, await ws.get_version())
print(Time:, await ws.get_time())

await ws.tap(500, 800)
await ws.start_app(com.android.settings)

png = await ws.take_screenshot()
print(fScreenshot: {len(png)} bytes)

asyncio.run(demo_http())
asyncio.run(demo_ws())

PortalConfig

用于管理连接设置的辅助数据类。支持直接构造或从环境变量加载。

python
from droidrun_agent import PortalConfig

直接构造

从环境变量加载

fromenv() 的环境变量：PORTALBASEURL、PORTALTOKEN、PORTALTIMEOUT、PORTALTRANSPORT。

MCP 服务器

内置的 MCP（模型上下文协议）服务器将所有 Portal 操作作为工具暴露，用于 AI 代理集成。需要 mcp 可选依赖（pip install droidrun-agent[mcp]）。

启动服务器

bash

通过 CLI 入口点

或作为 Python 模块

服务器从环境变量读取 PORTALBASEURL、PORTALTOKEN、PORTALTIMEOUT 和 PORTAL_TRANSPORT，并通过 stdio 通信。

MCP 工具

| 工具 | 描述 |
|------|-------------|