# WiseGrade（智评）

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

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

- [技术方案与开发规格](docs/WISEGRADE_TECHNICAL_SPEC.md)
- [会话页面与业务 Agent](docs/CHAT_AGENT.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`，访问 <http://127.0.0.1:18080>。

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