Skip to content

X5 Crop v3.6.2

Choose a tag to compare

@rrriiicccooo rrriiicccooo released this 05 Jun 14:50

中文快速使用

  1. 下载并解压 X5-Crop-v3.6.2.zip
  2. 第一次使用先运行安装器:
    • macOS: install/X5_Crop_Mac_install.command
    • Windows: install\X5_Crop_win_install.bat
  3. X5_Crop.py、对应系统启动器和要裁切的 TIFF 长图放在同一个文件夹里。
  4. 双击启动器,先选择 format,再选择是否 partial,再选择是否 Debug Analysis。

请下载本页面 Assets 里的 X5-Crop-v3.6.2.zip,不要下载 GitHub 自动生成的 Source code / 源码压缩包给普通用户使用。源码包是开发结构,不是整理好的用户发布包。

脚本不会修改原始 TIFF。自动裁切会生成新文件;进入 needs_review/ 的文件也是原 TIFF 的复制粘贴,方便人工处理。

English Quick Start

  1. Download and unzip X5-Crop-v3.6.2.zip.
  2. On a new machine, run the installer first:
    • macOS: install/X5_Crop_Mac_install.command
    • Windows: install\X5_Crop_win_install.bat
  3. Put X5_Crop.py, the launcher for your OS, and the TIFF strip scans in the same folder.
  4. Double-click the launcher, choose format, choose partial mode, then choose Debug Analysis.

Download X5-Crop-v3.6.2.zip from this page's Assets. Do not give normal users the auto-generated GitHub Source code zip; that is the development source layout, not the prepared user package.

The script does not modify original TIFF files. Auto crops are written as new files; files in needs_review/ are plain copies of the source TIFFs for manual handling.

包内文件 / Package Contents

X5_Crop.py
X5_Crop_Mac.command
X5_Crop_win.bat
README.md
快速启动_Quick_Start.md
install/
  X5_Crop_Mac_install.command
  X5_Crop_win_install.bat
  X5_Crop_Mac_uninstall.command
  X5_Crop_win_uninstall.bat

X5_Crop.py 是单文件脚本。日常使用只需要把 X5_Crop.py 和对应系统启动器复制到 TIFF 文件夹。

X5_Crop.py is a single-file script. For normal use, copy only X5_Crop.py and the platform launcher into the TIFF folder.

V3.6.2 稳定版说明

V3.6.2 是当前推荐给普通用户使用的稳定发布版。它保留 V3.3.1/V3.6 系列较稳定的检测链路,并完成了低收益逻辑清理:

  • equal-broad-region 合并为普通 equal,Debug Analysis 和报告更容易读。
  • hard_fallback_detection 缩小为 review-only fallback,避免 fallback 被误解成自动通过路径。
  • 普通启动器不会开启 diagnostics;诊断能力保留给本地测试和开发分析。
  • 输出 bleed 仍然只影响最终输出,不参与检测评分。

重要限制:叠片、近似叠片、局部片距非常不稳定、分隔条缺失或画面内容连续的长图,仍可能出现误识别或不够准确的裁切。遇到这些情况,请优先运行 Debug Analysis,并人工复核裁切框;不要把这类困难图当作完全可靠的自动裁切结果。

V3.6.2 Stable Release Notes

V3.6.2 is the current stable release recommended for normal users. It keeps the relatively stable V3.3.1/V3.6 detection chain and cleans up low-value logic:

  • equal-broad-region is folded into ordinary equal, making Debug Analysis and reports easier to read.
  • hard_fallback_detection is reduced to a review-only fallback so fallback logic is not mistaken for an auto-pass path.
  • Normal launchers do not enable diagnostics; diagnostics remain available for local testing and development analysis.
  • Output bleed still applies only to final output and does not participate in detection scoring.

Important limitation: overlapped frames, near-overlap, highly irregular local frame spacing, missing separator bars, or continuous image content can still be misdetected or cropped inaccurately. For these difficult scans, run Debug Analysis first and review crop boxes manually; do not treat them as fully reliable automatic crops.

Asset

  • Package: X5-Crop-v3.6.2.zip
  • SHA256: e01ed0f7e6661690c94d29d8e1c5d18987afa256baf4fd06267587d8188c85dc