Smart-Quiz-Parser 是一款面向大学生的 AI 期末刷题软件。它聚焦于“从文档到题库”的自动化与“从题库到高效练习”的完整链路，通过 React + Capacitor 构建，同时兼顾 Web 与移动端体验。项目从实际教学资料出发，支持多格式导入、多模型解析、错题复盘、进度持久化与本地化设置，目标是让题库准备和刷题流程更快、更准确、更可控。
一、核心定位与应用场景
Smart-Quiz-Parser 面向需要快速把教学资料转化为刷题系统的学生。它既适合期末复习、资格考试题库整理，也适合将现有课程资料进行结构化，快速形成可练习的题库和错题集，并通过可配置的 AI 解析与正则规则实现对不同资料格式的适配。
二、文档导入与题库生成
- 多格式导入
支持 DOC / DOCX / TXT / JSON 文件。DOC/DOCX 采用 Mammoth 读取文本，TXT 直接读取，JSON 可导入题库或恢复练习进度。 - AI 解析模式
提供三种 AI 处理模式：
- 智能提取：从原文中识别题目，容忍排版错误与噪声。
- 提取并格式化：修复 OCR 错误、补全选项标签、规范题干结构。
- 根据文档出题：根据学习资料自动生成新题。
- 正则规则解析
内置标准正则解析器，适合题库格式稳定的文档，速度快、成本低。支持自定义 splitPattern、optionPattern、answerPattern、explanationPattern，并可用 AI 根据样本文本生成建议规则，提升适配效率。
三、题目结构与解析结果规范化
系统统一题目结构，包含题干、选项、正确答案、原文解释与题型标记。
- 自动补全选项标签 A/B/C/D
- 统一正确答案为字母或 TRUE/FALSE
- 识别单选、多选与判断题
- 题目原文序号与内部题号分离，便于对照教材
四、答题流程与交互体验
- 题卡式刷题体验
清晰的题型标签与题号信息，支持单选、多选、判断题。 - 实时判题与反馈
提交后显示正确答案、原文参考；支持多选判断与高亮反馈。 - 题目菜单与搜索
内置题目目录与检索，可按题干或编号快速定位；错题模式下自动过滤显示。 - 滑动与动效体验
适配移动端滑动切题；关键交互提供反馈动画与视觉提示。