验证图片相似度>90%

验证图片相似度>90% 用于比较待测图片与目标图片的相似度是否超过 90%，并输出验证结果（true 或 false）。它常用于 UI 视觉回归测试、截图验证和界面一致性检查。

指令标识：MobileVerifyImageSimilarity
指令类型：移动端指令
指令描述：验证特定图片在手机当前屏幕的相似度是否超过指定阈值，输出验证结果（True 或 False）

先选使用方式

工作流支持「可视化编排」和「代码编排」两种创建方式。验证图片相似度>90% 在两种方式里都能用，核心业务参数一致，区别主要是你通过界面配置，还是通过 Python 脚本配置。

方式	怎么用	适合人群
可视化编排（推荐先学）	拖入「验证图片相似度>90%」节点，填写待测与目标图片地址、设置输出变量	大多数用户，零代码，适合快速搭建和调试
代码编排（Python）	在脚本中调用 `result = bots.mobileVerifyImageSimilarity(assertFile="...", targetFile="...", outKey="result")`	熟悉代码、需要复用脚本或批量生成流程的用户

第一次使用建议先用可视化编排跑通，再迁移到 Python 代码编排。下方「参数说明」同时给出界面字段和代码参数名，方便两种方式对应。

什么时候用？

对比不同版本的 UI 界面截图，验证是否发生非预期变化。
验证当前屏幕截图与基准图的相似度，确认页面显示正确。
检查不同设备或环境下的界面显示是否一致。
验证图标或按钮样式是否与设计稿一致。

使用前确认

待测图片与目标图片的 S3 地址都已准备好且可访问。
建议两张图片尺寸一致，尺寸不一致可能影响相似度计算。
相似度阈值固定为 90%，无法自定义。
该指令为验证类，默认失败处理为「输出结果」（OUTPUT_RESULT），即验证不通过也继续流程；可改为「抛出异常」中断流程。

可视化编排：从 0 到跑通

准备好待测图片与目标图片的 S3 地址。
在工作流画布中添加 验证图片相似度>90% 节点。
在 测试文件的 S3 地址、目标文件的 S3 地址 中分别填写两张图片地址。
在 将结果保存至 中填写变量名，例如 result。
如需在不通过时中断流程，将 False 结果处理 设为 THROW_EXCEPTION。
运行后查看输出结果是 true 还是 false。

【图片占位 | command-mobileverifyimagesimilarity-config】 建议放一张配置截图：右侧属性面板展示「测试文件的 S3 地址」「目标文件的 S3 地址」「False 结果处理」「将结果保存至」。图片用于说明需要提供两张图片地址并指定输出变量。

参数说明

输入参数

界面名称	代码属性名	类型	必填	默认值	说明
测试文件的 S3 地址	`assertFile`	String	是	-	待测图片的 S3 地址。
目标文件的 S3 地址	`targetFile`	String	是	-	目标（基准）图片的 S3 地址。
False 结果处理	`falseResultHandling`	Enum	否	`OUTPUT_RESULT`	高级参数。验证结果为 False 时的行为：`OUTPUT_RESULT`（输出结果继续流程）、`THROW_EXCEPTION`（抛出异常中断流程）。
是否发送消息	`sendMsgFlag`	Boolean	否	`true`	是否发送通知消息。

输出参数

界面名称	代码属性名	类型	必填	说明
将结果保存至	`outKey`	Boolean	是	输出验证结果：相似度 `>90%` 返回 `true`，否则返回 `false`。

成功标准

节点正常执行并输出布尔结果。
相似度 >90% 时输出 true，符合预期。
后续节点能基于输出结果进行分支判断。

【图片占位 | command-mobileverifyimagesimilarity-success】 建议放一张运行成功截图：节点为成功状态，变量面板展示 result=true。图片用于说明如何确认验证结果。

失败排查

现象	可能原因	处理建议
输出始终为 `false`	两张图片差异较大或尺寸不一致	确认基准图正确，建议两张图尺寸一致再对比
节点报错	图片地址无效或无法访问	确认 `assertFile`、`targetFile` 为有效 S3 地址且网络可访问
验证不通过却中断了流程	`falseResultHandling` 设为 `THROW_EXCEPTION`	若希望继续执行，改为 `OUTPUT_RESULT`
对比结果不稳定	使用了有损图片格式	建议使用无损格式（`PNG`）以获得更准确的对比结果

Python 代码编排

代码编排以 Python 为主。运行上下文由代码编排模板创建，示例里只需要关注业务指令本身。

# 比较待测图片与目标图片相似度，返回值即布尔结果
result = bots.mobileVerifyImageSimilarity(
    assertFile="待测图片的S3地址",
    targetFile="目标图片的S3地址",
    falseResultHandling="OUTPUT_RESULT",
    outKey="result",
)
print(result)

如果你想在工作流中通过节点动态编排指令，可使用执行指令（XML）节点。

常见问题

Q1：哪些参数是必填的？

A： assertFile、targetFile 和 outKey 三个参数都是必填的。

Q2：相似度阈值是多少？

A：相似度阈值固定为 90%，返回 true 表示相似度 >90%，返回 false 表示相似度 ≤90%。

Q3：支持哪些图片格式？

A：支持常见的图片格式（如 PNG、JPG、JPEG 等），建议使用无损格式（PNG）以获得更准确的对比结果。

Q4：文件路径有什么要求？

A： assertFile 和 targetFile 必须是有效的 S3 地址，确保文件存在且可访问。建议两张图片尺寸一致，并确保网络可访问 S3 存储服务。

Q5：False 结果处理如何使用？

A：该参数控制验证失败时的执行行为（括号内为需传入的参数值）：

输出结果（OUTPUT_RESULT，默认）：验证失败时输出 false 结果到 outKey，继续执行后续流程。

抛出异常（THROW_EXCEPTION）：验证失败时抛出异常，中断当前流程执行。