Plastic-Metal / PAFCA

自动申请出校

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

PAFCA:门禁申请代理

基于Github Action的每日自动门禁申请,开箱即用。并提供邮件/微信提醒功能

感谢 @billchenchina 提供的统一身份认证插件hitutil原始版本

手动申请出校入口

使用方法

  • fork仓库
  • 设置仓库的action secret,添加用户名hit_username、密码hit_password和可选的通知用Secrets
  • 开启Action(详细步骤见后文)
  • 每天早上8:00(UTC 00:00)可自动定时运行。申请第二天的门禁。你可以根据后文内容,设置邮件或微信提醒

设置仓库的Secrets:

Name Value
HIT_USERNAME 统一身份认证账号 (学号)
HIT_PASSWORD 统一身份认证密码
API_KEY 可选。server酱推送的sckey, 或发送电子邮件的密码/Key
MAIL_TO 可选。电子邮件信息,格式"服务器[:端口[U]]:用户名(邮箱)"

添加Action Secret的步骤

Fork的仓库会默认关闭action的执行,需要在仓库设置里打开:

启用Action的步骤1 启用Action的步骤2

以上步骤都完工后可以手动运行一次工作流,验证是否可以正常工作

手动运行

上报情况提醒

为了防止脚本突然挂了等情况发生,可设置电子邮件或微信提醒。

电子邮件提醒

  1. 设定Secrets的MAIL_TO字段,格式服务器[:端口[U]]:用户名(邮箱),服务器域名和地址可参考这篇博客。如果不设置端口,则尝试使用默认。如果加'U'则不使用TLS。
  2. 设定Secrets的API_KEY为你的邮箱账户密码,或是SMTP对应的API_KEY。

微信提醒

微信提醒基于Server酱,但是貌似这个服务对免费用户有限额,所以为什么不用电邮提醒呢?

在Server酱中弄到API_KEY后填写到Secrets的API_KEY即可。

如果脚本挂了,或者你想修改一下出校理由什么的

post_data.jsonc里边是申请数据包的原始数据,修改之即可。 reasons.json里边是申请出校理由。

特别注意

本项目仅为方便每日都需要离开校园的同学进行每日出校申请的工具。按照许可协议,开发者不对本工具的使用负责。使用时,请遵守学校的有关规定。

About

自动申请出校

License:GNU Affero General Public License v3.0


Languages

Language:Python 100.0%