1. 打样配色方案试改
印染厂、面料商拿到客户打样图（5～8 色常见），需要在 不换花型、不重绘 的情况下，快速试「把 A 色换成 B 色」的效果，供业务或客户确认。
2. 客户沟通与选色确认
业务员带着 U 盘便携版 到客户现场，打开样图 → 识别主色 → 逐色改色 → 左右对比预览 → 导出给客户看，减少「口头描述颜色」的误差。
3. 拍照样卡的色差修正
样卡、布样、纸质稿 用手机或相机拍摄 后，往往有光照、白平衡带来的微小色差。软件提供 「拍照色差合并」，把相近色归为一簇，改色时整簇一起变，避免花型边缘出现杂色块。
4. 多色花型快速换色（≤20 色）
花型通常由若干 大面积色块 组成。软件按 面积从大到小 列出主色，支持 一一对应映射（改前 → 改后），适合分色稿、平网/圆网印花稿这类 色块清晰 的图。
5. 内部打样 / 跟单协作
跟单、设计、调色之间传递「改色效果图」，导出 PNG/JPG 等，保持原图尺寸与清晰度，便于微信、邮件、ERP 附件流转，无需专业 PS 技能。
面向纺织印染打样场景，在 不改变花型结构 的前提下，对样图中的主色块进行识别、映射和替换，并实时预览改色效果。
1. 打开与导出
支持打开：PNG、JPG、BMP、WEBP、TIFF 等常见图片格式
支持保存：PNG（推荐无损）、JPG、TIFF、BMP
导出保持原图尺寸与清晰度，适合存档、发客户、内部流转
支持 拖拽/命令行传入图片路径 直接打开
2. 智能颜色识别
自动分析图片中的 主要颜色
可设置 颜色数量（1～20 种），相近色会自动合并
颜色列表 按面积从大到小排列，主色优先显示
显示每种颜色的 色块、HEX、RGB、面积占比
3. 颜色一一对应替换
每种识别出的颜色可单独设置 「改后颜色」
点击色块或「选色」按钮，用系统调色板选目标色
支持 「还原」 单行颜色，或 「重置映射」 恢复全部
改色时 整簇相近色一起变化，避免边缘出现杂色
4. 拍照色差处理
「拍照色差合并」 滑块：值越大，越能把拍照、扫描产生的微小色差归为一类
适合 手机拍样卡、纸质稿、布样 等不够标准的输入图
减少因光照、白平衡导致的 色块碎裂、改色不干净 问题
5. 背景过滤（可选）
忽略纯黑背景 / 忽略纯白背景
识别与改色时跳过背景区域，专注花型主体颜色
6. 双栏实时预览
左侧 原图预览 与 改色后预览 并排对比
修改目标色后 即时更新 效果，无需反复导出查看
预览自动缩放，大图也能流畅浏览
语言：Python 3.10+；GUI Tkinter + ttk；
难点 1：PyInstaller + NumPy 启动崩溃
现象： exe 报 Importing the numpy C-extensions failed
原因： Pillow 钩子会带入 NumPy，C 扩展在单文件 exe 里加载失败
应对：
算法改为纯 Pillow 像素遍历
ColorReplacer.spec 中 excludes=['numpy']
重新打包验证启动
难点 2：拍照色差导致「一种颜色变很多种」
现象： 同一色块因光照、JPEG 压缩被识别成大量相近色
应对：
软量化：RGB 按 step 取整，合并微差
用户指定颜色数：如指定 5 色，贪心合并到 5 簇
「拍照色差合并」滑块：用户可调合并强度
难点 3：指定数量外的颜色改不完整
现象： 列表只显示 5 个代表色，但图中还有未归入的相近色，改色时只改一部分
应对：
合并后 全图重算簇归属（recalculate_cluster_counts）
替换时用 最近簇索引（nearest_cluster_index），不是容差匹配
改某一簇 → 该簇内所有像素（含拍照变体）一起变
难点 4：大面积黑色背景识别不到
现象： 红底黑纹图，黑色占比大却不在列表里
原因： 早期默认 ignore_near_black=True，RGB ≤ 15 的像素被过滤
应对：
默认改为 不忽略 黑/白
增加可选「忽略纯黑背景 / 忽略纯白背景」
黑纹图建议颜色数设为 2～3
亮点:两层架构 + 簇模型：UI 与算法解耦，按簇改色而非单像素容差
软量化 + 贪心归并：针对拍照色差和指定 N 色的业务需求定制
零 NumPy 打包方案：解决 PyInstaller 兼容并控制体积
原图基准 + 高质量导出：预览缩放不影响输出清
评论