From d628c0778eee22a585dd8f5d13fa270fc9cd81df Mon Sep 17 00:00:00 2001
From: hnu202326010302 <1677625723@qq.com>
Date: Mon, 29 Sep 2025 18:16:50 +0800
Subject: [PATCH] ADD file via upload

---
 ...Š¨ç”Ÿæˆ�程åº� - Java版本说明文档.md | 234 ++++++++++++++++++
 1 file changed, 234 insertions(+)
 create mode 100644 doc/中�学数学��自动生�程� - Java版本说明文档.md

diff --git a/doc/中�学数学��自动生�程� - Java版本说明文档.md b/doc/中�学数学��自动生�程� - Java版本说明文档.md
new file mode 100644
index 0000000..62e39b3
--- /dev/null
+++ b/doc/中�学数学��自动生�程� - Java版本说明文档.md	
@@ -0,0 +1,234 @@
+
+
+# 中�学数学��自动生�程� - Java版本说明文档
+
+## 项目概述
+
+这是一个基于Java开�的中�学数学��自动生�程�，支��学��中和高中三个年级的数学题目生�，具有用户登录验��题目生��年级切�和试��存等功能。
+
+## 功能特性
+
+### 1. 用户登录验�
+
+- 支��学��中和高中�三个预设账�
+- 用户�和密�用空格隔开输入
+- 登录�功显示当�选择的出题年级
+- 登录失败�示�新输入
+
+### 2. 题目生�
+
+- **题目数�**：10-30题（或输入-1退出登录）
+- **�作数数�**：1-5个
+- **�作数范围**：1-100
+- **题目去�**：�一�师的题目�会与历�题目��
+
+### 3. 年级切�
+
+- 支�在登录状�下切�出题年级
+- 输入"切�为 XX"（XX为�学��中�高中）
+- 输入错误时�示�新输入
+
+### 4. 试��存
+
+- 按"年-月-日-时-分-秒.txt"格�命�
+- �个账�独立文件夹
+- 题目有��，�题间空一行
+
+## 年级难度�求
+
+### �学
+
+- 四则�算，结果�负
+
+### �中
+
+- 包�平方�开根��算
+- 题目中至少有一个平方或开根��算符
+
+### 高中
+
+- 包�三角函数（sin, cos, tan）
+- 题目中至少有一个三角函数
+
+## 使用�程
+
+### 登录界�
+
+```
+== 中�学数学��自动生�程� ==
+欢迎你 张三1 �学
+输入1开始出题
+输入2切�出题年级
+输入-1退出登录，返回开始界�
+```
+
+
+
+### 出题�程
+
+1. 输入1开始出题
+2. 输入题目数�（10-30）
+3. 系统生�对应年级难度的题目
+4. 题目显示并自动�存
+
+### 切�年级
+
+例如，切�为�中
+
+```
+2
+请输入想�切�的出题年级，输入-1返回�作界�
+�中
+已�功修改出题年级为�中，输入-1返回�作界�
+```
+
+### 登录过程
+
+
+
+```
+请输入用户�和密�（用空格分隔）：
+张三1 123
+登录�功�当�选择为�学出题
+
+== 中�学数学��自动生�程� ==
+欢迎你 张三1 �学
+输入1开始出题
+输入2切�出题年级
+输入-1退出登录，返回开始界�
+```
+
+
+
+### 题目生�示例
+
+
+
+```
+输入1开始出题
+准备生��学数学题目，请输入生�题目数�（输入-1将退出当�用户）：
+10
+
+正在为�学出题，请在10-30的范围内输入出题数目：
+
+1. 92 + 96 - (58 / 55 * 62)
+
+2. (24 * 13) * 34 + 15
+
+3. 68 - 55 - 57 / 85 / 71
+
+...
+
+已出题完�，输入-1返回�作界�
+```
+
+
+
+### 年级切�
+
+
+
+```
+输入2切�出题年级
+请输入想�切�的出题年级（�学��中�高中）：
+�中
+已�功修改出题年级为�中
+```
+
+
+
+## 文件�存格�
+
+### 目录结构
+
+```
+User-problem/
+├── 张三1/
+│   ├── 2025-09-29-22-30-45.txt
+│   └── 2025-09-29-22-35-20.txt
+├── �四2/
+│   └── 2025-09-29-22-40-15.txt
+```
+
+
+
+### 文件内容格�
+
+```
+1. 92 + 96 - (58 / 55 * 62)
+
+2. (24 * 13) * 34 + 15
+
+3. 68 - 55 - 57 / 85 / 71
+
+...
+```
+
+## 系统架构
+
+### 核心类说明
+
+#### 1. Main.java
+
+- **功能**: 程�主入�
+- **�责**: �动用户登录�程
+
+#### 2. User.java
+
+- **功能**: 用户管�类
+- **�责**:
+  - 处�用户登录验�
+  - 管�用户账户信�（用户��密��年级）
+  - �始化预设用户数�
+
+#### 3. ProblemManager.java
+
+- **功能**: 问题管�类
+- **�责**:
+  - 显示主界�
+  - 处�用户交互
+  - �调题目生��程
+  - �供年级切�功能
+
+#### 4. 题目生�器接�和实现类
+
+**MathProblemGenerator.java** (接�)
+
+- 定义题目生�器的统一接�
+
+**PrimarySchoolProblemGenerator.java** (�学题目生�器)
+
+- 生�包�基本四则�算的题目
+
+**MiddleSchoolProblemGenerator.java** (�中题目生�器)
+
+- 在�学基础上增加平方(²)和开方(√)�算
+
+**HighSchoolProblemGenerator.java** (高中题目生�器)
+
+- 在�中基础上增加三角函数(sin, cos, tan)�算
+
+#### 5. 工具类
+
+**ExpressionJudge.java**
+
+- **功能**: 表达�验�工具
+- **�责**: 检测数学表达�中的语法错误和语义错误
+
+**FileManager.java**
+
+- **功能**: 文件管�工具
+- **�责**: 处�用户题目文件的读写�作
+
+**TimeManager.java**
+
+- **功能**: 时间管�工具
+- **�责**: �供时间戳生�功能
+
+## 已知问题：除零错误
+
+### 问题�述
+
+在生��中高中题目时，存在**生�除零��**的风险。
+
+在生��中高中题目时，生�有5个�作数的��概率比较低，�能一次出题�会有，�多次出题�会出现。
\ No newline at end of file