简易图像识别¶
用途¶
此节点提供入门级模板匹配：给定一张模板，在一个画面来源中寻找最佳匹配，输出是否找到以及目标中心位置。它适合全画面快速找图；需要限定 ROI、OCR 或有限重试时使用有限范围抓取。
添加路径¶
Shift+A → 自动化 → 简易图像识别
执行行为¶
进入节点后，默认先等待 10 秒，再开始识别。画面来源按 ADB地址 → 窗口进程名 → 屏幕ID → 主桌面的优先级选择，第一项非空者生效。
关闭“循环查找”时只识别一次。开启后，默认在未找到时按间隔重试，找到后继续执行；开启“反转循环条件”后则在仍找到时重试，直到目标消失。命中且“点击目标”开启时，节点点击目标中心。
输入端口¶
| 端口 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 执行输入 | 执行 | 是 | 开始等待和识别。 |
| 模板 | 图像/通用 | 二选一 | 可连接路径、影像值或图像资源；优先于节点内目标图像。 |
| ADB地址 | 字符串 | 否 | 非空时使用 Android 截图。 |
| 窗口进程名 | 字符串 | 否 | 在非最小化窗口中按进程名先精确、再包含匹配。 |
| 屏幕ID | 字符串 | 否 | 指定显示器；为空且没有更高优先级来源时使用主桌面。 |
输出端口¶
| 端口 | 类型 | 说明 |
|---|---|---|
| 执行输出 | 执行 | 识别或循环条件完成后继续。 |
| 找到 | 布尔 | 本次最终画面是否命中。 |
| 位置 | 二维向量 | 目标中心相对当前画面的 0–1 百分比；未找到时为 (0,0)。 |
属性¶
| 属性 | 默认值 | 说明 |
|---|---|---|
| 目标图像 | 未设置 | 可导入或截取；连接模板端口时由端口覆盖。 |
| 锁定模板缩放 | 关闭 | 开启时仅以原尺寸匹配；关闭时尝试 0.7–1.3 的多档缩放。 |
| 点击目标 | 关闭 | 命中后点击中心；ADB 使用设备坐标，桌面/窗口使用桌面坐标。 |
| 置信度 | 0.70 | 有效范围 0.05–1.00。 |
| 延迟检测 | 开启 | 进入节点后先等待一次。 |
| 延迟时间 | 10 秒 | 有效范围 0.1–600 秒，不会在每次循环前重复。 |
| 循环查找 | 关闭 | 开启后阻塞执行线直到循环条件满足。 |
| 检测频率 | 0.50 秒 | 循环重试间隔，有效范围 0.05–60 秒。 |
| 反转循环条件 | 关闭 | 关闭时“找到即通过”；开启时“消失即通过”。 |
多个候选中置信度最高者优先；置信度相同时先取更靠左、再取更靠上的目标。
最小示例¶
开始 → 简易图像识别 → 分支
导入模板，关闭默认延迟，把 找到连接到分支条件。若希望等待按钮出现，再开启“循环查找”。
常见错误¶
- 执行后像是卡住 10 秒：默认启用了延迟检测；不需要时关闭。
- 同时填写多个来源却截错画面：来源有固定优先级，清空不需要的高优先级字段。
- 窗口找不到：填写进程名而非窗口标题，并确认窗口没有最小化。
- 模板边缘模糊导致误判：提高置信度，或开启“锁定模板缩放”。
- 循环永不结束：检查“反转循环条件”的方向，以及目标是否真的出现或消失。