Releases
1.2.5
mica-ppocr v1.2.5:给 OCR 结果加上「可信度」,并把新增单据的门槛降到一份 schema
Compare
Sorry, something went wrong.
No results found
feat(structured): 新增通用解析器(声明式 schema 入口)。structured/parser/generic/ 提供 OcrFieldSchema / OcrStructuredParser / OcrStructuredResult / FieldSpec / FieldRule / ValueNormalizer / ValueLocator 共 7 个类,新增单据类型写一份 schema 即可抽取字段、无需再实现解析器类,与存量 10 个强类型 parser 并行存在;取值走「标签定位 → 合并框剥值 → 正则兜底」,校验位与字段置信度复用 Validations / FieldConfidence,Spring Boot / Solon PPOcrTemplate 同步新增 generic(schema)。
feat(structured): 补齐「正确性」层 —— 结构化结果新增字段级置信度与人工复核出口:BaseStructuredResult 新增 fieldConfidences / needsReview / reviewReasons;新增 core/Validations.java 提供 GB 11643 / Luhn / GB 32100 三套校验位(PASS / FAIL / UNCHECKABLE 三态),已接入身份证、银行卡、营业执照、驾驶证四个解析器。校验不通过时置信度直接归零(不是打折) ,但字段值仍然保留 —— 丢值会让下游比现在更糟;「字段缺失」也不等于「值不可信」,是否复核由解析器按版面预期显式标记。
feat(structured): 证件号回填性别 —— 身份证号与驾驶证证号的倒数第二位即性别位(奇男偶女)。OCR 把"性别"整块漏识别时,号码本身能救回性别(FieldSource.BACKFILL),比直接留 null 有用得多。18 位取第 17 位、15 位旧证取末位。
feat(structured): 新增 core/DateRepair.java,把被 OCR 弄乱分隔符的日期还原成 yyyy-MM-dd("2015-0518"短横线被认成 0、"2015年3月5日"单位数月日补零、"2017-05-1.2"小数点把 12 拆成 1+2)。⚠️ "纯数字 8 位"路径必须排在"结构化切分"之前 (后者会把 2017-05-1.2 切成 2017-05-01,丢掉 12 的 2);非法日期宁可不修。已接入驾驶证(出生 / 初次领证 / 有效期限)与营业执照(成立日期)。
feat(structured): LabelMatcher 三增强 —— ① 相邻同排片段拼接重建标签;② 新增 core/LabelAliases.java 标签别名表,覆盖"多字 / 带空格 / 换说法"三类 OCR 走样,仅在规范标签落空时兜底 ⇒ 只增不减 、不改变既有命中行为;③ 新增 core/LabelMatchStatus.java,LabeledMatch 增加 status 字段区分 FOUND / LABEL_WITHOUT_VALUE / NOT_FOUND。⚠️ 标签查找顺序为 完整等于 > 以标签开头 > 片段拼接 > fragment 回退 > 别名兜底,拼接层必须排在 fragment 回退之前 (片段天然是标签子串,否则永不触发)。⚠️ 行为变更:命中拼接片段时返回合成框而非单个碎片框。
perf(core): Offset.area() / Offset.perimeter() 改用纯 Java 实现 —— 原先走 OpenCV Imgproc.contourArea / arcLength,每次调用都要构造 MatOfPoint2f 并跨 JNI 进入 native,单次约 550ns 且隐式依赖 native 库 ;现改为鞋带公式 + Math.hypot 边长和,单次约 12ns(≈45×),零对象分配、零 native 触达。数值逐位等价 (累加顺序与边长求和顺序严格对齐 OpenCV 源码)⇒ unclipDistance 输入不变 ⇒ 框坐标与识别文本不变,由 structured 集成测试回归锁定。顺带 OffsetTest 不再需要自行 loadOpenCv()。
feat(core): PPOcrV6Engine 构造期自动预热 —— 构造器初始化完成后自动跑一遍 det + rec 全链路,用一张 64×64 程序化合成笔画图把 ONNX Runtime 的计算图优化、内存池初始化与 JIT 提前到初始化期。实测(tiny 档,独立 JVM 各 9 次采样):首调惩罚 113ms → 23ms(消掉 80%),首个请求 688ms → 615ms,初始化期代价约 60ms。预热是引擎的初始化语义、无开关 (warmUp() 为内部方法);⚠️ 预热图尺寸取 det 的 limit_side_len(64×64),使 det 输入即预热图本身、零插值;预热失败只记 WARN,不影响引擎可用性。
fix(core): PPOcrV6Engine.close() 与在途推理的并发崩溃 —— ONNX Session 释放后底层 native 句柄被 free,与推理重叠会访问已释放内存,表现为 SIGSEGV(JVM 级崩溃,不可捕获) 。现用公平模式 ReentrantReadWriteLock 保护会话生命周期:推理入口持读锁(可并发),close() 持写锁;close() 采用有界等待 + 超时延迟释放 (默认等 1000ms,超时则引擎立即退役但不释放 native 会话,释放延后到在途推理结束),关停不会被长耗时推理拖住且绝不 use-after-free。⚠️ 行为变更:超时后在途推理可能被中断(抛 IllegalStateException)。回归测试见 PPOcrV6EngineLifecycleTest。
refactor(core): OpenCV 原生库加载收敛到 PPOcrV6Engine 构造期(ensureOpenCvLoaded()),Spring Starter / Solon Plugin 的 OpenCVNativeLoader 随之删除。openpnp 的 OpenCV 不会随 JVM 启动自动加载,原先靠各处各记得调一次 loadLocally(),漏掉则故障被推迟到首个推理请求 才以 UnsatisfiedLinkError 暴露;现改为构造期 fail fast (抛 IllegalStateException),保证「构造成功 ⇒ 推理不会撞 native 缺失」。⚠️ 行为变更:mica.ai.ppocr.enabled=false 时引擎 bean 不存在 ⇒ OpenCV 原生库不再加载 ,业务方自行使用 org.opencv.* 需自己调 loadLocally()。
fix(structured): 银行卡号校验不再放过「各位数字全同」的占位串 —— Luhn 对全零串加权和恒为 0(0 % 10 == 0)会误判为通过,导致 000000000000000000 这类票据占位符拿到满分置信度且不触发人工复核。现于 Luhn 之前加形态前置校验,各位数字全同即判 FAIL,该字段置信度直接归零并置位复核(值仍保留)。含不同数字的正常卡号判定不受影响。
fix(structured): 证件号回填出生日期不再输出非法日期 —— 号码被 OCR 认错时出生日期段可能拼出「13 月」「32 日」,此前会原样输出并因是推算来源而不触发置信度归零。现统一用 LocalDate.of 校验月份范围、当月天数与闰年规则(与 DateRepair 同一口径),非法则该字段置空而非给出一个假日期。⚠️ 行为变更:身份证号推出出生日期的格式不变,仅非法日期改为返回空。
You can’t perform that action at this time.