/USTC-ncov-AutoReport

中科大健康打卡平台自动打卡脚本

Primary LanguagePythonMIT LicenseMIT

**滑稽大学(University of Ridiculous of China)健康打卡平台自动打卡脚本

Auto-report action School Language GitHub stars GitHub forks

说明

本打卡脚本仅供学习交流使用，请勿过分依赖。开发者对使用或不使用本脚本造成的问题不负任何责任，不对脚本执行效果做出任何担保，原则上不提供任何形式的技术支持。

更新记录

  • 20200831：增强稳定性
  • 20200827：增加打卡失败重试功能，增加License
  • 20200826：为配合学校最新规定，切换至Github Actions实现一天三次打卡

使用方法

  1. 写在前面：请在自己fork的仓库中修改，并push到自己的仓库，不要直接修改本仓库，也不要将您的修改pull request到本仓库（对本仓库的改进除外）！如果尚不了解github的基本使用方法，请参阅使用议题和拉取请求进行协作/使用复刻和使用议题和拉取请求进行协作/通过拉取请求提议工作更改。

  2. 将本代码仓库fork到自己的github。

  3. 根据自己的实际情况修改data.json的数据，参看下文。这里给出了东、西、南、北、中五个校区正常在校的模板，默认的data.json是西区正常在校。开发者不保证这些模板的正确性。

  4. 将修改好的代码push至master分支。如果不需要修改 data.json，请在 README.md 里添加一个空格并push，否则不会触发之后的步骤。请在自己的仓库中修改，不要pull request到本仓库！

  5. 点击Actions选项卡，点击I understand my workflows, go ahead and enable them.

  6. 点击Settings选项卡，点击左侧Secrets，点击New secret，创建名为STUID，值为自己学号的secret。用同样方法，创建名为PASSWORD，值为自己**滑稽大学统一身份认证密码的secret。这两个值不会被公开。

    secrets

  7. 默认的打卡时间是每天的早上7:30、中午12:30和晚上19:30，可能会有数分钟的浮动。如需选择其它时间，可以修改.github/workflows/report.yml中的cron，详细说明参见安排的事件，请注意这里使用的是国际标准时间UTC，北京时间的数值比它大8个小时。建议修改默认时间，避开打卡高峰期以提高成功率。

  8. 在Actions选项卡可以确认打卡情况。如果打卡失败（可能是临时网络问题等原因），脚本会自动重试，五次尝试后如果依然失败，将返回非零值提示构建失败。

  9. 在Github个人设置页面的Notifications下可以设置Github Actions的通知，建议打开Email通知，并勾选"Send notifications for failed workflows only"。

在本地运行测试

要在本地运行测试，需要安装python 3。我们假设您已经安装了python 3和pip 3，并已将其路径添加到环境变量。

安装依赖

pip install -r requirements.txt

运行打卡程序

python report.py [DATA] [STUID] [PASSWORD]

其中，[DATA]是存放打卡数据的json文件的路径，[STUID]是学号，[PASSWORD]是统一身份认证的密码明文。

data.json 数据获取方法

使用 F12 开发者工具抓包之后得到数据，按照 json 格式写入 data.json 中。

  1. 登录进入 https://weixine.歪比巴卜.edu.cn/2020/，打开开发者工具（Chrome 可以使用 F12 快捷键），选中 Network 窗口：

  1. 点击确认上报，点击抓到的 daliy_report 请求，在 Headers 下面找到 Form Data 这就是每次上报提交的信息参数。

  1. 将找到的 Data 除 _token （每次都会改变，所以不需要复制，脚本中会每次获取新的 token 并添加到要提交的数据中）外都复制下来，存放在 data.json 中，并参考示例文件转换为对应的格式。

  2. 通过push操作触发构建任务，检查上报数据是否正确。

许可

MIT License

Copyright (c) 2020 BwZhang

Copyright (c) 2020 Violin Wang

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.