AI 班级管理决策引擎 — 智能排座 · 行为分析 · 班级文化
Intelligent Classroom Management & Seating Decision Engine
SeatWeaver 是一款面向班主任的 AI 智能排座与班级管理一体化工具。基于多维标签系统和多地区教育模型，提供从排座优化到班级文化建设的全链路解决方案。
| 领域 | 能力 |
|---|---|
| 🪑 智能排座 | 4 种优化算法（遗传算法 / 匈牙利算法 / 模拟退火 / 图求解），支持多维约束（视力、身高、行为、学业） |
| 🌍 多地区适配 | 内地、香港、澳门、台湾 × 3 个学段教育模型，标签权重和约束规则自动适配 |
| 🧠 行为分析引擎 | 45+ 业务引擎覆盖：行为趋势、心理画像、冲突衍生、家校沟通、课堂诊断 |
| 📊 班级文化 | 氛围雷达、健康报告、成长档案、温情教育系统、班级诊断 |
| 👨🏫 教师关怀 | 教师数据分析、教学策略推荐、身心健康看板、LLM 深度推理助手 |
| 🔬 AI 扩展 | 事件总线、全局触发链、自动评语、进步检测器、师生温度指数 |
| 📸 数据录入 | 扫码录入、OCR 文本识别、CSV 模板导入、JSON 格式解析 |
| 🔐 安全 | AES-256-GCM 加密、HMAC-SHA256 PIN 存储、常数时间比较防时序攻击 |
seatweaver/
├── lib/
│ ├── algorithms/ # 4 种排座优化算法
│ ├── configs/ # 4 地区 × 3 学段教育模型
│ ├── engines/ # 45+ 业务引擎（核心逻辑）
│ ├── models/ # 19 个数据模型
│ ├── services/ # 21 个服务（存储、AI、消息、通知）
│ ├── store/ # AppState 全局状态管理（ChangeNotifier）
│ ├── ui/
│ │ ├── pages/ # 28 个页面
│ │ ├── widgets/ # 14 个可复用组件
│ │ ├── theme/ # 亮/暗主题
│ │ └── icons/ # 自定义图标
│ └── utils/ # 9 个工具函数
├── test/ # 44 个测试文件（659+ 测试用例）
└── docs/ # 文档与审计报告
| 类别 | 引擎 | 说明 |
|---|---|---|
| 🎯 排座 | scoring_engine / constraint_engine / optimization_engine / rotation_engine / rl_seating_engine |
座位评估、约束验证、方案优化、轮换策略 |
| 📈 行为 | behavior_trend_engine / behavior_trigger_engine / behavior_derivative_handler / quick_recorder |
行为趋势追踪、触发联动、衍生分析 |
| 🧠 心理 | psych_behavior_engine / student_risk_engine / predictive_risk_engine |
心理画像、风险预测、早期干预 |
| 🌱 成长 | growth_archive_engine / growth_trend_engine / progress_detector / semester_simulator |
成长档案、学期模拟 |
| 👨🏫 教师 | teacher_analytics_engine / teaching_strategy_engine / teacher_wellness_engine / llm_deep_reasoning_engine |
教师数据分析、策略推荐、身心健康、AI 推理 |
| 🏫 班级 | class_culture_engine / climate_radar / classroom_diagnosis_engine / warm_education_system |
班级文化、氛围雷达、诊断报告 |
| 💬 沟通 | parent_communication_engine / comment_engine / personalized_script_engine |
家校沟通、评语生成、个性化话术 |
- Flutter SDK ≥ 3.11.5
- Dart SDK ≥ 3.11.5
- Android Studio / Xcode（移动端构建）
# 克隆仓库
git clone https://github.com/zxz88601151/-.git
cd seatweaver
# 安装依赖
flutter pub get
# 运行（开发模式）
flutter run
# 构建
flutter build apk # Android
flutter build ios # iOS
flutter build web # Web
flutter build windows # Windows运行后进入 7 步交互式引导：
- 欢迎界面 → 2. 选择地区（内地/香港/澳门/台湾）
- 选择学段 → 4. 填写班级信息
- 导入学生（扫码/CSV/手动） → 6. 配置座位行列
- 预览确认 — 快速上手
# 运行所有测试
flutter test
# 运行特定测试
flutter test test/engines_test.dart
# 代码分析
dart analyze lib/当前测试状态：659 passed / 5 skipped / 0 failed
- 智能排座引擎（4 种算法）
- 多地区教育模型适配
- 行为追踪与心理画像
- 教师数据看板与 AI 推理
- 班级协作（多教师协同管理）
- 云端数据同步
- 家长端小程序
- 自动排课与值日安排
感谢您对 SeatWeaver 的关注！欢迎参与开发：
- Fork 本仓库
- 创建特性分支：
git checkout -b feature/amazing-feature - 提交修改：
git commit -m 'feat: add amazing feature' - 推送分支：
git push origin feature/amazing-feature - 发起 Pull Request
详细规范请参阅 CONTRIBUTING.md。
| 类型 | 说明 |
|---|---|
feat: |
新功能 |
fix: |
修复 Bug |
refactor: |
重构 |
docs: |
文档 |
test: |
测试 |
chore: |
构建/工具 |
本项目基于 MIT 许可证开源 — 详见 LICENSE。
- 中哥 — 创始人 & 核心开发者
Built with ❤️ for Chinese educators
SeatWeaver — 让每位学生有一个合适的座位