## 功能概览 **📥 题库导入** — 上传王道等408题库 PDF，自动解析选择题和综合题，识别科目、章节、知识点标签并入库。支持文字型 PDF 直接提取和扫描型 PDF 视觉识别（VLM 降级），支持 PUA 乱码检测和自动修复。 **✏️ 刷题练习** — 按科目/章节随机或顺序刷题，即时批改并显示正确答案与解析。支持批量刷题模式和进度追踪。 **📊 答题统计** — 追踪各科正确率变化趋势，智能分析薄弱知识点，按知识点维度统计掌握情况。 **🤖 AI助教** — 基于 DeepSeek 大模型的智能问答，可针对具体题目或知识点进行深入讲解和答疑。 **📕 错题集** — 答错题目自动收集，支持按科目/章节/状态筛选，逐题或批量重做，状态标记（已掌握/待巩固/未重做），手动添加和移除。 **🧠 知识盲区分析** — AI 自动分析错题中的知识盲区和常见误区，生成纠正建议和记忆方法。 ## 常见问题 **Q: AI助教功能需要联网吗？** A: 需要。AI助教和知识盲区分析依赖 DeepSeek API，需要有效的 API Key 和网络连接。刷题和题库管理功能可以离线使用。 **Q: 支持哪些PDF格式？** A: PDF 内容要求： 1. 最适合导入的是 408 题库 / 题本类 PDF，页面里应包含明确的题号、题干和选项结构，例如 `一、单项选择题`、`1.`、`A/B/C/D`。 2. 文字型 PDF 的识别效果最好；如果是扫描版、整页图片型、CamScanner/手机扫描类 PDF，需要额外配置 `VISION_API_KEY` 才能走视觉模型解析。未配置视觉模型时，这类文件现在会直接判定为“扫描件”，避免继续按文字 PDF 导入出脏数据。 3. 即便配置了视觉模型，扫描件也仍有质量要求：页面应尽量端正、无严重阴影/高光、题号与选项清晰可见、不要大面积裁切缺失；否则容易出现题干断裂、选项串页码、配图定位不准等问题。 4. 扫描件导入耗时通常明显长于文字型 PDF；页数较多时，视觉解析可能持续数分钟。上传后如果短时间内还没有结果，先等待后端完成，不要连续重复上传同一份文件。 5. 更推荐按单科或单章节整理文件名与目录名，例如 `数据结构-线性表练习.pdf`、`操作系统/进程管理/真题.pdf`。系统会根据路径或文件名里的关键词推断科目；像 `2021408.pdf` 这种不含学科信息的文件，界面里通常会显示为 `未知科目`。 6. 纯讲义、纯答案册、没有标准题号/选项结构的资料，可能导入为 0 题或解析不完整。 **Q: 为什么需要两个 API Key？** A: 本项目使用双模型架构：DeepSeek 负责推理（AI 助教对话、答题分析），通义千问VL 负责视觉（扫描 PDF 识别、图片 OCR）。DeepSeek 的 API 不支持图片输入，所以需要单独的视觉模型。如果你只用文字型 PDF，只需配 DeepSeek 即可。 **Q: 数据库文件在哪里？** A: 默认在 `data/questions.db`，SQLite 单文件数据库。 **Q: 如何批量导入？** A: 点击'题库导入'，选择'指定目录导入'，路径默认已挂载到懒猫网盘下，默认需要带上'/app/home'。 如pdf文件在'下载'文件夹，则路径填写“/app/home/下载”，见附图。