Real-time detection of gaze direction and facial pose to quantify states of focus, distraction, or mind-wandering. Suitable for scenarios such as classroom learning, office meetings, and driving attention monitoring. | 专注度分析技能,实时检测视线方向、面部姿态,量化专注/分心/走神状态,适用于课堂学习、办公会议、驾驶专注度监测等场景
本技能明确约定:
memory/YYYY-MM-DD.md、MEMORY.md 等本地文件python -m scripts.focus_analysis --list --open-id 参数调用 API
查询云端的历史报告数据requests>=2.28.0
在执行专注度分析前,必须按以下优先级顺序获取 open-id:
第 1 步:【最高优先级】检查技能所在目录的配置文件(优先)
路径:skills/smyx_common/scripts/config.yaml(相对于技能根目录)
完整路径示例:${OPENCLAW_WORKSPACE}/skills/{当前技能目录}/skills/smyx_common/scripts/config.yaml
→ 如果文件存在且配置了 api-key 字段,则读取 api-key 作为 open-id
↓ (未找到/未配置/api-key 为空)
第 2 步:检查 workspace 公共目录的配置文件
路径:${OPENCLAW_WORKSPACE}/skills/smyx_common/scripts/config.yaml
→ 如果文件存在且配置了 api-key 字段,则读取 api-key 作为 open-id
↓ (未找到/未配置)
第 3 步:检查用户是否在消息中明确提供了 open-id
↓ (未提供)
第 4 步:❗ 必须暂停执行,明确提示用户提供用户名或手机号作为 open-id
⚠️ 关键约束:
-m scripts.focus_analysis 处理视频文件(必须在技能根目录下运行脚本)--input: 本地视频文件路径(使用 multipart/form-data 方式上传)--url: 网络视频 URL 地址(API 服务自动下载)--analyze-duration: 分析视频时长,单位:分钟,默认 30--focus-threshold: 专注度阈值,低于该分值判定为分心,默认 0.6--open-id: 当前用户的 open-id(必填,按上述流程获取)--scene: 应用场景,可选:classroom/office/driving,默认 classroom--list: 显示专注度分析历史报告列表清单(可以输入起始日期参数过滤数据范围)--api-key: API 访问密钥(可选)--api-url: API 服务地址(可选,使用默认值)--detail: 输出详细程度(basic/standard/json,默认 json)--output: 结果输出文件路径(可选)专注度分析报告-{记录id}形式拼接, "点击查看"列使用
[🔗 查看报告](reportImageUrl)
格式的超链接,用户点击即可直接跳转到对应的完整报告页面。| 报告名称 | 分析时间 | 平均专注度 | 点击查看 |
|---|---|---|---|
| 专注度分析报告-20260312172200001 | 2026-03-12 17:22:00 | 0.85 | 🔗 查看报告 |
# 分析课堂视频(以下只是示例,禁止直接使用openclaw-control-ui 作为 open-id)
python -m scripts.focus_analysis --input /path/to/classroom.mp4 --scene classroom --analyze-duration 45 --open-id openclaw-control-ui
# 分析办公会议视频,设置专注度阈值(以下只是示例,禁止直接使用openclaw-control-ui 作为 open-id)
python -m scripts.focus_analysis --input /path/to/meeting.mp4 --scene office --focus-threshold 0.55 --open-id openclaw-control-ui
# 分析驾驶视频(以下只是示例,禁止直接使用openclaw-control-ui 作为 open-id)
python -m scripts.focus_analysis --input /path/to/driving.mp4 --scene driving --analyze-duration 120 --open-id openclaw-control-ui
# 显示历史分析报告/显示分析报告清单列表/显示历史专注度报告(自动触发关键词:查看历史分析报告、历史报告、分析报告清单等)
python -m scripts.focus_analysis --list --open-id openclaw-control-ui
# 输出精简报告
python -m scripts.focus_analysis --input video.mp4 --scene classroom --open-id your-open-id --detail basic
# 保存结果到文件
python -m scripts.focus_analysis --input video.mp4 --scene classroom --open-id your-open-id --output result.json