Files
WiseGrade/README.md
T

2.2 KiB

WiseGrade(智评)

WiseGrade 是面向《自动化专业综合实践》课程的教师端自动评分系统。

教师端系统包含持久会话与业务 Agent、课程版本、挂载目录导入、自动文档解析与索引、知识库检索、独立评分批次、教师复核及导出。完整技术规格见:

当前约束

  • 仅供教师使用
  • 通过宿主机挂载目录读取学生材料
  • 支持 PDF、DOCX、PPTX 和 PPT 导出的 PDF
  • 使用本地 BGE-M3 嵌入模型
  • 使用 deepseek-flash 进行文本和图像理解
  • 支持课程、评分规则和评分批次版本化
  • 支持 Excel 成绩表和逐生 PDF 反馈导出

资料

课程原始资料位于 docs/ 目录。

快速启动

  1. 复制 .env.example 为 .env,设置 WISEGRADE_DATA_DIR、DEEPSEEK_API_KEY 和 WISEGRADE_SECRET_KEY。
  2. 将离线嵌入模型放在 models/bge-m3/(或修改 EMBEDDING_MODEL_PATH)。
  3. 运行 docker compose up,访问 http://127.0.0.1:18080。

打开系统默认进入空白“会话”草稿;点击“新建”也只切换草稿,发送第一条消息才保存会话。历史会话可从列表继续或删除;回答上方可逐层展开工具调用,末尾可展开引用原文与页面链接。查询可直接执行,导入、入库、建批、启动、复核和导出先展示确认卡片,由教师点击后执行。学生材料只从只读挂载的 /data/inbox 读取。没有本地嵌入模型或 API 密钥时,系统仍可启动和完成导入;索引、会话或评分会显示明确错误。详细部署和使用步骤见 部署与使用指南。

评分证据与会话检索引用共用文档 ID 和页码。页面文字来自 PostgreSQL 的完整资料页记录,检索片段与向量也在 PostgreSQL;页面 PNG 位于 data/processed/,可从引用的“查看图像”打开。数据库直接生成的课程目标和规则没有实体页图像,因此只显示“查看页面文字”。历史引用由迁移 0005 一次性规范化。