一、功能与适用场景
“图片压缩”用于批量减小图片文件体积，适合下面这些情况：
图片太大，发送、上传或保存比较慢。
一个文件夹里有很多图片，希望一次处理完。
图片分散在多个子文件夹中，希望压缩后仍保留原来的文件夹层级。
希望压缩时保持原来的图片格式和可见尺寸。
希望在压缩过程中移除图片中可能包含的拍摄位置、设备信息等元数据。
插件会读取来源图片，在另一个输出目录中生成压缩后的新文件。它不会直接修改或删除来源图片。
处理后的文件会保持：
原文件名。
原扩展名通常保持不变；如果候选文件的后缀与真实 JPEG、PNG 或 WebP 内容不一致，输出扩展名会自动按真实格式修正，来源文件名不会改动。
原来的相对文件夹结构。
原图片的可见宽度、高度和视觉方向。
插件只会保存“确实比源文件更小”的压缩结果。如果压缩后的临时结果没有变小，该图片会显示为“已跳过”，输出目录中不会生成该图片。
二、支持的图片范围
插件会先用文件名后缀筛选候选文件，再检查文件内部的真实格式、容器结构、帧数以及是否能够完整解码。候选文件的后缀即使写错，只要真实内容是可处理的静态 JPEG、PNG 或 WebP，仍会直接压缩，并把输出扩展名自动修正为真实格式；不会弹出“后缀不一致”警告，也不会修改来源文件。
下列文件仍会处理失败：
文件内容不完整或已经损坏的图片。
动画 WebP、动画 PNG 或其他多帧图片。
无法确认只有一帧的图片。
关于透明背景
JPG 格式本身不支持透明背景。
PNG 和 WebP 会继续输出为原格式，插件没有“背景颜色”或“转为 JPG”的设置，不会因为格式转换而主动铺设白色背景。
当前完成校验会确认输出格式、可见尺寸和可解码性，但不会把透明通道单独作为成功条件。透明素材非常重要时，建议先处理少量样图，并在常用看图软件或设计软件中确认透明区域正确，再批量处理。
关于图片方向
部分手机照片的像素实际方向与看到的方向不同，正确方向依赖 JPEG 中的 Exif Orientation 信息。插件会先读取这个方向，再把方向应用到输出图片的像素中，最后移除方向元数据。因此：
输出图片应保持与原图相同的视觉方向。
某些竖拍照片的底层宽高可能互换，但插件校验的是用户实际看到的宽高。
输出文件不再依赖 Exif Orientation 才能正确显示。
关于元数据
压缩会重新编码图片，并明确丢弃输入元数据。拍摄位置、设备、时间、作者、备注等信息不会作为普通元数据继续写入输出文件。方向会先应用到像素，再移除方向标记。
如果工作流程需要保留版权说明、拍摄参数或色彩配置等原始信息，请保留来源图片，不要只保存压缩后的文件。
三、开始前的准备
第一次使用时，建议按下面顺序准备：
把准备处理的图片整理到一个来源文件夹中。
如果图片在子文件夹中，确认是否需要保留这些子文件夹。
新建一个空的输出文件夹，例如
D:\压缩后图片。确保来源目录和输出目录不是同一个目录。
确保磁盘有足够空间，且当前 Windows 账号对输出目录有写入权限。
重要图片请保留备份。插件不会覆盖来源文件，但备份仍然是处理重要资料前的好习惯。
如果图片正在被其他软件编辑或同步，建议先保存并关闭相关软件，避免文件在处理时发生变化。
插件依赖吉米工具箱提供的 FFmpeg 和 ffprobe 共享资源。如果开始时提示“未检测到主体共享 FFmpeg 或 ffprobe”，说明处理资源没有准备好，插件无法继续。此时请先修复或重新安装工具箱共享资源，或者联系软件提供方。
四、如何进入插件
打开吉米工具箱。
进入本地应用或已安装插件列表。
找到名称为“图片压缩”的插件。
单击插件卡片或打开按钮。
进入后默认显示“操作”标签页；右上角会显示当前插件版本。
右上角常用按钮：
“返回”：返回插件列表。任务运行时返回会先出现离开提示。
“置顶”：让插件窗口保持在其他窗口上方；再次单击可取消置顶。
五、认识操作界面
“操作”页主要由四个区域组成：
来源目录：图片所在的根文件夹。
输出目录：压缩后图片的保存位置。
操作按钮：加载、开始压缩、暂停/继续、取消。
文件列表：显示文件、体积、压缩率、进度、状态和错误信息。
右侧“递归扫描”开关决定是否扫描来源目录中的子文件夹。
“配置”页包含两个参数：
JPEG/WebP 质量。
PNG 压缩级别。
目录、递归开关、压缩参数、当前标签页和列表分页数量会自动保存。下次打开插件时，插件会尝试恢复这些设置，并重新加载已保存的来源目录。
六、选择来源目录和输出目录
方法一：使用“选择”按钮
在“来源目录”一行单击“选择”。
在 Windows 文件夹选择窗口中找到图片所在文件夹。
单击确认后，插件会自动扫描并加载该目录中的图片。
在“输出目录”一行单击“选择”。
选择准备保存压缩结果的文件夹。
如果输出目录还不存在，后台在开始任务时可以创建它；对电脑操作不熟悉的用户，建议提前在资源管理器中建好并通过“选择”按钮选中。
方法二：拖拽到目录输入区域
来源目录支持拖入图片或文件夹：
打开 Windows 文件资源管理器。
找到一个图片或图片文件夹。
按住鼠标左键，把它拖到“来源目录”输入框区域。
输入区域出现拖入提示后松开鼠标。
插件会根据拖入内容确定来源目录并加载图片。
输出目录建议只拖入文件夹：
把准备保存结果的文件夹拖到“输出目录”输入框区域。
松开鼠标后检查输入框中的路径是否是正确的文件夹路径。
如果误把一个文件拖到输出区域，界面会尝试取这个文件所在的文件夹，但仍建议处理前再次核对路径。
目录关系限制
来源目录和输出目录不能相同。
开启“递归扫描”时，输出目录不能位于来源目录内部，否则下次扫描可能把输出再次当成输入。
未开启递归扫描时，后台不会禁止输出目录位于来源目录的子目录中，但为了避免混淆，仍建议始终使用两个互不包含的独立目录。
推荐结构：
D:\待压缩图片
D:\压缩后图片
七、添加图片和文件夹
插件提供三种加载方式。
方式一：加载整个来源目录
选择来源目录。
根据需要设置“递归扫描”。
单击“加载”。
等待“加载成功”提示。
查看文件列表中的数量和文件名。
“递归扫描”关闭时，只读取来源目录第一层中的图片；开启时，会继续读取所有子文件夹中的受支持图片。
切换“递归扫描”开关后，插件会自动重新加载当前来源目录。
方式二：使用“选择图片”按钮
在“文件列表”标题右侧单击“选择图片”。
在文件选择窗口中选择一张或多张 JPG、JPEG、PNG、WebP 图片。
单击确认。
插件会识别这些文件并加入列表。
如果所选图片都在当前来源目录内，它们会与现有列表合并，并自动去除重复项。如果所选图片不属于当前来源目录，插件会重新确定公共来源目录，列表也可能改为本次选择的图片。
方式三：拖入文件列表区域
在资源管理器中选中一张、多张图片，或者一个文件夹。
把它们拖到“文件列表”区域。
看到“释放以加入图片或文件夹”后松开鼠标。
插件会识别受支持的图片。
合并规则：
拖入内容都位于当前来源目录内时，会加入现有列表，并去除重复文件。
拖入内容不属于当前来源目录时，插件会按新文件的公共父目录重新设置来源目录，当前列表可能被本次拖入内容替换。
不同盘符中的文件通常没有统一来源根目录，不适合放在同一批次；建议分批处理。
从列表中移除文件
任务未运行时，可以在某一文件行上单击鼠标右键，然后选择“移除”。这只会从当前任务列表中移除，不会删除磁盘上的源文件。
单击“清空”会清空整个任务列表，同样不会删除源文件。
八、详细配置说明
1. JPEG/WebP 质量
允许范围是 1 到 100 的整数，默认值为 80。
数值越高：通常画面细节保留更多，文件也更大。
数值越低：通常文件更小，但更容易出现模糊、色块或边缘失真。
该设置只影响 JPG、JPEG 和 WebP。
PNG 不使用这个质量值。
可参考以下选择：
质量值不是“压缩百分比”。例如质量 80 不代表文件一定减少 20%，实际结果取决于原图内容和原来的编码方式。
2. PNG 压缩级别
允许范围是 0 到 9 的整数，默认值为 6。
0：处理通常更快，但文件可能更大。6：默认平衡值，适合大多数情况。9：会尝试更充分地压缩，通常更慢。
PNG 压缩级别主要影响处理耗时和文件体积，不是降低画质的“质量值”。不过插件仍会重新编码 PNG，并移除元数据。
3. 递归扫描
关闭：只扫描来源目录最外层。
开启：扫描来源目录及其全部子文件夹。
开启后，输出目录不能放在来源目录内部。
九、开始压缩
开始前请完成以下检查：
来源目录正确。
输出目录正确，且不是来源目录。
文件列表中至少有一张图片。
递归扫描状态符合需要。
JPEG/WebP 质量和 PNG 压缩级别已经确认。
然后：
返回“操作”标签页。
单击“开始压缩”。
插件会先校验目录、参数和图片。
文件状态会依次从“等待中”变为“处理中”，最后变为“已完成”“已跳过”“失败”或“已取消”。
处理结束后，检查顶部统计和文件列表。
插件会自动并行处理少量图片，以提高速度。并行数量由电脑可用处理器自动决定，最多同时处理 4 张，不需要用户设置。
十、暂停、继续、取消和离开
暂停
单击“暂停”后，插件会停止领取下一张图片，但已经进入“处理中”的图片会自然完成。因此，单击暂停后仍可能有少量文件继续完成，这是正常现象。
继续
任务暂停后，按钮文字会变为“继续”。单击“继续”，剩余等待中的图片会继续处理。
取消
单击“取消”后：
等待中的文件会变为“已取消”。
正在运行的压缩进程会被停止。
尚未正式提交的临时文件会被清理。
已经成功生成的输出文件会保留，不会自动删除。
来源文件始终保留。
取消完成前请不要立即手工删除输出目录，先等待界面状态稳定。
返回或关闭插件
任务运行时单击“返回”或离开插件，会出现提示：“图片压缩仍在进行，离开会立即取消未完成任务。”
想继续处理：选择留在当前页面。
确定不再继续：确认离开，宿主会停止插件任务并清理未完成的临时输出。
不要把“返回插件列表”当成后台继续运行功能。
十一、输出位置和命名规则
输出文件会写到所选输出目录中，并保留来源目录下的相对结构。
例如：
来源目录：D:\待压缩图片
源文件： D:\待压缩图片\商品A\正面.jpg
输出目录：D:\压缩后图片
输出文件：D:\压缩后图片\商品A\正面.jpg
重要规则：
文件名保持不变。扩展名通常保持不变；候选文件的后缀与真实可处理格式不一致时，输出会自动使用真实格式的
.jpg、.png或.webp扩展名。例如来源正面.jpg实际是 PNG 时，输出为正面.png，来源仍保留为正面.jpg。输出目录中已有同名文件时，插件不会覆盖，状态显示“已跳过”，原有输出文件保持不变。
压缩结果没有比源文件小时，状态显示“已跳过”，并且不会生成最终输出文件。
输出会先写入临时文件，验证格式、尺寸和可解码性后才正式提交。
如果要重新处理同一批图片，需要先手工确认并移走或逐个删除旧输出文件；插件不会替用户覆盖它们。
十二、如何判断处理结果
文件列表包含以下信息：
“源体积”：原图片大小。
“结果体积”：成功输出的文件大小；未成功生成时显示横线或对应结果。
“节省体积”：源体积减去结果体积。
“压缩率”：节省体积占源体积的比例。
“处理进度”：当前处理进度。
“处理状态”：最终结果类别。
“错误”：失败或跳过的具体原因。
状态含义：
顶部“总体原大小”统计所有列表图片的源体积；“总体结果大小”和“节省大小”主要统计已完成项目。批次中有跳过或失败项时，不要只看总体百分比，还要查看各状态数量。
十三、完整操作示例
假设有下面的图片：
D:\旅行照片\北京\照片1.jpg
D:\旅行照片\北京\照片2.jpg
D:\旅行照片\上海\照片3.png
希望压缩后放到 D:\旅行照片-压缩后，并保留“北京”“上海”两个子文件夹。
操作步骤：
打开“图片压缩”。
来源目录选择
D:\旅行照片。输出目录选择
D:\旅行照片-压缩后。打开“递归扫描”。
单击“加载”，确认列表中有 3 张图片。
打开“配置”标签页。
JPEG/WebP 质量填写
80。PNG 压缩级别填写
6。返回“操作”标签页，单击“开始压缩”。
等待任务结束。
单击“已完成”状态标签，只查看成功文件。
在资源管理器中打开
D:\旅行照片-压缩后，抽查图片方向、清晰度和透明区域。
可能的结果：
两张 JPG 显示“已完成”，生成压缩文件。
PNG 如果原来已经压缩得很好，可能显示“压缩后未变小”并被跳过。
如果输出目录已有
北京\照片1.jpg，该文件会显示“输出文件已存在”并被跳过。
十四、常见问题与解决办法
1. 单击“开始压缩”没有反应或提示请选择目录
检查来源目录、输出目录是否都已填写，并确认文件列表不是空的。
2. 加载后显示 0 张图片
依次检查：
文件是否为 JPG、JPEG、PNG 或 WebP。
图片是否只放在子文件夹中；如果是，请开启“递归扫描”。
来源路径是否仍然存在且可访问。
文件名后缀是否为 JPG、JPEG、PNG 或 WebP 候选格式。
3. 为什么很多图片显示“已跳过”
查看“错误”或状态提示：
“输出文件已存在”：输出目录中已有同名文件，插件不会覆盖。
“压缩后未变小”：重新编码结果不比原图小，插件不会保存一个更大的副本。
“已跳过”不等于“已生成新文件”。
4. 为什么压缩率是 0%
可能是压缩结果没有变小、文件被跳过、处理失败，或者原图本来已经高度压缩。查看该行状态和错误说明。
5. 竖拍照片会不会横过来
插件会读取 JPEG 方向信息，把正确方向应用到像素，并验证输出的可见宽高。正常情况下，输出视觉方向与原图一致。仍建议在批量处理手机照片前先抽查一两张竖拍照片。
6. 透明 PNG 或 WebP 需要注意什么
插件保持原格式，不提供背景填色功能。重要透明素材请先用少量样图验证透明边缘和半透明阴影，再处理整批文件。
7. 为什么动画图片失败
插件只处理静态单帧图片。动画 WebP 和 APNG 会被明确拒绝，避免只压缩第一帧后丢失动画内容。
8. 文件名后缀与真实格式不同怎么办
只要文件名后缀仍是 JPG、JPEG、PNG 或 WebP 之一，且真实内容是可完整解码的静态 JPEG、PNG 或 WebP，插件会按真实内容压缩，并自动修正输出扩展名；不会修改来源文件，也不会提示后缀不一致。真实内容损坏、动画或不受支持时，仍会显示失败原因。
9. 为什么提示图片文件损坏
图片容器结构不完整、无法完整解码或文件大小异常。先尝试在常用看图软件中打开源文件；如果也无法正常打开，需要从备份恢复。
10. 为什么递归模式不允许把输出目录放到来源目录里面
如果输出目录位于来源目录中，递归扫描可能再次扫描刚生成的文件，造成重复处理。请把输出目录改为来源目录旁边的独立文件夹。
11. 取消后为什么已有部分输出
取消只停止未完成任务。取消前已经验证并提交成功的输出会保留，这是为了避免删除用户已经得到的结果。
12. 提示缺少 FFmpeg 或 ffprobe
这是工具箱共享处理资源缺失或不可用，不是图片参数问题。请修复工具箱资源或联系软件提供方。
十五、隐私与数据安全说明
图片处理在本机完成，插件的压缩流程不会把图片上传到外部网站。
来源文件只读取，不会被覆盖或删除。
输出使用独立目录，并在验证完成后才正式提交。
输出目录已有同名文件时不会覆盖。
取消或异常时会清理尚未提交的临时文件。
压缩会丢弃输入元数据，因此输出不适合替代需要保留完整拍摄信息、版权字段或专业色彩资料的原始档案。
“移除元数据”能减少常见隐私信息，但发送图片前仍应直接检查画面本身，例如门牌号、证件、聊天内容和人脸，这些可见内容不会被元数据清理功能遮挡。
十六、使用注意事项
永远不要把输出目录当作唯一备份，先保留来源图片。
不要在任务运行时修改、移动或删除来源文件。
不要在任务运行时手工清理插件生成的临时文件。
已存在的输出不会覆盖；重新处理前先核对旧文件。
PNG 压缩级别与 JPEG/WebP 质量不是同一概念。
质量值越高不代表一定能得到更小的文件。
对文字截图、二维码、线稿和透明素材，先用少量样图测试。
批量完成后至少抽查：一张横图、一张竖图、一张 PNG，以及一张透明 WebP 或 PNG（如果批次中存在）。
十七、完成前检查清单
开始前：
来源目录已选择且路径正确。
输出目录已选择且与来源目录分开。
开启递归时，输出目录不在来源目录内部。
文件列表中的图片数量与预期基本一致。
JPEG/WebP 质量为 1～100 的整数。
PNG 压缩级别为 0～9 的整数。
重要源文件已有备份。
完成后：
“失败”“已跳过”“已取消”的数量已经逐项查看。
已确认“已跳过”项目是否没有生成新文件。
已抽查输出图片能正常打开。
已抽查横竖方向、清晰度、文字和透明背景。
已确认输出目录中的相对文件夹结构正确。
已确认需要交付的文件都处于“已完成”状态。