Gobang-Game/include/config.h

/**
 * @file config.h
 * @brief 五子棋游戏参数配置头文件
 * @note 本文件集中定义了五子棋游戏的所有参数配置，便于统一管理和修改
 */

#ifndef CONFIG_H
#define CONFIG_H

//---------- 棋盘相关参数 ----------//
#define MAX_BOARD_SIZE 25                           // 支持的最大棋盘尺寸
#define MIN_BOARD_SIZE 5                            // 支持的最小棋盘尺寸
#define DEFAULT_BOARD_SIZE 15                       // 默认棋盘尺寸
#define MAX_STEPS (MAX_BOARD_SIZE * MAX_BOARD_SIZE) // 游戏最大步数

//---------- 游戏模式参数 ----------//
#define GAME_MODE_AI 1                  // 人机对战模式
#define GAME_MODE_PVP 2                 // 双人对战模式
#define GAME_MODE_NETWORK 3             // 网络对战模式

//---------- 玩家标识参数 ----------//
#define EMPTY 0                         // 棋盘空位标识
#define PLAYER 1                        // 玩家标识 (用于人机对战模式)
#define AI 2                            // AI标识 (用于人机对战模式)
#define PLAYER1 1                       // 玩家1标识 (用于双人对战模式)
#define PLAYER2 2                       // 玩家2标识 (用于双人对战模式)

//---------- 特殊输入命令 ----------//
#define INPUT_UNDO -1                   // 悔棋
#define INPUT_SAVE -2                   // 保存
#define INPUT_EXIT -3                   // 退出
#define INPUT_SURRENDER -4              // 认输

//---------- 游戏设置默认值 ----------//
#define DEFAULT_USE_FORBIDDEN_MOVES false   // 默认不启用禁手规则
#define DEFAULT_USE_TIMER 0                 // 默认不启用计时器
#define DEFAULT_TIME_LIMIT 1800             // 默认时间限制为30分钟(内部以秒存储: 30*60)

//---------- AI参数 ----------//
#define DEFAULT_AI_DEPTH 5              // 默认AI搜索深度
#define DEFAULT_DEFENSE_COEFFICIENT 1.5 // 默认防守系数

//---------- 网络参数 ----------//
#define DEFAULT_NETWORK_PORT 8888       // 默认网络端口
#define MIN_NETWORK_PORT 1024           // 最小网络端口
#define MAX_NETWORK_PORT 65535          // 最大网络端口
#define NETWORK_TIMEOUT_MS 5000         // 网络超时时间(毫秒)
#define NETWORK_BUFFER_SIZE 1024        // 网络缓冲区大小

// 网络配置
#define MAX_IP_LENGTH 16                // 最大IP地址长度

// 网络消息类型
#define MSG_MOVE 1                      // 落子消息
#define MSG_CHAT 2                      // 聊天消息
#define MSG_SURRENDER 3                 // 认输消息
#define MSG_UNDO_REQUEST 4              // 悔棋请求
#define MSG_UNDO_RESPONSE 5             // 悔棋回应
#define MSG_GAME_START 6                // 游戏开始
#define MSG_GAME_END 7                  // 游戏结束
#define MSG_HEARTBEAT 8                 // 心跳包
#define MSG_DISCONNECT 9                // 断线消息

//---------- 评分参数 ----------//
// 棋型评分 - 用于calculate_step_score函数
#define SCORE_FIVE 5000                 // 五连
#define SCORE_LIVE_FOUR 2000            // 活四
#define SCORE_RUSH_FOUR 1000            // 冲四
#define SCORE_DEAD_FOUR 300             // 死四
#define SCORE_LIVE_THREE 500            // 活三
#define SCORE_SLEEP_THREE 200           // 眠三
#define SCORE_DEAD_THREE 80             // 死三
#define SCORE_LIVE_TWO 100              // 活二
#define SCORE_SLEEP_TWO 40              // 眠二
#define SCORE_DEAD_TWO 15               // 死二
#define SCORE_LIVE_ONE 15               // 开放单子
#define SCORE_HALF_ONE 8                // 半开放单子
#define SCORE_DEAD_ONE 2                // 封闭单子

// 位置奖励系数
#define POSITION_BONUS_FACTOR 10        // 位置奖励因子

// AI评估参数 - 用于evaluate_pos函数
#define AI_SCORE_FIVE 1000000           // AI评估-五连
#define AI_SCORE_LIVE_FOUR 100000       // AI评估-活四
#define AI_SCORE_RUSH_FOUR 10000        // AI评估-冲四
#define AI_SCORE_DEAD_FOUR 500          // AI评估-死四
#define AI_SCORE_LIVE_THREE 5000        // AI评估-活三
#define AI_SCORE_SLEEP_THREE 1000       // AI评估-眠三
#define AI_SCORE_DEAD_THREE 50          // AI评估-死三
#define AI_SCORE_LIVE_TWO 500           // AI评估-活二
#define AI_SCORE_SLEEP_TWO 100          // AI评估-眠二
#define AI_SCORE_DEAD_TWO 10            // AI评估-死二
#define AI_SCORE_LIVE_ONE 50            // AI评估-开放单子
#define AI_SCORE_HALF_ONE 10            // AI评估-半开放单子
#define AI_SCORE_DEAD_ONE 1             // AI评估-封闭单子

// AI位置奖励系数
#define AI_POSITION_BONUS_FACTOR 50     // AI位置奖励因子

// 搜索算法参数
#define SEARCH_MAX_SCORE 1000000        // 搜索最大分数
#define SEARCH_WIN_BONUS 1000000        // 获胜奖励分数
#define AI_NEARBY_RANGE 3               // AI搜索的邻近范围
#define AI_SEARCH_RANGE_THRESHOLD 8     // AI开始限制搜索范围的步数阈值

// 组合棋型评分 - AI增强新增
#define AI_SCORE_DOUBLE_THREE 50000     // 双三
#define AI_SCORE_FOUR_THREE 200000      // 四三
#define AI_SCORE_THREAT_SEQUENCE 80000  // 威胁序列
#define AI_SCORE_POTENTIAL_FIVE 300000  // 潜在五连

// 评分权重参数
#define TIME_WEIGHT_FACTOR 0.5          // 时间权重因子
#define WIN_BONUS 2000                  // 胜利奖励分数

//---------- GUI界面参数 ----------//
// 窗口和棋盘配置
#define WINDOW_WIDTH 1000
#define WINDOW_HEIGHT 800
#define BOARD_OFFSET_X 45
#define BOARD_OFFSET_Y 45
#define CELL_SIZE 30
#define STONE_RADIUS 13

// 配色方案 - 经典木纹风格 (RGB)
#define CLR_BOARD_BG_R       0xD4   // 棋盘背景 - 暖木色
#define CLR_BOARD_BG_G       0xA5
#define CLR_BOARD_BG_B       0x74
#define CLR_BOARD_BORDER_R   0x8B   // 棋盘边框 - 深木色
#define CLR_BOARD_BORDER_G   0x5E
#define CLR_BOARD_BORDER_B   0x3C
#define CLR_WINDOW_BG        "245 240 235"   // 窗口背景 - 米白
#define CLR_PANEL_BG         "237 229 218"   // 面板背景 - 浅米色
#define CLR_GRID_LINE_R      0x5C   // 网格线 - 深棕
#define CLR_GRID_LINE_G      0x3D
#define CLR_GRID_LINE_B      0x2E
#define CLR_TEXT_TITLE        "60 36 21"      // 标题文字 - 深棕
#define CLR_TEXT_NORMAL       "74 55 40"      // 正文文字 - 中棕
#define CLR_TEXT_SECONDARY    "139 115 85"    // 次要文字 - 浅棕
#define CLR_BTN_PRIMARY_BG    "139 94 60"     // 主按钮背景 - 深棕
#define CLR_BTN_PRIMARY_FG    "255 255 255"   // 主按钮文字 - 白色
#define CLR_BTN_NORMAL_BG     "237 229 218"   // 普通按钮背景 - 浅棕
#define CLR_BTN_NORMAL_FG     "107 66 38"     // 普通按钮文字 - 深棕
#define CLR_LAST_MOVE_R       0x2E   // 最后落子标记 - 蓝色
#define CLR_LAST_MOVE_G       0x86
#define CLR_LAST_MOVE_B       0xAB
#define CLR_STAR_POINT_R      0x3C   // 星位/天元 - 深棕
#define CLR_STAR_POINT_G      0x24
#define CLR_STAR_POINT_B      0x15
// 黑子渐变色
#define CLR_BLACK_STONE_R     0x10   // 黑子外圈
#define CLR_BLACK_STONE_G     0x10
#define CLR_BLACK_STONE_B     0x10
#define CLR_BLACK_HIGHLIGHT_R 0x50   // 黑子高光
#define CLR_BLACK_HIGHLIGHT_G 0x50
#define CLR_BLACK_HIGHLIGHT_B 0x50
// 白子渐变色
#define CLR_WHITE_STONE_R     0xF0   // 白子外圈
#define CLR_WHITE_STONE_G     0xF0
#define CLR_WHITE_STONE_B     0xF0
#define CLR_WHITE_HIGHLIGHT_R 0xFF   // 白子高光
#define CLR_WHITE_HIGHLIGHT_G 0xFF
#define CLR_WHITE_HIGHLIGHT_B 0xFF
#define CLR_WHITE_BORDER_R    0xA0   // 白子边框
#define CLR_WHITE_BORDER_G    0xA0
#define CLR_WHITE_BORDER_B    0xA0

//---------- 文件路径参数 ----------//
#define RECORDS_DIR "records"           // 记录文件目录
#define CONFIG_FILE "gobang_config.ini" // 配置文件路径
#define MAX_PATH_LENGTH 256             // 最大路径长度

//---------- LLM大模型参数 ----------//
#define DEFAULT_LLM_USE 0                          // 默认不使用LLM (0=算法AI, 1=大模型)
#define DEFAULT_LLM_ENDPOINT "https://api.minimax.chat/v1/chat/completions" // 默认API地址
#define DEFAULT_LLM_API_KEY ""                     // 默认API Key (需用户填写)
#define DEFAULT_LLM_MODEL "MiniMax-Text-01"        // 默认模型名
#define MAX_LLM_ENDPOINT_LEN 256                   // API地址最大长度
#define MAX_LLM_API_KEY_LEN 128                    // API Key最大长度
#define MAX_LLM_MODEL_LEN 64                       // 模型名最大长度
#define LLM_MAX_RETRIES 3                          // LLM返回非法坐标时最大重试次数
#define LLM_TIMEOUT_MS 30000                       // LLM HTTP请求超时(毫秒)

//---------- 配置管理函数声明 ----------//
/**
 * @brief 加载游戏配置
 */
void load_game_config();

/**
 * @brief 保存游戏配置
 */
void save_game_config();

/**
 * @brief 重置为默认配置
 */
void reset_to_default_config();

#endif // CONFIG_H