PKU一键出入校备案小工具 v3.0 (2021.3.10)
为作者的第一个 selenium
练手小项目,完善程度较低,欢迎任意类型的使用与开发改进
Note: 本项目的GitHub Actions 自动运行版本,膜 YOUSIKI 大佬
Note: 本项目已上传至北大网盘,与 GitHub 保持同步更新
Note: 已发布 Windows、Linux 和 mac OS 系统对应的 release,同时win版本和mac版本已上传至北大网盘,如果仅需要使用可直接下载相应的 release
Note: 为保证 repo 的轻便,不再于源码部分加入 Linux 版本的 PhantomJS
,若有需要请下载对应的 release,或于官网下载
- 本工具采用 Python3 搭配
selenium
完成自动化操作,实现全自动填报学生出入校备案,为频繁出入校的 PKU 学子(不频繁也行)提供较为便捷的解决方案 - 采用
PhantomJS
无头浏览器作为driver
,相较Chrome
、Firefox
等浏览器更为轻量化,且运行快速 - 支持多个配置文件,可在一个进程内同时进行多人填报
- 支持设置在运行结束后返回历史备案页面截图,无需自行登录查看备案结果
- 支持基于Server酱的备案结果微信推送功能,体验更佳
- 采用定时任务可实现定期(如每日)免打扰填报
- 第三方依赖包几乎只有
selenium
一个,从下到用贼jr快
本项目需要 Python 3,可以从Python 官网下载安装
本项目采用 Python 3.7.4 开发,由于含有 f-string
,请至少使用 Python 3.6 及以上版本,建议使用 Python 3.7 及以上版本
采用如下语句安装 selenium
,支持 2.48.0 及以上版本:
pip3 install selenium
然后就没了。惊不惊喜?意不意外?
-
将
config.sample.ini
文件重命名为config.ini
,请不要新建文件,不然自己搞定编码问题 -
用文本编辑器(建议代码编辑器)打开
config.ini
文件 -
配置
[login]
、[common]
、[out]
、[in]
、[capture]
、[wechat]
这几个 Section 下的变量,在config.ini
文件内有详细注释 -
若需要多人同时填报,可将
config.ini
文件复制若干份,分别重命名为config+序号.ini
例如config1.ini
,config2.ini
...并配置对应变量Note: 序号仅作匹配用,具体数值不重要,但是非法命名格式可能导致检测失败
-
进入项目根目录,以命令
python main.py
运行主程序- 亦可双击
run.bat
运行(仅限 Windows 系统) - 亦可用代码编辑器打开
main.py
并运行(并不推荐)
- 亦可双击
本项目中的 autoRun.bat
文件可提供在静默免打扰情况下运行程序的选择,配合 Windows 任务计划管理可实现定期自动填报,具体请参考Win10下定时启动程序或脚本
进入项目根目录,以命令 ./macAutoRun.sh
执行 macAutoRun.sh
脚本即可,可设定或取消定时运行
使用 Linux 系统的小伙伴们想必有一定的 shell 基础,那大佬们就自行用 crontab
设置吧~
Note: 静默运行的弊端为无法看到任何报错信息,若程序运行有错误,使用者很难得知。故建议采用定时静默运行时,设置微信推送,在移动端即可查看到备案成功信息。或设置备案历史截图功能并定期查看截图(不是很推荐)。
本项目支持基于Server酱的微信推送功能,仅需登录并扫码绑定,之后将获取到的 SCKEY 填入 config.ini
文件即可
Note: 因微信将于4月底下线模板消息功能,届时推送功能也将同步更新为Server酱-Turbo。所以有微信推送需求的小伙伴们可以提前做好准备,并关注本项目的未来版本
- 本项目主要为校内日常出入的同学提供便捷解决方案,会同时填报出校与入校备案,不支持单独填报,也不支持京外返校填报。若有此类特殊需求,烦请手动填报
PhantomJS
作为经典的轻量级无头浏览器,相较Chrome
等大型浏览器体量小的多,不占空间且运行快速。但是由于其本身属性也可能造成一系列问题,如:- 由于仅为练手项目,对于学校土豆服务器造成的各类玄学问题作者只能尽力避免,但并无完善的 Exception 处理机制,若遇到报错欢迎 issue,且万能的重来一次大法可以解决绝大多数问题
- 可能某天
selenium
对PhantomJS
停止了支持,那到了那天再想别的办法
- 当前看来,无论出不出学校都可以填报备案,所以每天定时运行一次并没有什么问题(事实上,作者在测试阶段每天填几十次,希望人没事.jpg)
- 本项目仅供参考学习,造成的一切后果由使用者自行承担
- 本项目敏感性不比 skj,利人利己,私以为还是可以合理扩散一下的,吧?
- 发布于 2020.3.10
- 支持多人同时填报
- 修复 driver 启动时可能出现的问题(感谢 AOZMH 的 contribution)
- 优化运行稳定性
- 发布于 2020.10.19
- 加入微信推送功能(感谢 XiaoTian 的 contribution)
- 支持 Linux 系统
- 修复填报逻辑问题可能引发的错误
- 终极修复【希望吧】可能的会话失效导致填报失败的问题
- 统一代码风格
- 发布于 2020.10.11
- 加入 mac OS 取消定时运行
- 第一个 release 版本
- 发布于 2020.10.10
- 支持 mac OS 设置定时运行,并加入运行前环境检查(感谢 mojave 的 contribution)
- 发布于 2020.10.10
- 修复填报入校备案时可能出现的会话失效导致填报失败的问题
- 发布于 2020.10.5
- 支持 mac OS 系统(感谢 JuiAnHsu 的 contribution)
- 发布于 2020.10.5
- 修复 iaaa 认证时第一次必触发 500 错误的问题(感谢 Rainshaw 的 contribution)
- 发布于 2020.10.4
- 项目初始版本