Skip to content

Repository files navigation

智考 AI (SmartExam AI)

Project Banner

智考 AI 是一个全流程 AI 驱动的现代化考试综合管理平台。系统深度集成了 Google Gemini 3 & 2.5 系列大模型能力,实现了从考前智能命题、考中实时监考到考后自动评阅及数据分析的完整闭环。旨在为教育机构和企业提供高效、智能、公正的在线考核解决方案。

🌟 核心功能详解

👨‍🏫 管理端 (教师/管理员)

1. 🧠 AI 智能命题引擎

告别繁琐的手工出题。只需简单配置,AI 即刻为您构建专业试卷:

  • 多维配置: 支持自定义考核主题(如“React 基础”、“量子物理”)、难度等级(简单/中等/困难)及题目数量。
  • 丰富题型: 涵盖单选题、多选题、判断题、填空题及简答题等多种题型,全面考察学生能力。
  • AI 绘图 (Powered by Gemini Image): 自动根据考试主题生成极具氛围感的试卷封面头图。支持选择**“抽象艺术”“写实风格”**,让试卷更具辨识度。
  • 智能续写: 在编辑过程中,可随时让 AI 补充生成新的题目,或手动微调题目内容。

2. 🛡️ 智能监考配置中心

打造严肃、公平的考试环境,模拟真实考场:

  • 多模态检测: 可开关配置头部移动检测(识别视线偏离)和环境音检测(识别异常交谈)。
  • 规则定制: 自定义抓拍频率(10s-300s)及违规警告阈值。
  • 严格模式: 标记高风险考试行为,供后续人工复核。

3. 📊 全局数据看板

不仅是数据展示,更是教学决策辅助:

  • 可视化图表: 直观展示各学科/考试的平均分走势与分布。
  • AI 深度洞察: 系统自动分析整体考试数据,生成自然语言形式的学情分析报告,精准指出知识盲区与教学改进方向。

👨‍🎓 考生端 (学生)

1. 🖥️ 沉浸式考试环境

  • 专注设计: 现代化、无干扰的答题界面,顶部实时展示考试倒计时。
  • 视觉体验: 考卷配备专属 AI 生成的主题头图,提升考试仪式感。
  • 实时反馈: 侧边栏实时显示监考状态(REC 录制中、头部/音频检测状态),对考生起到督促作用。

2. 📝 AI 智能阅卷系统

实现“交卷即出分”的高效体验:

  • 客观题秒判: 单选、多选、判断、填空题系统自动比对标准答案,毫秒级出分。
  • 主观题 AI 评分: 对于简答题,AI 将扮演“专家教师”角色,基于语义理解对比学生答案与标准答案,给出公正评分及详细的评语反馈,不再局限于关键词匹配。

3. 📈 成绩单与解析

  • 即时反馈: 考试结束后立即生成成绩单。
  • 逐题解析: 展示每道题的得分情况、标准答案及 AI 点评,帮助学生即时复盘,查漏补缺。

🛠️ 技术栈

本项目采用前沿的现代前端技术栈构建,确保高性能与良好的开发体验:

  • 核心框架: React 19 - 构建用户界面的核心库。
  • 语言: TypeScript - 提供强类型安全保障。
  • 样式: TailwindCSS - 实用优先的 CSS 框架,支持暗色模式。
  • AI 模型: Google Gemini API
    • gemini-3-flash-preview: 用于高并发、低延迟的文本生成(命题、阅卷、分析)。
    • gemini-2.5-flash-image: 用于生成高质量的试卷封面图。
  • 图表库: Recharts - 用于数据可视化。
  • 图标库: Lucide React - 美观统一的图标系统。
  • 构建/运行: Native ES Modules (ESM) - 浏览器原生支持,无需复杂打包配置。

🚀 快速开始

前置要求

  1. 需要获取 Google Gemini API Key。
  2. Node.js 环境(如果进行本地构建)。

环境变量

项目依赖 API Key 运行,请确保环境变量中包含:

API_KEY=your_google_gemini_api_key

注意:本应用采用纯前端架构,API Key 在初始化 GoogleGenAI 客户端时使用。

📂 目录结构

├── components/       # UI 组件
│   ├── AdminViews.tsx   # 管理端核心视图(命题、列表、详情、配置)
│   └── StudentViews.tsx # 学生端核心视图(考试、结果页)
├── services/         # 业务逻辑服务
│   ├── geminiService.ts  # AI 接口层 (调用 Gemini API)
│   └── storageService.ts # 数据持久层 (LocalStorage 封装)
├── types.ts          # TypeScript 类型定义
├── App.tsx           # 主应用入口与路由逻辑
├── index.html        # 入口 HTML
└── metadata.json     # 项目元数据与权限配置

🤝 贡献者

📄 许可证

本项目基于 Apache-2.0 许可证 开源。

About

一个有AI 能力的考试综合管理平台 ,包含考前命题-考中监考-考后评阅-数据应用-全流程 AI 大模型能力管理。中文版,分管理端和用户端。

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages