# classroom

**Repository Path**: java-bin/classroom

## Basic Information

- **Project Name**: classroom
- **Description**: Classroom Analysis Assistant (Electron + React), local single-user edition
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-11-15
- **Last Updated**: 2026-11-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI课堂分析助手（本机版）

基于课堂实录源代码重构的**本机单用户版**桌面应用。所有数据保存在本机，AI 服务直连各服务商 API，无云端依赖、无需注册登录。

## 功能总览

| 模块 | 说明 |
|------|------|
| 📄 文档库 | 支持 TXT / Markdown / DOCX / PDF 导入，自动识别 UTF-8 / GBK 等编码，拖拽或选择文件导入 |
| 🔍 智能预处理 | 本地即时分析：文本画像、师生发言结构、高频关键词、潜在问题提醒 |
| 🤖 AI 智能分析 | 五类分析，全程**流式输出**：提问分析（布鲁姆六层次）/ 教学改进 / 学习成果（SOLO）/ 课堂速览 / 自定义模板 |
| 📊 图表展示 | 布鲁姆分布柱状图、高阶提问占比、SOLO 层级递进图、发言结构饼图 |
| 📤 报告导出 | PDF / Word（完整排版报告）、Excel / CSV（明细数据）、Markdown |
| 📝 提示词模板 | 内置 4 个标准模板（源自原系统 Prompt），支持创建副本与自定义模板 |
| ⚙️ AI 服务 | 多配置档案：智谱 GLM / 通义千问 / DeepSeek / Kimi / OpenAI / Claude / Ollama 本地模型，一键测试连接、拉取模型列表 |
| 💾 数据管理 | 全部数据本地 JSON 存储，一键备份 / 恢复，明暗双主题 |

## 相比原系统的增强

- ✅ 完全本地化：原系统依赖 Supabase 云端（数据库 + Edge Functions），本版将 AI 调用与存储全部本地化，单用户免登录
- ✅ 更多文档格式：原版仅支持 TXT，本版支持 TXT/MD/DOCX/PDF（含 CJK cmap 支持）
- ✅ 长文档自动分块：按模型上下文窗口智能分块，逐块分析后自动汇总去重（原版强制单块截断）
- ✅ 流式输出：实时看到 AI 生成过程，可随时停止
- ✅ 内置示例课堂实录，开箱即用
- ✅ 教师反思可编辑保存（教学改进建议卡片）
- ✅ 仪表盘聚合统计（原版没有）
- ✅ 明暗主题、现代 UI

## 开发

```bash
npm install
npm run dev      # 开发模式
npm run build    # 构建产物
npm run dist     # 构建 Windows exe（NSIS 安装版 + 便携版）
```

## 技术栈

- Electron 37 + electron-vite 4 + Vite 6
- React 18 + TypeScript + Tailwind CSS
- Recharts 图表、docx/xlsx 导出、mammoth（DOCX 解析）、pdfjs-dist（PDF 文字提取，含 CJK cmap）

## 数据位置

`%APPDATA%/ai-classroom-studio/data/`：documents.json（文档元数据）、docs/*.txt（正文）、analyses.json（分析记录）、templates.json（模板）、settings.json（AI 配置）。