From 01da1f754426a1285fc20b9cf1b80672b16d8814 Mon Sep 17 00:00:00 2001
From: Administrator <15274802129@163.com>
Date: Fri, 08 May 2026 15:04:28 +0800
Subject: [PATCH] refactor(gateApi): 重构网格交易服务添加补仓重试机制

---
 src/main/java/com/xcong/excoin/modules/gateApi/wsHandler/handler/PositionClosesChannelHandler.java |   21 +++++++++++++--------
 1 files changed, 13 insertions(+), 8 deletions(-)

diff --git a/src/main/java/com/xcong/excoin/modules/gateApi/wsHandler/handler/PositionClosesChannelHandler.java b/src/main/java/com/xcong/excoin/modules/gateApi/wsHandler/handler/PositionClosesChannelHandler.java
index deefcdb..78950bb 100644
--- a/src/main/java/com/xcong/excoin/modules/gateApi/wsHandler/handler/PositionClosesChannelHandler.java
+++ b/src/main/java/com/xcong/excoin/modules/gateApi/wsHandler/handler/PositionClosesChannelHandler.java
@@ -10,7 +10,16 @@
 
 /**
  * 平仓频道处理器。
- * 私有频道,需认证。解析平仓推送后回调 {@link GateGridTradeService#onPositionClose}。
+ *
+ * <h3>数据用途</h3>
+ * 每笔平仓发生时推送 pnl(盈亏金额),累加到 {@code cumulativePnl} 用于判断策略停止条件:
+ * cumulativePnl ≥ overallTp(达到止盈目标)或 ≤ -maxLoss(超过亏损上限)。
+ *
+ * <h3>推送字段</h3>
+ * contract, side(long / short), pnl(该次平仓的盈亏,如 "+0.2" 或 "-0.1")
+ *
+ * <h3>注意</h3>
+ * 平仓盈亏来自服务器端,不受本地计算误差影响。这是策略停止的唯一盈亏判断来源。
  *
  * @author Administrator
  */
@@ -27,8 +36,7 @@
 
     @Override
     public boolean handleMessage(JSONObject response) {
-        String channel = response.getString("channel");
-        if (!CHANNEL_NAME.equals(channel)) {
+        if (!CHANNEL_NAME.equals(response.getString("channel"))) {
             return false;
         }
         try {
@@ -43,15 +51,12 @@
                 }
                 BigDecimal pnl = new BigDecimal(item.getString("pnl"));
                 String side = item.getString("side");
-                log.info("[{}] 推送: contract={}, side={}, pnl={}",
-                        CHANNEL_NAME, getContract(), side, pnl);
+                log.info("[{}] 平仓更新, 方向:{}, 盈亏:{}", CHANNEL_NAME, side, pnl);
                 if (getGridTradeService() != null) {
                     getGridTradeService().onPositionClose(getContract(), side, pnl);
                 }
             }
-        } catch (Exception e) {
-            log.error("[{}] 处理数据失败", CHANNEL_NAME, e);
-        }
+        } catch (Exception e) { log.error("[{}] 处理数据失败", CHANNEL_NAME, e); }
         return true;
     }
 }

--
Gitblit v1.9.1