# 版本号验证功能测试指南

## 功能概述
实现了客户端和服务端的版本号验证机制，确保只有版本匹配的客户端才能登录或注册游戏。

## 实现的功能

### 1. 客户端修改
- 在 `MainGame.gd` 中定义了客户端版本号：`const client_version :String = "1.0.1"`
- 在 `TCPNetworkManager.gd` 中修改了登录和注册请求，添加了版本号字段
- 在 `login_panel.gd` 中添加了版本号显示功能

### 2. 服务端修改
- 在 `TCPGameServer.py` 中定义了服务端版本号：`server_version: str = "1.0.1"`
- 添加了版本号验证函数 `_check_client_version()`
- 在登录和注册处理中添加了版本号验证逻辑
- 在服务器启动时显示版本信息

## 测试步骤

### 测试1：版本匹配（正常情况）
1. 确保客户端和服务端版本号都是 "1.0.1"
2. 启动服务器，应该看到：
   ```
   萌芽农场游戏服务器 v1.0.1
   服务器地址: 0.0.0.0:4040
   ==================================================
   ```
3. 启动客户端，应该看到：
   ```
   萌芽农场客户端 v1.0.1 启动
   ```
4. 在登录界面应该显示：`萌芽农场 v1.0.1 - 欢迎使用`
5. 尝试登录或注册，应该正常工作

### 测试2：版本不匹配（客户端版本较低）
1. 修改客户端版本号为 "0.9.0"：
   ```gdscript
   const client_version :String = "0.9.0"
   ```
2. 保持服务端版本为 "1.0.0"
3. 重新启动客户端
4. 尝试登录，应该收到错误消息：
   ```
   版本不匹配！客户端版本: 0.9.0, 服务端版本: 1.0.1，请更新客户端
   ```
5. 尝试注册，应该收到相同的错误消息

### 测试3：版本不匹配（客户端版本较高）
1. 修改客户端版本号为 "1.1.0"：
   ```gdscript
   const client_version :String = "1.1.0"
   ```
2. 保持服务端版本为 "1.0.1"
3. 重新启动客户端
4. 尝试登录或注册，应该收到版本不匹配的错误消息

### 测试4：空版本号处理
1. 修改客户端代码，发送空的版本号
2. 尝试登录或注册，应该被拒绝

## 预期结果

### 成功情况
- 版本匹配时，登录和注册功能正常工作
- 客户端和服务端都显示正确的版本信息

### 失败情况
- 版本不匹配时，登录和注册被拒绝
- 显示清晰的错误消息，指出版本不匹配的具体信息
- 服务端记录相应的警告日志

## 日志示例

### 服务端日志（版本匹配）
```
[INFO] [SERVER] TCP游戏服务器初始化 - 版本: 1.0.1
[INFO] [SERVER] 用户 12345 登录成功
```

### 服务端日志（版本不匹配）
```
[WARNING] [SERVER] 用户 12345 登录失败: 版本不匹配 (客户端: 0.9.0, 服务端: 1.0.1)
```

## 注意事项

1. **版本号格式**：建议使用语义化版本号格式（如 1.0.0）
2. **向后兼容性**：如果需要支持多个版本，可以修改验证逻辑
3. **版本更新策略**：
   - 主版本号变更：不兼容的重大更新
   - 次版本号变更：向后兼容的功能更新
   - 修订版本号变更：向后兼容的问题修复

## 扩展功能建议

1. **版本兼容性矩阵**：支持多个兼容版本
2. **自动更新提示**：客户端检测到版本不匹配时提供更新链接
3. **最低版本要求**：设置服务端支持的最低客户端版本
4. **版本信息API**：提供接口查询当前服务端版本和兼容的客户端版本列表