优化document-photo-to-pdf技能

This commit is contained in:
2026-10-24 23:17:33 +08:00
parent 58b9eaddd4
commit dca4e6be70
5 changed files with 807 additions and 49 deletions
@@ -15,6 +15,8 @@ P = {
"detect": {
"max_side": 1600, # 检测降采样长边;越大越准越慢
"min_edge_points": 40, # 单边拟合所需最少点数,低于则回退掩膜线
"side_support_frac": 0.25, # 单边支撑度:点数至少要达边长的这个比例,
# 不足则这条边退回矩形边(防止角点被甩飞)
"group_tol_px": 22.0, # 边线点归属容差(处理图像素)
"robust_px": 2.0, # 稳健拟合的残差基准(处理图像素)
"mask_erode_kernel": 3, # 掩膜内收核;3 = 半径 1 像素
@@ -25,6 +27,8 @@ P = {
"paper_close_div": 60, # 第一次闭运算核 = min(H,W)//该值
"paper_close_min": 5, # 形态学核最小值
"paper_close2_div": 80, # 第二次闭运算核 = min(H,W)//该值
"paper_open_div": 90, # 开运算核 = min(H,W)//该值(去布面高光碎点/细桥)
"paper_open_min": 5,
"band_div": 45, # 搜索环带宽度 = H//该值
"band_min": 15, # 环带宽度下限
"edge_local_gain": 1.55, # 边缘图局部阈值增益
@@ -42,14 +46,65 @@ P = {
"coverage_tol_min": 10,
"corner_oob_frac": 0.15, # 角点越界允许幅度(相对画面长边)
"boundary_side_margin": 0.10, # 拟合单边时排除两端各 10%,避开角点
# ---- 四边形候选择优
# 不再用“与矩形的夹角/位移上限”当门槛:真实拍摄的纸张是梯形,
# 左右两边本来就该一边内收一边外放,用矩形先验会把透视判成错误。
# 改为在 [矩形 / 掩膜边界拟合 / 边缘点拟合] 里按与纸面掩膜的 IoU 选优。
"iou_step": 2, # IoU 粗网格采样步长(处理图像素)
# ---- 贴边吸附(snap):沿每条边的法向在 ±band 内找梯度极值重拟合
"snap_enable": False, # 默认关闭:实测布面/塑料袋场景会跳到干扰结构上
"snap_band": 42, # 搜索半宽(处理图像素)
"snap_grad_min": 0.05, # 可接受的最小梯度
"snap_samples": 96, # 单边采样数
"snap_max_shift_frac": 0.10, # 吸附造成的最大角点位移(相对画面短边)
# ---- 收缝:把每条边推进到掩膜边界,去掉遗留的背景毛边
"shrink_enable": True,
"shrink_search": 80, # 向内搜索上限(处理图像素)
"shrink_max_frac": 0.05, # 单边内推上限(相对画面短边)
"shrink_keep_px": 1.5, # 留一点余量,不把自己压到纸上
# ---- 自适应纸面掩膜(替代原先固定的 v/s/floor 三件套)
# 旧实现用一组硬阈值,遇到“亮背景 + 低饱和纸张”(蓝布、塑料袋、亮桌面)
# 时背景会和纸并进同一连通域,掩膜一路贴到画面边缘,后续拟合出的
# “纸边”其实是照片边框。改为在下面这组候选里挑一个最像“一张纸”的:
# v = 亮度下限(V)、s = 饱和度上限(S)、o = Otsu 阈值的缩放系数
"mask_ladder": [
{"v": 0.50, "s": 0.45, "o": 1.00}, # 旧行为,作为兜底候选
{"v": 0.52, "s": 0.16, "o": 0.90},
{"v": 0.58, "s": 0.20, "o": 0.88},
{"v": 0.62, "s": 0.14, "o": 0.86},
{"v": 0.68, "s": 0.14, "o": 0.84},
{"v": 0.76, "s": 0.16, "o": 0.82},
],
"mask_min_bright_frac": 0.02, # 候选的原始合格像素占比下限
"mask_max_bright_frac": 0.96, # 上限:几乎全图都合格说明没分出纸
"mask_area_min": 0.02, # 掩膜面积占比合理区间
"mask_area_max": 0.90,
"mask_score": { # 候选打分权重(越大越像一张纸)
"solidity": 1.0, # 面积 / 凸包面积
"rect_fill": 1.4, # 面积 / 最小外接矩形面积
"border_touch": 3.2, # 掩膜贴画面边缘的惩罚
"aspect": 0.6, # 宽高比越接近 [0.2, 5] 越好
"contrast": 0.5, # 掩膜内外的亮暗差
},
"mask_aspect_min": 0.18, # 纸面宽高比合理区间(含横竖)
"mask_aspect_max": 5.5,
"mask_quality_max_pts": 1500, # 打分时凸包/矩形的最大采样点数(性能开关)
},
# ---------------------------------------------------------------- 几何门槛
"gate": {
"oob_max_pct": 15.0, # 越界超过此值判失败
"inner_paper_min": 0.60, # 框内纸面占比下限
"inner_edge_min": 0.75, # 每边内侧纸面占比下限
"inner_edge_min": 0.62, # 每边内侧纸面占比下限
# (旧值 0.75 对“矩形比掩膜略大”的正常情形误报;
# 旧的错位案例实测只有 0.14~0.47,0.62 仍能拦住)
"outer_dark_min": 0.35, # 外侧暗像素占比低于此值只告警
"repair": True, # 校验不过时先尝试“重拟合”而不是直接扔兜底框
"repair_fallback": "rect", # rect = 用掩膜的最小外接矩形;off = 直接兜底框
"coverage_warn": 0.40, # 四边覆盖率低于此值告警(未标定)
"aspect_deadband": 0.10, # 0.9~1.1 视为接近正方形,不参与方向投票
"paper_mismatch_pct": 20.0, # 与批次中位宽高比偏差超过此值告警