AI 阅卷助手 (AI Grading Assistant)

桌面端 AI Copilot — 零侵入式智能阅卷辅助工具

AI 阅卷助手是一款基于 Electron + Vue 3 + TypeScript 构建的桌面端 AI 阅卷辅助工具。教师可在现有阅卷系统中正常阅卷，通过全局快捷键（默认 Alt+Q）截图学生答案，AI 自动根据预设评分标准给出评分建议、扣分项和评语，帮助提升阅卷效率与一致性。

功能特性

零侵入设计 — 独立运行，不干预现有阅卷系统
全局截图 — Alt+Q 一键截图，支持矩形区域选择
AI 智能评分 — 支持 GPT-4o / Qwen-VL / Claude 等多模态模型
灵活评分标准 — 多题目、多维度评分标准配置，支持文本和图片参考答案
结果确认 — 显示 AI 评分、置信度、扣分明细，教师可修改后确认
历史记录 — 本地 SQLite 存储，支持搜索、浏览和复盘
模板管理 — 评分标准可保存为模板，支持 JSON 导入/导出
系统托盘 — 托盘常驻，后台运行，随时唤出
高度可配置 — API 地址、模型、快捷键、主题、字体大小等均可自定义

快速开始

环境要求

Node.js >= 20
npm >= 9

安装与运行

# 克隆仓库
git clone https://github.com/your-username/ai-grading-assistant.git
cd ai-grading-assistant

# 安装依赖
npm install

# 开发模式（Vite 热更新 + Electron）
npm run dev

打包构建

# 构建生产版本
npm run build

# 打包为 Windows 便携版
npm run pack

# 打包为 Windows 安装程序 (NSIS)
npm run dist

使用流程

启动应用，系统托盘显示图标，浮动工具条自动置顶
在设置中配置 AI API Key 和模型
在评分标准编辑器中添加题目、参考答案和评分细则
打开学生答卷，按下 Alt+Q 截图答题区域
AI 自动分析并返回评分建议、扣分项和评语
确认/修改评分后提交，结果保存至本地数据库

技术栈

类别	技术
桌面框架	Electron 42
前端框架	Vue 3.5 + TypeScript 7
构建工具	Vite 8
UI 组件库	Element Plus 2
状态管理	Pinia 4
本地存储	better-sqlite3 + electron-store
HTTP 客户端	Axios
打包分发	electron-builder (Windows x64)

项目结构

├── electron/              # Electron 主进程 (TypeScript)
│   ├── main/              #   窗口、截图、快捷键、IPC、托盘
│   └── preload/           #   预加载脚本 (contextBridge)
├── src/                   # Vue 3 渲染进程
│   ├── components/        #   浮动工具条、截图覆盖层、结果面板、设置、评分标准编辑器
│   ├── pages/             #   历史记录、模板管理
│   ├── stores/            #   Pinia 状态管理
│   ├── types/             #   TypeScript 类型定义
│   ├── utils/             #   工具函数
│   └── styles/            #   全局样式
├── database/              # SQLite 数据库 Schema
├── build/                 # 应用图标
├── dist/                  # Vue 构建输出
├── dist-electron/         # Electron 构建输出
└── release/               # 打包输出

AI 接口

支持兼容 OpenAI Chat Completions 格式的任意多模态模型：

默认接口：https://api.siliconflow.cn/v1/chat/completions
默认模型：用户手动配置
返回格式：结构化 JSON（评分、置信度、扣分明细、评语）

许可证

本项目采用 MIT License。

3.9 KiB Raw Permalink Blame History Unescape Escape