🎓 北航 iClass 签到系统

📢 本次更新说明(2026.06.01) - v1.0.4

• 修复了 Windows 端在 WebVPN 模式下导致 iClass 登录失败的问题（见 PR #20），提高了 VPN 打卡的稳定性与兼容性。
• 登录流程继续读取服务器 Date 响应头以同步签到时间，并改进了针对 VPN 链路的时间修正策略，尽量避免时间戳落到服务端未来时间导致的“参数错误”。
• 直连打卡逻辑保持不变，主要在 VPN 模式下优化时间偏移处理以减少异常失败率。
• 重要提醒：学校服务器目前仍不支持补签打卡，请务必在上课时间内完成打卡。

PR 链接： #20

特别感谢本次修复的 PR 提交者：@Yiki21

支持 校园网直连 / 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