@gloablehive/ipad-wechat-plugin 1.0.0 → 1.0.2

package/dist/src/client.js

@@ -0,0 +1,610 @@
+/**
+ * iPad WeChat API Client (聚合聊天开放平台)
+ *
+ * Gateway: https://chat-api.juhebot.com/open/GuidRequest
+ * 文档: data/ipad-wechat/AI-READABLE-OVERVIEW.md
+ * API Paths: data/ipad-wechat/apifox/apis/
+ */
+const GATEWAY_URL = "https://chat-api.juhebot.com/open/GuidRequest";
+/**
+ * Call JuHeBot API Gateway
+ */
+async function callApi(config, path, data) {
+    const requestBody = {
+        app_key: config.appKey,
+        app_secret: config.appSecret,
+        path,
+        data: {
+            guid: config.guid,
+            ...data,
+        },
+    };
+    console.log('[JuHeBot API] Request:', { path, data: requestBody.data });
+    const response = await fetch(GATEWAY_URL, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify(requestBody),
+    });
+    const result = await response.json();
+    console.log('[JuHeBot API] Response:', result);
+    // Handle error response
+    if (result.err_code !== undefined && result.err_code !== 0) {
+        throw new Error(`API Error: ${result.err_msg} (code: ${result.err_code})`);
+    }
+    if (result.code !== undefined && result.code !== 0) {
+        throw new Error(`API Error: ${result.msg} (code: ${result.code})`);
+    }
+    return result;
+}
+export function createIPadClient(config) {
+    return {
+        // ========== 实例管理 (Instance) ==========
+        /**
+         * 获取实例状态
+         * Path: /instance/get_status
+         */
+        async getDeviceStatus() {
+            return await callApi(config, "/instance/get_status", {});
+        },
+        /**
+         * 恢复实例
+         * Path: /instance/restore
+         */
+        async restoreInstance() {
+            return await callApi(config, "/instance/restore", {});
+        },
+        /**
+         * 停止实例
+         * Path: /instance/stop
+         */
+        async stopInstance() {
+            return await callApi(config, "/instance/stop", {});
+        },
+        /**
+         * 设置实例通知地址 (回调地址)
+         * Path: /instance/set_notify_url
+         */
+        async setNotifyUrl(notifyUrl) {
+            await callApi(config, "/instance/set_notify_url", { notifyUrl });
+        },
+        /**
+         * 设置实例桥接ID
+         * Path: /instance/set_bridge_id
+         */
+        async setBridgeId(bridgeId) {
+            await callApi(config, "/instance/set_bridge_id", { bridgeId });
+        },
+        // ========== 用户 (User) ==========
+        /**
+         * 获取登录账号信息
+         * Path: /user/get_profile
+         */
+        async getLoginAccountInfo() {
+            const res = await callApi(config, "/user/get_profile", {});
+            return res.data || {};
+        },
+        /**
+         * 获取个人二维码
+         * Path: /user/get_qrcode
+         */
+        async getQRCode() {
+            return await callApi(config, "/user/get_qrcode", {});
+        },
+        /**
+         * 退出登录
+         * Path: /user/logout
+         */
+        async logout() {
+            return await callApi(config, "/user/logout", {});
+        },
+        // ========== 联系人 (Contact) ==========
+        /**
+         * 同步联系人
+         * Path: /contact/init_contact
+         */
+        async syncContacts() {
+            const res = await callApi(config, "/contact/init_contact", {});
+            // API returns contactUsernameList array directly in response
+            const contactList = res.contactUsernameList || res.data?.contactUsernameList || [];
+            // Convert to Contact format (wechatId is the username)
+            return contactList.map((wechatId) => ({
+                wechatId,
+                nickName: "",
+                remark: "",
+            }));
+        },
+        /**
+         * 获取联系人详细
+         * Path: /contact/get_contact
+         */
+        async getContactDetail(wechatId) {
+            const res = await callApi(config, "/contact/get_contact", { userId: wechatId });
+            return res.data || {};
+        },
+        /**
+         * 批量获取联系人简要信息
+         * Path: /contact/batch_get_contact_brief_info
+         */
+        async batchGetContactBriefInfo(wechatIds) {
+            const res = await callApi(config, "/contact/batch_get_contact_brief_info", { userIds: wechatIds });
+            return res.data?.contacts || [];
+        },
+        /**
+         * 搜索联系人
+         * Path: /contact/search_contact
+         */
+        async searchContact(searchType, value) {
+            return await callApi(config, "/contact/search_contact", { searchType, value });
+        },
+        /**
+         * 添加好友
+         * Path: /contact/add_friend
+         */
+        async addFriend(v3, verifyMessage) {
+            return await callApi(config, "/contact/add_friend", { v3, verifyMessage });
+        },
+        /**
+         * 验证好友申请
+         * Path: /contact/verify_friend
+         */
+        async verifyFriend(who, status, ticket) {
+            return await callApi(config, "/contact/verify_friend", { who, status, ticket });
+        },
+        /**
+         * 修改好友备注
+         * Path: /contact/modify_remark
+         */
+        async updateFriendRemark(wechatId, remark) {
+            await callApi(config, "/contact/modify_remark", { userId: wechatId, remark });
+        },
+        /**
+         * 删除好友
+         * Path: /contact/del_friend
+         */
+        async deleteFriend(wechatId) {
+            return await callApi(config, "/contact/del_friend", { userId: wechatId });
+        },
+        /**
+         * 置顶聊天
+         * Path: /contact/modify_contact_top_flag
+         */
+        async setContactTop(wechatId, flag) {
+            return await callApi(config, "/contact/modify_contact_top_flag", { userId: wechatId, flag });
+        },
+        // ========== 消息发送 (Msg) ==========
+        /**
+         * 发送文本消息
+         * Path: /msg/send_text
+         */
+        async sendFriendMessage(params) {
+            const res = await callApi(config, "/msg/send_text", {
+                toUser: params.friendWechatId,
+                content: params.content,
+            });
+            return {
+                messageId: res.data?.messageId || `msg_${Date.now()}`,
+                msgSvrId: res.data?.msgSvrId || "",
+            };
+        },
+        /**
+         * 发送群@消息
+         * Path: /msg/send_room_at
+         */
+        async sendRoomMessage(params) {
+            const res = await callApi(config, "/msg/send_room_at", {
+                roomId: params.roomId,
+                content: params.content,
+            });
+            return {
+                messageId: res.data?.messageId || `msg_${Date.now()}`,
+                msgSvrId: res.data?.msgSvrId || "",
+            };
+        },
+        /**
+         * 发送图片
+         * Path: /msg/send_image
+         */
+        async sendFriendMedia(params) {
+            const res = await callApi(config, "/msg/send_image", {
+                toUser: params.friendWechatId,
+                filePath: params.filePath,
+            });
+            return {
+                messageId: res.data?.messageId || `msg_${Date.now()}`,
+                msgSvrId: res.data?.msgSvrId || "",
+            };
+        },
+        /**
+         * 发送图片到群
+         * Path: /msg/send_image (复用)
+         */
+        async sendRoomMedia(params) {
+            const res = await callApi(config, "/msg/send_image", {
+                roomId: params.roomId,
+                filePath: params.filePath,
+            });
+            return {
+                messageId: res.data?.messageId || `msg_${Date.now()}`,
+                msgSvrId: res.data?.msgSvrId || "",
+            };
+        },
+        /**
+         * 发送视频
+         * Path: /msg/send_video
+         */
+        async sendVideo(params) {
+            const res = await callApi(config, "/msg/send_video", params);
+            return {
+                messageId: res.data?.messageId || `msg_${Date.now()}`,
+                msgSvrId: res.data?.msgSvrId || "",
+            };
+        },
+        /**
+         * 发送文件
+         * Path: /msg/send_file
+         */
+        async sendFile(params) {
+            const res = await callApi(config, "/msg/send_file", params);
+            return {
+                messageId: res.data?.messageId || `msg_${Date.now()}`,
+                msgSvrId: res.data?.msgSvrId || "",
+            };
+        },
+        /**
+         * 发送位置
+         * Path: /msg/send_location
+         */
+        async sendLocation(params) {
+            return await callApi(config, "/msg/send_location", params);
+        },
+        /**
+         * 发送名片
+         * Path: /msg/send_share_card
+         */
+        async sendCard(params) {
+            return await callApi(config, "/msg/send_share_card", params);
+        },
+        /**
+         * 发送链接卡片
+         * Path: /msg/send_link_card
+         */
+        async sendLink(params) {
+            return await callApi(config, "/msg/send_link_card", params);
+        },
+        /**
+         * 发送表情
+         * Path: /msg/send_emoji
+         */
+        async sendEmoji(params) {
+            return await callApi(config, "/msg/send_emoji", params);
+        },
+        /**
+         * 发送表情URL
+         * Path: /msg/send_emoji_url
+         */
+        async sendEmojiUrl(params) {
+            return await callApi(config, "/msg/send_emoji_url", params);
+        },
+        /**
+         * 发送拍一拍
+         * Path: /msg/send_pat
+         */
+        async sendPat(roomId, userId) {
+            return await callApi(config, "/msg/send_pat", { roomId, userId });
+        },
+        /**
+         * 撤回消息
+         * Path: /msg/recall
+         */
+        async recallMessage(msgId) {
+            return await callApi(config, "/msg/recall", { msgId });
+        },
+        /**
+         * 发送引用消息
+         * Path: /msg/send_refer_msg
+         */
+        async sendReferMsg(params) {
+            return await callApi(config, "/msg/send_refer_msg", params);
+        },
+        // ========== 群组 (Room) ==========
+        /**
+         * 获取群信息
+         * Path: /room/get_chatroom_detail
+         */
+        async getRoomInfo(roomId) {
+            const res = await callApi(config, "/room/get_chatroom_detail", { roomId });
+            return res.data || {};
+        },
+        /**
+         * 获取群成员详细
+         * Path: /room/get_chatroom_member_detail
+         */
+        async getRoomMembers(roomId) {
+            const res = await callApi(config, "/room/get_chatroom_member_detail", { roomId });
+            return res.data?.members || [];
+        },
+        /**
+         * 创建群组
+         * Path: /room/create_chatroom
+         */
+        async createRoom(memberIds) {
+            const res = await callApi(config, "/room/create_chatroom", { memberIds });
+            return { roomId: res.data?.roomId || "" };
+        },
+        /**
+         * 添加群成员
+         * Path: /room/add_chatroom_member
+         */
+        async addRoomMember(roomId, memberId) {
+            await callApi(config, "/room/add_chatroom_member", { roomId, memberId });
+        },
+        /**
+         * 邀请群成员
+         * Path: /room/invite_chatroom_member
+         */
+        async inviteRoomMember(roomId, memberId) {
+            await callApi(config, "/room/invite_chatroom_member", { roomId, memberId });
+        },
+        /**
+         * 移除群成员
+         * Path: /room/del_chatroom_member
+         */
+        async removeRoomMember(roomId, memberId) {
+            await callApi(config, "/room/del_chatroom_member", { roomId, memberId });
+        },
+        /**
+         * 修改群名称
+         * Path: /room/modify_chatroom_name
+         */
+        async updateRoomName(roomId, name) {
+            await callApi(config, "/room/modify_chatroom_name", { roomId, name });
+        },
+        /**
+         * 设置群公告
+         * Path: /room/set_chatroom_announcement
+         */
+        async setRoomAnnouncement(roomId, announcement) {
+            await callApi(config, "/room/set_chatroom_announcement", { roomId, announcement });
+        },
+        /**
+         * 修改群显示昵称
+         * Path: /room/modify_chatroom_display_name
+         */
+        async setRoomDisplayName(roomId, displayName) {
+            await callApi(config, "/room/modify_chatroom_display_name", { roomId, displayName });
+        },
+        /**
+         * 是否显示群成员昵称
+         * Path: /room/modify_chatroom_show_name_flag
+         */
+        async setRoomShowNameFlag(roomId, flag) {
+            await callApi(config, "/room/modify_chatroom_show_name_flag", { roomId, flag });
+        },
+        /**
+         * 是否保存到通讯录
+         * Path: /room/modify_chatroom_contact_flag
+         */
+        async setRoomContactFlag(roomId, flag) {
+            await callApi(config, "/room/modify_chatroom_contact_flag", { roomId, flag });
+        },
+        /**
+         * 是否折叠群
+         * Path: /room/modify_chatroom_fold_flag
+         */
+        async setRoomFoldFlag(roomId, flag) {
+            await callApi(config, "/room/modify_chatroom_fold_flag", { roomId, flag });
+        },
+        /**
+         * 消息免打扰
+         * Path: /room/modify_chatroom_disturb_flag
+         */
+        async setRoomDisturbFlag(roomId, flag) {
+            await callApi(config, "/room/modify_chatroom_disturb_flag", { roomId, flag });
+        },
+        /**
+         * 添加群成员为好友
+         * Path: /room/add_chatroom_member_friend
+         */
+        async addRoomMemberAsFriend(roomId, memberId) {
+            return await callApi(config, "/room/add_chatroom_member_friend", { roomId, memberId });
+        },
+        /**
+         * 退出群
+         * Path: /room/quit_chatroom
+         */
+        async quitRoom(roomId) {
+            return await callApi(config, "/room/quit_chatroom", { roomId });
+        },
+        /**
+         * 转让群主
+         * Path: /room/tranfer_chatroom_owner
+         */
+        async transferRoomOwner(roomId, newOwnerId) {
+            return await callApi(config, "/room/tranfer_chatroom_owner", { roomId, newOwnerId });
+        },
+        /**
+         * 获取群二维码
+         * Path: /room/get_chatroom_qrcode
+         */
+        async getRoomQRCode(roomId) {
+            return await callApi(config, "/room/get_chatroom_qrcode", { roomId });
+        },
+        /**
+         * 置顶消息
+         * Path: /room/set_top_msg
+         */
+        async setTopMsg(roomId, msgId) {
+            return await callApi(config, "/room/set_top_msg", { roomId, msgId });
+        },
+        /**
+         * 取消置顶消息
+         * Path: /room/remove_top_msg
+         */
+        async removeTopMsg(roomId, msgId) {
+            return await callApi(config, "/room/remove_top_msg", { roomId, msgId });
+        },
+        // ========== 朋友圈 (SNS) ==========
+        /**
+         * 获取朋友圈动态
+         * Path: /sns/sns_timeline
+         */
+        async getMoments(limit = 20) {
+            const res = await callApi(config, "/sns/sns_timeline", { limit });
+            return res.data?.moments || [];
+        },
+        /**
+         * 获取好友朋友圈动态
+         * Path: /sns/sns_userpage
+         */
+        async getFriendMoments(wechatId, limit = 20) {
+            const res = await callApi(config, "/sns/sns_userpage", { userId: wechatId, limit });
+            return res.data?.moments || [];
+        },
+        /**
+         * 发布朋友圈
+         * Path: /sns/sns_post
+         */
+        async publishMoment(content, images) {
+            await callApi(config, "/sns/sns_post", { content, images });
+        },
+        /**
+         * 删除朋友圈
+         * Path: /sns/sns_delete
+         */
+        async deleteMoment(snsId) {
+            await callApi(config, "/sns/sns_delete", { snsId });
+        },
+        /**
+         * 朋友圈评论
+         * Path: /sns/sns_comment
+         */
+        async commentMoment(snsId, content, replyId) {
+            return await callApi(config, "/sns/sns_comment", { snsId, content, replyId });
+        },
+        /**
+         * 删除评论
+         * Path: /sns/sns_delete_comment
+         */
+        async deleteComment(snsId, commentId) {
+            await callApi(config, "/sns/sns_delete_comment", { snsId, commentId });
+        },
+        /**
+         * 点赞/取消点赞
+         * Path: /sns/sns_like
+         */
+        async likeMoment(snsId, type) {
+            return await callApi(config, "/sns/sns_like", { snsId, type });
+        },
+        // ========== 云存储 (Cloud) ==========
+        /**
+         * 上传文件
+         * Path: /cloud/upload
+         */
+        async uploadFile(filePath) {
+            return await callApi(config, "/cloud/upload", { filePath });
+        },
+        /**
+         * 上传大文件
+         * Path: /cloud/upload_big
+         */
+        async uploadBigFile(filePath) {
+            return await callApi(config, "/cloud/upload_big", { filePath });
+        },
+        /**
+         * CDN 上传
+         * Path: /cloud/cdn_upload
+         */
+        async cdnUpload(filePath) {
+            return await callApi(config, "/cloud/cdn_upload", { filePath });
+        },
+        /**
+         * 下载文件
+         * Path: /cloud/download
+         */
+        async downloadFile(fileId, savePath) {
+            return await callApi(config, "/cloud/download", { fileId, savePath });
+        },
+        /**
+         * CDN 下载
+         * Path: /cloud/cdn_download
+         */
+        async cdnDownload(url, savePath) {
+            return await callApi(config, "/cloud/cdn_download", { url, savePath });
+        },
+    };
+}
+/**
+ * API 路径映射表 (完整)
+ */
+export const API_PATHS = {
+    // 实例管理
+    instanceGetStatus: "/instance/get_status",
+    instanceRestore: "/instance/restore",
+    instanceStop: "/instance/stop",
+    instanceSetNotifyUrl: "/instance/set_notify_url",
+    instanceSetBridgeId: "/instance/set_bridge_id",
+    // 用户
+    userGetProfile: "/user/get_profile",
+    userGetQRCode: "/user/get_qrcode",
+    userLogout: "/user/logout",
+    // 联系人
+    contactInitContact: "/contact/init_contact",
+    contactGetContact: "/contact/get_contact",
+    contactBatchGetBriefInfo: "/contact/batch_get_contact_brief_info",
+    contactSearchContact: "/contact/search_contact",
+    contactAddFriend: "/contact/add_friend",
+    contactVerifyFriend: "/contact/verify_friend",
+    contactModifyRemark: "/contact/modify_remark",
+    contactDelFriend: "/contact/del_friend",
+    contactModifyTopFlag: "/contact/modify_contact_top_flag",
+    // 消息
+    msgSendText: "/msg/send_text",
+    msgSendRoomAt: "/msg/send_room_at",
+    msgSendImage: "/msg/send_image",
+    msgSendVideo: "/msg/send_video",
+    msgSendFile: "/msg/send_file",
+    msgSendLocation: "/msg/send_location",
+    msgSendShareCard: "/msg/send_share_card",
+    msgSendLinkCard: "/msg/send_link_card",
+    msgSendEmoji: "/msg/send_emoji",
+    msgSendEmojiUrl: "/msg/send_emoji_url",
+    msgSendPat: "/msg/send_pat",
+    msgRecall: "/msg/recall",
+    msgSendReferMsg: "/msg/send_refer_msg",
+    // 群组
+    roomCreateChatroom: "/room/create_chatroom",
+    roomGetDetail: "/room/get_chatroom_detail",
+    roomGetMembers: "/room/get_chatroom_member_detail",
+    roomAddMember: "/room/add_chatroom_member",
+    roomInviteMember: "/room/invite_chatroom_member",
+    roomDelMember: "/room/del_chatroom_member",
+    roomModifyName: "/room/modify_chatroom_name",
+    roomSetAnnouncement: "/room/set_chatroom_announcement",
+    roomModifyDisplayName: "/room/modify_chatroom_display_name",
+    roomModifyShowNameFlag: "/room/modify_chatroom_show_name_flag",
+    roomModifyContactFlag: "/room/modify_chatroom_contact_flag",
+    roomModifyFoldFlag: "/room/modify_chatroom_fold_flag",
+    roomModifyDisturbFlag: "/room/modify_chatroom_disturb_flag",
+    roomAddMemberFriend: "/room/add_chatroom_member_friend",
+    roomQuit: "/room/quit_chatroom",
+    roomTransferOwner: "/room/tranfer_chatroom_owner",
+    roomGetQRCode: "/room/get_chatroom_qrcode",
+    roomSetTopMsg: "/room/set_top_msg",
+    roomRemoveTopMsg: "/room/remove_top_msg",
+    // 朋友圈
+    snsTimeline: "/sns/sns_timeline",
+    snsUserpage: "/sns/sns_userpage",
+    snsPost: "/sns/sns_post",
+    snsDelete: "/sns/sns_delete",
+    snsComment: "/sns/sns_comment",
+    snsDeleteComment: "/sns/sns_delete_comment",
+    snsLike: "/sns/sns_like",
+    // 云存储
+    cloudUpload: "/cloud/upload",
+    cloudUploadBig: "/cloud/upload_big",
+    cloudCdnUpload: "/cloud/cdn_upload",
+    cloudDownload: "/cloud/download",
+    cloudCdnDownload: "/cloud/cdn_download",
+};

package/index.ts

@@ -6,7 +6,7 @@
  */
 
 import { defineChannelPluginEntry } from "openclaw/plugin-sdk/core";
-import { ipadWeChatPlugin } from "./src/channel.js";
+import { ipadWeChatPlugin, handleInboundMessage } from "./src/channel.js";
 
 export default defineChannelPluginEntry({
   id: "ipad-wechat",
@@ -21,9 +21,14 @@ export default defineChannelPluginEntry({
       auth: "plugin",
       handler: async (req, res) => {
         try {
-          const payload = req.body;
+          const payload = (req as any).body;
           // Handle inbound message
           console.log("[iPad WeChat] Received webhook:", payload);
+
+          if (payload) {
+            await handleInboundMessage(api, payload);
+          }
+
           res.statusCode = 200;
           res.end("ok");
           return true;

package/openclaw.plugin.json

@@ -39,15 +39,19 @@
   "configSchema": {
     "type": "object",
     "properties": {
-      "apiKey": {
+      "appKey": {
         "type": "string",
-        "description": "iPad WeChat API key for authentication",
-        "secret": true,
-        "required": true
+        "description": "JuHeBot App Key (聚合聊天开放平台)",
+        "secret": true
       },
-      "baseUrl": {
+      "appSecret": {
         "type": "string",
-        "description": "iPad WeChat API base URL"
+        "description": "JuHeBot App Secret",
+        "secret": true
+      },
+      "guid": {
+        "type": "string",
+        "description": "实例/设备 ID (Guid)"
       },
       "accountId": {
         "type": "string",
@@ -78,7 +82,7 @@
         "default": "allowlist"
       }
     },
-    "required": ["apiKey", "baseUrl"]
+    "required": ["appKey", "appSecret", "guid"]
   },
   "permissions": {
     "channels": ["ipad-wechat"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gloablehive/ipad-wechat-plugin",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "type": "module",
   "description": "OpenClaw channel plugin for iPad WeChat protocol - enables sending/receiving WeChat messages through iPad protocol",
   "main": "index.ts",
@@ -20,11 +20,12 @@
     }
   },
   "dependencies": {
-    "@gloablehive/wechat-cache": "^1.0.0",
+    "@gloablehive/wechat-cache": "^1.0.1",
     "openclaw": ">=1.0.0"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
+    "tsx": "^4.21.0",
     "typescript": "^5.0.0"
   }
 }