From 60d0e9bd70f87de69b378ab63bac60394e3ff696 Mon Sep 17 00:00:00 2001
From: Administrator <15274802129@163.com>
Date: Mon, 11 May 2026 11:31:52 +0800
Subject: [PATCH] feat(gate): 添加多账号支持和日志标签区分功能
---
src/main/java/com/xcong/excoin/modules/gateApi/wsHandler/handler/PositionsChannelHandler.java | 31 ++++++++++++++++++++++++++++---
1 files changed, 28 insertions(+), 3 deletions(-)
diff --git a/src/main/java/com/xcong/excoin/modules/gateApi/wsHandler/handler/PositionsChannelHandler.java b/src/main/java/com/xcong/excoin/modules/gateApi/wsHandler/handler/PositionsChannelHandler.java
index d55452d..4b6bf50 100644
--- a/src/main/java/com/xcong/excoin/modules/gateApi/wsHandler/handler/PositionsChannelHandler.java
+++ b/src/main/java/com/xcong/excoin/modules/gateApi/wsHandler/handler/PositionsChannelHandler.java
@@ -10,15 +10,40 @@
import java.math.BigDecimal;
/**
- * 仓位频道处理器。
+ * 仓位频道处理器（futures.positions）。
*
* <h3>数据用途</h3>
* 监控仓位数量（size）和入场价（entry_price）。
* 有仓位时（size.abs > 0）：标记方向活跃，记录入场价 → 基底首次成交记录基底入场价并等待生成网格队列，
* 非基底成交立即设止盈条件单。无仓位时（size=0）：标记方向不活跃。
*
- * <h3>推送字段</h3>
- * contract, mode（dual_long / dual_short）, size（正=多头，负=空头），entry_price
+ * <h3>完整推送字段（共20个，日志全部输出）</h3>
+ * <table>
+ * <tr><th>字段</th><th>类型</th><th>描述</th></tr>
+ * <tr><td>contract</td><td>String</td><td>合约名称</td></tr>
+ * <tr><td>mode</td><td>String</td><td>持仓模式：dual_long / dual_short</td></tr>
+ * <tr><td>size</td><td>String/Integer</td><td>合约张数（正=多头，负=空头）</td></tr>
+ * <tr><td>entry_price</td><td>Float</td><td>开仓均价</td></tr>
+ * <tr><td>cross_leverage_limit</td><td>Float</td><td>全仓模式下的杠杆倍数上限</td></tr>
+ * <tr><td>history_pnl</td><td>Float</td><td>已平仓的仓位总盈亏</td></tr>
+ * <tr><td>history_point</td><td>Float</td><td>已平仓的点卡总盈亏</td></tr>
+ * <tr><td>last_close_pnl</td><td>Float</td><td>最近一次平仓的盈亏</td></tr>
+ * <tr><td>leverage</td><td>Integer</td><td>杠杆倍数（0=全仓，正数=逐仓）</td></tr>
+ * <tr><td>leverage_max</td><td>Integer</td><td>当前风险限额下允许的最大杠杆倍数</td></tr>
+ * <tr><td>liq_price</td><td>Float</td><td>爆仓价格</td></tr>
+ * <tr><td>maintenance_rate</td><td>Float</td><td>当前风险限额下维持保证金比例</td></tr>
+ * <tr><td>margin</td><td>Float</td><td>保证金</td></tr>
+ * <tr><td>realised_pnl</td><td>Float</td><td>已实现盈亏</td></tr>
+ * <tr><td>realised_point</td><td>Float</td><td>点卡已实现盈亏</td></tr>
+ * <tr><td>risk_limit</td><td>Integer</td><td>风险限额</td></tr>
+ * <tr><td>time</td><td>Integer</td><td>更新 unix 时间戳（秒）</td></tr>
+ * <tr><td>time_ms</td><td>Integer</td><td>更新 unix 时间戳（毫秒）</td></tr>
+ * <tr><td>user</td><td>String</td><td>用户 ID</td></tr>
+ * <tr><td>update_id</td><td>Integer</td><td>消息序列号，每次推送 order 后自增1</td></tr>
+ * </table>
+ *
+ * <h3>回调数据（传给 GateGridTradeService）</h3>
+ * mode (Position.ModeEnum), size (BigDecimal), entry_price (BigDecimal)
*
* <h3>注意</h3>
* 双向持仓模式下空头 size 为负数，使用 {@code size.abs()} 判断是否有仓位。
--
Gitblit v1.9.1