# InsightClass

**Repository Path**: ygttygtt/InsightClass

## Basic Information

- **Project Name**: InsightClass
- **Description**: InsightClass 深见课堂：AI 赋能的智慧校园视觉中台，通过高精度行为特征检索重塑教与学的数字化洞察。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-26
- **Last Updated**: 2026-06-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# InsightClass 深见课堂

AI 赋能的智慧校园视觉中台，通过高精度行为特征检索重塑教与学的数字化洞察。

检测四类课堂行为：`phone_use`（玩手机）、`talking`（交谈）、`sleeping`（打瞌睡）、`standing`（站立）。

## 快速开始

```bash
# 1. 克隆项目
git clone <repo-url>
cd InsightClass

# 2. 安装依赖（含 Web 前端）
pip install -e .[ultralytics,web]

# 3. 启动 Web 服务
insightclass serve --host 0.0.0.0 --port 8080
# 浏览器打开 http://localhost:8080
```

> **端口说明**：默认端口 8000。若 8000 被占用（如海康摄像头后台），改用 `--port 8080`。
>
> **HTTPS 模式**：局域网摄像头需要 HTTPS 才能使用浏览器摄像头，加 `--https` 参数自动生成自签名证书。
>
> **摄像头配置**：`configs/cameras.yaml` 和 `configs/app.yaml` 由 Web 界面自动创建和管理，无需手动配置。

## 功能

- **RTSP 实时监控**：连接教室摄像头，实时查看画面（MJPEG 流）
- **目标检测**：在监控画面上叠加 AI 检测框，识别玩手机/交谈/打瞌睡/站立
- **摄像头检测**：从 RTSP 摄像头抓帧实时检测
- **图片/视频检测**：上传图片或视频文件进行离线分析
- **批量视频检测**：同时上传多个视频，后台异步处理，支持导出 CSV/JSON
- **摄像头管理**：Web 界面添加/删除/编辑/测试摄像头连通性
- **模型管理**：支持多模型切换，可设默认模型
- **Dashboard 统计**：各摄像头检测数据统计，支持导出报告

## CLI 命令

```bash
# 数据处理
insightclass create-manifest --config ... --output ...   # 创建数据集清单
insightclass extract-frames --manifest ... --fps 1.0     # 视频抽帧
insightclass inspect-yolo --dataset-root ... --output .. # 检查标注质量
insightclass write-yolo-yaml --dataset-root ... --output # 生成训练配置

# 训练推理
insightclass train --config configs/training.yaml        # 训练模型
insightclass validate --config ...                       # 验证模型
insightclass predict --config configs/inference.yaml     # 推理预测
insightclass render-first-frame --config ...             # 可视化第一帧

# 实验管理
insightclass compare-experiments --experiments-root experiments --output reports/summary.csv
insightclass view-experiments --experiments-root experiments --port 8001

# Web 服务
insightclass serve --host 0.0.0.0 --port 8000            # 主服务（摄像头+Dashboard）
insightclass serve --host 0.0.0.0 --port 8000 --https    # HTTPS 模式
insightclass demo --port 8000                            # Demo（推理+实验查看）
```

## 项目结构

```
InsightClass/
├── configs/              # 配置文件
│   ├── classes.yaml      #   类别定义（4 种行为）
│   ├── cameras.yaml      #   摄像头配置（运行时生成）
│   └── app.yaml          #   应用配置（运行时生成）
├── data/                 # 数据集（gitignored）
├── docs/                 # 项目文档
├── experiments/          # 训练产物（gitignored）
├── scripts/              # 独立工具脚本
└── src/insightclass/     # 源代码
    ├── backends/         #   可替换检测后端（Strategy + Factory）
    ├── data/             #   数据处理模块
    ├── evaluation/       #   实验管理模块
    ├── visualization/    #   可视化模块
    ├── web/              #   FastAPI Web 前端
    └── utils/            #   工具函数
```

## 文档

| 文档 | 用途 |
|------|------|
| [00 项目指南](docs/00_project_guide.md) | 架构与设计决策 |
| [01 快速上手](docs/01_快速上手.md) | 数据→标注→训练→推理全流程 |
| [02 录制操作手册](docs/02_录制操作手册.md) | 摄像头录制指南 |
| [03 视频处理手册](docs/03_视频处理手册.md) | 视频抽帧流程 |
| [04 标注工具手册](docs/04_X-AnyLabeling操作手册.md) | 标注工具使用指南 |
| [05 标注规范](docs/05_标注规范.md) | 标准化标注规则 |
| [06 实验手册](docs/06_实验手册.md) | 实验设计指南 |
| [07 服务器训练手册](docs/07_服务器训练手册.md) | GPU 服务器训练流程 |
| [08 前端使用手册](docs/08_前端使用手册.md) | Web 前端功能说明 |
| [项目整体架构文档](docs/项目整体架构文档.md) | 完整架构详解 |