AI 智慧黑板直播巡课系统是面向学校和教培机构的直播巡课、录像留存、巡课复盘、设备运维、权限审计和现场交付验收平台。当前版本为 V1.3.9。
系统围绕“智慧黑板 + 教室摄像头 + NVR/RTSP + 流媒体中台 + 校级巡课闭环”建设，帮助学校完成从实时巡课、异常记录、整改处理到报表归档的闭环管理。
开源许可证：Apache License 2.0。首次部署后请立即修改默认管理员密码。公开 Issue、日志和截图中不要包含学校、教师、学生、设备凭据或录像隐私信息。
- 首页看板：展示教室在线、直播、录像、告警、巡课任务和整改摘要。
- 实时巡课：查看智慧黑板画面和教室摄像头链路状态。
- 录像管理：管理手动录像、全天录像策略、录像状态、预览和下载边界。
- 巡课复盘：基于元数据、文件状态和人工说明生成复盘摘要。
- AI 运维中心：基于本地规则输出设备、NVR、FFmpeg、存储、流媒体、巡课闭环风险建议。
- 巡课闭环：管理巡课任务、异常、整改、证据、复盘、报表和轻量计划生成。
- 报表导出：基于巡课报表快照导出 HTML/CSV。
- 现场交付验收：检查后端版本、FFmpeg、录像目录、流媒体中台、NVR、客户端、实时链路、备份和权限审计。
- 权限审计：按用户功能权限和教室范围控制访问，关键操作写入日志。
- 不做人脸识别。
- 不做学生行为评价。
- 不输出视频内容识别结论。
- 不做泛 AI 聊天助手。
- 不做泛视频平台。
- 不伪造 NVR、RTSP、流媒体、摄像头或录像在线状态。
- 报表导出只包含任务、异常、整改、录像证据等元数据。
默认账号：admin / admin123
npm install
npm run dev默认地址：
- 后端 API：
http://127.0.0.1:4100 - 前端后台：
http://127.0.0.1:5173
如果 4100/5173 被旧服务占用，先运行端口检查脚本：
powershell -NoProfile -ExecutionPolicy Bypass -File scripts/check-dev-ports.ps1备用端口示例：
$env:PORT="4199"
npm --workspace apps/backend run start
$env:VITE_API_BASE="http://127.0.0.1:4199"
npm --workspace apps/frontend run dev -- --host 127.0.0.1 --port 5299 --strictPort服务启动后运行：
powershell -NoProfile -ExecutionPolicy Bypass -File scripts/check-delivery-health.ps1指定备用端口：
powershell -NoProfile -ExecutionPolicy Bypass -File scripts/check-delivery-health.ps1 -BackendUrl http://127.0.0.1:4199 -FrontendUrl http://127.0.0.1:5299npm run build
npm --workspace apps/backend run start生产环境建议：
- 前端使用
npm run build生成apps/frontend/dist，由 Nginx/IIS/Apache 托管静态文件。 - 后端作为常驻 Node.js 服务运行。
- 通过反向代理把
/api和 WebSocket 转发到后端端口。 DATA_DIR和RECORDING_DIR放到独立数据盘并定期备份。
提交缺陷或建议前请搜索现有 GitHub Issue。安全问题请按 SECURITY.md 私下报告，不要公开披露未修复问题或真实凭据。
本项目使用 Apache License 2.0。第三方组件仍遵循各自许可证，详见 THIRD_PARTY_NOTICES.md。