🎓 北航 iClass 签到系统

📢 本次更新说明(2026.04.20) - v1.0.3

• 修复了 Windows 端在 WebVPN 模式下可能因时间戳偏大导致的“参数错误”，现在可正常进行 VPN 打卡。
• 在登录阶段继续读取服务器 Date 响应头同步签到时间，并针对 VPN 链路加入了单独的负向时间修正，尽量避免时间戳落到服务端未来时间。
• 直连打卡逻辑保持不变，主要调整的是 Windows 端 VPN 模式下的时间偏移处理。
• 重要提醒：学校服务器目前不再支持补签打卡，请务必在上课时间内完成打卡。
• 由于网络波动，直接打卡或 VPN 打卡仍可能偶发失败，建议确认页面显示成功后再离开。

支持 校园网直连 / WebVPN 登录

⚠️ 免责声明 本项目为开源代码，使用者需自行选择是否使用，并应遵守北京航空航天大学的相关规定。因使用本项目产生的一切后果均由使用者本人承担。

---

🛠️ 部署与打包指南

注：原先的 Python 版本代码已迁移至 python 分支，全新版本请参考当前分支。

1. 一键式部署 (本地运行)

在项目根目录下运行以下脚本命令，会自动安装相关依赖：

Windows 环境:

./scripts/setup.bat

Linux / Mac 环境:

./scripts/setup.sh

运行成功后会自动打开客户端界面，即可访问并使用。

2. 打包生成 Windows 软件 (.exe)

项目目前已配置为仅打包 Windows 版本。如需生成独立的可执行程序，可在项目根目录下运行以下命令：

npm run build:win

提示：编译打包完成后，生成的免安装绿色版及 .exe 安装程序将自动输出在项目根目录的 dist_exe 文件夹中。

🎨 附：修改应用图标

如果需要更换打包生成软件的图标，请直接替换/覆盖项目根目录下的对应文件：

• icon.ico（替换为你自己的 Windows 图标文件，保持名字不变即可）

---

⚠️ 注意事项

• 本项目仅用于个人学习和研究交流，请勿用于违反学校规定的用途。
• 系统会话 (Session) 仅在本地存储登录状态，绝不会收集或上传个人的账号与密码。
• 若 iClass 系统接口更新，可能需要调整代码后才能继续使用，本项目无法保证长期及时更新。

---

💡 希望本工具能为你的学习和签到管理带来便利！🚀

✨ 致谢

感谢以下 PR 贡献者对本项目的支持与改进：

• @Yiki21
• @el-ev