更新记录
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 文字识别;需要识别的场景建议另接识别能力