EasyClick 入门指南（十二）：图色工具面板全解 —— 从“像素眼”到“代码生成器”
专栏：《EasyClick 自动化测试从入门到实战》
适用：Android / iOS 7.1.0+ / 鸿蒙 Next
核心痛点：为什么明明看着一样，脚本却找不到图？为什么 OCR 识别慢且不准？
前言：图色工具不是“取色器”，而是“参数工厂”
很多新手把图色工具当成单纯的截图工具，这是巨大的浪费。本期将深度解析图色工具的三大核心模块——找色、找图、OCR，并重点讲解如何利用代码生成功能，把“玄学调参”变成“科学配置”。
一、面板总览：三大区域的分工
| 区域 | 名称 | 核心职责 |
|---|---|---|
| 左侧 | 弹药库 | 管理图片历史列表 |
| 中间 | 作战地图 | 实时预览、取色、框选范围、手势操作 |
| 右侧 | 控制台 | 找色/找图/OCR 参数配置与代码生成 |
二、核心交互：你必须掌握的“肌肉记忆”
在操作具体功能前，先掌握中间预览区的三个核心手势，这是效率的源泉：
| 手势 | 动作 | 结果 |
|---|---|---|
| Hover + 空格 | 悬停后按空格 | 吸取当前像素颜色 → 填充到找色面板 |
| Ctrl + 左键拖拽 | 按住 Ctrl 拉框 | 截取区域为新图片 → 填充到找图面板 |
| 右键拖拽 | 右键拉框 | 定义搜索范围 → 自动填充 Left/Top/Right/Bottom |
三、找色模块：像素级的精准打击
1. 界面功能拆解
当前面板处于
findColor（或 findMultiColor）模式。
- 颜色列表 (1-8) ：支持多颜色点查找（用于渐变色或复杂纹理）。
- 偏色 (
#101010) ：防检测关键。允许颜色在一定范围内波动（如暗红/亮红）。 - 精度 (0.9) ：相似度阈值，越高越严格。
- 方向：扫描顺序，默认即可。
- 范围 (0,0,0,0) ：性能瓶颈。务必使用右键拖拽重新定义，避免全屏扫描。
2. 实战流程
- 吸色：鼠标移到目标点，按 空格。
- 限范围：在预览区右键拖拽画框。
- 调偏色：根据目标特性微调
#101010（静态色小，动态色大）。 - 测试：点击 【本图测试】 看红框是否命中。
- 生成：点击 【生成代码】 ，直接复制 JS 代码。
四、找图模块：特征匹配的进阶玩法
1. 核心算法选择
-
findImgByColor(按颜色找图) ：推荐首选。不仅比灰度快，且抗形变、抗半透明。- 强阈值 (0.8) ：主体匹配度。
- 弱阈值 (0.7) ：边缘容错度。
- 金字塔层级 (-1) ：自动缩放，保持 -1 即可。
-
findImage(传统灰度) ：仅在纯黑白图标且无透明度时使用。
2. 模板图处理（右键菜单黑科技）
在右侧小图上右键，你会看到关键功能：
- 涂色/一键涂色：去除背景杂色（如把白色背景涂黑），大幅提升匹配率。
- 透明找图：自动忽略四角色（PNG 透明通道）。
- 转换找图为找色：当图片极不稳定时，提取其主色调转为“找色”逻辑。
3. 避坑指南
| 问题 | 解决方案 |
|---|---|
| 明明一样却找不到 | 勾选 【透明找图】 或 【涂色】 |
| 找图速度慢 | 缩小范围（右键拖框），不要用全屏 |
| 分辨率不同导致失败 | 使用 findImgByColor，它对缩放更鲁棒 |
五、OCR 模块：文字识别的模型选型（重点🔥）
这是本期最重要的更新点。OCR 下拉菜单有多个选项，选型直接决定成败。
1. 模型选型对照表（官方推荐）
| 模型选项 | 推荐指数 | 适用场景 | 特点 |
|---|---|---|---|
**paddleOcrOnnxV5** | ⭐⭐⭐⭐⭐ 首选 | 绝大多数 UI、数字、汉字 | 最精准、速度最快，CPU 占用低 |
**paddleOcrOnnxV4** | ⭐⭐⭐ | V5 初始化失败时的兜底 | 兼容性稍好，精度略逊于 V5 |
**ocrlite** | ⭐⭐ | 老旧设备/低端芯片 | 兼容性最好,速度慢 |
| 百度/Tesseract | ⭐ | 特殊定制需求 | 速度慢，依赖网络或环境 |
无脑选 V5。只有当 V5 在你的设备上找不到时，才降级到 V4。
2. OCR 参数调优
- Padding (留白) ：建议
10。给文字周围留空间，防止边缘被切割。 - maxSideLen (缩放) ：建议
640。限制最长边，加速识别。 - boxScoreThresh (框置信度) ：建议
0.5。低于此值的文字框将被丢弃。
3. 代码生成实战
- 在中间预览区右键拖框（限制文字区域，极重要！）。
- 选择
paddleOcrOnnxV5。 - 点击 【生成代码】 。
- 代码将包含
ocr.recognize或ocr.findRect，直接返回文字内容和坐标。
六、总结：图色工具的正确打开方式
- 手势优先：空格吸色，Ctrl 切图，右键画范围。
- 范围第一：90% 的找不到问题，都是因为没限制范围。
- 模型选 V5：OCR 就用最新的 Onnx V5，又快又准。
- 相信生成代码：不要手敲 API，用工具生成的代码作为基础进行修改。
