cx-auto-sign 是基于 .NET5 的超星学习通自动签到工具。
本项目最低程度实现超星学习通的即时通讯协议。通过超星学习通的即时通讯协议监测最新的课程活动。当指定的课程有新的消息，就检查该课程是否有新的签到任务，如果有则进行签到。该方法与轮询相比，灵敏度更高，占用资源更低。
- 支持 手机号登录 和 学号登录 两种登录方式
- 支持
init指令，用以生成配置文件 - 支持
update指令，更新课程信息 - 实现自动签到工作流程
- 支持 WebApi 控制自动签到启停
- 支持通过 Server 酱 发送通知
- 支持通过 PushPlus 推送加 发送通知
- 支持签到成功后发送 邮件通知
- 支持多账号配置
首先需要在 .Net Runtime 下载页 下载并安装 .NET5 Runtime（提示：Run server apps下边的下载）。
然后在 Release页面 下载 cx-auto-sign.zip，并解压到某个目录。
（你也可以在 Actions 中找到自动编译的测试版）
在 cx-auto-sign.dll 所在的目录执行以下命令行（Windows 和 Linux都适用）：
# 通过手机号码登录，不需要学校编码
dotnet ./cx-auto-sign.dll init -u "双引号里面填手机号" -p "双引号里面填密码" 或：
# 通过学号登录，需要学校编码
dotnet ./cx-auto-sign.dll init -u "双引号里面填学号" -p "双引号里面填密码" -f "学校编码"在 cx-auto-sign.dll 所在的目录执行以下命令行:
dotnet ./cx-auto-sign.dll work即可开始自动签到。
配置文件均采用 json5 格式，方便编辑、打注释。
cx-auto-sign
├── Configs
│ └── Username.json5
├── Images
│ └── ...
├── AppConfig.json5
├── ...
AppConfig.json5文件为 应用配置文件。Configs文件夹存放 用户配置文件。Username.json5文件为 用户配置文件，其中Username指用户名。Images文件夹存放「图片签到」要提交的图片。
执行 init 指令时会创建以上文件
课程配置 > 用户配置 > 应用配置
当配置中没有该属性，或值为 null 时会向下一级取值。
- 应用配置：为
AppConfig.json5文件 - 用户配置：为
Configs文件夹下的文件 - 课程配置：为 用户配置 中
Couses属性
{
// 通知，可以在 应用配置 和 用户配置 中配置
"ServerChanKey": "", // Server 酱的 SendKey https://sct.ftqq.com/sendkey
"PushPlusToken": "", // PushPlus 的 Token https://www.pushplus.plus/
"BarkUrl": "", // Bark，例如：https://api.day.app/yourkey
// 电报 Telegram Bot 推送，可以在 应用配置 和 用户配置 中配置
// 详见：https://gist.github.com/dideler/85de4d64f66c1966788c1b2304b9caf1
"TelegramBotToken": "",
"TelegramBotChatId": "",
// 邮箱通知，可以在 应用配置 和 用户配置 中配置
"Email": "", // 接收通知的邮箱
"SmtpHost": "", // Smtp 发件主机
"SmtpPort": 0, // Smtp 发件端口
"SmtpUsername": "", // Smtp 发件邮箱
"SmtpPassword": "", // Smtp 发件密码
"SmtpSecure": true, // Smtp 是否使用 SSL
// 签到配置，可以在 应用配置、用户配置 和 课程配置 中配置
"SignEnable": false, // 允许自动，注意：默认是不会自动签到的！！！
"SignNormal": true, // 允许普通签到
"SignGesture": true, // 允许手势签到
"SignPhoto": true, // 允许图片签到，默认一张黑图，可在这里设置值，详见「拍照签到参数说明」
"SignLocation": true, // 允许位置签到
"SignDelay": 0, // 检测到新签到活动后延迟签到的秒数（过小容易出现秒签到现象）
"SignClientIp": "1.1.1.1", // 签到时提交的客户端 ip 地址
"SignAddress": "中国", // 位置签到的中文名地址
// 经纬度坐标使用的是百度坐标系，可通过此工具来确定 https://tool.lu/coordinate/
// 注意不要弄反了，不然你就在地球的另一头上课了
"SignLongitude": "-1",// 位置签到的经度
"SignLatitude": "-1", // 位置签到的纬度
// 以下为特有属性，不会被优先级覆盖
"DefaultUsername": "", // 默认用户
}{
// 以下为特有属性，不会被优先级覆盖
"Username": "", // 学号或手机号
"Password": "", // 密码
"Fid": "", // 学校代号，fid 为 null 时使用手机号登录
"WebApi": false, // 是否启动 Web Api，可以指定监听规则，详见「WebApi 说明」
"Courses": {}, // 课程配置
}课程信息由程序获取的，不建议修改，但可以为课程配置不一样的签到设置。
可用 init 初始化或 update 更新课程信息
{
"ClassId": { // 属性名为会话 Id，不建议修改
"CourseId": "", // 课程 Id，不建议修改
"ClassId": "", // 班级 Id，不建议修改
"ChatId": "", // 会话 Id，不建议修改
"CourseName": "", // 课程名，不建议修改
"ClassName": "", // 班级名，不建议修改
// 可在此配置签到设置
// 例如：
"SignEnable": true, // 默认是不会自动签到的！！！
}
}true或""等无效路径：一张黑图"."：随机使用Images文件夹下的一张图片["1.png", "2.jpg"]数组：随机使用数组中的一张图片- 可使用绝对路径和相对路径，相对路径是相对于
Images文件夹 - 可指定文件夹，将随机使用文件夹下的一张图片，会 遍历 子文件夹
例如：
"机房/"：随机使用Images/机房文件夹下的一张图片["", "机房/", "电脑/", "老师.jpg"]：将从黑图片、Images/机房文件夹、Images/电脑文件夹和Images/老师.jpg图片中随机使用一张图片
将值改为对象，可以指定星期和时间
键名以 | 为分界线，左为星期（1 - 7），右为时间。值仍然按照上面规则。
特殊时间：m 早上，a 下午，e 晚上。
优先级，从上到下，例如：
{
// 周一或周二，08:00-11:40
"1,2|08:00-11:40": "机房1.jpg",
// 周一或，14:30-18:00或19:00-21:35
"1,5-7|14:30-18:00,19:00-21:35": "机房2.jpg",
// 周三，上午或下午，即全天
"3|am,pm": "机房3.jpg",
// 忽略时间，即周四，全天
"4|": "机房4.jpg",
// 忽略星期，即每天下午
"|pm": "机房5.jpg",
// 其他时间段
"": ["自习室1.jpg", "自习室2.jpg"],
}该功能是用来测试的，并不会真的签到，但会推送消息。
Usage: dotnet ./cx-auto-sign.dll test
Options:
-h|--help Show help information
-u 指定用户名（学号）
-i 配置中的 ChatId
-t 签到类型，0 普通签到，1 拍照签到，2 二维码签到，3 手势签到，4 位置签到
-d 日期时间，默认当前时间，用于拍照签到
例如
> dotnet ./cx-auto-sign.dll test -u xxx
[09:28:36 INF] [1649467716652.582] 这是一个测试
[09:28:36 INF] [1649467716652.582] 消息时间：1649467716.6727889
[09:28:36 INF] [1649467716652.582] 用户：xxx
[09:28:36 INF] [1649467716652.582] ChatId：null
[09:28:36 WRN] [1649467716652.582] 该课程不在课程列表
[09:28:36 INF] [1649467716652.582] 签到类型：普通签到
[09:28:36 WRN] [1649467716652.582] 由于 Email 为空，没有发送邮件通知
[09:28:36 WRN] [1649467716652.582] 由于 ServerChanKey 为空，没有发送 ServerChan 通知
[09:28:36 WRN] [1649467716652.582] 由于 PushPlusToken 为空，没有发送 PushPlus 通知
[09:28:36 INF] 签到信息
地址：中国
经纬度：-1, -1
IP：1.1.1.1
详细
WebApi 默认监听规则是 http://localhost:5743，可在配置文件中修改。
若要监听全部网卡的 5743 端口，可写为：http://*:5743。
请求：GET /status
响应：
{
"username":"0000000000", // 学号或手机号
"cxAutoSignEnabled":true // 是否启动自动签到，默认为 true
}请求：GET /status/enable
响应：
{
"code": 0,
"msg":"success"
}请求：GET /status/disable
响应：
{
"code": 0,
"msg":"success"
}在 cx-auto-sign.dll 所在目录下创建一个名为 .noupdate 的文件。
- Clansty/superstar-checkin 调用环信 SDK
- cxOrz/chaoxing-sign-cli CLI
一切开发旨在学习，请勿用于非法用途。