学情总结抽查自动化

从 SmartBI 导出「教学&学管协作跟进明细」报表，按老师维度抽样评估学情总结是否符合模板、同质化程度，输出格式化的 Excel 抽查结果报告。

触发方式

用户说以下类似内容时触发：

• "抽查学情总结"
• "学情总结质量检查"
• "检查老师学情反馈"
• "学情抽查"

使用方式

python3 ~/.workbuddy/skills/xueqing-review/xueqing_review.py \
  --input "<导出的Excel路径>" \
  --output "<输出路径>" \
  --sample <抽样数量> \
  --template "<学情反馈模板Excel路径>"

参数说明

参数	必填	说明
--input	是	已导出的教学协作跟进明细 Excel 文件路径
--output	是	输出 Excel 文件路径
--sample	否	抽样老师数量，默认 20
--template	否	学情反馈模板 Excel 路径（用于自定义模板）
--seed	否	随机种子，默认 42（确保可复现）

完整流程

第一步：从 BI 导出数据

使用 bi_skill 导出报表：

python3 ~/.workbuddy/skills/bi_skill/bi_skill.py search \
  --name "教学&学管协作跟进明细" \
  --output "<输出目录>"

然后在 BI 页面手动设置筛选条件（或使用 export_xueqing.py 自动设置）：

• 日期：当天
• 主讲做工开始/结束时间：月1号 ~ 当天
• LP做工开始/结束时间：同主讲
• 当月协作池标签：选择对应协作池

第二步：运行学情分析

python3 ~/.workbuddy/skills/xueqing-review/xueqing_review.py \
  --input "<导出文件路径>" \
  --output "<输出路径>" \
  --sample 20

评估规则

模板匹配标准

学情总结需包含以下结构才视为「符合模板」：

三个阶段的模板结构：

阶段	主题	必含关键词
s1-3	学员兴趣	专注力、记忆犹新、学习兴趣/课堂活跃度
s4-6	学员习惯	学习习惯、记忆犹新、笔记草稿
s7-9	学员成绩	校内成绩、记忆犹新

通用关键词（所有阶段都需包含至少3个）：
记忆犹新、较好知识点、需要提升知识点、家长痛点、未续费顾虑点

格式要求： 需包含编号条目（如 1.xxx 2.xxx），至少5个编号条目

不符合模板的情况

• 太短的文本（15字以内）
• 状态备注（已转走、已续费、停课等）
• 无编号结构的自由文本
• 使用课后反馈模板而非学情反馈模板

评级标准

评级	条件
优秀	符合模板 + 同质化低（平均相似度 < 35%，每条内容个性化）
及格	符合模板 + 同质化高（平均相似度 ≥ 35%）
不及格	发送内容不符合模板要求，且疑似课后反馈内容

同质化计算

使用 SequenceMatcher 算法计算同一老师多条学情总结两两之间的文本相似度，取平均值。

输出格式

Excel 包含 3 个 Sheet：

1. 抽查总览：老师姓名、艺名、学情总数、符合模板数、阶段、同质化评估、综合评级
2. 详细条目：每条学情总结的具体内容、是否匹配、匹配度、评估说明
3. 评估规则：本次评估的规则说明

颜色标注：绿色=优秀、黄色=及格、红色=不及格

依赖

• Python 3.10+
• pandas
• openpyxl
• playwright（仅导出时需要）

注意事项

• 数据表头在第 10 行（header_row=9），学情总结列名为"学情总结"
• 抽样优先选择有 ≥2 条学情总结的老师（评估更准确）
• 默认随机种子 42，确保每次抽样结果可复现
• 如需更换协作池，需重新从 BI 导出数据