Add files via upload

game_mode.h

@@ -1,16 +1,16 @@
 /**
  * @file game_mode.h
- * @author ??????(3364451258@qq.com??15236416560@163.com??lhy3364451258@outlook.com)
- * @brief ????????????????
- * @version 3.0
- * @date 2025-06-30
+ * @author 刘航宇(3364451258@qq.com、15236416560@163.com、lhy3364451258@outlook.com)
+ * @brief 五子棋游戏框架头文件
+ * @version 4.0
+ * @date 2025-07-02
  *
  * @copyright Copyright (c) 2025
  *
- * @note ?????????????????????????????????
- * 1. AI?????
- * 2. ???????
- * 3. ??????
+ * @note 本文件定义了五子棋游戏的三种主要模式：
+ * 1. AI对战模式
+ * 2. 双人对战模式
+ * 3. 复盘模式
  */
 
 #ifndef GAME_MODE_H
@@ -18,53 +18,53 @@
 
 #include "gobang.h"
 
-// ????????????
+// 特殊输入命令
 #define INPUT_UNDO -1
 #define INPUT_SAVE -2
 #define INPUT_EXIT -3
 
 /**
- * @brief ????????????????
+ * @brief 从用户获取整数输入
  *
- * @param prompt ??????
- * @param min ?????
- * @param max ????
- * @return int ?????????
+ * @param prompt 提示信息
+ * @param min 最小值
+ * @param max 最大值
+ * @return int 输入的整数
  */
 int get_integer_input(const char *prompt, int min, int max);
 
 /**
- * @brief ?????????
+ * @brief 处理玩家回合
  *
- * @param x ?????????????
- * @param y ??????????????
- * @return true ????????
- * @return false ????????
+ * @param x 玩家输入的横坐标
+ * @param y 玩家输入的纵坐标
+ * @return true 输入有效
+ * @return false 输入无效
  */
 bool parse_player_input(int *x, int *y);
 
 /**
- * @brief ????AI???
+ * @brief 处理AI回合
  *
- * @param current_player ??????
+ * @param current_player 当前玩家
  */
 bool handle_player_turn(int current_player);
 
 /**
- * @brief AI?????
- * ????????AI???????
+ * @brief AI对战模式
+ * 实现玩家与AI的对战逻辑
  */
 void run_ai_game();
 
 /**
- * @brief ???????
- * ???????????????????
+ * @brief 双人对战模式
+ * 实现两个玩家之间的对战逻辑
  */
 void run_pvp_game();
 
 /**
- * @brief ??????
- * ???????????????
+ * @brief 复盘模式
+ * 加载并重现历史对局
  */
 void run_review_mode();