基于 PaddleOCR 的纯离线 OCR 识别插件，支持身份证银行卡驾驶证识别

返回数据示例

身份证正面识别结果：

{
  "name": "张三",
  "gender": "男",
  "ethnicity": "汉族",
  "birthDate": "1990 年 01 月 01 日",
  "address": "北京市朝阳区某某街道 123 号",
  "idNumber": "110101199001011234",
  "valid": true,
  "side": "front"
}

支持的证件类型

1. 身份证识别

自动判断正反面，提取完整信息：

import { parseIdCard, validateIdCard } from "@/uni_modules/lf-OCR/index.js";

const result = parseIdCard(ocrText);
if (result.side === "front") {
  // 正面：姓名、性别、民族、出生日期、地址、身份证号
  const validation = validateIdCard(result.idNumber);
  console.log("年龄:", validation.info.age);
} else {
  // 背面：签发机关、有效期限
  console.log("是否过期:", result.isExpired);
}

2. 银行卡识别

支持国内主流银行卡，自动识别银行和卡类型：

import { parseBankCard } from "@/uni_modules/lf-OCR/index.js";

const result = parseBankCard(ocrText);
console.log("卡号:", result.cardNumberFormatted); // 6222 0212 3456 7890 123
console.log("银行:", result.bankName); // 中国工商银行
console.log("类型:", result.cardType); // 借记卡

3. 驾驶证识别

支持主页和副页识别：

import { parseDriverLicense } from "@/uni_modules/lf-OCR/index.js";

const result = parseDriverLicense(ocrText);
console.log("准驾车型:", result.licenseClass); // C1
console.log("车型描述:", result.licenseClassDesc); // 小型汽车

内置校验功能

插件不仅能识别文字，还能验证证件有效性：

import { validateIdCard, validateBankCard } from "@/uni_modules/lf-OCR/index.js";

// 身份证校验（含校验码验证）
const idResult = validateIdCard("110101199001011234");
if (idResult.valid) {
  console.log("地区:", idResult.info.region);
  console.log("出生日期:", idResult.info.birthDate);
  console.log("性别:", idResult.info.gender);
  console.log("年龄:", idResult.info.age);
}

// 银行卡校验（Luhn 算法）
const bankResult = validateBankCard("6222021234567890123");
console.log("是否有效:", bankResult.valid);

扩展开发

更换 OCR 模型

支持替换为其他 ONNX 格式模型：

hybrid/html/models/
├── ppocr_det.onnx # 替换检测模型
├── ppocr_rec.onnx # 替换识别模型
└── ppocr_keys_v1.txt # 替换字典文件

新增识别模板

在 js_sdk/templates/ 目录下创建新模板，实现自定义证件解析：

// js_sdk/templates/passport.js
export function parsePassport(text, lines = []) {
  const result = {
    name: "",
    passportNumber: "",
    nationality: "",
    valid: false,
  };
  // 实现字段提取逻辑...
  return result;
}

平台兼容性

项目地址

• GitHub
• Gitee

常见问题

Q: 识别准确率如何？

A: 基于 PaddleOCR，中文识别准确率可达 95% 以上。建议使用清晰、光线充足的图片。

Q: 支持哪些证件？

A: 目前内置身份证、银行卡、驾驶证模板，同时支持通用文字识别。后续会持续更新。

Q: 如何添加新证件类型？

A: 在 js_sdk/templates/ 目录下创建新模板文件，参考现有模板实现即可。

开源协议

MIT License - 可免费用于商业项目