指示循环¶
用途¶
此节点让一段执行路线反复运行，同时用图像识别监视 ADB 画面。默认规则是“未命中时继续循环，命中时停止”；反转后则是“命中时继续，目标消失时停止”。
它不同于普通次数循环：识别监视与循环体是两个受控分支，适合“不断执行动作，直到某个画面出现/消失”。
添加路径¶
Shift+A → 自动化 → 指示循环
执行行为¶
每次进入节点先识别一次，再决定是否启动循环体。默认情况下，首次已经命中会直接走“停止条件满足”，循环体一次也不执行；未命中时，循环体持续逐轮执行，监视分支按最短时间串行识别。
识别条件满足时，节点取消正在进行的循环体，并走停止输出。循环体内若到达“结束执行”，结束蓝图的优先级更高：监视分支会被取消，蓝图立即结束。循环体输出未连接时，蓝图在执行准备阶段拒绝空循环。
输入端口¶
| 端口 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 进入循环 | 执行 | 是 | 激活一次指示循环。 |
| ADB | 字符串 | 否 | 只支持 ADB；可使用固定地址、扫描节点直接输出、Debug 目标或自动发现目标。 |
输出端口¶
| 端口 | 类型 | 说明 |
|---|---|---|
| 循环体 | 执行 | 必须连接；条件尚未满足时反复执行。 |
| 停止条件满足 | 执行 | 识别终止条件成立后执行一次。 |
| 已匹配 | 布尔 | 最后一次识别的原始命中结果；反转条件不会反转此值。 |
属性¶
双击节点进入与有限范围抓取相同的区域编辑器；指示循环固定使用图像模式。
| 属性 | 默认值 | 说明 |
|---|---|---|
| ADB | 空 | 固定目标地址；不填时由运行目标补齐。 |
| 目标图像 | 未设置 | 必填，可导入或截取。 |
| 搜索范围 | 全屏 | 每次只分析此归一化矩形。 |
| 匹配阈值 | 0.82 | 范围 0–1。 |
| 禁止缩放 | 开启 | 关闭时允许约 ±20% 模板缩放。 |
| 反转条件 | 关闭 | 关闭：命中停止；开启：未命中停止。 |
| 最短时间 | 0.5 秒 | 两次识别开始时间的最小间隔，范围 0.01–3600 秒。 |
识别本身耗时会占用间隔，因此请求始终串行，不会因设定很短而堆积。小于 0.1 秒时编辑器会给出性能提示。循环体没有额外固定间隔；需要节流时在循环体中连接“延时”。
最小示例¶
开始 → 指示循环
循环体→ADB 命令→ 回到本轮路线末端停止条件满足→ 下一任务
导入“完成提示”模板。默认未出现时反复执行命令，提示出现后停止。
常见错误¶
- 循环体没有连接：执行准备会拒绝空循环。
- 第一次就没有执行循环体：首次识别已满足停止条件，这是预期行为。
- 反转后
已匹配仍为 true：该端口始终表示原始识别结果，不表示“停止条件”。 - 循环体执行过快：识别间隔只限制监视分支；在循环体中添加延时。
- 使用屏幕或窗口 Debug 目标：当前节点只接受 ADB 目标。
- 结束节点与循环同时存在：执行到结束节点会立即结束整个蓝图，不会返回循环。