排查包装完整性的误判：沿可见性、掩膜、标签映射与 BOM 版本追查原因

对“误判完整”的现象分类

在改动阈值之前，先对现象分类：缺失的可见物品被报为完整；存在的可见物品被报为缺失；有歧义的观察被转入复核；执行失败；或判定被用在了错误的包装上。保留原始的参考内容物和完整图像。这些故障需要不同的解释，必须能够彼此区分。复核结果不等于已确认的漏装；一张空图像上看似有效的计数，也不能证明套件是完整的。要从一个可复现的失败案例和声明的可见内容物范围出发，而不是从一个为了让正常预览通过而改动的预期数量出发。

精确回放原始图像与套件版本

回放与该现象相关的原始图像、裁剪变换、前景或模型版本、BOM 标识和参考内容物，务必与当时完全一致。要核对实际安装的执行标识，而不是只看屏幕上的工作流名称。如果完全相同的冻结材料产生了不同的证据，应先检查自动预处理、未锁定版本的依赖项或请求关联，再考虑改动包装的光学条件。如果回放结果稳定，而新帧却有差异，接着对比采集条件和摆放条件。把完整的源帧与局部预览放在一起保留。回放成功只是缩小了排查范围；它并不能证明这一帧属于预定的包装事件，也不能证明所选的套件版本就是正确的生产配方。

区分被隐藏的内容物与观察到的缺失

检查在失败的那一帧中，盖片、包装膜、相邻物品或托盘壁是否遮住了必需的物体。保持参考内容物不变，在允许的基线摆放和受控的备选摆放下，比较同一个已标识的包装。如果物品只有在未经批准的情况下人工拿掉正常包装之后才变得可见，那么这项图像任务仍然超出了原有工位的范围。不能仅因为某个区域发暗，就宣布被隐藏的物体不存在。反过来，空腔位里的一处反光，也不能证明物品存在。在调整完整性规则之前，先保留实际的可见性局限，以及能把它与真正漏装区分开的对照。

区分被隐藏的物品与可见的空区域

被遮盖的物品和可观察的空区域，需要采用不同的证据处置方式。

完整的包装原始视图
声明的可见物品区域
盖片或包装膜的遮挡边界
有效的可见空区域对照

诊断用的可见性概念图；不推断被隐藏的内容物。

检查连通域与过滤的影响

把原始的前景连通域或检测器候选与原始图像并排检查。判断是接触使可见物品合并了、阴影把一个合法的连通域分裂了、托盘边缘混入了掩膜，还是重复检测使计数虚高。保留原有的标签映射和处理版本。开运算、闭运算、尺寸过滤和重复抑制，可能修复了前景的表示，却也去掉了一个很小的真实物品，或掩盖了一个多出来的物体。任何拟议的改动，都要在同一批完整、漏装和多装的参考上比较。不要只因为某个候选方案或过滤设置能给出想要的计数就选用它，而不记下哪些实际可见的物理证据仍然被表示出来。

failure_record = {
    'package_id': package_id,
    'kit_revision': kit_revision,
    'source_image_id': source_image_id,
    'graph_revision': graph_revision,
    'raw_item_evidence': raw_item_evidence,
    'visibility_state': visibility_state,
    'raw_bom_rule': raw_bom_rule,
    'execution_status': execution_status,
    'event_id': event_id,
}
# Preserve original failure and Review reasons; no implicit Pass or default empty inventory.

对照 BOM 约定核对标签

对照已冻结的套件定义，核对所配置标签的确切写法、区分大小写的含义、已知标签清单和预期数量。固定区域的标签并不能证明前景就是正确的物品类型；陌生的替代件可能同样满足几何上的观察，除非另有经过验证的识别能把它区分出来。在已审阅的 BOM 路径中，未知类别需要复核，而在预期条目中被省略的已知标签，则与零比较。保留这些分支，不要把不方便的检测结果改名成熟悉的标签。如果 BOM 版本发生了变化，要先在原有约定下评估原来的失败，再比较新的配方，免得把规格的变更误报成算法的改进。

追溯包装事件与配方标识

分别追溯包装标识、包装操作、源图像、流程图版本、套件版本、原始判定和接收端确认。缓存中可能仍留着上一个完整包装的结果，而当前包装却没有新的有效图像。在隔离环境中模拟延迟、缺失和被取消的结果，并保留它们所声明的未通过状态。检查配方的选择在采集与规则评估之间是否发生变化。拿另一个套件作为标准评估出来的正确计数，不是正确的完整性结果。要让执行错误和复核原因保持可见，也不要推断离线的工作流回放已经证明了实际的输送线时序或控制器动作。

维护包装诊断记录表

每个原始失败用记录表的一行，记下包装与事件标识、独立的参考内容物、完整图像、裁剪坐标、采集设置、流程图与运行环境标识、原始物品证据、可见性、BOM 约定和疑似成因。加上能区分各种解释的对照，以及能够推翻该解释的观察。把基线与候选的输出，连同尚未解决的情形，放在一起保留。这张表把可见性、表示、规格和事件四类对照区分开，不提供适用于所有场合的阈值。让复核和执行失败留在计划的分母之内。另一位工程师应当能够分辨：一项有依据的修正，和一种靠排除被遮盖包装或悄悄更改套件清单而得到的表面改善。

包装完整性故障的诊断对照
失败特征	鉴别对照	留存的证据
被隐藏的物品被报为缺失	同一包装，允许的摆放变化	完整图像与可见性边界
掩膜处理后计数发生变化	前后使用相同的原图与参考	原始连通域与处理版本
错误的内容物仍与预期标签吻合	核查区域标识的局限与冻结的 BOM	物品参考、标签映射与套件版本
当前包装显示的是上一次的完整结果	在隔离环境中注入延迟或缺失的响应	包装、图像、配方与事件标识

在独立包装上验证修正

先在冻结的开发组上验证拟议的修正，之后再在事先商定验收限值的独立包装上验证。确认真正的漏装和多放的可见物体仍然可以区分，并确认原先的失败没有只是变成了一次未上报的复核，或一帧旧的、已通过的画面。冻结修正后的光学条件、流程图、BOM 和事件映射，同时保留原有的基线。如果必需的内容物仍然被隐藏，或其标识未获证实，就保持这一边界，并采用另一种观察或清点控制。Deyi Vision 可以协助开展受支持的工作流诊断，但本流程并不认证当前运行环境的软件包、实际相机，也不认证生产环境下的完整性准确率。

修正真正出问题的那一层证据

在测试有针对性的修正之前，先保留原有的配方和失败现场。

冻结失败图像与套件约定
说明光学、表示或事件方面的成因
执行匹配的诊断对照
验证修正，或保留未解决的局限

建议的排查步骤顺序，不是已报告的工厂试验。

来源与技术参考资料

这些资料说明了本教程所用方法的依据与适用范围。文中的检查示例仅供参考；量产验收需要用你自己的样品取得证据。

Image ThresholdingOpenCV核查于 2026年10月11日
Morphological TransformationsOpenCV核查于 2026年10月11日
Deyi Vision Vision WorkbenchDeyi Vision核查于 2026年10月11日

对“误判完整”的现象分类

精确回放原始图像与套件版本

区分被隐藏的内容物与观察到的缺失

区分被隐藏的物品与可见的空区域

检查连通域与过滤的影响

对照 BOM 约定核对标签

追溯包装事件与配方标识

维护包装诊断记录表

在独立包装上验证修正

修正真正出问题的那一层证据

来源与技术参考资料

部件与选型参考

继续排查

为可见装配检查设置相机

为可见装配检查选择照明与 ROI

把检测问题和证据一起发过来。