03 图色与 YOLO 识别

识别在动作之前执行。未命中时不会执行动作，而是进入失败流程。识别类型切换后，只显示当前类型可添加的参数。

无识别

无识别不检查画面，节点被扫描到时直接命中。它没有必须添加的参数；高频场景通常保留 无动作，用于流程中转或结束节点。

识别范围和范围偏移虽然属于该类型的可添加参数，但无识别不进行画面查找，第一批手册不建议添加。

在识别下拉框选择找图，再从 + 菜单添加所需参数。

图中展示一个已添加模板、阈值、排序、序号和全屏识别范围的找图节点；未显示的参数仍从识别行右侧 + 添加。

参数	格式	默认/空值	必填与显示	运行影响与示例
模板图片	项目图片路径列表	初始一项空值；空值校验失败	必填；找图时可添加	依次加载项目资源，例如`images/start.png`
图片偏色	6 位十六进制列表	`000000`；空值校验失败	必填；数量必须与模板一致	RGB 各通道容差；`101010`允许每通道约 16 的差异
匹配阈值	`0..1` 数字	`0.9`；留空仍使用`0.9`	可选	越接近 `1` 越严格，例如`0.92`
结果排序	下拉选择	精度（`Score`）	可选	先过滤、去重，再排列候选
结果序号	整数	`0`	可选	`0`第一项，`1`第二项，`-1`最后一项；越界视为未命中
匹配算法	下拉选择	通用匹配	可选	决定模板比较算法；不确定时保持通用匹配
识别范围	`x1,y1,x2,y2` 或引用	`0,0,0,0`（全屏）	可选	只在范围内找图，例如`100,80,600,500`
范围偏移	`w1,h1,w2,h2`	未添加/空值均不偏移	可选	调整范围四边，例如`-10,0,20,10`

结果排序可选 精度、水平、垂直、面积、中心、随机。随机排序会在每次识别时重新排列。匹配算法可选 通用匹配、差异匹配、亮度匹配、精准差异、亮度相关、系数匹配、反转差异。

模板图片和图片偏色是位置对应的两张表。例如两张模板必须同时提供两个偏色值；不要只给一个值并期待自动套用到全部模板。

YOLO 使用已导入项目的 YOLOv8 ONNX 模型检测目标。模型导入、删除和检测测试见YOLO 指南：模型与检测；这里维护节点字段的权威说明。

参数	格式	默认/空值	必填与显示	运行影响与示例
检测模型	项目检测模型相对路径	空；空值校验失败	必填；YOLO 时可添加	选择项目中已导入的`.onnx`模型，例如`enemy.onnx`
类别标签	按类别编号排列的文本列表	未添加时使用模型自带标签	可选	仅在需要覆盖模型标签时填写，例如`person`、`car`
期望类别	非负整数列表	未添加时接受全部类别	可选	只保留指定类别编号，例如`0`、`2`
检测阈值	`0..1`数字或数字数组	`0.3`	可选	单个数字应用到全部类别；数组必须与期望类别数量一致，例如`[0.3,0.5]`
结果排序	下拉选择	精度（`Score`）	可选	可选精度、水平、垂直、面积、随机和期望
结果序号	整数	`0`	可选	`0`取第一项，`-1`取最后一项；越界视为未命中
识别范围	`x1,y1,x2,y2`或引用	`0,0,0,0`（全画面）	可选	只检测指定范围
范围偏移	`w1,h1,w2,h2`	不偏移	可选	调整识别范围四边

类别标签按模型的类别编号从0开始排列。期望类别填写的是编号，不是标签文字；阈值数组则按期望类别的填写顺序一一对应。期望排序会优先按期望类别顺序排列，其他排序方式处理过滤后的全部候选。

比色检查指定绝对坐标上的颜色是否同时符合预期，不显示识别范围、范围偏移、结果排序或结果序号。

参数	格式	默认/空值	必填与显示	运行影响与示例
比色数值	多点颜色文本	空；空值校验失败	必填；比色时可添加	每点为`x
匹配阈值	`0..1` 数字	`0.9`	可选	控制实际颜色与目标颜色的接近程度，例如`0.95`

多点格式由抓抓工具生成最稳妥。点坐标是截图客户区的绝对坐标，不随识别范围变化。

找色以主颜色为基准，并检查相对它的偏移颜色组合。

参数	格式	默认/空值	必填与显示	运行影响与示例
颜色数值	`"主色","偏移色"`	空；空值校验失败	必填；找色时可添加	例如`"FF0000","10
匹配阈值	`0..1` 数字	`0.9`	可选	控制颜色接近程度
结果排序	下拉选择	精度	可选	可选精度、水平、垂直、中心、随机；找色没有面积排序
结果序号	整数	`0`	可选	从完整排序结果选择；支持负数，越界未命中
查找数量	正整数	`1`	可选	限制返回给结果展示的匹配数量，不负责选择正式命中
去重阈值	非负整数	`10`；`0`不去重	可选	合并距离太近的候选，不是匹配阈值
识别范围	`x1,y1,x2,y2` 或引用	`0,0,0,0`（全屏）	可选	限定搜索区域
范围偏移	`w1,h1,w2,h2`	不偏移	可选	调整范围四边