egotoadcitadel/palette-from-image-ai

AI coloring palette-from-image generator for designers and pixel artists — pull a clean named palette straight from any image, no subscription or cloud upload.

🎨 Palette‑From‑Image‑AI 是什么？

一款仅限 Windows 的便携式桌面程序，可将任何图片（照片、截图、游戏纹理、绘画等）转换为可立即使用的调色板。它使用离线推理，通过设备端视觉模型首先将图像分割为有意义的区域（天空、地面、主体等），然后使用感知距离度量（LAB 空间中的 CIEDE2000）对颜色进行聚类。结果是一个包含 5-16 个色板的小型有序集合，每个色板自动标记（基础、强调、阴影、高光），并可导出为 HEX、CSS 变量、Adobe ASE、GIMP GPL、JSON、PNG 色板表、SVG 等 12 种格式。

⚙️ 核心架构（如 README 中所述）

组件	作用
设备端视觉模型	对输入图像执行语义分割。
感知颜色量化器	使用 CIEDE2000（LAB）而非原始 RGB 对颜色进行聚类。
区域采样器	按区域采样颜色，并根据面积加权，使每个区域具有公平的影响力。
和谐引擎	可选地将调色板对齐到色彩和谐方案（类似色、互补色、三角色、分裂互补色）。
角色标注器	自动分配功能标签（基础、强调、阴影、高光、中性）。
导出层	将调色板写入 12 种不同的文件格式，包括行业标准色板格式。
GPU 路径（DX12）	可选 DirectX 12 计算加速，适用于大图像（4K 约 1 秒）。
CLI 包装器	允许通过命令行参数进行脚本化。

所有这些组件都打包在单个 .exe 中；无需安装程序，无运行时依赖，无网络流量。

🚀 主要功能（面向用户）

功能	作用
区域感知提取	按语义区域采样颜色，避免朴素像素频率方法常见的重复色板。
感知聚类	使用 CIEDE2000，因此人类看起来相同的颜色会被合并。
角色标注	每个色板获得一个标签（基础、强调、阴影、高光），可编辑。
和谐约束	选择配色方案；引擎将调色板朝该方案调整。
12 种导出格式	HEX、RGB、HSL、LAB、ASE、GPL、ACO、CSS 变量、JSON、PNG 工作表、SVG 工作表、SKETCH。
批处理模式	拖入文件夹；应用为每张图片创建一个调色板，多线程。
调色板比较	比较两个调色板并查看颜色差异 – 便于艺术方向跟踪。
色板锁定	固定一种颜色（例如品牌色），并围绕它重新提取其余颜色。
目测采样器	点击任意像素，将其精确值添加为色板。
GPU 切换	启用 DirectX 12 计算以加速高分辨率图像的处理。
便携配置	设置保存在可执行文件旁边；将文件夹移到 U 盘上即可正常工作。
CLI 模式	脚本化使用：`palette-from-image-ai.exe --input foo.png --count 8 --format css --out palette.css`。
监视文件夹	自动处理放入监视目录中的新文件。

📦 快速入门（来自 README 的快速入门步骤）

下载 GitHub 登陆页面上的 zip 文件。其中包含 .exe 和 models/ 文件夹。
解压整个归档到您控制的文件夹中（无需安装）。
运行 .exe。首次启动会构建一个小型着色器缓存（约 3 秒）。
拖放一张图片到窗口，或使用 文件 → 打开图像。
调整色板数量（5-16），选择和谐模式，锁定您想保留的颜色。
导出所需格式 – HEX 一键导出，或右键单击色板复制其值。

典型的端到端时间：1 分钟以内，使用 GPU 加速的 4K 图像约为 1.2 秒。

🛠️ 系统要求（如所列）

最低配置	推荐配置
Windows 10 21H2（64 位）	Windows 11 23H2+
4 核 CPU，SSE4.2	8 核 CPU，AVX2
4 GB 内存	16 GB 内存
集成 GPU（DX11）	独立 DX12 GPU，4 GB 显存
450 MB 可用磁盘	1.2 GB 可用（SSD）

无需额外运行时（无需 .NET、Python 或 Node）。应用完全在用户空间中运行。

📚 典型使用场景

场景	Palette‑From‑Image‑AI 为何适合
游戏资产管道 – 着色器需要 ASE 调色板。	直接 ASE 导出、区域感知颜色、精灵文件夹批处理。
UI/UX 设计 – 生成 CSS 颜色变量。	CSS 变量导出、和谐模式、角色标签（基础/强调）。
品牌一致的视觉指导 – 固定品牌色，同时重新推导调色板。	色板锁定 + 重新提取，调色板比较以查看随时间的变化。
安全工作室的离线工作流 – 无法上传资源。	完全离线、无遥测、便携文件夹。
脚本/CI – 自动生成调色板。	CLI 模式和监视文件夹自动化。

📌 限制与已知问题（来自 README）

首次启动会触发 SmartScreen 警告，因为二进制文件未签名。
暂不支持非常大的 TIFF（>200 百万像素） – 请先缩小。
网络驱动器上的批处理模式可能会停止；为获得最佳速度，请复制到本地。
在没有 DX12 计算队列的机器上，GPU 切换将被禁用。
平坦且高饱和度的图像可能需要较低的去重阈值（在设置 → 高级中调整）。

📜 许可证与贡献

MIT 许可证 – 免费用于个人、商业和教育用途。欢迎署名，但不强制。
存储库包含编译后的可执行文件和模型文件；未提及源代码，因此贡献可能仅限于问题报告或请求新功能（例如路线图上的 Linux CLI 构建）。

🎯 总结

Palette‑From‑Image‑AI 是一款真正的、完全离线的 Windows 应用程序，利用设备端视觉模型和感知颜色聚类，从任何图像生成高质量、角色感知的调色板。其优势在于区域感知提取、丰富的导出选项以及便携、零安装的特性，非常适合需要可靠调色板而不依赖在线服务的艺术家、UI 设计师和游戏开发者。