黑色星期五充值赠礼
每笔符合条件的充值都可获赠额度,并可与其他优惠叠加。
11月30日截止
游戏对 AI 智能体来说很难,难度和表单、菜单完全不是一回事。屏幕每秒都在变,你点的东西大多不是按钮,而一个每步都要停下来想十秒的智能体早就输了。Lovely Router 的手机智能体有一个专门为此打造的模式。在快速模式下,决策模型根据屏幕元素和截图在远不到一秒内选出几乎每一步,教练模型在旁边写策略并不断改写,而毫无效果的操作会被发现且不会重复。它运行在云手机上:云端真实的 Android 14 手机,可安装任意 APK,每清醒小时 $1.20,按分钟计费。
交给你的 AI 智能体
把这段提示词复制到 Claude Code、Cursor、Codex 或任何编程智能体中。它会告诉智能体文档在哪里,以及如何使用你的 API 密钥。
Install a game on a Lovely Router cloud phone and start a fast-mode phone run that plays it, then report the result and the coach's strategy. - Docs (read first): https://lovelyrouter.com/docs/phone.md and https://lovelyrouter.com/docs/api/phones.md - Create a phone, install the APK, start an agent run with `mode: "fast"` and a goal (what counts as doing well); poll it and read `strategy` and the steps. Delete the phone when done. - 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 game and what to play>
人们用它做什么
让智能体玩每个构建的前几关,并报告它卡在哪里、哪个界面失去响应,或者在固定步数内推进到了多远。
教程、奖励弹窗和商店推荐:新玩家能在无人帮助的情况下走完这些吗?
看智能体从屏幕中学习游戏规则、比较教练写出的策略,或者在你自己的页面上展示 AI 正在玩的实时游戏。
工作原理
安装游戏
游戏常常以分包形式分发。用
PUT /v1/phones/apks/{name}上传一次(单次请求最大 100 MB,分片最大 500 MB),或者在apps中列出一个https://链接。.xapk的游戏数据(其 OBB 文件)也会一并复制到手机上。启动一次快速运行
在发送目标时带上
"mode": "fast"。说明玩什么、什么算表现好:“玩这一关,优先选择棋盘靠底部的配对,150 步后停止并报告分数。”观看,然后读取结果
打开实时屏幕观看游戏进行。运行结束后,用
trace=1读取智能体的回答、教练最新的策略和每一步操作。
启动一次游戏运行
curl https://lovelyrouter.com/v1/phones/runs \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{
"goal": "Open the puzzle game and play level 1. Make the best move you can on each turn. When the level ends, report whether you won and the score shown.",
"apps": ["puzzle-game.xapk"],
"mode": "fast",
"max_steps": 200
}'在新手机启动并安装游戏期间,运行处于 queued,之后变为 running。达到 max_steps 的运行以 stopped 结束,而不是 failed,因为像“一直玩下去”这样的开放式目标没有别的终点。
决策模型与教练
快速模式把工作分给两个模型,两者都包含在手机价格里:
- 决策模型负责玩。每一步它都会拿到一份根据屏幕内容生成的菜单(对每个元素点击、输入、长按或滚动,外加返回、主页、回车、等待和打开应用)以及截图,因此它也能点击不在列表中的位置,比如棋子或图片里的方块,并能向四个方向滑动。它总是按最佳猜测行动,即使不确定:在游戏里,任何一步都比等待强。
- 教练负责思考。它读取目标、最近的步骤和屏幕,然后写下一段简短策略(对游戏而言,是优先选哪些走法)和一条当前局势的说明。它在第一步、每隔几步、游戏或应用发生变化时、以及运行看起来卡住时运行,而决策模型从不等待它:每一步都使用它最新的版本。运行会在
strategy、situation和sidecar_updates中展示它;"plan": false可将其关闭。
你在 model 中选择的聊天模型(默认 gemini-3.8-flash)只负责写最终回答和向你提出的问题。智能体输入的文本来自你的目标和你的回复,绝不编造。由于聊天模型不参与走子,快速运行消耗的 token 远少于 smart 运行。
横屏游戏与实时屏幕
许多游戏锁定横屏。此时截图返回 1200×540 而不是 540×1200,坐标也随之变化,实时屏幕会跟着游戏一起旋转。POST /v1/phones/{id}/screen 返回链接:它在任何浏览器中都能打开,无需插件,还能嵌入 iframe,因此你可以在自己的页面上展示正在进行的游戏。拿到链接的人也能点击和输入,所以要谨慎分享,或者把它留在你自己的仪表盘里。
事后读取操作记录
GET /v1/phones/runs/{id}?trace=1 会列出每一步:智能体记录了什么、动作及其参数、前台应用、是否成功、耗时多少 ms,以及对于毫无效果的操作标记 unchanged: true。数一数无效操作、找出关卡停滞的位置,或者在目标里写不同指令、用同一个目标运行两次来比较两种策略。
如果你想自己写脚本机器人,可以跳过智能体直接操控手机:先 GET /v1/phones/{id}/screenshot,再用截图坐标 POST /v1/phones/{id}/actions,带上 tap 或 swipe(直接控制)。
常见问题
AI 智能体真的能玩手游吗?+
能,但有局限。在快速模式下,它根据屏幕元素和截图在远不到一秒内选出走法,遵循教练写出的策略,并避开毫无效果的操作。它的水平相当于一个反应快、守规则的玩家;需要每秒大量精确输入的快速反应游戏则超出它的能力。
它能玩哪些游戏?+
任何能在 Android 14 上运行、并能从 APK、.apks 或 .xapk 文件安装的游戏。回合制和益智游戏最适合它,因为每一步都能从一张截图中判断。
智能体在快输时会重启游戏吗?+
不会。除非游戏已经结束,或者你的目标要求重启,否则“重新开始”“新游戏”和“再试一次”按钮都被排除在它的走法之外。
教练要额外收费吗?+
不要。决策模型和教练都包含在手机的按小时价格中。只有写最终回答和提问的聊天模型按 token 计费。
智能体玩的时候我能观看吗?+
能。实时屏幕链接可以在任何浏览器中、或通过 iframe 在你自己的页面上显示手机,横屏竖屏皆可。