@sssxyd/face-liveness-detector 0.2.33 → 0.2.35

package/dist/index.esm.js

@@ -332,6 +332,43 @@ function _detectBrowserEngine(userAgent) {
     // 4. 其他浏览器 - 保守方案，使用 WASM
     return 'other';
 }
+/**
+ * 检测环境信息（用于诊断）
+ */
+function _detectEnvironmentInfo() {
+    const isMobile = /android|iphone|ipad|ipod|opera mini|iemobile|wpdesktop/i.test(navigator.userAgent.toLowerCase());
+    const isAndroid = /android/i.test(navigator.userAgent);
+    const isIOS = /iphone|ipad|ipod/i.test(navigator.userAgent);
+    // 检测内存
+    let memory = { available: 'unknown' };
+    if (navigator.deviceMemory) {
+        memory = { available: `${navigator.deviceMemory}GB` };
+    }
+    // 检测连接
+    let connection = { type: 'unknown' };
+    if (navigator.connection) {
+        const conn = navigator.connection;
+        connection = {
+            type: conn.effectiveType,
+            downlink: `${conn.downlink}Mbps`,
+            rtt: `${conn.rtt}ms`,
+            saveData: conn.saveData
+        };
+    }
+    return {
+        isMobile,
+        isAndroid,
+        isIOS,
+        memory,
+        connection,
+        userAgent: navigator.userAgent,
+        platform: navigator.platform,
+        language: navigator.language,
+        hardwareConcurrency: navigator.hardwareConcurrency,
+        maxTouchPoints: navigator.maxTouchPoints,
+        vendor: navigator.vendor
+    };
+}
 function _getOptimalBackendForEngine(engine) {
     // 针对不同内核的优化策略
     const backendConfig = {
@@ -605,14 +642,28 @@ async function _loadAndVerifyHuman(human) {
     catch (error) {
         const errorMsg = error instanceof Error ? error.message : 'Unknown error';
         const errorStack = error instanceof Error ? error.stack : 'N/A';
+        const isCORSError = errorMsg.toLowerCase().includes('cors') ||
+            errorMsg.toLowerCase().includes('cross-origin') ||
+            errorMsg.toLowerCase().includes('blocked by cors policy');
+        const isNetworkError = errorMsg.toLowerCase().includes('network') ||
+            errorMsg.toLowerCase().includes('failed to fetch') ||
+            errorMsg.toLowerCase().includes('fetch failed');
+        const isWASMError = errorMsg.toLowerCase().includes('wasm') ||
+            errorMsg.toLowerCase().includes('webassembly');
         console.error('[FaceDetectionEngine] Error during human.load():', {
             errorMsg,
             stack: errorStack,
             backend: human.config?.backend,
             hasModels: !!human.models,
-            modelsKeys: human.models ? Object.keys(human.models).length : 0
+            modelsKeys: human.models ? Object.keys(human.models).length : 0,
+            isCORSError,
+            isNetworkError,
+            isWASMError,
+            modelBasePath: human.config?.modelBasePath,
+            wasmPath: human.config?.wasmPath,
+            userAgent: navigator.userAgent
         });
-        throw new Error(`Model loading error: ${errorMsg}`);
+        throw new Error(`Model loading error (${human.config?.backend} backend): ${errorMsg}`);
     }
     const loadTime = performance.now() - modelLoadStartTime;
     console.log('[FaceDetectionEngine] Human.js loaded successfully', {
@@ -632,54 +683,14 @@ async function _loadAndVerifyHuman(human) {
         console.error('[FaceDetectionEngine] CRITICAL: human.models is empty after loading!');
         throw new Error('No models were loaded - human.models is empty');
     }
-    // 详细检查每个关键模型及其结构
-    const criticalModels = ['face', 'antispoof', 'liveness'];
-    const missingModels = [];
-    for (const modelName of criticalModels) {
-        const model = human.models[modelName];
-        if (!model) {
-            missingModels.push(modelName);
-            console.error(`[FaceDetectionEngine] CRITICAL: Model '${modelName}' is missing!`);
-        }
-        else {
-            const isLoaded = model.loaded || model.state === 'loaded' || !!model.model;
-            // 检查模型是否有必要的内部结构（防止 "Cannot read properties of undefined (reading 'inputs')" 错误）
-            const hasExecutor = !!model['executor'];
-            const hasInputs = !!model.inputs && Array.isArray(model.inputs) && model.inputs.length > 0;
-            const hasModelUrl = !!model['modelUrl'];
-            console.log(`[FaceDetectionEngine] Model '${modelName}':`, {
-                loaded: isLoaded,
-                state: model.state,
-                hasModel: !!model.model,
-                hasExecutor,
-                hasInputs,
-                hasModelUrl,
-                inputsType: typeof model.inputs,
-                inputsLength: Array.isArray(model.inputs) ? model.inputs.length : 'N/A'
-            });
-            // 严格检查：模型必须有以下结构才能正常工作
-            if (!isLoaded || !hasExecutor || !hasModelUrl) {
-                missingModels.push(`${modelName} (incomplete)`);
-                console.error(`[FaceDetectionEngine] WARNING: Model '${modelName}' may not be fully loaded - missing structure`);
-            }
-            // 如果 inputs 未定义会导致 "Cannot read properties of undefined (reading 'inputs')" 错误
-            if (!hasInputs && modelName !== 'antispoof') {
-                console.warn(`[FaceDetectionEngine] WARNING: Model '${modelName}' has no inputs - may cause errors during detection`);
-                missingModels.push(`${modelName} (no inputs)`);
-            }
-        }
-    }
-    if (missingModels.length > 0) {
-        console.error('[FaceDetectionEngine] Some critical models failed to load:', missingModels);
-        throw new Error(`Critical models not loaded: ${missingModels.join(', ')}`);
-    }
     // 打印加载的模型信息
     if (human.models) {
         const loadedModels = Object.entries(human.models).map(([name, model]) => ({
             name,
             loaded: model?.loaded || model?.state === 'loaded',
             type: typeof model,
-            hasModel: !!model?.model
+            hasModel: !!model?.model,
+            keys: Object.keys(model).length
         }));
         console.log('[FaceDetectionEngine] All loaded models:', {
             backend: human.config?.backend,
@@ -711,7 +722,11 @@ async function _tryLoadHumanWithBackend(backend, modelPath, wasmPath) {
             errorMsg,
             stack,
             backend: config.backend,
-            userAgent: navigator.userAgent
+            userAgent: navigator.userAgent,
+            isCORSError: errorMsg.toLowerCase().includes('cors'),
+            isNetworkError: errorMsg.toLowerCase().includes('network'),
+            isWASMError: errorMsg.toLowerCase().includes('wasm'),
+            environmentInfo: _detectEnvironmentInfo()
         });
         return null;
     }
@@ -720,11 +735,8 @@ async function _tryLoadHumanWithBackend(backend, modelPath, wasmPath) {
         console.error(`[FaceDetectionEngine] Human instance is null (${backend})`);
         return null;
     }
-    // 验证 Human 实例结构（早期检测 WASM 问题）
-    if (!human.config) {
-        console.warn('[FaceDetectionEngine] Warning: human.config is missing');
-    }
     try {
+        console.log(`[FaceDetectionEngine] Starting model loading for ${backend} backend...`);
         await _loadAndVerifyHuman(human);
         const totalTime = performance.now() - initStartTime;
         console.log(`[FaceDetectionEngine] Successfully loaded Human.js with ${backend} backend in ${totalTime.toFixed(2)}ms`);
@@ -732,7 +744,19 @@ async function _tryLoadHumanWithBackend(backend, modelPath, wasmPath) {
     }
     catch (error) {
         const errorMsg = error instanceof Error ? error.message : 'Unknown error';
-        console.error(`[FaceDetectionEngine] Failed to load models with ${backend} backend:`, errorMsg);
+        const stack = error instanceof Error ? error.stack : 'N/A';
+        console.error(`[FaceDetectionEngine] Failed to load models with ${backend} backend:`, {
+            errorMsg,
+            stack,
+            backend,
+            modelPath,
+            wasmPath,
+            isCORSError: errorMsg.toLowerCase().includes('cors') || errorMsg.toLowerCase().includes('cross-origin'),
+            isNetworkError: errorMsg.toLowerCase().includes('network') || errorMsg.toLowerCase().includes('failed to fetch'),
+            isWASMError: errorMsg.toLowerCase().includes('wasm'),
+            duration: `${(performance.now() - initStartTime).toFixed(2)}ms`,
+            environmentInfo: _detectEnvironmentInfo()
+        });
         return null;
     }
 }
@@ -745,14 +769,15 @@ async function _tryLoadHumanWithBackend(backend, modelPath, wasmPath) {
  */
 async function loadHuman(modelPath, wasmPath, preferredBackend) {
     const selectedBackend = _detectOptimalBackend(preferredBackend);
+    const environmentInfo = _detectEnvironmentInfo();
     console.log('[FaceDetectionEngine] Starting Human.js initialization:', {
         selectedBackend,
         modelBasePath: modelPath || '(using default)',
         wasmPath: wasmPath || '(using default)',
-        userAgent: navigator.userAgent,
-        platform: navigator.platform
+        ...environmentInfo
     });
     // 尝试用主后端加载
+    console.log(`[FaceDetectionEngine] Attempting to load Human.js with ${selectedBackend} backend...`);
     const human = await _tryLoadHumanWithBackend(selectedBackend, modelPath, wasmPath);
     if (human) {
         return human;
@@ -770,11 +795,38 @@ async function loadHuman(modelPath, wasmPath, preferredBackend) {
         console.warn(`[FaceDetectionEngine] Primary backend (${selectedBackend}) failed, attempting fallback to ${fallbackBackend}...`);
         const humanFallback = await _tryLoadHumanWithBackend(fallbackBackend, modelPath, wasmPath);
         if (humanFallback) {
+            console.log(`[FaceDetectionEngine] Successfully loaded with fallback backend: ${fallbackBackend}`);
             return humanFallback;
         }
-        throw new Error(`Human.js loading failed: both ${selectedBackend} and ${fallbackBackend} backends failed`);
-    }
-    throw new Error(`Human.js loading failed: ${selectedBackend} backend failed (no fallback available)`);
+        const errorDetails = {
+            message: `Human.js loading failed: both ${selectedBackend} and ${fallbackBackend} backends failed`,
+            backends: {
+                primary: selectedBackend,
+                fallback: fallbackBackend,
+                both_failed: true
+            },
+            environment: environmentInfo,
+            paths: {
+                modelBasePath: modelPath || '(using default)',
+                wasmPath: wasmPath || '(using default)'
+            },
+            webglAvailable: _isWebGLAvailable()
+        };
+        console.error('[FaceDetectionEngine] CRITICAL ERROR:', errorDetails);
+        throw new Error(errorDetails.message);
+    }
+    const errorDetails = {
+        message: `Human.js loading failed: ${selectedBackend} backend failed (no fallback available)`,
+        backend: selectedBackend,
+        environment: environmentInfo,
+        paths: {
+            modelBasePath: modelPath || '(using default)',
+            wasmPath: wasmPath || '(using default)'
+        },
+        webglAvailable: _isWebGLAvailable()
+    };
+    console.error('[FaceDetectionEngine] CRITICAL ERROR:', errorDetails);
+    throw new Error(errorDetails.message);
 }
 /**
  * Extract OpenCV version from getBuildInformation