一套用于墨镜电商图片生产的 Windows 桌面工具。它把下面三类工作集中到一个控制台中：
- 使用网页版 ChatGPT 辅助完成四角度图片精修；
- 将 SKU 图片整理成 Photoshop 批处理需要的目录和顺序；
- 在 Photoshop 中批量生成白底图、组合图、三视图和 45 度排版长图。
当前版本：1.6.0 支持系统：Windows 10 / Windows 11
只想马上使用？请直接阅读下面的“下载与第一次启动”。不需要安装编程环境，也不需要自己编译源码。
当前仓库还没有建立正式的 GitHub Release 页面。现在可以下载通过 Windows CI 检查的 main 分支最新快照：
- 打开 KeRo Tools GitHub 仓库。
- 点击页面右上方绿色的 Code 按钮。
- 点击 Download ZIP。也可以直接下载 main 分支 ZIP。
- 下载完成后，右键 ZIP，选择“全部解压”。不要直接在压缩包里运行程序。
- 打开解压后的文件夹，双击
KeRo 墨镜控制台.exe。 - 等待右侧“环境状态”完成检查。显示“系统已就绪”后即可使用。
main.zip 会随着仓库更新，不是固定不变的版本发布包，因此目前没有对应的独立 SHA-256 文件。以后建立正式 Release 后，固定版本 ZIP 和 SHA-256 将放在 Release 页面中。
请保留完整目录，不要只把某一个 EXE 单独复制到桌面。EXE 需要通过相对路径调用旁边的 脚本资源 和 说明文档。
当前 EXE 没有 Authenticode 数字签名，Windows SmartScreen 可能显示“Windows 已保护你的电脑”。这不代表程序检查出了病毒，而是 Windows 无法验证发布者身份。
请确认文件确实下载自本仓库，然后选择“更多信息”→“仍要运行”。如果公司电脑的安全策略禁止运行未签名程序，请联系管理员，或者审查源码后自行构建。
| 文件 | 作用 | 什么时候使用 |
|---|---|---|
KeRo 墨镜控制台.exe |
推荐总入口 | 第一次使用，或者需要按完整流程生产图片 |
墨镜AI精修工作台.exe |
只打开 AI 精修 | 已经知道流程，只需要整理 ChatGPT 精修任务 |
墨镜素材整理工具.exe |
只打开素材整理 | 已有四角度成品，只需要整理 Photoshop 输入目录 |
墨镜图片自动化工具.exe |
只打开 Photoshop 自动化 | 素材已经整理好，只需要批量生成最终版式 |
三个子工具可以分别使用，并不强制每次都走完整三步。例如，已经有合格的四角度图片时，可以跳过 AI 精修，直接从素材整理开始。
原始 SKU 四角度图片
↓
① AI 精修：人工上传到 ChatGPT，导入精修结果
↓
04_final_sku_ready
↓
② 素材整理：预检、复制、重命名和分组
↓
白底图 / 组合 / 三视图 / 排列组合
↓
③ Photoshop 图片自动化
↓
JPG / PNG / PSD 成品
如果你只想知道按钮顺序，可以记住：
AI 精修 → 素材整理 → 先打开 Photoshop → 图片自动化
AI 精修工作台负责整理任务、复制提示词、打开 ChatGPT、导入下载结果和生成验收图。它不调用 OpenAI API，也不会自动控制浏览器；登录、上传图片、发送提示词和下载图片仍由你手动完成。
推荐目录结构如下：
SKU素材/
型号8205/
黑色/
三视图/
45度.jpg
侧面.jpg
正面.jpg
背面.jpg
茶色/
三视图/
45度.png
侧面.png
正面.png
背面.png
每个款式的 三视图 文件夹应有四张图片。标准视角名称最稳妥；如果文件名是相机编号或随机数字，只要文件夹中刚好有四张 JPG/JPEG/PNG，V1.2.12 也会按文件名自然排序导入，之后仍需要你人工确认视角。
- 在控制台点击“AI 精修”，或直接双击
墨镜AI精修工作台.exe。 - 点击“原图文件夹”，选择 SKU 总目录或某个型号目录。
- 检查“保存位置”。默认位置是当前 Windows 用户桌面下的
AI精修输出。 - 点击“生成工作台”。
- 在“当前任务”区域按
1 → 2 → 3 → 4操作：- “打开4图文件夹”；
- “复制提示词”；
- “打开 ChatGPT”，手动上传这四张图并粘贴提示词；
- 下载四张精修结果后，点击“导入4张成品”。
- 在弹出的预览窗口中确认每张图对应
45度 / 侧面 / 正面 / 背面。不要只依赖 ChatGPT 的下载文件名。 - 完成全部款式后点击“生成验收图”，检查颜色、形状、比例、角度和镜片是否被错误改变。
后续工具真正需要的是工作台里的 04_final_sku_ready：
04_final_sku_ready/
型号8205/
黑色/
45度.png
侧面.png
正面.png
背面.png
最终成品统一保存为真实 PNG。中途关闭后，可以在“恢复旧任务”中选择原来的工作台文件夹，然后点击“载入旧工作台”继续。
只应在确认最终图正确后使用“清理残余”。工具会先显示即将清理的图片数、文件数和容量，得到确认后再把中间图片、验收缓存和残余图片送入 Windows 回收站；04_final_sku_ready 中的最终成品以及必要的文字/清单文件会保留。
这不是无提示永久删除，但仍建议先检查 04_final_sku_ready，再确认清理。
素材整理工具会把每个型号下的款式图片复制、转换和重命名，生成 Photoshop 脚本可以直接读取的连续图片目录。输入支持 PNG、JPG、JPEG，输出统一为真实 PNG。
- 在控制台点击“素材整理”，或双击
墨镜素材整理工具.exe。 - 如果处理 AI 精修结果，选择“批量处理”，然后选择整个
04_final_sku_ready。 - 第一次处理建议先勾选“只做预检，不复制图片”。
- 点击“开始处理”，查看
预检报告.csv；确认没有缺少关键视角后再正式运行。 - 取消“只做预检”，再次点击“开始处理”。
- 如果不希望旧结果与本次结果混在一起，勾选“新建干净输出批次”。工具会创建类似
本次输出_20260713_153000的时间戳目录，不会删除旧结果。
- 单型号处理：选择一个具体型号文件夹，例如
型号8205。 - 批量处理：选择包含多个型号文件夹的总目录，例如
04_final_sku_ready。
默认输出文件夹名为 11111，可以在界面中改成“交付图”等其他合法名称。
| 输出目录 | 图片来源 | 用途 |
|---|---|---|
白底图 |
每个款式的 45度 图 |
Photoshop 1:1 白底图任务 |
排列组合 |
每个款式的 45度 图 |
Photoshop 45 度排版长图任务 |
组合 |
每个款式的 侧面 图 |
每三张合成一张组合图 |
三视图 |
每个款式按 正面 → 侧面 → 背面 排列 |
每三张合成一张三视图 |
每个型号通常会得到：
型号8205/
11111/
白底图/
排列组合/
组合/
三视图/
复制结果清单.csv
预检报告.csv
如果某个款式缺少正面、侧面或背面中的任意一张，工具会跳过这一整组三视图并写入预检报告，避免后面的图片发生三张一组错位。
这一部分需要 Adobe Photoshop 桌面版。
- 先启动 Photoshop，并等待它完全打开。
- 在 KeRo 控制台点击“图片自动化”，或双击
墨镜图片自动化工具.exe。 - 在左侧选择任务：
1:1 白底图、组合图、三视图或45度排版布局。 - 阅读右侧的输入要求，然后点击“启动 Photoshop 脚本”。
- 在 Photoshop 弹出的窗口中确认参数、输出命名和暂停间隔。
- 选择第二步生成的对应输入文件夹。
- 选择本次成品输出文件夹。
- 等待 Photoshop 显示完成提示，然后检查输出的 JPG、PNG、PSD 和日志文件。
| Photoshop 任务 | 应选择的输入目录 | 处理规则 |
|---|---|---|
| 1:1 白底图 | 11111\白底图 |
一张输入生成一张白底成品 |
| 组合图 | 11111\组合 |
每三张输入合成一张组合图 |
| 三视图 | 11111\三视图 |
每三张按正面、侧面、背面合成一张 |
| 45度排版布局 | 11111\排列组合 |
多张 45 度图排成一张长图 |
如果通过根目录的 墨镜图片自动化工具.exe 启动任务，请先查看素材整理阶段生成的 预检报告.csv，并确认 组合 或 三视图 输入目录中的图片数能够被 3 整除。
如果使用下面介绍的 Photoshop 内置统一界面，则可以在正式运行前直接点击“检查输入数量”。该按钮会显示自然排序预览和不能成组的余数；它不在根目录 EXE 打开的 Windows 启动界面中。
KeRo 控制台底部可以控制正在运行的四个 Photoshop JSX 任务：
- “暂停”：当前这一张成品写完后暂停后续处理；
- “继续”：清除暂停或停止请求；如果脚本仍在暂停等待，会从检查点继续；
- “停止”：当前这一张成品写完后停止后续处理，已完成的文件保留。
这些按钮不会强行杀死 Photoshop，也不会在写文件过程中立刻中断，因此点击后可能需要等待当前输出完成。如果脚本已经响应“停止”并退出，“继续”不会自动重启已经结束的任务，需要重新启动对应的 Photoshop 任务。
可以在 Photoshop 中手动打开统一界面：
Photoshop → 文件 → 脚本 → 浏览...
然后选择：
脚本资源\墨镜 Tools\PS自动化脚本-墨镜-可视化工具-修正版\
PS自动化脚本-墨镜\墨镜批处理可视化UI.jsx
- 确认 ZIP 已经完整解压，不要在压缩包预览窗口中运行。
- 确认四个 EXE、
脚本资源和说明文档仍在同一个根目录。 - 不要单独移动 EXE，也不要改名
脚本资源。 - 打开
KeRo 墨镜控制台.exe，查看右侧“环境状态”和底部运行记录。 - 如果安全软件拦截 PowerShell 或未签名 EXE，需要在安全软件中查看拦截记录。
- 确认每个款式下面存在
三视图文件夹； - 标准情况应包含 45度、侧面、正面、背面四张图片；
- 随机文件名模式必须刚好有四张受支持图片；
- WebP 当前不会自动转换，请先转成 PNG/JPG/JPEG。
- 先查看
预检报告.csv； - 如果使用 Photoshop 内置统一 JSX 界面，点击“检查输入数量”；
- 如果使用根目录 EXE 启动任务，先在资源管理器中确认输入图片总数；
- 三视图和组合图的输入数量必须是 3 的倍数；
- 不要手动打乱素材整理工具生成的连续编号。
暂停和停止只在当前输出完成后的检查点响应。复杂 PSD 或大尺寸长图仍在保存时，需要等待保存完成。
KeRo Tools 自身不会把 SKU 图片、源码或本地文件上传到第三方服务器，也不保存 OpenAI API Key。AI 精修阶段只有你在网页版 ChatGPT 中手动选择并上传的图片会离开本机。
- Windows 10 或 Windows 11；
- Windows PowerShell 5.1；
- .NET Framework 4.x；
- Adobe Photoshop 桌面版，仅 Photoshop 自动化功能需要；
- ChatGPT 网页版账号，仅 AI 精修流程需要；
- 当前未承诺兼容 macOS、Linux、PowerShell 7 或所有 Photoshop 历史版本；
- WebP 不会自动转换；
- EXE 尚未进行 Authenticode 代码签名；
- 套件版本为
1.6.0，四个 EXE 文件版本为1.6.0.0；AI 工作台保留独立功能版本1.2.12。
暗色控制台截图见 docs/screenshots/control-center-dark.png。更详细的专项说明位于 说明文档。
普通使用者不需要执行本节。
Windows 控制台和三个启动器的 C# 源码位于 src/windows。在 Windows PowerShell 5.1 中运行：
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\build.ps1构建脚本使用本机 .NET Framework csc.exe，并将四个 EXE 输出到仓库根目录。完整说明见 BUILDING.md。
运行公开版完整检查：
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\tests\public-release-check.ps1生成发布 ZIP 和 SHA-256：
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\package-release.ps1验证发布 ZIP 在含中文和空格的陌生路径中仍能运行：
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\tests\relocation-check.ps1请不要在公开 Issue 中上传包含私人 SKU 图片、客户资料、下载目录或 Windows 用户名的截图。安全问题处理方式见 SECURITY.md。
本仓库公开源代码供查看，但当前使用 All Rights Reserved 授权，不属于 OSI 定义的开源软件。未经作者明确许可，不得擅自复制、修改或再分发。具体条款见 LICENSE。
Copyright (c) 2026 KeRo. All rights reserved.