作业判分

要解决什么问题

批量收作业后，最耗时的往往不是「看内容」，而是把分数写回成绩单：文件夹命名不统一、缺交要单独标记、同一门课还要保留多次作业的列而不覆盖历史分数。若再叠加代码、文档、图片等不同格式，人工逐份打开再打分很难规模化。

技能如何工作

技能以 homework_dir 为入口，约定目录里有且只有一个 .xlsx 成绩单（需含 学号、姓名 列），其余子文件夹视为学生提交。文件夹名需包含学生姓名（建议 {姓名}_{作业标识}），程序会按姓名做匹配（含去空格、去后缀等模糊规则），无法匹配的会进入未匹配列表。

对每个已匹配提交，会按后缀选择读取方式：.py / .js 等走代码全文；.md / .txt / .pdf 走文本；.jpg / .png 走图像分析。若有 要求.md 或你提供的作业要求，会一并作为批改上下文，从正确性、完整性、规范性（及可选的创新加分）给出百分制分数与简要评语。

写回 Excel 时会自动识别已有 作业N得分 列，为本轮评分追加下一列；未提交填 缺交 或 0；修改前会生成 成绩单.bak.xlsx 备份。最后输出 Markdown 汇总表（学号、姓名、提交状态、得分、评语）及平均分、最高/最低分、缺交人数。

适用边界与注意点

• 操作前请关闭 Excel，避免文件被锁定。
• 姓名匹配以精确优先，模糊匹配建议人工复核日志。
• 单份作业判分失败不会阻断整批；失败项会记入错误日志。
• 可通过 max_score 自定义满分，默认百分制。