stuhealth

使用 Python 编写的每日健康打卡命令行工具。

2021 年 9 月 14 日起，打卡系统增加了滑动验证码，并且在服务端实装了二次验证，因此：

基于抓包和 JavaScript 逆向的打卡机（包括这个 repo 在内）都已经失效了。

基于 Selenium、Puppeteer、Playwright 等浏览器自动控制工具的打卡机，需要自行实现模拟拖动滑块的操作来突破滑动验证码。已实现！

2022 年 9 月 18 日起，打卡系统强制要求使用微信扫码登录才能访问。~~遗憾的是，扫码登录的过程目前还可以绕过。~~

2022 年 10 月 1 日起，扫码登录的绕过问题被修复了 ( ﾟ∀。) 拿手机扫🐴这种事情应该就没有办法自动化了啊 ( ^ω^) 这里的代码和说明文本将作为存档，不再更新。

如果有人仍然要求你进行充满形式主义的打卡，我的建议是不打。

快速上手

# 首次使用需要安装依赖
$ pip3 install -r requirements.txt

# 输入学号和密码进行打卡
$ python3 stuhealth.py -u 2017233333 -p p@SsW0Rd -ve https://example.com/ -vt Ap1t0K3N

推荐使用云服务器，设置 Crontab（Linux）或计划任务（Windows）实现自动化的每日打卡工作。

59 13 * * * python3 /path/to/stuhealth.py -u 2017233333 -p p@SsW0Rd -ve https://example.com/ -vt Ap1t0K3N

对于未安装 Python 的 Windows 用户，可以在这里直接下载使用 PyInstaller 打包的可执行文件。

因为是命令行工具，所以需要在终端中运行（提示：在空白处按住 Shift 点击右键，选择“在此处打开 Powershell 窗口”可以打开终端），而不是直接双击。
PS C:\path\to> .\stuhealth -u 2017233333 -p p@SsW0Rd -ve https://example.com/ -vt Ap1t0K3N

如果没有云服务器，也可以使用 GitHub Actions 实现自动打卡。（后述）

参数说明

参数	简写	说明
`--username`	`-u`	用户名。
`--password`	`-p`	密码。
`--validator-endpoint`	`-ve`	滑动验证码 API 地址。
`--validator-token`	`-vt`	滑动验证码 API 的鉴权 token。
`--log`	`-l`	将日志输出到指定的文件。
`--dry-run`	`-dr`	试运行模式，输出将要提交的打卡数据，但并不会真的提交。
`--help`	`-h`	显示参数说明。

如果打卡成功或今日已打卡，则进程返回的状态码为 0，出现错误则为非 0。

滑动验证码的自动完成通过另一个 API 服务实现，可以使用以下项目之一部署的实例：

原版使用 Python、Selenium 和 GeckoDriver 实现。
Docker 版基于原版代码封装成 Docker 容器。

部署后，在自动打卡时将 API 地址和 token 填入命令行参数中即可。

API 调用规则

POST <validator-endpoint>

通过添加请求头 Authorization: Bearer <validator-token> 完成鉴权。

{
    // 可以用于模拟登录的，完成滑动验证码后得到的token
    "validation_token": "...",
    // 错误信息（如果有的话，此时状态码不是200）
    "error": "..."
}

使用 GitHub Actions 自动打卡

新建一个任意名称的 repository，设为 public 或 private 都可以。然后点击 Actions 选项卡创建一个新任务，输入以下配置：

name: stuhealth-checkin

on:
  workflow_dispatch:
  schedule:
    # * is a special character in YAML so you have to quote this string
    - cron: '0 0 * * *'

jobs:
  stuhealth-checkin:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - name: Clone stuhealth repository
        run: git clone https://github.com/SO-JNU/stuhealth.git
      - name: Setup Python
        uses: actions/setup-python@v2
        with:
          python-version: 3.x
          cache: pip
          cache-dependency-path: requirements.txt
      - name: Install pip dependencies
        working-directory: stuhealth
        run: pip install -U -r requirements.txt
      - name: Run stuhealth
        working-directory: stuhealth
        run: python stuhealth.py -u ${{ secrets.username }} -p ${{ secrets.password }} -ve ${{ secrets.validatorEndpoint }} -vt ${{ secrets.validatorToken }}

根据需要自行修改 cron 表达式来改变执行时间。配置文件中使用的时区为 UTC，所以上面的表达式 0 0 * * * 表示在每天的 UTC 时间 0:00 即北京时间 8:00 执行。可以使用这个在线工具来预览 cron 表达式指定的执行时间。

在 Settings 选项卡中的 Secrets 部分按照命令行参数用途添加 username、password、validatorEndpoint、validatorToken。Secrets 保存后便无法再次查看，可以在 Actions 中使用但是也不会在执行结果中显示。

设置完成后，在指定时间 GitHub Actions 就会自动帮你启动打卡机了。你可以在 Actions 选项卡中查看每次运行的结果。

注意：GitHub Actions 不能保证任务一定可以准时按照 cron 表达式指定的时间运行，实际执行时间可能会有数分钟的延迟，可以参见这里的说明。

批量打卡和邮件提醒

使用下面的 Python 脚本就可以实现批量打卡了，在打卡失败时会通过 SMTP 服务发送邮件来进行提醒。请参考你所使用的邮箱的帮助文档来填写 SMTP 服务器地址和你的用户名及密码（在某些邮箱中又称为“授权码”）。

你也可以将发送邮件替换成其他想要使用的提醒方式。

import email.header
import email.mime.text
import email.utils
import smtplib
import subprocess
import time
import typing

# SMTP登录相关
SMTP_HOST = '...'
SMTP_USER = '...'
SMTP_PASSWORD = '...'

# 滑动验证码API相关
VALIDATOR_ENDPOINT = '...'
VALIDATOR_TOKEN = '...'

if __name__ == '__main__':
    for username, password, mailAddress in (
        (2017233333, 'p@SsW0Rd', 'example@example.com'),
        ...,
    ):
        username: int
        password: str
        mailAddress: typing.Optional[str]
        executeTime = time.strftime("%Y-%m-%d %H:%M:%S", time.localtime())

        p = subprocess.Popen(
            (
                'python3',
                '/path/to/stuhealth.py',
                '-u', str(username),
                '-p', password,
                '-ve', VALIDATOR_ENDPOINT,
                '-vt', VALIDATOR_TOKEN,
            ),
            stdout=subprocess.PIPE,
        )
        p.wait()
        r = p.stdout.read().decode('utf-8')
        print(r)
        if p.returncode and mailAddress:
            message = email.mime.text.MIMEText(
                f'健康打卡失败，以下是打卡工具的输出：<br><pre><code>{r}</code></pre><br>用户名：{username}<br>执行时间：{executeTime}',
                'html',
                'utf-8',
            )
            message['From'] = email.utils.formataddr(('Stuhealth', SMTP_USER))
            message['To'] = mailAddress
            message['Subject'] = email.header.Header('[Stuhealth] 健康打卡失败通知', 'utf-8').encode()

            with smtplib.SMTP_SSL(SMTP_HOST) as smtp:
                smtp.login(SMTP_USER, SMTP_PASSWORD)
                smtp.sendmail(SMTP_USER, (mailAddress,), message.as_string())