Skip to content

X5 Crop v4.0.1

Latest
Latest

Choose a tag to compare

View all tags
@rrriiicccooo rrriiicccooo released this 09 Jun 08:11
· 1 commit to main since this release
v4.0.1
b9940a8

X5 Crop v4.0.1

中文说明

V4.0.1 是 V4.0 之后的窄范围兼容更新，重点解决普通 135 长图里“肉眼分隔很清楚，但黑色片距比旧规则更宽”的情况。

快速使用

  1. 下载本 Release 的 X5-Crop-v4.0.1.zip，不要下载 GitHub 自动生成的 Source code 压缩包。
  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。

本版更新

  • 新增正式 wide-separator 分支，用于普通 135 full strip 的宽黑色分隔条。
  • 默认窄分隔检测仍保持 V4.0 行为；只有普通 separator 候选没有通过 auto gate 时，才尝试宽分隔条。
  • wide-separator 要求黑带均值和相对突出度达标，并单独记录为 wide_detected_gaps / wide_gap_retry。
  • 包含宽分隔条的候选有轻微 confidence cap，避免宽黑带把困难图误推成过高置信。
  • wide-separator 只对普通 135 full strip 启用；half、xpan、120 和 135-dual 暂不启用。
  • 新增仓库内诊断启动器 X5_Crop_Mac_diagnostics.command，用于本地开发测试；它不会放进用户 Release 包。

验证结果

  • python3 X5_Crop.py --version 输出 X5_Crop.py 4.0.1。
  • python3 -m py_compile X5_Crop.py x5crop/*.py x5crop/detection/*.py x5crop/debug/*.py 通过。
  • 新增 4 张宽片距 135 样本从 V4.0 的 needs_review 变为 4 个 approved_auto，报告里均出现宽分隔相关记录。
  • 既有全量 Test/135 dry run 保持 42 个 approved_auto / 6 个 needs_review。
  • 使用 python3 -m x5crop.regression 对比既有 135 报告和 V4.0.1 临时报告，48 行在 status、confidence、review_reasons、outer_box、frame_boxes、gaps 上均为 0 diff。
  • Release zip 只包含用户需要的脚本、启动器、TXT 文档和 install 目录；不包含 x5crop/、archive、CHANGELOG、AGENTS、LICENSE、诊断启动器或测试输出。

包校验

X5-Crop-v4.0.1.zip SHA-256：

5496ecf79fd725f20f487569e0ffb560496f52350e9e9fdfcd1fdeb836c9c5cf

English Notes

V4.0.1 is a narrow compatibility update after V4.0. It focuses on normal 135 strips where the gutter is visually clear but wider than the previous separator-width rule allowed.

Quick Start

  1. Download X5-Crop-v4.0.1.zip from this Release. Do not use GitHub’s auto-generated Source code zip.
  2. On first use, run the installer launcher: on macOS, double-click install/X5_Crop_Mac_install.command; on Windows, double-click install/X5_Crop_win_install.bat.
  3. After installation, place X5_Crop.py and the platform launcher in the TIFF strip folder: X5_Crop_Mac.command for macOS, X5_Crop_win.bat for Windows.
  4. Double-click the main launcher and choose format, partial mode, and Debug Analysis when prompted.

Changes

  • Adds the formal wide-separator branch for wide dark gutters in normal 135 full strips.
  • Keeps the default narrow-separator behavior from V4.0; wide separator retry only runs when the normal separator candidate fails the auto gate.
  • Requires accepted wide separators to satisfy mean-score and relative-prominence gates, and records them as wide_detected_gaps / wide_gap_retry.
  • Applies a light confidence cap to candidates containing wide separators, so wide gutters do not inflate confidence too aggressively.
  • Enables wide-separator only for normal 135 full strips; half-frame, xpan, 120 formats, and 135-dual remain disabled for now.
  • Adds the repository diagnostic launcher X5_Crop_Mac_diagnostics.command for local development testing; it is not included in user Release packages.

Verification

  • python3 X5_Crop.py --version prints X5_Crop.py 4.0.1.
  • python3 -m py_compile X5_Crop.py x5crop/*.py x5crop/detection/*.py x5crop/debug/*.py passed.
  • Four new wide-gutter 135 samples changed from V4.0 needs_review to 4 approved_auto, with wide-separator records in the reports.
  • The existing full Test/135 dry run remained 42 approved_auto / 6 needs_review.
  • python3 -m x5crop.regression compared the existing 135 report against the V4.0.1 temporary report, with 0 diffs across all 48 rows for status, confidence, review_reasons, outer_box, frame_boxes, and gaps.
  • The Release zip contains only the user-facing script, launchers, TXT docs, and install folder; it excludes x5crop/, archive snapshots, CHANGELOG, AGENTS, LICENSE, diagnostic launcher, and test outputs.

Package Checksum

X5-Crop-v4.0.1.zip SHA-256:

5496ecf79fd725f20f487569e0ffb560496f52350e9e9fdfcd1fdeb836c9c5cf
Assets 3
Loading