Driver Head-Pose Abnormality (Head-Down / Side-View) | 驾驶员头部姿态异常(低头/侧视)检测
Using an in-cabin DMS camera, the system analyzes the driver's head pose in real time, computing head pitch (down/up) and yaw (left/right turn). | 通过车载DMS摄像头实时分析驾驶员头部姿态,计算头部俯仰角(低头/抬头)和偏航角(左/右转头)。当低头角度超过阈值(默认>30°)且持续时间超过2秒(可能为看手机、查看物品),或侧视角度超过阈值(默认>45°)持续时间超过2秒(可能为与乘客聊天、看窗外)时,输出分心驾驶预警,联动语音提醒,预防交通事故。 Skill: Driver Head-Pose Abnormality (Head-Down / Side-View) | 驾驶员头部姿态异常(低头/侧视)检测 Owner: 18072937735 Summary: Using an in-cabin DMS camera, the system analyzes the driver's head pose in real time, computing head pitch (down/up) and yaw (left/right turn). | 通过车载DMS摄像头实时分析驾驶员头部姿态,计算头部俯仰角(低头/抬头)和偏航角(左/右转头)。当低头角度超过阈值(默认>30°)且持续时间超过2秒(可能为看手机、查看物品),或侧视角度超过阈值(默认>45°)持续时间超过2秒(可能为与乘客聊天、看窗外)时,输出分心驾驶预警,联动语音提醒,预防交通事故。 Tags: lates
Rank
62
Safety
84
Downloads
2.0k
Updated
Oct 9, 2026
Version
1.0.13
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 2K downloads reported by the source. Last updated 10/9/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 9, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 9, 2026
- Adoption signal
- 2K downloadsadoption · observed Oct 9, 2026
- Latest release
- 1.0.13release · observed Oct 1, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s17f8q65zg3y98t86jdg1177g583whq8:smyx-driver-head-pose-abnormality-analysis- Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-18072937735-smyx-driver-head-pose-abnormality-analysis/snapshot"
Documentation
CLAWHUB
148,873 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
--- name: "smyx-driver-head-pose-abnormality-analysis" description: "Using an in-cabin DMS camera, the system analyzes the driver's head pose in real time, computing head pitch (down/up) and yaw (left/right turn). | 通过车载DMS摄像头实时分析驾驶员头部姿态,计算头部俯仰角(低头/抬头)和偏航角(左/右转头)。当低头角度超过阈值(默认>30°)且持续时间超过2秒(可能为看手机、查看物品),或侧视角度超过阈值(默认>45°)持续时间超过2秒(可能为与乘客聊天、看窗外)时,输出分心驾驶预警,联动语音提醒,预防交通事故。" version: "1.0.15" license: "MIT-0" --- # 🚘 Driver Head-Pose Abnormality (Head-Down / Side-View) | 驾驶员头部姿态异常(低头/侧视)检测 > **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询 --- ## 🧭 技能概览 | Overview | 模块 | 内容 | |---|---| | 🏷️ 技能名称 | **驾驶员头部姿态异常(低头/侧视)检测** | | 🎯 核心目标 | 通过车载DMS摄像头实时分析驾驶员头部姿态,计算头部俯仰角(低头/抬头)和偏航角(左/右转头)。当低头角度超过阈值(默认>30°)且持续时间超过2秒(可能为看手机、查看物品),或侧视角度超过阈值(默认>45°)持续时间超过2秒(可能为与乘客聊天、看窗外)时,输出分心驾驶预警,联动语音提醒,预防交通事故。 | | 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL | | 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 | | 🧩 场景码 | `SMYX_DRIVER_HEAD_POSE_ABNORMALITY_ANALYSIS` | Using an in-cabin DMS camera, the system analyzes the driver's head pose in real time, computing head pitch (down/up) and yaw (left/right turn). When the head-down angle exceeds a threshold (default > 30°) and lasts more than 2 seconds (possibly looking at a phone or checking objects), or the side-view yaw angle exceeds a threshold (default > 45°) lasting more than 2 seconds (possibly chatting with passengers or looking out the window), it outputs a distracted-driving alert and triggers voice reminders, helping prevent traffic accidents. Application scenarios: passenger cars, commercial vehicles, ride-hailing fleets, freight fleets. The system monitors in real time; when long-duration head-down or head-side behavior is detected, it raises alerts and records distraction events. Skill features: distracted driving (especially looking down at a phone) has become a major cause of traffic accidents. AI real-time head-pose monitoring can promptly remind drivers to refocus and reduce accident risk. Can be integrated into dashcams, in-vehicle smart boxes, or fleet-management platforms to enhance driving safety. 通过车载DMS摄像头实时分析驾驶员头部姿态,计算头部俯仰角(低头/抬头)和偏航角(左/右转头)。当低头角度超过阈值(默认>30°)且持续时间超过2秒(可能为看手机、查看物品),或侧视角度超过阈值(默认>45°)持续时间超过2秒(可能为与乘客聊天、看窗外)时,输出分心驾驶预警,联动语音提醒,预防交通事故。应用场景:乘用车、商用车、网约车、货运车队。系统实时监测,当驾驶员出现长时间低头或侧头时发出警报,并记录分心事件。技能特点:分心驾驶(尤其是低头看手机)已成为交通事故的主要原因之一。通过AI实时检测头部姿态异常,可及时提醒驾驶员集中注意力,降低事故风险。该技能可集成到行车记录仪、车载智能盒子或车队管理平台中,提升驾驶安全水平。 ## 🤖 AI 角色 | AI Role | 角色要点 | 说明 | |---|---| | 说明 1 | **假设你是一个专业的驾驶员分心监测 AI。你的任务是分析驾驶员面部视频,计算头部姿态角(俯仰角 pitch、偏航角 yaw、翻滚角 roll),检测低头和侧视行为。当头部姿态超出预设阈值且持续时间超过设定值(默认 2 秒)时,输出分心预警。不要提供其他安全建议或医学诊断,仅输出基于头部姿态的检测结果。** | ## 🎬 技能演示 | Skill Demo [▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html) --- ## 🎯 任务目标 | Goals ### 1. 🧩 技能用途 基于车载 DMS 摄像头驾驶员面部视频,实时计算头部姿态角 + 检测低头/侧视行为 + 按持续时间阈值输出分心预警 ### 2. 🛠️ 能力范围 | 序号 | 具体能力 | |---:|---| | 1 | 驾驶员面部检测 | | 2 | 头部关键点定位 | | 3 | 3D 头部姿态估计(pitch / yaw / roll) | | 4 | 低头/侧视事件识别(角度阈值 + 持续时间阈值) | | 5 | 分心事件累计统计 | | 6 | 预警类型分类(head_down_distraction / head_side_distraction / head_roll_abnormality) | |
_meta.json
{
"ownerId": "kn7e2caqj7pnsvr9r7t8zenghs83xw7n",
"slug": "smyx-driver-head-pose-abnormality-analysis",
"version": "1.0.13",
"publishedAt": 1790885551388
}references/api_doc.md
# API 接口文档
此处用于存放驾驶员头部姿态异常(低头/侧视)检测 API 的接口文档,待后续补充。
## 接口规范
- 基础地址:由 smyx_common 配置统一管理
- 认证方式:API Key 鉴权
- 响应格式:JSON
## 主要接口
1. `/web/health-analysis/v2/start-health-analysis` - 启动驾驶员头部姿态异常检测任务
2. `/web/health-analysis/v2/get-health-analysis-result` - 获取头部姿态分析结果
3. `/web/health-analysis/page-health-analysis-result` - 分页查询历史分心事件
4. `/health/order/api/getReportDetailExport?id={id}` - 导出完整报告
## 场景代码
- `SMYX_DRIVER_HEAD_POSE_ABNORMALITY_ANALYSIS` - 驾驶员头部姿态异常(低头/侧视)检测
## 输入约束
- 摄像头:车载 DMS 摄像头(红外/IR-cut 优先)
- 安装位置:方向盘上方 / A 柱 / 仪表台上方,正对驾驶员面部
- 帧率:≥ 25 FPS;分辨率 ≥ 480p
- 必须能稳定看到面部及头部轮廓;夜间启用红外补光
- 戴帽子/口罩/墨镜可能影响关键点稳定性
## 头部姿态角定义
- `pitch_deg` - 俯仰角(° , > 0 抬头 / < 0 低头)
- `yaw_deg` - 偏航角(° , > 0 右转头 / < 0 左转头)
- `roll_deg` - 翻滚角(° , 头部左右倾斜)
## 默认阈值(可由调用方覆盖)
- 低头判定:`pitch_deg < -30°`
- 侧视判定:`|yaw_deg| > 45°`
- 持续时间阈值:超过 2 秒触发预警(distraction_duration_threshold_sec)
## 预警类型
- `head_down_distraction` - 低头分心(疑似看手机/查物品)
- `head_side_distraction` - 侧视分心(疑似与乘客聊天/看窗外)
- `head_roll_abnormality` - 头部倾斜异常(参考)
## 输出字段(参考)
- `driver_detected` - 是否检测到驾驶员
- `head_pose_angles` - 当前/统计期内头部姿态角(pitch_deg / yaw_deg / roll_deg)
- `head_down_events` - 低头分心事件列表(含开始时间、持续秒数、最大角度)
- `head_side_events` - 侧视分心事件列表(含开始时间、持续秒数、最大角度、方向 left/right)
- `total_distraction_duration_sec` - 累计分心时长(秒)
- `distraction_event_count` - 分心事件总次数
- `warning_type` - 触发的预警类型
- `warning_message` - 预警提示文本(如"驾驶员低头 3.2 秒(最大 -38°),疑似看手机,请立即抬头注视前方")
- `recommend_action` - 建议的座舱联动动作(voice_alert / fleet_upload / event_record)
> 仅输出基于头部姿态的检测结果与预警,不提供其他安全建议或医学诊断;预警仅供辅助提醒,驾驶员对车辆操作负全责。skills/smyx_analysis/references/api_doc.md
# API接口文档 ## 接口规范 - 基础地址:由 smyx_common 配置统一管理 - 认证方式:API Key 鉴权 - 请求格式:支持文件上传 - 响应格式:JSON ## 错误码说明 | 错误码 | 说明 | |-----|----------| | 400 | 请求参数错误 | | 401 | API密钥无效 | | 403 | 权限不足 | | 413 | 文件过大 | | 415 | 不支持的文件格式 | | 500 | 服务器内部错误 |
scripts/config.yaml
{}AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/18072937735/skills/smyx-driver-head-pose-abnormality-analysis",
"sourceUrl": "https://clawhub.ai/18072937735/skills/smyx-driver-head-pose-abnormality-analysis",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T20:40:08.926Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-18072937735-smyx-driver-head-pose-abnormality-analysis/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-18072937735-smyx-driver-head-pose-abnormality-analysis/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-09T20:40:08.926Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "2K downloads",
"href": "https://clawhub.ai/18072937735/smyx-driver-head-pose-abnormality-analysis",
"sourceUrl": "https://clawhub.ai/18072937735/smyx-driver-head-pose-abnormality-analysis",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T20:40:08.926Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.0.13",
"href": "https://clawhub.ai/18072937735/smyx-driver-head-pose-abnormality-analysis",
"sourceUrl": "https://clawhub.ai/18072937735/smyx-driver-head-pose-abnormality-analysis",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-10-01T20:12:31.388Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-18072937735-smyx-driver-head-pose-abnormality-analysis/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-18072937735-smyx-driver-head-pose-abnormality-analysis/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.13",
"description": "Version 1.0.15 - Updated version number in SKILL.md. - skill-card.md file has been removed. - No core logic or feature changes indicated.",
"href": "https://clawhub.ai/18072937735/smyx-driver-head-pose-abnormality-analysis",
"sourceUrl": "https://clawhub.ai/18072937735/smyx-driver-head-pose-abnormality-analysis",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-10-01T20:12:31.388Z",
"isPublic": true
}
]
}Record generated Oct 9, 2026.
