lich0821 · lich0821 · May 4, 2025 · May 4, 2025 · May 4, 2025 · May 4, 2025
diff --git a/clients/java/wcf-bmc/CHANGELOG.md b/clients/java/wcf-bmc/CHANGELOG.md
@@ -32,37 +32,45 @@ ___
 
 ### 功能列表
 
-| 接口名            | 地址                     |
-|----------------|------------------------|
-| 查询登录状态         | /loginStatus           |
-| 获取登录微信内部识别号UID | /loginWeChatUid        |
-| 获取登录微信信息       | /loginWeChatInfo       |
-| 获取消息类型列表       | /list/msgType          |
-| 获取联系人列表        | /list/contacts         |
-| 获取数据库表名称列表     | /list/dbTableName      |
-| 获取指定数据库中的表列表   | /list/dbTable          |
-| 执行数据库查询SQL     | /exec/dbQuerySql       |
-| 发送消息汇总入口       | /send/msgMaster        |
-| 发送文本消息         | /send/textMsg          |
-| 发送富文本消息        | /send/richTextMsg      |
-| 发送XML消息        | /send/xmlMsg           |
-| 发送图片消息         | /send/imageMsg         |
-| 发送表情消息         | /send/emojiMsg         |
-| 发送文件消息         | /send/fileMsg          |
-| 拍一拍群友          | /patOnePat             |
-| 撤回消息           | /revokeMsg             |
-| 通过好友申请         | /passFriendApply       |
-| 添加群成员为微信好友     | /addFriend/groupMember |
-| 查询群成员          | /groupMember/list      |
-| 邀请群成员          | /groupMember/invite    |
-| 删除群成员          | /groupMember/delete    |
-| 查询朋友圈          | /friendCircle          |
-| 接收转账           | /receiveTransfer       |
+| 接口名          | 地址                     |
+|--------------|------------------------|
+| 查询登录状态       | /loginStatus           |
+| 获取登录微信号      | /loginWeChatUid        |
+| 获取登录微信信息     | /loginWeChatInfo       |
+| 获取消息类型列表     | /list/msgType          |
+| 获取联系人列表      | /list/contacts         |
+| 获取数据库表名称列表   | /list/dbTableName      |
+| 获取指定数据库中的表列表 | /list/dbTable          |
+| 执行数据库查询SQL   | /exec/dbQuerySql       |
+| 发送消息汇总入口     | /send/msgMaster        |
+| 发送文本消息       | /send/textMsg          |
+| 发送富文本消息      | /send/richTextMsg      |
+| 发送XML消息      | /send/xmlMsg           |
+| 发送图片消息       | /send/imageMsg         |
+| 发送表情消息       | /send/emojiMsg         |
+| 发送文件消息       | /send/fileMsg          |
+| 拍一拍群友        | /patOnePat             |
+| 撤回消息         | /revokeMsg             |
+| 通过好友申请       | /passFriendApply       |
+| 添加群成员为微信好友   | /addFriend/groupMember |
+| 查询群成员        | /groupMember/list      |
+| 邀请群成员        | /groupMember/invite    |
+| 删除群成员        | /groupMember/delete    |
+| 查询朋友圈        | /friendCircle          |
+| 接收转账         | /receiveTransfer       |
 
 ### 已知bug
 
 v39.5.2版本目前会出现注入失败的情况，待排查修复，可先使用v39.5.1，只须替换dll版本即可
 
+### 2025-05-04
+
+- 1.更新拍一拍接口入参
+- 2.客户端内置方法名与PY版本保持一致
+- 3.适配指定参数查询接口
+
+<br/>
+
 ### 2025-05-03
 
 - 1.更新dll为v39.5.2
@@ -87,32 +95,32 @@ ___
 
 ### 功能列表
 
-| 接口名            | 地址                     | 是否支持 | 备注     |
-|----------------|------------------------|------|--------|
-| 查询登录状态         | /loginStatus           | ✔️   | 已测试    |
-| 获取登录微信内部识别号UID | /loginWeChatUid        | ✔️   | 已测试    |
-| 获取登录微信信息       | /loginWeChatInfo       | ✔️   | 已测试    |
-| 获取消息类型列表       | /list/msgType          | ✔️   | 已测试    |
-| 获取联系人列表        | /list/contacts         | ✔️   | 已测试    |
-| 获取数据库表名称列表     | /list/dbTableName      | ✔️   | 已测试    |
-| 获取指定数据库中的表列表   | /list/dbTable          | ✔️   | 已测试    |
-| 执行数据库查询SQL     | /exec/dbQuerySql       | ✔️   | 已测试    |
-| 发送消息汇总入口       | /send/msgMaster        | ❌    | 预留     |
-| 发送文本消息         | /send/textMsg          | ✔️   | 已测试    |
-| 发送富文本消息        | /send/richTextMsg      | ❌    | 已知BUG  |
-| 发送XML消息        | /send/xmlMsg           | ❌    | 该版本不支持 |
-| 发送图片消息         | /send/imageMsg         | ✔️   | 已测试    |
-| 发送表情消息         | /send/emojiMsg         | ✔️   | 已测试    |
-| 发送文件消息         | /send/fileMsg          | ✔️   | 已测试    |
-| 拍一拍群友          | /patOnePat             | ✔️   | 已测试    |
-| 撤回消息           | /revokeMsg             | ❌    | 该版本不支持 |
-| 通过好友申请         | /passFriendApply       | ❌    | 该版本不支持 |
-| 添加群成员为微信好友     | /addFriend/groupMember | ❔    | 待测试    |
-| 查询群成员          | /groupMember/list      | ✔️   | 已测试    |
-| 邀请群成员          | /groupMember/invite    | ❔    | 待测试    |
-| 删除群成员          | /groupMember/delete    | ❔    | 待测试    |
-| 查询朋友圈          | /friendCircle          | ❔    | 待测试    |
-| 接收转账           | /receiveTransfer       | ❌    | 该版本不支持 |
+| 接口名          | 地址                     | 是否支持 | 备注     |
+|--------------|------------------------|------|--------|
+| 查询登录状态       | /loginStatus           | ✔️   | 已测试    |
+| 获取登录微信号      | /loginWeChatUid        | ✔️   | 已测试    |
+| 获取登录微信信息     | /loginWeChatInfo       | ✔️   | 已测试    |
+| 获取消息类型列表     | /list/msgType          | ✔️   | 已测试    |
+| 获取联系人列表      | /list/contacts         | ✔️   | 已测试    |
+| 获取数据库表名称列表   | /list/dbTableName      | ✔️   | 已测试    |
+| 获取指定数据库中的表列表 | /list/dbTable          | ✔️   | 已测试    |
+| 执行数据库查询SQL   | /exec/dbQuerySql       | ✔️   | 已测试    |
+| 发送消息汇总入口     | /send/msgMaster        | ❌    | 预留     |
+| 发送文本消息       | /send/textMsg          | ✔️   | 已测试    |
+| 发送富文本消息      | /send/richTextMsg      | ❌    | 该版本不支持 |
+| 发送XML消息      | /send/xmlMsg           | ❌    | 该版本不支持 |
+| 发送图片消息       | /send/imageMsg         | ✔️   | 已测试    |
+| 发送表情消息       | /send/emojiMsg         | ✔️   | 已测试    |
+| 发送文件消息       | /send/fileMsg          | ✔️   | 已测试    |
+| 拍一拍群友        | /patOnePat             | ✔️   | 已测试    |
+| 撤回消息         | /revokeMsg             | ❌    | 该版本不支持 |
+| 通过好友申请       | /passFriendApply       | ❌    | 该版本不支持 |
+| 添加群成员为微信好友   | /addFriend/groupMember | ❔    | 待测试    |
+| 查询群成员        | /groupMember/list      | ✔️   | 已测试    |
+| 邀请群成员        | /groupMember/invite    | ❔    | 待测试    |
+| 删除群成员        | /groupMember/delete    | ❔    | 待测试    |
+| 查询朋友圈        | /friendCircle          | ❔    | 待测试    |
+| 接收转账         | /receiveTransfer       | ❌    | 该版本不支持 |
 
 ### 提示
 

diff --git a/clients/java/wcf-bmc/src/main/java/com/wechat/ferry/controller/WeChatDllController.java b/clients/java/wcf-bmc/src/main/java/com/wechat/ferry/controller/WeChatDllController.java
@@ -72,7 +72,7 @@ public TResponse<Object> loginStatus() {
         return TResponse.ok(ResponseCodeEnum.SUCCESS, status);
     }
 
-    @ApiOperation(value = "获取登录微信内部识别号UID", notes = "queryLoginWeChatUid")
+    @ApiOperation(value = "获取登录微信号", notes = "queryLoginWeChatUid")
     @PostMapping(value = "/loginWeChatUid")
     public TResponse<Object> queryLoginWeChatUid() {
         String weChatUid = weChatDllService.queryLoginWeChatUid();
@@ -186,6 +186,7 @@ public TResponse<WxPpWcfSendPatOnePatMsgResp> patOnePat(@Validated @RequestBody
     @ApiOperation(value = "撤回消息", notes = "revokeMsg")
     @PostMapping(value = "/revokeMsg")
     public TResponse<Object> revokeMsg(@Validated @RequestBody WxPpWcfRevokeMsgReq request) {
+        weChatDllService.revokeMsg(request);
         return TResponse.ok(ResponseCodeEnum.SUCCESS);
     }
 
@@ -246,7 +247,7 @@ public TResponse<Object> deleteGroupMember(@Validated @RequestBody WxPpWcfDelete
     @ApiOperation(value = "查询朋友圈", notes = "queryFriendCircle")
     @PostMapping(value = "/friendCircle")
     public TResponse<Object> queryFriendCircle() {
-        weChatDllService.queryFriendCircle();
+        weChatDllService.queryFriendCircle(0);
         return TResponse.ok(ResponseCodeEnum.SUCCESS);
     }
 

diff --git a/...a/wcf-bmc/src/main/java/com/wechat/ferry/entity/vo/request/WxPpWcfPassFriendApplyReq.java b/...a/wcf-bmc/src/main/java/com/wechat/ferry/entity/vo/request/WxPpWcfPassFriendApplyReq.java
@@ -17,23 +17,22 @@
 public class WxPpWcfPassFriendApplyReq {
 
     /**
-     * 申请人
+     * 加密用户名
      * v3 xml.attrib["encryptusername"]
      * 加密用户名 (好友申请消息里 v3 开头的字符串)
      */
-    @NotBlank(message = "申请人不能为空")
-    @ApiModelProperty(value = "申请人")
-    private String applicant;
+    @NotBlank(message = "加密用户名不能为空")
+    @ApiModelProperty(value = "加密用户名")
+    private String encryptUsername;
 
     /**
-     * 审核人
+     * ticket
      * v4 xml.attrib["ticket"]
      * Ticket (好友申请消息里 v4 开头的字符串)
-     * 一般指自己，别人申请添加，自己审核是否通过
      */
-    @NotBlank(message = "审核人不能为空")
-    @ApiModelProperty(value = "审核人")
-    private String reviewer;
+    @NotBlank(message = "ticket不能为空")
+    @ApiModelProperty(value = "ticket")
+    private String ticket;
 
     /**
      * 场景

diff --git a/...ts/java/wcf-bmc/src/main/java/com/wechat/ferry/entity/vo/request/WxPpWcfRevokeMsgReq.java b/...ts/java/wcf-bmc/src/main/java/com/wechat/ferry/entity/vo/request/WxPpWcfRevokeMsgReq.java
@@ -19,7 +19,7 @@ public class WxPpWcfRevokeMsgReq {
     /**
      * 消息编号
      */
-    @ApiModelProperty(value = "场景")
+    @ApiModelProperty(value = "消息编号")
     private String msgId;
 
 }
diff --git a/...java/wcf-bmc/src/main/java/com/wechat/ferry/entity/vo/request/WxPpWcfSendEmojiMsgReq.java b/...java/wcf-bmc/src/main/java/com/wechat/ferry/entity/vo/request/WxPpWcfSendEmojiMsgReq.java
@@ -16,14 +16,6 @@
 @ApiModel(value = "wxPpWcfSendEmojiMsgReq", description = "个微WCF发送表情消息请求入参")
 public class WxPpWcfSendEmojiMsgReq {
 
-    /**
-     * 资源路径-本地表情路径
-     * 需要确保图片路径正确，建议使用绝对路径（使用双斜杠\\）
-     */
-    @NotBlank(message = "资源路径不能为空")
-    @ApiModelProperty(value = "资源路径-本地表情路径")
-    private String resourcePath;
-
     /**
      * 消息接收人
      * 消息接收人，私聊为 wxid（wxid_xxxxxxxxxxxxxx）
@@ -33,4 +25,12 @@ public class WxPpWcfSendEmojiMsgReq {
     @ApiModelProperty(value = "消息接收人")
     private String recipient;
 
+    /**
+     * 资源路径-本地表情路径
+     * 需要确保图片路径正确，建议使用绝对路径（使用双斜杠\\）
+     */
+    @NotBlank(message = "资源路径不能为空")
+    @ApiModelProperty(value = "资源路径-本地表情路径")
+    private String resourcePath;
+
 }
diff --git a/.../java/wcf-bmc/src/main/java/com/wechat/ferry/entity/vo/request/WxPpWcfSendFileMsgReq.java b/.../java/wcf-bmc/src/main/java/com/wechat/ferry/entity/vo/request/WxPpWcfSendFileMsgReq.java
@@ -16,13 +16,6 @@
 @ApiModel(value = "wxPpWcfSendFileMsgReq", description = "个微WCF发送文件消息请求入参")
 public class WxPpWcfSendFileMsgReq {
 
-    /**
-     * 资源路径-本地文件路径
-     */
-    @NotBlank(message = "资源路径不能为空")
-    @ApiModelProperty(value = "资源路径-本地文件路径")
-    private String resourcePath;
-
     /**
      * 消息接收人
      * 消息接收人，私聊为 wxid（wxid_xxxxxxxxxxxxxx）
@@ -32,4 +25,11 @@ public class WxPpWcfSendFileMsgReq {
     @ApiModelProperty(value = "消息接收人")
     private String recipient;
 
+    /**
+     * 资源路径-本地文件路径
+     */
+    @NotBlank(message = "资源路径不能为空")
+    @ApiModelProperty(value = "资源路径-本地文件路径")
+    private String resourcePath;
+
 }
diff --git a/...java/wcf-bmc/src/main/java/com/wechat/ferry/entity/vo/request/WxPpWcfSendImageMsgReq.java b/...java/wcf-bmc/src/main/java/com/wechat/ferry/entity/vo/request/WxPpWcfSendImageMsgReq.java
@@ -16,6 +16,15 @@
 @ApiModel(value = "wxPpWcfSendImageMsgReq", description = "个微WCF发送图片消息请求入参")
 public class WxPpWcfSendImageMsgReq {
 
+    /**
+     * 消息接收人
+     * 消息接收人，私聊为 wxid（wxid_xxxxxxxxxxxxxx）
+     * 群聊为 roomid（xxxxxxxxxx@chatroom）
+     */
+    @NotBlank(message = "消息接收人不能为空")
+    @ApiModelProperty(value = "消息接收人")
+    private String recipient;
+
     /**
      * 资源路径-本地图片地址
      * 需要确保图片路径正确，建议使用绝对路径（使用双斜杠\\）
@@ -26,13 +35,4 @@ public class WxPpWcfSendImageMsgReq {
     @ApiModelProperty(value = "资源路径-本地图片地址")
     private String resourcePath;
 
-    /**
-     * 消息接收人
-     * 消息接收人，私聊为 wxid（wxid_xxxxxxxxxxxxxx）
-     * 群聊为 roomid（xxxxxxxxxx@chatroom）
-     */
-    @NotBlank(message = "消息接收人不能为空")
-    @ApiModelProperty(value = "消息接收人")
-    private String recipient;
-
 }
diff --git a/.../java/wcf-bmc/src/main/java/com/wechat/ferry/entity/vo/request/WxPpWcfSendTextMsgReq.java b/.../java/wcf-bmc/src/main/java/com/wechat/ferry/entity/vo/request/WxPpWcfSendTextMsgReq.java
@@ -18,15 +18,6 @@
 @ApiModel(value = "wxPpWcfSendTextMsgReq", description = "个微WCF发送文本消息请求入参")
 public class WxPpWcfSendTextMsgReq {
 
-    /**
-     * 消息文本
-     * 消息内容（如果是 @ 消息则需要有跟 @ 的人数量相同的 @）
-     * 换行使用 `\\\\n` （单杠）
-     */
-    @NotBlank(message = "消息文本不能为空")
-    @ApiModelProperty(value = "消息文本")
-    private String msgText;
-
     /**
      * 消息接收人
      * 消息接收人，私聊为 wxid（wxid_xxxxxxxxxxxxxx）
@@ -36,6 +27,15 @@ public class WxPpWcfSendTextMsgReq {
     @ApiModelProperty(value = "消息接收人")
     private String recipient;
 
+    /**
+     * 消息文本
+     * 消息内容（如果是 @ 消息则需要有跟 @ 的人数量相同的 @）
+     * 换行使用 `\\\\n` （单杠）
+     */
+    @NotBlank(message = "消息文本不能为空")
+    @ApiModelProperty(value = "消息文本")
+    private String msgText;
+
     /**
      * 要艾特的用户
      * 群聊时要 @ 的人（私聊时为空字符串），多个用逗号分隔。

diff --git a/...a/wcf-bmc/src/main/java/com/wechat/ferry/entity/vo/response/WxPpWcfDatabaseTableResp.java b/...a/wcf-bmc/src/main/java/com/wechat/ferry/entity/vo/response/WxPpWcfDatabaseTableResp.java
@@ -21,7 +21,7 @@ public class WxPpWcfDatabaseTableResp {
     private String tableName;
 
     /**
-     * SQL
+     * 该数据库下的所有表名及对应建表语句
      */
     @ApiModelProperty(value = "SQL")
     private String sql;