技能介绍

要解决的问题

在真实安卓设备上做自动化，最常见的困境是：脚本能截图，却没法把一次点击变成带坐标的手势；位置型操作必须先查分辨率再算像素，分辨率一变，硬编码的坐标全部作废。longarm Control 把设备上运行的 longarm 应用当作控制面，通过 HTTP 端点与 MCP 工具，把手势、截图、应用启动、悬浮窗状态与批量任务统一成一套可调用的接口。

它如何工作

先检查连接：发出任何指令前先执行 scripts/longarm.sh status。它确认网络可达，并返回当前 Plus 状态以及该设备上可用的手势端点。
动态计算坐标：位置型请求先拉取 screen-info，依据返回的 width/height 计算像素，不要假设分辨率。坐标为 Android 屏幕像素，原点 (0,0) 在左上角，x 向右递增，y 向下递增。
核心能力：截图、应用/Intent 启动、悬浮窗显示与隐藏，以及手势执行（滑动、捏合、双指滑动、旋转）。
批量任务：一个任务包含名称、可选变量与步骤。步骤支持手势、截图、启动应用/Intent、悬浮窗控制、延时、变量赋值与循环。批量接口立即返回 runId 和 status: "processing"，通过 batch-history-get 轮询直到状态变为 finished、failed 或 aborted。截图步骤保存在历史记录中，可单独下载，也可导出为 zip。
MCP 模式：当需要 agent/工具客户端直连时改用 MCP server，工具是否可用与 HTTP 侧遵循同一套 Plus 门控。

适用边界与注意点

swipe、pinch、two-finger-swipe、rotate 属于 Plus 专属手势。设备没有 Plus 时，HTTP 返回 403 与 {"error":"Plus subscription required"}，MCP 则完全不暴露这些工具。设备上必须运行 longarm、启动对应 server、授予无障碍与悬浮窗权限，并且本机网络可达。若 HTTP base URL、可选 bearer token 或 MCP URL/port 缺失，应先向用户询问，而不是猜测。完整端点规范见 references/api.md，MCP 方法与工具名见 references/mcp.md。