# WiseGrade（智评）

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

教师端系统包含课程版本、挂载目录导入、文档解析、知识库检索、独立评分批次、教师复核及导出。完整技术规格见：

- [技术方案与开发规格](docs/WISEGRADE_TECHNICAL_SPEC.md)
- [Codex Goal 模式开发提示词](docs/CODEX_GOAL_PROMPT.md)

## 当前约束

- 仅供教师使用
- 通过宿主机挂载目录读取学生材料
- 支持 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 --build -d`，访问 <http://127.0.0.1:8080>。

学生材料只从只读挂载的 `/data/inbox` 读取。没有本地嵌入模型或 API 密钥时，系统仍可启动和完成导入；评分会显示明确错误。详细部署和使用步骤见 [部署与使用指南](docs/DEPLOYMENT.md)。