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

package/dist/index.esm.js

@@ -96,7 +96,7 @@ const DEFAULT_OPTIONS = {
     },
     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
     },
@@ -1891,20 +1891,37 @@ class MotionLivenessDetector {
     }
     /**
      * 验证运动一致性 - 防止照片微动攻击
-     * 真实面部运动：光流和关键点方差应该一致且相关
-     * 照片微动：只有光流或只有噪声，二者不匹配
+     * 真实面部运动：光流和关键点方差应该都有意义（都不为零）
+     * 照片微动：通常表现为只有光流或只有噪声，或两者都非常低
+     *
+     * 修复：允许不同类型运动的不同比例关系
+     * - 大幅度头部运动（旋转/平移）: 高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);
     }
     /**
      * 检测瞳孔反应 - 活体的关键特征
@@ -2338,7 +2355,7 @@ class MotionLivenessDetector {
     }
     /**
      * 根据运动分析确定面部是否活跃
-     * 增强照片防护：加入光流最小阈值和运动一致性检查
+     * 修复：改进对真实面部运动的识别，减少误判
      */
     determineLiveness(motionScore, keypointVariance, motionType, opticalFlow, motionConsistency) {
         // 照片特征：
@@ -2346,7 +2363,6 @@ class MotionLivenessDetector {
         // - 关键点方差很低 (< 0.02)
         // - 光流几乎为零 (< 0.08) ← 最明显的照片特征
         // - 运动类型 = 'none'
-        // - 运动不一致（光流和关键点不匹配）← 照片微动
         // 检查1：必须有有意义的光流（照片的最弱点）
         // 照片无法产生光流，这是最可靠的指标
         if (opticalFlow < this.minOpticalFlowThreshold) {
@@ -2364,10 +2380,13 @@ class MotionLivenessDetector {
         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：验证物理约束（防止突跳式微动）
@@ -4683,12 +4702,12 @@ class FaceDetectionEngine extends SimpleEventEmitter {
     }
     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);
     }