一、功能与适用场景
“图片尺寸调整”用于批量改变静态图片的像素宽度和高度，适合下面这些情况：
把相机或手机大图缩小后用于网页、文档或聊天发送。
把一批图片统一到指定宽度或高度。
把图片放进一个固定宽高范围内。
把图片等比放大后居中裁剪成统一尺寸。
把不同长宽比的图片直接拉伸成完全相同的宽高。
处理包含多个子文件夹的图片，并保留原来的目录结构。
插件会把结果写入独立输出目录，不会修改或删除来源图片。
输出会保持：
原文件名。
原扩展名和真实图片格式。
来源目录中的相对文件夹结构。
例如：
来源目录：D:\商品原图
源文件： D:\商品原图\服装\正面.png
输出目录：D:\商品调整后
输出文件：D:\商品调整后\服装\正面.png
二、支持的图片范围
插件会检查真实编码、扩展名、帧数、宽高和 TIFF 页数。下列文件会显示失败：
已损坏或无法识别的图片。
真实格式与扩展名不一致的文件。
动画或多帧图片。
多页 TIFF。
无法确认静态单帧的图片。
宽高或总像素超过安全限制的图片。
插件不会只取动画第一帧或 TIFF 第一页来冒充完整处理结果。
三、处理后会发生哪些变化
1. 图片会重新编码
尺寸调整需要重新生成像素，因此输出不是原文件的简单复制。JPG/WebP 的画质会受质量参数影响，PNG 的编码体积和速度会受压缩级别影响。
2. 格式保持不变
JPG 仍输出 JPG。
PNG 仍输出 PNG。
WebP 仍输出 WebP。
BMP 仍输出 BMP。
TIF/TIFF 保持原扩展名和 TIFF 格式。
如果需要改变格式，应使用“图片格式转换”。
3. 方向会先被正确应用
手机照片可能依赖 Exif Orientation 或旋转信息显示正确方向。插件会在缩放前把翻转或旋转应用到像素，再移除来源元数据。因此，输出不需要依赖原方向标签即可保持正确视觉方向。
4. 元数据不会作为原始资料保留
处理命令明确丢弃输入元数据和章节。Exif、GPS、XMP、IPTC、拍摄参数、版权字段、方向标记和其他附加信息不应被认为会继续保留。
如果需要保留完整摄影资料、版权说明或专业色彩信息，必须保存来源文件。
5. 透明背景
插件不改变格式，也没有背景颜色设置。
JPG 来源本身不支持透明。
PNG 和 WebP 编码流程不会主动把图片转成 JPG 或使用指定背景色铺底。
当前完成校验会确认真实格式和输出宽高，但不会把 Alpha 透明通道单独作为成功条件。重要的透明边缘、半透明阴影或设计素材应先用少量样图验证。
BMP、TIFF 以及具体编码对透明通道的表现可能不同，不要只根据扩展名推断透明一定保留。
四、开始前的准备
建议准备两个独立文件夹：
D:\待调整图片
D:\尺寸调整后
开始前请确认：
来源图片已整理好。
是否要处理子文件夹已经明确。
输出目录与来源目录不同。
当前 Windows 账号对输出目录有写入权限。
磁盘有足够空间。放大图片时，输出可能比来源大很多。
重要图片已有备份。
正在编辑的图片已经保存，最好暂时关闭编辑软件。
已想清楚需要“保持比例”“裁剪”还是“拉伸”。
插件依赖吉米工具箱提供的 FFmpeg 和 ffprobe 共享资源。如果提示“未检测到主体绑定的 FFmpeg/ffprobe 资源”，请先修复工具箱共享资源或联系软件提供方。
五、如何进入插件
打开吉米工具箱。
进入本地应用或已安装插件列表。
找到“图片尺寸调整”。
单击打开。
默认进入“操作”标签页。
右上角：
版本标签显示当前插件版本。
“返回”返回插件列表；任务进行时会先提示。
“置顶”让窗口保持在其他窗口前面。
六、认识界面
“操作”页包括：
来源目录。
输出目录。
“加载文件”“开始调整”“暂停/继续”“取消”。
“包含子文件夹”开关。
文件列表和状态筛选。
“配置”页包括：
尺寸模式。
缩放比例或目标宽高。
固定尺寸适配方式。
是否允许放大。
JPEG/WebP 质量。
PNG 压缩级别。
目录、尺寸参数、递归状态、当前标签页和分页数量会自动保存。
图片加载完成后，修改尺寸模式、缩放比例、目标宽高、固定尺寸适配方式或“允许放大”，操作页文件列表中的空闲候选图片会立即同步新的“目标尺寸”。如果新配置要求放大且“允许放大”关闭，对应图片会立即显示“已跳过”和原因；重新允许放大或调低目标尺寸后，会恢复为“等待中”。JPEG/WebP 质量和 PNG 压缩级别不改变目标尺寸，因此修改它们不会刷新尺寸预览。
七、选择来源目录和输出目录
使用“选择”按钮
单击来源目录右侧“选择”。
选择图片所在文件夹并确认。
选择完成后，再单击“加载文件”。
单击输出目录右侧“选择”。
选择调整后图片的保存文件夹。
注意：“图片尺寸调整”选择来源目录后不会立即自动加载；需要单击“加载文件”，或者在来源路径输入框中按 Enter。
拖入来源目录区域
可以拖入文件夹，也可以拖入一张或多张受支持图片：
拖入文件夹：使用该文件夹作为来源目录，并按“包含子文件夹”设置扫描。
拖入一张或多张图片：使用这些图片的公共父目录作为来源目录，并加载本次拖入的图片。
拖入来源目录区域后会立即开始扫描。
拖入输出目录区域
只应拖入文件夹。当前界面会直接采用拖入路径；如果拖入的是图片文件，路径会被当作输出路径并导致后续校验失败。出现这种情况时，请清空该输入框并重新选择正确的文件夹。
目录关系限制
来源目录和输出目录必须分开。
开启“包含子文件夹”时，输出目录不能位于来源目录内部。
未开启时，后台不会禁止输出目录位于来源目录的子目录中，但为了避免误读旧输出，仍推荐使用互不包含的独立目录。
八、加载图片、拖拽和列表管理
加载整个来源目录
选择来源目录。
设置“包含子文件夹”。
单击“加载文件”。
等待插件读取每张图片的真实格式、帧数、方向和尺寸。
检查文件列表。
开关关闭时，只加载来源目录第一层；开启时，也加载所有子文件夹。
切换“包含子文件夹”后，插件会自动重新加载当前来源目录。
拖入文件列表区域
当前界面没有单独的“选择图片”按钮。可以把图片或文件夹拖到文件列表区域：
如果尚未设置来源目录，先拖入图片，插件会尝试用这些图片的公共父目录作为来源目录。
如果已经设置来源目录，只拖入位于该来源目录内部的图片或文件夹。
松开后，插件会按本次拖入路径重新扫描并显示列表。
重要：这个插件的拖入扫描会用本次扫描结果替换当前列表，不是持续追加。需要处理分散在多个位置的图片时，建议先把它们整理到一个统一来源目录，或分多个批次处理。
如果当前来源目录是 D:\A，却把 E:\B\photo.jpg 拖入列表，文件不在来源目录内，会被拒绝。应先把来源目录改为正确的公共根目录。
清空和移除
单击“清空”清除当前列表，不删除源文件。
每行最右侧的“×”可以移除单张图片。
任务运行时不能清空或移除。
单击文件名会把完整来源路径复制到剪贴板，方便定位；不会打开图片。
九、尺寸模式详细说明
模式一：百分比缩放
按来源图片宽高同时乘以同一个百分比，保持长宽比。
范围：1% 到 500%，界面可填写 1 位小数。计算结果会四舍五入到至少 1 像素。
示例：
原图：2000×1200
比例：50%
结果：1000×600
适合：整批图片统一缩小一半、缩小到 25% 等。
模式二：指定宽度
指定目标宽度，高度按原长宽比自动计算。
范围：1 到 32768 像素的整数。
示例：
原图：3000×2000
目标宽度：1200
结果：1200×800
适合：网页图片统一宽度、文档插图统一宽度。
模式三：指定高度
指定目标高度，宽度按原长宽比自动计算。
范围：1 到 32768 像素的整数。
示例：
原图：3000×2000
目标高度：600
结果：900×600
适合：头像、列表缩略图或展示图统一高度。
模式四：固定宽高
同时指定宽度和高度，并选择“包含”“覆盖”或“拉伸”。
宽、高分别为 1 到 32768 像素的整数，目标总像素不能超过 100000000。
十、固定尺寸适配方式
1. 包含（边界内等比缩放）
图片保持比例，完整放进目标宽高边界内，不裁剪、不拉伸，也不会自动补白边。
例如把 1200×800 放入 600×600：
结果：600×400
它不会生成 600×600 的白边画布。目标宽高只是边界，实际结果可能有一边小于设置值。
适合：必须保留完整画面，允许实际尺寸不是精确固定宽高。
2. 覆盖（等比缩放后居中裁剪）
图片先等比缩放，直到完全覆盖目标宽高，再从中心裁剪到精确尺寸。
例如把 1200×800 处理为 600×600：
先等比缩放到能覆盖正方形。
左右多余部分从中心对称裁掉。
最终结果精确为
600×600。
适合：商品方图、头像、卡片封面等必须精确尺寸的场景。
注意：画面边缘可能被裁掉，主体靠近边缘时先做样图确认。插件固定居中裁剪，不能在界面中调整裁剪焦点。
3. 拉伸（精确宽高）
直接把图片缩放到设置的宽度和高度，不保持原长宽比，也不裁剪。
例如：
原图：1200×800
目标：600×600
结果：600×600
人物或物体可能被压扁、拉高或拉宽。只有明确接受变形时才使用。
十一、“允许放大”详细说明
默认关闭。
关闭时
如果当前设置要求任意方向比来源图片更大，整张图片会显示“已跳过”，原因是：
目标尺寸需要放大源图，已按设置跳过
例如：
原图：800×600
指定宽度：1920
允许放大：关
结果：跳过，不生成输出
开启时
允许生成比来源图片更大的像素尺寸。但放大不能创造真实细节，可能出现模糊、锯齿或纹理变软。
对于“覆盖”模式，插件还会检查裁剪前的中间缩放尺寸。如果为了覆盖目标框必须先放大，而“允许放大”关闭，该图片也会跳过。
十二、质量和压缩参数
JPEG/WebP 质量
范围 1 到 100 的整数，默认 90。只影响 JPG、JPEG 和 WebP。
高数值：细节通常更多，文件更大。
低数值：文件通常更小，压缩痕迹更明显。
它不影响 PNG、BMP 或 TIFF。
建议：
PNG 压缩级别
范围 0 到 9 的整数，默认 6。只影响 PNG。
0：通常较快，文件可能较大。6：默认平衡值。9：通常较慢，并尝试更充分压缩。
PNG 压缩级别主要影响速度和体积，不是降低画质的质量值。
BMP 和 TIFF
界面没有单独的 BMP/TIFF 质量选项，使用插件固定编码方式。
十三、尺寸安全限制
为避免异常图片占用过多内存或生成不可控制的大文件，插件限制：
来源和目标单边最大
32768像素。来源和目标总像素最大
100000000。“覆盖”模式的裁剪前中间缩放结果也必须满足这些限制。
例如 20000×20000 等于 4 亿像素，会被拒绝。
如果提示单边或总像素超限，应降低目标尺寸，不能通过反复开始绕过。
十四、开始调整
选择来源目录。
选择输出目录。
设置是否包含子文件夹。
打开“配置”，选择尺寸模式并填写参数。
确认“允许放大”、质量和 PNG 压缩级别。
返回“操作”并单击“加载文件”。
检查文件列表中的原尺寸、目标尺寸、状态和跳过原因。
如需修改尺寸设置，返回“配置”调整；空闲候选行会立即同步新的目标尺寸和放大跳过状态。
确认列表预览符合预期后，单击“开始调整”。
开始时后台仍会按最新配置独立计算目标尺寸并校验参数。任务运行后，列表中的目标尺寸属于本批次计划；处理中、已完成、失败、已取消及因输出已存在而跳过的记录不会被后来修改的配置覆盖。要按新配置预览下一批图片，请在当前任务结束后重新加载文件。
插件会自动使用 1～4 个并行工作任务提高速度，不需要用户设置。
十五、暂停、继续、取消和离开
暂停
单击“暂停”后，插件停止领取新任务；已经由并行工作任务领取的图片会继续处理。因此暂停后短时间内仍可能有几张图片完成。
继续
暂停后按钮变为“继续”。单击后，剩余队列继续运行。
取消
单击“取消”后：
队列中等待的文件会标记为“已取消”。
正在运行的 FFmpeg/ffprobe 操作会收到取消信号。
未正式提交的临时文件会清理。
已经成功生成的输出会保留。
来源文件不会改变。
取消接口会先发出停止请求，后台进程和界面状态还需要短暂收尾。请等待“处理中”消失后再关闭窗口或操作输出目录。
返回或关闭
任务进行时返回会提示：“图片尺寸调整仍在进行，返回将取消未完成任务。”
想继续：留在当前页面。
确认停止：确认离开，宿主会取消任务、等待处理进程结束并清理临时文件。
返回插件列表不会让任务继续在后台处理。
十六、输出和覆盖规则
保持相对目录和原格式
来源：D:\原图\A\photo.jpeg
输出：D:\结果\A\photo.jpeg
永不覆盖已有输出
如果输出路径中已有同名文件：
状态显示“已跳过”。
错误说明显示“输出文件已存在”。
已有文件保持不变。
本次不会生成新的同名结果。
临时文件和验证
插件会：
在最终目录中生成临时输出。
再次检查真实格式、静态单帧和实际宽高。
确认实际宽高与目标计划完全一致。
以不覆盖已有文件的方式提交最终名称。
删除临时文件。
验证失败、取消或冲突时不会把未验证临时结果当成正式输出。
十七、如何判断处理结果
文件列表显示：
文件名和相对路径。
原尺寸。
目标尺寸。
实际结果。
状态。
错误或跳过原因。
“目标尺寸”是计划值；“实际结果”只有成功完成后才会显示。空闲候选行会随尺寸配置立即更新；任务开始后和已有历史结果保留各自批次计划。最终交付前应确认目标尺寸与实际结果一致。
十八、完整操作示例
示例一：所有照片缩小到 50%
来源目录选择
D:\旅行原图。输出目录选择
D:\旅行图-50%。根据需要开启“包含子文件夹”。
单击“加载文件”。
配置中选择“百分比缩放”。
缩放比例填写
50%。“允许放大”保持关闭。
开始调整。
原图 4000×3000 的目标尺寸为 2000×1500。
示例二：网页图片统一宽度 1200 像素
选择“指定宽度”。
目标宽度填写
1200。“允许放大”关闭，避免小图被放大变糊。
开始调整。
宽于 1200 的图片会缩小；窄于 1200 的图片会跳过。
示例三：生成 1080×1080 方图并裁剪
选择“固定宽高”。
宽度填写
1080。高度填写
1080。固定尺寸适配选择“覆盖”。
根据源图大小决定是否开启“允许放大”。
先处理少量样图，检查主体是否因居中裁剪而被切掉。
示例四：把图片完整放进 1920×1080 范围
选择“固定宽高”。
宽度填写
1920，高度填写1080。适配选择“包含”。
结果保持完整比例且没有补边，实际尺寸可能是
1620×1080、1920×800等。
十九、常见问题与解决办法
1. 选择来源目录后为什么列表还是空的
选择来源目录后需要单击“加载文件”。也可以在来源路径输入框中按 Enter。
2. 为什么加载后有文件显示失败
查看错误列。常见原因：
图片损坏。
文件后缀与真实格式不一致。
动画或多帧图片。
多页 TIFF。
图片尺寸或总像素超限。
文件在扫描时被移动或修改。
3. 为什么图片显示“目标尺寸需要放大源图，已按设置跳过”
当前设置会让至少一个方向大于来源，而“允许放大”关闭。可以降低目标尺寸，或在能接受画质下降时开启“允许放大”。
4. 为什么“包含”没有输出我填写的精确宽高
“包含”保持比例、不裁剪、不补边，填写的是最大边界，不是最终画布。要精确尺寸可选择“覆盖”或“拉伸”。
5. 为什么修改配置后部分文件的目标尺寸没有变化
只有空闲的“等待中”图片和因禁止放大而“已跳过”的候选图片会即时同步。正在处理、已完成、失败、已取消，以及因“输出文件已存在”而跳过的记录属于已启动任务或历史结果，插件会保留当时的目标尺寸和原因。当前任务结束后重新加载文件，即可按最新配置预览下一批。
6. 为什么“覆盖”裁掉了图片边缘
覆盖模式必须填满目标框，因此会居中裁掉超出部分。当前不能移动裁剪焦点。主体靠边时改用“包含”或使用专业裁剪工具。
7. 为什么“拉伸”后人物变形
拉伸不保持原长宽比。改用指定宽度、指定高度或固定宽高的“包含/覆盖”。
8. 为什么输出文件比原图更大
放大尺寸、较高 JPEG/WebP 质量、原图编码差异都可能让输出更大。尺寸调整保证目标宽高和格式，不保证减小体积。
9. 为什么透明图需要抽查
插件保持原格式且不主动铺背景，但完成校验没有单独验证 Alpha 通道。透明边缘是关键业务内容时，先用样图确认。
10. 为什么竖拍照片的原尺寸看起来交换了
列表显示的是应用方向后用户实际看到的宽高。竖拍照片底层编码可能是横向像素加 Orientation，因此可见宽高会与底层顺序不同。
11. 为什么输出没有原来的 Exif、GPS 或拍摄时间
尺寸调整会重新编码并丢弃元数据。需要保留这些信息时必须保留来源图片，或选择符合业务要求的其他工具。
12. 为什么提示“输出文件已存在”
插件不会覆盖。核对旧输出后，手工移走或逐个删除，再重新运行。
13. 为什么拖入文件列表后原列表不见了
本插件用本次拖入内容重新扫描并替换列表，不是追加模式。请把要处理的文件整理在统一来源目录中，再整体加载。
14. 为什么拖到输出目录后报路径错误
输出区域只应拖入文件夹。如果拖入图片，界面可能直接填入文件路径。重新使用“选择”按钮选择正确输出文件夹。
15. 为什么递归模式不允许输出目录位于来源目录中
避免生成结果再次进入来源扫描。使用来源目录旁边的独立输出目录。
16. 取消后为什么还有已完成文件
取消只停止未完成部分，已经验证并提交的输出会保留。
17. 提示缺少 FFmpeg/ffprobe 怎么办
这是工具箱共享处理资源不可用。请修复共享资源或联系软件提供方。
二十、隐私与数据安全说明
图片调整在本机完成，插件的处理流程不会把图片上传到外部网站。
来源图片只读，不会覆盖或删除。
输出写入用户指定的独立目录。
已有同名输出不会覆盖。
临时输出通过真实格式和尺寸验证后才提交。
失败、取消或冲突时会清理未提交的临时文件。
输出会丢弃输入元数据，但画面中的证件、地址、人脸、二维码等可见隐私不会被自动处理。
输出不能替代需要保留原始拍摄信息、版权字段或专业色彩资料的原始档案。
二十一、使用注意事项
先用少量样图确认尺寸模式，再处理整批文件。
重要图片保留来源备份。
不要在任务运行时移动、重命名或删除来源文件。
不要在任务运行时修改输出目录中的临时文件。
“包含”不补边，“覆盖”会裁剪，“拉伸”会变形。
放大不能增加真实细节。
“已跳过”不等于已生成输出。
透明图片、竖拍照片、文字截图和边缘主体都应抽查。
二十二、完成前检查清单
开始前：
来源目录和输出目录已分开。
开启子文件夹时，输出目录不在来源目录内部。
已单击“加载文件”，列表数量正确。
尺寸模式与业务目标一致。
“包含/覆盖/拉伸”的区别已确认。
百分比在 1%～500% 范围内。
宽高不超过 32768，目标总像素不超过 100000000。
是否允许放大已经确认。
文件列表中的目标尺寸和放大跳过状态已随当前配置同步。
JPEG/WebP 质量为 1～100 的整数。
PNG 压缩级别为 0～9 的整数。
重要来源文件已有备份。
完成后：
已检查“失败”“已跳过”“已取消”项目。
已确认需要交付的文件都是“已完成”。
“目标尺寸”和“实际结果”一致。
已抽查比例、裁剪范围和是否变形。
已抽查竖拍方向和透明背景。
已确认输出格式和相对目录结构正确。
已确认输出文件能在客户常用软件中打开。