chore: initialize WiseGrade project

2026-09-25 11:10:34 +08:00
parent f7a9091c86
commit 146d5566cf
16 changed files with 6603 additions and 1 deletions
@@ -2,7 +2,7 @@

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

-当前项目处于技术方案固化和系统开发准备阶段。完整技术规格见：
+教师端系统包含课程版本、挂载目录导入、文档解析、知识库检索、独立评分批次、教师复核及导出。完整技术规格见：

 - [技术方案与开发规格](docs/WISEGRADE_TECHNICAL_SPEC.md)
 - [Codex Goal 模式开发提示词](docs/CODEX_GOAL_PROMPT.md)
@@ -20,3 +20,11 @@ WiseGrade 是面向《自动化专业综合实践》课程的教师端自动评
 ## 资料

 课程原始资料位于 `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)。