第二个版本

Administrator

2026-05-18 53dba56501e03dcf761fc9ac7bedbfdc922eefec

 src/main/java/com/xcong/excoin/modules/gateApi/GateConfig.java

@@ -1,6 +1,8 @@
package com.xcong.excoin.modules.gateApi;

import java.math.BigDecimal;
import java.util.ArrayList;
import java.util.List;

/**
 * Gate 模块统一配置。
@@ -8,20 +10,27 @@
 * <p>通过 Builder 模式集中管理所有运行参数，避免参数散落在多个文件中。
 * 提供 REST API 和 WebSocket 地址的自动环境切换（测试网/生产网）。
 *
 * <h3>关键参数</h3>
 * <ul>
 *   <li><b>网格参数</b>：gridRate（比例间距）、step（绝对步长 = shortBaseEntryPrice × gridRate，运行时计算）、
 *       gridQueueSize（队列容量）</li>
 *   <li><b>止盈止损</b>：overallTp（整体止盈 USDT）、maxLoss（最大亏损 USDT）</li>
 *   <li><b>风险控制</b>：marginRatioLimit（保证金占比上限，超限跳过开仓）、leverage（杠杆）、
 *       marginMode（全仓/逐仓）、positionMode（单向/双向）</li>
 *   <li><b>盈亏计算</b>：contractMultiplier（合约乘数）、unrealizedPnlPriceMode（计价模式：最新价/标记价）</li>
 * </ul>
 *
 * <h3>使用示例</h3>
 * <pre>
 *   GateConfig config = GateConfig.builder()
 *       .apiKey("...")
 *       .apiSecret("...")
 *       .contract("XAU_USDT")
 *       .contract("ETH_USDT")
 *       .leverage("100")
 *       .gridRate(new BigDecimal("0.0035"))
 *       .contractMultiplier("0.001")
 *       .contractMultiplier("0.01")
 *       .isProduction(false)
 *       .build();
 *
 *   String restUrl = config.getRestBasePath();  // 自动返回测试网或生产网地址
 *   String wsUrl   = config.getWsUrl();
 * </pre>
 *
 * <h3>默认值</h3>
@@ -36,11 +45,18 @@
 */
public class GateConfig {

    /** 未实现盈亏计价模式 */
    /**
     * 未实现盈亏（unrealizedPnl）计价模式。
     *
     * <ul>
     *   <li>{@link #LAST_PRICE} — 按最新成交价计算，变动快、更贴近实际平仓价</li>
     *   <li>{@link #MARK_PRICE} — 按标记价格计算，变动平稳、过滤市场噪音</li>
     * </ul>
     */
    public enum PnLPriceMode {
        /** 按最新成交价计算 */
        /** 按最新成交价计算未实现盈亏 */
        LAST_PRICE,
        /** 按标记价格计算 */
        /** 按标记价格计算未实现盈亏，需通过 {@link GateGridTradeService#setMarkPrice(BigDecimal)} 注入 */
        MARK_PRICE
    }

@@ -78,6 +94,12 @@
    private final PnLPriceMode unrealizedPnlPriceMode;
    /** 网格绝对步长（shortBaseEntryPrice × gridRate），运行时由队列生成逻辑设置 */
    private BigDecimal step;
    /** 网格元素列表，由队列初始化时同步填充，包含完整的多空仓挂单状态 */
    private volatile List<GridElement> gridElements = new ArrayList<>();
    /** 基座多头挂单参数，在基座成交后由 tryGenerateQueues 填充 */
    private TraderParam baseLongTraderParam;
    /** 基座空头挂单参数，在基座成交后由 tryGenerateQueues 填充 */
    private TraderParam baseShortTraderParam;

    private GateConfig(Builder builder) {
        this.apiKey = builder.apiKey;
@@ -181,6 +203,28 @@
    /** 设置网格绝对步长（由 generateShortQueue 在运行时计算并注入） */
    public void setStep(BigDecimal step) { this.step = step; }

    // ==================== 网格元素列表 ====================

    /** @return 网格元素列表（队列初始化后填充），线程不安全，仅由策略线程单线程写入 */
    public List<GridElement> getGridElements() { return gridElements; }
    /** 设置网格元素列表（由队列生成逻辑写入），同时重建全局 ID 索引 */
    public void setGridElements(List<GridElement> gridElements) {
        this.gridElements = gridElements;
        GridElement.rebuildIndex(gridElements);
    }

    // ==================== 基座挂单参数 ====================

    /** @return 基座多头挂单参数 */
    public TraderParam getBaseLongTraderParam() { return baseLongTraderParam; }
    /** 设置基座多头挂单参数（由 tryGenerateQueues 在基座成交后填充） */
    public void setBaseLongTraderParam(TraderParam baseLongTraderParam) { this.baseLongTraderParam = baseLongTraderParam; }

    /** @return 基座空头挂单参数 */
    public TraderParam getBaseShortTraderParam() { return baseShortTraderParam; }
    /** 设置基座空头挂单参数（由 tryGenerateQueues 在基座成交后填充） */
    public void setBaseShortTraderParam(TraderParam baseShortTraderParam) { this.baseShortTraderParam = baseShortTraderParam; }

    // ==================== 环境 ====================

    /** @return 是否为生产环境（true=实盘生产网 / false=模拟盘测试网） */
@@ -226,7 +270,7 @@
        /** 补仓最大重试次数，默认 3 */
        private int reopenMaxRetries = 3;
        /** 网格队列容量，默认 50 */
        private int gridQueueSize = 50;
        private int gridQueueSize = 300;
        /** 保证金占初始本金比例上限，默认 0.2（20%） */
        private BigDecimal marginRatioLimit = new BigDecimal("0.2");
        /** 合约乘数，默认 0.001 */