核心功能
xuexitong-homework-submit 是一款面向学习通（超星）平台的作业自动化 CLI 工具，通过 Python 脚本将原本繁琐的手动网页操作流程转化为可复用的命令行工作流。
主要能力模块
| 模块 | 功能说明 |
|------|---------|
| `list` | 扫描并列出所有可作业入口（taskrefId） |
| `resolve` | 解析特殊任务链接为可直接访问的 doHomeWork URL |
| `fetch`+`template` | 抓取题目内容并生成结构化答案模板（JSON） |
| `save` | **安全暂存**答案，不触发最终提交 |
| `submit` | 正式交卷，需显式 `--confirm` 确认 |
| 手写图流水线 | 文本答案 → 手写风格 PNG（handright）→ 图床上传 → HTML `<img>` 嵌入 |
| `scan_pending` | 批量扫描疑似未填写的新作业 |
技术依赖与开源生态
- requests：HTTP 会话与 Cookie 管理
- handright：将文本渲染为仿真手写笔迹图像
- Pillow：图像处理与格式转换
安全设计
- Cookie 隔离存储于
~/.openclaw/credentials/xuexitong_cookie.txt - 交卷操作强制二次确认，避免误触
- 支持
--sleep-ms参数控制请求频率，降低限流风险
显著优点
1. 可复现性：JSON 模板使答案编辑版本可控
2. 防误操作：save/submit 分离，暂存可反复验证
3. 手写模拟：针对需手写拍照提交的场景提供程序化方案
4. 增量扫描：快速定位未完成作业，减少人工巡查
潜在局限与风险
| 风险类型 | 说明 |
|---------|------|
| 学术诚信 | 自动化提交可能违反平台用户协议及学校学术规范 |
| 账号安全 | 依赖本地 Cookie 文件，若权限配置不当存在泄露风险 |
| 服务稳定性 | 平台接口变更可能导致脚本失效，需持续维护 |
| 检测风险 | 异常请求模式（频率、IP、User-Agent）可能触发风控 |
适合人群
- 需批量处理标准化作业的技术人员/助教（在合规前提下）
- 希望建立个人答题知识库并复用历史答案的学习者
- 对手写提交有硬性要求、需程序化生成图像的场景
常规风险缓解
- 严格遵守
--confirm机制，避免 unintended submit - 定期轮换 Cookie，监控
401/403异常 - 控制请求频率，避免高峰期高频调用
- 关注上游仓库更新，及时适配平台接口变更