修改二维码图片

README.md

@@ -8,7 +8,8 @@
 
 ### 1. 人脸识别
 - **实时检测**：基于 CompreFace API 进行高精度人脸检测
-- **正脸检测**：使用姿态检测技术，只识别正面人脸，过滤侧脸、抬头或低头
+- **正脸检测**：使用姿态检测技术，获取人脸的yaw（偏航角）、pitch（俯仰角）、roll（翻滚角）数据，只识别正面人脸，有效过滤侧脸、抬头或低头
+- **角度过滤**：通过REST API直接调用CompreFace的pose插件，设置±20°的角度阈值，确保只检测正脸
 - **身份识别**：自动识别员工和访客，支持相似度阈值配置
 - **防重复识别**：智能冷却机制，避免短时间内重复识别同一人
 - **质量评估**：使用 Laplacian 方差评估图像清晰度
@@ -135,8 +136,8 @@ face_detection:
   quality_threshold: 10  # 图像质量阈值(Laplacian方差)
   min_face_size: 80  # 最小人脸尺寸(像素)
   face_present_duration: 2.0  # 持续出现时长(秒)才触发识别
-  max_yaw: 30.0  # 最大允许的偏航角(度)，超过此角度视为侧脸
-  max_pitch: 30.0  # 最大允许的俯仰角(度)，超过此角度视为抬头或低头
+  max_yaw: 20.0  # 最大允许的偏航角(度)，超过此角度视为侧脸
+  max_pitch: 20.0  # 最大允许的俯仰角(度)，超过此角度视为抬头或低头
 
 # 人脸识别配置
 face_recognition:
@@ -148,7 +149,7 @@ role_mapping:
 # 二维码配置
 qrcode:
   image_path: "preview_qrcode_sota.jpg"
-  display_duration: 10
+  display_duration: 30
 
 # 视频配置
 video:
@@ -300,8 +301,8 @@ kanda-robot-facial-recognition/
 - `quality_threshold`: 图像质量阈值，建议 10-50
 - `min_face_size`: 最小人脸尺寸（像素），建议 60-100
 - `face_present_duration`: 持续出现时长（秒），建议 1.5-3.0
-- `max_yaw`: 最大允许的偏航角（度），超过此角度视为侧脸，建议 20-40
-- `max_pitch`: 最大允许的俯仰角（度），超过此角度视为抬头或低头，建议 20-40
+- `max_yaw`: 最大允许的偏航角（度），超过此角度视为侧脸，推荐 20°
+- `max_pitch`: 最大允许的俯仰角（度），超过此角度视为抬头或低头，推荐 20°
 - `stranger_threshold`: 陌生人阈值，建议 0.95-0.99
 - `recognition_cooldown`: 识别冷却时间（秒），建议 15-30
 
@@ -475,9 +476,13 @@ python preview_qrcode.py
 ## 更新日志
 
 ### v1.1.0 (2025-12-18)
-- ✅ 新增正脸检测功能，基于姿态检测技术过滤侧脸
-- ✅ 添加人脸角度阈值配置（max_yaw, max_pitch）
-- ✅ 优化人脸识别准确性，适用于门禁场景
+- ✅ 新增正脸检测功能，基于CompreFace姿态检测技术过滤侧脸
+- ✅ 添加人脸角度阈值配置（max_yaw: 20°, max_pitch: 20°）
+- ✅ 使用REST API直接调用CompreFace，绕过SDK限制获取pose数据
+- ✅ 优化人脸识别准确性，适用于门禁场景，只识别正面人脸
+- ✅ 二维码显示时间延长至30秒，方便访客操作
+- ✅ 二维码指引界面改为全屏显示，提升用户体验
+- ✅ 修复PIL兼容性问题，解决圆角矩形渲染错误
 
 ### v1.0.0 (2025-12-03)
 - ✅ 完整的人脸检测和识别功能