前言

1、请务必认真阅读此文档后继续！

2、在开始之前请帮我点一下右上角的star。

3、此项目仅限学习交流，禁止用于任何商业或违法用途！

4、此项目仅限学习交流，您必须在Fork或下载此仓库源码后的24小时内删除所有内容。

5、此项目仅限学习交流，学习或使用此项目造成任何损失均由个人承担。

6、如基于或参考此项目进行二次开发，请注明原作者并使用GPL2.0许可证

目录

• 前言
• 使用门槛
• 使用方法
  • Github Actions
  • 使用自己的服务器部署
• 修改自动打卡时间🎯
• 赞助支持
• 常见问题
  • 打卡失败
  • 暂停自动打卡
  • 修改配置文件
  • 保持最新代码

使用门槛

1、帮我点一下右上角的star（星星）

2、仅限个人学习交流使用，禁止任何平台或个人将此项目用于盈利或违法！

使用方法

Github Actions

推荐指数：⭐⭐⭐⭐⭐

优点：适合没有自己服务器的人使用。

缺点： 每日打卡时间无法保证十分准时，拥有10-30分钟的误差。

1.点击Star后Fork本仓库🤪
2.准备配置文件🤔

如果想同时打卡多个用户,请再添加一个数据体就好了(如果还不理解点我)

注意：配置文件模板下方有配置含义，请务必参照配置含义填写

[
  {
    "enable": true,
    "alias": "张三",
    "phone": "18888888888",
    "password": "123456...",
    "deviceType": "Xiaomi|Mi 13|13",
    "deviceId": "设备ID",
    "randomLocation": true,
    "address": "打卡地址",
    "longitude": "位置经度",
    "latitude": "位置纬度",
    "pushKey": "推送Key"
  }
]

其配置含义如下：

3.配置Secret

填写完成后请复制如上配置文件，然后打开仓库的Settings->Secrets->Actions->New repository secret

Name填USERS

Secret填改好的配置文件

4.运行测试

以下部分图片复用了工学云自动打卡，除左上角forked from xxxx外与视频教程无其他区别

至此，自动打卡将会在每天8点左右自动运行打卡。😉

使用自己的服务器部署

推荐指数：⭐⭐⭐⭐⭐

优点：运行稳定、准时。

缺点：有一定的上手成本。

具体教程：

1、下载本仓库源码到你服务器。

2、在服务器中安装好Python环境。

3、运行命令来下载依赖。

pip install requests
pip install pytz
pip install pycryptodome

4、在百度搜索：你的操作系统+ 定时任务，查看如何创建定时任务。

5、创建一个user.json配置文件在项目目录，并将配置文件放入其中

6、运行python Main.py测试

修改自动打卡时间🎯

修改自动打卡时间需要了解Cron表达式的使用。😴 修改打卡时间不要开浏览器翻译！！

2.编辑表达式

GitHub的cron表达式不支持精准到秒，所以从最左边开始，分别为：

分钟 小时 日 月份 星期

而且Github的服务器时间会比我们晚八个小时，所以在你需要打卡的时间-8配置到里面就行了

例如说在上午十点打卡就是:

- cron: "00 02 * * *"

请注意，在修改打卡时间尽量不要设置在运行高峰期，例如说八点整九点整等，运行高峰期会造成任务启动有极高延迟，可设置为7点57分等非整点时间。

赞助支持

如果此仓库帮助了你学到了新知识，你可以帮我买杯可乐，但如果你使用此项目产生任何盈利，请不要支持。

常见问题

打卡失败

如果遇到打卡失败，并且错误信息中含有HTTP、timed out字样的，原因在于连接实习备案服务器超时，目前没有很好的解决办法，经过测试，此错误出现率不高，如果遇到可手动重新运行下Actions。

暂停自动打卡

在Actions-Sign-右边三个点disable workflow

修改配置文件

Settings-Secrets-Actions-下面Repository secrets有个USERS，点击小箭头编辑，里面没内容是正常的，配置文件一旦保存将无法再被看到。

保持最新代码

随着职校家园的更新，自动打卡可能会在某个版本后失效，开发者会及时更新代码，但你Fork的代码并无法保证与主分支（我的代码）实时同步，此时需要手动同步代码，需要注意的是Github不会有任何通知告诉你代码过时或有新版发布，为此，你可以扫描下方二维码关注公众号，当有重要更新或调整时会在公众号发文提醒。

手动同步代码方法：

公众号：

最后，帮我点下仓库的小星星，Thanks.

😀😀😀😀😀