3. CV-X软件平台与验证工具链

CV-X 视觉系统的可靠性验证，不能只靠现场相机和控制器完成。真正决定验证效率与可追溯性的，是围绕 CV-X 控制器构建的软件工具链：CV-X Navigator 负责程序编辑与参数下发，模拟器负责离线复现与预验证，日志功能负责记录运行与判定过程，版本管理负责程序与参数的受控变更，而验证数据追溯则把“哪一次验证、用哪一版程序、得到什么结果”串成一条可回查的证据链。理解这五者的分工与衔接，是后续所有验证工作的基础。

CV-X Navigator：程序编辑与参数下发的中心

CV-X Navigator 是运行在 PC 上的工程软件，通过以太网或 USB 与 CV-X 控制器连接。它的核心作用不是“画界面”，而是把验证所需的检测逻辑结构化：相机取像条件、工具链（如边缘位置、面积、图案匹配、OCR）、判定阈值、I/O 输出映射、以及多品种切换用的程序号，都在 Navigator 中编辑并下载到控制器。

在可靠性验证中，Navigator 有两个特别值得利用的能力。第一是参数批量导出与导入：可以把某个程序的全部工具参数导出为文件，便于在验证前后做差异比对。第二是实时监控与测量值回读：在联机状态下，可以直接读取每个工具的当前测量值、判定结果和 NG 原因，这对定位“是取像问题还是阈值问题”非常关键。

模拟器：离线复现与预验证

CV-X 模拟器允许在没有控制器或没有实际产线的情况下，加载已保存的图像、程序与参数，复现检测过程。它的价值在于把验证从“占用产线”变成“可重复的离线实验”。典型用法是：把现场采集的一组 OK/NG 图像导入模拟器，批量运行同一程序，观察判定结果是否与预期一致。

模拟器验证时要注意一个边界：模拟器复现的是图像处理与判定逻辑，不能完全替代真实光照、镜头畸变、触发时序和 I/O 响应。因此合理的做法是“模拟器先筛，现场再确认”。例如先用 200 张历史图像在模拟器上跑一遍，若误判率明显偏高，就不必上产线；若模拟器结果稳定，再到现场做小批量实测。

日志功能：把运行过程变成可回查的数据

CV-X 控制器的日志功能通常可记录测量值、判定结果、程序号、时间戳、触发计数以及 NG 图像。验证时最忌讳只看“最终 OK/NG”，而应关注日志中的测量值分布。例如某边缘工具的判定下限为 9.80 mm，日志中若出现大量 9.82～9.85 mm 的临界值，即使当前判定为 OK，也说明过程能力不足，需要调整阈值或改善取像。

日志导出后建议按“程序号 + 时间窗 + 判定结果”三个维度筛选。对于 NG 记录，应同时保留对应图像，否则后续无法判断是真实缺陷还是误检。日志的采样频率和保存条数要在验证前确认，避免关键时段被覆盖。

版本管理与验证数据追溯方法

版本管理的核心是：任何一次验证结果，都必须能对应到唯一一版程序与参数。推荐采用“程序号 + 版本号 + 校验码”的三段式标识。每次修改工具参数、阈值或 I/O 映射后，版本号递增，并记录变更内容、变更人、变更时间和变更原因。

验证数据追溯则要求把以下要素绑定在一起：验证任务编号、程序版本、参数包文件、日志文件、NG 图像、验证结论。这样当客户或内部审核问“这批产品为什么判 OK”时，可以沿着“任务编号 → 程序版本 → 参数包 → 日志 → 图像”逐级回查。

一个可执行的验证数据追溯示例

假设某次验证任务编号为 V-20240612-01，程序号为 PRG01，版本号为 v1.3。验证前从 Navigator 导出参数包 PRG01_v1.3_params.csv，验证中从控制器导出日志 PRG01_v1.3_log_20240612.csv，并保留 12 张 NG 图像。验证结论为“误判率 0.5%，漏判率 0%，满足验收要求”。

当后续有人质疑该结论时，追溯路径是：先查任务编号 V-20240612-01，找到对应程序版本 v1.3，再调出参数包确认阈值设置，最后用日志和图像复现当时的判定过程。如果期间程序已升级到 v1.4，则必须明确说明 v1.3 的结论不能直接代表 v1.4，需要重新验证或做差异评估。

工具链协同的检查要点

• Navigator 与控制器一致性：下载后回读一次参数，确认与导出文件一致，避免“编辑了但没生效”。
• 模拟器图像来源可追溯：导入模拟器的图像应标注采集日期、产品批次和判定标签，不能使用来源不明的图片。
• 日志时间同步：控制器时间应与验证记录时间对齐，否则日志时间戳无法与现场事件对应。
• 版本号只增不减：任何参数改动都必须产生新版本号，禁止在原版本上直接覆盖修改。
• 追溯字段完整：任务编号、程序版本、参数包、日志、图像、结论六项缺一不可。