SuperAPI AI 工具集

adb-navigation-base

测试与质量

查看项目

更新于 10-16 07:26

技能介绍

用途:为 Android 设备 UI 自动化提供基础手势与等待模式,可用于构建可靠的工作流、处理时序敏感的界面切换,以及创建可复用的导航模式。

主要能力: 一、adb-tap.py 智能点击,支持失败自动重试(--retry)、点击后文字校验(--verify-text)与超时(--timeout)。 二、adb-swipe.py 方向滑动,支持 up、down、left、right 四个方向、距离像素(--distance)、自定义起点(--start-x、--start-y)与滑动后校验。 三、adb-wait-for.py 等待元素或文字出现,检测方式为 text(基于 OCR),可配置超时(1-60 秒)、轮询间隔(--interval),支持 --json 输出,找到元素时返回坐标。

使用方式:脚本以 uv run 调用,例如 uv run .claude/skills/adb-navigation-base/scripts/adb-tap.py --x 100 --y 200 --retry 3,或 uv run .claude/skills/adb-navigation-base/scripts/adb-swipe.py --direction up --distance 300;等待示例为 uv run .claude/skills/adb-navigation-base/scripts/adb-wait-for.py --method text --target "Loaded" --timeout 5。技能还提供 TOON 工作流定义,可用编排器执行:uv run .claude/skills/adb-workflow-orchestrator/scripts/adb-run-workflow.py --workflow .claude/skills/adb-navigation-base/workflow/tap-and-wait.toon --param device="127.0.0.1:5555"。

适用场景:登录导航、滑动查找元素、带重试的可靠操作等。依赖 adb-screen-detection 进行截图与 OCR,并被 adb-workflow-orchestrator、adb-magisk、adb-karrot 使用。

限制:检测方式为 OCR,需要系统 adb 工具;重试用尽或超时返回错误,由调用方处理;资料未提供收费、价格与平台支持信息。