Xuexitong Homework Submit

---

name: xuexitong-homework-submit description: "学习通/超星作业自动化（v1.1.2）：扫描作业、抓题模板、暂存/交卷、手写图答案流水线。致谢 HandWrite、学习通 API（mooc1-api.chaoxing.com）与超星图床上传接口（notice.chaoxing.com）。" version: 1.1.2 homepage: "https://github.com/smallwhiteman/xuexitong-homework-submit-skill" metadata: author: smallwhiteman openclaw: emoji: "📚"

---

学习通（超星）作业自动化 Skill

把「手动点网页」变成「可复用命令流程」：

列作业入口（taskrefId）

解析到 doHomeWork URL

抓题并生成可编辑答案模板

暂存（save）/交卷（submit）

手写图答案流水线：文本答案 → 手写 PNG → 图床 URL → HTML → 暂存

当前版本：v1.1.2

致谢

感谢本 Skill 使用到的三个核心依赖/服务：

HandWrite（手写渲染能力）

学习通 API：mooc1-api.chaoxing.com

超星图床上传接口：notice.chaoxing.com/pc/files/uploadNoticeFile

安全约束

默认 Cookie 文件：~/.openclaw/credentials/xuexitong_cookie.txt

save 是安全操作（暂存）

submit 是高风险操作（交卷），必须显式 --confirm

快速开始

> 目录变量：{baseDir} 指当前 skill 根目录。

# 1) 列出作业入口
python3 {baseDir}/scripts/xuexitong_submit.py list
2) 解析 task 链接 -> doHomeWork URL
python3 {baseDir}/scripts/xuexitong_submit.py resolve \
  --task-url ""
3) 抓题 + 生成答案模板
python3 {baseDir}/scripts/xuexitong_submit.py fetch \
  --dohomework-url "" \
  --out work.json
python3 {baseDir}/scripts/xuexitong_submit.py template \
  --work-json work.json \
  --out answers.json
4) 暂存（推荐先走这步）
python3 {baseDir}/scripts/xuexitong_submit.py save \
  --dohomework-url "" \
  --answers answers.json \
  --work-json work.json
5) 交卷（必须显式确认）
python3 {baseDir}/scripts/xuexitong_submit.py submit \
  --dohomework-url "" \
  --answers answers.json \
  --work-json work.json \
  --confirm

手写图答案流水线

# A. 初始化：抓题并生成可编辑 answers_text.json
python3 {baseDir}/scripts/xuexitong_hw_pipeline.py init \
  --dohomework-url "" \
  --outdir runs/run1
手动编辑 runs/run1/answers_text.json 的 answer 字段
B. 执行：渲染->上传->生成 HTML 答案->暂存
python3 {baseDir}/scripts/xuexitong_hw_pipeline.py run \
  --dohomework-url "" \
  --rundir runs/run1

扫描“疑似新作业且未填写”

python3 {baseDir}/scripts/xuexitong_scan_pending.py \
  --limit 80 \
  --out runs/pending_scan.json

输出包含：

candidates[]：候选作业（疑似未交且未写）

resolveFailures[]：解析失败的任务入口

自动更新检查（已内置）

每次运行主脚本都会去 GitHub 检查最新版本（读取仓库 VERSION）：

若有新版本，会打印更新提示

不会阻塞主流程（网络失败时静默跳过）

更新命令：

clawhub update xuexitong-homework-submit

临时关闭更新检查：

XUEXITONG_SKIP_UPDATE_CHECK=1 python3 {baseDir}/scripts/xuexitong_submit.py list

常见故障

401/403 或页面异常：Cookie 过期，重新抓取 Cookie。

单题提交成功但多题空白：请传 --work-json，脚本会逐题提取隐藏字段。

服务器偶发 EOF/限流：重试或加 --sleep-ms 200 降速。