功能关键词：批量裁剪黑边、去除白边、单色边框、固定像素裁剪、动画图片处理。
工具概述
图片黑边批量去除工具用于检测图片周围连续的黑色、白色或其他近乎单色的边框，并裁剪这些边框后保存图片，也可以按指定像素数直接裁剪选定的边。适合整理带边框的图片、截图或GIF和WebP动画图片。
界面包含“常用参数”、“输出设置”、“高级选项”3个选项卡，涵盖检测阈值、触发比例、安全边距、裁剪边、同名文件处理策略、并发数、预览、暂停与恢复、失败重试。根据边框颜色以及行和列的特征进行判断，不提供主体识别或手动选择裁剪范围。
工具截图
主要功能
- 支持选择多个图片文件或目录来源，按需递归扫描子目录，并保留相对路径结构。
- 通过自动、智能任意边框色、黑边、白边、自定义单色共5种模式，检测连续边框的行和列。
- 可以设置阈值、行列触发比例、像素和百分比安全边距、最小裁剪像素数，并指定允许裁剪的边。
- 固定裁剪像素数大于0时，将跳过颜色检测，直接从选定的边裁剪相同的像素数。
- 输出可以保留原格式，或转换为JPG、PNG、WEBP、BMP、TIFF或GIF，并提供质量、压缩、透明区域填充、同名文件处理策略选项。
- GIF和动画WebP图片会在合并所有帧的区域后统一裁剪，输出为GIF或WebP时，会尝试保留帧显示时长、循环和透明度参数。
- 大图可以先以缩略图尺寸检测，再映射回原始尺寸，并提供首张图片预览、并发处理、暂停与恢复、安全停止、失败重试和日志。
使用前的准备
文件选择中显示JPG、JPEG、PNG、BMP、WebP、TIF、TIFF、GIF、TGA、ICO，源代码中的扩展名列表还包括JPE、JFIF、DIB、PPM、PGM、PBM、PNM，可通过目录或“所有文件”选项加载。实际的编码支持取决于Pillow。
请准备有效的输入和保存目录；建议使用单独的输出位置。首次输入有效文件或文件夹且输出为空时，软件会自动填入包含来源的目录；正式开始前需要确认。
自定义边框色和透明区域填充色使用0到255之间的3个R,G,B值。默认自定义颜色0,0,0和透明区域填充255,255,255均由软件提供。
全帧动画分支仅用于GIF和WebP；APNG和多页TIFF没有对应的完整动画/多页处理流程。
详细操作步骤
1. 选择输入、保存目录和子目录范围
在“路径设置”中点击“文件”选择多张图片，所选内容会追加到现有输入中；点击“文件夹”则替换为单个目录。也可以拖入文件或文件夹进行添加，或用半角分号分隔多个路径。
“整理”会删除重复路径并标记不存在的项目，“清空”会清除输入；整理不会裁剪图片。路径按分号拆分，不支持通过给路径中的分号加引号来将其保护为单个项目。
勾选“扫描子目录”后，可以选择“保留原路径结构”；未勾选时，只处理目录的第一层。保留结构时，文件按各来源根目录的相对目录整理，不会自动为多个根目录分别添加其根目录名；不保留时，文件将集中到保存目录中。
然后点击保存目录的“浏览”选择输出位置。由于首个有效输入可能会将来源目录自动填入输出位置，需要主动确认；来源内单独的输出子目录会在递归处理中被排除，但仍允许将保存位置设为与来源相同的目录，建议保持启用源文件保护，并使用单独的目录。
相同的输入路径字符串会被整理并去重，但同时选择文件夹及其内部文件时，仍可能被重复收集。
2. 在常用参数中选择合适的边框模式
展开“检测模式”。明显为黑色的边框选择“黑边”，明显为白色的边框选择“白边”；“自动检测”会比较黑色和白色检测中可裁剪的区域，在找不到有效边框时按需尝试任意单色边框，不应理解为能在所有图片中识别所有边框颜色。
“智能检测（任意边框色）”会检查边缘的各行和各列是否分别接近其自身的中位数颜色，支持黑白以外的近乎单色或轻微渐变；每条边最多向内扫描宽度或高度的45%，需要结合图片内容谨慎调整设置。
“单色边框（自定义）”使用下方的RGB值，下一步将展示其启用状态。不透明度极低的像素会在黑色或白色背景上参与检测；这不是独立的透明边框模式。
模式仅决定检测规则，不具备自动识别人物或商品轮廓、补全被裁剪图片内容的功能。
3. 设置阈值、触发比例、安全边距和自定义RGB
阈值范围为0到255，默认值为20，判断基于整个RGB通道的最大色差；值越大，接近目标颜色的像素越容易被视为边框。界面提示的一般范围为10到40。
行/列触发比例范围为0.50到1.00，默认值为0.98；这意味着，一行或一列要被识别为边缘，其像素中至少98%需要满足目标条件。降低比例会放宽判断，并不意味着直接裁剪相应比例。
安全边距范围为0到200，默认值为0；表示检测后向外额外保留的像素，以避免裁剪得过于接近内容。最小裁剪像素数范围为0到200，默认值为2；当4条边的计划裁剪量最大值小于阈值时，视为无需裁剪，代码中至少使用1像素作为阈值。
RGB字段仅在切换到自定义单色后启用；以R,G,B输入目标颜色，各值应在0到255范围内；其他模式下RGB字段禁用。
4. 在高级选项中选择裁剪边和处理保护设置
点击“高级选项”；上、下、左、右默认全部勾选，可以仅允许裁剪特定边；正式开始前请至少勾选1条边。
边距%的范围为0到20%，默认值为0%，按原图短边计算，并与常用参数中的像素安全边距相加。它会额外保留边缘，而不是增加裁剪量。
固定裁剪像素数范围为0到5000，默认值为0。大于0时，将跳过颜色检测，从选定的每条边裁剪相同的像素数；此时不使用颜色阈值、安全像素边距、百分比边距和常规最小裁剪规则。
“无需裁剪时复制原文件”默认勾选：保留原格式且没有可裁剪区域时，会直接复制原文件；取消勾选后，此类图片不会输出。明确选择转换格式时，即使无需裁剪，图片也会以所选格式重新保存。
“保留元数据”、“保护源文件”、“大图快速检测”默认全部勾选。“保护源文件”会在输出位置与当前源文件相同时自动生成新名称，或在跳过策略下不执行写入；它不是一键备份。大图超过约400万像素时，会先在缩略图上检测，再将坐标映射回原图；输出仍为原图的裁剪区域，不会直接导出检测用缩略图。
对于静态图片，会先尝试按EXIF方向进行校正，EXIF、ICC、DPI元数据会根据输出格式尽可能保留，但不保证所有标签及额外动画信息的完整性。图中保留了软件的默认选项。
5. 设置输出格式、编码质量、同名文件处理和并发数
点击“输出设置”，保留原格式，或选择JPG、PNG、WEBP、BMP、TIFF、GIF。选择特定格式后，相关质量设置的可用状态会变化，保留原格式时可设置全部3类参数。
JPEG质量范围为1到100，默认值为92；PNG压缩范围为0到9，默认值为6，影响的是压缩时间和文件大小，而非有损压缩的画质；WEBP质量范围为1到100，默认值为90。参数仅对相应的保存格式生效。
同名文件处理包括自动重命名、跳过和覆盖。默认的自动重命名会添加_1、_2等；同一批次内的任务使用锁记录输出路径，避免自动编号冲突，但覆盖策略仍会替换现有目标，多个同名来源宜使用可区分的目录。
并发数范围为1到32，当前默认值为8；由CPU数量推导，并限制在2到8之间。大图或多个帧会同时占用内存，界面建议2到8，可根据机器情况降低。
透明区域填充色默认值为255,255,255，主要用于将透明图片转换为JPEG。将GIF/WebP动画图片输出为GIF或WebP时，会按所有帧裁剪区域的并集统一裁剪，并尝试保留帧显示时长和循环；若任一帧没有可裁剪区域，整个序列将保留共享画布。转换为其他静态格式时，仅导出第一帧。
6. 实际使用时的预览项、启动任务和查看日志
正式添加来源后，“预览”会使用当前设置处理最先找到的图片，并在弹窗中提供原图/检测框与裁剪后图片的对比；这不是全帧序列整体的预览，也不会批量保存。
确认来源、输出位置和参数后，点击“开始”；程序会先重新验证权限并统计文件，然后并行处理。进度按已处理/总数更新，日志中显示成功、跳过、失败、无需裁剪的情况。
运行中点击“暂停”会请求暂停，按钮变为“恢复”后再次点击即可恢复运行；已进入当前图片解码、检测或编码的任务不会立即中断。点击“停止”同样会等待运行中的任务结束，已完成的输出不会撤销，因此不能根据说明中的“即时中断”预期瞬间结束。
完成后若存在失败文件，“失败重试”将启用，使用仍然存在的失败项作为新输入，以当前参数再次执行“开始”和权限验证。重试会改写输入列表，而不是恢复原批次的进度。
点击“打开保存目录”查看结果位置，若目录不存在，也会尝试创建。日志保留最新的200条，可结合最终统计确认失败数量；复制的文件或未裁剪而转换的文件也可能计为成功，无需裁剪数与成功数并非互斥分类。没有CSV导出或单独的下载按钮。
主要参数说明
| 参数 | 功能 | 建议 |
|---|---|---|
| 检测模式 | 自动、智能任意边框色、黑色、白色、自定义。 | 已知的边框颜色可明确选择，自动主要比较黑色和白色。 |
| 阈值/触发比例 | 0—255，默认值20；0.50—1.00，默认值0.98。 | 两者均放宽时，颜色相似的行和列更容易被视为边框。 |
| 安全边距/边距% | 0—200像素；短边的0—20%，两者默认值均为0。 | 两者相加，作为检测后额外保留的量。 |
| 最小裁剪像素数 | 0—200，默认值2，实际阈值至少为1。 | 比较4条边计划裁剪量的最大值，不要求所有边均达到该值。 |
| 裁剪边/固定像素 | 可选择4条边；固定0—5000，默认值0。 | 大于0时固定优先，不使用颜色检测或安全边距。 |
| 无需裁剪时复制 | 默认开启；保留原格式时会复制原文件。 | 明确选择格式转换时，即使不裁剪也会输出。 |
| 保护来源/快速检测 | 默认开启；对约400万像素的大图进行缩略图检测。 | 输出使用原图裁剪；检测用缩略图不是成品。 |
| 编码/同名文件 | JPEG92、PNG6、WEBP90；默认自动重命名。 | 覆盖会替换现有目标，请先确认输出目录。 |
| 并发数/透明区域填充 | 1—32，当前为8；RGB默认值为255,255,255。 | 并发数以图片数量为单位，填充色主要用于JPEG。 |
结果与保存
成品文件的基本名称来自源文件，以原扩展名或所选输出格式保存，自动重命名使用_1、_2等。保留结构时，文件按相对于来源的目录整理，不会为多个根目录添加根目录名；不保留时，输出将集中在一起。
实际裁剪或转换时，会先在同一目录写入临时文件，再替换目标；无需裁剪且保留原格式时，可直接复制。不裁剪并不一定意味着没有输出，也不意味着图片被重新压缩。
GIF和动画WebP图片会先读取所有帧并取安全区域的并集，再统一裁剪；转换为静态格式时仅导出第一帧。对于APNG、多页TIFF、ICO等格式，不保证完整保留帧和页面或所有尺寸。
正式完成后，请使用“打开保存目录”查看结果，并使用失败日志和重试项处理问题。元数据仅会根据格式尽可能保留，停止也不会回滚已完成的文件。
常见问题与使用建议
1. 为什么自定义颜色显示为灰色？
仅在选择“单色边框（自定义）”时启用，其他模式不使用此RGB字段。
2. 增大阈值会提高裁剪精度吗？
增大数值只会放宽颜色判断，并不会提高精度，可按界面显示的一般范围设置。
3. 0.98意味着裁掉98%吗？
不是，它意味着，一行或一列要被视为边缘，其中满足边框条件的像素比例需要达到98%。
4. 安全边距与边距%会相加吗？
是的，作为检测后额外保留的量，像素边距会与原图短边的相应比例相加。
5. 固定裁剪像素数会受颜色模式影响吗？
大于0时，优先从选定的边裁剪固定像素数，并跳过颜色检测和安全边距。
6. 为什么无需裁剪的图片也会保存？
默认会复制原文件；选择格式转换时，即使不裁剪，也会以目标格式重新保存。
7. 为什么GIF或WebP看起来没有被裁剪？
各帧之间会取并集，若任一帧没有共同的可裁剪区域，整个序列将保留共享画布。
8. 为什么暂停后仍有文件被写入？
暂停和停止会在安全检查点响应，已进入解码或保存的任务可能会继续直至完成。
9. 为什么“失败重试”显示为灰色？
当前没有记录的失败项，或任务仍在运行时，此项不可用。
10. 为什么保存目录会自动与来源相同？
输出位置为空时，软件会自动填入首个有效来源的位置，因此正式开始前需要确认，并按需改为单独的目录。
