✨ Added sendForwardMsg action for LagrangeExtend #216

* [add]: 自定义消息合并转发 兼容 Lagrange

* [add]: 发送合并转发消息 兼容 Lagrange

* [add]: 改为任意List

src/main/java/com/mikuac/shiro/action/LagrangeExtend.java

@@ -1,7 +1,11 @@
 package com.mikuac.shiro.action;
 
+import com.mikuac.shiro.dto.action.common.ActionData;
 import com.mikuac.shiro.dto.action.common.ActionList;
 
+import java.util.List;
+import java.util.Map;
+
 public interface LagrangeExtend {
 
     /**
@@ -11,4 +15,12 @@ public interface LagrangeExtend {
      */
     ActionList<String> fetchCustomFace();
 
+    /**
+     * 发送合并转发
+     *
+     * @param msg 自定义转发消息 (可使用 ShiroUtils.generateForwardMsg() 方法创建)
+     * @return result {@link ActionData} of {@link String} 合并转发的 longmsg Id
+     */
+    ActionData<String> sendForwardMsg(List<Map<String, Object>> msg);
+
 }

src/main/java/com/mikuac/shiro/common/utils/ArrayMsgUtils.java

@@ -185,6 +185,16 @@ public ArrayMsgUtils rps(int value) {
         return this;
     }
 
+    public ArrayMsgUtils longMsg(String id) {
+        builder.add(getJsonData("longmsg", m -> m.put("id", id)));
+        return this;
+    }
+
+    public ArrayMsgUtils forward(String id) {
+        builder.add(getJsonData("forward", m -> m.put("id", id)));
+        return this;
+    }
+
     public ArrayMsgUtils markdown(String content) {
         builder.add(getJsonData("markdown", m -> {
             HashMap<String, String> map = new HashMap<>();

src/main/java/com/mikuac/shiro/common/utils/MsgUtils.java

@@ -347,6 +347,30 @@ public MsgUtils rps(int value) {
         return this;
     }
 
+    /**
+     * 发送长消息
+     *
+     * @param id 长消息Id
+     * @return {@link MsgUtils}
+     */
+    public MsgUtils longMsg(String id) {
+        String code = String.format("[CQ:longmsg,id=%s]", id);
+        builder.append(code);
+        return this;
+    }
+
+    /**
+     * 发送合并转发消息
+     *
+     * @param id 合并转发消息Id
+     * @return {@link MsgUtils}
+     */
+    public MsgUtils forward(String id) {
+        String code = String.format("[CQ:forward,id=%s]", id);
+        builder.append(code);
+        return this;
+    }
+
     /**
      * 构建消息链
      *

src/main/java/com/mikuac/shiro/common/utils/ShiroUtils.java

@@ -306,6 +306,29 @@ public static List<Map<String, Object>> generateForwardMsg(List<String> contents
         return nodes;
     }
 
+    /**
+     * 兼容 Lagrange
+     * 生成自定义合并转发消息
+     *
+     * @param contents 消息列表，每个元素视为一个消息节点 Object 可为 List<ArrayMsg> 或 CQCode
+     * @return 消息结构
+     */
+    @SuppressWarnings("Duplicates")
+    public static List<Map<String, Object>> generateForwardMsg(String uin, String name, List<?> contents) {
+        List<Map<String, Object>> nodes = new ArrayList<>();
+        contents.forEach(msg -> {
+            Map<String, Object> node = new HashMap<>();
+            node.put("type", "node");
+            Map<String, Object> data = new HashMap<>();
+            data.put("name", name);
+            data.put("uin", uin);
+            data.put("content", msg);
+            node.put("data", data);
+            nodes.add(node);
+        });
+        return nodes;
+    }
+
     /**
      * 兼容 Shamrock
      * 生成引用消息和自定义消息混合合并转发

src/main/java/com/mikuac/shiro/core/Bot.java

@@ -1348,6 +1348,21 @@ public ActionList<String> fetchCustomFace() {
         }.getType()) : null;
     }
 
+    /**
+     * 获取合并转发消息Id
+     *
+     * @param msg 自定义转发消息 (可使用 ShiroUtils.generateForwardMsg() 方法创建)
+     * @return result {@link ActionData} of {@link String} 合并转发的消息Id
+     */
+    @Override
+    public ActionData<String> sendForwardMsg(List<Map<String, Object>> msg) {
+        JSONObject params = new JSONObject();
+        params.put(ActionParams.MESSAGES, msg);
+        JSONObject result = actionHandler.action(session, ActionPathEnum.SEND_FORWARD_MSG, params);
+        return result != null ? result.to(new TypeReference<ActionData<String>>() {
+        }.getType()) : null;
+    }
+
     /**
      * 自定义请求
      *

src/main/java/com/mikuac/shiro/enums/MsgTypeEnum.java

@@ -156,6 +156,11 @@ public enum MsgTypeEnum {
      */
     tts,
 
+    /**
+     * 长消息
+     */
+    longmsg,
+
     /**
      * 未知类型
      */