3D近距离特征物查找¶

用途¶

此节点在 3D 画面中查找图像模板、OCR 文字或识图类 ONNX 模型目标。找到后按配置对准目标、前进或原地等待终止条件，再执行 PC 或安卓的结束后操作。校准信息可连接通用游戏组件。

Shift+A → 宏 → 3D近距离特征物查找

节点先识别当前画面，再按查找模式继续搜索；找到后按配置对准目标、完成终止判定和结束后操作。普通搜索失败、对准失败或条件超时输出 完成 = false；完成全部要求时输出 true，两种结果都沿执行输出继续。取消、参数及资源错误仍按错误处理。

“每次识别前点击扫描键”开启时，两种查找模式都会先点击指定位置再截图。

端口	类型	必填	说明
执行输入	执行	是	开始搜索。
ADB	字符串	与桌面二选一	Android 目标地址。
桌面	字符串	与 ADB 二选一	桌面目标描述；固定前进使用 PC 前台游戏模式，后台消息模式不支持固定前进。
OCR 文本	字符串	OCR 模式必填	有效连接值优先于节点属性。
组件目标组	数组	否	组件目标描述字符串数组，提供校准基础，可连接通用游戏组件输出。

端口	类型	说明
执行输出	执行	搜索成功或业务失败后继续。
完成	布尔	是否完成查找、对准、终止判定与所配置的结束后操作。

双击节点进入“屏幕预览”和“查找与操作选项”。

属性	默认值	说明
目标类型	目标图像	可选图像、OCR 或识图模型。
目标模板 / OCR / 模型	未设置或内置模型	对应模式的识别依据；模型可按类别标签或 `class_id`过滤，留空表示全部。
查找区域	全屏	在预览中拖动；识别只分析该区域。
匹配/置信阈值	0.65	图像/OCR 使用匹配阈值，模型使用置信阈值。
扫描键前置	关闭	每次识别前点击一次可拖动位置。

模型模式会先按类别和置信度过滤，再选取同帧中离屏幕中心最近的目标。

模式	主要属性	行为
视角模式	共同起点、水平/垂直方向与最大长度、横向次数 2、竖向次数 3	先原地识别，再按多行扫描顺序拖动视角。
快速查找	开关，默认关闭	固定横向满距离拖动 4 次，不做垂直扫描，并忽略次数属性。
固定位移	轮盘中心、前进半径、理想最短识别间隔 0 秒	安卓使用轮盘前进，PC 前台游戏模式使用配置的前进键；识别请求串行执行。

理想最短识别间隔为 0 时，上一轮识别完成后立即开始下一轮；大于 0 时，它是两轮识别开始时间的最短间隔。实际频率还受截图和识别耗时影响，不会为追赶设定间隔堆积并发请求。前进脉冲的松开间隔为 0.1 秒，与识别间隔独立。

固定位移还可要求目标框与查找区域的交集面积达到指定比例，默认面积门槛关闭，预设比例为 5%。

“前进”可按需勾选。关闭后仍先查找并对准，再原地等待终止判定。

终止条件	行为
满足原识别条件	按识别间隔复查，在判定超时内满足条件后继续。
前进指定秒数 / 等待指定秒数	开启前进时按设定时长前进，到时松开；关闭时原地等待该时长。
独立结束条件出现	使用另外配置的图像或 OCR 条件；关闭前进时原地复查，开启时找到并对准后前进，条件命中后先停止前进。

指定时长和条件判定超时均支持 0.2–120 秒。条件超时返回失败，不执行结束后操作。PC 后台消息模式不支持固定前进。

“是否使用慢走”默认关闭。勾选后，前进按通用游戏组件的原生慢走和短按补位配置执行；桌面与安卓分别使用对应平台的设置。

属性	默认值	说明
移到屏幕中心	关闭	反复微调视角，直到目标中心进入圆形容差区。
中心容差	屏幕长边 15%	圆形容差区的半径，可调 0.1%–50%。
最大居中修正次数	15	范围 1–15。
结束后操作	按配置	PC 可选无操作、按键操作或目标点击；安卓可选无操作或目标触摸。

居中检查使用目标框中心到画面中心的直线距离。默认 0.15 在 1920×1080 画面上对应半径 288 像素。若某个蓝图按交互要求单独设置为 0.0625，同一画面上对应 120 像素；这是该蓝图的作者参数示例，软件默认仍为 0.15。

“无操作”不会点击或按键，仍须完成此前的查找、对准与终止判定。

开始 → 3D近距离特征物查找 → 分支

选择目标图像，导入模板，连接 ADB 地址并用默认视角模式搜索；根据 完成分别进入交互或失败恢复路线。