SuperAPI AI 工具集

adb-navigation-base

通用与其它

查看项目

更新于 10-15 21:09

技能介绍

用途:为 Android UI 自动化提供基础手势与等待模式,作为更复杂自动化流程的底层构件。

主要能力:包含三个脚本。adb-tap.py 支持带重试的智能点击与点击后文本校验;adb-swipe.py 支持上、下、左、右四方向滑动,可配置距离与起始坐标,并处理滚动惯性;adb-wait-for.py 按文本(基于 OCR)轮询等待元素出现,可配置超时(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),可用工作流编排器执行: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"。

适用场景:构建可靠自动化流程、处理时序敏感的 UI 切换、创建可复用导航模式,可与 adb-screen-detection 配合实现完整自动化,并被 adb-workflow-orchestrator、adb-magisk、adb-karrot 等使用。

限制:依赖 adb 命令行工具与 adb-screen-detection(提供截图、OCR、元素查找);等待检测方法目前仅支持 text(OCR);超时会返回 TIMEOUT 错误,需调用方处理。版本 1.0.0,状态为 Foundation Tier。