# AppGame模块Handler列表

本文档记录了AppGame模块中所有Handler的详细信息，包括功能描述、请求/响应类型、实现状态等。

## 目录

- [1. Public Handler](#1-public-handler) - 公共接口Handler
  - [1.1 TokenHandler](#11-tokenhandler) - 获取访问令牌
  - [1.2 LoginHandler](#12-loginhandler) - 用户登录
  - [1.3 Login4uHandler](#13-login4uhandler) - 4U登录
  - [1.4 Login4ursHandler](#14-login4urshandler) - URS登录
  - [1.5 RegisterHandler](#15-registerhandler) - 用户注册
  - [1.6 PlayerDataHandler](#16-playerdatahandler) - 获取玩家公共数据
  - [1.7 SendSmsHandler](#17-sendsmshandler) - 发送短信验证码
  - [1.8 CheckCodeHandler](#18-checkcodehandler) - 验证短信验证码
  - [1.9 DeviceInfoHandler](#19-deviceinfohandler) - 上报设备信息
- [2. User Handler](#2-user-handler) - 用户相关Handler
  - [2.1 DataHandler](#21-datahandler) - 获取用户完整数据
  - [2.2 EditinfoHandler](#22-editinfohandler) - 编辑用户信息
  - [2.3 EditPasswordHandler](#23-editpasswordhandler) - 修改用户密码
  - [2.4 GameSkinHandler](#24-gameskinhandler) - 游戏皮肤管理
  - [2.5 LogoutHandler](#25-logouthandler) - 用户登出
  - [2.6 QueryDataHandler](#26-querydatahandler) - 查询用户数据
  - [2.7 LogDataHandler](#27-logdatahandler) - 获取用户日志数据
  - [2.8 ClearLogHandler](#28-clearloghandler) - 清理用户日志
- [3. Farm Handler](#3-farm-handler) - 农场相关Handler
  - [3.1 Land相关](#31-land相关)
    - [3.1.1 SowHandler](#311-sowhandler) - 种植种子
    - [3.1.2 HarvestHandler](#312-harvesthandler) - 收获作物
    - [3.1.3 UpHandler](#313-uphandler) - 升级土地
    - [3.1.4 FertilizerHandler](#314-fertilizerhandler) - 使用化肥
    - [3.1.5 PesticideHandler](#315-pesticidehandler) - 使用农药
    - [3.1.6 WateringHandler](#316-wateringhandler) - 浇水
    - [3.1.7 WeedicideHandler](#317-weedicidehandler) - 使用除草剂
    - [3.1.8 RemoveCropHandler](#318-removecrophandler) - 移除作物
  - [3.2 House相关](#32-house相关)
    - [3.2.1 UpHandler](#321-uphandler) - 升级房屋
    - [3.2.2 RankHandler](#322-rankhandler) - 房屋等级排行榜
    - [3.2.3 RankfundHandler](#323-rankfundhandler) - 房屋资金排行榜
  - [3.3 God相关](#33-god相关)
    - [3.3.1 OpenHandler](#331-openhandler) - 激活神像
- [4. Pet Handler](#4-pet-handler) - 宠物相关Handler
  - [4.1 DataHandler](#41-datahandler) - 获取宠物数据
  - [4.2 GetHandler](#42-gethandler) - 获取宠物
  - [4.3 EatHandler](#43-eathandler) - 宠物进食
  - [4.4 TrainHandler](#44-trainhandler) - 宠物训练
  - [4.5 TrainSaveHandler](#45-trainsavehandler) - 保存宠物训练结果
  - [4.6 LifeSkillUseHandler](#46-lifeskillusehandler) - 使用宠物生活技能
  - [4.7 VegetealHandler](#47-vegetealhandler) - 宠物摘菜功能
  - [4.8 RankHandler](#48-rankhandler) - 宠物排行榜
- [5. Item Handler](#5-item-handler) - 物品相关Handler
  - [5.1 CraftHandler](#51-crafthandler) - 物品合成
  - [5.2 DismantleHandler](#52-dismantlehandler) - 物品分解
  - [5.3 OpenboxHandler](#53-openboxhandler) - 开启宝箱
  - [5.4 QueryHandler](#54-queryhandler) - 查询物品信息
- [6. Friend Handler](#6-friend-handler) - 好友相关Handler
  - [6.1 ApplyHandler](#61-applyhandler) - 申请添加好友
  - [6.2 ApplyAgreeHandler](#62-applyagreehandler) - 同意好友申请
  - [6.3 ApplyRefuseHandler](#63-applyrefusehandler) - 拒绝好友申请
  - [6.4 ApplyListHandler](#64-applylisthandler) - 获取好友申请列表
  - [6.5 ApplyL2Handler](#65-applyl2handler) - L2好友申请
  - [6.6 ApplyMyHandler](#66-applymyhandler) - 我的好友申请
  - [6.7 ListHandler](#67-listhandler) - 获取好友列表
  - [6.8 DeleteHandler](#68-deletehandler) - 删除好友
- [7. Shop Handler](#7-shop-handler) - 商店相关Handler
  - [7.1 BuyHandler](#71-buyhandler) - 购买商品
  - [7.2 QueryHandler](#72-queryhandler) - 查询商品信息
- [8. Matchexchange Handler](#8-matchexchange-handler) - 撮合交易Handler
  - [8.1 OpenHandler](#81-openhandler) - 开启交易所
  - [8.2 AddHandler](#82-addhandler) - 添加交易订单
  - [8.3 CancelHandler](#83-cancelhandler) - 取消交易订单
  - [8.4 ListHandler](#84-listhandler) - 获取交易订单列表
  - [8.5 MyHandler](#85-myhandler) - 获取我的交易订单
- [9. Promotion Handler](#9-promotion-handler) - 推广相关Handler
  - [9.1 InfoHandler](#91-infohandler) - 获取推广信息
  - [9.2 ListHandler](#92-listhandler) - 获取推广列表
- [10. Test Handler](#10-test-handler) - 测试相关Handler
  - [10.1 ActivityTimeTestHandler](#101-activitytimetesthandler) - 活动时间测试

---

## 1. Public Handler

公共接口Handler，处理不需要特殊权限的请求。

### 1.1 TokenHandler ✅

**文件**: `app/Module/AppGame/Handler/Public/TokenHandler.php`

**功能**: 获取访问令牌

**请求**: `RequestPublicToken`

**响应**: `ResponsePublicToken`

**需要登录**: ❌

**实现状态**: ✅ 已完成

### 1.2 LoginHandler ✅

**文件**: `app/Module/AppGame/Handler/Public/LoginHandler.php`

**功能**: 用户登录

**请求**: `RequestPublicLogin`

**响应**: `ResponsePublicLogin`

**需要登录**: ❌

**实现状态**: ✅ 已完成

### 1.3 Login4uHandler ✅

**文件**: `app/Module/AppGame/Handler/Public/Login4uHandler.php`

**功能**: 4U系统登录

**需要登录**: ❌

**实现状态**: ✅ 已完成

### 1.4 Login4ursHandler ✅

**文件**: `app/Module/AppGame/Handler/Public/Login4ursHandler.php`

**功能**: URS系统登录

**需要登录**: ❌

**实现状态**: ✅ 已完成

### 1.5 RegisterHandler ✅

**文件**: `app/Module/AppGame/Handler/Public/RegisterHandler.php`

**功能**: 用户注册

**请求**: `RequestPublicRegister`

**响应**: `ResponsePublicRegister`

**需要登录**: ❌

**实现状态**: ✅ 已完成

### 1.6 PlayerDataHandler ✅

**文件**: `app/Module/AppGame/Handler/Public/PlayerDataHandler.php`

**功能**: 获取玩家公共数据（其他玩家可见的信息）

**请求**: `RequestPublicPlayerData`
- `user_id` (int64) - 目标用户ID

**响应**: `ResponsePublicPlayerData`
- `user_info` (PublicUserInfo) - 用户基本信息
- `gods_info` (PublicGod[]) - 神像数据
- `land_info` (PublicLand[]) - 土地数据

**需要登录**: ✅

**实现状态**: ✅ 已完成

**最后更新**: 2025-07-08

**说明**:
- 返回指定用户的公共可见信息
- 包括用户基本信息（昵称、头像、皮肤）
- 包括神像激活状态（4种神像）
- 包括土地信息和作物状态
- 支持查看其他玩家的农场信息

### 1.7 SendSmsHandler ✅

**文件**: `app/Module/AppGame/Handler/Public/SendSmsHandler.php`

**功能**: 发送短信验证码

**需要登录**: ❌

**实现状态**: ✅ 已完成

### 1.8 CheckCodeHandler ✅

**文件**: `app/Module/AppGame/Handler/Public/CheckCodeHandler.php`

**功能**: 验证短信验证码

**需要登录**: ❌

**实现状态**: ✅ 已完成

### 1.9 DeviceInfoHandler ✅

**文件**: `app/Module/AppGame/Handler/Public/DeviceInfoHandler.php`

**功能**: 上报设备信息

**需要登录**: ❌

**实现状态**: ✅ 已完成

---

## 2. User Handler

用户相关Handler，处理用户账户、信息管理等功能。

### 2.1 DataHandler ✅

**文件**: `app/Module/AppGame/Handler/User/DataHandler.php`

**功能**: 获取当前用户完整数据

**请求**: `RequestUserData`

**响应**: `ResponseUserData`
- 包含用户完整信息、物品、货币、房屋、土地、神像、宠物等数据

**需要登录**: ✅

**实现状态**: ✅ 已完成

**说明**:
- 获取当前登录用户的完整游戏数据
- 包含所有模块的相关信息
- 用于游戏主界面数据加载

### 2.2 EditinfoHandler ✅

**文件**: `app/Module/AppGame/Handler/User/EditinfoHandler.php`

**功能**: 编辑用户信息

**需要登录**: ✅

**实现状态**: ✅ 已完成

### 2.3 EditPasswordHandler ✅

**文件**: `app/Module/AppGame/Handler/User/EditPasswordHandler.php`

**功能**: 修改用户密码

**需要登录**: ✅

**实现状态**: ✅ 已完成

### 2.4 GameSkinHandler ✅

**文件**: `app/Module/AppGame/Handler/User/GameSkinHandler.php`

**功能**: 游戏皮肤管理

**需要登录**: ✅

**实现状态**: ✅ 已完成

### 2.5 LogoutHandler ✅

**文件**: `app/Module/AppGame/Handler/User/LogoutHandler.php`

**功能**: 用户登出

**需要登录**: ✅

**实现状态**: ✅ 已完成

### 2.6 QueryDataHandler ✅

**文件**: `app/Module/AppGame/Handler/User/QueryDataHandler.php`

**功能**: 查询用户数据

**需要登录**: ✅

**实现状态**: ✅ 已完成

### 2.7 LogDataHandler ✅

**文件**: `app/Module/AppGame/Handler/User/LogDataHandler.php`

**功能**: 获取用户日志数据

**需要登录**: ✅

**实现状态**: ✅ 已完成

### 2.8 ClearLogHandler ✅

**文件**: `app/Module/AppGame/Handler/User/ClearLogHandler.php`

**功能**: 清理用户日志

**需要登录**: ✅

**实现状态**: ✅ 已完成

---

## 3. Farm Handler

农场相关Handler，处理种植、收获、土地管理等功能。

### 3.1 Land相关

#### 3.1.1 SowHandler ✅

**文件**: `app/Module/AppGame/Handler/Land/SowHandler.php`

**功能**: 种植种子

**需要登录**: ✅

**实现状态**: ✅ 已完成

#### 3.1.2 HarvestHandler ✅

**文件**: `app/Module/AppGame/Handler/Land/HarvestHandler.php`

**功能**: 收获作物

**需要登录**: ✅

**实现状态**: ✅ 已完成

#### 3.1.3 UpHandler ✅

**文件**: `app/Module/AppGame/Handler/Land/UpHandler.php`

**功能**: 升级土地

**需要登录**: ✅

**实现状态**: ✅ 已完成

#### 3.1.4 FertilizerHandler ✅

**文件**: `app/Module/AppGame/Handler/Land/FertilizerHandler.php`

**功能**: 使用化肥

**需要登录**: ✅

**实现状态**: ✅ 已完成

#### 3.1.5 PesticideHandler ✅

**文件**: `app/Module/AppGame/Handler/Land/PesticideHandler.php`

**功能**: 使用农药（除虫）

**需要登录**: ✅

**实现状态**: ✅ 已完成

#### 3.1.6 WateringHandler ✅

**文件**: `app/Module/AppGame/Handler/Land/WateringHandler.php`

**功能**: 浇水

**需要登录**: ✅

**实现状态**: ✅ 已完成

#### 3.1.7 WeedicideHandler ✅

**文件**: `app/Module/AppGame/Handler/Land/WeedicideHandler.php`

**功能**: 使用除草剂

**需要登录**: ✅

**实现状态**: ✅ 已完成

#### 3.1.8 RemoveCropHandler ✅

**文件**: `app/Module/AppGame/Handler/Land/RemoveCropHandler.php`

**功能**: 移除作物

**需要登录**: ✅

**实现状态**: ✅ 已完成

### 3.2 House相关

#### 3.2.1 UpHandler ✅

**文件**: `app/Module/AppGame/Handler/House/UpHandler.php`

**功能**: 升级房屋

**需要登录**: ✅

**实现状态**: ✅ 已完成

#### 3.2.2 RankHandler ✅

**文件**: `app/Module/AppGame/Handler/House/RankHandler.php`

**功能**: 房屋等级排行榜

**需要登录**: ✅

**实现状态**: ✅ 已完成

#### 3.2.3 RankfundHandler ✅

**文件**: `app/Module/AppGame/Handler/House/RankfundHandler.php`

**功能**: 房屋资金排行榜

**需要登录**: ✅

**实现状态**: ✅ 已完成

### 3.3 God相关

#### 3.3.1 OpenHandler ✅

**文件**: `app/Module/AppGame/Handler/God/OpenHandler.php`

**功能**: 激活神像

**需要登录**: ✅

**实现状态**: ✅ 已完成

---

## 4. Pet Handler

宠物相关Handler，处理宠物管理、技能使用等功能。

### 4.1 DataHandler ✅

**文件**: `app/Module/AppGame/Handler/Pet/DataHandler.php`

**功能**: 获取宠物数据

**需要登录**: ✅

**实现状态**: ✅ 已完成

### 4.2 GetHandler ✅

**文件**: `app/Module/AppGame/Handler/Pet/GetHandler.php`

**功能**: 获取宠物

**需要登录**: ✅

**实现状态**: ✅ 已完成

### 4.3 EatHandler ✅

**文件**: `app/Module/AppGame/Handler/Pet/EatHandler.php`

**功能**: 宠物进食

**需要登录**: ✅

**实现状态**: ✅ 已完成

### 4.4 TrainHandler ✅

**文件**: `app/Module/AppGame/Handler/Pet/TrainHandler.php`

**功能**: 宠物训练

**需要登录**: ✅

**实现状态**: ✅ 已完成

### 4.5 TrainSaveHandler ✅

**文件**: `app/Module/AppGame/Handler/Pet/TrainSaveHandler.php`

**功能**: 保存宠物训练结果

**需要登录**: ✅

**实现状态**: ✅ 已完成

### 4.6 LifeSkillUseHandler ✅

**文件**: `app/Module/AppGame/Handler/Pet/LifeSkillUseHandler.php`

**功能**: 使用宠物生活技能

**需要登录**: ✅

**实现状态**: ✅ 已完成

### 4.7 VegetealHandler ✅

**文件**: `app/Module/AppGame/Handler/Pet/VegetealHandler.php`

**功能**: 宠物摘菜功能

**需要登录**: ✅

**实现状态**: ✅ 已完成

### 4.8 RankHandler ✅

**文件**: `app/Module/AppGame/Handler/Pet/RankHandler.php`

**功能**: 宠物排行榜

**需要登录**: ✅

**实现状态**: ✅ 已完成

---

## 5. Item Handler

物品相关Handler，处理物品使用、合成、分解等功能。

### 5.1 CraftHandler ✅

**文件**: `app/Module/AppGame/Handler/Item/CraftHandler.php`

**功能**: 物品合成

**需要登录**: ✅

**实现状态**: ✅ 已完成

### 5.2 DismantleHandler ✅

**文件**: `app/Module/AppGame/Handler/Item/DismantleHandler.php`

**功能**: 物品分解

**需要登录**: ✅

**实现状态**: ✅ 已完成

### 5.3 OpenboxHandler ✅

**文件**: `app/Module/AppGame/Handler/Item/OpenboxHandler.php`

**功能**: 开启宝箱

**需要登录**: ✅

**实现状态**: ✅ 已完成

### 5.4 QueryHandler ✅

**文件**: `app/Module/AppGame/Handler/Item/QueryHandler.php`

**功能**: 查询物品信息

**需要登录**: ✅

**实现状态**: ✅ 已完成

---

## 6. Friend Handler

好友相关Handler，处理好友申请、管理等功能。

### 6.1 ApplyHandler ✅

**文件**: `app/Module/AppGame/Handler/Friend/ApplyHandler.php`

**功能**: 申请添加好友

**需要登录**: ✅

**实现状态**: ✅ 已完成

### 6.2 ApplyAgreeHandler ✅

**文件**: `app/Module/AppGame/Handler/Friend/ApplyAgreeHandler.php`

**功能**: 同意好友申请

**需要登录**: ✅

**实现状态**: ✅ 已完成

### 6.3 ApplyRefuseHandler ✅

**文件**: `app/Module/AppGame/Handler/Friend/ApplyRefuseHandler.php`

**功能**: 拒绝好友申请

**需要登录**: ✅

**实现状态**: ✅ 已完成

### 6.4 ApplyListHandler ✅

**文件**: `app/Module/AppGame/Handler/Friend/ApplyListHandler.php`

**功能**: 获取好友申请列表

**需要登录**: ✅

**实现状态**: ✅ 已完成

### 6.5 ApplyL2Handler ✅

**文件**: `app/Module/AppGame/Handler/Friend/ApplyL2Handler.php`

**功能**: L2好友申请

**需要登录**: ✅

**实现状态**: ✅ 已完成

### 6.6 ApplyMyHandler ✅

**文件**: `app/Module/AppGame/Handler/Friend/ApplyMyHandler.php`

**功能**: 我的好友申请

**需要登录**: ✅

**实现状态**: ✅ 已完成

### 6.7 ListHandler ✅

**文件**: `app/Module/AppGame/Handler/Friend/ListHandler.php`

**功能**: 获取好友列表

**需要登录**: ✅

**实现状态**: ✅ 已完成

### 6.8 DeleteHandler ✅

**文件**: `app/Module/AppGame/Handler/Friend/DeleteHandler.php`

**功能**: 删除好友

**需要登录**: ✅

**实现状态**: ✅ 已完成

---

## 7. Shop Handler

商店相关Handler，处理商品购买、促销等功能。

### 7.1 BuyHandler ✅

**文件**: `app/Module/AppGame/Handler/Shop/BuyHandler.php`

**功能**: 购买商品

**需要登录**: ✅

**实现状态**: ✅ 已完成

### 7.2 QueryHandler ✅

**文件**: `app/Module/AppGame/Handler/Shop/QueryHandler.php`

**功能**: 查询商品信息

**需要登录**: ✅

**实现状态**: ✅ 已完成

---

## 8. Matchexchange Handler

撮合交易相关Handler，处理交易所功能。

### 8.1 OpenHandler ✅

**文件**: `app/Module/AppGame/Handler/Matchexchange/OpenHandler.php`

**功能**: 开启交易所

**需要登录**: ✅

**实现状态**: ✅ 已完成

### 8.2 AddHandler ✅

**文件**: `app/Module/AppGame/Handler/Matchexchange/AddHandler.php`

**功能**: 添加交易订单

**需要登录**: ✅

**实现状态**: ✅ 已完成

### 8.3 CancelHandler ✅

**文件**: `app/Module/AppGame/Handler/Matchexchange/CancelHandler.php`

**功能**: 取消交易订单

**需要登录**: ✅

**实现状态**: ✅ 已完成

### 8.4 ListHandler ✅

**文件**: `app/Module/AppGame/Handler/Matchexchange/ListHandler.php`

**功能**: 获取交易订单列表

**需要登录**: ✅

**实现状态**: ✅ 已完成

### 8.5 MyHandler ✅

**文件**: `app/Module/AppGame/Handler/Matchexchange/MyHandler.php`

**功能**: 获取我的交易订单

**需要登录**: ✅

**实现状态**: ✅ 已完成

---

## 9. Promotion Handler

推广相关Handler，处理推广系统功能。

### 9.1 InfoHandler ✅

**文件**: `app/Module/AppGame/Handler/Promotion/InfoHandler.php`

**功能**: 获取推广信息

**需要登录**: ✅

**实现状态**: ✅ 已完成

### 9.2 ListHandler ✅

**文件**: `app/Module/AppGame/Handler/Promotion/ListHandler.php`

**功能**: 获取推广列表

**需要登录**: ✅

**实现状态**: ✅ 已完成

---

## 10. Test Handler

测试相关Handler，处理测试功能。

### 10.1 ActivityTimeTestHandler ✅

**文件**: `app/Module/AppGame/Handler/Test/ActivityTimeTestHandler.php`

**功能**: 活动时间测试

**需要登录**: ✅

**实现状态**: ✅ 已完成

**说明**: 用于测试活动时间相关功能

---

## 状态说明

- ✅ **已完成**: Handler已实现并测试通过
- 🚧 **开发中**: Handler正在开发中
- 📋 **计划中**: Handler已规划但未开始开发
- ❌ **已废弃**: Handler已不再使用

## 维护说明

1. 新增Handler时请及时更新此文档
2. Handler状态变更时请更新对应状态标识
3. 重要变更请在说明中注明更新时间
4. 建议按模块分类组织Handler信息