经过了漫长的近三年的疫情时期,疫情政策终于变开放了起来,所以健康打卡也停止了,因此本项目的使命已经完成
让我们迎接没有疫情,没有核酸检测,没有健康打卡的这一天吧~(终于熬到头了,小声逼逼~)
本项目是 CQUPT 企业微信学生健康打卡 的一个自动化打卡脚本,可以一定程度上节约身体健康的同学申报的时间。
打卡逻辑主要是通过自动登录获取教务在线的cookie,然后进行企业微信的授权进行打卡。
登录验证码的识别主要使用 pytorch 设计了一个 3层-CNN 卷积神经网络 来预测验证码,
数据集通过模拟教务在线的验证码来自动生成,识别率可以达到 90%。
- 本脚本仅供 学习交流 使用,请勿过分依赖,请时刻注意 自身健康状况,如有特殊情况,请立即停止该脚本并申报实际情况!
- 本脚本仅供 身体健康状况良好 的学生使用,如果身体有不适,请立即报告给辅导员
- 若使用本脚本导致的一切后果,如 隐瞒自身健康状况,误报 等,本项目概不负责。
- 请勿将本仓库的任何内容用于商业或非法目的,否则后果自负。
- 需要有一台自己的服务器,最好是 linux
- 需要会部署 docker
-
随机打卡位置
根据所填经纬度增加干扰量
-
随机打卡时间
可以设置一个固定的时间,打卡的时间会在这个时间点进行抖动
-
打卡邮件提醒
为防止本项目出现意料之外的 bug,每天打卡成功或失败后,会发送邮件通知当天的打卡情况
所以当通知打卡失败后,请进行手动打卡!!!
-
智能检测居住地疫情风险情况
是不是每天打卡这个事情已经够麻烦了,还要查看近期的疫情情况?
本项目切身体会到了这种感受,根据用户所填详细居住地址,
自动检测用户居住地的新冠肺炎疫情风险等级,新增新冠病毒感染人员情况
开发出 自动填充 关于 疫情相关 的打卡信息的功能
-
验证码识别
采用 深度学习 技术,训练出了验证码识别模型,识别度高达 90%
-
自动检验是否开启验证码
因为教务在线有时候开验证码,有时候不开,所以加了这个功能
本项目的邮箱通知功能需要配置 邮件服务 的 SMTP 授权码
具体以 QQ邮箱 为例:
注:如果自动填充模块遇到错误,会填写用户发送请求的打卡信息或 info.json
的信息
本项目的自动填充功能需要申请 百度地图 的 API Key
申请流程如下:
-
登录 百度地图开放平台
-
点击 控制台
-
点击 成为开发者
-
填写所需信息
开发者信息中的产品用途随便写个100字即可, 不用等待审核会直接通过
-
申请 API Key
依次点击
应用管理
->我的应用
->创建应用
-
填写应用信息
-
复制 AK
进入
我的应用
,点击复制按钮即可
本项目通过 docker 进行部署,有两种形式,分别为 服务端 形式和 服务端 客户端 形式,对外暴露端口默认为 :8089
服务端提供两个接口,分别是 打卡接口 和 验证码识别接口。
使用这种形式部署需要每天 手动 向 打卡接口 发送携带用户信息和打卡信息的请求(当然也可以自己写个发送请求的 CRON),然后服务端会自动调用 验证码识别接口 来登录,并进行自动打卡。
执行以下命令:
docker pull stellarisw/cqupt-clock
docker run -it \
--name cqupt-clock \
-d \
--restart=always \
-p 8089:8089 \
-e CLOCK_PORT=8089 \
-e EMAIL_ACCOUNT="" \
-e EMAIL_PASSWORD="" \
-e SMTP_SERVER="" \
stellarisw/cqupt-clock
环境变量说明:
- CLOCK_PORT:服务端暴露的端口,更改的话需要与上面的 -p 参数进行同步
- EMAIL_ACCOUNT:邮箱账号 (可选)
- EMAIL_PASSWORD:邮箱授权码 (可选)
- SMTP_SERVER:邮箱服务器 (可选, 默认为 QQ邮箱)
执行以下命令
git clone https://github.com/gocybee/cqupt-clock.git
docker build -t cqupt-clock ./cqupt-clock
docker run -it \
--name cqupt-clock \
-d \
--restart=always \
-p 8089:8089 \
-e CLOCK_PORT=8089 \
-e EMAIL_ACCOUNT="" \
-e EMAIL_PASSWORD="" \
-e SMTP_SERVER="" \
-v $(pwd)/cqupt-clock:/workspace \
cqupt-clock
环境变量说明:
- CLOCK_PORT:服务端暴露的端口,更改的话需要与上面的 -p 参数进行同步
- EMAIL_ACCOUNT:邮箱账号 (可选)
- EMAIL_PASSWORD:邮箱授权码 (可选)
- SMTP_SERVER:邮箱服务器 (可选, 默认为 QQ邮箱)
POST /do
BODY multipart/form-data
参数名 | 参数值样例 | 是否必填 | 描述 |
---|---|---|---|
name | xxx | 是 | 姓名 |
stu_id | 202121xxxx | 是 | 学号 |
username | 16xxxxx | 是 | 统一认证码 |
password | xxx | 是 | 密码 |
is_today | true | 是 | 是否给今天打卡,选项:"True","False" |
clock_time | 2022-09-04 17:50:36 | 否 | 给指定日期打卡,格式:"%Y-%m-%d %H:%M:%S"(只有当"is_today"选项为"false"时该选项才填写) |
is_force | false | 是 | 是否强制打卡(会覆盖之前的打卡记录), 选项:"True","False" |
latitude | 29.536702 | 是/自动填充 | 纬度 |
longitude | 106.611035 | 是/自动填充 | 经度 |
district | 重庆市,重庆市,南岸区 | 是 | 地区(根据企业微信里面的表单填写对应的地区) |
location | 重庆邮电大学 xx苑x舍xxx号 | 是 | 具体地点 (这里一定要具体到楼栋,否则无法判断该楼栋是否是中高风险区 |
risk_level | 低风险 | 是/自动填充 | 目前居住地新冠肺炎疫情风险等级, 选项:"低风险","中风险","高风险","其他" |
risk_history | 无 | 是 | 7天内是否有中高风险地区旅居史, 选项:"无","有" |
contact_history | 无 | 是 | 7天内否是接触中高风险地区旅居史人员, 选项:"无","有" |
prefecture_history | 否 | 是/自动填充 | 7天内所在地级市是否有本土疫情发生, 选项:"否","是" |
is_risk | 否 | 是/自动填充 | 目前居住地是否为风险区或临时管控区域, 选项:"否","是" |
is_normal_temp | 是 | 是 | 今日体温是否正常, 选项:"是","否" |
has_symptom | 否 | 是 | 今日是否有与新冠病毒感染有关的症状, 选项:"否","是" |
roommates | 无 | 是 | 同住人员信息, 选项: "是","无","无同住人员" |
code_color | 绿色 | 是 | 渝康码颜色, 选项:"绿色","黄色","红色","其他" |
RESPONSE
字段名 | 字段值样例 | 描述 |
---|---|---|
code | 200 | 状态码 |
msg | 打卡成功 | 消息 |
ok | true | 请求是否成功 |
GET /captcha?timestamp=&session_id=&route=
Query
参数名 | 参数值样例 | 描述 |
---|---|---|
timestamp | 1660383478 | 教务在线 captcha 请求地址中的 timestamp 参数 |
session_id | 4EF0AD5BD16FB3ED25VB34A420B510AD | cookie 中的 JSESSIONID |
route | 8e57f1d63642a2d968c01cdaeb9aab9b | cookie 中的 route |
RESPONSE
字段名 | 字段值样例 | 描述 |
---|---|---|
code | 200 | 状态码 |
msg | 获取验证码成功 | 消息 |
ok | true | 请求是否成功 |
data | s2de | 验证码 |
如果需要更改打卡配置,则需要执行命令
docker stop cqupt-clock
docker rm cqupt-clock
docker run -it \
...
在第三个命令中,更改相应的配置即可
使用这种形式部署,可以实现全自动化打卡 (每天根据设定的时间点打卡),需要配置用户信息和打卡信息配置文件,在项目cron/info.json
目录下,形式为 json,根据打卡接口文档
配置相应的参数值即可,同时还需要配置打卡的时间点和打卡时间抖动范围
{
"name": "",
"stu_id": "",
"username": "",
"password": "",
"is_today": "",
"clock_time": "",
"is_force": "",
"latitude": "",
"longitude": "",
"district": "",
"location": "",
"risk_level": "",
"risk_history": "",
"contact_history": "",
"prefecture_history": "",
"is_risk": "",
"is_normal_temp": "",
"has_symptom": "",
"roommates": "",
"code_color": ""
}
执行以下命令:
docker pull stellarisw/cqupt-clock
docker run -it \
--name cqupt-clock \
-d \
--restart=always \
-e ENABLE_CRON="true" \
-e CRON_HOUR=12 \
-e CRON_JITTER=3600 \
-e EMAIL_ACCOUNT="" \
-e EMAIL_PASSWORD="" \
-e SMTP_SERVER="" \
-e BAIDU_MAP_API_KEY="" \
-v $(pwd)/cqupt-clock/cron/info.json:/workspace/cron/info.json \
stellarisw/cqupt-clock
环境变量说明:
- ENABLE_CRON:开启客户端
- CRON_HOUR:设置打卡时间点 (参数范围: 0-23, 默认为12)
- CRON_JITTER:设置打卡时间抖动范围 (参数单位: 秒, 默认为3600)
- EMAIL_ACCOUNT:邮箱账号 (可选)
- EMAIL_PASSWORD:邮箱授权码 (可选)
- SMTP_SERVER:邮箱服务器 (可选, 默认为 QQ邮箱)
- BAIDU_MAP_API_KEY:百度地图 AK 码(可选,填写此项默认开启自动填充功能,不填则不开启)
- -v .../info.sjon:/workspace/cron/info.json:填写 info.json 文件位置,只需更改":"左边的参数即可
执行以下命令:
git clone https://github.com/gocybee/cqupt-clock.git
docker build -t cqupt-clock ./cqupt-clock
docker run -it \
--name cqupt-clock \
-d \
--restart=always \
-e ENABLE_CRON="true" \
-e CRON_HOUR=12 \
-e CRON_JITTER=3600 \
-e EMAIL_ACCOUNT="" \
-e EMAIL_PASSWORD="" \
-e SMTP_SERVER="" \
-e BAIDU_MAP_API_KEY="" \
-v $(pwd)/cqupt-clock:/workspace \
cqupt-clock
环境变量说明:
- ENABLE_CRON:开启客户端
- CRON_HOUR:设置打卡时间点 (参数范围: 0-23, 默认为12)
- CRON_JITTER:设置打卡时间抖动范围 (参数单位: 秒, 默认为3600)
- EMAIL_ACCOUNT:邮箱账号 (可选)
- EMAIL_PASSWORD:邮箱授权码 (可选)
- SMTP_SERVER:邮箱服务器 (可选, 默认为 QQ邮箱)
- BAIDU_MAP_API_KEY:百度地图 AK 码(可选,填写此项默认开启自动填充功能,不填则不开启)
如果需要更改打卡信息,直接修改 info.json
文件即可
如果需要更改打卡配置,则需要执行命令
docker stop cqupt-clock
docker rm cqupt-clock
docker run -it \
...
在第三个命令中,更改相应的配置即可
如果打卡过程中有什么不懂的地方,或者出了什么bug,欢迎提 issue
最后如果觉得这个项目用起来好的话,star 支持一下
- 自动填写表单-7天内所在地级市是否有本土疫情发生
- 自动填写表单-目前居住地是否为风险区或临时管控区域
- 自动填写表单-渝康码颜色