swu-checkin-cli

CHECKIN.
SIMPLIFIED.

西南大学自动打卡,
从命令行开始。

一个面向西南大学签到流程的命令行项目。支持多账号管理、交互式数字菜单、Docker 部署、定时运行和结果推送;无需 Web 管理面板,也能清楚掌握每次执行的结果。

开始了解
01多账号配置02数字菜单03定时运行04结果推送

把签到流程放进
可管理的日常工具里。

项目将账号管理、登录、执行、重试与结果通知串成一条命令行流程。以下能力均来自项目仓库的公开说明。

01 / ACCOUNTS

管理多个账号

支持通过 users.json、环境变量或命令行临时账号提供凭据,适合个人和少量账号集中管理。

02 / MENU

不用手改配置

输入 python check_in.py -m,通过数字菜单查看配置、增删账号、设置推送和立即运行。

03 / LOGIN

浏览器登录链路

默认使用 Playwright 浏览器登录当前学校统一认证页面,并提供 Token 缓存与强制重新登录选项。

04 / SCHEDULE

适配定时任务

可由宿主机 cron 或仓库提供的 GitHub Actions workflow 定时调用;内置运行锁避免重叠触发。

05 / CONTAINER

Docker 部署

Docker 默认将配置、Token 缓存与运行锁存放在 /data,便于通过挂载目录保存运行数据。

06 / NOTIFY

多渠道通知

支持钉钉机器人、企业微信群机器人、Bark、Server 酱和 PushDeer;未配置时可在日志中查看结果。

三步启动。

以下是仓库 README 提供的本地安装路径。Docker Compose 也有独立部署方式。

01

获取项目

克隆公开仓库,进入 swu-checkin-cli 目录。

02

安装依赖

安装 Python 依赖,再安装 Playwright 的 Chromium 浏览器内核。

03

打开菜单

运行数字菜单,配置账号与通知,再进行配置检查或手动执行一次。

从安装到运行,
都在终端完成。

复制仓库 README 中的常用命令,根据自己的运行环境配置账号与依赖。

克隆仓库
git clone https://github.com/Cart042/swu-checkin-cli.git
安装 Python 依赖
pip install -r requirements.txt
安装浏览器内核
playwright install chromium
打开数字菜单
python check_in.py -m
检查配置与依赖
python check_in.py --check-config
执行一次签到
python check_in.py
强制重新登录
python check_in.py --force-login

适合终端,
也适合自动化。

选择能稳定访问学校官网的运行环境。项目支持直接运行、Docker Compose,以及仓库内置的 GitHub Actions workflow。

01 / LOCAL

Python 直接运行

在装好依赖的环境中配置账号,使用菜单管理设置,按需手动执行或交给系统定时任务。

阅读快速开始 ↗
02 / VPS

Docker Compose

构建镜像后运行一次性容器。将宿主机目录挂载到 /data,以保存配置与 Token 缓存。

阅读 Docker 部署 ↗
03 / WORKFLOW

GitHub Actions

仓库提供手动和定时触发的 workflow。账号信息需放入 Repository secrets。

阅读工作流说明 ↗

实际结果取决于登录环境。

项目 README 说明,学校官网的网络出口、登录页策略或临时维护会影响执行。遇到加载超时或接口异常,可先手动重跑,再检查网络与登录调试信息。

请妥善保管账号配置。

  • 不要将真实的 users.json、.env 或 Token 缓存提交到仓库。
  • 在 GitHub Actions 中使用 Repository secrets 存储账号密码。
  • 项目基于 ptbb2005/swu-checkin 的核心打卡逻辑,并以 MIT 许可证发布。