完整視覺配方的版本管理與回滾

問題與前置條件

匯出的相機設定未必包含閾值、模型、校正或 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 現有的發布名稱，也不能證明所供應的系統實作了這套版本管理流程。

相關閱讀

選型前請先閱讀相關的選型與應用指南。如需工程評估，請提供樣品影像、所需達到的結果、運作條件以及已填寫完整的測試紀錄。