32 lines
1.6 KiB
Markdown
32 lines
1.6 KiB
Markdown
# 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 --build -d`，访问 <http://127.0.0.1:18080>。
|
|
|
|
打开系统默认进入“对话”；查询可直接执行，导入、入库、建批、启动、复核和导出先展示确认卡片，由教师点击后执行。学生材料只从只读挂载的 `/data/inbox` 读取。没有本地嵌入模型或 API 密钥时，系统仍可启动和完成导入；索引、对话或评分会显示明确错误。详细部署和使用步骤见 [部署与使用指南](docs/DEPLOYMENT.md)。
|