final3 代码规范检查完毕

MathPuzzle.iml

@@ -1,5 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <module type="JAVA_MODULE" version="4">
+  <component name="CheckStyle-IDEA-Module" serialisationVersion="2">
+    <option name="activeLocationsIds" />
+  </component>
   <component name="NewModuleRootManager" inherit-compiler-output="true">
     <exclude-output />
     <content url="file://$MODULE_DIR$">

src/mathpuzzle/Main.java

@@ -2,10 +2,28 @@ package mathpuzzle;
 
 import mathpuzzle.controller.StartController;
 
+/**
+ * 程序主入口类，启动数学题目生成系统。
+ *
+ * <p>该类包含main方法，作为程序的入口点，负责启动整个数学题目生成系统。
+ * 系统启动后会初始化控制器并开始处理用户交互。
+ *
+ * @author 杨博文
+ * @version 1.0
+ * @since 2025
+ */
 public class Main {
 
+  /**
+   * 程序主入口方法。
+   *
+   * <p>该方法创建启动控制器实例并调用start方法，
+   * 启动整个数学题目生成系统的主循环。
+   *
+   * @param args 命令行参数（当前未使用）
+   */
   public static void main(String[] args) {
     StartController startController = new StartController();
     startController.start();
   }
-}
+}

src/mathpuzzle/controller/StartController.java

@@ -13,12 +13,32 @@ import mathpuzzle.service.QuestionGenerator;
 import mathpuzzle.service.SeniorHighGenerator;
 import mathpuzzle.system.LogSystem;
 
+/**
+ * 启动控制器，负责整个数学题目生成系统的主流程控制。
+ *
+ * <p>该控制器处理用户登录、题目生成数量输入、题目生成逻辑以及用户级别切换等功能。
+ *
+ * @author 杨博文
+ * @version 1.0
+ * @since 2025
+ */
 public class StartController {
 
+  /** 日志系统，用于用户登录和管理。 */
   private LogSystem logSystem = new LogSystem();
+
+  /** 去重器，用于避免生成重复的数学题目。 */
   private QuestionDeduplicator deduplicator = new QuestionDeduplicator();
+
+  /** 文件处理器，用于保存生成的题目试卷。 */
   private FileHandler fileHandler = new FileHandler();
 
+  /**
+   * 启动整个数学题目生成系统。
+   *
+   * <p>该方法实现系统主循环，包括用户登录、题目生成和用户级别切换功能。
+   * 系统会持续运行直到程序被终止。
+   */
   public void start() {
 
     logSystem.userHashMapInit();
@@ -52,6 +72,15 @@ public class StartController {
     }
   }
 
+  /**
+   * 处理用户级别切换功能。
+   *
+   * <p>当用户输入格式为"切换为XX"的指令时，该方法会解析并切换用户的学习级别。
+   * 支持的级别包括：小学、初中、高中。
+   *
+   * @param user 当前登录的用户对象
+   * @param input 用户输入的字符串
+   */
   private void handleLevelSwitch(User user, String input) {
     if (input.startsWith("切换为")) {
       String newLevel = input.substring(3);
@@ -65,6 +94,14 @@ public class StartController {
     }
   }
 
+  /**
+   * 根据指定的级别创建对应的题目生成器。
+   *
+   * <p>该方法根据用户选择的教育级别返回相应的题目生成器实例。
+   *
+   * @param level 教育级别，支持"小学"、"初中"、"高中"
+   * @return 对应级别的题目生成器实例，如果级别不支持则返回null
+   */
   private QuestionGenerator createGenerator(String level) {
     switch (level) {
       case "小学":
@@ -78,6 +115,16 @@ public class StartController {
     }
   }
 
+  /**
+   * 处理题目生成逻辑，包括去重和保存功能。
+   *
+   * <p>该方法负责生成指定数量的不重复数学题目，使用去重器避免与历史题目重复，
+   * 并将生成的题目保存到文件中。
+   *
+   * @param user 当前用户对象
+   * @param count 需要生成的题目数量
+   * @throws IOException 当文件保存过程中发生错误时抛出
+   */
   // 处理题目生成，进行去重工作
   private void handleQuestionGeneration(User user, int count) throws IOException {
     QuestionGenerator generator = createGenerator(user.getLevel());
@@ -104,8 +151,8 @@ public class StartController {
 
       String newQuestion = tempQuestions.get(0);
       // 移除末尾的 " =" 以便查重更准确（可选，取决于你如何存储历史题）
-      String questionForDedup = newQuestion.endsWith(" =") ?
-          newQuestion.substring(0, newQuestion.length() - 2) : newQuestion;
+      String questionForDedup = newQuestion.endsWith(" =")
+          ? newQuestion.substring(0, newQuestion.length() - 2) : newQuestion;
 
       if (!deduplicator.isDuplicate(questionForDedup)) {
         // 题目不重复，加入最终列表和查重集
@@ -130,4 +177,4 @@ public class StartController {
     fileHandler.savePaper(user, finalQuestions);
     System.out.println("试卷已成功保存！");
   }
-}
+}

src/mathpuzzle/entity/User.java

@@ -1,30 +1,72 @@
 package mathpuzzle.entity;
 
+/**
+ * 用户实体类，表示系统中的用户信息。
+ *
+ * <p>该类包含用户的基本信息，如用户名、密码和学习级别。
+ * 用户级别可以是小学、初中或高中。
+ *
+ * @author 杨博文
+ * @version 1.0
+ * @since 2025
+ */
 public class User {
 
+  /** 用户名，不可修改。 */
   private final String name;
+
+  /** 用户密码，不可修改。 */
   private final String password;
+
+  /** 用户当前的学习级别，可以修改。 */
   private String level;
 
+  /**
+   * 构造一个新的用户对象。
+   *
+   * @param name 用户名，不能为空
+   * @param password 用户密码，不能为空
+   * @param level 用户学习级别，支持"小学"、"初中"、"高中"
+   */
   public User(String name, String password, String level) {
     this.name = name;
     this.password = password;
     this.level = level;
   }
 
+  /**
+   * 获取用户名。
+   *
+   * @return 用户名
+   */
   public String getName() {
     return name;
   }
 
+  /**
+   * 获取用户密码。
+   *
+   * @return 用户密码
+   */
   public String getPassword() {
     return password;
   }
 
+  /**
+   * 获取用户当前的学习级别。
+   *
+   * @return 用户学习级别
+   */
   public String getLevel() {
     return level;
   }
 
+  /**
+   * 设置用户的学习级别。
+   *
+   * @param newLevel 新的学习级别，支持"小学"、"初中"、"高中"
+   */
   public void setLevel(String newLevel) {
     level = newLevel;
   }
-}
+}

src/mathpuzzle/service/CaculatePrimary.java

@@ -7,12 +7,35 @@ import java.util.List;
 import java.util.Map;
 import java.util.Stack;
 
+/**
+ * 小学数学表达式计算器，用于计算小学级别的数学表达式。
+ *
+ * <p>该类使用双栈算法实现中缀表达式的计算，支持加减乘除四则运算和括号。
+ * 运算符优先级：乘除高于加减，括号具有最高优先级。
+ *
+ * @author 杨博文
+ * @version 1.0
+ * @since 2025
+ */
 public class CaculatePrimary {
 
+  /** 数字栈，用于存储操作数。 */
   private final Stack<Double> numStack = new Stack<>();
+
+  /** 操作符栈，用于存储运算符和括号。 */
   private final Stack<String> opStack = new Stack<>();
+
+  /** 运算符优先级映射表，数字越大优先级越高。 */
   private final Map<String, Integer> precedence = new HashMap<>();
 
+  /**
+   * 计算给定的数学表达式。
+   *
+   * <p>该方法使用双栈算法计算表达式的值，支持四则运算和括号。
+   *
+   * @param expression 表达式元素列表，包含数字、运算符和括号
+   * @return 表达式的计算结果
+   */
   public double caculate(List<String> expression) {
     precedence.put("+", 1);
     precedence.put("-", 1);
@@ -42,6 +65,12 @@ public class CaculatePrimary {
     return numStack.pop();
   }
 
+  /**
+   * 执行一次基本的二元运算操作。
+   *
+   * <p>从数字栈中弹出两个操作数，从操作符栈中弹出一个运算符，
+   * 执行相应的运算，并将结果压入数字栈。
+   */
   public void doCaculte() {
     String op = opStack.pop();
     double num2 = numStack.pop();
@@ -63,5 +92,4 @@ public class CaculatePrimary {
         break;
     }
   }
-}
-
+}

src/mathpuzzle/service/FileHandler.java

@@ -1,6 +1,6 @@
 package mathpuzzle.service;
 
-import mathpuzzle.entity.User;
+
 import java.io.BufferedWriter;
 import java.io.FileWriter;
 import java.io.IOException;
@@ -10,12 +10,29 @@ import java.nio.file.Paths;
 import java.time.LocalDateTime;
 import java.time.format.DateTimeFormatter;
 import java.util.List;
+import mathpuzzle.entity.User;
 
 /**
- * 文件处理器 负责创建用户目录和保存试卷文件
+ * 文件处理器，负责创建用户目录和保存试卷文件。
+ *
+ * <p>该类提供用户目录管理功能和试卷文件保存功能。
+ * 每次生成的试卷会以时间戳命名保存到对应用户的目录中。
+ *
+ * @author 杨博文
+ * @version 1.0
+ * @since 2025
  */
 public class FileHandler {
 
+  /**
+   * 确保用户目录存在，如果不存在则创建。
+   *
+   * <p>该方法检查用户对应的目录是否存在，如果不存在则创建该目录。
+   * 用户目录以用户名命名，位于当前工作目录下。
+   *
+   * @param user 需要创建目录的用户对象
+   * @throws IOException 当目录创建过程中发生错误时抛出
+   */
   public void ensureUserDirectory(User user) throws IOException {
     String dirPath = "./" + user.getName();
     Path path = Paths.get(dirPath);
@@ -24,6 +41,16 @@ public class FileHandler {
     }
   }
 
+  /**
+   * 保存试卷到用户目录中。
+   *
+   * <p>该方法将生成的题目列表保存到文件中，文件名包含时间戳信息，
+   * 以确保每次生成的试卷都有唯一的文件名。每个题目前添加题号， 题目之间用空行分隔。
+   *
+   * @param user      试卷所属的用户对象
+   * @param questions 需要保存的题目列表
+   * @throws IOException 当文件写入过程中发生错误时抛出
+   */
   public void savePaper(User user, List<String> questions) throws IOException {
     ensureUserDirectory(user);
     // 生成文件名：年-月-日-时-分-秒.txt
@@ -39,4 +66,4 @@ public class FileHandler {
       }
     }
   }
-}
+}

src/mathpuzzle/service/JuniorHighGenerator.java

@@ -7,12 +7,30 @@ import java.util.List;
 import java.util.Random;
 
 /**
- * 初中题目生成器 题目必须包含至少一个平方或开根号运算符
+ * 初中题目生成器，负责生成包含平方或开根号运算的初中级别数学题目。
+ *
+ * <p>该生成器确保每道题目都包含至少一个高级运算符（平方或开根号），
+ * 题目结构包含基本的四则运算和高级运算的组合。
+ *
+ * @author 杨博文
+ * @version 1.0
+ * @since 2025
  */
 public class JuniorHighGenerator implements QuestionGenerator {
 
+  /**
+   * 高级运算符数组，包含"平方"和"开根号"。
+   */
   private static final String[] ADVANCED_OPS = {"平方", "开根号"};
+
+  /**
+   * 基本运算符数组，包含四则运算符号。
+   */
   private static final String[] OPERATORS = {"+", "-", "*", "/"};
+
+  /**
+   * 随机数生成器，用于生成随机题目。
+   */
   private final Random random = new Random();
 
   @Override
@@ -25,6 +43,14 @@ public class JuniorHighGenerator implements QuestionGenerator {
     return questions;
   }
 
+  /**
+   * 生成单个初中级别的数学题目。
+   *
+   * <p>该方法确保生成的题目包含至少一个高级运算符（平方或开根号），
+   * 并根据操作数数量采用不同的生成策略。
+   *
+   * @return 生成的数学题目字符串
+   */
   private String generateSingleQuestion() {
     List<String> parts = new ArrayList<>();
     int operandCount = random.nextInt(5) + 1;
@@ -46,9 +72,7 @@ public class JuniorHighGenerator implements QuestionGenerator {
           // 随机数看取出来的是不是开根号运算符
           if ("开根号".equals(ADVANCED_OPS[random.nextInt(ADVANCED_OPS.length)])) {
             parts = generateRoot(parts, i);
-          }
-          // 如果不是开根号就是平方运算
-          else {
+          } else { // 如果不是开根号就是平方运算
             parts = generateSquare(parts, i);
           }
           hasAdvancedOp = true;
@@ -63,7 +87,15 @@ public class JuniorHighGenerator implements QuestionGenerator {
     return String.join(" ", parts) + " =";
   }
 
-  // 产生基本操作
+  /**
+   * 生成基本的四则运算表达式部分。
+   *
+   * <p>该方法生成指定数量的操作数和运算符，构成基础的数学表达式。
+   *
+   * @param operandCount 操作数的数量
+   * @param parts        用于存储表达式各部分的列表
+   * @return 包含基本运算表达式的列表
+   */
   public List<String> generateBase(int operandCount, List<String> parts) {
     for (int i = 0; i < operandCount; i++) {
       int num = random.nextInt(100) + 1;
@@ -75,7 +107,15 @@ public class JuniorHighGenerator implements QuestionGenerator {
     return parts;
   }
 
-  // 强制加入一个高级运算符
+  /**
+   * 强制在表达式中添加一个高级运算符作为保底机制。
+   *
+   * <p>当随机生成过程中没有添加高级运算符时，使用此方法确保
+   * 每道题目都包含至少一个高级运算符。
+   *
+   * @param parts 包含表达式各部分的列表
+   * @return 添加了高级运算符的表达式列表
+   */
   public List<String> forceAddAdvancedOp(List<String> parts) {
     String advancedOp = ADVANCED_OPS[random.nextInt(ADVANCED_OPS.length)];
     if ("平方".equals(advancedOp)) {
@@ -87,6 +127,16 @@ public class JuniorHighGenerator implements QuestionGenerator {
     return parts;
   }
 
+  /**
+   * 在指定位置生成开根号运算。
+   *
+   * <p>该方法在表达式指定位置添加开根号运算，可能只对单个操作数
+   * 进行开根号，或者对一段子表达式进行开根号。
+   *
+   * @param parts 包含表达式各部分的列表
+   * @param i     开根号运算的起始位置
+   * @return 添加了开根号运算的表达式列表
+   */
   public List<String> generateRoot(List<String> parts, int i) {
     if (random.nextBoolean()) {
       parts.set(i, "开根号(" + parts.get(i) + ")");
@@ -108,6 +158,15 @@ public class JuniorHighGenerator implements QuestionGenerator {
     return parts;
   }
 
+  /**
+   * 在指定位置生成平方运算。
+   *
+   * <p>该方法在表达式指定位置添加平方运算，对一段子表达式进行平方运算。
+   *
+   * @param parts 包含表达式各部分的列表
+   * @param i     平方运算的起始位置
+   * @return 添加了平方运算的表达式列表
+   */
   public List<String> generateSquare(List<String> parts, int i) {
     parts.set(i, "(" + parts.get(i));
     // 为避免随机数上限出现0，此处要单独判断一下左括号正好括住倒数第二个操作数的情况
@@ -124,4 +183,4 @@ public class JuniorHighGenerator implements QuestionGenerator {
     }
     return parts;
   }
-}
+}

src/mathpuzzle/service/PrimarySchoolGenerator.java

@@ -5,11 +5,21 @@ import java.util.List;
 import java.util.Random;
 
 /**
- * 小学题目生成器 题目仅包含 +, -, *, / 和 ()
+ * 小学题目生成器，负责生成包含四则运算和括号的小学级别数学题目。
+ *
+ * <p>该生成器专门用于生成适合小学生的数学题目，题目仅包含加减乘除四则运算
+ * 和括号，确保计算结果为非负数。
+ *
+ * @author 杨博文
+ * @version 1.0
+ * @since 2025
  */
 public class PrimarySchoolGenerator implements QuestionGenerator {
 
+  /** 运算符数组，包含四则运算符号。 */
   private static final String[] OPERATORS = {"+", "-", "*", "/"};
+
+  /** 随机数生成器，用于生成随机题目。 */
   private final Random random = new Random();
 
   @Override
@@ -22,6 +32,14 @@ public class PrimarySchoolGenerator implements QuestionGenerator {
     return questions;
   }
 
+  /**
+   * 生成单个小级别的数学题目.
+   *
+   * <p>该方法生成包含2-5个操作数的四则运算表达式，可能包含括号，
+   * 并确保计算结果为非负数。如果计算结果为负数，则重新生成。
+   *
+   * @return 生成的小学数学题目字符串
+   */
   private String generateSingleQuestion() {
     CaculatePrimary caculatePrimary = new CaculatePrimary();
     int operandCount = random.nextInt(4) + 2; // 2-5个操作数
@@ -61,6 +79,14 @@ public class PrimarySchoolGenerator implements QuestionGenerator {
     }
   }
 
+  /**
+   * 判断给定字符串是否为数字。
+   *
+   * <p>该方法检查字符串是否可以转换为数字格式。
+   *
+   * @param str 待检查的字符串
+   * @return 如果字符串是数字则返回true，否则返回false
+   */
   public static boolean isNumeric(String str) {
     if (str == null || str.isEmpty()) {
       return false;
@@ -73,6 +99,15 @@ public class PrimarySchoolGenerator implements QuestionGenerator {
     }
   }
 
+  /**
+   * 生成基本的四则运算表达式部分。
+   *
+   * <p>该方法生成指定数量的操作数和运算符，构成基础的数学表达式。
+   *
+   * @param operandCount 操作数的数量
+   * @param parts 用于存储表达式各部分的列表
+   * @return 包含基本运算表达式的列表
+   */
   public List<String> generateBase(int operandCount, List<String> parts) {
     for (int i = 0; i < operandCount; i++) {
       int num = random.nextInt(100) + 1;
@@ -83,6 +118,4 @@ public class PrimarySchoolGenerator implements QuestionGenerator {
     }
     return parts;
   }
-
-
 }

src/mathpuzzle/service/QuestionDeduplicator.java

@@ -4,17 +4,35 @@ import java.io.BufferedReader;
 import java.io.File;
 import java.io.FileReader;
 import java.io.IOException;
-import mathpuzzle.entity.User;
 import java.util.HashSet;
 import java.util.Set;
+import mathpuzzle.entity.User;
 
 /**
- * 题目查重器 负责加载历史题目并检查新题目是否重复
+ * 题目查重器，负责加载历史题目并检查新题目是否重复。
+ *
+ * <p>该类维护一个题目集合，用于检测当前生成的题目是否与用户的历史题目重复。
+ * 通过加载用户目录下的所有历史试卷文件，提取题目内容进行去重检查。
+ *
+ * @author 杨博文
+ * @version 1.0
+ * @since 2025
  */
 public class QuestionDeduplicator {
 
+  /**
+   * 存储用户历史题目的集合。
+   */
   private final Set<String> existingQuestions = new HashSet<>();
 
+  /**
+   * 加载指定用户的所有历史题目。
+   *
+   * <p>该方法遍历用户目录下的所有.txt文件，读取并解析题目内容，
+   * 将历史题目添加到去重集合中。此操作会清空之前的题目记录。
+   *
+   * @param user 需要加载历史题目的用户对象
+   */
   public void loadExistingQuestions(User user) {
     existingQuestions.clear();
     String userDir = "./" + user.getName();
@@ -25,9 +43,9 @@ public class QuestionDeduplicator {
     }
 
     File[] files = dir.listFiles((d, name) -> name.endsWith(".txt"));
-      if (files == null) {
-          return;
-      }
+    if (files == null) {
+      return;
+    }
 
     for (File file : files) {
       try (BufferedReader br = new BufferedReader(new FileReader(file))) {
@@ -47,11 +65,27 @@ public class QuestionDeduplicator {
     }
   }
 
+  /**
+   * 检查指定题目是否为重复题目。
+   *
+   * <p>该方法检查给定的题目是否已经存在于历史题目集合中。
+   *
+   * @param question 待检查的题目内容
+   * @return 如果题目重复则返回true，否则返回false
+   */
   public boolean isDuplicate(String question) {
     return existingQuestions.contains(question);
   }
 
+  /**
+   * 将新题目添加到去重集合中。
+   *
+   * <p>该方法将当前生成的题目添加到去重集合中，用于防止
+   * 在同一次生成过程中出现重复题目。
+   *
+   * @param question 需要添加的题目内容
+   */
   public void addQuestion(String question) {
     existingQuestions.add(question);
   }
-}
+}

src/mathpuzzle/service/QuestionGenerator.java

@@ -2,7 +2,27 @@ package mathpuzzle.service;
 
 import java.util.List;
 
+/**
+ * 题目生成器接口，定义了题目生成器的标准方法。
+ *
+ * <p>所有具体的题目生成器都应该实现此接口，提供统一的题目生成功能。
+ * 不同级别的题目生成器（如小学、初中、高中）可以根据各自的特点
+ * 实现不同的生成算法。
+ *
+ * @author 杨博文
+ * @version 1.0
+ * @since 2025
+ */
 public interface QuestionGenerator {
 
+  /**
+   * 生成指定数量的数学题目。
+   *
+   * <p>该方法根据实现类的特定规则生成指定数量的数学题目。
+   * 生成的题目应该符合对应教育级别的难度要求。
+   *
+   * @param count 需要生成的题目数量
+   * @return 包含生成题目的字符串列表
+   */
   List<String> generateQuestions(int count);
-}
+}

src/mathpuzzle/service/SeniorHighGenerator.java

@@ -7,12 +7,24 @@ import java.util.List;
 import java.util.Random;
 
 /**
- * 高中题目生成器 题目必须包含至少一个 sin, cos, tan 三角函数运算符
+ * 高中题目生成器，负责生成包含三角函数运算的高中级别数学题目。
+ *
+ * <p>该生成器确保每道题目都包含至少一个三角函数运算符（sin、cos或tan），
+ * 题目结构包含基本的四则运算和三角函数运算的组合。
+ *
+ * @author 杨博文
+ * @version 1.0
+ * @since 2025
  */
 public class SeniorHighGenerator implements QuestionGenerator {
 
+  /** 三角函数运算符数组，包含"sin"、"cos"和"tan"。 */
   private static final String[] TRIG_FUNCS = {"sin", "cos", "tan"};
+
+  /** 基本运算符数组，包含四则运算符号。 */
   private static final String[] OPERATORS = {"+", "-", "*", "/"};
+
+  /** 随机数生成器，用于生成随机题目。 */
   private final Random random = new Random();
 
   @Override
@@ -25,6 +37,14 @@ public class SeniorHighGenerator implements QuestionGenerator {
     return questions;
   }
 
+  /**
+   * 生成单个高中级别的数学题目。
+   *
+   * <p>该方法确保生成的题目包含至少一个三角函数运算符，
+   * 并根据操作数数量采用不同的生成策略。
+   *
+   * @return 生成的数学题目字符串
+   */
   private String generateSingleQuestion() {
     List<String> parts = new ArrayList<>();
     int operandCount = random.nextInt(5) + 1;
@@ -41,7 +61,7 @@ public class SeniorHighGenerator implements QuestionGenerator {
         if (i == parts.size() - 1) {
           advancedOp = TRIG_FUNCS[random.nextInt(TRIG_FUNCS.length)];
           parts.set(i, advancedOp + parts.get(i));
-        } else if (isNumeric(parts.get(i)) && random.nextBoolean()) {// 随机数看是否为操作数且随即进入生成程序
+        } else if (isNumeric(parts.get(i)) && random.nextBoolean()) { // 随机数看是否为操作数且随即进入生成程序
           // 进入随机生成tan\sin\cos的程序
           parts = generateTrig(parts, i);
           break;
@@ -51,6 +71,15 @@ public class SeniorHighGenerator implements QuestionGenerator {
     return String.join(" ", parts) + " =";
   }
 
+  /**
+   * 生成基本的四则运算表达式部分。
+   *
+   * <p>该方法生成指定数量的操作数和运算符，构成基础的数学表达式。
+   *
+   * @param operandCount 操作数的数量
+   * @param parts 用于存储表达式各部分的列表
+   * @return 包含基本运算表达式的列表
+   */
   // 产生基本操作
   public List<String> generateBase(int operandCount, List<String> parts) {
     for (int i = 0; i < operandCount; i++) {
@@ -63,6 +92,16 @@ public class SeniorHighGenerator implements QuestionGenerator {
     return parts;
   }
 
+  /**
+   * 在指定位置生成三角函数运算。
+   *
+   * <p>该方法在表达式指定位置添加三角函数运算，可能只对单个操作数
+   * 进行三角函数运算，或者对一段子表达式进行三角函数运算。
+   *
+   * @param parts 包含表达式各部分的列表
+   * @param i 三角函数运算的位置
+   * @return 添加了三角函数运算的表达式列表
+   */
   // 产生三角函数运算符
   public List<String> generateTrig(List<String> parts, int i) {
     String trigOp = TRIG_FUNCS[random.nextInt(TRIG_FUNCS.length)];
@@ -85,4 +124,4 @@ public class SeniorHighGenerator implements QuestionGenerator {
     }
     return parts;
   }
-}
+}