黑色星期五充值赠礼
每笔符合条件的充值都可获赠额度,并可与其他优惠叠加。
11月30日截止
脚本化的 UI 测试只要按钮挪个位置就会失效,而每次发版前都靠人把同样的流程点一遍又撑不起规模。可以让 AI 智能体来代替点击:你用自然语言描述一个测试(“用这个邮箱注册,往购物车里加一件商品,核对总价”),智能体就会读屏、点击、输入、滚动,直到完成或确认做不到。Lovely Router 的云手机是云端的真机 Android 14 手机。把 APK 装到其中一台上,通过 /v1/phones 下发测试目标,再读回通过或失败、智能体的回答以及它走过的每一步。手机在唤醒期间每小时 $1.20,按分钟计费,休眠期间不收费。
交给你的 AI 智能体
把这段提示词复制到 Claude Code、Cursor、Codex 或任何编程智能体中。它会告诉智能体文档在哪里,以及如何使用你的 API 密钥。
Upload my Android build to a Lovely Router cloud phone and run a short suite of plain-language test goals against it, reporting pass or fail with the agent's steps. - Docs (read first): https://lovelyrouter.com/docs/phone.md and https://lovelyrouter.com/docs/api/phones.md - Create a phone, upload and install the APK, start one agent run per test goal and poll it; collect each run's steps and final answer. Delete the phone at the end (billed while awake). - Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys. - Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large. - Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt. My task: <the APK and the test flows to check>
工作原理
上传你的构建
用
PUT /v1/phones/apks/{name}把 APK 存一次,单次请求最大 100 MB,或者按 50 MB 分片上传最大 500 MB。拆分包(.apks、.xapk)同样支持。上传到同一个名称会替换原文件,所以你的 CI 可以始终用同一个名称推送每个新构建。带着应用启动一台手机
在
apps中带上你的 APK 创建一台手机。新手机大约需要一分钟启动,安装期间会稍久一些。它的startup_apps字段会说明每个安装是否成功、装的是哪个包。把每个测试当作一个目标来运行
把每个测试以自然语言目标的形式发到
POST /v1/phones/{id}/runs,并带上它需要的所有值。当智能体达成目标时,运行以succeeded结束;当它判定目标无法达成时,以failed结束,原因写在answer里。trace=1会返回每一步。
针对你的 APK 运行一个测试目标
上传构建,带着它启动一台手机,然后等到它就绪:
curl -X PUT https://lovelyrouter.com/v1/phones/apks/myapp-latest.apk \
-H "Authorization: Bearer $LOVELY_API_KEY" \
--data-binary @app/build/outputs/apk/release/app-release.apk
curl https://lovelyrouter.com/v1/phones \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{"apps": ["myapp-latest.apk"], "name": "release-check", "wait": 50}'然后把测试依次发到同一台手机上。这个 Python 脚本会跑一个小型测试套件,并为每个测试打印一条结果:
import os, requests
API = "https://lovelyrouter.com/v1/phones"
H = {"Authorization": f"Bearer {os.environ['LOVELY_API_KEY']}"}
PHONE = "ph_..." # the id from POST /v1/phones
TESTS = {
"signup": "Open MyApp. Sign up with the email qa+signup@example.com and the password Test-1234. "
"Pass if the home screen greets the new user; report the greeting.",
"cart": "Open MyApp, search for 'blue mug', add the first result to the cart and open the cart. "
"Report the item name, quantity and total exactly as shown.",
"settings": "Open MyApp's settings, switch the language to German and go back to the home screen. "
"Pass only if the home screen is now in German.",
}
for name, goal in TESTS.items():
run = requests.post(f"{API}/{PHONE}/runs", headers=H, json={"goal": goal, "max_steps": 40}).json()
while run["status"] in ("queued", "running"):
run = requests.get(f"{API}/runs/{run['id']}", headers=H, params={"wait": 50}).json()
if run["status"] == "waiting":
print(name, "needs a person:", run["question"])
continue
trace = requests.get(f"{API}/runs/{run['id']}", headers=H, params={"trace": 1}).json()["trace"]
print(f"{name:<10} {run['status']:<10} {run['steps']:>3} steps {run['answer'] or run['error']}")
for s in trace:
if not s["ok"] or s.get("unchanged"):
print(" step", s["step"], s["action"], s.get("error") or "screen did not change", "-", s["note"])一台手机同一时间只运行一个目标,所以测试是依次进行的;在忙碌的手机上再发一个运行会得到 409。要并行测试就多启动几台手机:每个账号同时最多可以有 3 台。
智能体如何走完一个测试
在默认的 smart 模式下,每一步都是一次由对话模型发起的工具调用。模型会拿到屏幕上的元素(来自 Android 的视图树,每个元素都带位置以及 clickable、editable 等标记)和截图,然后只调用一个工具:tap、long_press、swipe、scroll、type、key、open_url、launch 或 wait 来执行动作,ask_user 来向你提问,或者 done 带着答案结束。每一步都会记录一条 note,写明它看到了什么、为什么这么做,以及动作本身、前台应用、是否成功,还有当动作让屏幕保持原样时的 unchanged: true。
默认模型是 gemini-3.8-flash;可以把模型列表中的任意对话模型作为 model 传入。它的 token 按正常 API 价格计费,运行会在 llm_usd 中报告这些消耗。一次运行默认最多 40 步,通过 max_steps 最多可到 200 步;达到上限的运行以 stopped 结束。
像写测试用例那样写目标。 把智能体需要的所有值(账号、搜索词、预期文本)都给它,并说明什么算通过:“如果总价以欧元显示则通过”。智能体会在 answer 中报告它看到的内容,所以让它把你想要断言的文本原样抄下来,再在代码里校验。
登录、验证码和人工介入
需要短信验证码的测试账号,或者只应由人来批准的流程,都不必跳过。智能体会调用 ask_user,运行转为 waiting 并带上 question,你用 POST /v1/phones/runs/{id}/reply 回答。或者打开实时屏幕,手动完成这一步,然后回复 done。
POST /v1/phones/{id}/screen 返回一个指向手机实时屏幕的链接。它在任何浏览器里都能打开,无需插件,可以嵌在你自己的仪表盘里作为 iframe,并让拿到链接的人观看和点击,所以只分享给应该使用这台手机的人。手机控制台不用写代码也能做到同样的事。
除非目标里明确要求,智能体从不付款、转账、删除数据或公开发布内容。不过结账流程还是建议使用测试账号和沙箱支付环境。
截图、重置和日志
在智能体运行之间,你自己的代码可以直接操控手机(直接控制):
GET /v1/phones/{id}/screenshot把屏幕保存为 WebP 用于测试报告,短边 540 像素。POST /v1/phones/{id}/actions配合{"action": "shell", "command": "pm clear com.example.myapp"}可在下一个测试前重置应用数据,logcat -d -t 300 *:E会在output中返回最新的错误。{"action": "launch", "package": "com.example.myapp"}会在起始页打开应用;{"action": "rotate", "orientation": "landscape"}用来检查横屏布局。
curl https://lovelyrouter.com/v1/phones/ph_.../actions \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{"action": "shell", "command": "logcat -d -t 300 *:E"}'在已经装有该应用的手机上安装新构建会执行更新:POST /v1/phones/{id}/apps 配合 {"apk": "myapp-latest.apk"},安装完成后返回。
它擅长什么,不擅长什么
AI 测试适合人们真正会用的流程:新手引导、搜索、结账、设置,以及任何你能用一句话描述的回归场景。布局变化时它们依然有效,因为智能体每一步都读屏,而不是去找固定的 view id。它们比脚本化测试慢(smart 模式下每步要几秒),而且只根据屏幕上的内容判断,所以需要精确像素比对或时序的检查还是应该放在你自己的测试代码里。每台手机都是云端同一款 Android 14 手机,带 Google Play 服务,没有 Play 商店,因此它不能替代在多种实体设备和 Android 版本上的测试。
常见问题
可以测试不在任何应用商店里的自有 APK 吗?+
可以。用 PUT /v1/phones/apks/{name} 上传,再按名称安装,或者在 apps 中列出指向该文件的 https:// 链接。任何 APK 都可以,.apks 和 .xapk 拆分包同样可以。
我怎么知道测试是否通过?+
当智能体达成目标时,运行以 succeeded 结束;当它判定做不到时以 failed 结束,原因写在 answer 或 error 里。让智能体报告你关心的文本,再在你自己的代码里对它做断言。
我能看到智能体每一步做了什么吗?+
可以。GET /v1/phones/runs/{id}?trace=1 会列出每一步的动作、它看到什么和为什么这么做的说明、是否成功,以及屏幕是否发生变化。用截图端点抓取截图放进你的报告。
应用要求输入验证码时会怎样?+
智能体会向你提问:运行转为 waiting 并带上 question,你回复后它继续。你也可以直接在实时屏幕上自己完成这一步。
可以并行运行测试吗?+
每台手机同一时间只运行一个目标,每个账号同时最多可以有 3 台手机,因此最多可并行运行 3 个测试。
能用于 iOS 应用吗?+
不能。云手机只运行 Android 14。