feat: add low contrast visibility analysis

src/core/models.py

@@ -94,6 +94,14 @@ class BatchMode(str, Enum):
     FULL_COMBO = "full_combo"         # 全组合（矩阵）
 
 
+class VisibilityStatus(str, Enum):
+    """衣服目标区域与印花的可见度状态。"""
+    NORMAL = "正常"
+    LOW = "偏低"
+    UNCLEAR = "不明显"
+    UNKNOWN = "无法判断"
+
+
 @dataclass
 class BatchOptions:
     """批量任务配置。"""
@@ -101,6 +109,16 @@ class BatchOptions:
     export_options: ExportOptions = field(default_factory=ExportOptions)
 
 
+@dataclass
+class VisibilityResult:
+    """衣服目标区域与印花颜色对比分析结果。"""
+    status: VisibilityStatus
+    score: float = 0.0
+    rgb_distance: float = 0.0
+    brightness_difference: float = 0.0
+    error: str = ""
+
+
 # ---------------------------------------------------------------------------
 # 合成结果
 # ---------------------------------------------------------------------------
@@ -113,6 +131,7 @@ class ComposeResult:
     print_path: Optional[Path] = None
     output_path: Optional[Path] = None   # 成功时有效
     error: str = ""                       # 失败时的错误说明
+    visibility: Optional[VisibilityResult] = None
 
 
 @dataclass