技能介绍

要解决的问题

手机拍摄的合同、收据、票据和书页常带有桌面背景、不均匀阴影、偏色和轻微倾斜。直接打印或归档时，这些干扰会让文字发灰、边缘脏乱、角落发暗。该技能接受一张或多张 JPG/PNG，目标不是做 OCR，而是把照片整理成白底黑字、文字清晰、边界干净的标准扫描风格结果。

处理流程与关键步骤

自动分割纸张：先用 Otsu 自动阈值分离亮纸张与暗背景；再忽略外圈 4% 边角阴影，取中心白色像素的 bounding box 裁切纸张区域。
压平光照：分通道做形态学白顶帽，估计局部背景并归一化，消除桌面反光和不均匀阴影。
增强文字：使用自适应阈值（Gaussian、block=31、C=12）与反锐化蒙版（1.5/-0.5），让笔画更黑更锐利。
清理边缘：外圈 2% 强制填白，避免残余暗斑被自适应阈值放大成黑色噪点。
参数与输出：--edge-margin 默认 0.04，是比例而非像素；值越大裁切越多，适合阴影重，值越小保留内容更多。输出默认到 scan_outputs，并展示结果供检查。

适用边界与注意点

适合合同、收据、票据、书本等需要黑白清晰归档的文档照片。它不做 OCR，不保留彩色原始效果，也不应对已经清晰的数字 PDF 重复处理。它只做裁切和增强，不做透视矫正或倾斜校正；若照片旋转明显，应先用 Hough 直线或 PCA 校正，再把校正后的图交给本技能。调参时避免用 Canny 找纸张边缘，也不要在 Otsu 二值图上过度闭运算；Otsu、4% 边距、亮区 bounding box、白顶帽去阴影和 2% 填白是这套流程的关键。