钉钉群机器人消息发送工具

1. 概述

封装钉钉群机器人 Webhook API，支持三种消息类型：**文本**（text）、**Markdown**、**ActionCard（卡片+按钮）**。

文件位置：
- com.xcong.excoin.utils.dingtalk.DingTalkUtils — 消息发送核心类
- com.xcong.excoin.utils.dingtalk.DingTalkType — 通知类型枚举

依赖：taobao-sdk-java.jar（本地 jar，已配置在 lib/ 目录下）

2. 快速开始

2.1 创建发送器

DingTalkUtils robot = new DingTalkUtils(accessToken, secret);

参数说明：
| 参数 | 来源 |
|------|------|
| accessToken | 机器人 Webhook URL 中 access_token= 后面的部分 |
| secret | 机器人安全设置 → 加签 → 密钥（勾选后才需要） |

机器人创建步骤：群设置 → 智能群助手 → 添加机器人 → 自定义 → 安全设置选"加签" → 复制 Webhook URL 和密钥。

2.2 发送文本消息

robot.sendText("充值到账通知：用户123 充值 1000 USDT");

2.3 发送 Markdown 消息

robot.sendMarkdown("策略止盈通知",
    "## 网格策略止盈\n" +
    "- 累计盈亏: **+2.5 USDT**\n" +
    "- 当前价格: 3450.12\n" +
    "- 触发时间: 15:30:00");

2.4 发送 ActionCard（卡片+跳转按钮）

robot.sendActionCard(
    "止盈通知",                              // 标题
    "### 策略已达到止盈目标\n" +              // 正文（支持 Markdown）
    "- 累计盈亏: **+5.0 USDT**\n" +
    "- 策略已自动停止",
    "查看详情",                              // 按钮文字
    "https://your-site.com/strategy/detail"    // 跳转链接
);

3. API 参考

3.1 构造方法

3.2 实例方法

3.3 静态方法（向后兼容旧代码）

4. 通知类型枚举

public enum DingTalkType {
    PAY_CONFIRM("充值确认", 1),
    FAST_SALE("快速卖出", 2),
    TI_COIN("提币通知", 3),
    CARD_VERIFY("实名认证", 4),
    BLOCK_COIN("链上转账通知", 5);
}

5. 使用示例

5.1 Gradient Trading 策略集成

// 在 GateGridTradeService 中注入 DingTalkUtils
private final DingTalkUtils dingTalk;

public GateGridTradeService(GateConfig config, DingTalkUtils dingTalk) {
    this.config = config;
    this.dingTalk = dingTalk;
    // ...
}

// 止盈时通知
public void onPositionClose(...) {
    if (totalPnl.compareTo(config.getOverallTp()) >= 0) {
        dingTalk.sendMarkdown("策略止盈",
            "## 网格策略已止盈\n" +
            "- 合约: " + config.getContract() + "\n" +
            "- 累计盈亏: **" + cumulativePnl + " USDT**\n" +
            "- 浮动盈亏: " + unrealizedPnl + " USDT");
        state = StrategyState.STOPPED;
    }
}

// 止损通知
if (totalPnl.compareTo(config.getMaxLoss().negate()) <= 0) {
    dingTalk.sendText("‼ 策略亏损预警: " + totalPnl + " USDT，已停止");
    state = StrategyState.STOPPED;
}

5.2 Spring Boot 集成

@Configuration
public class DingTalkConfig {

    @Value("${dingtalk.access-token}")
    private String accessToken;

    @Value("${dingtalk.secret}")
    private String secret;

    @Bean
    public DingTalkUtils dingTalkUtils() {
        return new DingTalkUtils(accessToken, secret);
    }
}

application.yml:
yaml dingtalk: access-token: 161d5e5b60ae5d6b4c80f2a9c35f9f212961a7c7154aa7e94b99503eca3886b0 secret: SECc0b73559742b950f07eabbd050c406a6abb3b67d112d3735289e90f58884c543

5.3 旧代码兼容（无需修改）

以下旧写法仍然有效：

// ThreadPoolUtils 中的旧调用，无需修改
ThreadPoolUtils.sendDingTalk(5);  // → 发送"链上转账通知" ActionCard

6. 对比旧版变更