ClassIsland-NotifyPlus

June 12, 2025 · View on GitHub

让ClassIsland实现远程消息推送的扩展插件。

本项目基于ClassIsland开发，感谢原作者的优秀工作！

🌟 主要特性

远程消息推送: 支持从其他设备向Windows电脑发送通知消息
远程截图功能: 支持远程全屏截图和指定窗口截图，带时间水印
WebMessage服务: 提供Web接口，支持HTTP请求发送消息
跨平台支持: 任何支持HTTP的设备都可以发送消息
自定义通知: 支持自定义消息内容、样式和显示时间
原版功能: 保留ClassIsland的所有原有功能

📦 安装说明

从Release页面下载最新版本
解压到任意目录
运行ClassIsland.exe
首次运行时请以管理员身份运行network_fix.bat配置网络权限

🔧 配置说明

网络配置

运行network_fix.bat（需要管理员权限）
确保Windows防火墙允许ClassIsland的网络访问
查看程序显示的本地IP地址，用于远程访问

远程消息发送

网页地址地址：http://<本机IP>:8088 注意：本网站只能在内网访问
ClassIsland 目前支持以下 Web API 请求：

发送自定义消息

端点: http://[IP地址]:8088/api/message 或直接 http://[IP地址]:8088/
方法: POST
内容类型: application/json

请求体格式:

{
  "message": "要显示的消息内容",
  "speech": true,  // 可选，是否语音朗读
  "duration": 10   // 可选，显示时长(秒)
}

响应:

{
  "success": true|false,
  "error": "错误信息"    // 如果出错才会有
}

获取课表信息

端点: http://[IP地址]:8088/api/schedule
方法: GET

响应:

{
  "classes": [
    {
      "startTime": "开始时间 (hh:mm)",
      "endTime": "结束时间 (hh:mm)",
      "subject": "课程名称",
      "isCurrent": true|false  // 是否为当前课程
    },
    // 可能包含下一节课
  ]
}

或者出错时:

{
  "error": "错误信息"
}

远程截图功能
- 端点: http://[IP地址]:8088/api/screenshot
- 方法: GET
- 参数:
  - type: 截图类型，fullscreen（全屏）或 window（窗口）
  - windowHandle: 窗口句柄（仅窗口截图时需要）
- 示例:
  - 全屏截图: http://[IP地址]:8088/api/screenshot?type=fullscreen
  - 窗口截图: http://[IP地址]:8088/api/screenshot?type=window&windowHandle=123456
- 响应: 返回PNG格式的图片文件
- 特性:
  - 立即执行截图，无延迟
  - 自动添加ClassIsland时间水印
  - 支持下载和预览
远程窗口关闭功能 🆕
- 获取可关闭窗口: http://[IP地址]:8088/api/close-windows
  - 方法: GET
  - 响应: 返回窗口列表，包含可关闭状态
- 关闭窗口: http://[IP地址]:8088/api/close-window
  - 方法: POST
  - 请求体:
```
{
  "windowHandle": "窗口句柄",
  "forceClose": false
}
```
  - 参数说明:
    - windowHandle: 通过获取窗口列表API获得的窗口句柄
    - forceClose: 是否强制关闭（直接终止进程）
- 安全特性:
  - 自动过滤系统关键窗口（explorer、dwm等）
  - 不允许关闭当前ClassIsland进程
  - 记录所有关闭操作的详细日志
  - 支持优雅关闭和强制关闭两种模式
- Web界面: 提供直观的窗口选择和关闭界面，带安全提醒

获取可截图窗口列表

端点: http://[IP地址]:8088/api/windows
方法: GET

响应:

{
  "success": true,
  "data": [
    {
      "handle": "窗口句柄",
      "title": "窗口标题",
      "processName": "进程名称"
    }
  ]
}

退出令牌管理功能 🆕
- 获取令牌状态: http://[IP地址]:8088/api/exit-token/status
  - 方法: GET
  - 响应:
```
{
  "success": true,
  "hasToken": true,
  "token": "A1B2C3D4",
  "setTime": "2023-12-07 14:30:25"
}
```
- 设置新令牌: http://[IP地址]:8088/api/exit-token/set
  - 方法: POST
  - 响应: 返回新生成的8位令牌
- 清除令牌: http://[IP地址]:8088/api/exit-token/clear
  - 方法: POST
  - 响应: 确认清除结果
- 安全特性:
  - 设置令牌后，必须通过令牌验证才能退出应用
  - 令牌为8位大写字母和数字组合
  - 退出验证成功后令牌自动清除
  - 可通过Web界面重新设置令牌
- Web界面: 提供令牌状态查看、设置和清除功能