|
|
# ExamGenerator 项目
|
|
|
|
|
|
本项目是一个 **数学试题自动生成系统**，支持 **小学、初中、高中** 三个年级的数学题目。
|
|
|
系统采用 **抽象类 + 子类继承** 的设计模式，分别实现不同年级的出题逻辑，并支持用户登录、题目查重和自动保存功能。
|
|
|
|
|
|
---
|
|
|
|
|
|
## 📂 项目结构
|
|
|
|
|
|
```
|
|
|
ExamGenerator/
|
|
|
├── main.py # 主入口程序
|
|
|
├── exam_generator.py # 考试生成器核心逻辑（含查重）
|
|
|
├── account_manager.py # 用户账户管理模块
|
|
|
├── history_manager.py # 历史管理模块（负责保存/读取历史题目）
|
|
|
├── generators/ # 出题生成器目录
|
|
|
│ ├── base_generator.py # 抽象类：出题生成器基类
|
|
|
│ ├── primary_generator.py # 小学出题生成器
|
|
|
│ ├── junior_generator.py # 初中出题生成器
|
|
|
│ └── senior_generator.py # 高中出题生成器
|
|
|
└── exams/ # 保存生成的试卷目录
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
## 功能介绍
|
|
|
|
|
|
### 用户登录
|
|
|
|
|
|
* 支持小学、初中、高中账号登录
|
|
|
* 登录后自动进入对应出题模式
|
|
|
|
|
|
### 出题生成
|
|
|
|
|
|
* 小学：四则运算
|
|
|
* 初中：四则运算 + 平方/开方
|
|
|
* 高中：四则运算 + 三角函数
|
|
|
|
|
|
### 历史查重
|
|
|
|
|
|
* `HistoryManager` 只负责保存和读取历史题目
|
|
|
* **查重逻辑已集成在 `ExamGenerator._generate_and_save_questions`**，生成题目时会自动避免重复
|
|
|
|
|
|
### 题目保存
|
|
|
|
|
|
* 生成的题目自动保存为 `.txt` 文件
|
|
|
* 文件名格式：`YYYY-MM-DD-HH-MM-SS.txt`
|
|
|
|
|
|
---
|
|
|
|
|
|
## 使用方法
|
|
|
|
|
|
### 运行项目（开发环境）
|
|
|
|
|
|
```bash
|
|
|
cd ExamGenerator
|
|
|
python main.py
|
|
|
```
|
|
|
|
|
|
### 登录系统
|
|
|
|
|
|
* 输入用户名和密码（例如：`张三1 123`）
|
|
|
* 系统会识别年级，并提示你输入要生成的题目数量
|
|
|
|
|
|
### 生成题目
|
|
|
|
|
|
* 输入 `10-30` 之间的数字，生成对应数量的数学题
|
|
|
* 输入 `-1` 可退出当前用户
|
|
|
* 输入 `切换为 小学/初中/高中` 可切换出题难度
|
|
|
|
|
|
---
|
|
|
|
|
|
## 技术亮点
|
|
|
|
|
|
* **抽象类设计**：使用 `BaseQuestionGenerator` 定义统一接口，小学/初中/高中继承实现
|
|
|
* **模块化结构**：按功能拆分文件，便于维护和扩展
|
|
|
* **查重机制优化**：查重逻辑整合进 `ExamGenerator`，`HistoryManager` 仅负责保存/读取
|
|
|
* **可扩展性强**：后续可新增 “大学” 出题生成器，只需继承抽象类即可
|
|
|
|
|
|
---
|
|
|
|
|
|
## ⚠️ 注意事项
|
|
|
|
|
|
* 默认账号信息存放在 `exam_generator.py` 中
|
|
|
* 生成的题目文件会自动存放在 `exams/用户名/` 目录下
|
|
|
* Python 版本需 **>= 3.8**
|
|
|
|
|
|
---
|
|
|
|
|
|
## 发布与运行（Release 版本）
|
|
|
|
|
|
### Windows 平台
|
|
|
|
|
|
1. 打包：
|
|
|
|
|
|
```bash
|
|
|
pyinstaller --onefile main.py
|
|
|
```
|
|
|
|
|
|
生成的 `main.exe` 位于 `dist/` 目录。
|
|
|
|
|
|
2. 运行方式：
|
|
|
|
|
|
```bash
|
|
|
main.exe
|
|
|
```
|
|
|
|
|
|
### Linux 平台
|
|
|
|
|
|
1. 打包：
|
|
|
|
|
|
```bash
|
|
|
pyinstaller --onefile main.py
|
|
|
```
|
|
|
|
|
|
生成的可执行文件在 `dist/main`。
|
|
|
|
|
|
2. 运行方式：
|
|
|
|
|
|
```bash
|
|
|
./main
|
|
|
```
|
|
|
|
|
|
* 确保执行权限：`chmod +x main`
|
|
|
* 注意 Linux 路径分隔符为 `/`
|
|
|
|
|
|
---
|
|
|
|
|
|
## 参数设置
|
|
|
|
|
|
发布版本运行时，需要在交互过程中输入以下参数：
|
|
|
|
|
|
* **用户名**
|
|
|
|
|
|
* 例如：`张三1`
|
|
|
* 用于识别所属年级（小学/初中/高中）
|
|
|
|
|
|
* **密码**
|
|
|
|
|
|
* 默认均为 `123`（可在 `exam_generator.py` 中修改）
|
|
|
|
|
|
* **题目数量**
|
|
|
|
|
|
* 输入范围：`10 - 30`
|
|
|
* 系统会生成对应数量的题目
|
|
|
* 输入 `-1` 退出当前用户
|
|
|
|
|
|
* **切换难度**
|
|
|
|
|
|
* 输入 `切换为 小学` / `切换为 初中` / `切换为 高中`
|
|
|
* 可在运行中调整题目难度
|
|
|
|
|
|
---
|
|
|
|
|
|
## 开发环境 vs 发布环境
|
|
|
|
|
|
* **开发环境**：本地运行，需 Python >= 3.8
|
|
|
* **发布环境**：打包成可执行文件（Windows 为 `.exe`，Linux 为二进制文件），用户无需安装 Python
|
|
|
* **跨平台差异**：注意路径分隔符和执行权限的不同
|
|
|
|
|
|
---
|
