SuperAPI AI 工具集

adb-navigation-base

通用与其它

查看项目

更新于 10-16 00:04

技能介绍

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

主要能力:包含三个脚本。adb-tap.py 执行智能点击,支持自动重试、点击后文本校验与超时保护;adb-swipe.py 执行上下左右四方向滑动,可配置距离与起始坐标,支持滑动后校验并考虑滚动惯性;adb-wait-for.py 轮询等待指定文本出现,可配置超时(1-60 秒)与轮询间隔,支持 JSON 输出,找到后返回元素坐标。

使用方式:通过 uv run 调用脚本,例如点击 uv run .claude/skills/adb-navigation-base/scripts/adb-tap.py --x 100 --y 200 --retry 3 --verify-text "Next";滑动 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 工作流定义(如 tap-and-wait.toon、scroll-and-find.toon、gesture-sequence.toon),可用 adb-workflow-orchestrator 的 adb-run-workflow.py 执行。

适用场景:Android 应用自动化测试与操作流程,如登录、翻页、滚动查找元素,以及与其他 adb 技能组合完成完整自动化。

限制:依赖 adb 命令行工具与 adb-screen-detection(截图与 OCR),等待检测方法目前仅支持基于 OCR 的文本识别;具体设备兼容性、性能与收费信息暂未提供。