技能介绍

要解决什么问题

大班授课时，教师很难同时盯住每位学生的表情与互动状态。固定机位摄像头虽然一直在录，但把「专注、困惑、无聊、沮丧」等信号转成可操作的课堂反馈，通常仍依赖人工扫视或课后回看，实时性不足。

本技能面向教室固定摄像头采集的图片或视频（本地文件或 URL），在不做人脸身份绑定的前提下，做群体层面的课堂参与度分析，供教师调整节奏、关注可能遇到理解困难的位置。

技能如何工作

分析链路大致如下：

感知：人脸检测（不关联身份）、六类情绪（focused / confused / happy / frustrated / bored / neutral）、头部朝向（相对讲台）、举手事件计数
结构化：座位 ROI 网格（row × col）、教学环节推测（如 lecture / interaction / practice）
输出：班级整体参与度评分（0–100）、低参与度座位坐标（仅坐标、匿名）、困惑/沮丧热点、与上一时间窗的趋势对比、面向教师的中性建议、参与度伪彩色热力图

标准执行路径：用户提供清晰可用的课堂视频输入 → 系统在内部完成身份关联（不向用户索取或展示身份参数）→ 在技能根目录调用 scripts/smyx_classroom_engagement_analysis_analysis（--input 或 --url）→ 返回结构化报告与报告链接。若用户表达查看历史报告清单的意图，须通过 --list 从云端 API拉取最新清单并以 Markdown 表格呈现，不得从本地 memory 或人工汇总伪造列表。

适用边界与注意点

输入以 mp4/avi/mov 为主，文档要求单文件约 10MB 上限；机位宜为讲台对面或斜侧高位，能覆盖大部分学生面部。
记笔记低头、思考等日常动作可能被误判为「无聊」或「困惑」，宜结合短时序均值解读；讲解切换到练习等环节时，短暂参与度下降可能属正常波动。
强匿名与合规：禁止人脸识别/学生身份绑定；禁止用于绩效评估、家长沟通或公开排名；禁止长期存原始视频或可识别个人数据。涉及未成年人需学校与家长知情同意，建议教务处统一备案。在线教育场景需学生开摄像头且采集合法合规。