排查包裝完整性的誤判：沿可見性、遮罩、標籤對映與 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

把檢測問題與佐證資料一併寄來。