1. 项目概述

1.1. 简介

  Auto_Attendance实现莞工学工系统勤工俭学岗位自动打卡的功能，适用于各学生助理、助理班主任等勤工俭学职位的日常考勤打卡。用以实现自动考勤，避免忘记打卡和打了卡但忘记签退等因“忘记”而引发的情况。
  由于定时任务太多，Github Actions会创建一个执行队列，因此经常会出现定时任务不在指定时间运行的情况，往往会有几分钟到几十分钟不等的延迟，尤其是在UTC16:00（即北京时间0:00)前后。此外，GitHub Actions本身的保护机制使得单个程序最大运行时间是360分钟。因此，为保证其稳定性，程序定时每天7:30和13:30启动，然后在python程序中设置简单的循环进行监控，在需要签到和签退的时刻运行签到和签退操作。除了可以设置个人的考勤时间外，还能设置是否在休息日（包括法定节假日）是否考勤。

1.2. 功能展示

1.3. 使用技术

• Python3.7
• Github Actions
• 网络爬虫（主要是requests和解析库的使用）
• 配置文件的基本知识

2. 部署

2.1. fork仓库

2.2. 设置Secrets

添加USERNAME

添加PASSWORD

添加成功

2.3. 设置考勤时间

设置考勤时间不需要编辑python代码，仅需要编辑schedule.json文件
  在schedule.json文件中，"0"-"6"表示星期日-星期六（每周的第一天是星期日），其映射的列表表示考勤时间
  考勤时间列表的每一个元素亦是一个列表，代表一次考勤的开始时间和结束时间，下面这个例子能让你更加清楚如何制定自己的考勤时间表

Tips: 不要更改schedule.json的文件结构；时间要严格按照"时:分"的格式，不要精确到秒。否则将造成程序无法正常运行

schedule.json

{
    "0": [

    ],
    "1": [
        ["8:30", "10:10"],
        ["14:30", "17:30"]
    ],
    "2": [
        ["8:30", "12:00"]
    ],
    "3": [
        ["14:30", "17:30"]
    ],
    "4": [
        ["8:30", "10:10"]
    ],
    "5": [
        ["14:30", "17:00"]
    ],
    "6": [
        
    ]
}

上面这段json代码的意思是：

按照自己的需求设置即可，下面我们来对schedule.json进行在线编辑

点击schedule.json

编辑schedule.json

提交修改，成功设置考勤时间

2.4. * 配置config.ini

config.ini一般不需要进行配置。该文件下有两个参数：

• holiday_attendance： bool类型，设置休息日及法定节假日是否考勤，True则考勤，False则不考勤，默认为False
• workAssignmentId： int类型，设置考勤职位的ID，当你有2个职位的时候可能会用到该参数

如果有多个职位，需要指定具体某一个职位；或者想要提高运行效率，可以配置一下workAssignmentId
以下是配置方法。若无需配置，跳到下一节

首先登录学工系统，来到考勤页面，并按F12打开开发者工具

搜索workAssignmentId

双击select标签，找到workAssignmentId

假设网安学院学生工作助理的workAssignmentId=9200。那么，config.ini文件应该这么写

[attendance]
holiday_attendance = False
workAssignmentId = 9200

文件在线配置的方法可参考2.3. 设置考勤时间

2.5. 开启Actions定时任务

点击Actions，启动工作流

启动成功！

2.6. 开启微信消息通知

需要配置Server酱获取对应的key，再将key配置到Secrets，详细配置教程戳这里

注：因为自动考勤不支持多账号，因为在配置key时，只需要设置Secrets的变量名为SERVER_KEY，值为-K <key>即可，例如-K fgasd12

3. 项目结构

Auto_Attendance
│  attendance.py
│  config.ini
│  log.yaml
│  README.md
│  requirements.txt
│  schedule.json
│  special.json
│
└─.github
    └─workflows
            main.yml

• attendance.py: 主程序
• config.ini: 关于休息日是否考勤、考勤职位ID等信息的配置文件
• README.md: 项目说明
• requirements.txt: 运行程序所需的python第三方库及使用版本
• schedule.json: 考勤时间配置文件
• special.json: 考勤特殊情况，用于更改具体某一天的考勤安排
• .github/workflows/main.yml: YAML文件，创建github action的工作流workflows

4. 常见问题

4.1. 设置8:30-12:00考勤，但工作流提前几十分钟就开始启动？

Github Actions经常性不会准时开启定时任务，通常延迟几分钟到几十分钟才运行，因此程序设置了7:30和13:30的定时任务（因为GitHub Actions限制每个程序只能运行6个小时，因此分两次运行），在程序上设置时间监控进行考勤

4.2. 使用这个程序会泄露我的个人账号/密码吗？

账号和密码是使用Github Actions Secrets保存，安全性由Github及其安全算法来保障。不能说万无一失，只能说安全性还是有保障的。如果你有一台一直在运行的电脑，直接本地运行会更具安全性，但相应地也失去便捷性

5. 参考资料

• 莞工自动打卡  Auto_Daily_Attendance-rebuild-

• YAML语言教程

• GitHub Actions 入门教程

• chinesecalendar · PyPI

• dgut-requests · PyPI

6. 更新日志

v2022-2-1

• 修复bug
• 添加Server酱消息通知功能

v2022-1-31

• 重构项目代码(attendance.py)，使用schedule实现定时用以替代简单的sleep阻塞
• 设置虚拟环境为ubuntu-18.04，修正了因openssl版本问题访问不到学校网站的问题