面向单门课程的多 Agent 可信知识问答与专项复习系统。
当前目标：由 5 人小组在 7 天内完成可答辩演示的 MVP。系统需要跑通“资料导入 → 可信问答 → 严格拒答 → 专项训练 → 评分讲解 → 错题沉淀”闭环。
- 导入数字 PDF，并为扫描 PDF 提供基础 OCR。
- 回答附带文档名、页码或题号引用。
- 证据不足时明确拒答，不使用模型通识补全课程事实。
- 展示协调、知识、出题、评测讲解四类 Agent 的公开步骤摘要。
- 支持专项训练、分步评分、讲解、错题本和掌握度更新。
- 使用 Docker Compose 或统一脚本在答辩电脑复现。
- 前端：Vue 3、TypeScript、Vite、Pinia、Vue Router、Element Plus、KaTeX
- 后端：FastAPI、Pydantic、SQLAlchemy、Alembic
- Agent：LangGraph
- 数据：PostgreSQL、pgvector、全文检索
- 文档处理：PyMuPDF、PaddleOCR
- 测试：pytest、Vitest、Playwright
- 部署：Docker Compose
| 成员 | 角色 | 主责 | 交付 |
|---|---|---|---|
| A | 组长 / 产品测试 | 范围、任务板、评测、验收、答辩 | 需求清单、50 条评测、指标报告、答辩材料 |
| B | 知识库 / RAG | PDF/OCR、切块、索引、混合检索、引用 | 导入检索模块、SourceRef、Recall@5 报告 |
| C | Agent / 提示词 | 状态图、契约、拒答、出题、评分 | Agent 流程、Schema、提示词和契约测试 |
| D | 后端 / 数据部署 | 认证、API、数据库、Worker、SSE、部署 | API、迁移、任务恢复、Compose、备份 |
| E | 前端 / E2E | 页面、SSE、公式、响应式、端到端测试 | 完整前端、E2E、演示界面 |
成员姓名和 GitHub 用户名由 A 在 docs/TEAM.md 中维护。
| 日期 | 目标 | 集成验收 |
|---|---|---|
| 第 1 天 | 定范围、定接口、搭骨架 | 公共契约合并，前后端、数据库和 Worker 可启动 |
| 第 2 天 | 资料可导入、可检索 | 返回带页码的 SourceRef |
| 第 3 天 | 可信问答闭环 | 可回答问题带引用，资料外问题正确拒答 |
| 第 4 天 | 训练评分闭环 | 至少完成 3 题并返回评分、讲解和错题 |
| 第 5 天 | 全链路集成 | 登录到错题主链路跑通 |
| 第 6 天 | 评测与集中修复 | 核心指标达标或形成明确缺陷清单 |
| 第 7 天 | 冻结与答辩 | 完整演示连续成功 3 次 |
第 2、4、6 天结束前设置集成门；未通过时优先修复主链路，不新增功能。
.
├─ apps/
│ ├─ frontend/ # E：Vue 前端
│ ├─ api/ # D：FastAPI 服务
│ └─ worker/ # B/D：导入与索引任务
├─ packages/
│ ├─ agents/ # C：LangGraph、提示词与 Agent 契约
│ └─ retrieval/ # B：解析、切块、索引与混合检索
├─ contracts/ # B/C/D/E 共用 JSON Schema 与 Mock
├─ docs/ # A 维护的需求、评测、ADR 和答辩资料
├─ tests/
│ └─ evaluation/ # A 组织的 50 条评测集与指标脚本
└─ .github/ # Issue、PR 与协作模板
首批代码进入后，再由各模块负责人补充对应目录的启动、测试和故障处理说明。
- 第 1 天先合并
contracts/中的公共契约和 Mock，再并行开发。 - 每项任务使用独立分支，通过 Pull Request 合并到
main。 - 每个 PR 至少由一名非主责成员评审。
- Schema 变更必须同步更新契约、示例响应和前端 Mock。
- 当天可运行代码必须推送到远程仓库，禁止关键模块只留在个人电脑。
- 密钥、真实课程资料、个人数据、标准答案和私有评分点不得提交。
完整流程见 CONTRIBUTING.md。
- 正常流程和错误流程都能运行。
- 单元测试、契约测试或对应自动化测试已通过。
- 权限和私有字段隔离已验证；提交答案前不返回答案或评分点。
- 错误响应和日志包含
trace_id。 - 接口契约、Mock 和必要说明同步更新。
- 至少一名非主责成员完成评审，并在集成环境运行成功。
- 复制
.env.example创建本地环境文件；不要提交真实密钥。 - 课程资料与评测数据应遵守版权和隐私要求。
- 本仓库当前未指定开源许可证；公开可见不等于授权复制、修改或再分发。