KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #developer-tools #claude-code #codex #cli #agent-skills #ai #dsh-plugin #mcp #windows #agent

iclass_buaa

★ 130 Open GitHub ↗

北航上课签到二维码

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 🎓 北航 iClass 签到系统

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

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

PR 链接： https://github.com/zeroduhyy/iclass_buaa/pull/20

特别感谢本次修复的 PR 提交者：[@Yiki21](https://github.com/Yiki21)

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

iclass_buaa

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README