aerospaceboy
ebe33392ca
Preserve document revisions and evidence, harden indexing and export behavior, add explicit material selection and direct-folder import, validate model JSON schemas with safe error messages, and retain student selection while loading scoring data.
WiseGrade（智评）
WiseGrade 是面向《自动化专业综合实践》课程的教师端自动评分系统，采用个人电脑本地部署、单机单管理员模式。
系统支持课程与评分规则版本管理、挂载目录导入、文档解析与知识库检索、独立评分批次、教师复核、Excel 成绩表和逐生 PDF 反馈导出。教师也可通过持久会话查询材料、调用业务功能，并在确认卡片中核对和执行写入操作。
快速启动
- 复制
.env.example为.env，设置学生材料目录WISEGRADE_DATA_DIR、DEEPSEEK_API_KEY和随机WISEGRADE_SECRET_KEY。 - 将离线 BGE-M3 模型放在
models/bge-m3/；扫描 PDF 另需离线 OCR 模型。 - 在仓库根目录运行
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 和恢复机制。
- 开发与测试 · 故障定位。
证据政策上线与批次 3 复核清单 记录把页面类型证据政策应用到业务环境的步骤，以及批次 3 建议复核的评分项。该文件中的业务数据操作均未执行。
开发提示词 集中存放阶段任务说明；交接记录 保留实现进展、验证记录和接手事项。
课程原始资料及测试示例仍位于 docs/ 根目录，应用和测试按现有路径读取；学生原件、模型权重和运行产物不纳入项目文档。