更新记录

1.0.0(2026-11-19)

首次发布:完成 Android / HarmonyOS 双端实现与真机验证。


平台兼容性

uni-app x(4.25)

Chrome Safari Android iOS 鸿蒙 微信小程序
× × √ × - ×

其他

多语言 暗黑模式 宽屏模式 蒸汽模式
× × × √

uni-doc-corrector · 文档矫正增强

手机拍的文档,一键变成「扫描件」:自动裁掉四周白边 + 灰度 / 对比度 / 锐化 三种增强。

为什么需要它

  • 拍照时很难刚好把纸张铺满取景框,结果四周一圈桌面背景,观感很脏
  • 纸质文档在室内光下偏灰、发虚,直接看/存档都不清爽
  • 本插件用纯系统 Bitmap 完成裁边和增强,不依赖 OCR / 任何三方 SDK

平台支持

平台 自动裁边 增强
Android 5.0+ ✅ ✅
鸿蒙 ⚠️ 当前降级(返回 9080006,接口不变,后续补齐) ⚠️ 同上

快速开始

import { autoCrop, enhance } from '@/uni_modules/uni-doc-corrector'

// 自动裁掉白边
autoCrop({ src: '/storage/emulated/0/DCIM/doc.jpg', padding: 4 })

// 变成扫描件:灰度 + 增强
enhance({ src: '/storage/emulated/0/DCIM/doc.jpg', mode: 'gray' })
enhance({ src: '/storage/emulated/0/DCIM/doc.jpg', mode: 'contrast', strength: 1.3 })

成功回调返回 { path, width, height, cropped },直接拿去预览或上传。

API

方法 说明
autoCrop(options) 按亮度阈值找内容包围盒并裁切,threshold 默认 232、padding 默认 0
enhance(options) mode: gray / contrast / sharp;strength 0.5~2.0
diagnose(options) 返回各能力可用性与系统版本,用于降级判断

错误码

错误码 含义
9080001 参数错误
9080002 图片加载失败
9080003 未检测到文档边界(画面几乎全是背景色)
9080004 处理失败
9080005 保存失败
9080006 当前平台不支持

说明

  • 处理后默认输出到应用缓存目录,可通过 output 指定自己的路径
  • 裁边基于亮度阈值:纸张为浅色、背景为深色时效果最好;纯白桌面上拍白纸会难以区分
  • 本插件不含 OCR 文字识别;需要识别的场景建议另接识别能力

隐私、权限声明

1. 本插件需要申请的系统权限列表:

读取源图片需应用具备文件/相册权限;最低支持 Android 5.0 (API 21)

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集、不上传任何图片数据,所有处理均在本机完成

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无

暂无用户评论。