更新记录

1.0.0（2026-11-05）

• 首发：实名认证一体（人脸活体 + 证件 OCR + 人证比对），分步引导交互，付费闸门，引擎可插拔（ML Kit/Vision），合规最小化。

平台兼容性

uni-app(4.0)

zl-kyc-pro 实名认证一体 Pro

uni-app 实名认证一体化组件：人脸活体检测 + 身份证/银行卡 OCR + 人证 1:1 比对。 版本：v1.0.0 ｜ 类型：UTS 插件（component-uts）｜ 授权：普通授权版 + 源码授权版 ｜ 仅 App 端

功能特性

• 人脸活体检测（双模式）：动作活体（眨眼/转头等）+ 静默活体（防照片/视频翻拍）；口罩/眼镜鲁棒。
• 证件 OCR：身份证人像面/国徽面 + 银行卡；自动字段映射（姓名/身份证号/出生日期/性别/住址/有效期/卡号/银行）。
• 人证 1:1 比对：现场人脸特征 vs 证件照特征比对，返回相似度与阈值判定。
• 离线 + 在线双模：默认纯本地（不采集上传）；可选自有服务端转发权威库比对。
• 分步引导交互：隐私告知 → 活体 → 证件 → 结果；逐步反馈、失败分类提示、单步重试。
• 付费闸门：证件 OCR 免费；人脸活体 + 人证比对为 Pro（enablePro/licenseKey/licenseApi 三级校验）。

平台兼容

App-Android、App-iOS（仅 App；活体与 OCR 依赖原生相机能力）。

快速上手

将 zl-kyc-pro 放入项目 uni_modules 目录，页面引入组件：

<zl-kyc
  :enable-pro="true"
  :with-compare="true"
  :doc-types="['idcard_front', 'idcard_back', 'bankcard']"
  @done="onDone" @cancel="onCancel" @buy="onBuy"
/>

或调用编排 API（utils/kyc.ts）：

import { runKyc, mapOcrFields, parseIdNo, cosineSimilarity } from '@/uni_modules/zl-kyc-pro/utils/kyc'
const r = await runKyc({ withCompare: true, livenessMode: 'action' }, undefined, { onStep: (s) => console.log(s) })
// r: { ok, step, liveness, ocr, match, markDemo, elapsedMs }

组件 Props / 事件

事件：@done(KycResult)、@cancel()、@buy()。

引擎接入（真机）

• Android：utssdk/app-android 接入 Google ML Kit（Face Detection / Text Recognition，免费、Apache-2.0 合规），经 uni-app 仓储引入依赖，实现 detectFaces/recognizeText/compareFeatures 后置 getCapability().ready=true。
• iOS：utssdk/app-ios 接入 Apple Vision 框架（系统、免费），实现同接口后置 ready=true。
• 未接入引擎：JS 层走纯本地演示兜底（markDemo=true），仅演示完整流程，非真实识别。

Android 权限与合规声明

• CAMERA（人脸活体 / 证件采集）；iOS 相机权限（用户主动触发时系统弹窗授权）。
• 人脸属敏感个人信息：默认纯本地模式，仅提取特征值、不上传原始人脸图像；如需权威库比对，经自有服务端（server/kyc-reference.js）HMAC 验签 + 转发，前端零敏感凭证。
• 引擎全部使用系统/开源合规许可（ML Kit Apache-2.0 / Vision 系统框架），不引入无授权商业 SDK。
• 不采集、不存储用户画像数据；证件 OCR 仅本机识别、结果由用户确认后回填。

性能目标（真机验收）

活体 ≤300ms｜证件 OCR ≤1.5s｜人证比对 ≤500ms｜冷启动 ≤1.2s｜模型包体 ≤15MB。

常见问题

• Q：能否上架到 H5/小程序？ A：活体与证件 OCR 依赖原生相机能力，仅 App 端支持。
• Q：人脸图像会上传吗？ A：默认仅提取特征值，不上传原始人脸图像；是否比对由接入方自有服务决定。

变更记录

见 CHANGELOG.md。