驾驶员眨眼与闭眼疲劳检测

要解决什么问题

长途、夜间或单调路况下，驾驶员容易出现眨眼变慢、单次闭眼变长，甚至数秒级「微睡眠」。这类状态往往早于明显打哈欠或偏离车道才被注意到。车队与网约车场景若只靠事后复盘，很难在座舱内做可量化的疲劳信号对齐——例如每分钟眨眼次数是否在 15–20 次附近、单次闭眼是否超过约 2 秒、PERCLOS 是否抬升。

本技能面向车载 DMS（驾驶员监测） 摄像头采集的面部视频：在帧率与双眼可见性满足要求时，从视觉流里估计睁眼/闭眼，汇总眨眼频率、平均闭眼时长、最长闭眼与微睡眠次数，并映射到 normal / mild / moderate / severe 等等级，同时给出预警类型（如 low_blink_rate、microsleep、prolonged_eye_closure、high_perclos）与方向性座舱动作建议（voice_alert、seat_vibrate、fleet_upload）。

技能如何工作

典型流程可以概括为：

• 输入：本地视频路径（--input）或公网视频 URL（--url，由 API 侧拉取，无需你在本地先下载）。
• 身份：分析前需取得有效的 open-id（禁止臆造或跳过），用于落库与查询历史报告。
• 执行：在技能根目录调用 python -m scripts.smyx_driver_blink_fatigue_detection_analysis，将结构化结果以 JSON 等形式返回（可用 --detail 控制详略）。
• 历史清单：当用户用「查看疲劳驾驶报告」「显示车队安全诊断报告」等表述查询时，须通过 --list --open-id 走云端接口，并以表格列出报告名称、疲劳等级、分析时间与 reportImageUrl 链接；不得从本地 memory 或会话里拼历史记录。

报告字段侧会说明是否检测到驾驶员（driver_detected）、双眼是否可见（eye_visible），并在 blink_metrics 中给出每分钟眨眼次数、平均/最长闭眼毫秒数、microsleep_count、perclos 等，便于与运营 SOP 对齐。

适用边界与注意点

• 输入一般为 mp4/avi/mov，体积与帧率有硬性要求：≥ 25 FPS（推荐 30）、分辨率 ≥ 480p，且画面能稳定看到双眼；墨镜、强逆光、遮挡会明显拉低可靠性。
• 输出仅为视觉辅助安全提醒，不构成医学或睡眠障碍诊断；车辆操控责任仍在驾驶员本人。
• 车载人脸视频涉及生物特征与隐私，部署前需知情同意，并遵守当地法规与车队数据保管要求。