packfix

packfix 是一款工具，用於驗證 AI 生成的商品圖是否保留了真實包裝，並在沒有保留時修復影像。它要解決的問題是：影像模型能令人信服地再現姿態、光照和陰影，但可能會細微改動重量標識、認證圓標或接縫處細小文字等小字印刷。該工具用定量得分取代主觀的目視檢查。

系統由兩個獨立元件構成。第一個 fidelity.py 衡量生成畫面中的印刷圖案是否對應真實包裝。它在真實包裝版面上提取 SIFT 特徵，與生成畫面匹配，用 RANSAC 求解單應性變換，並以內點數作為得分。得分高於閾值表示確實對應；低於閾值則說明模型憑空編造了印刷內容，應重新生成該畫面。第二個元件 packfix.py 修復場景正確但印刷發生偏移的畫面。它把真實包裝變形到單應性變換找到的四邊形中，並把生成包裝的低頻明暗轉移到真實圖案上，使真實印刷處在場景的光照之下。alpha 通道經過腐蝕和羽化，以保留生成袋子的邊緣和接觸陰影。

倉庫還包括 export.py（在位元組上限下按精確畫素尺寸裁切適配）、qa.py（以程式碼形式執行交付清單）和 cost.py（根據實際 token 數計算執行費用）。版面圖由使用者提供；倉庫不含任何包裝圖案。該專案採用 MIT 許可證。