https://github.com/zeroduhyy/iclass_buaa
北航上课签到二维码
https://github.com/zeroduhyy/iclass_buaa
automation beihang buaa iclass python script
Last synced: about 2 months ago
JSON representation
北航上课签到二维码
- Host: GitHub
- URL: https://github.com/zeroduhyy/iclass_buaa
- Owner: zeroduhyy
- License: mit
- Created: 2025-03-06T07:20:41.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-04-10T16:54:57.000Z (2 months ago)
- Last Synced: 2026-04-10T18:32:56.616Z (2 months ago)
- Topics: automation, beihang, buaa, iclass, python, script
- Language: TypeScript
- Homepage:
- Size: 270 KB
- Stars: 112
- Watchers: 1
- Forks: 7
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-buaa - Github - zeroduhyy/iclass_buaa
README
# 🎓 北航 iClass 签到系统
## 📢 本次更新说明(2026.04.20) - v1.0.3
- 修复了 Windows 端在 WebVPN 模式下可能因时间戳偏大导致的“参数错误”，现在可正常进行 VPN 打卡。
- 在登录阶段继续读取服务器 `Date` 响应头同步签到时间，并针对 VPN 链路加入了单独的负向时间修正，尽量避免时间戳落到服务端未来时间。
- 直连打卡逻辑保持不变，主要调整的是 Windows 端 VPN 模式下的时间偏移处理。
- 重要提醒：学校服务器目前不再支持补签打卡，请务必在上课时间内完成打卡。
- 由于网络波动，直接打卡或 VPN 打卡仍可能偶发失败，建议确认页面显示成功后再离开。
> **支持 校园网直连 / WebVPN 登录**
>
> ⚠️ **免责声明**
> 本项目为开源代码，使用者需自行选择是否使用，并应遵守北京航空航天大学的相关规定。因使用本项目产生的一切后果均由使用者本人承担。
---
## 🛠️ 部署与打包指南
*注：原先的 Python 版本代码已迁移至 `python` 分支，全新版本请参考当前分支。*
### 1. 一键式部署 (本地运行)
在项目根目录下运行以下脚本命令，会自动安装相关依赖：
**Windows 环境:**
```cmd
./scripts/setup.bat
```
**Linux / Mac 环境:**
```bash
./scripts/setup.sh
```
*运行成功后会自动打开客户端界面，即可访问并使用。*
### 2. 打包生成 Windows 软件 (.exe)
项目目前已配置为仅打包 Windows 版本。如需生成独立的可执行程序，可在项目根目录下运行以下命令：
```bash
npm run build:win
```
*提示：编译打包完成后，生成的免安装绿色版及 `.exe` 安装程序将自动输出在项目根目录的 `dist_exe` 文件夹中。*
### 🎨 附：修改应用图标
如果需要更换打包生成软件的图标，请直接替换/覆盖项目根目录下的对应文件：
- `icon.ico`（替换为你自己的 Windows 图标文件，保持名字不变即可）
---
## ⚠️ 注意事项
- 本项目仅用于个人学习和研究交流，**请勿用于违反学校规定的用途**。
- 系统会话 (Session) 仅在本地存储登录状态，**绝不会**收集或上传个人的账号与密码。
- 若 iClass 系统接口更新，可能需要调整代码后才能继续使用，本项目无法保证长期及时更新。
---
💡 *希望本工具能为你的学习和签到管理带来便利！🚀*
## ✨ 致谢
感谢以下 PR 贡献者对本项目的支持与改进：
- [@Yiki21](https://github.com/Yiki21)
- [@el-ev](https://github.com/el-ev)