跳到主要内容

屏幕找图/找色/找字

在屏幕、窗口或图片中查找指定图片、颜色或文字，返回匹配点坐标。常用来定位按钮、菜单后再点。

当前模块定义​

概述​

例如要点一个按钮：先把按钮截成 png，再用本模块在屏幕上搜，得到坐标。鼠标输入 里也有「移动到位图位置」，找到后会直接点，但不返回坐标。本模块只回报位置，不点击。

官网 2.1.25 与 2.1.26 记录中，本模块的查找范围新增并继续完善了 指定窗口 和 指定图片：前者适合在被遮挡的目标窗口中查找，后者适合在本地图片里查找，不必先把内容显示到屏幕上。当前仓库的 data/xaction 还没有同步这两个选项的枚举值和后续参数 Key，因此本页只说明能力，不写参数 Key、示例值或可导入的配置片段。

升级注意：如果你在 2.1.25 里已经把查找范围设为 指定图片，升级到 2.1.26 后请重新打开该步骤编辑并保存一次，让目标图片设置按新版格式更新。

参数说明​

类型：

  • 查找图片(文件)
  • 查找图片(变量)
  • 查找颜色
  • 查找文字

位图路径：仅查找图片(文件)。完整路径。可多行，按顺序试，命中一个就停。截图请存 png / bmp，不要用 jpg（有损压缩对不上）。截的时候别把鼠标停在目标上，避免悬浮变色。

位图变量：仅查找图片(变量)。事先用截图或读文件加载。

颜色：仅查找颜色。如 #FF0000。

文字：仅查找文字。可多行写多组，命中任意一组即可。

查找范围：主屏幕、当前窗口、坐标范围、所有屏幕。2.1.25 起还可选择 指定窗口 或 指定图片；2.1.26 起，指定图片的目标可来自图片路径或图片变量，指定窗口可选择返回窗口相对坐标。这两个选项的具体参数以当前 Quicker 编辑器和官网版本记录为准。注意 当前窗口 是动作运行时的当前前台窗口，不等同于新增的 指定窗口。

查找坐标范围：查找范围为「坐标范围」时填写，格式 left,top,right,bottom，例如 0,0,800,600。

定位位置：仅找图。返回点相对位图的位置（下图红点）：位图中间、左上角、右上角、左下角、右下角。

X偏移 / Y偏移：在定位点上再平移。正值向右、向下。

颜色容差：仅找图、找色。每个颜色通道允许的偏差 0–100。0 是精确匹配，也最快。默认 10。

匹配方式：仅找图。默认的「颜色容差（快速）」与旧动作行为一致，要求每个像素的各颜色通道都在容差内；「相似度」按整张图片的总体差异评分，能容忍少量抗锯齿、渲染或压缩差异。

最低相似度：仅在相似度匹配时使用，范围 0–100，默认 90。数值越高，要求越接近原图。先从 90 开始；误匹配时提高，漏匹配时小幅降低。相似度模式不使用「颜色容差」。

最大匹配：仅找图。最多找几个匹配，默认 1，超过 1000 会按 1000 处理。只需要第一个位置时保持 1，可以减少扫描和排序开销。

重试次数：找不到时再试几次，每次间隔 300ms。

跳过WindowsOCR引擎：仅找字。旧稿未写。

忽略背景色：仅找图。查找图四个顶点颜色一样时，把这种颜色当背景忽略。默认开启。旧稿未写。

失败后中止动作：找不到是否停止后续步骤。默认开启。

输出​

  • 是否成功：是否至少找到一处。
  • 第一个匹配点：从左上往右、往下的第一处，格式 x,y。
  • 匹配序号：从多张图或多组文字里查找时，命中的是第几组，从 0 起。仅找图(文件)、找字。旧稿未写。
  • 所有匹配点：全部匹配点列表。找色没有这项。
  • 最佳相似度：最佳成功匹配的评分，范围 0–100；颜色容差模式成功时为 100，未找到时为 0。仅找图。

查找范围为 指定窗口 时，2.1.26 起可在步骤设置中选择是否返回窗口相对坐标。需要把结果交给窗口内部处理、或窗口可能移动时，优先考虑窗口相对坐标；需要直接移动系统鼠标时，仍要确认后续步骤期望的是屏幕坐标还是窗口坐标。

找图失败时​

截图和屏幕不一致：

  • 截的时候鼠标造成了悬浮态。先把鼠标移开，开始截图后再框目标。
  • 分辨率、软件版本或界面变了。保持环境一致，关掉会动态改色的工具。
  • 窗口没对齐到整像素，边缘会有轻微差。
  • 存成了 jpg。改存 png。

目标图尽量小，只要能认出特征：

还不稳时先按问题选择调整方式：轻微颜色变化可增大颜色容差；抗锯齿、缩放渲染或压缩造成的整体小差异可改用相似度模式，并从 90 附近小幅调整。不要直接把阈值降得很低，否则更容易误命中，扫描也可能变慢。目标还没出现时，前面加等待，或加大重试、放进循环。

若开启「忽略背景色」，而模板图片四角同色且整张图都被判定为背景，步骤会直接失败。此时关闭该选项，或重新截取包含明显前景特征的小图。

社区增强版子程序（容错更高）：

子程序找图增强版社区分享的找图子程序，容错更高。Cesaryuan

屏幕找色​

在屏幕或窗口里找指定颜色第一次出现的位置。

把「第一个匹配点」交给鼠标输入，移动并点击：

屏幕找字​

按从上到下、从左到右，找指定文字第一次出现的位置。引擎是 Windows 内置 OCR + 基础OCR。面向专业版；免费版能用，但半速。

使用条件：

  • Windows OCR 需要 Windows 10 / 11，并在系统设置里至少装中、英两种语言包。

  • 离线 OCR 只要 64 位系统，CPU 支持 AVX。

注意：目标区域里不要有多处相近文字，必要时用坐标范围收窄；少用标点、空格，OCR 容易认错；找字本身有一定失败率。

示例动作​

动作屏幕找字示例演示Quicker屏幕找字功能CL

相关链接​

鼠标输入移到匹配点并点击；也可直接「移动到位图位置」。屏幕截图截出要查找的小图。基础OCR找字用的离线识别引擎。

更新历史​

  • 2.1.26：指定图片目标支持图片路径或图片变量；指定窗口可选择返回窗口相对坐标。2.1.25 中已使用指定图片的动作升级后需要重新打开步骤编辑一次。
  • 2.1.25：查找范围新增指定窗口、指定图片。当前结构化模块数据尚未同步对应参数。
  • 2.1.19：找图新增相似度匹配、最低相似度和最佳相似度输出。
  • 1.1.4：增加此模块。
  • 1.23.4：增加找色。
  • 1.38.1：增加找字。

更新于