腾讯会议知识付费智慧考官 — 全链路课堂考勤与学情追踪
> 🎯 腾讯会议与微信生态深度孪生，让知识付费讲师在微信生态内完成教学闭环，不再跳转到外部工具。
>
> 本工具填补腾讯会议在"轻量教学工具"层面的功能空白——QQ课堂下线后遗留的考勤签到、学情统计、专注度监测等教学刚需，现在一站搞定。
核心能力
1. 课前智能签到
- 限时签到：设定签到窗口（如开课前5分钟），超时自动标记迟到
- 多次签到：课中随机发起签到，防止挂机/代签
- 身份核验：结合等候室名单，核验参会者身份
2. 课中专注度监测
- 入会时长追踪：记录每位学员的实际在会时长
- 互动频次统计：统计举手、投票、发言等互动行为
- 异常检测：识别长时间无互动、频繁进出等异常行为
3. 课后学情报告
- 个人学情档案：出勤率、专注度评分、互动表现
- 班级整体分析：到课率趋势、互动热力图、薄弱环节
- AI学情建议：基于数据生成个性化学习建议
工作流程
流程一：创建考勤任务
当用户说"为XX会议创建考勤"或类似意图时：
- 确认目标会议（会议ID或会议主题）
- 配置考勤规则：
- 签到模式：限时签到 / 多次签到 / 身份核验
- 迟到阈值：开课后多少分钟算迟到（默认5分钟）
- 专注度计算方式：基于在会时长+互动频次 - 调用
scripts/attendance_manager.py的setup_attendance函数 - 返回考勤任务配置确认
流程二：执行签到与监测
当会议进行中，用户说"开始签到"或触发定时签到时：
- 调用腾讯会议Skill的签到管理API发起签到
- 调用
get_participants获取实时参会成员 - 记录签到状态和在会时长
- 如启用多次签到，按设定间隔发起新一轮签到
流程三：生成学情报告
当会议结束或用户说"生成学情报告"时：
- 获取完整参会成员列表和签到记录
- 获取AI智能纪要（如有）提取互动数据
- 调用
scripts/learning_analytics.py的generate_report函数 - 输出格式化的学情报告（个人版/班级版）
输入参数
| 参数 | 必填 | 说明 |
|---|---|---|
| meeting_id | 是 | 腾讯会议ID |
| attendance_mode | 否 | 签到模式：limited/multi/verify，默认limited |
| late_threshold | 否 | 迟到阈值（分钟），默认5 |
| report_type | 否 | 报告类型：personal/class，默认class |
输出格式
签到状态通知
📋 考勤任务已创建
━━━━━━━━━━━━━━━━
会议：{meeting_topic}
会议ID：{meeting_id}
签到模式：{mode}
迟到阈值：{threshold}分钟
━━━━━━━━━━━━━━━━
✅ 准备就绪，开课后自动启动签到
实时签到结果
📊 第{round}轮签到结果
━━━━━━━━━━━━━━━━
已签到：{signed}/{total} 人
签到率：{rate}%
迟到：{late} 人
未签到：{unsigned} 人
━━━━━━━━━━━━━━━━
⏱️ 签到截止时间：{deadline}
学情报告（班级版）
📈 班级学情报告 — {class_name}
━━━━━━━━━━━━━━━━━━━━━━━
📅 课程日期：{date}
👥 应到/实到：{expected}/{actual} 人
📊 到课率：{attendance_rate}%
🔥 互动排行 TOP5
1. {name1} — {score1}分（签到{sig1}+互动{int1}）
2. {name2} — {score2}分
3. {name3} — {score3}分
4. {name4} — {score4}分
5. {name5} — {score5}分
⚠️ 需关注学员
• {name_a}：到课率低于60%，建议沟通
• {name_b}：连续3次未互动，可能掉队
💡 教学建议
• {suggestion_1}
• {suggestion_2}
━━━━━━━━━━━━━━━━━━━━━━━
与腾讯会议Skill的协作
本技能依赖腾讯会议Skill提供的基础能力：
| 本技能功能 | 依赖的腾讯会议Skill能力 |
|---|---|
| 会议信息获取 | get_meeting |
| 签到管理 | 签到管理API（发起/终止/查询） |
| 参会成员追踪 | get_participants |
| 身份核验 | get_meeting_invitees + 等候室API |
| 互动数据 | 投票API、转写数据 |
| AI纪要 | get_smart_minutes |
| 课程回放 | 录制管理API |
边界情况处理
- 会议未开始：提示用户等待会议开始后执行签到
- API调用失败：记录失败原因，提供手动签到的备选方案
- 数据不完整：标注缺失数据项，基于已有数据生成部分报告
- 权限不足：提示用户检查腾讯会议账号权限（需商业版或以上）
适用场景
- 🎓 高校课堂：教务考勤+学情追踪
- 🏢 企业培训：培训签到+效果评估
- 📚 知识付费：学员管理+满意度分析
- 🎯 认证考试：身份核验+监考辅助
