From 2ca957b7ca32c1814bcc36a77fa5ea4a866114f0 Mon Sep 17 00:00:00 2001 From: hnu202326010322 <1463365450@qq.com> Date: Mon, 29 Sep 2025 15:56:58 +0800 Subject: [PATCH 1/4] Update README.md --- doc/README.md | 99 ++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 98 insertions(+), 1 deletion(-) diff --git a/doc/README.md b/doc/README.md index 8d16069..bf008b7 100644 --- a/doc/README.md +++ b/doc/README.md @@ -1,2 +1,99 @@ -# math_qustion +# 中小学数学卷子自动生成程序 +## 一、项目概述 + +### 1.1 项目简介 +本项目是一个中小学数学卷子自动生成程序，可以根据不同学段（小学、初中、高中）自动生成符合知识难度的数学题目，并支持题目去重、保存为文件、用户登录验证等功能。程序的核心目标是帮助教师快速生成练习题卷，减轻出题负担，提高教学效率。 + +### 1.2 功能特点 +- 用户登录与权限管理：不同学段用户账号独立，防止越权生成题目。 +- 分学段题目生成：根据小学、初中、高中难度生成对应题目。 +- 随机出题：每次生成的题目随机，保证练习多样性。 +- 题目去重：检查历史题目，避免重复出题。 +- 文件保存：自动按用户、学段、时间生成规范文件名保存题目。 + +--- + +## 二、系统结构 + +### 2.1 目录结构 +``` +中小学数学卷子自动生成程序/ +├── src +│ ├── main.py # 程序入口，控制整体流程 +│ ├── user_manager.py # 用户管理与身份验证 +│ ├── file_handler.py # 文件读写与查重 +│ └── question_generator.py # 分学段数学题目生成 +├── doc +│ ├── README.md +│ └── 个人项目使用大模型后人工修改代码一览表/ +└── README.md # 项目总说明 +``` + +### 2.2 核心模块 +| 模块文件 | 功能描述 | +|----------------------|----------| +| main.py | 程序入口，实现登录、出题数量输入、学段切换、题目生成与保存流程 | +| user_manager.py | 管理用户账号、密码及对应学段，提供登录验证功能 | +| file_handler.py | 管理用户文件夹、题目文件保存、历史题目读取与查重 | +| question_generator.py| 根据学段生成数学题目，支持基础运算、函数、三角函数等题型 | + +--- + +## 三、运行说明 + +### 3.1 运行环境 +- 操作系统：Windows 7/8/10/11 系统 +- 无需安装 Python 环境，直接运行可执行文件即可 + +### 3.2 运行步骤 +1. #### 启动程序 #### +- 双击运行 main.exe 文件，程序将在 Windows 终端中启动 +2. #### 登录流程 #### +- 程序启动后，会提示输入用户名和密码（格式：用户名 密码，中间用空格分隔） +- 输入正确的用户名和密码后，程序会显示当前账户对应的题目难度 +1. #### 生成题目 #### +- 登录成功后，程序会提示输入生成题目数量（10-30 道之间） +- 输入符合要求的数字（10-30），程序将自动生成对应数量的题目 +- 生成完成后，题目会保存到以用户名命名的文件夹（如张三1_questions/）下的文本文件中 +- 程序会预览前 3 道题目，并显示保存路径 +4. #### 切换难度 #### +- 在输入题目数量的提示下，可输入以下指令切换题目难度： + (1)输入 "切换为小学"：生成小学难度题目（包含 +、-、*、/ 和括号） + (2)输入 "切换为初中"：生成初中难度题目（包含平方、开根号及小学难度所有运算） + (3)输入 "切换为高中"：生成高中难度题目（包含 sin、cos、tan 三角函数及初中难度所有运算） +5. #### 退出登录 #### +- 在输入题目数量的提示下，输入 "-1" 可退出当前用户登录，返回初始登录界面 + +### 3.3 预设用户 +| 用户名 | 密码 | 学段 | +|--------|------|------| +| 张三1 | 123 | 小学 | +| 张三2 | 123 | 小学 | +| 张三3 | 123 | 小学 | +| 李四1 | 123 | 初中 | +| 李四2 | 123 | 初中 | +| 李四3 | 123 | 初中 | +| 王五1 | 123 | 高中 | +| 王五2 | 123 | 高中 | +| 王五3 | 123 | 高中 | + +--- + +## 四、文件保存说明 +- 生成的题目文件会保存在程序运行目录下的[用户名]_questions文件夹中 +- 文件名格式为[当前时间]_[难度类型].txt，例如2023-10-01-15-30-45_小学.txt +- 每个题目文件中包含生成的所有题目，每题带有题号，题目之间用空行分隔 + +## 五、开发协作规范 + +### 5.1 分支管理 +- **main**：稳定版本，仅合并测试通过的代码 +- **develop**：开发主线，集成最新功能 + +## 六、 注意事项 +1. 用户名可以包含空格，但密码不能包含空格 +2. 题目数量必须在 10-30 道之间，否则会提示输入无效 +3. 程序会自动检查重复题目，确保生成的题目与历史题目不重复 +4. 生成的除法题目保证除数不为 0 且能整除，避免出现小数结果 +5. 若程序运行过程中出现错误，会在终端中显示错误信息 \ No newline at end of file -- 2.34.1 From 8c3f0d416d4b78e745f4a4f21c04366e086ebe2b Mon Sep 17 00:00:00 2001 From: hnu202326010322 <1463365450@qq.com> Date: Mon, 29 Sep 2025 16:05:28 +0800 Subject: [PATCH 2/4] =?UTF-8?q?=E5=88=A0=E9=99=A4=20'README.md'?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 2 -- 1 file changed, 2 deletions(-) delete mode 100644 README.md diff --git a/README.md b/README.md deleted file mode 100644 index 8d16069..0000000 --- a/README.md +++ /dev/null @@ -1,2 +0,0 @@ -# math_qustion - -- 2.34.1 From 5f9cf30afbf851a0535b15da50dc7aecbbe8ccb2 Mon Sep 17 00:00:00 2001 From: hnu202326010322 <1463365450@qq.com> Date: Mon, 29 Sep 2025 16:05:46 +0800 Subject: [PATCH 3/4] =?UTF-8?q?=E5=88=A0=E9=99=A4=20'doc/README.md'?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- doc/README.md | 99 --------------------------------------------------- 1 file changed, 99 deletions(-) delete mode 100644 doc/README.md diff --git a/doc/README.md b/doc/README.md deleted file mode 100644 index bf008b7..0000000 --- a/doc/README.md +++ /dev/null @@ -1,99 +0,0 @@ -# 中小学数学卷子自动生成程序 - -## 一、项目概述 - -### 1.1 项目简介 -本项目是一个中小学数学卷子自动生成程序，可以根据不同学段（小学、初中、高中）自动生成符合知识难度的数学题目，并支持题目去重、保存为文件、用户登录验证等功能。程序的核心目标是帮助教师快速生成练习题卷，减轻出题负担，提高教学效率。 - -### 1.2 功能特点 -- 用户登录与权限管理：不同学段用户账号独立，防止越权生成题目。 -- 分学段题目生成：根据小学、初中、高中难度生成对应题目。 -- 随机出题：每次生成的题目随机，保证练习多样性。 -- 题目去重：检查历史题目，避免重复出题。 -- 文件保存：自动按用户、学段、时间生成规范文件名保存题目。 - ---- - -## 二、系统结构 - -### 2.1 目录结构 -``` -中小学数学卷子自动生成程序/ -├── src -│ ├── main.py # 程序入口，控制整体流程 -│ ├── user_manager.py # 用户管理与身份验证 -│ ├── file_handler.py # 文件读写与查重 -│ └── question_generator.py # 分学段数学题目生成 -├── doc -│ ├── README.md -│ └── 个人项目使用大模型后人工修改代码一览表/ -└── README.md # 项目总说明 -``` - -### 2.2 核心模块 -| 模块文件 | 功能描述 | -|----------------------|----------| -| main.py | 程序入口，实现登录、出题数量输入、学段切换、题目生成与保存流程 | -| user_manager.py | 管理用户账号、密码及对应学段，提供登录验证功能 | -| file_handler.py | 管理用户文件夹、题目文件保存、历史题目读取与查重 | -| question_generator.py| 根据学段生成数学题目，支持基础运算、函数、三角函数等题型 | - ---- - -## 三、运行说明 - -### 3.1 运行环境 -- 操作系统：Windows 7/8/10/11 系统 -- 无需安装 Python 环境，直接运行可执行文件即可 - -### 3.2 运行步骤 -1. #### 启动程序 #### -- 双击运行 main.exe 文件，程序将在 Windows 终端中启动 -2. #### 登录流程 #### -- 程序启动后，会提示输入用户名和密码（格式：用户名 密码，中间用空格分隔） -- 输入正确的用户名和密码后，程序会显示当前账户对应的题目难度 -1. #### 生成题目 #### -- 登录成功后，程序会提示输入生成题目数量（10-30 道之间） -- 输入符合要求的数字（10-30），程序将自动生成对应数量的题目 -- 生成完成后，题目会保存到以用户名命名的文件夹（如张三1_questions/）下的文本文件中 -- 程序会预览前 3 道题目，并显示保存路径 -4. #### 切换难度 #### -- 在输入题目数量的提示下，可输入以下指令切换题目难度： - (1)输入 "切换为小学"：生成小学难度题目（包含 +、-、*、/ 和括号） - (2)输入 "切换为初中"：生成初中难度题目（包含平方、开根号及小学难度所有运算） - (3)输入 "切换为高中"：生成高中难度题目（包含 sin、cos、tan 三角函数及初中难度所有运算） -5. #### 退出登录 #### -- 在输入题目数量的提示下，输入 "-1" 可退出当前用户登录，返回初始登录界面 - -### 3.3 预设用户 -| 用户名 | 密码 | 学段 | -|--------|------|------| -| 张三1 | 123 | 小学 | -| 张三2 | 123 | 小学 | -| 张三3 | 123 | 小学 | -| 李四1 | 123 | 初中 | -| 李四2 | 123 | 初中 | -| 李四3 | 123 | 初中 | -| 王五1 | 123 | 高中 | -| 王五2 | 123 | 高中 | -| 王五3 | 123 | 高中 | - ---- - -## 四、文件保存说明 -- 生成的题目文件会保存在程序运行目录下的[用户名]_questions文件夹中 -- 文件名格式为[当前时间]_[难度类型].txt，例如2023-10-01-15-30-45_小学.txt -- 每个题目文件中包含生成的所有题目，每题带有题号，题目之间用空行分隔 - -## 五、开发协作规范 - -### 5.1 分支管理 -- **main**：稳定版本，仅合并测试通过的代码 -- **develop**：开发主线，集成最新功能 - -## 六、 注意事项 -1. 用户名可以包含空格，但密码不能包含空格 -2. 题目数量必须在 10-30 道之间，否则会提示输入无效 -3. 程序会自动检查重复题目，确保生成的题目与历史题目不重复 -4. 生成的除法题目保证除数不为 0 且能整除，避免出现小数结果 -5. 若程序运行过程中出现错误，会在终端中显示错误信息 \ No newline at end of file -- 2.34.1 From 5e2ed8cf12f179d0a401d4ec622368b8813632d9 Mon Sep 17 00:00:00 2001 From: hnu202326010322 <1463365450@qq.com> Date: Mon, 29 Sep 2025 16:06:03 +0800 Subject: [PATCH 4/4] =?UTF-8?q?=E4=B8=8A=E4=BC=A0=E6=96=87=E4=BB=B6?= =?UTF-8?q?=E8=87=B3=20'doc'?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- doc/README.md | 99 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 99 insertions(+) create mode 100644 doc/README.md diff --git a/doc/README.md b/doc/README.md new file mode 100644 index 0000000..ca48975 --- /dev/null +++ b/doc/README.md @@ -0,0 +1,99 @@ +# 中小学数学卷子自动生成程序 + +## 一、项目概述 + +### 1.1 项目简介 +本项目是一个中小学数学卷子自动生成程序，可以根据不同学段（小学、初中、高中）自动生成符合知识难度的数学题目，并支持题目去重、保存为文件、用户登录验证等功能。程序的核心目标是帮助教师快速生成练习题卷，减轻出题负担，提高教学效率。 + +### 1.2 功能特点 +- 用户登录与权限管理：不同学段用户账号独立，防止越权生成题目。 +- 分学段题目生成：根据小学、初中、高中难度生成对应题目。 +- 随机出题：每次生成的题目随机，保证练习多样性。 +- 题目去重：检查历史题目，避免重复出题。 +- 文件保存：自动按用户、学段、时间生成规范文件名保存题目。 + +--- + +## 二、系统结构 + +### 2.1 目录结构 +``` +中小学数学卷子自动生成程序/ +├── src +│ ├── main.py # 程序入口，控制整体流程 +│ ├── user_manager.py # 用户管理与身份验证 +│ ├── file_handler.py # 文件读写与查重 +│ └── question_generator.py # 分学段数学题目生成 +├── doc +│ ├── README.md +│ └── 个人项目使用大模型后人工修改代码一览表/ +└── README.md # 项目总说明 +``` + +### 2.2 核心模块 +| 模块文件 | 功能描述 | +|----------------------|----------| +| main.py | 程序入口，实现登录、出题数量输入、学段切换、题目生成与保存流程 | +| user_manager.py | 管理用户账号、密码及对应学段，提供登录验证功能 | +| file_handler.py | 管理用户文件夹、题目文件保存、历史题目读取与查重 | +| question_generator.py| 根据学段生成数学题目，支持基础运算、函数、三角函数等题型 | + +--- + +## 三、运行说明 + +### 3.1 运行环境 +- 操作系统：Windows 7/8/10/11 系统 +- 无需安装 Python 环境，直接运行可执行文件即可 + +### 3.2 运行步骤 +1. #### 启动程序 #### +- 双击运行 main.exe 文件，程序将在 Windows 终端中启动 +2. #### 登录流程 #### +- 程序启动后，会提示输入用户名和密码（格式：用户名 密码，中间用空格分隔） +- 输入正确的用户名和密码后，程序会显示当前账户对应的题目难度 +1. #### 生成题目 #### +- 登录成功后，程序会提示输入生成题目数量（10-30 道之间） +- 输入符合要求的数字（10-30），程序将自动生成对应数量的题目 +- 生成完成后，题目会保存到以用户名命名的文件夹（如张三1_questions/）下的文本文件中 +- 程序会预览前 3 道题目，并显示保存路径 +4. #### 切换难度 #### +- 在输入题目数量的提示下，可输入以下指令切换题目难度： + (1)输入 "切换为小学"：生成小学难度题目（包含 +、-、*、/ 和括号） + (2)输入 "切换为初中"：生成初中难度题目（包含平方、开根号及小学难度所有运算） + (3)输入 "切换为高中"：生成高中难度题目（包含 sin、cos、tan 三角函数及初中难度所有运算） +5. #### 退出登录 #### +- 在输入题目数量的提示下，输入 "-1" 可退出当前用户登录，返回初始登录界面 + +### 3.3 预设用户 +| 用户名 | 密码 | 学段 | +|--------|------|------| +| 张三1 | 123 | 小学 | +| 张三2 | 123 | 小学 | +| 张三3 | 123 | 小学 | +| 李四1 | 123 | 初中 | +| 李四2 | 123 | 初中 | +| 李四3 | 123 | 初中 | +| 王五1 | 123 | 高中 | +| 王五2 | 123 | 高中 | +| 王五3 | 123 | 高中 | + +--- + +## 四、文件保存说明 +- 生成的题目文件会保存在程序运行目录下的[用户名]_questions文件夹中 +- 文件名格式为[当前时间]_[难度类型].txt，例如2023-10-01-15-30-45_小学.txt +- 每个题目文件中包含生成的所有题目，每题带有题号，题目之间用空行分隔 + +## 五、开发协作规范 + +### 5.1 分支管理 +- **main**：稳定版本，仅合并测试通过的代码 +- **develop**：开发主线，集成最新功能 + +## 六、 注意事项 +1. 用户名可以包含空格，但密码不能包含空格 +2. 题目数量必须在 10-30 道之间，否则会提示输入无效 +3. 程序会自动检查重复题目，确保生成的题目与历史题目不重复 +4. 生成的除法题目保证除数不为 0 且能整除，避免出现小数结果 +5. 若程序运行过程中出现错误，会在终端中显示错误信息 \ No newline at end of file -- 2.34.1