更新记录

1.0.0（2026-11-05）

• NDEF 消息解析（T 文本 / U URI 记录）与编码。
• 卡片分类（Mifare Classic/Ultralight/CPU 等，依据 SAK/ATQA）。
• AID 匹配（银联/Visa/MasterCard/交通联合）与 PAN 脱敏。
• 防克隆指纹（FNV-1a，CPU 卡）。
• 按功能级 Pro 闸门（anticlone/batchexport/transit/write）。
• 跨平台 utssdk 骨架（Android/iOS/鸿蒙，需真机编译接入）。

平台兼容性

uni-app(4.0)

NFC 读卡工具箱 Pro（zl-nfc-kit）

uni-app NFC 读卡工具箱：读取卡片 UID/ATQA/SAK、解析 NDEF 文本与 URI、Mifare/CPU 卡自动分类、AID 匹配（银联/Visa/MasterCard/交通联合）、PAN 脱敏、防克隆指纹取证。支持 Android / iOS / 鸿蒙 App 真机。

特性

• 基础读取：获取卡片 UID、ATQA、SAK，自动判定卡片技术类型。
• NDEF 解析：解析文本(T) 与 URI(U) 记录，自动解码内容。
• 卡片分类：依据 SAK/ATQA 推断 Mifare Classic/Ultralight/CPU 卡等。
• AID 匹配（Pro）：识别银联、Visa、MasterCard 及交通联合等应用，银行卡号自动脱敏。
• 防克隆取证（Pro）：CPU 卡每次读取生成基于 UID+时间戳的 FNV-1a 指纹，可结合接入方时间戳服务形成不可抵赖证据链。
• 批量导出（Pro）：读取记录一键导出 CSV。

安装

在 DCloud 插件市场 搜索 zl-nfc-kit 导入 uni_modules，在页面中引入组件即可。

快速开始

<template>
  <zl-nfc :pro="true" :enable-pro="true" />
</template>
<script>
import zlNfc from '@/uni_modules/zl-nfc-kit/components/zl-nfc/zl-nfc.vue'
export default { components: { zlNfc } }
</script>

API（纯逻辑，utils/nfc.ts 可直接调用）

性能与验收

合规说明

• 仅在本地读取并解析卡片信息，不读取、不上传任何用户隐私数据。
• 银行卡号等敏感字段默认脱敏（anonymizePan），由接入方自行决定存储与处理方式。
• 平台能力声明：Android 需 android.permission.NFC；iOS 需在 Info.plist 配置 NFC 读取权限与隐私描述；鸿蒙需开通 NFC 权限。
• 全自研实现，无第三方侵权；原生层为 UTS 接口骨架，需在 HBuilderX 真机编译接入。

付费说明

普通授权版 / 源码授权版双版本。防克隆取证、AID 解析、批量导出为 Pro 功能，需激活授权后启用。

更新说明

• 1.0.0 首发：NDEF 文本/URI 解析、卡片分类（SAK/ATQA）、AID 匹配（银联/Visa/MasterCard/交通联合）、PAN 脱敏。
• 1.1.0 深度增强：防克隆取证（FNV-1a 指纹 + 证据链）、批量导出 CSV、UTS 跨平台（Android/iOS/鸿蒙）原生层骨架、AID/URI 标准编解码。