在 Finder 中右键一张或多张票据照片，自动完成文档边缘识别、透视矫正、残余歪斜纠正和彩色扫描增强，并在原图旁生成 JPEG 与 PDF。
Right-click photographed invoices or documents in Finder to detect the paper, correct perspective and residual skew, enhance them in a color scan style, and export JPEG and PDF files locally.
- Finder 快速操作，一次点击完成处理
- 使用 macOS 原生 Vision 自动识别票据和纸张四角
- 两级自动矫正：先拉正斜拍和梯形透视，再保持纸张直立并根据文字行与表格线纠正残余歪斜
- 压平阴影与偏色，提白纸张背景，增强文字和表格线
- 保留红章、蓝章、签名等原始颜色
- 同时生成高质量 JPEG 和单页 A4 PDF
- 支持一次选择多张图片，绝不覆盖原图
- 完全本地处理，不上传照片，不常驻后台
左侧为带有倾斜、暖色偏色和不均匀阴影的模拟手机照片；右侧为自动裁边、透视矫正和彩色扫描增强后的结果。
- macOS 15 或更高版本
- Xcode 或 Xcode Command Line Tools
- 已在 Apple Silicon Mac 上测试
克隆仓库并运行安装脚本：
git clone https://github.com/ethansunqing/macos-invoice-auto-scan.git
cd macos-invoice-auto-scan
./install.sh安装完成后，在 Finder 中选中 JPEG、PNG、HEIC 或其他图片，右键选择：
快速操作 → 发票自动裁剪（图片+PDF）
程序会在原图旁生成：
原文件名_自动裁剪.jpg
原文件名_自动裁剪.pdf
如文件已存在，会自动追加序号，不会覆盖已有文件。
安装后也可以直接调用：
"$HOME/Library/Application Support/InvoiceAutoCrop/invoice-autocrop" photo.jpg可用参数：
--both 同时输出 JPEG 和 PDF（默认）
--image-only 仅输出 JPEG
--pdf-only 仅输出 PDF
--no-enhance 不做彩色扫描增强，保留裁边和两级纠偏
--no-deskew 关闭文字行/表格线二次纠偏
--output-dir 指定输出目录
./uninstall.shVNDetectDocumentSegmentationRequest检测文档边缘。CIPerspectiveCorrection完成透视矫正。- 分析文字基线和表格横线的投影集中度，在可靠范围内自动完成小角度二次纠偏。
- 大范围背景估计与局部光照归一化消除拍照阴影和偏色。
- 保留颜色的对比度、降噪和锐化处理产生扫描效果。
- ImageIO 与 Core Graphics 输出 JPEG 和 A4 PDF。
检测不到可靠纸张边缘时，程序会保留整张图片，避免错误裁切。
所有图像处理均在本机完成。程序不联网、不收集数据、不上传文件。