packfix

packfix 是一款工具，用于验证 AI 生成的商品图是否保留了真实包装，并在没有保留时修复图像。它要解决的问题是：图像模型能令人信服地再现姿态、光照和阴影，但可能会细微改动重量标识、认证圆标或接缝处细小文字等小字印刷。该工具用定量得分取代主观的目视检查。

系统由两个独立组件构成。第一个 fidelity.py 衡量生成画面中的印刷图案是否对应真实包装。它在真实包装版面上提取 SIFT 特征，与生成画面匹配，用 RANSAC 求解单应性变换，并以内点数作为得分。得分高于阈值表示确实对应；低于阈值则说明模型凭空编造了印刷内容，应重新生成该画面。第二个组件 packfix.py 修复场景正确但印刷发生偏移的画面。它把真实包装变形到单应性变换找到的四边形中，并把生成包装的低频明暗转移到真实图案上，使真实印刷处在场景的光照之下。alpha 通道经过腐蚀和羽化，以保留生成袋子的边缘和接触阴影。

仓库还包括 export.py（在字节上限下按精确像素尺寸裁切适配）、qa.py（以代码形式运行交付清单）和 cost.py（根据实际 token 数计算运行费用）。版面图由用户提供；仓库不含任何包装图案。该项目采用 MIT 许可证。