儿童专注度与走神时段分析

要解决什么问题

家长或老师想判断孩子写作业、上网课时的真实专注程度，单靠偶尔看一眼很难量化，也记不住「哪几分钟在走神、走神时在做什么」。本技能面向智能台灯内置摄像头或桌面固定机位的学习区域视频：把面部是否偏离书本/屏幕、视线方向、手部小动作等行为转成可对比的指标，并标出走神时段，便于事后对照录像或报告讨论学习状态。

技能如何工作

分析侧扮演儿童学习行为分析 AI，只输出基于视觉的客观结果，不提供教学方案或学习建议。

• 输入：本地 mp4/avi/mov（建议 ≥15 FPS、光照均匀、正对面部与学习区域），或公网视频 URL（由 API 侧下载）。
• 检测与打分：儿童是否在场、面部朝向、视线、手部小动作（玩笔、摸脸、摆弄物品、玩手机等）、离座；按分钟给出 0–100 专注分，并归类走神事件：gaze_away、head_lift、hand_fidget、off_seat、phone_use。
• 输出：会话时长、整体专注分、focus_grade（excellent / good / fair / poor）、每分钟得分序列、走神起止与累计走神时长；专注度持续偏低时可给出提醒文案。
• 历史报告：用户查询历史清单时，须通过 python -m scripts.smyx_child_focus_analysis_analysis --list --open-id ... 从云端拉取，以表格展示报告名、整体专注度、分析时间与报告链接；执行分析前需取得有效 open-id，禁止臆造。

典型脚本入口：scripts/smyx_child_focus_analysis_analysis.py，参数含 --input / --url、--open-id、--detail（如 json）等。

适用边界与注意点

• 评分仅供行为辅助参考，不能替代家长或教师的现场观察与教育判断。
• 涉及未成年人影像，使用前需监护人知情同意，并妥善保管录像与报告。
• 单文件大小上限约 10MB；历史数据不得从本地 memory 拼凑，须走统一 API。