完整视觉配方的版本管理与回滚

问题与前置条件

导出的相机配置未必包含阈值、模型、标定或 PLC 映射。要定义出整套可复现的检测配置集，并弄清各厂商的导出功能实际保留了什么。

准备测试

本例假设：已验收的配方为 R10，候选配方为 R11，标定版本为 C4，应用程序版本为 2.0。准备一套冻结的样本集，其中含合格件、缺陷件和临界件；保留原始图像和预期判定。

在给配方编版本号之前，先界定发布的单元。凡是影响判定的内容都要纳入：设备标识及相关固件、采集设置、照明布置、检测逻辑或模型、标定、应用程序构建版本，以及 PLC 或机器人的映射。厂商的配置导出可能只覆盖其中一部分；要查看其文档所述的范围，不要假定它包含整个工位。用清单（manifest）把各个文件和物理设置关联起来，并在适当的地方使用稳定的标识符和完整性校验。最近一次验收通过的配置集要独立于候选版本，随时可以取回。文本配置尽量用 Git 做版本管理，较大的二进制制品则引用到有标识的受控存储位置；仅凭文件名不能证明其内容。

操作步骤

1. 归档当前生效的配置集，包括设备/固件标识、配置文件和内容校验和。
2. 说明每项拟议变更及其原因和依赖项，且不得改动已验收的归档。
3. 运行冻结的样本，并做时序和接口检查；记录结果发生变化的样本，而不是只记一个总分。
4. 评审通过后，把候选版本作为一个带标识的整体发布，并记录其启用时间。
5. 在受控的回滚试验中恢复 R10；恢复生产之前，先核实配置、标定和结果。

准备一套冻结的回放样本集，其预期判定的记录独立于候选算法。其中要包含来自约定应用范围的已知合格、已知不合格和临界样本，并保留它们的原始图像和标签。先运行 R10，建立经验收的对比基准，再运行 R11，期间不得改动回放证据。要记录发生变化的判定及其原因，而不是只记最后汇总的合格百分比。回放之后，在所记录的硬件和 C4 标定下，用实际工件重新采集图像，因为已存的图像无法检验当下的曝光、运动、物理安装或输出时序。凡是要调整模型的情况，训练或调参用的样本要与独立验证样本分开。不要为了迎合候选版本的新判定而悄悄修改预期标签来批准它。

测试记录示例

以下为示例性假设，并非 Deyi 的实测性能。请将这些数值替换为你自己经签字确认的测试记录。

只有在回放冻结测试集，并在所记录的 C4 标定和应用程序版本下运行实际工件之后，才可以升级到 R11。回放检验的是算法，无法证明当前的光学、时序或执行动作。回滚到 R10 时，恢复生产之前要核对校验和以及完整的当前生效清单。保留 R11 的失败案例和批准决定。文件加载成功，并不能证明先前验收通过的硬件和配置已经恢复。

建立一份发布记录，其中包含请求加载的清单、实际加载的清单以及观察到的当前生效配置。记下促成 R11 的具体参数差异及其支撑证据。导入成功只能证明导入操作已经完成，并不证明每台设备都应用了预期的设置。要用受支持的机制回读标识符，或检查实际生效的配置。回滚时，恢复 R10 的完整配置集，并在恢复生产之前重复执行已定义的参考检查。通过获批的状态转换清除待处理的结果，避免 R11 的事件被发布在 R10 名下。即使已经回退，也要保留失败候选版本的图像和评审记录，因为它们解释了为什么该版本没有发布。

流程的两种视图

故障排查

• 文件名正确，里面的数据也可能不同；要核对内容，不能只看时间戳。
• 恢复相机文件，无法找回丢失的模型，也解决不了应用程序版本不匹配的问题。
• 过期的标定会让本来没有改动的阈值失效。

验收与交接

只有当先前的完整配置集已恢复，并在当前运行约束内复现其约定结果时，回滚才算验收通过。即使候选版本被否决，也要保留它的证据。这里的版本标签并不对应 Deyi 实际发布的任何应用程序。

测试前先设定验收限值，并保留原始证据。此处的示例并不能说明所供型号具备相应能力。

验收应同时覆盖升级和回滚，并附一份经过独立评审的预期结果列表。验证合格与不合格的参考案例、实际采集、输出关联，以及启动时对已验收清单的恢复。如果某个组成部分无法自动导出或自动验证，就记录人工检查的做法和负责人，而不要声称可以完全自动复现。确认已存储的事件记录标明的是当时所用的配方、标定和应用程序版本，而不是当前恰好生效的版本。交接材料包括清单、制品引用、测试证据、批准决定和恢复说明。示例中的 R10/R11 和应用程序 2.0 等标签只是编辑用的标识符，既不是 Deyi 现有的发布名称，也不能证明所供系统实现了这套版本管理流程。

相关阅读

选型前请先阅读相关的选型与应用指南。如需工程评审，请提供样品图像、所需达到的结果、运行条件以及已填写完整的测试记录。