# Auto-ShiXiBeiAn

**Repository Path**: Songaiqi/Auto-ShiXiBeiAn

## Basic Information

- **Project Name**: Auto-ShiXiBeiAn
- **Description**: 🎨实习备案（职校家园）自动打卡，支持多用户、自定义位置与时间、微信消息推送。
- **Primary Language**: Unknown
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 3
- **Created**: 2023-07-30
- **Last Updated**: 2025-08-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">
<h1 align="center">
Auto-ShiXiBeiAn
</h1>
<p align="center">
🥰河南实习备案自动打卡系统🥰
</p>
<p align="center">
支持多用户、自定义位置与时间、微信消息推送
</br>
</p>
</br></div>
</br>



## 前言

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

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

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

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

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

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

</br>

## 目录

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

</br>
</br>

## 使用门槛

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

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



</br></br>

## 使用方法

### Github Actions

推荐指数：⭐⭐⭐⭐⭐


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


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

</br>

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

**注意：配置文件模板下方有配置含义，请务必参照配置含义填写**
```json
[
  {
    "enable": true,
    "alias": "张三",
    "phone": "18888888888",
    "password": "123456...",
    "deviceType": "Xiaomi|Mi 13|13",
    "deviceId": "设备ID",
    "randomLocation": true,
    "address": "打卡地址",
    "longitude": "位置经度",
    "latitude": "位置纬度",
    "pushKey": "推送Key"
  }
]
```

其配置含义如下：

| 参数名称 | 含义                                                         |
| -- | ------------------------------------------------------------ |
| enable | 是否启用该用户的打卡（true或false)                           |
| alias | 别名，用于在打卡日志中标识不同用户，可空。                   |
| phone | 手机号                                                       |
| password | 密码                                                         |
| deviceType | 设备类型,格式:手机品牌英文名称\|手机代号\|安卓系统版本,例如:Xiaomi\|Mi 13\|13 |
| deviceId | 设备ID,36位字母+数字组合,[点我获取随机ID](http://did.sxba.xuanran.cc)          |
| randomLocation   | 打卡位置浮动，启用后每次打卡系统将会在你原有的经纬度的基础之上删掉最后一位数字并随机加入一位数字，使每次打卡经纬度不同      |
| address | 打卡地址,例如中国河南省洛阳市xxxxx                           |
| longitude | 打卡位置经度,通过坐标拾取来完成，[传送门](https://jingweidu.bmcx.com/) |
| latitude | 打卡位置纬度,通过坐标拾取来完成，[传送门](https://jingweidu.bmcx.com/) |
| pushKey | 打卡结果微信推送，微信推送使用的是pushPlus，请到官网绑定微信([传送门](https://www.pushplus.plus/))，然后在发送消息里面把你的token复制出来粘贴到pushKey这项 |





</br>

3.配置Secret

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

Name填USERS

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


</br></br></br>

### 使用自己的服务器部署

推荐指数：⭐⭐⭐⭐⭐

优点：运行稳定、准时。

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

具体教程：

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

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

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

```python
pip install requests
pip install pytz
pip install pycryptodome
```

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

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

6、运行python Main.py测试

</br></br></br>


## 修改自动打卡时间🎯	

修改自动打卡时间需要了解Cron表达式的使用。😴


</br>
1.编辑sign.yml文件，找到图中我圈出的部分


2.编辑表达式

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

分钟 小时 日 月份 星期

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

</br>

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

```yml
- cron: "00 02 * * *"
```

</br>
</br>





## 赞助支持

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

## 常见问题

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

### 暂停自动打卡
在Actions-Sign-右边三个点disable workflow
</br>

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


</br></br>
最后，帮我点下仓库的小星星，Thanks.
有问题可以关注“吾有一站”公众号或我的论坛http://liuxuyang.cn联系我

😀😀😀😀😀