clansty/superstar-checkin

超星学习通自动签到

Superstar Checkin

超星学习通自动签到工具

特色：

• 通过 IM 协议实时获取签到信息，而不是每隔一定时间请求服务器

• 包含 QQ 机器人，实时向指定的群通知程序状态

• 支持使用任何一张二维码进行二维码签到，即使二维码已经过期（直接在指定群内发送二维码即可）

功能（已实现部分）

• 自动取 Cookie，过期自动更新

• 支持通过学习通 IM 协议实时获取签到推送

• 在群内发送提醒并自动签到

• 通过 QQ 机器人接收群内发送的二维码实现二维码签到

  本功能只需要一张已过期的二维码就可以

• 支持多用户共同签到

• 根据课程设置签到经纬度以及位置名称

  请使用此网页拾取坐标

• 支持通过周次设定签到的地址，适用于实验课和正课在不同地点的情况

• 手动签到

  机器人命令：签到 {aid} [enc(二维码签到时)|courseId(位置签到时。不需要提交位置可以不填)]

• Docker 和 Docker Compose 部署

• 通过 REST API 设置课程信息

部署方法

使用 Docker Compose 部署

1. 下载 docker-compose.yaml 和 config.example.yaml，将它们放在一个文件夹中
2. 将 config.example.yaml 重命名为 config.yaml
3. 修改 config.yaml 中的配置项
4. docker compose up

使用 NixOS 部署

1. 在你的系统 Flake 中，引入本项目

   inputs.superstar-checkin.url = "github:clansty/superstar-checkin";

2. 在系统配置的某个 Module 中填写配置项（查看示例）

3. nixos-rebuild switch

可以使用 systemctl status superstar-checkin 来查看状态

手动部署

1. 安装 NodeJS 14 以上版本
2. yarn install
3. cp config.example.yaml config.yaml 并在 config.yaml 中填写配置项。配置文件中自带说明，请参考
4. yarn build
5. yarn start

提示：机器人使用的账号必须已经在 oicq 框架上登录过

限制

（据说）学习通禁止腾讯云阿里云这种 IP 签到，所以需要部署在家庭宽带下

参考

本程序借鉴了一些前人的项目：

• mkdir700/chaoxing_auto_sign
• SSmJaE/XueXiTonsSign_Electron
• cyanray/cx-auto-sign

更多有关学习通签到的项目值得尝试

项目地址	开发语言	备注
https://github.com/cyanray/cx-auto-sign	C#	超星学习通自动签到工具，通过IM协议监测签到活动。
https://github.com/mkdir700/chaoxing_auto_sign	Python	超星学习通自动签到脚本&多用户多任务&API
https://github.com/PrintNow/ChaoxingSign	PHP	PHP版超星自动签到，支持多用户，二次开发便捷！
https://github.com/Wzb3422/auto-sign-chaoxing	TypeScript	超星学习通自动签到，梦中刷网课
https://github.com/Huangyan0804/AutoCheckin	Python	学习通自动签到，支持手势，二维码，位置，拍照等
https://github.com/aihuahua-522/chaoxing-testforAndroid	Java	学习通（超星）自动签到
https://github.com/yuban10703/chaoxingsign	Python	超星学习通自动签到
https://github.com/SSmJaE/XueXiTonsSign_Electron	TypeScript	基于Electron，桌面端，GUI，签到队列