vite-uni-dev-tool 1.1.0 → 1.2.0

package/dist/v3/hooks/useNFC/utils.ts

@@ -1,754 +1,754 @@
-// 创建一个 ArrayBuffer 并查看其值
-export function transformArrayBuffer(buffer: ArrayBuffer): NFC.TransformId {
-  if (!buffer) {
-    return {
-      byteArray: [],
-      hexArray: [],
-      hexString: '',
-    };
-  }
-
-  // 将 ArrayBuffer 转为 Uint8Array（按字节读取）
-  const uint8Array = new Uint8Array(buffer);
-
-  // 方式1：转为普通数组
-  const byteArray = Array.from(uint8Array);
-  // console.log('ArrayBuffer 字节值（十进制）:', byteArray);
-
-  // 方式2：转为十六进制（NFC 场景常用，因为 NFC 数据多以十六进制展示）
-  const hexArray = byteArray.map((byte) =>
-    byte.toString(16).padStart(2, '0').toUpperCase(),
-  );
-
-  const hexString = hexArray.join(':');
-
-  return {
-    byteArray,
-    hexArray,
-
-    hexString,
-  };
-}
-
-/**
- * 将字节数组转换为字符串
- *
- * @export
- * @param {number[]} bytes
- * @return {*}
- */
-export function byteToString(bytes: number[]) {
-  return bytes.map((byte) => String.fromCharCode(byte)).join('');
-}
-
-/**
- * 将字符串转换为字节数组
- *
- * @export
- * @param {string} str
- * @return {*}  {number[]}
- */
-export function stringToBytes(str: string): number[] {
-  return Array.from(str).map((char) => char.charCodeAt(0));
-}
-
-export function stringToArrayBuffer(str: string): ArrayBuffer {
-  const bytes = stringToBytes(str); // 使用现有工具函数
-  const uint8Array = new Uint8Array(bytes);
-  return uint8Array.buffer.slice(
-    uint8Array.byteOffset,
-    uint8Array.byteOffset + uint8Array.byteLength,
-  );
-}
-
-export function arrayNumberToArrayBuffer(numbers: number[]): ArrayBuffer {
-  const buffer = new ArrayBuffer(numbers.length);
-  const view = new DataView(buffer);
-  numbers.forEach((number, index) => {
-    view.setUint8(index, number);
-  });
-  return buffer;
-}
-
-// 可以添加解析函数来解析 ATQA 信息
-export function parseAtqa(atqaBuffer: ArrayBuffer) {
-  const uint8Array = new Uint8Array(atqaBuffer);
-  if (uint8Array.length < 2) return null;
-
-  const byte1 = uint8Array[0];
-  const byte2 = uint8Array[1];
-
-  return {
-    uidType: (byte1 >> 7) & 0x01, // UID 类型
-    storageSize: (byte1 >> 4) & 0x07, // 存储大小编码
-    manufacturer: byte1 & 0x0f, // 制造商代码
-    cardFeatures: (byte2 >> 4) & 0x0f, // 功能特性
-    reserved: byte2 & 0x0f, // 保留位
-  };
-}
-
-export function parseAtqaAndroid(atqa: number[]) {
-  const byte1 = atqa[0];
-  const byte2 = atqa[1];
-  return {
-    uidType: (byte1 >> 7) & 0x01, // UID 类型
-    storageSize: (byte1 >> 4) & 0x07, // 存储大小编码
-    manufacturer: byte1 & 0x0f, // 制造商代码
-    cardFeatures: (byte2 >> 4) & 0x0f, // 功能特性
-    reserved: byte2 & 0x0f, // 保留位
-  };
-}
-
-/**
- * 获取 SAK 类型
- *
- * @export
- * @param {number} sak
- * @return {*}
- */
-export function getSakType(sak: number) {
-  switch (sak) {
-    case 0x00:
-      return '未指定类型';
-    case 0x08:
-      return 'Mifare Classic 1K';
-    case 0x09:
-      return 'Mifare Classic Mini';
-    case 0x10:
-      return 'Mifare Plus';
-    case 0x11:
-      return 'Mifare Classic 4K';
-    case 0x18:
-      return 'Mifare Ultralight / Ultralight C';
-    case 0x20:
-      return 'DESFire';
-    default:
-      return '未知';
-  }
-}
-
-export function getSakHex(sak: number) {
-  return '0x' + (sak < 16 ? '0' : '') + sak.toString(16).toUpperCase();
-}
-
-/** 获取读写标准 */
-export function getReadWriteStandard(nfcTypes: NFC.NfcType[]) {
-  return nfcTypes.map((nfcType) => {
-    switch (nfcType) {
-      case 'NFC-A':
-      case 'MIFARE Classic':
-      case 'MIFARE Ultralight':
-        return 'ISO 14443-3A';
-      case 'NFC-B':
-        return 'ISO 14443-3B';
-      case 'NFC-F':
-        return 'ISO 14443-3F';
-      case 'NFC-V':
-        return 'ISO 15693';
-      case 'Ndef':
-      case 'NDEF':
-        return 'NDEF';
-      case 'ISO-DEP':
-        return 'ISO 14443-4';
-      case 'Ndef Formatable':
-        return 'NDEF Formatable';
-      default:
-        return '未知';
-    }
-  });
-}
-
-export function getAndroidTechs(techs: string[]) {
-  return techs.map((tech) => {
-    switch (tech) {
-      case 'android.nfc.tech.IsoDep':
-        return 'ISO-DEP';
-      case 'android.nfc.tech.MifareClassic':
-        return 'MIFARE Classic';
-      case 'android.nfc.tech.MifareUltralight':
-        return 'MIFARE Ultralight';
-      case 'android.nfc.tech.NfcA':
-        return 'NFC-A';
-      case 'android.nfc.tech.NfcB':
-        return 'NFC-B';
-      case 'android.nfc.tech.NfcF':
-        return 'NFC-F';
-      case 'android.nfc.tech.NfcV':
-        return 'NFC-V';
-      case 'android.nfc.tech.Ndef':
-        return 'Ndef';
-      case 'android.nfc.tech.NdefFormatable':
-        return 'Ndef Formatable';
-      default:
-        return '';
-    }
-  });
-}
-
-export function getTnfDescription(tnf: string) {
-  switch (tnf) {
-    case '0':
-      return 'TNF_EMPTY';
-    case '1':
-      return 'TNF_WELL_KNOWN';
-    case '2':
-      return 'TNF_MIME_MEDIA';
-    case '3':
-      return 'TNF_ABSOLUTE_URI';
-    case '4':
-      return 'TNF_EXTERNAL_TYPE';
-    case '5':
-      return 'TNF_UNKNOWN';
-    case '6':
-      return 'TNF_UNCHANGED';
-    case '7':
-      return 'TNF_RESERVED';
-    default:
-      return '未知';
-  }
-}
-
-/**
- * 获取URI记录的具体类型描述
- * @param prefixCode - URI前缀代码（payload的第一个字节）
- * @returns URI类型描述
- */
-function getUriTypeDescription(prefixCode: number): string {
-  const uriPrefixes: { [key: number]: string } = {
-    0x00: '未指定（纯URI）',
-    0x01: 'http://www.', // http://www.
-    0x02: 'https://www.', // https://www.
-    0x03: 'http://', // http://
-    0x04: 'https://', // https://
-    0x05: 'tel:', // tel: (电话号码)
-    0x06: 'mailto:', // mailto: (邮箱地址)
-    0x07: 'ftp://anonymous:anonymous@', // ftp://anonymous:anonymous@
-    0x08: 'ftp://ftp.', // ftp://ftp.
-    0x09: 'ftps://', // ftps://
-    0x0a: 'sftp://', // sftp://
-    0x0b: 'smb://', // smb://
-    0x0c: 'nfs://', // nfs://
-    0x0d: 'ftp://', // ftp://
-    0x0e: 'dav://', // dav://
-    0x0f: 'news:', // news:
-    0x10: 'telnet://', // telnet://
-    0x11: 'imap:', // imap:
-    0x12: 'rtsp://', // rtsp://
-    0x13: 'urn:', // urn:
-    0x14: 'pop:', // pop:
-    0x15: 'sip:', // sip:
-    0x16: 'sips:', // sips:
-    0x17: 'tftp:', // tftp:
-    0x18: 'btspp://', // btspp:// (Bluetooth)
-    0x19: 'btl2cap://', // btl2cap:// (Bluetooth)
-    0x1a: 'btgoep://', // btgoep:// (Bluetooth)
-    0x1b: 'tcpobex://', // tcpobex://
-    0x1c: 'irdaobex://', // irdaobex://
-    0x1d: 'file://', // file://
-    0x1e: 'urn:epc:id:', // urn:epc:id:
-    0x1f: 'urn:epc:tag:', // urn:epc:tag:
-    0x20: 'urn:epc:pat:', // urn:epc:pat:
-    0x21: 'urn:epc:raw:', // urn:epc:raw:
-    0x22: 'urn:epc:', // urn:epc:
-    0x23: 'urn:nfc:', // urn:nfc:
-  };
-
-  return uriPrefixes[prefixCode] || '未知';
-}
-
-/** 定义 URI 前缀映射表 */
-const uriPrefixMap: { [key: string]: number } = {
-  '': 0x00, // 未指定协议
-  'http://www.': 0x01,
-  'https://www.': 0x02,
-  'http://': 0x03,
-  'https://': 0x04,
-  'tel:': 0x05, // 电话号码
-  'mailto:': 0x06, // 邮箱地址
-  'ftp://anonymous:anonymous@': 0x07,
-  'ftp://ftp.': 0x08,
-  'ftps://': 0x09,
-  'sftp://': 0x0a,
-  'smb://': 0x0b,
-  'nfs://': 0x0c,
-  'ftp://': 0x0d,
-  'dav://': 0x0e,
-  'news:': 0x0f,
-  'telnet://': 0x10,
-  'imap:': 0x11,
-  'rtsp://': 0x12,
-  'urn:': 0x13,
-  'pop:': 0x14,
-  'sip:': 0x15,
-  'sips:': 0x16,
-  'tftp:': 0x17,
-  'btspp://': 0x18,
-  'btl2cap://': 0x19,
-  'btgoep://': 0x1a,
-  'tcpobex://': 0x1b,
-  'irdaobex://': 0x1c,
-  'file://': 0x1d,
-  'urn:epc:id:': 0x1e,
-  'urn:epc:tag:': 0x1f,
-  'urn:epc:pat:': 0x20,
-  'urn:epc:raw:': 0x21,
-  'urn:epc:': 0x22,
-  'urn:nfc:': 0x23,
-};
-
-/**
- * 创建 URI 类型的 NDEF 记录
- * 根据 NFC Forum URI Record Type Definition 规范
- *
- * @param uri 完整的 URI 字符串，如 "tel:18888888888", "https://www.example.com"
- * @returns NDEF 记录对象
- */
-export function createUriNdefRecord(uri: string): NFC.NdefRecord {
-  let prefix = '';
-  let suffix = uri;
-
-  // 查找匹配的前缀
-  for (const [protocol, _code] of Object.entries(uriPrefixMap)) {
-    if (uri.startsWith(protocol) && protocol.length > prefix.length) {
-      prefix = protocol;
-    }
-  }
-
-  // 提取 URI 后缀部分
-  if (prefix) {
-    suffix = uri.substring(prefix.length);
-  }
-
-  // 获取前缀代码
-  const prefixCode = uriPrefixMap[prefix] || 0x00;
-
-  // 构建 payload：前缀代码 + 剩余 URI
-  const payloadArray = [prefixCode];
-  if (suffix) {
-    // 将后缀字符串转换为字节数组
-    const suffixBytes = stringToBytes(suffix);
-    payloadArray.push(...suffixBytes);
-  }
-
-  return {
-    tnf: 1, // TNF_WELL_KNOWN
-    type: 'U', // URI 类型
-    payload: arrayNumberToArrayBuffer(payloadArray),
-  };
-}
-
-export function getTypeDescription(type: string, payload?: number[]) {
-  switch (type) {
-    case 'T':
-      return '文本记录';
-    case 'U':
-      // URI记录需要根据payload的第一个字节确定具体类型
-      if (payload && payload.length > 0) {
-        const uriPrefixCode = payload[0]; // 第一个字节是URI前缀代码
-        return getUriTypeDescription(uriPrefixCode);
-      }
-      return 'URI记录';
-    case 'Sp':
-      return 'Smart Poster记录';
-    case 'Sig':
-      return '签名记录';
-    case 'application/vnd.wfa.wsc':
-      return 'Wi-Fi Simple Configuration记录';
-    case 'android.com:pkg':
-      return 'Android 包名记录';
-    case 'text/vcard':
-      return 'VCard 记录';
-    default:
-      // 如果是 MIME 类型格式，可以返回更具体的描述
-      if (type.startsWith('application/')) {
-        return `应用数据类型: ${type}`;
-      } else if (type.startsWith('text/')) {
-        return `文本数据类型: ${type}`;
-      } else if (
-        type.startsWith('image/') ||
-        type.startsWith('video/') ||
-        type.startsWith('audio/')
-      ) {
-        return `媒体数据类型: ${type}`;
-      }
-      return '未知';
-  }
-}
-
-/**
- * 通用 TLV 解析配置项接口
- * 支持自定义各类 TLV 解析规则，适配不同格式数据
- */
-interface TLVParseConfig {
-  // 合法 TLV 的 Type 高字节标识（默认：0x10，对应 NFC WiFi 数据）
-  legalTypeHigh?: number;
-  // 需要跳过的无效 TLV 类型（低字节）列表
-  skipTlvTypes?: number[];
-  // 长度解析策略（支持自定义，适配标准大端/低字节有效/高字节有效等）
-  lengthParseStrategy: (lengthHigh: number, lengthLow: number) => number;
-  // 目标 TLV 类型映射（键：TLV 低字节类型，值：字段名称 + 数据转换函数）
-  targetTlvMap: Record<
-    number,
-    {
-      fieldName: string;
-      converter: (valueBytes: number[]) => any;
-    }
-  >;
-}
-
-/**
- * 通用 TLV 解析工具函数
- * 可适配 NFC 门禁卡、公交卡、WiFi 数据等各类 TLV 格式数据
- * @param tlvBytes 原始 TLV 字节数组
- * @param config 自定义解析配置项
- * @returns 解析后的结果对象（键：配置中定义的 fieldName，值：转换后的数据）
- */
-export function parseUniversalTLV(
-  tlvBytes: number[],
-  config: TLVParseConfig,
-): Record<string, any> {
-  // 配置项默认值填充
-  const finalConfig = {
-    legalTypeHigh: 0x10,
-    skipTlvTypes: [],
-    ...config,
-  };
-
-  // 存储解析结果
-  const parseResult: Record<string, any> = {
-    raw: tlvBytes,
-  };
-  const byteLength = tlvBytes.length;
-  let index = 0;
-
-  // 循环解析 TLV 数据（核心：按配置项灵活解析）
-  while (index < byteLength) {
-    // 1. 校验是否有足够字节读取 Type（2 字节）
-    if (index + 1 >= byteLength) {
-      break;
-    }
-
-    const typeHigh = tlvBytes[index];
-    const typeLow = tlvBytes[index + 1];
-    const currentType = typeLow;
-
-    // 2. 过滤非法 TLV（非配置指定的高字节标识）
-    if (typeHigh !== finalConfig.legalTypeHigh) {
-      index++;
-      continue;
-    }
-
-    // 3. 跳过配置中指定的无效 TLV（直接跳过头部 4 字节：Type2 + Length2）
-    if (finalConfig.skipTlvTypes?.includes(currentType)) {
-      index += 4;
-      continue;
-    }
-
-    // 4. 步进 Type 字节（2 字节），准备读取 Length
-    index += 2;
-    if (index + 1 >= byteLength) {
-      break;
-    }
-
-    // 5. 按自定义策略解析 Length（灵活适配不同格式）
-    const lengthHigh = tlvBytes[index];
-    const lengthLow = tlvBytes[index + 1];
-    const currentLength = finalConfig.lengthParseStrategy(
-      lengthHigh,
-      lengthLow,
-    );
-
-    // 6. 步进 Length 字节（2 字节），准备读取 Value
-    index += 2;
-    if (index + currentLength > byteLength) {
-      break;
-    }
-
-    // 7. 读取 Value 部分（按自定义长度截取）
-    const currentValue = tlvBytes.slice(index, index + currentLength);
-
-    // 8. 强制步进 Value 字节（避免索引卡死，确保遍历完整性）
-    index += currentLength;
-
-    // 9. 按自定义映射转换目标 TLV 数据
-    const targetTlvConfig = finalConfig.targetTlvMap[currentType];
-    if (targetTlvConfig) {
-      try {
-        const convertedData = targetTlvConfig.converter(currentValue);
-        parseResult[targetTlvConfig.fieldName] = convertedData;
-      } catch (_e) {
-        parseResult[targetTlvConfig.fieldName] = null;
-      }
-    }
-  }
-
-  return parseResult;
-}
-
-/**
- * 辅助工具：修正 authType 转换逻辑，适配 32（0x20）等新值
- */
-const TLVConverterTools = {
-  // 1. 字节数组 → UTF-8 字符串（保持原有）
-  bytesToUtf8String: (bytes: number[]): string => {
-    try {
-      return new TextDecoder('utf-8', { fatal: false }).decode(
-        new Uint8Array(bytes),
-      );
-    } catch (_e) {
-      return bytes.map((byte) => String.fromCharCode(byte)).join('');
-    }
-  },
-
-  // 2. 字节数组 → WIFI 认证类型（核心修正：添加 32（0x20）的映射）
-  bytesToWifiAuthType: (bytes: number[]): string => {
-    // 适配当前字节数组的 [0, 32]，取有效数据（低字节优先，与格式一致）
-    const authValue = bytes.length >= 2 ? bytes[1] || bytes[0] : bytes[0];
-    console.log(
-      `[authType 解析] 原始标识值：${authValue}（十六进制：0x${authValue.toString(16).padStart(2, '0')}`,
-    );
-
-    switch (authValue) {
-      case 1:
-        return 'OPEN (无认证)';
-      case 2:
-      case 34: // 0x22：原有 WPA2-Personal
-        return 'WPA2-Personal';
-      case 32: // 0x20：新增，适配当前字节数组的 authType 值
-        return 'WPA-Personal (兼容 WPA2)';
-      case 3:
-        return 'WPA-Personal';
-      default:
-        return `未知认证类型（0x${authValue.toString(16).padStart(4, '0')}`;
-    }
-  },
-
-  // 3. 其他工具函数（保持原有，可选）
-  bytesToHexString: (bytes: number[], separator = ''): string => {
-    return bytes
-      .map((byte) => byte.toString(16).padStart(2, '0').toUpperCase())
-      .join(separator);
-  },
-  bytesToDecimal: (bytes: number[], isBigEndian = true): number => {
-    let result = 0;
-    if (isBigEndian) {
-      bytes.forEach((byte) => {
-        result = (result << 8) | byte;
-      });
-    } else {
-      bytes.reverse().forEach((byte) => {
-        result = (result << 8) | byte;
-      });
-    }
-    return result;
-  },
-  bytesToWifiEncryptionType: (bytes: number[]): string => {
-    const isAllFf = bytes.every((byte) => byte === 255);
-    if (isAllFf) {
-      return 'AES/TKIP (WPA2 兼容)';
-    }
-    const encryptValue = TLVConverterTools.bytesToDecimal(bytes);
-    return encryptValue === 0
-      ? 'NONE (无加密)'
-      : `WEP（0x${encryptValue.toString(16).padStart(4, '0')}`;
-  },
-};
-
-// 定义 WiFi 数据的自定义解析配置
-export const wifiTLVConfig: TLVParseConfig = {
-  legalTypeHigh: 0x10, // 合法 TLV 高字节为 16
-  skipTlvTypes: [14], // 跳过无效 TLV 类型 14
-  // 长度解析策略：低字节有效（适配非标准 WiFi 数据）
-  lengthParseStrategy: (lengthHigh, lengthLow) => lengthLow,
-  // 目标 TLV 映射（按需扩展）
-  targetTlvMap: {
-    69: {
-      // SSID 类型
-      fieldName: 'ssid',
-      converter: TLVConverterTools.bytesToUtf8String,
-    },
-    39: {
-      // 密码类型
-      fieldName: 'password',
-      converter: TLVConverterTools.bytesToUtf8String,
-    },
-    3: {
-      // 认证类型
-      fieldName: 'authType',
-      converter: TLVConverterTools.bytesToWifiAuthType,
-    },
-    32: {
-      // 加密类型
-      fieldName: 'encryptionType',
-      converter: TLVConverterTools.bytesToWifiEncryptionType,
-    },
-  },
-};
-
-// WSC 配置接口
-
-// 生成 WSC 数据 (Android/Windows 更兼容的格式)
-export function generateWSCBytesForAndroid(config: NFC.WSCConfig): number[] {
-  const bytes: number[] = [];
-
-  // 这是 Android 和 Windows 都接受的简化格式
-  // 参考: Wi-Fi Alliance WSC Specification 2.0
-
-  // 1. Credential 属性 (0x100e)
-  // 这是一个容器属性，包含其他属性
-
-  // 先收集所有属性
-  const credentialAttrs: number[] = [];
-
-  // SSID
-  const ssidBytes = Array.from(config.ssid, (c) => c.charCodeAt(0));
-  credentialAttrs.push(0x10, 0x45); // SSID
-  credentialAttrs.push(0x00, ssidBytes.length);
-  credentialAttrs.push(...ssidBytes);
-
-  // 认证类型
-  let authValue = 0x0020; // 默认 WPA2-Personal
-  if (config.authType === 'OPEN') authValue = 0x0001;
-  if (config.authType === 'WPA') authValue = 0x0022;
-
-  credentialAttrs.push(0x10, 0x03); // Authentication Type
-  credentialAttrs.push(0x00, 0x02);
-  credentialAttrs.push((authValue >> 8) & 0xff, authValue & 0xff);
-
-  // 加密类型
-  let encValue = 0x0008; // 默认 AES
-  if (config.encryptionType === 'NONE') encValue = 0x0001;
-  if (config.encryptionType === 'TKIP') encValue = 0x0004;
-  if (config.encryptionType === 'WEP') encValue = 0x0008;
-
-  credentialAttrs.push(0x10, 0x0f); // Encryption Type
-  credentialAttrs.push(0x00, 0x02);
-  credentialAttrs.push((encValue >> 8) & 0xff, encValue & 0xff);
-
-  // 网络密钥
-  if (config.authType !== 'OPEN') {
-    const keyBytes = Array.from(config.password, (c) => c.charCodeAt(0));
-    credentialAttrs.push(0x10, 0x27); // Network Key
-    credentialAttrs.push(0x00, keyBytes.length);
-    credentialAttrs.push(...keyBytes);
-  }
-
-  // 网络密钥索引 (WEP 需要)
-  if (config.encryptionType === 'WEP') {
-    const idx = config.networkKeyIndex || 1;
-    credentialAttrs.push(0x10, 0x28); // Network Key Index
-    credentialAttrs.push(0x00, 0x01);
-    credentialAttrs.push(idx);
-  }
-
-  // 将 Credential 属性添加到主字节数组
-  bytes.push(0x10, 0x0e); // Credential
-  bytes.push(0x00, credentialAttrs.length);
-  bytes.push(...credentialAttrs);
-
-  return bytes;
-}
-
-/**
- * vCard (text/vcard) 数据解析工具
- * 适配 vCard 3.0 格式，支持提取核心联系人字段，具备容错性
- */
-
-const vcardFieldMap: Record<string, string> = {
-  FN: 'fullName',
-  VERSION: 'version',
-  ORG: 'organization',
-  TEL: 'telephone',
-  ADR: 'address',
-  URL: 'url',
-};
-const reverseVcardFieldMap: Record<string, string> = Object.entries(
-  vcardFieldMap,
-).reduce(
-  (acc, [key, value]) => {
-    acc[value] = key;
-    return acc;
-  },
-  {} as Record<string, string>,
-);
-
-/**
- * 解析 vCard 格式的 payload 字符串，提取联系人信息
- * @param vcardPayload NFC 读取到的 vCard 原始字符串（含 \n 分隔符）
- * BEGIN:VCARD\nVERSION:3.0\nFN:any\nORG:any\nTEL:18888888888\nADR:杭州\nURL:www.baidu.com\nEND:VCARD\n
- * @returns 结构化的联系人信息对象
- */
-export function parseVCardPayload(vcardPayload: string): NFC.VCardContactInfo {
-  // 初始化默认结果
-  const contactInfo: NFC.VCardContactInfo = {
-    fullName: '',
-    version: '',
-    organization: '',
-    telephone: '',
-    address: '',
-    url: '',
-  };
-
-  // 步骤1：预处理 payload（去除首尾空白、处理不同分隔符 \n/\r\n/\r，拆分行为数组）
-  const processedPayload = vcardPayload
-    .trim()
-    .replace(/\r\n/g, '\n')
-    .replace(/\r/g, '\n');
-  const vcardLines = processedPayload
-    .split('\n')
-    .filter((line) => line.trim() !== '');
-
-  // 步骤2：验证是否为合法 vCard 格式
-  const isLegalVCard =
-    vcardLines.some((line) => line.startsWith('BEGIN:VCARD')) &&
-    vcardLines.some((line) => line.startsWith('END:VCARD'));
-  if (!isLegalVCard) {
-    console.warn(
-      '[vCard 解析] 无效的 vCard 格式，缺少 BEGIN:VCARD 或 END:VCARD 标记',
-    );
-    return contactInfo;
-  }
-
-  // 步骤3：遍历每行，解析关键字段（KEY:VALUE 格式）
-
-  for (const line of vcardLines) {
-    // 拆分 KEY 和 VALUE（按第一个冒号分割，避免 VALUE 中包含冒号的情况）
-    const colonIndex = line.indexOf(':');
-    if (colonIndex === -1) continue;
-
-    const fieldKey = line.substring(0, colonIndex).trim().toUpperCase();
-    const fieldValue = line.substring(colonIndex + 1).trim();
-
-    // 映射到结构化对象字段
-    const targetField = vcardFieldMap[fieldKey];
-    if (targetField) {
-      contactInfo[targetField] = fieldValue;
-    } else {
-      // 支持扩展字段（直接挂载到对象上）
-      contactInfo[fieldKey.toLowerCase()] = fieldValue;
-    }
-  }
-
-  return contactInfo;
-}
-
-/**
- * 格式化 vCard 联系人信息
- *
- * @export
- * @param {NFC.VCardContactInfo} cardInfo
- * @return {*}
- */
-export function formatCardInfo(cardInfo: NFC.VCardContactInfo) {
-  const list = Object.keys(cardInfo)
-    .filter((key) => {
-      return cardInfo[key];
-    })
-    .map((key) => {
-      return `${reverseVcardFieldMap[key]}:${cardInfo[key]}`;
-    });
-
-  list.unshift('BEGIN:VCARD');
-  list.push('END:VCARD');
-  return list.join('\n');
-}
+// 创建一个 ArrayBuffer 并查看其值
+export function transformArrayBuffer(buffer: ArrayBuffer): NFC.TransformId {
+  if (!buffer) {
+    return {
+      byteArray: [],
+      hexArray: [],
+      hexString: '',
+    };
+  }
+
+  // 将 ArrayBuffer 转为 Uint8Array（按字节读取）
+  const uint8Array = new Uint8Array(buffer);
+
+  // 方式1：转为普通数组
+  const byteArray = Array.from(uint8Array);
+  // console.log('ArrayBuffer 字节值（十进制）:', byteArray);
+
+  // 方式2：转为十六进制（NFC 场景常用，因为 NFC 数据多以十六进制展示）
+  const hexArray = byteArray.map((byte) =>
+    byte.toString(16).padStart(2, '0').toUpperCase(),
+  );
+
+  const hexString = hexArray.join(':');
+
+  return {
+    byteArray,
+    hexArray,
+
+    hexString,
+  };
+}
+
+/**
+ * 将字节数组转换为字符串
+ *
+ * @export
+ * @param {number[]} bytes
+ * @return {*}
+ */
+export function byteToString(bytes: number[]) {
+  return bytes.map((byte) => String.fromCharCode(byte)).join('');
+}
+
+/**
+ * 将字符串转换为字节数组
+ *
+ * @export
+ * @param {string} str
+ * @return {*}  {number[]}
+ */
+export function stringToBytes(str: string): number[] {
+  return Array.from(str).map((char) => char.charCodeAt(0));
+}
+
+export function stringToArrayBuffer(str: string): ArrayBuffer {
+  const bytes = stringToBytes(str); // 使用现有工具函数
+  const uint8Array = new Uint8Array(bytes);
+  return uint8Array.buffer.slice(
+    uint8Array.byteOffset,
+    uint8Array.byteOffset + uint8Array.byteLength,
+  );
+}
+
+export function arrayNumberToArrayBuffer(numbers: number[]): ArrayBuffer {
+  const buffer = new ArrayBuffer(numbers.length);
+  const view = new DataView(buffer);
+  numbers.forEach((number, index) => {
+    view.setUint8(index, number);
+  });
+  return buffer;
+}
+
+// 可以添加解析函数来解析 ATQA 信息
+export function parseAtqa(atqaBuffer: ArrayBuffer) {
+  const uint8Array = new Uint8Array(atqaBuffer);
+  if (uint8Array.length < 2) return null;
+
+  const byte1 = uint8Array[0];
+  const byte2 = uint8Array[1];
+
+  return {
+    uidType: (byte1 >> 7) & 0x01, // UID 类型
+    storageSize: (byte1 >> 4) & 0x07, // 存储大小编码
+    manufacturer: byte1 & 0x0f, // 制造商代码
+    cardFeatures: (byte2 >> 4) & 0x0f, // 功能特性
+    reserved: byte2 & 0x0f, // 保留位
+  };
+}
+
+export function parseAtqaAndroid(atqa: number[]) {
+  const byte1 = atqa[0];
+  const byte2 = atqa[1];
+  return {
+    uidType: (byte1 >> 7) & 0x01, // UID 类型
+    storageSize: (byte1 >> 4) & 0x07, // 存储大小编码
+    manufacturer: byte1 & 0x0f, // 制造商代码
+    cardFeatures: (byte2 >> 4) & 0x0f, // 功能特性
+    reserved: byte2 & 0x0f, // 保留位
+  };
+}
+
+/**
+ * 获取 SAK 类型
+ *
+ * @export
+ * @param {number} sak
+ * @return {*}
+ */
+export function getSakType(sak: number) {
+  switch (sak) {
+    case 0x00:
+      return '未指定类型';
+    case 0x08:
+      return 'Mifare Classic 1K';
+    case 0x09:
+      return 'Mifare Classic Mini';
+    case 0x10:
+      return 'Mifare Plus';
+    case 0x11:
+      return 'Mifare Classic 4K';
+    case 0x18:
+      return 'Mifare Ultralight / Ultralight C';
+    case 0x20:
+      return 'DESFire';
+    default:
+      return '未知';
+  }
+}
+
+export function getSakHex(sak: number) {
+  return '0x' + (sak < 16 ? '0' : '') + sak.toString(16).toUpperCase();
+}
+
+/** 获取读写标准 */
+export function getReadWriteStandard(nfcTypes: NFC.NfcType[]) {
+  return nfcTypes.map((nfcType) => {
+    switch (nfcType) {
+      case 'NFC-A':
+      case 'MIFARE Classic':
+      case 'MIFARE Ultralight':
+        return 'ISO 14443-3A';
+      case 'NFC-B':
+        return 'ISO 14443-3B';
+      case 'NFC-F':
+        return 'ISO 14443-3F';
+      case 'NFC-V':
+        return 'ISO 15693';
+      case 'Ndef':
+      case 'NDEF':
+        return 'NDEF';
+      case 'ISO-DEP':
+        return 'ISO 14443-4';
+      case 'Ndef Formatable':
+        return 'NDEF Formatable';
+      default:
+        return '未知';
+    }
+  });
+}
+
+export function getAndroidTechs(techs: string[]) {
+  return techs.map((tech) => {
+    switch (tech) {
+      case 'android.nfc.tech.IsoDep':
+        return 'ISO-DEP';
+      case 'android.nfc.tech.MifareClassic':
+        return 'MIFARE Classic';
+      case 'android.nfc.tech.MifareUltralight':
+        return 'MIFARE Ultralight';
+      case 'android.nfc.tech.NfcA':
+        return 'NFC-A';
+      case 'android.nfc.tech.NfcB':
+        return 'NFC-B';
+      case 'android.nfc.tech.NfcF':
+        return 'NFC-F';
+      case 'android.nfc.tech.NfcV':
+        return 'NFC-V';
+      case 'android.nfc.tech.Ndef':
+        return 'Ndef';
+      case 'android.nfc.tech.NdefFormatable':
+        return 'Ndef Formatable';
+      default:
+        return '';
+    }
+  });
+}
+
+export function getTnfDescription(tnf: string) {
+  switch (tnf) {
+    case '0':
+      return 'TNF_EMPTY';
+    case '1':
+      return 'TNF_WELL_KNOWN';
+    case '2':
+      return 'TNF_MIME_MEDIA';
+    case '3':
+      return 'TNF_ABSOLUTE_URI';
+    case '4':
+      return 'TNF_EXTERNAL_TYPE';
+    case '5':
+      return 'TNF_UNKNOWN';
+    case '6':
+      return 'TNF_UNCHANGED';
+    case '7':
+      return 'TNF_RESERVED';
+    default:
+      return '未知';
+  }
+}
+
+/**
+ * 获取URI记录的具体类型描述
+ * @param prefixCode - URI前缀代码（payload的第一个字节）
+ * @returns URI类型描述
+ */
+function getUriTypeDescription(prefixCode: number): string {
+  const uriPrefixes: { [key: number]: string } = {
+    0x00: '未指定（纯URI）',
+    0x01: 'http://www.', // http://www.
+    0x02: 'https://www.', // https://www.
+    0x03: 'http://', // http://
+    0x04: 'https://', // https://
+    0x05: 'tel:', // tel: (电话号码)
+    0x06: 'mailto:', // mailto: (邮箱地址)
+    0x07: 'ftp://anonymous:anonymous@', // ftp://anonymous:anonymous@
+    0x08: 'ftp://ftp.', // ftp://ftp.
+    0x09: 'ftps://', // ftps://
+    0x0a: 'sftp://', // sftp://
+    0x0b: 'smb://', // smb://
+    0x0c: 'nfs://', // nfs://
+    0x0d: 'ftp://', // ftp://
+    0x0e: 'dav://', // dav://
+    0x0f: 'news:', // news:
+    0x10: 'telnet://', // telnet://
+    0x11: 'imap:', // imap:
+    0x12: 'rtsp://', // rtsp://
+    0x13: 'urn:', // urn:
+    0x14: 'pop:', // pop:
+    0x15: 'sip:', // sip:
+    0x16: 'sips:', // sips:
+    0x17: 'tftp:', // tftp:
+    0x18: 'btspp://', // btspp:// (Bluetooth)
+    0x19: 'btl2cap://', // btl2cap:// (Bluetooth)
+    0x1a: 'btgoep://', // btgoep:// (Bluetooth)
+    0x1b: 'tcpobex://', // tcpobex://
+    0x1c: 'irdaobex://', // irdaobex://
+    0x1d: 'file://', // file://
+    0x1e: 'urn:epc:id:', // urn:epc:id:
+    0x1f: 'urn:epc:tag:', // urn:epc:tag:
+    0x20: 'urn:epc:pat:', // urn:epc:pat:
+    0x21: 'urn:epc:raw:', // urn:epc:raw:
+    0x22: 'urn:epc:', // urn:epc:
+    0x23: 'urn:nfc:', // urn:nfc:
+  };
+
+  return uriPrefixes[prefixCode] || '未知';
+}
+
+/** 定义 URI 前缀映射表 */
+const uriPrefixMap: { [key: string]: number } = {
+  '': 0x00, // 未指定协议
+  'http://www.': 0x01,
+  'https://www.': 0x02,
+  'http://': 0x03,
+  'https://': 0x04,
+  'tel:': 0x05, // 电话号码
+  'mailto:': 0x06, // 邮箱地址
+  'ftp://anonymous:anonymous@': 0x07,
+  'ftp://ftp.': 0x08,
+  'ftps://': 0x09,
+  'sftp://': 0x0a,
+  'smb://': 0x0b,
+  'nfs://': 0x0c,
+  'ftp://': 0x0d,
+  'dav://': 0x0e,
+  'news:': 0x0f,
+  'telnet://': 0x10,
+  'imap:': 0x11,
+  'rtsp://': 0x12,
+  'urn:': 0x13,
+  'pop:': 0x14,
+  'sip:': 0x15,
+  'sips:': 0x16,
+  'tftp:': 0x17,
+  'btspp://': 0x18,
+  'btl2cap://': 0x19,
+  'btgoep://': 0x1a,
+  'tcpobex://': 0x1b,
+  'irdaobex://': 0x1c,
+  'file://': 0x1d,
+  'urn:epc:id:': 0x1e,
+  'urn:epc:tag:': 0x1f,
+  'urn:epc:pat:': 0x20,
+  'urn:epc:raw:': 0x21,
+  'urn:epc:': 0x22,
+  'urn:nfc:': 0x23,
+};
+
+/**
+ * 创建 URI 类型的 NDEF 记录
+ * 根据 NFC Forum URI Record Type Definition 规范
+ *
+ * @param uri 完整的 URI 字符串，如 "tel:18888888888", "https://www.example.com"
+ * @returns NDEF 记录对象
+ */
+export function createUriNdefRecord(uri: string): NFC.NdefRecord {
+  let prefix = '';
+  let suffix = uri;
+
+  // 查找匹配的前缀
+  for (const [protocol, _code] of Object.entries(uriPrefixMap)) {
+    if (uri.startsWith(protocol) && protocol.length > prefix.length) {
+      prefix = protocol;
+    }
+  }
+
+  // 提取 URI 后缀部分
+  if (prefix) {
+    suffix = uri.substring(prefix.length);
+  }
+
+  // 获取前缀代码
+  const prefixCode = uriPrefixMap[prefix] || 0x00;
+
+  // 构建 payload：前缀代码 + 剩余 URI
+  const payloadArray = [prefixCode];
+  if (suffix) {
+    // 将后缀字符串转换为字节数组
+    const suffixBytes = stringToBytes(suffix);
+    payloadArray.push(...suffixBytes);
+  }
+
+  return {
+    tnf: 1, // TNF_WELL_KNOWN
+    type: 'U', // URI 类型
+    payload: arrayNumberToArrayBuffer(payloadArray),
+  };
+}
+
+export function getTypeDescription(type: string, payload?: number[]) {
+  switch (type) {
+    case 'T':
+      return '文本记录';
+    case 'U':
+      // URI记录需要根据payload的第一个字节确定具体类型
+      if (payload && payload.length > 0) {
+        const uriPrefixCode = payload[0]; // 第一个字节是URI前缀代码
+        return getUriTypeDescription(uriPrefixCode);
+      }
+      return 'URI记录';
+    case 'Sp':
+      return 'Smart Poster记录';
+    case 'Sig':
+      return '签名记录';
+    case 'application/vnd.wfa.wsc':
+      return 'Wi-Fi Simple Configuration记录';
+    case 'android.com:pkg':
+      return 'Android 包名记录';
+    case 'text/vcard':
+      return 'VCard 记录';
+    default:
+      // 如果是 MIME 类型格式，可以返回更具体的描述
+      if (type.startsWith('application/')) {
+        return `应用数据类型: ${type}`;
+      } else if (type.startsWith('text/')) {
+        return `文本数据类型: ${type}`;
+      } else if (
+        type.startsWith('image/') ||
+        type.startsWith('video/') ||
+        type.startsWith('audio/')
+      ) {
+        return `媒体数据类型: ${type}`;
+      }
+      return '未知';
+  }
+}
+
+/**
+ * 通用 TLV 解析配置项接口
+ * 支持自定义各类 TLV 解析规则，适配不同格式数据
+ */
+interface TLVParseConfig {
+  // 合法 TLV 的 Type 高字节标识（默认：0x10，对应 NFC WiFi 数据）
+  legalTypeHigh?: number;
+  // 需要跳过的无效 TLV 类型（低字节）列表
+  skipTlvTypes?: number[];
+  // 长度解析策略（支持自定义，适配标准大端/低字节有效/高字节有效等）
+  lengthParseStrategy: (lengthHigh: number, lengthLow: number) => number;
+  // 目标 TLV 类型映射（键：TLV 低字节类型，值：字段名称 + 数据转换函数）
+  targetTlvMap: Record<
+    number,
+    {
+      fieldName: string;
+      converter: (valueBytes: number[]) => any;
+    }
+  >;
+}
+
+/**
+ * 通用 TLV 解析工具函数
+ * 可适配 NFC 门禁卡、公交卡、WiFi 数据等各类 TLV 格式数据
+ * @param tlvBytes 原始 TLV 字节数组
+ * @param config 自定义解析配置项
+ * @returns 解析后的结果对象（键：配置中定义的 fieldName，值：转换后的数据）
+ */
+export function parseUniversalTLV(
+  tlvBytes: number[],
+  config: TLVParseConfig,
+): Record<string, any> {
+  // 配置项默认值填充
+  const finalConfig = {
+    legalTypeHigh: 0x10,
+    skipTlvTypes: [],
+    ...config,
+  };
+
+  // 存储解析结果
+  const parseResult: Record<string, any> = {
+    raw: tlvBytes,
+  };
+  const byteLength = tlvBytes.length;
+  let index = 0;
+
+  // 循环解析 TLV 数据（核心：按配置项灵活解析）
+  while (index < byteLength) {
+    // 1. 校验是否有足够字节读取 Type（2 字节）
+    if (index + 1 >= byteLength) {
+      break;
+    }
+
+    const typeHigh = tlvBytes[index];
+    const typeLow = tlvBytes[index + 1];
+    const currentType = typeLow;
+
+    // 2. 过滤非法 TLV（非配置指定的高字节标识）
+    if (typeHigh !== finalConfig.legalTypeHigh) {
+      index++;
+      continue;
+    }
+
+    // 3. 跳过配置中指定的无效 TLV（直接跳过头部 4 字节：Type2 + Length2）
+    if (finalConfig.skipTlvTypes?.includes(currentType)) {
+      index += 4;
+      continue;
+    }
+
+    // 4. 步进 Type 字节（2 字节），准备读取 Length
+    index += 2;
+    if (index + 1 >= byteLength) {
+      break;
+    }
+
+    // 5. 按自定义策略解析 Length（灵活适配不同格式）
+    const lengthHigh = tlvBytes[index];
+    const lengthLow = tlvBytes[index + 1];
+    const currentLength = finalConfig.lengthParseStrategy(
+      lengthHigh,
+      lengthLow,
+    );
+
+    // 6. 步进 Length 字节（2 字节），准备读取 Value
+    index += 2;
+    if (index + currentLength > byteLength) {
+      break;
+    }
+
+    // 7. 读取 Value 部分（按自定义长度截取）
+    const currentValue = tlvBytes.slice(index, index + currentLength);
+
+    // 8. 强制步进 Value 字节（避免索引卡死，确保遍历完整性）
+    index += currentLength;
+
+    // 9. 按自定义映射转换目标 TLV 数据
+    const targetTlvConfig = finalConfig.targetTlvMap[currentType];
+    if (targetTlvConfig) {
+      try {
+        const convertedData = targetTlvConfig.converter(currentValue);
+        parseResult[targetTlvConfig.fieldName] = convertedData;
+      } catch (_e) {
+        parseResult[targetTlvConfig.fieldName] = null;
+      }
+    }
+  }
+
+  return parseResult;
+}
+
+/**
+ * 辅助工具：修正 authType 转换逻辑，适配 32（0x20）等新值
+ */
+const TLVConverterTools = {
+  // 1. 字节数组 → UTF-8 字符串（保持原有）
+  bytesToUtf8String: (bytes: number[]): string => {
+    try {
+      return new TextDecoder('utf-8', { fatal: false }).decode(
+        new Uint8Array(bytes),
+      );
+    } catch (_e) {
+      return bytes.map((byte) => String.fromCharCode(byte)).join('');
+    }
+  },
+
+  // 2. 字节数组 → WIFI 认证类型（核心修正：添加 32（0x20）的映射）
+  bytesToWifiAuthType: (bytes: number[]): string => {
+    // 适配当前字节数组的 [0, 32]，取有效数据（低字节优先，与格式一致）
+    const authValue = bytes.length >= 2 ? bytes[1] || bytes[0] : bytes[0];
+    console.log(
+      `[authType 解析] 原始标识值：${authValue}（十六进制：0x${authValue.toString(16).padStart(2, '0')}`,
+    );
+
+    switch (authValue) {
+      case 1:
+        return 'OPEN (无认证)';
+      case 2:
+      case 34: // 0x22：原有 WPA2-Personal
+        return 'WPA2-Personal';
+      case 32: // 0x20：新增，适配当前字节数组的 authType 值
+        return 'WPA-Personal (兼容 WPA2)';
+      case 3:
+        return 'WPA-Personal';
+      default:
+        return `未知认证类型（0x${authValue.toString(16).padStart(4, '0')}`;
+    }
+  },
+
+  // 3. 其他工具函数（保持原有，可选）
+  bytesToHexString: (bytes: number[], separator = ''): string => {
+    return bytes
+      .map((byte) => byte.toString(16).padStart(2, '0').toUpperCase())
+      .join(separator);
+  },
+  bytesToDecimal: (bytes: number[], isBigEndian = true): number => {
+    let result = 0;
+    if (isBigEndian) {
+      bytes.forEach((byte) => {
+        result = (result << 8) | byte;
+      });
+    } else {
+      bytes.reverse().forEach((byte) => {
+        result = (result << 8) | byte;
+      });
+    }
+    return result;
+  },
+  bytesToWifiEncryptionType: (bytes: number[]): string => {
+    const isAllFf = bytes.every((byte) => byte === 255);
+    if (isAllFf) {
+      return 'AES/TKIP (WPA2 兼容)';
+    }
+    const encryptValue = TLVConverterTools.bytesToDecimal(bytes);
+    return encryptValue === 0
+      ? 'NONE (无加密)'
+      : `WEP（0x${encryptValue.toString(16).padStart(4, '0')}`;
+  },
+};
+
+// 定义 WiFi 数据的自定义解析配置
+export const wifiTLVConfig: TLVParseConfig = {
+  legalTypeHigh: 0x10, // 合法 TLV 高字节为 16
+  skipTlvTypes: [14], // 跳过无效 TLV 类型 14
+  // 长度解析策略：低字节有效（适配非标准 WiFi 数据）
+  lengthParseStrategy: (lengthHigh, lengthLow) => lengthLow,
+  // 目标 TLV 映射（按需扩展）
+  targetTlvMap: {
+    69: {
+      // SSID 类型
+      fieldName: 'ssid',
+      converter: TLVConverterTools.bytesToUtf8String,
+    },
+    39: {
+      // 密码类型
+      fieldName: 'password',
+      converter: TLVConverterTools.bytesToUtf8String,
+    },
+    3: {
+      // 认证类型
+      fieldName: 'authType',
+      converter: TLVConverterTools.bytesToWifiAuthType,
+    },
+    32: {
+      // 加密类型
+      fieldName: 'encryptionType',
+      converter: TLVConverterTools.bytesToWifiEncryptionType,
+    },
+  },
+};
+
+// WSC 配置接口
+
+// 生成 WSC 数据 (Android/Windows 更兼容的格式)
+export function generateWSCBytesForAndroid(config: NFC.WSCConfig): number[] {
+  const bytes: number[] = [];
+
+  // 这是 Android 和 Windows 都接受的简化格式
+  // 参考: Wi-Fi Alliance WSC Specification 2.0
+
+  // 1. Credential 属性 (0x100e)
+  // 这是一个容器属性，包含其他属性
+
+  // 先收集所有属性
+  const credentialAttrs: number[] = [];
+
+  // SSID
+  const ssidBytes = Array.from(config.ssid, (c) => c.charCodeAt(0));
+  credentialAttrs.push(0x10, 0x45); // SSID
+  credentialAttrs.push(0x00, ssidBytes.length);
+  credentialAttrs.push(...ssidBytes);
+
+  // 认证类型
+  let authValue = 0x0020; // 默认 WPA2-Personal
+  if (config.authType === 'OPEN') authValue = 0x0001;
+  if (config.authType === 'WPA') authValue = 0x0022;
+
+  credentialAttrs.push(0x10, 0x03); // Authentication Type
+  credentialAttrs.push(0x00, 0x02);
+  credentialAttrs.push((authValue >> 8) & 0xff, authValue & 0xff);
+
+  // 加密类型
+  let encValue = 0x0008; // 默认 AES
+  if (config.encryptionType === 'NONE') encValue = 0x0001;
+  if (config.encryptionType === 'TKIP') encValue = 0x0004;
+  if (config.encryptionType === 'WEP') encValue = 0x0008;
+
+  credentialAttrs.push(0x10, 0x0f); // Encryption Type
+  credentialAttrs.push(0x00, 0x02);
+  credentialAttrs.push((encValue >> 8) & 0xff, encValue & 0xff);
+
+  // 网络密钥
+  if (config.authType !== 'OPEN') {
+    const keyBytes = Array.from(config.password, (c) => c.charCodeAt(0));
+    credentialAttrs.push(0x10, 0x27); // Network Key
+    credentialAttrs.push(0x00, keyBytes.length);
+    credentialAttrs.push(...keyBytes);
+  }
+
+  // 网络密钥索引 (WEP 需要)
+  if (config.encryptionType === 'WEP') {
+    const idx = config.networkKeyIndex || 1;
+    credentialAttrs.push(0x10, 0x28); // Network Key Index
+    credentialAttrs.push(0x00, 0x01);
+    credentialAttrs.push(idx);
+  }
+
+  // 将 Credential 属性添加到主字节数组
+  bytes.push(0x10, 0x0e); // Credential
+  bytes.push(0x00, credentialAttrs.length);
+  bytes.push(...credentialAttrs);
+
+  return bytes;
+}
+
+/**
+ * vCard (text/vcard) 数据解析工具
+ * 适配 vCard 3.0 格式，支持提取核心联系人字段，具备容错性
+ */
+
+const vcardFieldMap: Record<string, string> = {
+  FN: 'fullName',
+  VERSION: 'version',
+  ORG: 'organization',
+  TEL: 'telephone',
+  ADR: 'address',
+  URL: 'url',
+};
+const reverseVcardFieldMap: Record<string, string> = Object.entries(
+  vcardFieldMap,
+).reduce(
+  (acc, [key, value]) => {
+    acc[value] = key;
+    return acc;
+  },
+  {} as Record<string, string>,
+);
+
+/**
+ * 解析 vCard 格式的 payload 字符串，提取联系人信息
+ * @param vcardPayload NFC 读取到的 vCard 原始字符串（含 \n 分隔符）
+ * BEGIN:VCARD\nVERSION:3.0\nFN:any\nORG:any\nTEL:18888888888\nADR:杭州\nURL:www.baidu.com\nEND:VCARD\n
+ * @returns 结构化的联系人信息对象
+ */
+export function parseVCardPayload(vcardPayload: string): NFC.VCardContactInfo {
+  // 初始化默认结果
+  const contactInfo: NFC.VCardContactInfo = {
+    fullName: '',
+    version: '',
+    organization: '',
+    telephone: '',
+    address: '',
+    url: '',
+  };
+
+  // 步骤1：预处理 payload（去除首尾空白、处理不同分隔符 \n/\r\n/\r，拆分行为数组）
+  const processedPayload = vcardPayload
+    .trim()
+    .replace(/\r\n/g, '\n')
+    .replace(/\r/g, '\n');
+  const vcardLines = processedPayload
+    .split('\n')
+    .filter((line) => line.trim() !== '');
+
+  // 步骤2：验证是否为合法 vCard 格式
+  const isLegalVCard =
+    vcardLines.some((line) => line.startsWith('BEGIN:VCARD')) &&
+    vcardLines.some((line) => line.startsWith('END:VCARD'));
+  if (!isLegalVCard) {
+    console.warn(
+      '[vCard 解析] 无效的 vCard 格式，缺少 BEGIN:VCARD 或 END:VCARD 标记',
+    );
+    return contactInfo;
+  }
+
+  // 步骤3：遍历每行，解析关键字段（KEY:VALUE 格式）
+
+  for (const line of vcardLines) {
+    // 拆分 KEY 和 VALUE（按第一个冒号分割，避免 VALUE 中包含冒号的情况）
+    const colonIndex = line.indexOf(':');
+    if (colonIndex === -1) continue;
+
+    const fieldKey = line.substring(0, colonIndex).trim().toUpperCase();
+    const fieldValue = line.substring(colonIndex + 1).trim();
+
+    // 映射到结构化对象字段
+    const targetField = vcardFieldMap[fieldKey];
+    if (targetField) {
+      contactInfo[targetField] = fieldValue;
+    } else {
+      // 支持扩展字段（直接挂载到对象上）
+      contactInfo[fieldKey.toLowerCase()] = fieldValue;
+    }
+  }
+
+  return contactInfo;
+}
+
+/**
+ * 格式化 vCard 联系人信息
+ *
+ * @export
+ * @param {NFC.VCardContactInfo} cardInfo
+ * @return {*}
+ */
+export function formatCardInfo(cardInfo: NFC.VCardContactInfo) {
+  const list = Object.keys(cardInfo)
+    .filter((key) => {
+      return cardInfo[key];
+    })
+    .map((key) => {
+      return `${reverseVcardFieldMap[key]}:${cardInfo[key]}`;
+    });
+
+  list.unshift('BEGIN:VCARD');
+  list.push('END:VCARD');
+  return list.join('\n');
+}