Skip to content

X5 Crop v4.0

Choose a tag to compare

View all tags
@rrriiicccooo rrriiicccooo released this 08 Jun 03:08
· 7 commits to main since this release
v4.0
16dba1a

中文说明

V4.0 是当前稳定发布版。它把源码重写成模块化 V4 架构，但 Release 包继续提供单文件 X5_Crop.py，普通用户仍然只需要脚本本体和对应系统启动器。

请下载本页面 Assets 里的 X5-Crop-v4.0.zip。不要下载 GitHub 自动生成的 Source code / 源码压缩包；源码包是开发结构，不是整理好的用户发布包。

脚本不会修改原始 TIFF。自动裁切会生成新文件；进入 needs_review/ 的文件是原 TIFF 副本，方便人工处理。

快速使用

  1. 解压 X5-Crop-v4.0.zip。
  2. 第一次使用先运行安装启动器：
    • macOS: 双击 install/X5_Crop_Mac_install.command
    • Windows: 双击 install\X5_Crop_win_install.bat
  3. 安装完成后，把 X5_Crop.py、对应系统主启动器和 TIFF 长图放在同一个文件夹：
    • macOS 主启动器：X5_Crop_Mac.command
    • Windows 主启动器：X5_Crop_win.bat
  4. 双击主启动器，按提示选择 format、partial mode 和 Debug Analysis。

Release 包内容

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

Release 里的 X5_Crop.py 是单文件发布版，已经内置内部 x5crop/ 代码。普通用户不需要复制 x5crop/ 文件夹。

V4.0 主要变化

  • 模块化 V4 架构：检测、几何、证据缓存、TIFF I/O、Debug Analysis、report 复用、deskew、CLI 和 regression 已拆分到 x5crop/ 内部模块。
  • Release 包继续保持简单：只包含单文件脚本、两个主启动器、两个安装器、两个卸载器、README 和快速启动文档。
  • 全量 135 default-deskew dry run 对比 V3.9：status、confidence、review_reasons、outer_box、frame_boxes 和 gaps 为 0 diff。
  • 相比 V3.6.2 稳定版，V4 保留后续开发中已验证的保守修正，例如 lucky-pass 风险样本进入 REVIEW、部分红框/外框路径更稳。
  • 默认输出 bleed：长轴 20px，短轴 10px；如果检测到叠片、近似叠片或连续内容风险，长轴输出 bleed 会自动提高到 50px。bleed 只影响最终输出，不参与检测评分。
  • 文档明确说明：自动裁切输出 TIFF 会保留原 TIFF 的画质相关属性，包括位深、通道结构、ICC / 色彩空间、resolution 和 metadata；裁切不会主动降位深、改色、压缩或重采样。
  • Release 包内用户文档改为 README.txt 和 快速启动_Quick_Start.txt，方便不同系统直接打开阅读；仓库源文档仍保留 Markdown 格式。
  • 文档结构更清晰：README 作为完整用户手册，不再重复快速启动步骤和版本更新日志；快速操作见 快速启动_Quick_Start.md，版本差异见 CHANGELOG.md。
  • 当前版本主要针对普通 135 全量回归测试和优化；其它 format 可用，但建议先用 Debug Analysis 检查。

已知限制

  • 叠片、近似叠片、局部片距不稳定、分隔条缺失、连续画面内容等困难场景仍可能误识别。
  • 对不确定图片，请使用 Debug Analysis dry run，并人工复核。

文件校验

  • Package: X5-Crop-v4.0.zip
  • SHA256: 400341479f53da639262f1c521fba17d3fb259a7562ca32fca964cc1c6f4630b

English

V4.0 is the current stable release. The source code has been rewritten into the modular V4 architecture, while the Release package still ships a standalone X5_Crop.py so normal users only need the script and platform launcher.

Download X5-Crop-v4.0.zip from Assets on this page. Do not use GitHub's auto-generated Source code zip; that is the development source layout, not the prepared user package.

Original TIFF files are not modified. Auto crops are written as new files; files copied into needs_review/ are original-file copies for manual handling.

Quick Start

  1. Unzip X5-Crop-v4.0.zip.
  2. On first use, run the installer launcher:
    • macOS: double-click install/X5_Crop_Mac_install.command
    • Windows: double-click install\X5_Crop_win_install.bat
  3. After installation, place X5_Crop.py, the platform main launcher, and your long TIFF scans in the same folder:
    • macOS main launcher: X5_Crop_Mac.command
    • Windows main launcher: X5_Crop_win.bat
  4. Double-click the main launcher and choose the film format, partial mode, and Debug Analysis options.

Package Contents

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

The Release X5_Crop.py is a standalone file with the internal x5crop/ code embedded. Normal users do not need to copy an x5crop/ folder.

V4.0 Highlights

  • Modular V4 architecture: detection, geometry, evidence cache, TIFF I/O, Debug Analysis, report reuse, deskew, CLI, and regression now live in dedicated x5crop/ modules.
  • Simple Release package: standalone script, two main launchers, two installers, two uninstallers, README, and quick-start guide.
  • Full 135 default-deskew dry run against V3.9: 0 diffs for status, confidence, review_reasons, outer_box, frame_boxes, and gaps.
  • Compared with the V3.6.2 stable release, V4 keeps later conservative improvements, including lucky-pass risk review gating and more stable red-gap / outer paths in known cases.
  • Default output bleed: 20px on the long axis and 10px on the short axis. When overlap, near-overlap, or continuous-content risk is detected, long-axis output bleed is automatically raised to 50px. Bleed affects output only, not detection scoring.
  • Documentation now states explicitly that auto-cropped TIFF output preserves source-TIFF quality-related attributes, including bit depth, channel layout, ICC / color space, resolution, and metadata. Cropping does not intentionally lower bit depth, recolor, compress, or resample image data.
  • User documents inside the Release package now ship as README.txt and 快速启动_Quick_Start.txt for easier reading across systems. Repository source documents remain Markdown files.
  • Cleaner documentation structure: README is now the full user manual and no longer repeats quick-start steps or changelog-style version notes; quick operation steps live in 快速启动_Quick_Start.md, and version differences live in CHANGELOG.md.
  • This version is primarily optimized and regression-tested for normal 135 scans. Other formats are available, but Debug Analysis is recommended.

Known Limitations

  • Overlap, near-overlap, locally irregular spacing, missing separators, and continuous image content can still be misdetected.
  • Use Debug Analysis dry run and manually review uncertain scans.

Verification

  • Package: X5-Crop-v4.0.zip
  • SHA256: 400341479f53da639262f1c521fba17d3fb259a7562ca32fca964cc1c6f4630b
Assets 3
Loading