Longarm 批处理任务

返回 longarm 文档

批处理任务可以保存可复用的多步骤工作流，并在之后从应用、REST API 或 MCP 运行。

关键行为

同一时间只能有一个批处理运行
运行请求会立即返回 runId
通过状态和历史记录检查进度
screenshot 步骤捕获的截图会保存到批处理历史
默认保留 30 次运行记录

任务结构

{
  "id": "bt_...",
  "name": "Open Settings and capture",
  "steps": [],
  "repeat": 1,
  "variables": {}
}

步骤结构

{
  "id": "step_1",
  "type": "tap",
  "params": { "x": 540, "y": 1200, "duration": 80 },
  "repeat": 1,
  "delayAfterMs": 0,
  "continueOnError": false,
  "children": []
}

步骤类型

免费：

tap
long_press
screenshot
open_app
open_intent
overlay_show
overlay_hide
delay
set
ui_action
set_text
ui_scroll
wait_for_ui
loop

Plus：

swipe
pinch
two_finger_swipe
rotate

变量

在字符串参数中使用 {{name}} 替换：

{
  "variables": {
    "packageName": "com.android.settings"
  },
  "steps": [
    {
      "type": "open_app",
      "params": { "packageName": "{{packageName}}" }
    }
  ]
}

可从 Batch 标签页、REST API 或 MCP 运行已保存任务，并在 Batch History 中查看消息和截图。