本仓库内容仅供学习参考，请不要依赖自动签到，确保自己提交的信息真实有效。参与抗疫人人有责！！！！！！！

请注意，学校都是我虚构的，我并不是在 南昌大学 {滑稽}，因为学校标识码它排第一，那我直接用它来举例

Python版本 江西省普通高等学校 校园防疫 健康签到 自动签到程序

去年疫情期间，根据学校的，在 支付宝 -> 江西省终身学习卡 -> 小程序 -> 校园防疫 -> 健康签到 进行签到

结果老是忘记被班主任点名

本身也就是软件专业，直接上手干他！

iPhone使用Thor软件抓包，走一遍流程，发现这个小程序就是个套壳网页。

测试中发现cookie不会过期，登陆都省了，图方便直接使用苹果的快捷指令app做了一个发送签到请求的POST，再配合苹果的自动化，完成每日签到。

到了21年寒假，在家闲的胃疼，再加上由于需要帮妹子们（手动狗头）签到，使用快捷指令因为步骤太多很容易失败，于是便有了做程序脚本的想法。再加上个学期的Java学摸鱼摸的有点多，下学期还要学j2ee，就打算使用Java来制作签到脚本。

但是程序员懂得都懂，Java做脚本。。。。。。蛋疼，虽然没学过python，但是寒假帮闺蜜抢华为手机摸索写了个python脚本，也就啥都不怕了，肝就完事了。

写之前在gayhub随手搜了一下，居然发现已经有一位大佬@PrintNow已经使用PHP制作了一个同款脚本Jiangxi-University-Health-Check-in。所以本python脚本除了使用python来实现以外，还进行了一些功能上的优化，同时，这个脚本给了我很多的思路和帮助，包括但不限于：

• 免登陆进入系统
• URL中那串数字
• 关于street参数的描述（@ChiuJun）
• 这个README文档也是从Jiangxi-University-Health-Check-in扒过来修改的哈哈哈哈哈

很乐意解决你在使用过程中遇到的问题，但我也没系统学过python，只能尽力帮忙，欢迎 issues，尽量把整个程序以及产生的log文件全部上传。

1. 克隆或者下载本项目到本地

2. pip install 以下依赖

   pip install -r requirements.txt

3. 修改 SignConfigTemplate.cfg第4 行签到模式，0表示单人签到 1表示多人签到

4. 如果使用单人签到模式，即上一步signs = 0，则修改 第8 行 的yourID为你的学号。

   否则，如果使用多人签到模式，即第上一步signs = 0，则12 行的 IDs，每个学号之间同英文 , 分隔开，形如以下的模式：

   	IDs = 学号1,学号2,学号3,学号4

   Ps:部分学校可能用一卡通号等代替。可以到 https://fxgl.jx.edu.cn/你的高校代码/ 自己尝试一下，（你的高校代码 详见后文 ** 江西省100所高校代码*）*

5. 修改第16 行 学校代码（详见后文 江西省100所高校代码）

6. 修改第20 行 身份类型（0表示学生 1表示教职工）（暂不支持教职工，部分细节有差异，如果有老师需要可以提交issues我再修改）

7. 修改第23 行 是否为毕业班级（0表示是毕业班的学生 1表示不是毕业班的学生）

8. 修改第30 行 签到模式 （0表示获取前一日的签到定位，1表示使用输入的经纬度）

   因为为了使签到位置产生一点点差异，每次签到都会随机偏移一点。

   如果获取前一日的签到定位进行签到，长时间签到可能会偏差较大，适合多人签到且时间跨度不是不长。每次签到会在上一次签到的基础上随机偏移1.1m以内，理论上连续签到一年会偏移200m左右

   使用输入的经纬度，单人签到推荐，会在你输入的经纬度定位上随机偏移11.1m以内

9. 如果使用输入的经纬度模式，即上一步中的参数 signType = 1,则还需要配置34行和36行的经纬度、38行的地址，建议在* 百度拾取坐标系统*找到自己的位置。经度是较大的那个。

10. 如果需要server酱推送，可在第38-46行了解详情并配置

11. 将BigStudyConfigTemplate.cfg重命名为BigStudyConfig.cfg

12. 部署到虚拟主机或者本机，然后cd到相关文件夹，运行命令 python3 sign.py 即可

    # Ubuntu 安装 python3 方法，其它如 CentOS 可以网上搜
    sudo apt install python3
    sudo apt install python3-pip
    #安装完成后继续配置python
    pip3 install requests

13. 对于liunx系统，建议使用 crontab 定时运行上述命令。Windows可以使用定时任务，macOS也有定时。

    crontab 使用方法可以网上查找资料

1. 克隆/派生本项目到你自己的仓库

2. 克隆你的项目到本地，在本地编辑SignConfigTemplate.cfg，同A方案的3-11步骤，然后提交回去

   或者直接在GitHub上编辑SignConfigTemplate.cfg并保存并重命名为SignConfig.cfg

   

3. 点开你项目的Actions，点击左侧Workflows-All workflows-Auto ZFB XiaoYuanFangYi Sign，点击黄色警示⚠️条右边的Enable workflow

   

4. 至此，GitHub workflow已经成功开启。默认理想情况下将会在每天的凌晨0点半、9点半、18点半进行三次签到。如果想修改定时时间，可以看下一部分。

   测试一下，怎么知道自己的GitHub workflow能不能正常运行呢？

   在成功编辑完sign.py和打开workflow后，每次 提交一次push，就可以手动出发运行workflow。此时打开项目的Action，就会发现出了一个新的workflow正在运行或刚刚运行完毕，点击即可查看详情。

   点击Do sign可以查看运行详情，当然，每次运行，你的仓库log文件夹下也会自动生成了日志文件，可以进行查看。

   如果你配置了SERVER酱，也会将签到日志一起推送。

   

   如果运行失败，你的GitHub绑定的邮箱会收到相关提醒。

   

   以上不仅适用于手动出发的action，每天自动运行的action也是一样的。

   怎么修改GitHub workflow定时运行的时间？

   打开Action，找到一个运行的记录，点击右侧的三个点，再点击View workflow file（推荐）

   或者在项目中打开文件夹.github/workflows/autosign.yml

   

   然后点击右上角的笔进入编辑，在第十二行找到：

       - cron: '30 */9 * * *'

   至于cron的用法，大家具体百度。要注意的是，这里的时间是UTC协调世界时，简单的说，就是要在你理解的北京时间上减去8小事。比如凌晨一点，这里你要输入17点（｜1点-8小时｜），凌晨十二点，这里你要输入16点（｜0点-8小时｜），随后右上角提交即可。

   注意！github action存在一定的延迟，测试发现可能是几分钟，也可能是几十分钟，也可能是一个多小时。所以到了定时时间却没有运行请不必担心，等一天你再看看。

腾讯云云函数是腾讯云为企业和开发者们提供的无服务器执行环境，帮助您在无需购买和管理服务器的情况下运行代码， 是实时文件处理和数据处理等场景下理想的计算平台。您只需使用 SCF 平台支持的语言编写核心代码并设置代码运行的条件，即可在腾讯云基础设施上弹性、安全地运行代码。在方法二失效的情况下，用此方法是最方便最好的解决方案。

1. 下载本项目到本地，解压到某个文件夹，编辑SignConfigTemplate.cfg，同A方案的3-11步骤

2. 注册腾讯云服务，好像可以微信扫码登录免注册

   腾讯云官网，注册登录都在右上角

3. 注册登录后，进入腾讯云云函数 SCF页面，点击 管理控制台 进入控制台页面

   

4. 进入控制台后，点击左侧函数服务，再点击右侧函数服务旁的地区，然后选择一个地区。推荐国内的地区并且离你自己地理位置进的地区。这里以广州示例，然后点击新建。（注：首次使用腾讯云可能会提示你需要实名认证、首次使用云函数可能会显示某功能需要授权。按照腾讯云提示完成即可）

   

5. 点击 从头创建 ，按图所示进行配置。其中红色部分需要特别注意，其他部分均按腾讯云默认即可。

   基础配置

   函数类型选择事件函数

   函数名称自己写一个，比如AutoZFBXiaoYuanFangYiSign

   地域选择上一步你选择的那个地区

   运行环境选择Python3.6

   函数代码

   提交方法选择本地上传文件夹

   执行方法输入sign.cloudFun

   在下面的框内选择上传你第一步编辑好的代码所在的文件夹

   高级配置

   执行超时时间输入一个较大的数，确保能运行完毕。

   单人模式签到一般60秒够了。多人签到的话就 60+20*多人签到人数 也差不多了，注意别超过900秒

   触发器配置

   触发方式为定时触发

   定时任务名称无所谓自定，默认的即可

   出发周期选择自定义触发周期

   Cron表达式和方法B中的差不多，但是不需要考虑时差问题，此处的定时腾讯云是以北京时间为准

   Cron表达式可以百度或者查看腾讯云的文档。通俗解释如下：

   一般是希望程序在每天的固定某个时间运行，表达式为：

   定时秒 定时分 定时小时 * * * *

   例如我要在每天的15:50:30秒运行这个程序，就是：

   30 50 15 * * * *

   正常情况下，大家设置个凌晨12点过点签到或者8点签到就是了：

   1 1 0 * * * *

   0 0 8 * * * *
   

   

   

6. 点击完成，完成创建，云函数部署完毕

   

7. 测试函数是否能正常运行，点击左侧的函数管理，点击函数代码，点击测试。

   

8. 配置正确的话，一般来说运行是成功的。

   

9. 如果配置的定时函数未运行，请在触发管理里检查你的cron表达式。

10. 如果配置的定时函数出错，可以再日志查询里查看历史允许的情况。如果有配置server酱，运行成功在手机上会有提示。

    

11. 阿里云、华为云等云产品的云函数服务按理也是适用的，请自测，可能需要修改文件目录（可读写的临时目录不同）对于学生党来说，腾讯云相对要划算很多，因此产品方面我是首选腾讯云的。

基于对签到数据的改动较以往数据尽量小的原则，作详细说明（感谢原项目 @ChiuJun > issues: street参数确定是可选项吗？ ）
定位部分为三个环境：

1. 支付宝环境
   支付宝环境需要 street 参数，参考支付宝H5开放文档
   street 参数由返回结果的 pois[0].address 与 pois[0].name 拼接而成，最后再拼接成 address.zddlwz

   address.street = result.pois[0].address + result.pois[0].name;
   //...
   var zddlwz =address.province+address.city+address.district+address.street;

   而 Singleton.php 中 $street 为空，并且没有将 $street 拼接至 zddlwz ,所以造成了本签到程序提交的签到记录中缺失具体的街道信息。
   考虑到大部分人的环境都是支付宝，建议将具体的街道信息加入到POST参数中
   修改 Singleton.php 第 92 行为

   "zddlwz" => $province . $city . $district . $street,//自动地理位置：省市县(区)街道 拼接结果

2. 微信环境
   微信环境中同样需要 street 参数，并且不同于支付宝环境，微信环境中 street 参数不包含 streetNumber 信息，拼接地理位置时 zddlwz 同样需要详细到街道号。
   至于 street 参数中具体填什么，建议自行查看微信小程序开发者文档。

   address.street = addComp.street;
   //...
   address.zddlwz = addComp.province+addComp.city+addComp.district+addComp.street+addComp.streetNumber;

3. H5环境
   H5环境 street 参数为可选项，对于H5环境的同学，不需要对 Singleton.php 做额外更改。

   var addressStr = address.province + address.city + address.district;

1. 登录 API

   https://fxgl.jx.edu.cn/学校标识码/public/homeQd?loginName=你的学号&loginType=0

2. 签到 API

   https://fxgl.jx.edu.cn/学校标识码/studentQd/saveStu

3. 签到记录页面

   https://fxgl.jx.edu.cn/学校标识码/public/xslby

4. 是否签到

   https://fxgl.jx.edu.cn/学校标识码/studentQd/studentIsQd

   data为1即为已经签到

5. 签到记录API

   https://fxgl.jx.edu.cn/学校标识码/studentQd/pageStudentQdInfoByXh

6. 百度地图API

   http://api.map.baidu.com/reverse_geocoding/v3/ak=80smLnoLWKC9ZZWNLL6i7boKiQeVNEbq&output=json&coordtype=wgs84ll&location=纬度,经度

   从这个签到系统里提取出的ak，正好省了我们去申请

感谢它们对本项目做出的贡献

• @ChiuJun

• @PrintNow

• 某位一直帮助我的大三学长

系统：macOS 12.2 Beta

python版本：Python 3.10

可能会有，可能不会有

• 加入多人签到的完整支持
• 支持通过server酱进行签到成功/失败通知
• 配合GitHub Action达到利用GitHub来做服务器免费进行签到
• 通过获取上一次的签到记录进行签到，并进行随机偏移
• 支持通过QQ机器人（httpAPI）插件进行签到成功/失败通知
• 腾讯云云函数支持
• 详细的腾讯云云函数使用教程

• 2021.2.16

  初代版本，实现单人签到主要功能

• 2020.2.18

  加入对多人签到的支持，修复部分逻辑，解决大部分警告

• 2020.2.18

  加入对GitHub workflows以达到免自己服务器进行云定时签到的支持

• 2020.2.19

  加入对SERVER酱推送的支持，log更加详细，修复GitHub workflows的一些小bug

• 2022.1.11.1

  修改配置文件的配置方式，来确保输入的时候不会因格式错误导致异常报错来加入对学号中含有字母的支持

  增加更多因配置问题导致出错的提示

• 2022.1.11.2

  增加对腾讯云函数的支持，避免因系统屏蔽国外ip导致的github action自动签到失败，今明两天将更新教程

• 2022.1.12

  增加详细的腾讯云云函数教程，修复几个云函数的错误

1. 本程序为免费开源项目，仅供交流学习，遵循GPL v3开源协议，无任何形式的盈利行为。
2. 本程序服务于原系统，旨在让原系统功能更强大。
3. 本程序皆调用官方接口实现，无任何“Hack”行为，无破坏官方接口行为。
4. 本程序仅做数据处理，不拦截、存储、篡改任何用户数据。
5. 严禁使用本程序进行盈利、散播任何违法信息等行为。
6. 本程序不作任何稳定性的承诺，如因使用本程序导致的问题，均与本软件无关。

‼‼‼ 人工摘抄可能有遗漏的地方，具体请以实际为准

快捷键 CTRL + F 可快速搜索你的学校

数据来源于：http://www.moe.gov.cn/srcsite/A03/moe_634/201706/t20170614_306900.html