Skip to content
/ wjc_auto_sign Public

用于安徽师范大学皖江学院（芜湖学院）的每晚自动签到脚本

1 star 0 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

2-civilization/wjc_auto_sign

BranchesTags

Repository files navigation

README

芜湖学院（原 安徽师范大学皖江学院） 签到自动化

目前实现：

  • 使用更好的日志模块loguru
  • 签到端
    • 用于从数据库中提取用户数据并在规定时间内启动签到任务，完成后自动等待至下一次签到开始。
    • 对于签到次数过多的账号，将会自动停用该账号
      • 签到失败天数达到3天
  • 注册信息端
    • 提供Web页面向用户提供注册功能，将用户提交的信息保存至数据库供签到端使用
    • 为用户提供取消签到功能，用户可自行选择是否启用自动签到（是否停用）

待实现：

  • 两端分离，签到端自动同步数据库
  • （Web）简易的管理后台，方便对用户签到信息进行监控以及管理
  • （Web）显示历史更新版本

使用说明

准备环境：

  • Python3.8+

使用pip安装依赖：

pip install -r requirements_web.txt

如果你只用于本地使用且不需要Web页面提供注册功能，可选择手动向signinInfo.db中添加数据。同时选择安装以下依赖即可：

pip install -r requirements.txt

配置（可选）

setting.py文件用于配置脚本运行，提供以下参数供修改：

  • DB_PATH：数据库名。数据库使用Sqlite3，不存在会按此名词自动生成，如无需要不推荐修改
  • DB_TABLE：用于保存用户信息的表名，同样无需要不推荐修改。
  • TIME_SET：邮箱推送设置
    • start：签到任务开始时间
    • end：签到任务结束时间。注意：该时间应该小于实际签到结束时间，让脚本提前结束，避免签到失败的信息无法及时推送，以错过手动签到。
  • TIME_CHCECK_WAIT：由于脚本难以精确地在签到开始时启动，所以会提前启动，并检测签到是否开始，首次检测时间间隔，默认为180秒。该值仅限第一次检测，后会根据响应的结果自动调整。
  • TIME_SLEEP_WAIT：签到完成后等待下一次启动时间，不推荐修改。
  • MAIL_SET：邮箱推送设置
    • admin：一天的签到任务结束后向该邮箱推送今日所有用户的签到情况。
    • account：推送信息将由此邮箱发送。
    • host：邮箱服务器
    • token：邮箱授权码

添加数据

手动添加数据

推荐先启动auto_sign.py来初始化下数据库，然后再向signInfo.db中添加数据

你也可以参照setting.py中的DB_INIT_SQL来手动创建对应的表结构。

使用Web端添加数据

需要Node.js环境，进入web_app目录下执行

npm install
npm run build

待前端文件打包完毕后，回到根目录执行以下指令启动Web端

python web_app.py

访问http://127.0.0.1:8000即可进行注册

开始自动签到

完成上面的准备步骤后，现在可以将auto_sign.py启动，它会自动从数据库中提取用户数据并在规定时间内启动签到任务，完成后自动等待至下一次签到开始。

每次完成签到任务，都会向每个用户发送邮件确认，并额外向管理员发送邮件汇报今日签到任务结果。

开发说明

2024年学校官网及统一认证平台功能逐步上线正常，网页中终于可通过一些手段进入，便于抓包逆向。

签到步骤：

  • 根据设置的账号密码登录获取必要的Token或Cookies
  • (额外)检测是否需要验证，如若需要则启动反验证码模块
  • 携带必要信息查询签到任务
  • 根据设置签到任务
  • (额外)通知设置的账户信息签到状态

模块

登录

API:

  • URL:https://ids.uwh.edu.cn/authserver/login?service=https://ehall.uwh.edu.cn/login
  • METHOD: GET | POST
  • PARAMS: NONE
  • DATA: (FORM)
    • username:账号
    • password:密码（加密）
    • captcha:验证码
    • _eventId:submit
    • cllt:userNameLogin
    • dllt:generalLogin
    • lt: 保持为空
    • execution:来自前置页面

前置页：需要预先GET此页，包含了POST时所需的必要信息（data和cookie）

API:

  • URL:https://ehall.uwh.edu.cn/student/cas
  • METHOD: POST

上一个请求成功后携带Cookie直接访问即可，另有登录界面，需要额外密码（身份证号后六位），不推荐。

获取签到任务

API:

Params:

params_load = {
            "bSortable_0": "false",
            "bSortable_1": "true",
            "iSortingCols": "1",
            "iDisplayStart": "0",
            "iDisplayLength": "12",
            "iSortCol_0": "3",
            "sSortDir_0": "desc",
            "_t_s_": "1711441937310"
        }

其中_t_s_为13位时间戳

Response:

{
    "sEcho": 1,
    "iDisplayStart": 0,
    "iDisplayLength": 12,
    "iSortColList": [2],
    "sSortDirList": ["desc"],
    "iTotalRecords": 1,
    "iTotalDisplayRecords": 1,
    "aaData": [{
        "UPDATE_COUNT": 2,
        "JSSJ": "2024-03-26 23:00:00",
        "QDFS": "1",
        "SJDM": "17112924123429681075",
        "QDCS": null,
        "VALID": "0",
        "DM": "17089192567824456997",
        "JLDM": null,
        "QDWZ_DZ": null,
        "QDLB": "晚间签到",
        "QDSJ": null,
        "UPDATE_IND": "1",
        "FBR": "张铮",
        "SUBJECT": "江北校区晚间签到",
        "KSSJ": "2024-03-26 20:30:00",
        "ISFZR": "0"
    }]
}

成功签到示例：

{
    "code": 1,
    "msg": "成功获取签到任务",
    "info": {
        "sEcho": 1,
        "iDisplayStart": 0,
        "iDisplayLength": 12,
        "iSortColList": [2],
        "sSortDirList": ["desc"],
        "iTotalRecords": 1,
        "iTotalDisplayRecords": 1,
        "aaData": [
            {
                "UPDATE_COUNT": 2,
                "JSSJ": "2024-03-26 23:00:00",
                "QDFS": "1",
                "SJDM": "17112924123429681075",
                "QDCS": 1,
                "VALID": "1",
                "DM": "17089192567824456997",
                "JLDM": "17114572277777336296",
                "QDWZ_DZ": "中国安徽 省芜湖市鸠江区二坝镇通江大道辅路",
                "QDLB": "晚间签到",
                "QDSJ": "2024-03-26 20:47:07",
                "UPDATE_IND": "1",
                "FBR": "张铮",
                "SUBJECT": "江北 校区晚间签到",
                "KSSJ": "2024-03-26 20:30:00",
                "ISFZR": "0"
            }
        ]
    }
}

其中:

  • JSSJ：签到结束时间
  • KSSJ: 签到开始时间
  • SJDM和DM: 后续签到需要用到的信息。
  • QDSJ: 签到时间 时间格式：YYYY-MM-DD H:M:S
    • null 未签到
  • VALID:
    • "0"：未开始
    • "1"：已开始

更新日志

  • 2024-09-01_Ver1.2.2:
    • 现在只会在签到失败后向指定的邮箱发送邮件
    • 现在前端提供取消签到任务的选项
  • 2024-05-26_Ver1.2.1:
    • 修复因登录超时却未能加入失败队列的问题
    • 注册成功邮件恢复正常发送
  • 2024-05-18_Ver1.2.0:
    • 使用React + Anti Design 重构的前端界面，提供更好更合理的注册或更新过程
    • 使用FastAPI重构的后端，更加合理的注册的流程
    • 现在会在确认账号有效且邮箱有效后进行账号注册，避免账号被恶意注册以及密码错误导致无法签到等问题
    • 增加超时机制，避免一个账号失去响应后导致整个签到队列停止
  • 2024-05-15_Ver1.1.2:
    • 修复注册失败
  • 2024-05-15_Ver1.1.1:
    • 部分模块引入loguru日志模块
  • 2024-04-30_Ver1.1.0:
    • 新增连续签到失败自动封禁功能
  • 2024-04-23_Ver1.0.2:
    • Web端时间段检测增加1s延迟以尽可能规避数据库链接抢占。
  • 2024-04-22_Ver1.0.1:
    • Web端增加时间段检测，禁止在签到时间段内进行注册等数据库操作。
  • 2024-04-21_Ver1.0.0:
    • 正式版本

About

用于安徽师范大学皖江学院（芜湖学院）的每晚自动签到脚本

Resources

Readme
Activity

Stars

1 star

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

No packages published

Languages