超星学习通 作业自动批改

工作流总览

① 配置 config.json → ② 下载作业HTML → ③ 提取主观题 → ④ AI批改 → ⑤ 写回评分 → ⑥ 清理输出

0. 前置准备

Chrome 远程调试

# 以CDP模式启动Chrome（关闭所有Chrome窗口后运行）
chrome.exe --remote-debugging-port=9222 --remote-allow-origins=* --user-data-dir="C:ChromeDebug"

安装依赖

pip install websockets

1. 下载作业 HTML

python scripts/download_homework.py --config config.json --login

--login 会在浏览器打开超星登录页，等待手动登录（或自动登录若密码已配置）。

无 --login 则假设已有登录态，直接开始下载。

参数

config.json 下载相关配置

{
  "login": {
    "chrome_port": 9222,
    "script_base": "https://mooc2-ans.chaoxing.com",
    "account": "手机号",
    "password": "密码",
    "cpi": "cpi参数（从超星URL获取）"
  },
  "download": {
    "target_students": ["学生A", "学生B"],
    "courses": [
      {"name": "课程名", "courseid": 123, "classes": [
        {"name": "班级名", "clazzid": 456}
      ]}
    ],
    "output_dir": "下载目录"
  }
}

获取 courseid / clazzid / cpi：登录后打开任意作业列表页，URL中 courseid=xxx&clazzid=xxx&cpi=xxx。

下载说明

• 每个学生按姓名创建子目录，文件命名 学生名_课程_作业名.html
• 自动勾选"显示客观题"checkbox + JS强制移除 display:none
• 支持作业列表分页 + 学生列表分页
• 已存在的文件自动跳过（断点续传）

2. 提取主观题 → JSON

python scripts/extract_subj.py --config config.json

读取 paths.input_dir 下所有HTML → 提取主观题（简答题）题干、学生答案、满分 → 输出 {work_dir}/subj_questions.json

3. AI 批改主观题

python scripts/grade_subj.py --config config.json

读取 subj_questions.json → 逐题调用LLM API评分 → 输出 {work_dir}/subj_graded.json

特性：

• 断点续评（已有记录跳过）
• 每 save_every 题自动保存
• API限流控制 rate_limit_seconds

4. 写回评分到原始HTML

python scripts/apply_scores.py --config config.json

读取 subj_graded.json → 在原始HTML的 更新 value → 原地修改

5. 清理HTML（最终输出）

python scripts/clean_html.py --config config.json

读取 paths.input_dir → 输出到 paths.output_dir

处理内容：

• 剥离