一、功能与适用场景
“图片格式转换”用于把一批静态图片转换成另一种图片格式。例如：
把 PNG 转成 JPG，方便发送或上传到只接受 JPG 的系统。
把 JPG 转成 PNG。
把 BMP 或 TIFF 转成更常用的 WebP、JPG 或 PNG。
把一个目录及其子目录中的图片统一转换成同一种格式。
在转换时移除拍摄位置、设备、作者、注释等隐私元数据。
插件会在单独的输出目录中生成新文件，不会修改或删除来源图片。输出会保留来源目录中的相对文件夹结构和原文件基本名称，只把扩展名换成目标格式。
例如：
来源目录：D:\商品原图
源文件： D:\商品原图\服装\正面.png
输出目录：D:\商品转换后
目标格式：JPG
输出文件：D:\商品转换后\服装\正面.jpg
二、支持的输入和输出格式
支持的输入格式
支持的目标格式
JPG
PNG
WebP
BMP
TIFF
选择 TIFF 时，输出扩展名统一为 .tiff。选择 JPG 时，输出扩展名统一为 .jpg。
静态图片限制
插件会检查真实编码格式、文件后缀、帧数和图层/页面情况，而不是只看扩展名。下列内容会被拒绝：
动画 WebP 或其他多帧图片。
多页 TIFF。
包含多个可识别图像流或多图层结构的图片。
无法确认只有一帧的文件。
文件已损坏或无法解码。
真实内容与扩展名不一致的文件，例如把 PNG 直接改名为
.jpg。
这样可以避免只转换动画的第一帧、只取 TIFF 的第一页或误处理伪装文件。
三、转换后会发生哪些变化
1. 文件格式会改变
输出采用“配置”页选择的目标格式。来源文件保持不变。
2. 可见宽高保持不变
插件不会主动缩放图片。它会按用户实际看到的方向计算宽高，转换后再验证输出的宽度和高度与来源图片的可见尺寸一致。
如果需要改变尺寸，应使用“图片尺寸调整”插件。
3. 图片方向会被应用到像素
手机照片可能依赖 Exif 或显示旋转信息才能竖直显示。转换时会先应用方向，再移除方向元数据。转换后的图片不需要继续依赖原方向标记即可保持正确方向。
4. 隐私元数据会被移除
转换时会删除普通元数据、章节和方向侧数据，并在完成前检查常见隐私字段，例如 Exif、GPS、XMP、IPTC、位置、作者、版权、注释、描述和创建时间。
不要依赖转换结果保留原始拍摄参数、版权说明或专业色彩资料。需要这些信息时，请保留来源文件。
5. 图片会重新编码
格式转换不是简单改文件名，而是重新解码和编码。即使宽高不变，文件体积和画面细节也可能变化：
JPG 和 WebP 的质量由“质量”设置控制。
PNG 的体积和处理时间受“PNG 压缩级别”影响。
BMP 和 TIFF 使用插件固定的编码方式；TIFF 使用 Deflate 压缩。
四、透明背景必须了解的规则
转换为 JPG
JPG 不支持透明背景。来源 PNG、WebP 或其他含透明区域的图片转为 JPG 时，插件会把透明部分铺到“JPG 背景色”上。
背景色通过调色盘选择，不需要手工输入颜色代码：
打开“配置”页。
目标格式选择“JPG”。
单击“JPG 背景色”右侧的色块按钮。
在弹出的调色盘中单击需要的颜色，弹层会自动关闭。
按钮上会显示当前颜色的色块和颜色代码，例如
#FFFFFF。
调色盘共两行 16 个颜色：第一行是从白到黑的灰阶，第二行是红、橙、黄、绿、青、蓝、紫、洋红等常用彩色。默认选中白色 #FFFFFF，当前选中的色块带蓝色边框。
调色盘中的颜色都已通过后台校验，任选一个都不会导致转换被拒绝。转换任务运行期间调色盘不可点击，需要先取消或等待任务结束。
转换为其他格式
JPG 背景色只在目标格式是 JPG 时生效。
目标为 PNG 或 WebP 时，不使用 JPG 背景色，编码流程不会主动铺设该背景色。
BMP、TIFF 及具体编码对透明通道的支持可能不同。
插件会验证格式、尺寸、方向和隐私元数据，但不会把透明通道单独作为完成判定。透明边缘、半透明阴影或设计素材很重要时，请先转换少量样图并检查实际输出。
五、开始前的准备
建议先准备两个独立目录：
D:\待转换图片
D:\转换后图片
开始前逐项检查：
来源图片已经整理到来源目录中。
需要处理子文件夹时，准备开启“递归”。
输出目录与来源目录不是同一个目录。
输出目录有足够空间，当前 Windows 账号有写入权限。
重要图片已有备份。
正在编辑的图片已经保存，最好暂时关闭相关编辑软件。
已明确目标格式，以及透明图片转 JPG 时要使用的背景色。
插件依赖吉米工具箱提供的 FFmpeg 和 ffprobe 共享资源。如果提示“请先绑定 ffmpeg.exe 与 ffprobe.exe 外部资源”，请先修复工具箱共享资源或联系软件提供方，不能通过修改图片参数绕过。
六、如何进入插件
打开吉米工具箱。
进入本地应用或已安装插件列表。
找到“图片格式转换”。
单击打开。
进入后默认位于“操作”标签页。
右上角：
版本标签显示当前插件版本。
“返回”用于返回插件列表；任务进行时会先提示是否离开。
“置顶”可让当前窗口保持在其他窗口前面。
七、认识界面
“操作”页包括：
来源目录。
输出目录。
“加载文件”“开始转换”“暂停/继续”“取消”按钮。
“递归”开关。
文件列表和状态统计。
“配置”页包括：
目标格式。
JPG/WebP 质量。
PNG 压缩级别。
JPG 背景色。
质量、PNG 压缩级别和 JPG 背景色会根据目标格式自动显示或隐藏。
每个配置项名称右侧都有一个问号图标，鼠标移到上面会显示该配置的详细说明，包括取值范围、数值含义和常见影响，不必先查教程即可判断怎么填。
修改任意配置后，“操作”页文件列表会立即同步：
更换目标格式：每行的“目标格式”随之更新；原本已完成或已跳过的行会回到“等待中”，进度清零，等待重新转换；原格式与新目标格式相同的行直接变为“已跳过”。
调整质量、PNG 压缩级别或背景色：每行的“输出参数”随之更新，已有的状态和进度不变。
已经判定“失败”的行（例如不支持的格式）保持失败状态，只更新目标格式和输出参数。
转换任务运行期间所有配置项都不可修改，需要先暂停并取消，或等任务结束。
目录、递归状态、目标格式、质量、背景色和列表分页数量会自动保存。下次打开插件时，会恢复有效设置并尝试重新加载来源目录。
八、选择来源目录和输出目录
使用“选择”按钮
单击来源目录右侧的“选择”。
选中图片所在的文件夹并确认。
插件会自动加载该文件夹中的候选图片。
单击输出目录右侧的“选择”。
选择转换后文件的保存目录。
拖入来源目录区域
可以把一个图片或一个文件夹拖到来源目录输入区域：
打开资源管理器。
按住图片或文件夹。
拖到“来源目录”输入框区域。
松开鼠标。
插件会以本次拖入内容重新确定来源目录并重新生成列表。
拖入来源目录区域属于“重新选择来源”，不是在现有列表后面简单追加。
拖入输出目录区域
只建议拖入文件夹。拖入图片时，界面会尝试取图片所在目录，但处理前仍要检查输入框中的路径。
目录限制
来源目录和输出目录不能相同。
开启递归时，输出目录不能位于来源目录内部。
未开启递归时，后台不会禁止输出目录位于来源目录的子目录中，但独立的并列目录更安全、更容易核对。
九、添加图片和文件夹
加载整个来源目录
选择来源目录。
根据需要打开或关闭“递归”。
单击“加载文件”。
等待“已加载 N 个文件”的提示。
查看文件列表中的原格式、目标格式、输出参数、宽高和状态。
递归关闭时只读取目录第一层；递归打开时也读取全部子文件夹。
切换递归开关后，插件会重新加载当前来源目录。
拖入文件列表区域
当前界面没有单独的“选择图片”按钮。如只想处理部分图片，可以直接拖入：
在资源管理器中选中一张、多张图片或一个文件夹。
拖到文件列表区域。
看到“释放以加入图片或文件夹”后松开鼠标。
等待插件检查真实格式和帧数。
列表处理规则：
新内容仍属于当前来源目录时，会与现有列表合并并去重。
新内容导致统一来源目录发生变化时，来源目录会更新，列表会重置为本次扫描结果。
不同盘符中的文件通常无法形成统一来源目录，建议分批处理。
拖入 GIF、HEIC、AVIF 等候选后，它们可能进入检查流程，但会显示“不支持的图片格式”，不会转换。
清空或移除
单击“清空”会清空整个列表，但不会删除磁盘文件。
每行最右侧有“×”移除按钮，任务未运行时可移除单个文件。
单击文件名会把该来源文件的完整路径复制到剪贴板，方便在资源管理器中定位；它不会打开文件。
十、详细配置说明
1. 目标格式
从 JPG、PNG、WebP、BMP、TIFF 中选择一种。整个批次使用同一个目标格式。
如果输入格式与目标格式相同，该文件会显示“已跳过”，不会调用转换，也不会在输出目录生成副本。这个插件不会用“转成相同格式”的方式重新压缩图片。
2. 质量
仅在目标格式为 JPG 或 WebP 时显示。允许范围是 1 到 100 的整数，默认值为 90。
数值越高：通常细节保留更多，文件更大。
数值越低：通常文件更小，但可能出现模糊或压缩痕迹。
它不是“压缩百分比”，质量
90不代表体积减少10%。
建议：
3. PNG 压缩级别
仅在目标格式为 PNG 时显示。允许范围是 0 到 9 的整数，默认值为 6。
0：通常更快，但输出可能更大。6：速度和体积的平衡值。9：通常更慢，并尝试更充分压缩。
PNG 压缩级别主要影响处理时间和文件体积，不是 JPG 那种有损质量参数。
4. JPG 背景色
仅在目标格式为 JPG 时显示，用调色盘选择，默认 #FFFFFF（白色）。
单击色块按钮弹出调色盘，两行共 16 个颜色：第一行灰阶（白、浅灰到黑），第二行常用彩色（红、橙、黄、绿、青、蓝、紫、洋红）。当前选中的颜色带蓝色边框，按钮上同时显示色块和颜色代码。
透明图片转 JPG 前，请按最终页面、文档或商品背景选择颜色；白底通常最通用。
十一、输出命名、目录和冲突规则
保留相对目录
来源：D:\来源\A\photo.png
输出：D:\结果\A\photo.jpg
不覆盖已有文件
如果 D:\结果\A\photo.jpg 已存在：
插件不会覆盖它。
该行显示“已跳过”。
错误说明显示“输出文件已存在”。
已有文件内容保持不变。
要重新生成，请先手工核对并移走或逐个删除旧输出。
同名不同格式可能冲突
假设同一目录内有：
photo.jpg
photo.png
如果两者都转为 WebP，它们都会映射到：
photo.webp
插件会识别这种冲突，只允许一个输入占用该输出名称，另一个显示“多个输入文件映射到同一输出文件”并跳过。批量转换前，建议先整理同名不同格式的文件。
临时输出验证
插件先在输出目录中生成临时文件，检查：
真实格式是否与目标格式一致。
宽高是否与来源可见尺寸一致。
方向信息是否已正确应用。
常见隐私元数据是否仍然存在。
验证通过后才正式提交最终文件。失败或取消时会清理临时文件。
十二、开始转换
确认来源目录和输出目录。
确认文件列表数量和错误行。
打开“配置”。
选择目标格式。
设置对应的质量、PNG 压缩级别或 JPG 背景色。
返回“操作”。
核对列表中的“目标格式”和“输出参数”是否与刚才的设置一致。
单击“开始转换”。
等待列表状态更新。
插件会自动使用 1～4 个并行任务提高速度，不需要用户设置并行数量。
十三、暂停、继续、取消和离开
暂停
单击“暂停”后，插件不再领取新的文件，但已经开始的转换会继续完成。因为插件可能同时处理多张图片，暂停后短时间内仍出现新的“已完成”状态是正常的。
继续
暂停后按钮变成“继续”。单击后，队列中的剩余文件继续转换。
取消
单击“取消”后：
等待中的文件变为“已取消”。
正在运行的 FFmpeg 转换会收到停止信号。
未提交的临时文件会被清理。
已经完成并提交的输出会保留。
来源图片不会改变。
请等待状态同步完成后再关闭窗口或整理输出目录。
返回或关闭
任务进行时离开会提示：“图片转换仍在进行，离开会取消未完成任务。”
需要任务继续：留在插件页面。
确认放弃剩余任务：确认离开。
插件不是“返回后继续在后台转换”的工作模式。
十四、如何判断转换结果
文件列表显示：
文件名和相对路径。
原格式。
目标格式。
输出参数：当前配置会用于该行的编码参数，JPG 显示“质量 90 · 背景 #FFFFFF”并附带背景色块，WebP 显示“质量 90”，PNG 显示“压缩级别 6”，BMP 显示“无压缩”，TIFF 显示“Deflate 无损”。
来源图片的可见宽高。
处理进度。
状态。
具体错误或跳过原因。
“输出参数”始终跟随“配置”页的当前设置，用来在开始转换前确认参数是否正确。
状态解释：
顶部状态标签可以筛选“总文件数”“等待中”“成功”“已跳过”“失败”。取消后的行仍可在“总文件数”视图中查看。
十五、完整操作示例
示例一：把透明 PNG 转成白底 JPG
来源目录选择
D:\商品透明图。输出目录选择
D:\商品白底图。根据目录情况设置递归。
单击“加载文件”。
打开“配置”。
目标格式选择“JPG”。
质量填写
90。JPG 背景色单击色块按钮，在调色盘第一行选择白色
#FFFFFF。返回“操作”，确认每行“输出参数”显示“质量 90 · 背景 #FFFFFF”。
单击“开始转换”。
完成后抽查透明边缘是否与白底融合自然。
示例二：把 BMP 和 TIFF 统一转成 PNG
把 BMP 和单页 TIFF 放到同一来源目录。
选择独立输出目录。
目标格式选择“PNG”。
PNG 压缩级别填写
6。开始转换。
检查是否存在多页 TIFF 失败项。
示例三：保留子目录批量转 WebP
来源：
D:\网站图片\首页\banner.jpg
D:\网站图片\商品\one.png
操作：
来源目录选择
D:\网站图片。输出目录选择
D:\网站图片-WebP。开启递归。
目标格式选择 WebP。
质量设置为
85。开始转换。
输出：
D:\网站图片-WebP\首页\banner.webp
D:\网站图片-WebP\商品\one.webp
十六、常见问题与解决办法
1. 为什么“开始转换”按钮不可用
文件列表为空或任务正在运行时，按钮不可用。先选择来源目录并加载文件。
2. 为什么输入格式和目标格式相同会跳过
插件只负责格式之间的转换，不把相同格式重新编码为新副本。同格式行不会生成输出。如果要压缩，应使用“图片压缩”；如果要改尺寸，应使用“图片尺寸调整”。
3. 为什么 GIF、HEIC 或 AVIF 出现在列表后失败
扫描会把部分常见图片后缀作为候选进行真实检查，但当前转换核心只接受 JPG、PNG、WebP、BMP 和单页 TIFF。失败行不会生成输出。
4. 为什么动画 WebP 或多页 TIFF 失败
插件只转换静态单帧图片，防止丢失动画帧或 TIFF 页面。请使用专门支持动画或多页文档的工具。
5. 为什么透明区域变成了白色或其他颜色
目标格式为 JPG 时必然无法保留透明。透明区域会铺到“JPG 背景色”上。需要透明时，请选择支持透明的目标格式并先做样图验证。
6. 为什么图片方向正确，但宽高看起来交换了
竖拍照片可能依赖方向元数据。插件按实际可见方向计算宽高，并把方向应用到像素；这可能使底层宽高与原始编码顺序不同，但视觉方向应保持正确。
7. 为什么提示“输出文件已存在”
插件不会覆盖已有文件。打开输出目录核对旧文件，确认后手工移走或逐个删除，再重新运行。
8. 为什么提示“多个输入文件映射到同一输出文件”
同一相对目录中存在相同基本名称、不同扩展名的文件，转换到统一格式后名称发生冲突。先重命名其中一个来源文件，再重新加载。
9. 为什么递归时不能把输出目录放在来源目录内
这样会导致生成结果再次进入扫描范围。请使用来源目录旁边的独立输出目录。
10. 为什么转换后文件更大
格式、图片内容、质量值和编码方式都会影响体积。格式转换保证目标格式和可见尺寸，不保证输出一定更小。若主要目标是减小体积，请根据目标格式降低质量，或使用“图片压缩”。
11. 为什么文件扩展名与真实格式不一致
只改文件名不能完成格式转换。请找到原始文件，或使用能够正确打开该文件的软件先另存为真实格式。
12. 为什么提示缺少 FFmpeg/ffprobe
工具箱共享图片处理资源不可用。请修复共享资源或联系软件提供方。
13. 取消后为什么还有已完成文件
取消只停止未完成部分，已经验证并正式提交的结果不会自动删除。
14. 为什么改了目标格式后，“已完成”的行变回“等待中”
更换目标格式意味着这些图片要按新格式重新转换一次，所以状态、进度和上次的输出路径都会重置。上次已经生成的输出文件仍在输出目录中，不会被删除；重新转换时如果新输出名称已存在，该行会显示“输出文件已存在”。
15. 为什么改了质量或背景色后，列表里的“输出参数”跟着变了
“输出参数”显示的是当前配置将要使用的编码参数，用于开始前核对，因此会随配置实时刷新。它不代表已完成文件的历史参数；已完成文件的实际参数由当时的设置决定，不会被改写。
16. 为什么找不到手工输入背景色的输入框
背景色改为调色盘选择，避免输入不被支持的颜色写法。请单击“JPG 背景色”右侧的色块按钮，在弹出的调色盘中选色。
十七、隐私与数据安全说明
转换在本机执行，插件的图片转换流程不会把图片上传到外部网站。
来源文件只读，不会被覆盖或删除。
输出写入用户指定目录。
已有同名输出不会覆盖。
输出在临时文件中完成并验证，通过后才提交。
取消或失败会清理未提交临时文件。
转换会移除常见隐私元数据，但画面本身的证件、地址、二维码、人脸和聊天内容不会被自动遮挡。
输出不保证保留原版权字段、拍摄参数或色彩配置；需要留档时必须保存来源文件。
十八、使用注意事项
批量转换前先用 1～3 张样图测试。
透明图片转 JPG 前务必确认背景色。
不要在运行期间移动、改名或删除来源文件。
不要在运行期间修改输出目录中的临时文件。
不要把“已跳过”当作“转换成功”。
处理多页 TIFF、动画图片或设计工程文件时，应使用专用工具。
转换完成后抽查文字、细线、透明边缘、颜色和方向。
十九、完成前检查清单
开始前：
来源目录和输出目录已经分开。
递归开启时，输出目录不在来源目录内部。
文件列表数量与预期一致。
目标格式已经确认。
JPG/WebP 质量为 1～100 的整数。
PNG 压缩级别为 0～9 的整数。
转 JPG 时已在调色盘中选定背景色。
列表中的“目标格式”和“输出参数”与配置一致。
已处理同名不同格式可能造成的输出冲突。
重要来源图片已有备份。
完成后：
已查看所有“失败”和“已跳过”项目。
已确认同格式项目没有误以为生成了输出。
已抽查输出能正常打开。
已检查图片宽高和视觉方向。
已检查透明背景或 JPG 铺底颜色。
已确认相对目录结构正确。
已确认需要交付的文件均为“已完成”。