WiseGrade（智评）

WiseGrade 是面向《自动化专业综合实践》课程的教师端自动评分系统，采用个人电脑本地部署、单机单管理员模式。

系统支持课程与评分规则版本管理、挂载目录导入、文档解析与知识库检索、独立评分批次、教师复核、Excel 成绩表和逐生 PDF 反馈导出。教师也可通过持久会话查询材料、调用业务功能，并在确认卡片中核对和执行写入操作。

快速启动

1. 复制 .env.example 为 .env，设置学生材料目录 WISEGRADE_DATA_DIR、DEEPSEEK_API_KEY 和随机 WISEGRADE_SECRET_KEY。
2. 将离线 BGE-M3 模型放在 models/bge-m3/；扫描 PDF 另需离线 OCR 模型。
3. 在仓库根目录运行 docker compose up，访问 http://127.0.0.1:18080。

学生材料从只读挂载的 /data/inbox 读取，支持 PDF、DOCX、PPTX 和 PPT 导出的 PDF。默认使用本地 BGE-M3 嵌入模型及 deepseek-flash 模型配置；模型端点需支持所用功能的文本、图像和工具调用。没有本地嵌入模型或 API 密钥时仍可启动和导入，依赖模型的功能会显示配置错误。

文档入口

部署、使用和技术说明统一维护在 项目指南：

• 部署与配置：Linux、Windows Docker Desktop、离线模型和 OCR。
• 教师使用：导入、评分、复核、导出与会话确认规则。
• 业务规则与技术设计：成绩结构、课程依据、解析、RAG、评分和版本管理。
• 会话与业务 Agent 实现：任务、数据、工具边界、API 和恢复机制。
• 开发与测试 · 故障定位。

开发提示词 集中存放阶段任务说明；交接记录 保留实现进展、验证记录和接手事项。

课程原始资料及测试示例仍位于 docs/ 根目录，应用和测试按现有路径读取；学生原件、模型权重和运行产物不纳入项目文档。