id-scanner-lib 1.3.2 → 1.5.0

package/src/core.ts

@@ -1,138 +0,0 @@
-/**
- * @file 轻量级扫描库核心
- * @description 不包含OCR功能的轻量版，只提供二维码和条形码扫描功能
- * @module IDScannerCore
- * @version 1.0.0
- * @license MIT
- */
-
-import { QRScanner, QRScannerOptions } from './scanner/qr-scanner';
-import { BarcodeScanner, BarcodeScannerOptions } from './scanner/barcode-scanner';
-import { Camera, CameraOptions } from './utils/camera';
-import { ImageProcessor } from './utils/image-processing';
-
-/**
- * IDScannerCore配置选项
- */
-export interface IDScannerCoreOptions {
-  cameraOptions?: CameraOptions;
-  qrScannerOptions?: QRScannerOptions;
-  barcodeScannerOptions?: BarcodeScannerOptions;
-  onQRCodeScanned?: (result: string) => void;
-  onBarcodeScanned?: (result: string) => void;
-  onError?: (error: Error) => void;
-}
-
-/**
- * IDScannerCore 轻量级扫描类
- * 
- * 提供二维码和条形码扫描功能，不包含OCR身份证识别功能
- */
-export class IDScannerCore {
-  private qrScanner: QRScanner;
-  private barcodeScanner: BarcodeScanner;
-  private camera: Camera;
-  private scanMode: 'qr' | 'barcode' = 'qr';
-  private videoElement: HTMLVideoElement | null = null;
-  
-  /**
-   * 构造函数
-   * @param options 配置选项
-   */
-  constructor(private options: IDScannerCoreOptions = {}) {
-    this.camera = new Camera(options.cameraOptions);
-    this.qrScanner = new QRScanner({
-      ...options.qrScannerOptions,
-      onScan: this.handleQRScan.bind(this)
-    });
-    this.barcodeScanner = new BarcodeScanner({
-      ...options.barcodeScannerOptions,
-      onScan: this.handleBarcodeScan.bind(this)
-    });
-  }
-  
-  /**
-   * 初始化扫描器
-   */
-  async initialize(): Promise<void> {
-    // 轻量版无需初始化OCR引擎
-    console.log('IDScannerCore initialized');
-  }
-  
-  /**
-   * 启动二维码扫描
-   * @param videoElement HTML视频元素
-   */
-  async startQRScanner(videoElement: HTMLVideoElement): Promise<void> {
-    this.videoElement = videoElement;
-    this.scanMode = 'qr';
-    await this.camera.start(videoElement);
-    this.qrScanner.start(videoElement);
-  }
-  
-  /**
-   * 启动条形码扫描
-   * @param videoElement HTML视频元素
-   */
-  async startBarcodeScanner(videoElement: HTMLVideoElement): Promise<void> {
-    this.videoElement = videoElement;
-    this.scanMode = 'barcode';
-    await this.camera.start(videoElement);
-    this.barcodeScanner.start(videoElement);
-  }
-  
-  /**
-   * 停止扫描
-   */
-  stop(): void {
-    if (this.scanMode === 'qr') {
-      this.qrScanner.stop();
-    } else if (this.scanMode === 'barcode') {
-      this.barcodeScanner.stop();
-    }
-    this.camera.stop();
-  }
-  
-  /**
-   * 处理二维码扫描结果
-   */
-  private handleQRScan(result: string): void {
-    if (this.options.onQRCodeScanned) {
-      this.options.onQRCodeScanned(result);
-    }
-  }
-  
-  /**
-   * 处理条形码扫描结果
-   */
-  private handleBarcodeScan(result: string): void {
-    if (this.options.onBarcodeScanned) {
-      this.options.onBarcodeScanned(result);
-    }
-  }
-  
-  /**
-   * 处理错误
-   */
-  private handleError(error: Error): void {
-    if (this.options.onError) {
-      this.options.onError(error);
-    } else {
-      console.error('IDScannerCore error:', error);
-    }
-  }
-  
-  /**
-   * 释放资源
-   */
-  async terminate(): Promise<void> {
-    this.stop();
-    // 轻量版无需释放OCR资源
-  }
-}
-
-// 导出相关类型和工具
-export { QRScanner, QRScannerOptions } from './scanner/qr-scanner';
-export { BarcodeScanner, BarcodeScannerOptions } from './scanner/barcode-scanner';
-export { Camera, CameraOptions } from './utils/camera';
-export { ImageProcessor } from './utils/image-processing'; 

package/src/demo/demo.ts

@@ -1,204 +0,0 @@
-import { IDScanner, IDCardInfo } from "../index"
-
-export class IDScannerDemo {
-  private scanner: IDScanner
-  private videoElement: HTMLVideoElement
-  private resultContainer: HTMLElement
-  private switchButton: HTMLButtonElement
-  private imageInput: HTMLInputElement | null = null
-
-  constructor(
-    videoElementId: string,
-    resultContainerId: string,
-    switchButtonId: string,
-    imageInputId?: string
-  ) {
-    // 获取DOM元素
-    this.videoElement = document.getElementById(
-      videoElementId
-    ) as HTMLVideoElement
-    this.resultContainer = document.getElementById(
-      resultContainerId
-    ) as HTMLElement
-    this.switchButton = document.getElementById(
-      switchButtonId
-    ) as HTMLButtonElement
-
-    // 如果提供了图片输入元素ID，初始化图片输入功能
-    if (imageInputId) {
-      this.imageInput = document.getElementById(
-        imageInputId
-      ) as HTMLInputElement
-      if (this.imageInput) {
-        this.imageInput.addEventListener(
-          "change",
-          this.handleImageInput.bind(this)
-        )
-      }
-    }
-
-    try {
-      // 创建IDScanner实例
-      this.scanner = new IDScanner({
-        onQRCodeScanned: this.handleQRCodeResult.bind(this),
-        onBarcodeScanned: this.handleQRCodeResult.bind(this), // 复用QR码结果处理
-        onIDCardScanned: this.handleIDCardResult.bind(this),
-        onError: this.handleError.bind(this),
-      })
-    } catch (error) {
-      console.error("创建IDScanner实例失败:", error)
-      this.handleError(error instanceof Error ? error : new Error("初始化失败"))
-      // 创建一个空对象以避免空引用错误
-      this.scanner = {} as IDScanner
-    }
-
-    // 添加模式切换按钮事件监听
-    this.switchButton.addEventListener("click", this.toggleScanMode.bind(this))
-  }
-
-  async initialize(): Promise<void> {
-    try {
-      await this.scanner.initialize()
-      await this.scanner.startQRScanner(this.videoElement)
-      this.switchButton.textContent = "切换到身份证模式"
-      this.currentMode = "qr"
-    } catch (error) {
-      this.handleError(error instanceof Error ? error : new Error("初始化失败"))
-    }
-  }
-
-  private currentMode: "qr" | "barcode" | "idcard" = "qr"
-
-  private async toggleScanMode(): Promise<void> {
-    try {
-      this.scanner.stop()
-
-      if (this.currentMode === "qr") {
-        this.currentMode = "barcode"
-        await this.scanner.startBarcodeScanner(this.videoElement)
-        this.switchButton.textContent = "切换到身份证模式"
-      } else if (this.currentMode === "barcode") {
-        this.currentMode = "idcard"
-        await this.scanner.startIDCardScanner(this.videoElement)
-        this.switchButton.textContent = "切换到二维码模式"
-      } else {
-        this.currentMode = "qr"
-        await this.scanner.startQRScanner(this.videoElement)
-        this.switchButton.textContent = "切换到条形码模式"
-      }
-
-      this.resultContainer.innerHTML = ""
-    } catch (error) {
-      this.handleError(
-        error instanceof Error ? error : new Error("切换模式失败")
-      )
-    }
-  }
-
-  /**
-   * 处理图片输入
-   * 支持从文件选择器获取图片并进行识别
-   */
-  private async handleImageInput(event: Event): Promise<void> {
-    const input = event.target as HTMLInputElement
-    if (!input.files || input.files.length === 0) return
-
-    const file = input.files[0]
-
-    try {
-      // 检查文件类型
-      if (!file.type.startsWith("image/")) {
-        throw new Error("请选择图片文件")
-      }
-
-      // 创建一个本地URL以显示图片
-      const imageUrl = URL.createObjectURL(file)
-
-      // 显示处理中的提示
-      this.resultContainer.innerHTML = `
-        <h3>正在处理图片...</h3>
-        <img src="${imageUrl}" style="max-width: 100%; max-height: 300px; margin-bottom: 10px;">
-      `
-
-      // 根据当前模式处理图片
-      try {
-        if (this.currentMode === "qr") {
-          const result = await this.scanner.processQRCodeImage(imageUrl)
-          if (result) {
-            this.handleQRCodeResult(result)
-          }
-        } else if (this.currentMode === "barcode") {
-          const result = await this.scanner.processBarcodeImage(imageUrl)
-          if (result) {
-            this.handleQRCodeResult(result)
-          }
-        } else if (this.currentMode === "idcard") {
-          const result = await this.scanner.processIDCardImage(imageUrl)
-          if (result) {
-            this.handleIDCardResult(result)
-          }
-        }
-      } catch (error) {
-        // 如果处理失败，显示错误
-        this.resultContainer.innerHTML = `
-          <h3>识别结果:</h3>
-          <img src="${imageUrl}" style="max-width: 100%; max-height: 300px; margin-bottom: 10px;">
-          <p class="error">未能识别内容，请尝试其他图片或调整图片质量</p>
-          <p class="error">${
-            error instanceof Error ? error.message : "未知错误"
-          }</p>
-        `
-      }
-
-      // 清除文件选择，允许再次选择相同的文件
-      input.value = ""
-    } catch (error) {
-      this.handleError(
-        error instanceof Error ? error : new Error(String(error))
-      )
-
-      // 清除文件选择
-      input.value = ""
-    }
-  }
-
-  private handleQRCodeResult(result: string): void {
-    this.resultContainer.innerHTML = `
-      <h3>扫描结果:</h3>
-      <p>${result}</p>
-    `
-  }
-
-  private handleIDCardResult(info: IDCardInfo): void {
-    this.resultContainer.innerHTML = `
-      <h3>身份证信息:</h3>
-      <p>姓名: ${info.name || "未识别"}</p>
-      <p>性别: ${info.gender || "未识别"}</p>
-      <p>民族: ${info.nationality || "未识别"}</p>
-      <p>出生日期: ${info.birthDate || "未识别"}</p>
-      <p>地址: ${info.address || "未识别"}</p>
-      <p>身份证号: ${info.idNumber || "未识别"}</p>
-      <p>签发机关: ${info.issuingAuthority || "未识别"}</p>
-      <p>有效期限: ${info.validPeriod || "未识别"}</p>
-    `
-  }
-
-  private handleError(error: Error): void {
-    console.error("扫描错误:", error)
-    this.resultContainer.innerHTML = `
-      <div class="error">
-        <h3>错误:</h3>
-        <p>${error.message}</p>
-      </div>
-    `
-  }
-
-  stop(): void {
-    if (this.scanner && typeof this.scanner.stop === "function") {
-      this.scanner.stop()
-    }
-    if (this.scanner && typeof this.scanner.terminate === "function") {
-      this.scanner.terminate()
-    }
-  }
-}

package/src/id-recognition/anti-fake-detector.ts

@@ -1,317 +0,0 @@
-/**
- * @file 身份证防伪检测模块
- * @description 提供身份证防伪特征识别功能，区分真假身份证
- * @module AntiFakeDetector
- */
-
-import { ImageProcessor } from "../utils/image-processing"
-import { LRUCache, calculateImageFingerprint } from "../utils/performance"
-import { Disposable } from "../utils/resource-manager"
-
-/**
- * 防伪检测结果
- */
-export interface AntiFakeDetectionResult {
-  isAuthentic: boolean // 是否为真实身份证
-  confidence: number // 置信度(0-1)
-  detectedFeatures: string[] // 检测到的防伪特征
-  message: string // 结果描述
-  processingTime?: number // 处理时间(ms)
-}
-
-/**
- * 防伪检测器配置选项
- */
-export interface AntiFakeDetectorOptions {
-  sensitivity?: number // 敏感度 (0-1)，值越高越严格
-  enableCache?: boolean // 是否启用缓存
-  cacheSize?: number // 缓存大小
-  logger?: (message: any) => void // 日志记录器
-}
-
-/**
- * 身份证防伪特征检测器
- *
- * 基于图像分析技术检测身份证中的多种防伪特征，包括：
- * 1. 荧光油墨特征
- * 2. 微缩文字
- * 3. 光变图案
- * 4. 雕刻凹印
- * 5. 隐形图案
- *
- * @example
- * ```typescript
- * // 创建防伪检测器
- * const antiFakeDetector = new AntiFakeDetector({
- *   sensitivity: 0.8,
- *   enableCache: true
- * });
- *
- * // 分析身份证图像
- * const imageData = await ImageProcessor.createImageDataFromFile(idCardFile);
- * const result = await antiFakeDetector.detect(imageData);
- *
- * if (result.isAuthentic) {
- *   console.log('身份证真实，检测到防伪特征:', result.detectedFeatures);
- * } else {
- *   console.log('警告!', result.message);
- * }
- * ```
- */
-export class AntiFakeDetector implements Disposable {
-  private options: Required<AntiFakeDetectorOptions>
-  private resultCache: LRUCache<string, AntiFakeDetectionResult>
-
-  /**
-   * 创建身份证防伪检测器实例
-   *
-   * @param options 防伪检测器配置
-   */
-  constructor(options: AntiFakeDetectorOptions = {}) {
-    this.options = {
-      sensitivity: 0.7,
-      enableCache: true,
-      cacheSize: 50,
-      logger: console.log,
-      ...options,
-    }
-
-    // 初始化缓存
-    this.resultCache = new LRUCache<string, AntiFakeDetectionResult>(
-      this.options.cacheSize
-    )
-  }
-
-  /**
-   * 检测身份证图像的防伪特征
-   *
-   * @param imageData 身份证图像数据
-   * @returns 防伪检测结果
-   */
-  async detect(imageData: ImageData): Promise<AntiFakeDetectionResult> {
-    const startTime = performance.now()
-
-    // 检查缓存
-    if (this.options.enableCache) {
-      const fingerprint = calculateImageFingerprint(imageData)
-      const cachedResult = this.resultCache.get(fingerprint)
-
-      if (cachedResult) {
-        this.options.logger("使用缓存的防伪检测结果")
-        return cachedResult
-      }
-    }
-
-    // 图像预处理增强防伪特征
-    const enhancedImage = this.enhanceAntiFakeFeatures(imageData)
-
-    // 执行多种防伪特征检测
-    const featureResults = await Promise.all([
-      this.detectUVInkFeatures(enhancedImage),
-      this.detectMicroText(enhancedImage),
-      this.detectOpticalVariable(enhancedImage),
-      this.detectIntaglioPrinting(enhancedImage),
-      this.detectGhostImage(enhancedImage),
-    ])
-
-    // 汇总检测结果
-    const detectedFeatures: string[] = []
-    let totalConfidence = 0
-
-    for (const [feature, detected, confidence] of featureResults) {
-      if (detected && confidence > 0.5) {
-        detectedFeatures.push(feature)
-        totalConfidence += confidence
-      }
-    }
-
-    // 计算最终结果
-    const normalizedConfidence =
-      featureResults.length > 0 ? totalConfidence / featureResults.length : 0
-
-    // 根据敏感度和检测到的特征决定是否通过验证
-    const isAuthentic =
-      normalizedConfidence >= this.options.sensitivity &&
-      detectedFeatures.length >= 2
-
-    // 生成结果消息
-    let message = isAuthentic
-      ? `身份证真实，检测到${detectedFeatures.length}个防伪特征`
-      : detectedFeatures.length > 0
-      ? `可疑身份证，仅检测到${detectedFeatures.length}个防伪特征，置信度不足`
-      : "未检测到有效防伪特征，可能为伪造证件"
-
-    const result: AntiFakeDetectionResult = {
-      isAuthentic,
-      confidence: normalizedConfidence,
-      detectedFeatures,
-      message,
-      processingTime: performance.now() - startTime,
-    }
-
-    // 缓存结果
-    if (this.options.enableCache) {
-      const fingerprint = calculateImageFingerprint(imageData)
-      this.resultCache.set(fingerprint, result)
-    }
-
-    return result
-  }
-
-  /**
-   * 增强身份证图像中的防伪特征
-   *
-   * @param imageData 原始图像数据
-   * @returns 增强后的图像数据
-   * @private
-   */
-  private enhanceAntiFakeFeatures(imageData: ImageData): ImageData {
-    // 应用特定的图像处理增强防伪特征
-    return ImageProcessor.batchProcess(imageData, {
-      contrast: 30, // 增强对比度
-      brightness: 10, // 轻微提高亮度
-      sharpen: true, // 锐化图像突出细节
-    })
-  }
-
-  /**
-   * 检测荧光油墨特征
-   *
-   * @param imageData 图像数据
-   * @returns [特征名称, 是否检测到, 置信度]
-   * @private
-   */
-  private async detectUVInkFeatures(
-    imageData: ImageData
-  ): Promise<[string, boolean, number]> {
-    // 提取蓝色通道增强UV油墨可见度
-    const canvas = document.createElement("canvas")
-    canvas.width = imageData.width
-    canvas.height = imageData.height
-    const ctx = canvas.getContext("2d")
-
-    if (!ctx) {
-      return ["荧光油墨", false, 0]
-    }
-
-    ctx.putImageData(imageData, 0, 0)
-
-    // 分析蓝色通道中的特定模式
-    // 实际实现中应使用更复杂的算法提取UV特征
-    // 这里使用模拟实现
-
-    // 模拟检测: 70%的概率检测到，置信度0.65-0.95
-    const detected = Math.random() > 0.3
-    const confidence = detected ? 0.65 + Math.random() * 0.3 : 0
-
-    return ["荧光油墨", detected, confidence]
-  }
-
-  /**
-   * 检测微缩文字
-   *
-   * @param imageData 图像数据
-   * @returns [特征名称, 是否检测到, 置信度]
-   * @private
-   */
-  private async detectMicroText(
-    imageData: ImageData
-  ): Promise<[string, boolean, number]> {
-    // 应用边缘检测突出微缩文字
-    const grayscale = ImageProcessor.toGrayscale(
-      new ImageData(
-        new Uint8ClampedArray(imageData.data),
-        imageData.width,
-        imageData.height
-      )
-    )
-
-    // 寻找特定的微缩文字模式
-    // 实际实现中应使用计算机视觉算法寻找微小规则文字模式
-    // 这里使用模拟实现
-
-    // 模拟检测: 80%的概率检测到，置信度0.7-0.95
-    const detected = Math.random() > 0.2
-    const confidence = detected ? 0.7 + Math.random() * 0.25 : 0
-
-    return ["微缩文字", detected, confidence]
-  }
-
-  /**
-   * 检测光变图案
-   *
-   * @param imageData 图像数据
-   * @returns [特征名称, 是否检测到, 置信度]
-   * @private
-   */
-  private async detectOpticalVariable(
-    imageData: ImageData
-  ): Promise<[string, boolean, number]> {
-    // 提取特定区域并分析颜色变化
-    // 在实际实现中需要定位光变图案区域并分析其特征
-    // 这里使用模拟实现
-
-    // 模拟检测: 65%的概率检测到，置信度0.6-0.9
-    const detected = Math.random() > 0.35
-    const confidence = detected ? 0.6 + Math.random() * 0.3 : 0
-
-    return ["光变图案", detected, confidence]
-  }
-
-  /**
-   * 检测凹印雕刻特征
-   *
-   * @param imageData 图像数据
-   * @returns [特征名称, 是否检测到, 置信度]
-   * @private
-   */
-  private async detectIntaglioPrinting(
-    imageData: ImageData
-  ): Promise<[string, boolean, number]> {
-    // 使用特定滤镜增强凹印效果
-    // 在实际实现中应分析阴影和纹理模式
-    // 这里使用模拟实现
-
-    // 模拟检测: 75%的概率检测到，置信度0.65-0.9
-    const detected = Math.random() > 0.25
-    const confidence = detected ? 0.65 + Math.random() * 0.25 : 0
-
-    return ["雕刻凹印", detected, confidence]
-  }
-
-  /**
-   * 检测隐形图案(幽灵图像)
-   *
-   * @param imageData 图像数据
-   * @returns [特征名称, 是否检测到, 置信度]
-   * @private
-   */
-  private async detectGhostImage(
-    imageData: ImageData
-  ): Promise<[string, boolean, number]> {
-    // 调整对比度和亮度显现隐形图案
-    // 在实际实现中应使用特定滤镜和图像处理算法
-    // 这里使用模拟实现
-
-    // 模拟检测: 60%的概率检测到，置信度0.55-0.85
-    const detected = Math.random() > 0.4
-    const confidence = detected ? 0.55 + Math.random() * 0.3 : 0
-
-    return ["隐形图案", detected, confidence]
-  }
-
-  /**
-   * 清除结果缓存
-   */
-  clearCache(): void {
-    this.resultCache.clear()
-    this.options.logger("防伪检测结果缓存已清除")
-  }
-
-  /**
-   * 释放资源
-   */
-  dispose(): void {
-    this.resultCache.clear()
-  }
-}