4. 配方文件结构与参数体系

在 In-Sight 视觉系统中，一个“配方”并不是单一文件，而是一组围绕当前检测任务组织起来的参数集合。它既包含图像采集与作业层面的设置，也包含各视觉工具自身的参数、标定数据、通信映射关系、用户权限以及版本标识。理解配方内部的分层结构，是后续换型调试、备份迁移和版本回退的基础。如果只把配方当成“一个可以保存的文件”，在换型时很容易出现工具参数被覆盖、标定失效或通信地址错位等问题。

一、配方文件的整体分层

从工程视角看，In-Sight 配方可以理解为五个相互关联的参数域：作业参数、工具参数、标定数据、通信映射、权限与版本标识。它们并非彼此独立，而是存在明确的依赖方向。作业参数决定“在什么条件下采集图像”，工具参数决定“对图像做什么处理”，标定数据把像素坐标转换为物理坐标，通信映射把结果送到 PLC 或上位机，权限与版本标识则控制“谁能改、改的是哪一版”。

二、作业参数：图像输入的“前提条件”

作业参数位于配方最上游，它不参与图像内容判定，却直接决定工具能否稳定工作。典型字段包括曝光时间、增益、触发模式（内部/外部）、触发延时、光源输出强度、图像分辨率与采集超时。换型时若产品颜色或反光特性变化，曝光与增益往往需要同步调整；若产线节拍变化，触发延时和超时也要重新核算。

例如某次换型中，新产品为深色哑光表面，沿用旧配方时图像整体偏暗，定位工具评分从 0.92 降到 0.61。此时不应直接改工具阈值，而应先检查作业参数：将曝光从 3000 μs 提升到 5000 μs、增益从 1 倍调到 2 倍后，评分恢复到 0.90 以上，再微调工具参数才合理。这说明作业参数是工具参数生效的基础，顺序不能颠倒。

三、工具参数：检测逻辑的核心

工具参数是配方中数量最多、变化最频繁的部分。每个视觉工具都有自己的一组参数，例如定位工具包含 ROI 区域、模板、角度搜索范围、评分阈值；测量工具包含边缘极性、卡尺数量、滤波宽度、单位；检测工具包含灰度阈值、面积上下限、连通域数量等。

工具参数之间存在引用关系。定位工具输出的坐标和角度，通常作为后续测量工具、检测工具的输入坐标系。因此换型时若定位模板更换，所有依赖该定位结果的工具 ROI 都会随之偏移。正确做法是：先确认定位工具在新产品上稳定命中，再逐个检查下游工具的 ROI 是否仍覆盖目标特征，而不是一次性批量修改所有阈值。

四、标定数据：像素与物理量的桥梁

标定数据把图像像素坐标转换为毫米等物理单位。它通常包含像素当量（mm/pixel）、标定点坐标、旋转角度、原点偏移以及镜头畸变系数。标定数据一旦失效，所有以物理单位输出的测量结果都会产生系统性偏差。

换型时若相机、镜头、工作距离或安装角度未变，标定数据可以沿用；但只要相机位置、镜头焦距或视野发生任何变化，就必须重新标定。判断标定是否仍有效的简单方法：用标准件测量一个已知尺寸，若偏差超过公差的三分之一，应重新标定而不是靠修改工具参数补偿。

五、通信映射：结果如何被外部读取

通信映射定义 In-Sight 与 PLC、机器人或上位机之间的数据交换方式。常见内容包括：结果寄存器地址、触发信号地址、状态位、字符串格式、数值缩放系数以及心跳信号。换型时若检测项数量或结果顺序发生变化，通信映射必须同步更新，否则 PLC 读到的可能是上一版配方的结果。

一个实用的检查习惯是：换型后先在 In-Sight 软件内确认各工具输出值正确，再对照通信映射表逐项核对寄存器地址与数据类型，最后在 PLC 侧观察实际读到的数值是否与软件显示一致。三者一致，才算通信映射真正生效。

六、用户权限与版本标识

权限控制决定哪些角色可以修改配方。通常分为操作员、工程师、管理员三级：操作员只能切换配方和查看结果；工程师可以修改工具参数和作业参数；管理员才能修改标定、通信映射和权限设置。换型调试时若发现某些参数无法保存，应先确认当前登录角色是否具备对应权限。

版本标识则用于追溯。建议在配方名称中嵌入产品型号与版本号，例如 P-2201_A3_v2.1，并在备注中记录修改人、修改日期和变更内容。这样在出现批量误判时，可以快速回退到上一稳定版本，而不是靠记忆逐个参数恢复。

七、一份可参考的配方参数检查表