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

AdminSrc/AdminApi/GameConfigs/GameConfigController.cs

@@ -54,6 +54,9 @@ namespace AdminApi.GameConfigs
 
 
 
+        /// <summary>
+        /// 一键初始化所有配置（GameConfig + ActivityConfig）
+        /// </summary>
         [HttpGet("init-all")]
         public async Task<BaseResponse<string>> InitAll([FromServices] IActivityConfigService activityConfigService)
         {
@@ -64,6 +67,9 @@ namespace AdminApi.GameConfigs
             return this.ToResult("所有配置初始化成功");
         }
 
+        /// <summary>
+        /// 初始化游戏配置（仅 GameConfig）
+        /// </summary>
         [HttpGet("init-game")]
         public async Task<BaseResponse<string>> InitGame()
         {
@@ -71,6 +77,9 @@ namespace AdminApi.GameConfigs
             return this.ToResult("游戏配置初始化成功");
         }
 
+        /// <summary>
+        /// 初始化指定板块（从gameconfig.json读取该板块数据，不影响其他配置）
+        /// </summary>
         [HttpGet("InitSection/{sectionName}")]
         public async Task<BaseResponse<string>> InitSection(string sectionName)
         {
@@ -135,6 +144,9 @@ namespace AdminApi.GameConfigs
             }
         }
 
+        /// <summary>
+        /// 保存指定板块到 gameconfig.json（将当前 MongoDB 配置写回初始化文件）
+        /// </summary>
         [HttpGet("SaveSection/{sectionName}")]
         public async Task<BaseResponse<string>> SaveSection(string sectionName)
         {
@@ -213,6 +225,9 @@ namespace AdminApi.GameConfigs
             }
         }
 
+        /// <summary>
+        /// 初始化活动配置（仅 ActivityConfig）
+        /// </summary>
         [HttpGet("init-activity")]
         public async Task<BaseResponse<string>> InitActivity([FromServices] IActivityConfigService activityConfigService)
         {
@@ -220,6 +235,9 @@ namespace AdminApi.GameConfigs
             return this.ToResult("活动配置初始化成功");
         }
 
+        /// <summary>
+        /// 初始化活动配置单个板块（从 activityconfig.json 读取）
+        /// </summary>
         [HttpGet("InitActivitySection/{sectionName}")]
         public async Task<BaseResponse<string>> InitActivitySection(string sectionName, [FromServices] IActivityConfigService activityConfigService)
         {
@@ -3317,6 +3335,9 @@ namespace AdminApi.GameConfigs
             }
         }
 
+        /// <summary>
+        /// 获取游戏配置
+        /// </summary>
         [HttpGet]
 
         public async Task<BaseResponse<GameConfig>> Get()
@@ -3329,6 +3350,9 @@ namespace AdminApi.GameConfigs
             return this.ToResult(res);
         }
 
+        /// <summary>
+        /// 获取所有鱼类型列表（用于下拉选择）
+        /// </summary>
         [HttpGet("FishTypeList")]
         public async Task<BaseResponse<List<FishTypeConfig>>> GetFishTypeList()
         {
@@ -3341,6 +3365,9 @@ namespace AdminApi.GameConfigs
             return this.ToResult(res.FishTypeConfigs.OrderBy(f => f.FishNumber).ToList());
         }
 
+        /// <summary>
+        /// 获取道具列表（用于发送邮件选择道具）
+        /// </summary>
         [HttpGet("PropList")]
         public async Task<BaseResponse<List<BaseProductCount>>> GetPropList()
         {
@@ -3365,6 +3392,9 @@ namespace AdminApi.GameConfigs
             return this.ToResult(propList);
         }
 
+        /// <summary>
+        /// 添加和修改游戏配置
+        /// </summary>
         [HttpPost("Update")]
         public async Task<BaseResponse<string>> Update(GameConfig param)
         {
@@ -3378,6 +3408,9 @@ namespace AdminApi.GameConfigs
         }
 
 
+        /// <summary>
+        /// 更新鱼种配置
+        /// </summary>
         [HttpPost("UpdateFishType")]
         public async Task<BaseResponse<string>> UpdateFishType(List<FishTypeConfig> configs)
         {
@@ -3391,6 +3424,9 @@ namespace AdminApi.GameConfigs
                 return this.ToFailResult<string>(res.msg);
         }
 
+        /// <summary>
+        /// 更新房间配置
+        /// </summary>
         [HttpPost("UpdateRoom")]
         public async Task<BaseResponse<string>> UpdateRoom(List<RoomConfig> configs)
         {
@@ -3403,6 +3439,9 @@ namespace AdminApi.GameConfigs
                 return this.ToFailResult<string>(res.msg);
         }
 
+        /// <summary>
+        /// 更新出鱼配置
+        /// </summary>
         [HttpPost("UpdateRoomFish")]
         public async Task<BaseResponse<string>> UpdateRoomFish(List<RoomFishConfig> configs)
         {
@@ -3416,6 +3455,9 @@ namespace AdminApi.GameConfigs
                 return this.ToFailResult<string>(res.msg);
         }
 
+        /// <summary>
+        /// 更新鱼阵配置
+        /// </summary>
         [HttpPost("UpdateFishArray")]
         public async Task<BaseResponse<string>> UpdateFishArray(List<FishArrayConfig> configs)
         {
@@ -3429,6 +3471,9 @@ namespace AdminApi.GameConfigs
                 return this.ToFailResult<string>(res.msg);
         }
 
+        /// <summary>
+        /// 更新用户等级配置
+        /// </summary>
         [HttpPost("UpdateUserLevel")]
         public async Task<BaseResponse<string>> UpdateUserLevel(List<UserLevelConfig> configs)
         {
@@ -3441,6 +3486,9 @@ namespace AdminApi.GameConfigs
                 return this.ToFailResult<string>(res.msg);
         }
 
+        /// <summary>
+        /// 更新道具配置
+        /// </summary>
         [HttpPost("UpdateProp")]
         public async Task<BaseResponse<string>> UpdateProp(List<PropInfConfig> configs)
         {
@@ -3454,6 +3502,9 @@ namespace AdminApi.GameConfigs
                 return this.ToFailResult<string>(res.msg);
         }
 
+        /// <summary>
+        /// 更新道具碎片配置
+        /// </summary>
         [HttpPost("UpdatePropFragment")]
         public async Task<BaseResponse<string>> UpdatePropFragment(List<PropFragmentConfig> configs)
         {
@@ -3484,6 +3535,9 @@ namespace AdminApi.GameConfigs
             }
         }
 
+        /// <summary>
+        /// 更新VIP等级配置
+        /// </summary>
         [HttpPost("UpdateVipLevel")]
         public async Task<BaseResponse<string>> UpdateVipLevel(List<VipLevelConfig> configs)
         {
@@ -3498,6 +3552,9 @@ namespace AdminApi.GameConfigs
                 return this.ToFailResult<string>(res.msg);
         }
 
+        /// <summary>
+        /// 独立更新刮刮卡配置，避免页面提交并覆盖整份游戏配置。
+        /// </summary>
         [HttpPost("UpdateScratchCard")]
         public async Task<BaseResponse<string>> UpdateScratchCard(List<ScratchCardConfig> configs)
         {
@@ -3514,6 +3571,9 @@ namespace AdminApi.GameConfigs
             return res.isok ? this.ToResult(res.msg) : this.ToFailResult<string>(res.msg);
         }
 
+        /// <summary>
+        /// 更新Boss道具掉落配置
+        /// </summary>
         [HttpPost("UpdateBossDrop")]
         public async Task<BaseResponse<string>> UpdateBossDrop(BossDropConfig config)
         {
@@ -3528,6 +3588,9 @@ namespace AdminApi.GameConfigs
 
 
 
+        /// <summary>
+        /// 导出指定板块的配置为JSON文件，产品数据自动从PropConfig富化
+        /// </summary>
         [HttpGet("ExportSection/{sectionName}")]
         public async Task<IActionResult> ExportSection(string sectionName)
         {