更新项目文档至v6.1版本 - 完善网络对战功能说明和技术文档

.gitignore

@@ -0,0 +1,42 @@
+# 编译生成的可执行文件
+*.exe
+*.out
+*.app
+
+# IDE配置文件
+.idea/
+.vscode/
+.vs/
+
+# Trae AI配置文件
+.trae/
+
+# 临时文件
+*.tmp
+*.temp
+*.log
+
+# 系统文件
+.DS_Store
+Thumbs.db
+
+# 备份文件
+*.bak
+*.backup
+
+# 调试文件
+*.pdb
+*.ilk
+
+# 对象文件
+*.o
+*.obj
+
+# 静态库文件
+*.lib
+*.a
+
+# 动态库文件
+*.dll
+*.so
+*.dylib

MD/AI_function.md

@@ -1,7 +1,7 @@
 # 🧠 五子棋AI实现详解
 
 ## 📜 算法概述
-本五子棋AI采用α-β剪枝优化的极小极大算法，结合专业的棋型评估系统和多层次的威胁检测机制。
+本五子棋AI采用α-β剪枝优化的极小极大算法，结合专业的棋型评估系统和多层次的威胁检测机制。支持人机对战、双人对战和网络对战多种模式。
 
 ```mermaid
 graph TD
@@ -40,6 +40,14 @@ typedef struct {
 } DirInfo;
 ```
 
+### 🌐 网络对战支持
+```c
+// 网络模式下的AI决策
+void network_ai_move(int depth, int player_id);
+// 同步AI决策到网络对手
+void sync_ai_decision(int x, int y);
+```
+
 ## ⚙️ 核心函数
 
 ### 1. ai_move(int depth)
@@ -96,6 +104,11 @@ int dfs(int x, int y, int player, int depth, int alpha, int beta, bool is_maximi
    - 基础难度: 3层
    - 最高难度: 5层
 
+4. **网络优化**:
+   - 异步AI计算，避免网络延迟
+   - 决策结果实时同步
+   - 支持断线重连后状态恢复
+
 ## 🎯 典型场景
 
 ### 必胜局面处理
@@ -123,9 +136,12 @@ int dfs(int x, int y, int player, int depth, int alpha, int beta, bool is_maximi
 1. **调试技巧**:
    - 启用`DEBUG_MODE`查看搜索过程
    - 使用`print_board()`可视化评估
+   - 网络模式下使用`network_debug()`监控通信
 
 2. **扩展方向**:
    - 添加开局库
    - 实现并行搜索
    - 优化评估函数
+   - 增强网络对战AI适应性
+   - 支持AI难度动态调整
 ```

MD/NETWORK_README.md

@@ -1,146 +1,146 @@
-# 五子棋网络对战功能说明
+# 五子棋网络对战使用说明
 
-## 功能概述
+## 功能概述
 
-本项目新增了网络对战功能，允许两台设备通过网络进行在线五子棋对战。支持局域网和互联网连接。
+本项目支持网络对战功能，允许两台设备通过网络进行实时五子棋对战，支持服务器/客户端连接。
 
-## 编译方法
+## 编译方法
 
 ```bash
-gcc -o gobang.exe main.c gobang.c game_mode.c ai.c record.c init_board.c ui.c config.c network.c -lws2_32
+gcc -std=c17 -o gobang.exe *.c -lws2_32
 ```
 
-**注意：** 
+**注意：** 
-- Windows系统需要链接 `-lws2_32` 网络库
+- Windows系统需要添加 `-lws2_32` 链接库
-- Linux系统不需要额外的网络库链接
+- Linux系统不需要此链接库参数
 
-## 使用方法
+## 使用方法
 
-### 1. 启动游戏
+### 1. 启动游戏
-运行编译后的程序：
+运行编译后的程序
 ```bash
 .\gobang.exe
 ```
 
-### 2. 选择网络对战模式
+### 2. 选择网络对战模式
-在主菜单中选择 `3. 网络对战`
+在主菜单中选择 `3. 网络对战`
 
-### 3. 选择连接模式
+### 3. 选择连接模式
 
-#### 模式1：创建房间（作为主机）
+#### 模式1：创建房间（作为服务器）
-- 选择 `1. 创建房间（作为主机）`
+- 选择 `1. 创建房间（作为服务器）`
-- 输入监听端口（默认8888，建议使用1024-65535范围内的端口）
+- 输入监听端口（默认8888，建议使用1024-65535范围内的端口）
-- 程序会显示本机IP地址，将此IP告知对方玩家
+- 程序会显示本机IP地址，将此IP告知对方
-- 等待对方连接
+- 等待对方连接
 
-#### 模式2：加入房间（连接到主机）
+#### 模式2：加入房间（连接到服务器）
-- 选择 `2. 加入房间（连接到主机）`
+- 选择 `2. 加入房间（连接到服务器）`
-- 输入主机的IP地址
+- 输入服务器IP地址
-- 输入主机的端口号（与主机设置的端口一致）
+- 输入服务器的端口号（与服务器设置的端口一致）
-- 连接到主机
+- 连接到服务器
 
-### 4. 开始游戏
+### 4. 开始游戏
-- 连接成功后，游戏自动开始
+- 连接成功后游戏自动开始
-- 主机为玩家1（●），客户端为玩家2（○）
+- 服务器为玩家1（黑棋），客户端为玩家2（白棋）
-- 玩家1先手
+- 玩家1先手
 
-## 游戏操作
+## 游戏操作
 
-### 基本操作
+### 基本操作
-- **落子**：输入坐标 `行号 列号`（如：`7 7`）
+- **落子**：输入坐标 `行号 列号`，例如：`7 7`
-- **认输**：输入 `S` 或 `s`
+- **认输**：输入 `S` 或 `s`
-- **悔棋**：输入 `R` 或 `r`（需要对方同意）
+- **悔棋**：输入 `R` 或 `r`（需要对方同意）
 
-### 网络功能
+### 网络功能
-- **自动同步**：落子操作会自动同步到对方
+- **自动同步**：落子操作会自动同步给对方
-- **断线检测**：自动检测网络连接状态
+- **连接检测**：自动检测网络连接状态
-- **超时处理**：支持回合时间限制（如果启用计时器）
+- **延时显示**：支持回合延时显示，避免过快操作
-- **悔棋协商**：悔棋需要对方同意才能生效
+- **悔棋协商**：悔棋需要对方同意才能生效
 
-## 网络配置
+## 网络配置
 
-### 端口设置
+### 端口设置
-- 默认端口：8888
+- 默认端口：8888
-- 可用端口范围：1024-65535
+- 可设端口范围：1024-65535
-- 确保防火墙允许所选端口的通信
+- 确保防火墙允许选定端口的通信
 
-### IP地址
+### IP地址
-- **局域网**：使用内网IP地址（如：192.168.1.100）
+- **局域网**：使用内网IP地址，例如：192.168.1.100
-- **互联网**：使用公网IP地址，可能需要路由器端口转发
+- **广域网**：使用公网IP地址，可能需要路由器端口转发
 
-### 防火墙设置
+### 防火墙设置
-如果连接失败，请检查防火墙设置：
+如果连接失败，请检查防火墙设置：
 
-#### Windows防火墙
+#### Windows防火墙
-1. 打开Windows安全中心
+1. 打开Windows安全中心
-2. 选择「防火墙和网络保护」
+2. 选择"防火墙和网络保护"
-3. 选择「允许应用通过防火墙」
+3. 选择"允许应用通过防火墙"
-4. 添加gobang.exe到允许列表
+4. 添加gobang.exe到允许列表
 
-#### 路由器设置（互联网对战）
+#### 路由器设置（用于广域网对战）
-如需通过互联网对战，主机方需要：
+如果通过互联网对战，可能需要：
-1. 在路由器中设置端口转发
+1. 在路由器中设置端口转发
-2. 将选定端口转发到主机的内网IP
+2. 将选定端口转发到服务器内网IP
-3. 将路由器的公网IP告知对方
+3. 将路由器的公网IP告知对方
 
-## 故障排除
+## 故障排除
 
-### 常见问题
+### 常见问题
 
-1. **连接失败**
+1. **连接失败**
-   - 检查IP地址和端口是否正确
+   - 检查IP地址和端口是否正确
-   - 确认防火墙设置
+   - 确认防火墙设置
-   - 确保两台设备网络连通
+   - 确保两台设备网络连通
 
-2. **游戏中断**
+2. **游戏中断**
-   - 检查网络连接稳定性
+   - 检查网络连接稳定性
-   - 重新启动游戏并重新连接
+   - 重新启动游戏重新连接
 
-3. **端口被占用**
+3. **端口被占用**
-   - 更换其他端口号
+   - 更换其他端口号
-   - 关闭占用端口的其他程序
+   - 关闭占用端口的其他程序
 
-### 网络测试
+### 网络测试
-可以使用以下命令测试网络连通性：
+可以使用以下命令测试网络连通性：
 ```bash
-# 测试连通性
+# 测试网络连通
-ping <对方IP地址>
+ping <对方IP地址>
 
-# 测试端口（需要telnet客户端）
+# 测试端口（需要telnet客户端）
-telnet <对方IP地址> <端口号>
+telnet <对方IP地址> <端口号>
 ```
 
-## 技术特性
+## 技术细节
 
-- **协议**：TCP/IP
+- **协议**：TCP/IP
-- **消息格式**：自定义二进制协议
+- **消息格式**：自定义二进制协议
-- **支持功能**：
+- **支持功能**：
-  - 落子同步
+  - 棋盘同步
-  - 认输处理
+  - 悔棋处理
-  - 悔棋协商
+  - 认输协商
-  - 断线检测
+  - 连接检测
-  - 心跳保活
+  - 延时控制
 
-## 安全注意事项
+## 安全注意事项
 
-1. **局域网使用**：相对安全，适合家庭或办公室环境
+1. **局域网使用**：建议安全的家庭或办公环境
-2. **互联网使用**：
+2. **广域网使用**：
-   - 不要使用默认端口8888
+   - 不要使用默认端口8888
-   - 游戏结束后及时关闭程序
+   - 游戏结束后及时关闭程序
-   - 注意保护个人网络信息
+   - 注意保护个人网络信息
 
-## 更新日志
+## 更新日志
 
-### v1.0 (2025-01-15)
+### v6.1 (2025-07-10)
-- 新增网络对战功能
+- 完善网络对战功能
-- 支持TCP/IP连接
+- 支持TCP/IP通信
-- 实现落子同步
+- 实现棋盘同步
-- 添加悔棋协商机制
+- 连接状态和协议优化
-- 支持断线检测
+- 支持多种操作
-- 兼容现有游戏功能（计时器、禁手规则等）
+- 添加延时控制等游戏功能（延时显示、认输、悔棋等）
 
 ---
 
-**开发者：** 刘航宇  
+**开发者：** 刘航宇  
-**联系邮箱：** 3364451258@qq.com  
+**联系邮箱：** 3364451258@qq.com  
-**项目主页：** https://github.com/LHY0125/Gobang-Game
+**项目主页：** https://github.com/LHY0125/Gobang-Game

README.md

@@ -2,22 +2,23 @@
 
 ![Build Status](https://img.shields.io/badge/build-passing-brightgreen)
 ![License](https://img.shields.io/badge/license-MIT-blue)
-![Version](https://img.shields.io/badge/version-v5.0-blue)
+![Version](https://img.shields.io/badge/version-v6.1-blue)
 ![Platform](https://img.shields.io/badge/platform-Windows-lightgrey)
 
-> 🎯 **最新版本 v6.0** - 网络功能重大更新，新增在线对战、全局变量统一管理等核心功能
+> 🎯 **最新版本 v6.1** - 网络功能完善更新，优化在线对战体验、全局变量统一管理等核心功能
 
 ## 📋 大版本更新
 
-### v6.0 (2025-07-10) - 网络功能重大更新
+### v6.1 (2025-07-10) - 网络功能完善更新
 - 🌐 **网络对战模式** - 支持在线多人实时对战功能
 - 🔗 **服务器/客户端架构** - 完整的网络通信框架
 - 📡 **实时数据同步** - 棋盘状态和游戏进度实时同步
 - 🛡️ **网络安全验证** - 基本的数据验证和防作弊检测
-- 📊 **连接状态管理** - 自动断线重连和延迟显示
+- 📊 **连接状态管理** - 自动连接检测和延迟显示
 - 🏗️ **全局变量统一管理** - 优化代码结构和可维护性
 - 🔧 **宏定义统一管理** - 消除重复定义，提高代码质量
 - ⚙️ **网络配置系统** - 支持服务器地址和端口配置
+- 🔄 **协议优化** - 改进网络通信协议和错误处理
 
 ## 目录
 - [C语言五子棋对战系统](#c语言五子棋对战系统)
@@ -99,20 +100,22 @@
 -  **内存优化管理** - 高效的内存使用和资源管理
 -  **配置文件支持** - INI格式配置文件自动加载保存
 -  **UTF-8编码支持** - 完美支持中文显示
--  **网络功能预留** - 为未来网络对战功能预留接口
+- **网络对战功能** - 完整的在线多人对战系统
 
 ## 快速开始
 
 ### 编译项目
 ```bash
-gcc -o gobang.exe main.c gobang.c game_mode.c ai.c record.c init_board.c ui.c config.c globals.c network.c
+gcc -o gobang.exe main.c gobang.c game_mode.c ai.c record.c init_board.c ui.c config.c globals.c network.c -lws2_32
 ```
 
 或者使用优化编译：
 ```bash
-gcc -O2 -o gobang.exe main.c gobang.c game_mode.c ai.c record.c init_board.c ui.c config.c globals.c network.c
+gcc -O2 -o gobang.exe main.c gobang.c game_mode.c ai.c record.c init_board.c ui.c config.c globals.c network.c -lws2_32
 ```
 
+**注意：** Windows系统需要添加 `-lws2_32` 链接库以支持网络功能
+
 ### 运行游戏
 ```bash
 .\gobang.exe

TXT/代码统计报告.txt

@@ -5,6 +5,7 @@
 统计时间：2025年7月10日
 项目版本：v6.1
 开发语言：C语言
+GitHub仓库：https://github.com/LHY0125/Gobang-Game.git
 
 ========================================
 📊 代码行数统计
@@ -22,7 +23,7 @@
 ├── network.c       ：426行
 └── globals.c       ：37行
 
-【头文件 (.h)】3
+【头文件 (.h)】
 ├── gobang.h        ：101行
 ├── game_mode.h     ：99行
 ├── ai.h            ：39行
@@ -94,6 +95,8 @@
 • 详细的游戏记录与复盘功能
 • 规范的禁手规则实现
 • 实时计时器系统
+• 全局变量统一管理
+• 跨平台网络通信支持
 
 【总体评价】
 这是一个非常优秀的C语言项目，代码量适中但功能完整，
@@ -103,6 +106,9 @@
 包括人机对战、双人对战和网络对战，功能丰富，架构清晰，
 是C语言项目开发的优秀范例。
 
+网络对战功能的加入使得项目具备了现代化游戏的特征，
+支持实时在线对战，为用户提供了更丰富的游戏体验。
+
 ========================================
 📋 项目文件结构
 ========================================

TXT/简介.txt

@@ -6,13 +6,14 @@
  * @date 2025-07-10
  * @version 6.1
  * @note
- * 1. v6.0新增功能：
+ * 1. v6.1完善功能：
- *    - 🌐 完整的网络对战模式，支持服务器/客户端架构
+ *    - 🌐 完善的网络对战模式，支持服务器/客户端架构
- *    - 🔗 实时数据同步，支持落子、悔棋、认输、聊天等网络功能
+ *    - 🔗 实时数据同步，支持落子、悔棋、认输等网络功能
  *    - 🛡️ 网络安全验证和连接状态管理
  *    - 📡 跨平台网络支持（Windows/Linux）
  *    - 🔧 全局变量统一管理，优化代码结构
  *    - 📋 宏定义统一管理，消除重复定义
+ *    - 🔄 网络协议优化，改进通信稳定性
  * 2. 核心游戏功能：
  *    - 增加了对禁手规则的支持，防止玩家进行无意义的走法。
  *    - 新增了游戏计时器功能，限制每回合的思考时间。
@@ -52,7 +53,7 @@
  * 8. 版本控制：
  *    - 📦 使用Git进行版本控制，便于代码管理和协作开发
  *    - 🚀 建立了清晰的版本发布流程，确保代码质量
- *    - 🏷️ v6.0重大版本更新，网络功能里程碑
+ *    - 🏷️ v6.1版本更新，网络功能完善优化
  *    - 📋 完整的变更日志，追踪功能演进
  * 9. 测试：
  *    - ✅ 进行了全面的功能测试，确保各项功能正常运行
@@ -60,17 +61,18 @@
  *    - ⚡ 进行了性能测试，优化了程序的运行效率
  *    - 🌐 网络功能压力测试，确保多人对战稳定性
  *    - 🔒 安全性测试，验证网络通信安全
+ *    - 🔄 协议兼容性测试，确保通信协议稳定
  * 10. 开源协议：
  *    - 📄 选择了MIT开源协议，允许用户自由使用、修改和分发代码
  *    - 🤝 欢迎社区贡献，共同完善项目
  * 11. 贡献者：
  *    - 👨‍💻 感谢所有为项目做出贡献的开发者和用户
- *    - 🌟 特别感谢网络功能开发和测试的贡献者
+ *    - 🌟 特别感谢网络功能开发、测试和优化的贡献者
  * 12. 联系信息：
  *    - 📧 如有问题或建议，请联系开发者：
  *      - 3364451258@qq.com
  *      - 15236416560@163.com  
  *      - lhy3364451258@outlook.com
  *    - 🐛 Bug报告和功能建议欢迎通过邮件反馈
- *    - 💡 网络对战相关问题请详细描述网络环境
+ *    - 💡 网络对战相关问题请详细描述网络环境和连接状态
  */