ClassGuard 离班助手

面向 ClassIsland 的 Windows 离班提醒插件
_{项目由 AI 辅助设计}

项目简介

ClassGuard 会在下课或放学后等待一段时间，再按当时的实际状态检查 U 盘和仍在运行的软件，提醒教师离开教室前完成必要处理。

检查只会在等待结束后执行。等待期间已经关闭的软件不会产生过期提醒；如果下一节课已经开始、提醒被关闭、提醒模式改变，或刚结束的科目被排除，本次检查会自动取消。

主要功能

• 支持“每节课下课后检查”和“只在放学后检查”两种提醒时机。
• 检查 Windows 识别为可移动磁盘的 U 盘。
• 检查 QQ、微信、企业微信和飞书是否仍在运行。
• 可添加、修改、关闭和删除自定义软件检查项。
• 可按 ClassIsland 档案中的科目排除不需要检查的课程。
• 多个未处理项目会合并到一条 ClassIsland 提醒中。
• 测试提醒会立即检查当前启用的项目，不等待课程延时。

运行要求

项目	要求
ClassIsland	2.1.0.1 及以上版本
操作系统	Windows10 及以上版本

本版本不专门兼容更早的 ClassIsland、预发布版或其他操作系统。

下载与安装

1. 从 GitHub Releases 下载 ClassGuard.cipx。
2. 打开 ClassIsland 的插件设置，选择安装本地插件。
3. 选择下载的 ClassGuard.cipx，安装完成后重启 ClassIsland。
4. 打开“ClassGuard 离班提醒”设置页完成配置。

使用方法

1. 打开“启用离班提醒”。
2. 选择每节课下课后检查，或只在放学后检查。
3. 设置下课后等待多久再开始检查，默认 90 秒。
4. 开启需要检查的 U 盘和软件项目。
5. 如需检查其他软件，添加显示名称和 Windows 进程名称。
6. 在“排除课程”中勾选不需要检查的科目。排除按科目生效。
7. 使用“发送测试提醒”立即检查当前设置和实际系统状态。

提醒的声音、语音和强调效果由 ClassIsland 的提醒设置统一控制。

识别限制

• U 盘检查依赖 Windows 将设备识别为“可移动磁盘”。部分移动硬盘或固态硬盘会被识别为固定磁盘，此时不会触发提醒。
• 软件检查根据正在运行的进程名称判断。程序即使关闭窗口但仍驻留后台，也会被视为仍在运行。
• 自定义软件采用不区分大小写的精确进程名匹配，不能填写程序完整路径。
• 一个自定义项目只对应一个进程名；需要检查多个进程时应分别添加。

源码构建

构建环境需要 .NET 8 SDK。克隆仓库后，在项目根目录运行：

dotnet test .\ClassGuard.Tests\ClassGuard.Tests.csproj --configuration Release
dotnet build .\ClassGuard.csproj --configuration Release

生成的安装包位于 cipx/ClassGuard.cipx。

许可证

本项目采用 GNU General Public License v3.0 或任何后续版本授权。