班主任成绩助手
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_cf809658/grade-manager。
技能介绍
解决什么问题
班主任每学期要处理多场考试的成绩单:同一考试的 Excel 反复更新、每位学生需要一份历次成绩汇总、还要发到腾讯文档里分发。手工复制粘贴既慢又容易错——重考被当成新考、成绩着了色又被要求改回来、改错了还在云文档留痕。这个技能把整套流程固化为可重复执行的管线,核心是按文件名对考试去重:同一文件名再处理就是更新,新文件名才是新增;学生成绩单统一黑色显示,只放考试名称、各科分数与总分,绝不出现名次、平均分和日期。
它如何工作
本地处理(pipeline.py):扫描 成绩管理/班级/ 根目录的 .xlsx/.xls(学生子文件夹不递归,防止把学生成绩单当考试文件);多行表头的 .xls 自动经 xls_convert.py 转成单行表头再解析;原表总分列直接优先采用,与各科之和差超 0.05 只告警不覆盖;生成 姓名_学号.xlsx 并输出 review.json,处理前自动备份 grade_data.json。
审阅确认:pipeline 跑完后必须在对话里完整列出所有学生的成绩——这只是唯一的核对窗口,不许只丢文件路径。班主任说「确认」或直接改分(如「张三数学改为130」),改完重新生成成绩单。
云文档同步(sync_cloud.py):已有「姓名_学号」文档就原地 clear + rewrite + restyle,不删除、不改 URL、不动权限;只有旧「成绩单」则先 rename_file_title 原地改名再更新;都没有才导入新建。技术细节上有三处值得注意:列宽单位是像素(考试名 170px、学科 80px),显式设置全部列时无需先清空;每一行容器加 wrap_text;set_privilege 只能放开不能收回私密,所以脚本从不碰权限,默认文档全私密,分发前由老师手动改。单份学生失败不影响其他人,失败了看 sync_results.json 补同步即可。
适用边界
- 全程手动触发:说「处理成绩」跑 pipeline,说「同步」跑 sync,不建 automation。
- 班级名以文件夹名为准,不做校对;汇总列只认「总分/原始总分/总分合计/等级总分」,口径不明的(如「4门总分」)忽略。
- 学号保持字符串化(保前导零);
manage.set_privilege只能设 policy 2/3,设不回私密;遇到400007/400008是 VIP 积分不足,应暂停提示充值而不是重试。 - 连接器写入的是教师本人云文档空间,个人开发者无法直接分享给学生/家长,分发要走 COS 临时链接或 PDF 转发。
使用场景
- 新一场月考成绩 Excel 放进班级文件夹后,跑一遍处理成绩流程,把这轮成绩追加进所有学生的个人成绩单。
- 原表总分列和各科之和差了 0.08,需要按成绩系统导出值保留原表总分,同时提醒老师们再核实一次。
- 要把每位学生的成绩单原地更新到已有的腾讯文档,副本不改链接也不改权限。
- 发现上一场考试里有个学生已转学,需要更新该场考试的学生名单并删除那条记录。
适合人员
- 需要把班级历次考试成绩汇总去重并生成学生个人成绩单的班主任
- 需要按文件名去重更新成绩并同步到腾讯文档的教务/信息技术老师
- 使用含多行表头 .xls 导出的老成绩系统、需要批量清洗后再用的教师
- 需要将成绩分发给家长和学生并坚持不改动云文档权限的班主任