2. MERLIC项目交付物全景

在MERLIC项目验收与交付中，最容易出问题的往往不是视觉算法本身，而是“东西没交全”或“交的东西版本对不上”。一个可复现、可维护的MERLIC项目，交付物远不止一个.mvapp工程文件。本节把MERLIC项目交付物拆成六大类，并给出分类标准与命名规范，帮助你在项目启动阶段就建立交付物台账，而不是在验收前临时拼凑。

一、为什么MERLIC交付物需要分类

MERLIC工程文件（.mvapp）内部已经封装了图像源配置、工具链（Tool Chain）、参数集、结果输出与部分标定引用。但工程文件是“可执行体”，不是“可维护体”。当客户需要更换相机、调整标定、修改通信地址，或者三年后由另一位工程师接手时，仅有一个.mvapp是远远不够的。交付物分类的核心目的有三个：可复现（能在另一台机器上重建相同运行环境）、可追溯（每个参数和标定数据有来源和版本）、可运维（现场人员能按手册处理常见异常）。

因此，我们把交付物划分为：工程与配置类、标定与数据类、接口与集成类、文档类、培训类、运维类。这六类不是按文件格式划分，而是按“谁在什么阶段使用它”划分。

二、工程与配置类：可执行体的完整快照

工程与配置类交付物的核心是.mvapp文件，但仅有它不够。MERLIC的工程文件在保存时可以选择是否嵌入图像源配置和标定引用。如果选择“引用外部文件”，那么交付时必须同时提供被引用的配置文件，否则工程在另一台机器上打开会报“图像源不可用”或“标定文件缺失”。

建议的交付清单包括：主工程文件（命名如 ProjectName_v1.2.0_20250115.mvapp，版本号与日期必须体现在文件名中）、图像源配置文件（相机IP、曝光、增益、触发模式等）、工具链参数集导出文件（MERLIC支持将当前工具链的参数导出为独立文件，便于对比不同版本间的参数差异）、用户权限与配方文件（如果项目使用了MERLIC的用户管理和配方切换功能）。

这里有一个实操要点：MERLIC的工程文件本身不包含版本管理功能，因此必须依靠外部命名规范和版本变更记录来追溯。建议在项目启动时就建立deliverables/目录，按六类分子目录存放，每次交付前用脚本或手动核对清单。

三、标定与数据类：精度可复现的关键

标定数据是MERLIC项目中最容易被忽视、也最容易在验收时引发争议的部分。相机内参标定文件（通常为XML或JSON格式）记录了焦距、主点、畸变系数；手眼标定矩阵记录了相机坐标系与机器人/运动平台坐标系之间的变换关系。这些数据一旦丢失，重新标定需要停机数小时甚至数天。

交付时至少应包含：相机标定文件（含标定日期和标定板类型）、手眼标定矩阵文件（含标定方法和残差报告）、像素-物理坐标映射表（如果项目使用了MERLIC的“像素到世界坐标”转换工具）、标定原始图像与标定报告。标定报告应记录标定时的环境温度、镜头型号、标定板批次等元数据，因为这些因素会影响标定结果的可复现性。

四、接口与集成类：产线联调的契约

MERLIC项目通常需要与PLC、机器人或MES系统通信。接口与集成类交付物是“契约性”文件，定义了MERLIC与外部系统之间的数据交换格式和时序关系。核心交付物包括：PLC通信配置与地址表（明确每个输入/输出信号对应的PLC地址、数据类型、有效范围）、结果输出格式定义（如OK/NG判定、测量值、缺陷坐标等字段的格式和精度）、触发信号时序说明（从PLC发出触发信号到MERLIC返回结果的完整时序图，含超时阈值）、第三方系统对接文档（如与MES的数据库表结构或API接口说明）。

地址表建议用表格形式交付，字段至少包含：信号名称、方向（MERLIC→PLC或PLC→MERLIC）、PLC地址、数据类型、单位、有效范围、默认值、备注。这份表格在产线联调阶段是双方工程师的共同语言，在运维阶段则是排查通信故障的第一手资料。

五、文档类：验收与审计的依据

文档类交付物直接服务于验收。需求规格与验收标准应在项目启动阶段就与客户确认，并在验收时逐条核对。系统架构与数据流图应展示MERLIC在整条产线中的位置、图像数据从采集到输出的完整路径、以及与外部系统的交互关系。工具链逻辑说明应逐个工具解释其作用、关键参数和判定阈值，使非原开发人员也能理解工程逻辑。版本变更记录应记录每次修改的内容、原因、影响范围和验证结果。

文档类交付物的一个常见问题是“写得太晚”。建议在项目开发过程中同步维护，而不是验收前突击补写。MERLIC工程中的工具链注释和参数备注可以直接导出为文档初稿，减少重复劳动。

六、培训类与运维类：从交付到长期运行

培训类交付物包括操作员培训PPT、工程师进阶培训材料、培训签到与考核记录、常见操作视频。培训材料应区分“操作员”和“工程师”两个层级：操作员需要知道如何启动检测、如何处理报警、如何切换配方；工程师需要知道如何修改工具参数、如何重新标定、如何备份和恢复工程。

运维类交付物是项目长期稳定运行的保障。运维手册应包含故障树（从现象到原因的排查路径）、备份与恢复流程（备份频率、备份内容、恢复步骤）、备件与许可证清单（相机、镜头、光源、MERLIC许可证的型号和到期日）、维护周期与点检表（每日/每周/每月的点检项目）。

七、交付物清单模板

下表给出一个可直接使用的交付物核对清单模板。项目团队可根据实际项目增减条目，但六类框架建议保留。

使用这份清单时，建议在项目启动会上就与客户确认“接收人”和“核对方式”，并在每次交付后由双方签字确认。交付物不是一次性动作，而是贯穿项目始终的持续过程。把清单建好、版本管好、责任分好，验收时就不会因为“少了一个文件”而卡住。