⚠注意

由于超星学习通更新，目前无法签到二维码签到 #23。其他类型的签到正常。

项目简介

cx-auto-sign 是基于 .NET5 的超星学习通自动签到工具。

本项目最低程度实现超星学习通的即时通讯协议。通过超星学习通的即时通讯协议监测最新的课程活动。当指定的课程有新的消息，就检查该课程是否有新的签到任务，如果有则进行签到。该方法与轮询相比，灵敏度更高，占用资源更低。

项目进度

支持手机号登录和学号登录两种登录方式
支持 init指令，用以生成配置文件
实现自动签到工作流程
支持签到成功后发送邮件通知
支持 WebApi 控制自动签到启停
支持通过Server酱发送通知

使用方法

0x00 运行环境

首先需要在.Net Runtime 下载页下载并安装 .NET5 Runtime (提示：Run server apps下边的下载)。

然后在Release页面下载 cx-auto-sign.zip，并解压到某个目录。

(你也可以在 Actions 中找到自动编译的测试版)

0x01 登录并初始化配置文件

在 cx-auto-sign.dll 所在的目录执行以下命令行(Windows 和 Linux都适用):

# 通过手机号码登录，不需要学校编码
dotnet ./cx-auto-sign.dll init -u "双引号里面填手机号" -p "双引号里面填密码"

或：

# 通过学号登录，需要学校编码
dotnet ./cx-auto-sign.dll init -u "双引号里面填学号" -p "双引号里面填密码" -f "学校编码"

以上指令会创建 AppConfig.json 文件、 EmailConfig.json 文件、 Courses 目录和 Images 目录。

AppConfig.json 文件用于配置签到的一些参数。

EmailConfig.json 文件用于配置通知邮件的参数。

Courses 目录下有一系列 .json 文件，每个文件对应一门课程。对于不需要自动签到的课程，请删除对应的文件。

Images 目录中的图片会用于拍照签到，签到时会随机抽取一张图片用于签到。

0x02 开始自动签到

在 cx-auto-sign.dll 所在的目录执行以下命令行:

dotnet ./cx-auto-sign.dll work

即可开始自动签到。

配置文件说明(AppConfig.json)

执行 init 指令时会创建该文件，其内容以及解释如下：

{
    "Username": "",             // 学号或手机号
    "Password": "",             // 密码
    "Fid": "",                  // 学校代号，fid为null时使用手机号登录
    "Address": "**",           // 定位签到的中文名地址
    "Latitude": "-1",           // 定位签到的纬度
    "Longitude": "-1",          // 定位签到的经度
    "ClientIp": "1.1.1.1",      // 签到时提交的客户端ip地址
    "DelaySeconds": 10,         // 检测到新签到活动后延迟签到的秒数（过小容易出现秒签到现象）
    "EnableWebApi": true,       // 是否启动 Web Api，默认关闭
    "ServerChanKey": "SCKEY"    // Server酱的SCKEY，默认为 null
}

WebApi 说明

WebApi 默认地址是 localhost:5743，可在 appsettings.json 文件里修改。

查看状态

请求：GET /status

响应：

{
    "username":"0000000000",    // 学号或手机号
    "cxAutoSignEnabled":true    // 是否启动自动签到，默认为 true
}

启动自动签到

请求：GET /status/enable

响应：

{
    "code": 0,
    "msg":"success"
}

停止自动签到

请求：GET /status/disable

响应：

{
    "code": 0,
    "msg":"success"
}

FQA

1. 如何关闭自动更新检测?

在 cx-auto-sign.dll 所在目录下创建一个名为 .noupdate 的文件。

声明

一切开发旨在学习，请勿用于非法用途。

WindFlames / cx-auto-sign

⚠注意