@gloablehive/ipad-wechat-plugin 1.0.0 → 1.0.2

package/src/client.ts

@@ -1,13 +1,15 @@
 /**
- * iPad WeChat API Client
+ * iPad WeChat API Client (聚合聊天开放平台)
  *
- * Based on wechat/api.md documentation
- * Different from WorkPhone - uses iPad protocol
+ * Gateway: https://chat-api.juhebot.com/open/GuidRequest
+ * 文档: data/ipad-wechat/AI-READABLE-OVERVIEW.md
+ * API Paths: data/ipad-wechat/apifox/apis/
  */
 
-export interface IPadClientConfig {
-  baseUrl: string;
-  apiKey: string;
+export interface JuHeBotConfig {
+  appKey: string;
+  appSecret: string;
+  guid: string;  // 实例/设备 ID
 }
 
 export interface WebhookPayload {
@@ -24,6 +26,18 @@ export interface WebhookPayload {
   };
 }
 
+export interface JuHeBotResponse {
+  code?: number;
+  msg?: string;
+  err_code?: number;
+  err_msg?: string;
+  data?: any;
+  contactUsernameList?: string[];
+  currentWxcontactSeq?: number;
+  currentChatRoomContactSeq?: number;
+  continueFlag?: number;
+}
+
 export interface SendTextResponse {
   messageId: string;
   msgSvrId: string;
@@ -48,225 +62,716 @@ export interface RoomInfo {
   memberCount: number;
 }
 
-function getHeaders(apiKey: string) {
-  return {
-    "Content-Type": "application/json",
-    "Authorization": `Bearer ${apiKey}`,
-  };
+export interface DeviceInfo {
+  guid: string;
+  name: string;
+  status: string;
+  wechatId?: string;
+  nickName?: string;
 }
 
-export function createIPadClient(config: IPadClientConfig) {
-  const { baseUrl, apiKey } = config;
+const GATEWAY_URL = "https://chat-api.juhebot.com/open/GuidRequest";
+
+/**
+ * Call JuHeBot API Gateway
+ */
+async function callApi(config: JuHeBotConfig, path: string, data: any): Promise<JuHeBotResponse> {
+  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() as any;
+  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: JuHeBotConfig) {
   return {
-    // ========== 消息发送 ==========
+    // ========== 实例管理 (Instance) ==========
+
+    /**
+     * 获取实例状态
+     * Path: /instance/get_status
+     */
+    async getDeviceStatus(): Promise<any> {
+      return await callApi(config, "/instance/get_status", {});
+    },
+
+    /**
+     * 恢复实例
+     * Path: /instance/restore
+     */
+    async restoreInstance(): Promise<any> {
+      return await callApi(config, "/instance/restore", {});
+    },
+
+    /**
+     * 停止实例
+     * Path: /instance/stop
+     */
+    async stopInstance(): Promise<any> {
+      return await callApi(config, "/instance/stop", {});
+    },
+
+    /**
+     * 设置实例通知地址 (回调地址)
+     * Path: /instance/set_notify_url
+     */
+    async setNotifyUrl(notifyUrl: string): Promise<void> {
+      await callApi(config, "/instance/set_notify_url", { notifyUrl });
+    },
+
+    /**
+     * 设置实例桥接ID
+     * Path: /instance/set_bridge_id
+     */
+    async setBridgeId(bridgeId: string): Promise<void> {
+      await callApi(config, "/instance/set_bridge_id", { bridgeId });
+    },
+
+    // ========== 用户 (User) ==========
+
+    /**
+     * 获取登录账号信息
+     * Path: /user/get_profile
+     */
+    async getLoginAccountInfo(): Promise<{
+      wechatId: string;
+      nickName: string;
+      avatar: string;
+    }> {
+      const res = await callApi(config, "/user/get_profile", {});
+      return res.data || {};
+    },
+
+    /**
+     * 获取个人二维码
+     * Path: /user/get_qrcode
+     */
+    async getQRCode(): Promise<any> {
+      return await callApi(config, "/user/get_qrcode", {});
+    },
+
+    /**
+     * 退出登录
+     * Path: /user/logout
+     */
+    async logout(): Promise<any> {
+      return await callApi(config, "/user/logout", {});
+    },
+
+    // ========== 联系人 (Contact) ==========
 
+    /**
+     * 同步联系人
+     * Path: /contact/init_contact
+     */
+    async syncContacts(): Promise<Contact[]> {
+      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: string) => ({
+        wechatId,
+        nickName: "",
+        remark: "",
+      }));
+    },
+
+    /**
+     * 获取联系人详细
+     * Path: /contact/get_contact
+     */
+    async getContactDetail(wechatId: string): Promise<Contact> {
+      const res = await callApi(config, "/contact/get_contact", { userId: wechatId });
+      return res.data || {};
+    },
+
+    /**
+     * 批量获取联系人简要信息
+     * Path: /contact/batch_get_contact_brief_info
+     */
+    async batchGetContactBriefInfo(wechatIds: string[]): Promise<any[]> {
+      const res = await callApi(config, "/contact/batch_get_contact_brief_info", { userIds: wechatIds });
+      return res.data?.contacts || [];
+    },
+
+    /**
+     * 搜索联系人
+     * Path: /contact/search_contact
+     */
+    async searchContact(searchType: string, value: string): Promise<any> {
+      return await callApi(config, "/contact/search_contact", { searchType, value });
+    },
+
+    /**
+     * 添加好友
+     * Path: /contact/add_friend
+     */
+    async addFriend(v3: string, verifyMessage?: string): Promise<any> {
+      return await callApi(config, "/contact/add_friend", { v3, verifyMessage });
+    },
+
+    /**
+     * 验证好友申请
+     * Path: /contact/verify_friend
+     */
+    async verifyFriend(who: string, status: number, ticket: string): Promise<any> {
+      return await callApi(config, "/contact/verify_friend", { who, status, ticket });
+    },
+
+    /**
+     * 修改好友备注
+     * Path: /contact/modify_remark
+     */
+    async updateFriendRemark(wechatId: string, remark: string): Promise<void> {
+      await callApi(config, "/contact/modify_remark", { userId: wechatId, remark });
+    },
+
+    /**
+     * 删除好友
+     * Path: /contact/del_friend
+     */
+    async deleteFriend(wechatId: string): Promise<any> {
+      return await callApi(config, "/contact/del_friend", { userId: wechatId });
+    },
+
+    /**
+     * 置顶聊天
+     * Path: /contact/modify_contact_top_flag
+     */
+    async setContactTop(wechatId: string, flag: number): Promise<any> {
+      return await callApi(config, "/contact/modify_contact_top_flag", { userId: wechatId, flag });
+    },
+
+    // ========== 消息发送 (Msg) ==========
+
+    /**
+     * 发送文本消息
+     * Path: /msg/send_text
+     */
     async sendFriendMessage(params: {
       friendWechatId: string;
       content: string;
     }): Promise<SendTextResponse> {
-      // API: 发送文本消息 - api-316658257
-      const response = await fetch(`${baseUrl}/api-316658257`, {
-        method: "POST",
-        headers: getHeaders(apiKey),
-        body: JSON.stringify({
-          toUser: params.friendWechatId,
-          content: params.content,
-        }),
+      const res = await callApi(config, "/msg/send_text", {
+        toUser: params.friendWechatId,
+        content: params.content,
       });
-      const data = await response.json();
+
       return {
-        messageId: data.data?.messageId || `msg_${Date.now()}`,
-        msgSvrId: data.data?.msgSvrId || "",
+        messageId: res.data?.messageId || `msg_${Date.now()}`,
+        msgSvrId: res.data?.msgSvrId || "",
       };
     },
 
+    /**
+     * 发送群@消息
+     * Path: /msg/send_room_at
+     */
     async sendRoomMessage(params: {
       roomId: string;
       content: string;
     }): Promise<SendTextResponse> {
-      // API: 发送群@消息 - api-316658258
-      const response = await fetch(`${baseUrl}/api-316658258`, {
-        method: "POST",
-        headers: getHeaders(apiKey),
-        body: JSON.stringify({
-          roomId: params.roomId,
-          content: params.content,
-        }),
+      const res = await callApi(config, "/msg/send_room_at", {
+        roomId: params.roomId,
+        content: params.content,
       });
-      const data = await response.json();
+
       return {
-        messageId: data.data?.messageId || `msg_${Date.now()}`,
-        msgSvrId: data.data?.msgSvrId || "",
+        messageId: res.data?.messageId || `msg_${Date.now()}`,
+        msgSvrId: res.data?.msgSvrId || "",
       };
     },
 
+    /**
+     * 发送图片
+     * Path: /msg/send_image
+     */
     async sendFriendMedia(params: {
       friendWechatId: string;
       filePath: string;
     }): Promise<SendMediaResponse> {
-      // API: 发送图片 - api-316658262
-      const response = await fetch(`${baseUrl}/api-316658262`, {
-        method: "POST",
-        headers: getHeaders(apiKey),
-        body: JSON.stringify({
-          toUser: params.friendWechatId,
-          filePath: params.filePath,
-        }),
+      const res = await callApi(config, "/msg/send_image", {
+        toUser: params.friendWechatId,
+        filePath: params.filePath,
       });
-      const data = await response.json();
+
       return {
-        messageId: data.data?.messageId || `msg_${Date.now()}`,
-        msgSvrId: data.data?.msgSvrId || "",
+        messageId: res.data?.messageId || `msg_${Date.now()}`,
+        msgSvrId: res.data?.msgSvrId || "",
       };
     },
 
+    /**
+     * 发送图片到群
+     * Path: /msg/send_image (复用)
+     */
     async sendRoomMedia(params: {
       roomId: string;
       filePath: string;
     }): Promise<SendMediaResponse> {
-      // API: 发送图片到群 - 复用图片接口
-      const response = await fetch(`${baseUrl}/api-316658262`, {
-        method: "POST",
-        headers: getHeaders(apiKey),
-        body: JSON.stringify({
-          roomId: params.roomId,
-          filePath: params.filePath,
-        }),
+      const res = await callApi(config, "/msg/send_image", {
+        roomId: params.roomId,
+        filePath: params.filePath,
       });
-      const data = await response.json();
+
       return {
-        messageId: data.data?.messageId || `msg_${Date.now()}`,
-        msgSvrId: data.data?.msgSvrId || "",
+        messageId: res.data?.messageId || `msg_${Date.now()}`,
+        msgSvrId: res.data?.msgSvrId || "",
       };
     },
 
-    // ========== 联系人管理 ==========
+    /**
+     * 发送视频
+     * Path: /msg/send_video
+     */
+    async sendVideo(params: { toUser: string; filePath: string }): Promise<SendMediaResponse> {
+      const res = await callApi(config, "/msg/send_video", params);
+      return {
+        messageId: res.data?.messageId || `msg_${Date.now()}`,
+        msgSvrId: res.data?.msgSvrId || "",
+      };
+    },
 
-    async syncContacts(): Promise<Contact[]> {
-      // API: 同步联系人 - api-316658212
-      const response = await fetch(`${baseUrl}/api-316658212`, {
-        method: "POST",
-        headers: getHeaders(apiKey),
-        body: JSON.stringify({}),
-      });
-      const data = await response.json();
-      return data.data?.contacts || [];
+    /**
+     * 发送文件
+     * Path: /msg/send_file
+     */
+    async sendFile(params: { toUser: string; filePath: string }): Promise<SendMediaResponse> {
+      const res = await callApi(config, "/msg/send_file", params);
+      return {
+        messageId: res.data?.messageId || `msg_${Date.now()}`,
+        msgSvrId: res.data?.msgSvrId || "",
+      };
     },
 
-    async getContactDetail(wechatId: string): Promise<Contact> {
-      // API: 获取联系人详细 - api-316658219
-      const response = await fetch(`${baseUrl}/api-316658219`, {
-        method: "POST",
-        headers: getHeaders(apiKey),
-        body: JSON.stringify({ userId: wechatId }),
-      });
-      const data = await response.json();
-      return data.data || {};
+    /**
+     * 发送位置
+     * Path: /msg/send_location
+     */
+    async sendLocation(params: { toUser: string; lat: number; lng: number; title?: string; address?: string }): Promise<any> {
+      return await callApi(config, "/msg/send_location", params);
     },
 
-    async updateFriendRemark(wechatId: string, remark: string): Promise<void> {
-      // API: 修改好友备注 - api-316658224
-      await fetch(`${baseUrl}/api-316658224`, {
-        method: "POST",
-        headers: getHeaders(apiKey),
-        body: JSON.stringify({
-          userId: wechatId,
-          remark,
-        }),
-      });
+    /**
+     * 发送名片
+     * Path: /msg/send_share_card
+     */
+    async sendCard(params: { toUser: string; cardWxid: string }): Promise<any> {
+      return await callApi(config, "/msg/send_share_card", params);
+    },
+
+    /**
+     * 发送链接卡片
+     * Path: /msg/send_link_card
+     */
+    async sendLink(params: { toUser: string; title: string; desc: string; url: string; thumbUrl?: string }): Promise<any> {
+      return await callApi(config, "/msg/send_link_card", params);
     },
 
-    // ========== 群管理 ==========
+    /**
+     * 发送表情
+     * Path: /msg/send_emoji
+     */
+    async sendEmoji(params: { toUser: string; emojiPath: string }): Promise<any> {
+      return await callApi(config, "/msg/send_emoji", params);
+    },
+
+    /**
+     * 发送表情URL
+     * Path: /msg/send_emoji_url
+     */
+    async sendEmojiUrl(params: { toUser: string; emojiUrl: string }): Promise<any> {
+      return await callApi(config, "/msg/send_emoji_url", params);
+    },
+
+    /**
+     * 发送拍一拍
+     * Path: /msg/send_pat
+     */
+    async sendPat(roomId: string, userId: string): Promise<any> {
+      return await callApi(config, "/msg/send_pat", { roomId, userId });
+    },
+
+    /**
+     * 撤回消息
+     * Path: /msg/recall
+     */
+    async recallMessage(msgId: string): Promise<any> {
+      return await callApi(config, "/msg/recall", { msgId });
+    },
+
+    /**
+     * 发送引用消息
+     * Path: /msg/send_refer_msg
+     */
+    async sendReferMsg(params: { toUser: string; content: string; referMsgId: string }): Promise<any> {
+      return await callApi(config, "/msg/send_refer_msg", params);
+    },
+
+    // ========== 群组 (Room) ==========
 
+    /**
+     * 获取群信息
+     * Path: /room/get_chatroom_detail
+     */
     async getRoomInfo(roomId: string): Promise<RoomInfo> {
-      // API: 获取群信息 - api-316658229
-      const response = await fetch(`${baseUrl}/api-316658229`, {
-        method: "POST",
-        headers: getHeaders(apiKey),
-        body: JSON.stringify({ roomId }),
-      });
-      const data = await response.json();
-      return data.data || {};
+      const res = await callApi(config, "/room/get_chatroom_detail", { roomId });
+      return res.data || {};
     },
 
-    async getRoomMembers(roomId: string): Promise<string[]> {
-      // API: 获取群成员详细 - api-316658230
-      const response = await fetch(`${baseUrl}/api-316658230`, {
-        method: "POST",
-        headers: getHeaders(apiKey),
-        body: JSON.stringify({ roomId }),
-      });
-      const data = await response.json();
-      return data.data?.members || [];
+    /**
+     * 获取群成员详细
+     * Path: /room/get_chatroom_member_detail
+     */
+    async getRoomMembers(roomId: string): Promise<any[]> {
+      const res = await callApi(config, "/room/get_chatroom_member_detail", { roomId });
+      return res.data?.members || [];
     },
 
+    /**
+     * 创建群组
+     * Path: /room/create_chatroom
+     */
     async createRoom(memberIds: string[]): Promise<{ roomId: string }> {
-      // API: 创建群组 - api-316658231
-      const response = await fetch(`${baseUrl}/api-316658231`, {
-        method: "POST",
-        headers: getHeaders(apiKey),
-        body: JSON.stringify({ memberIds }),
-      });
-      const data = await response.json();
-      return { roomId: data.data?.roomId || "" };
+      const res = await callApi(config, "/room/create_chatroom", { memberIds });
+      return { roomId: res.data?.roomId || "" };
     },
 
+    /**
+     * 添加群成员
+     * Path: /room/add_chatroom_member
+     */
     async addRoomMember(roomId: string, memberId: string): Promise<void> {
-      // API: 添加群成员 - api-316658232
-      await fetch(`${baseUrl}/api-316658232`, {
-        method: "POST",
-        headers: getHeaders(apiKey),
-        body: JSON.stringify({ roomId, memberId }),
-      });
+      await callApi(config, "/room/add_chatroom_member", { roomId, memberId });
+    },
+
+    /**
+     * 邀请群成员
+     * Path: /room/invite_chatroom_member
+     */
+    async inviteRoomMember(roomId: string, memberId: string): Promise<void> {
+      await callApi(config, "/room/invite_chatroom_member", { roomId, memberId });
     },
 
+    /**
+     * 移除群成员
+     * Path: /room/del_chatroom_member
+     */
     async removeRoomMember(roomId: string, memberId: string): Promise<void> {
-      // API: 移除群成员 - api-316658234
-      await fetch(`${baseUrl}/api-316658234`, {
-        method: "POST",
-        headers: getHeaders(apiKey),
-        body: JSON.stringify({ roomId, memberId }),
-      });
+      await callApi(config, "/room/del_chatroom_member", { roomId, memberId });
     },
 
-    // ========== 账号 ==========
+    /**
+     * 修改群名称
+     * Path: /room/modify_chatroom_name
+     */
+    async updateRoomName(roomId: string, name: string): Promise<void> {
+      await callApi(config, "/room/modify_chatroom_name", { roomId, name });
+    },
 
-    async getLoginAccountInfo(): Promise<{
-      wechatId: string;
-      nickName: string;
-      avatar: string;
-    }> {
-      // API: 获取登录账号信息 - api-316658209
-      const response = await fetch(`${baseUrl}/api-316658209`, {
-        method: "POST",
-        headers: getHeaders(apiKey),
-        body: JSON.stringify({}),
-      });
-      const data = await response.json();
-      return data.data || {};
+    /**
+     * 设置群公告
+     * Path: /room/set_chatroom_announcement
+     */
+    async setRoomAnnouncement(roomId: string, announcement: string): Promise<void> {
+      await callApi(config, "/room/set_chatroom_announcement", { roomId, announcement });
+    },
+
+    /**
+     * 修改群显示昵称
+     * Path: /room/modify_chatroom_display_name
+     */
+    async setRoomDisplayName(roomId: string, displayName: string): Promise<void> {
+      await callApi(config, "/room/modify_chatroom_display_name", { roomId, displayName });
+    },
+
+    /**
+     * 是否显示群成员昵称
+     * Path: /room/modify_chatroom_show_name_flag
+     */
+    async setRoomShowNameFlag(roomId: string, flag: number): Promise<void> {
+      await callApi(config, "/room/modify_chatroom_show_name_flag", { roomId, flag });
+    },
+
+    /**
+     * 是否保存到通讯录
+     * Path: /room/modify_chatroom_contact_flag
+     */
+    async setRoomContactFlag(roomId: string, flag: number): Promise<void> {
+      await callApi(config, "/room/modify_chatroom_contact_flag", { roomId, flag });
     },
 
-    // ========== 朋友圈 ==========
+    /**
+     * 是否折叠群
+     * Path: /room/modify_chatroom_fold_flag
+     */
+    async setRoomFoldFlag(roomId: string, flag: number): Promise<void> {
+      await callApi(config, "/room/modify_chatroom_fold_flag", { roomId, flag });
+    },
+
+    /**
+     * 消息免打扰
+     * Path: /room/modify_chatroom_disturb_flag
+     */
+    async setRoomDisturbFlag(roomId: string, flag: number): Promise<void> {
+      await callApi(config, "/room/modify_chatroom_disturb_flag", { roomId, flag });
+    },
+
+    /**
+     * 添加群成员为好友
+     * Path: /room/add_chatroom_member_friend
+     */
+    async addRoomMemberAsFriend(roomId: string, memberId: string): Promise<any> {
+      return await callApi(config, "/room/add_chatroom_member_friend", { roomId, memberId });
+    },
 
+    /**
+     * 退出群
+     * Path: /room/quit_chatroom
+     */
+    async quitRoom(roomId: string): Promise<any> {
+      return await callApi(config, "/room/quit_chatroom", { roomId });
+    },
+
+    /**
+     * 转让群主
+     * Path: /room/tranfer_chatroom_owner
+     */
+    async transferRoomOwner(roomId: string, newOwnerId: string): Promise<any> {
+      return await callApi(config, "/room/tranfer_chatroom_owner", { roomId, newOwnerId });
+    },
+
+    /**
+     * 获取群二维码
+     * Path: /room/get_chatroom_qrcode
+     */
+    async getRoomQRCode(roomId: string): Promise<any> {
+      return await callApi(config, "/room/get_chatroom_qrcode", { roomId });
+    },
+
+    /**
+     * 置顶消息
+     * Path: /room/set_top_msg
+     */
+    async setTopMsg(roomId: string, msgId: string): Promise<any> {
+      return await callApi(config, "/room/set_top_msg", { roomId, msgId });
+    },
+
+    /**
+     * 取消置顶消息
+     * Path: /room/remove_top_msg
+     */
+    async removeTopMsg(roomId: string, msgId: string): Promise<any> {
+      return await callApi(config, "/room/remove_top_msg", { roomId, msgId });
+    },
+
+    // ========== 朋友圈 (SNS) ==========
+
+    /**
+     * 获取朋友圈动态
+     * Path: /sns/sns_timeline
+     */
+    async getMoments(limit: number = 20): Promise<any[]> {
+      const res = await callApi(config, "/sns/sns_timeline", { limit });
+      return res.data?.moments || [];
+    },
+
+    /**
+     * 获取好友朋友圈动态
+     * Path: /sns/sns_userpage
+     */
     async getFriendMoments(wechatId: string, limit: number = 20): Promise<any[]> {
-      // API: 获取好友朋友圈动态 - api-316658314
-      const response = await fetch(`${baseUrl}/api-316658314`, {
-        method: "POST",
-        headers: getHeaders(apiKey),
-        body: JSON.stringify({ userId: wechatId, limit }),
-      });
-      const data = await response.json();
-      return data.data?.moments || [];
+      const res = await callApi(config, "/sns/sns_userpage", { userId: wechatId, limit });
+      return res.data?.moments || [];
     },
 
+    /**
+     * 发布朋友圈
+     * Path: /sns/sns_post
+     */
     async publishMoment(content: string, images: string[]): Promise<void> {
-      // API: 发布朋友圈 - api-316658315
-      await fetch(`${baseUrl}/api-316658315`, {
-        method: "POST",
-        headers: getHeaders(apiKey),
-        body: JSON.stringify({ content, images }),
-      });
+      await callApi(config, "/sns/sns_post", { content, images });
+    },
+
+    /**
+     * 删除朋友圈
+     * Path: /sns/sns_delete
+     */
+    async deleteMoment(snsId: string): Promise<void> {
+      await callApi(config, "/sns/sns_delete", { snsId });
+    },
+
+    /**
+     * 朋友圈评论
+     * Path: /sns/sns_comment
+     */
+    async commentMoment(snsId: string, content: string, replyId?: string): Promise<any> {
+      return await callApi(config, "/sns/sns_comment", { snsId, content, replyId });
+    },
+
+    /**
+     * 删除评论
+     * Path: /sns/sns_delete_comment
+     */
+    async deleteComment(snsId: string, commentId: string): Promise<void> {
+      await callApi(config, "/sns/sns_delete_comment", { snsId, commentId });
+    },
+
+    /**
+     * 点赞/取消点赞
+     * Path: /sns/sns_like
+     */
+    async likeMoment(snsId: string, type: number): Promise<any> {
+      return await callApi(config, "/sns/sns_like", { snsId, type });
+    },
+
+    // ========== 云存储 (Cloud) ==========
+
+    /**
+     * 上传文件
+     * Path: /cloud/upload
+     */
+    async uploadFile(filePath: string): Promise<any> {
+      return await callApi(config, "/cloud/upload", { filePath });
+    },
+
+    /**
+     * 上传大文件
+     * Path: /cloud/upload_big
+     */
+    async uploadBigFile(filePath: string): Promise<any> {
+      return await callApi(config, "/cloud/upload_big", { filePath });
+    },
+
+    /**
+     * CDN 上传
+     * Path: /cloud/cdn_upload
+     */
+    async cdnUpload(filePath: string): Promise<any> {
+      return await callApi(config, "/cloud/cdn_upload", { filePath });
+    },
+
+    /**
+     * 下载文件
+     * Path: /cloud/download
+     */
+    async downloadFile(fileId: string, savePath: string): Promise<any> {
+      return await callApi(config, "/cloud/download", { fileId, savePath });
+    },
+
+    /**
+     * CDN 下载
+     * Path: /cloud/cdn_download
+     */
+    async cdnDownload(url: string, savePath: string): Promise<any> {
+      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",
+};