@sssxyd/face-liveness-detector 0.4.0-alpha.6 → 0.4.0-alpha.8

package/dist/index.js

@@ -118,7 +118,7 @@
         },
         collect_image_quality_features: {
             require_full_face_in_bounds: false,
-            min_laplacian_variance: 50,
+            min_laplacian_variance: 40, // 从 50 降低到 40，适应现实环境的光线和对焦变化
             min_gradient_sharpness: 0.15,
             min_blur_score: 0.6
         },
@@ -1913,20 +1913,37 @@
         }
         /**
          * 验证运动一致性 - 防止照片微动攻击
-         * 真实面部运动：光流和关键点方差应该一致且相关
-         * 照片微动：只有光流或只有噪声，二者不匹配
+         * 真实面部运动：光流和关键点方差应该都有意义（都不为零）
+         * 照片微动：通常表现为只有光流或只有噪声，或两者都非常低
+         *
+         * 修复：允许不同类型运动的不同比例关系
+         * - 大幅度头部运动（旋转/平移）: 高keypoint variance, 中等optical flow
+         * - 微妙表情运动: 中等optical flow, 低keypoint variance
+         * - 照片微动: 两者都很低，或严重不匹配（一个近零一个不近零）
          */
         validateMotionConsistency(opticalFlow, keypointVariance) {
-            // 如果光流和关键点变化都很低，返回0（静止或照片）
+            // 两个指标都非常低 = 照片或静止
             if (opticalFlow < 0.01 && keypointVariance < 0.01) {
                 return 0;
             }
-            // 计算二者的相关性
-            // 真实运动：二者应该相关联（同时增加）
-            // 照片微动：可能只有一个很大（比如光流大但关键点稳定）
-            const ratio = Math.min(opticalFlow, keypointVariance) / Math.max(opticalFlow, keypointVariance, 0.01);
-            // 一致性分数：接近1表示匹配良好，接近0表示不匹配（可疑）
-            return ratio;
+            // 照片微动的典型特征：其中一个接近零，另一个不为零
+            // 但不是绝对拒绝，因为不同运动类型有不同的光流/关键点比例
+            const minValue = Math.min(opticalFlow, keypointVariance);
+            const maxValue = Math.max(opticalFlow, keypointVariance);
+            // 如果两个都有意义的值（都 > 0.01），认为是真实运动
+            // 即使比例不完全匹配（真实运动类型不同会导致不同的比例）
+            if (minValue >= 0.01) {
+                // 两者都有意义，即使比例不完全匹配也是可以接受的
+                // 允许最大 5:1 的比例（头部大幅旋转可能导致这样的差异）
+                const ratio = minValue / maxValue;
+                // 高宽容度：比例超过 0.2 就认为一致
+                // （之前的阈值 0.265 正好在这个范围内失败）
+                return Math.max(ratio, 0.5); // 如果两者都有意义，至少返回 0.5
+            }
+            // 其中一个接近零
+            // 这可能是照片微动，但也可能是特定运动（比如仅眼睛运动）
+            // 给予较低但非零的分数
+            return minValue / (maxValue + 0.001);
         }
         /**
          * 检测瞳孔反应 - 活体的关键特征
@@ -2360,7 +2377,7 @@
         }
         /**
          * 根据运动分析确定面部是否活跃
-         * 增强照片防护：加入光流最小阈值和运动一致性检查
+         * 修复：改进对真实面部运动的识别，减少误判
          */
         determineLiveness(motionScore, keypointVariance, motionType, opticalFlow, motionConsistency) {
             // 照片特征：
@@ -2368,7 +2385,6 @@
             // - 关键点方差很低 (< 0.02)
             // - 光流几乎为零 (< 0.08) ← 最明显的照片特征
             // - 运动类型 = 'none'
-            // - 运动不一致（光流和关键点不匹配）← 照片微动
             // 检查1：必须有有意义的光流（照片的最弱点）
             // 照片无法产生光流，这是最可靠的指标
             if (opticalFlow < this.minOpticalFlowThreshold) {
@@ -2386,10 +2402,13 @@
             if (motionType === 'none') {
                 return false;
             }
-            // 检查5：运动一致性检查（防止照片微动）
-            // 真实面部运动：光流和关键点应该一致
-            // 照片微动：二者会严重不匹配
-            if (motionConsistency < this.motionConsistencyThreshold) {
+            // 检查5（改进）：运动一致性检查 - 但对真实面部运动更宽容
+            // 如果两个指标都强劲，则宽松一致性检查
+            const strongMotionIndicators = keypointVariance >= 0.5 && opticalFlow >= 0.1;
+            const minConsistencyThreshold = strongMotionIndicators
+                ? this.motionConsistencyThreshold * 0.5 // 放宽到 0.15（原来 0.3）
+                : this.motionConsistencyThreshold;
+            if (motionConsistency < minConsistencyThreshold) {
                 return false;
             }
             // 检查6：验证物理约束（防止突跳式微动）
@@ -4705,12 +4724,12 @@
         }
         getPerformActionCount() {
             if (this.options.action_liveness_action_count <= 0) {
-                this.emitDebug('config', 'liveness_action_count is 0 or negative', { count: this.options.action_liveness_action_count }, 'warn');
+                this.emitDebug('config', 'liveness_action_count is 0 or negative', { count: this.options.action_liveness_action_count }, 'info');
                 return 0;
             }
             const actionListLength = this.options.action_liveness_action_list?.length ?? 0;
             if (actionListLength === 0) {
-                this.emitDebug('config', 'liveness_action_list is empty', { actionListLength }, 'warn');
+                this.emitDebug('config', 'liveness_action_list is empty', { actionListLength }, 'info');
             }
             return Math.min(this.options.action_liveness_action_count, actionListLength);
         }