为各服务接口补 /// 中文注释：swagger 恢复中文说明（admin 203 / user 93 / customer 12 / fishgame 4）

FishGameSrc/FishGameHost/Controllers/PlayerController.cs

@@ -16,6 +16,9 @@ public class PlayerController : ControllerBase
         _jwtTools = jwtTools;
     }
 
+    /// <summary>
+    /// 玩家登录 - 生成 JWT token 并返回玩家基础信息（调试用）
+    /// </summary>
     [HttpPost("login")]
     public IActionResult Login([FromBody] PlayerLoginRequest request)
     {

FishGameSrc/FishGameHost/Controllers/RoomController.cs

@@ -23,6 +23,9 @@ namespace FishGameHost.Controllers
             public string WebSocketUrl { get; set; } = "";
         }
 
+        /// <summary>
+        /// 快速加入 - 根据游戏类型和等级查找一个不满员的房间，直接返回 WS 地址和 roomId
+        /// </summary>
         [HttpGet("QuickJoin")]
         public BaseResponse<QuickJoinResult> QuickJoin(int gameType, int level)
         {
@@ -54,6 +57,9 @@ namespace FishGameHost.Controllers
             return instances[0];
         }
 
+        /// <summary>
+        /// 分配房间到目标游戏服务器 - 返回指定房间对应的对局服务 WS 地址
+        /// </summary>
         [HttpGet("Assign")]
         public BaseResponse<string> AssignRoom(string roomId)
         {

FishGameSrc/FishGameHost/Controllers/TimeController.cs

@@ -6,6 +6,9 @@ namespace FishGameHost.Controllers;
 [Route("fishapi/[controller]")]
 public class TimeController : ControllerBase
 {
+    /// <summary>
+    /// 获取 FishApi 当前服务器时间，用于比较不同容器的系统时钟。
+    /// </summary>
     [HttpGet("GetDateTime")]
     [ResponseCache(NoStore = true, Location = ResponseCacheLocation.None)]
     public IActionResult GetDateTime()