Auto-GongXueYun

前言

强烈建议前往Github查看最新代码，Gitee中代码更新不及时点我

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

2、本项目开源&免费，所有开发均仅限于学习交流，禁止用于任何商业用途。

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

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

目录

• 前言
• 使用门槛
• 使用方法
  • Github Actions
  • 百度云函数部署
  • 使用自己的服务器部署
• 启用保持登录
• 启用每日打卡检查
• 启用打卡位置浮动
• 修改自动打卡时间🎯
• 赞助支持
• 常见问题
  • 打卡失败
  • Actions运行错误
  • 增加打卡检查运行次数
  • 上班及下班卡判断逻辑
  • 暂停自动打卡
  • 修改配置文件
  • 周报日报功能
  • 保持最新代码

使用门槛

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

使用方法

Github Actions

推荐指数：⭐⭐⭐⭐⭐

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

缺点：

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

2、Action在某些情况下可能会连接工学云服务器超时造成打卡失败(已加入每日打卡检查，当未打卡时会补签)。

1.点击Star后Fork本仓库🤪

2.准备配置文件🤔

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

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

[
  {
    "enable": true,
    "phone": "17666666666",
    "password": "1111111111",
    "keepLogin": false,
    "token": "如果keepLogin为false就不填",
    "userId": "如果keepLogin为false就不填",
    "planId": "如果keepLogin为false就不填",
    "randomLocation": true,
    "user-agent": "null",
    "signCheck": false,
    "country": "中国",
    "province": "河南省",
    "city": "洛阳市",
    "area": "新安县",
    "desc": "打卡备注",
    "type": "android",
    "address": "你的详细地址",
    "longitude": "101.987848",
    "latitude": "33.100038",
    "pushKey": "dhsajifysfsafsdfdsxxxxxx"
  }
]

其配置含义如下：

3.配置Secret

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

Name填USERS

Secret填改好的配置文件

4.运行测试

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

百度云函数部署

以下教程来自：@96368a

目前仅测试了百度云函数，其他云厂商请自行测试

tips: 腾讯云、阿里云函数不用试了，IP全黑

首先下载项目

创建一个user.json配置文件在项目目录，并填写配置文件

登录百度云后台创建云函数，模块选空白

运行时选择python3.6

配置定时触发器，表达式参考这里

函数基本信息里可以添加多个触发器，上班下班需要分别配置

进入代码编辑，选择上传函数zip包，然后把代码打包上传即可

使用自己的服务器部署

推荐指数：⭐⭐

优点：运行稳定、准时。

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

目前已知腾讯云、阿里云以及部分百度云的服务器、云函数IP被工学云拉黑，如果你使用以上云服务商产品不用再费时间了，华为云目前可用。

具体教程：

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

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

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

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

5、运行python main.py测试

启用保持登录

启用保持登录指的是打卡程序在启用保持登录开启后不再使用账号密码登录打卡，而是使用Token方式。

启用保持登录需要会抓包，而且要抓https的包，如果你手机没Root就别想了

1、下载小黄鸟，抓包软件选择工学云

2、打开工学云

3、在抓包软件里找到https://api.moguding.net/attendence/clock/v1/listSynchro 这个请求

4、找到Token以及userId、planId

启用每日打卡检查

因为Github Action某些情况下可能会无法连接工学云服务器造成打卡+推送失败问题，为此推出每日打卡检查，启用后，每日11点（有1次检查）以及23点（也有1次检查）将会对今日打卡情况进行分析，如存在漏签则自动补签。

如需开启，请在配置文件中的signCheck设置为true

启用打卡位置浮动

启用打卡位置浮动后，每次打卡系统会在原有经纬度中删掉最后一位数字，并随机加入一位数字，使每次打卡经纬度不同。

修改自动打卡时间🎯

修改自动打卡时间需要了解Cron表达式的使用，且需注意不要将打卡时间设置为11点以及23点，此时间段中会运行每日打卡检查，自动打卡在此时间段内不生效。😴

修改打卡时间不要开浏览器翻译！

2.编辑表达式

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

分钟 小时 日 月份 星期

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

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

- cron: "00 02 * * *"

周一到周五晚上九点打下班卡：

- cron: "00 13 * * 1-5"

赞助支持

如果此仓库帮助了你学到了新知识，你可以帮我买杯可乐。

常见问题

打卡失败

如果遇到action运行失败或者打卡失败，99%都是Github无法连接工学云服务器(错误信息中含有Network字样)，属于玄学问题，猜测是服务器IP被拉黑，这点没很好的处理办法，只能重试，如打卡十分重要可适当增加每日打卡检查次数。

Actions运行错误

脚本已经对除了解析配置文件失败外所有的异常进行捕获，如果你运行后图标是一个×，99%都是解析配置文件错误，这种情况下Start Sign里面会显示有此关键字：

json.decoder.JSONDecodeError: Expecting value:xxxxxxxxxxxxxxxxxxx

它代表无法解析配置文件，请仔细检查你的配置文件格式！（大部分人都是拿中文的逗号，当英文的逗号,用！这两个是不一样的，配置文件内除了双引号中的字符可以是中文外其他都是英文！）

增加打卡检查运行次数

从1.0版本开始，每日打卡检查从每日运行4次调整为每日2次并默认关闭，具体原因请查看更新日志，如需要调整每日打卡检查运行次数，可先学习修改自动打卡这一小节的基础知识后再来。 默认情况下的sign.yml时间配置如下：

- cron: "00 23 * * *" # 上班卡
- cron: "15 03 * * *" # 每日签到检查，如不需要可删除这行，其含义为每日11点15运行（存在延时）
- cron: "00 10 * * *" # 下班卡
- cron: "15 15 * * *" # 每日签到检查，如不需要可删除这行，其含义为每日23点15运行（存在延时）

打卡检查仅限在每日11点以及23点运行，其他时间运行会造成多打卡情况出现，所以如果你需要增加自动打卡的次数就复制第二行或第四行，然后修改具体的时间即可，但请注意分钟必须限制在0-25之间（因action运行20分钟左右的延时，防止action启动后已过11/23点），例如说我想要增加两次打卡检查，则可这样写：

- cron: "00 23 * * *" # 上班卡
- cron: "15 03 * * *" # 每日签到检查，如不需要可删除这行，其含义为每日11点15运行（存在延时）
- cron: "05 03 * * *" # 每日签到检查，如不需要可删除这行，其含义为每日11点5运行（存在延时）
- cron: "00 10 * * *" # 下班卡
- cron: "15 15 * * *" # 每日签到检查，如不需要可删除这行，其含义为每日23点15运行（存在延时）
- cron: "05 15 * * *" # 每日签到检查，如不需要可删除这行，其含义为每日23点5运行（存在延时）

上班及下班卡判断逻辑

每日12点以前运行全部为上班，12点及以后默认为下班卡。

暂停自动打卡

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

修改配置文件

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

周报日报功能

周报日报打卡图片功能已做，但不会上线，原因点我，所以不要在加我说多少多少钱收算法。

保持最新代码

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

手动同步代码方法：

公众号：

开发&维护不易，如果此仓库对你的学习有帮助，你可以给我买瓶可乐来支持我维护下去（点我支持），Thanks.

😀😀😀😀😀