Skip to content

Latest commit

 

History

History
99 lines (61 loc) · 4.3 KB

readme.md

File metadata and controls

99 lines (61 loc) · 4.3 KB

Superstar Checkin

超星学习通自动签到工具

GitHub package.json dependency version (prod) discord

特色:

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

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

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

功能(已实现部分)

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

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

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

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

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

  • 支持多用户共同签到

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

    请使用此网页拾取坐标

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

  • 手动签到

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

  • Docker 和 Docker Compose 部署

  • 通过 REST API 设置课程信息

部署方法

使用 Docker Compose 部署

  1. 下载 docker-compose.yamlconfig.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 签到,所以需要部署在家庭宽带下

参考

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

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

项目地址 开发语言 备注
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,签到队列