feishu-user-plugin 1.0.0

package/src/official.js

@@ -0,0 +1,365 @@
+const lark = require('@larksuiteoapi/node-sdk');
+
+class LarkOfficialClient {
+  constructor(appId, appSecret) {
+    this.appId = appId;
+    this.appSecret = appSecret;
+    this.client = new lark.Client({ appId, appSecret, disableTokenCache: false });
+    this._uat = null;
+    this._uatRefresh = null;
+    this._uatExpires = 0;
+  }
+
+  // --- UAT (User Access Token) Management ---
+
+  loadUAT() {
+    const token = process.env.LARK_USER_ACCESS_TOKEN;
+    const refresh = process.env.LARK_USER_REFRESH_TOKEN;
+    const expires = parseInt(process.env.LARK_UAT_EXPIRES || '0');
+    if (token) {
+      this._uat = token;
+      this._uatRefresh = refresh || null;
+      this._uatExpires = expires;
+    }
+  }
+
+  get hasUAT() {
+    return !!this._uat;
+  }
+
+  async _getValidUAT() {
+    if (!this._uat) throw new Error('No user_access_token. Run: npx feishu-user-plugin oauth');
+
+    const now = Math.floor(Date.now() / 1000);
+    // Proactively refresh if we know it's expiring within 5 min
+    if (this._uatExpires > 0 && this._uatExpires <= now + 300) {
+      return this._refreshUAT();
+    }
+    return this._uat;
+  }
+
+  async _refreshUAT() {
+    if (!this._uatRefresh) throw new Error('UAT expired and no refresh token. Run: npx feishu-user-plugin oauth');
+
+    const res = await fetch('https://open.feishu.cn/open-apis/authen/v2/oauth/token', {
+      method: 'POST',
+      headers: { 'content-type': 'application/json' },
+      body: JSON.stringify({
+        grant_type: 'refresh_token',
+        client_id: this.appId,
+        client_secret: this.appSecret,
+        refresh_token: this._uatRefresh,
+      }),
+    });
+    const data = await res.json();
+    const tokenData = data.access_token ? data : data.data;
+    if (!tokenData?.access_token) throw new Error(`UAT refresh failed: ${JSON.stringify(data)}. Run: npx feishu-user-plugin oauth`);
+
+    this._uat = tokenData.access_token;
+    this._uatRefresh = tokenData.refresh_token || this._uatRefresh;
+    this._uatExpires = Math.floor(Date.now() / 1000) + tokenData.expires_in;
+    this._persistUAT();
+    console.error('[feishu-user-plugin] UAT refreshed successfully');
+    return this._uat;
+  }
+
+  _persistUAT() {
+    const fs = require('fs');
+    const path = require('path');
+    const envPath = path.join(__dirname, '..', '.env');
+    try {
+      let env = fs.readFileSync(envPath, 'utf8');
+      for (const [key, val] of Object.entries({
+        LARK_USER_ACCESS_TOKEN: this._uat,
+        LARK_USER_REFRESH_TOKEN: this._uatRefresh,
+        LARK_UAT_EXPIRES: String(this._uatExpires),
+      })) {
+        const regex = new RegExp(`^${key}=.*$`, 'm');
+        if (regex.test(env)) env = env.replace(regex, `${key}=${val}`);
+        else env += `\n${key}=${val}`;
+      }
+      fs.writeFileSync(envPath, env.trim() + '\n');
+    } catch {}
+  }
+
+  // --- UAT-based IM operations (for P2P chats) ---
+
+  // Wrapper: call fn with UAT, retry once after refresh if auth fails (code 99991668/99991663)
+  async _withUAT(fn) {
+    let uat = await this._getValidUAT();
+    const data = await fn(uat);
+    if (data.code === 99991668 || data.code === 99991663) {
+      // Token invalid/expired — try refresh once
+      uat = await this._refreshUAT();
+      return fn(uat);
+    }
+    return data;
+  }
+
+  async listChatsAsUser({ pageSize = 20, pageToken } = {}) {
+    const params = new URLSearchParams({ page_size: String(pageSize) });
+    if (pageToken) params.set('page_token', pageToken);
+    const data = await this._withUAT(async (uat) => {
+      const res = await fetch(`https://open.feishu.cn/open-apis/im/v1/chats?${params}`, {
+        headers: { 'Authorization': `Bearer ${uat}` },
+      });
+      return res.json();
+    });
+    if (data.code !== 0) throw new Error(`listChatsAsUser failed (${data.code}): ${data.msg}`);
+    return { items: data.data.items || [], pageToken: data.data.page_token, hasMore: data.data.has_more };
+  }
+
+  async readMessagesAsUser(chatId, { pageSize = 20, startTime, endTime, pageToken } = {}) {
+    const params = new URLSearchParams({
+      container_id_type: 'chat', container_id: chatId, page_size: String(pageSize),
+    });
+    if (startTime) params.set('start_time', startTime);
+    if (endTime) params.set('end_time', endTime);
+    if (pageToken) params.set('page_token', pageToken);
+    const data = await this._withUAT(async (uat) => {
+      const res = await fetch(`https://open.feishu.cn/open-apis/im/v1/messages?${params}`, {
+        headers: { 'Authorization': `Bearer ${uat}` },
+      });
+      return res.json();
+    });
+    if (data.code !== 0) throw new Error(`readMessagesAsUser failed (${data.code}): ${data.msg}`);
+    return {
+      items: (data.data.items || []).map(m => this._formatMessage(m)),
+      hasMore: data.data.has_more,
+      pageToken: data.data.page_token,
+    };
+  }
+
+  // --- IM ---
+
+  async listChats({ pageSize = 20, pageToken } = {}) {
+    const res = await this.client.im.chat.list({ params: { page_size: pageSize, page_token: pageToken } });
+    if (res.code !== 0) throw new Error(`listChats failed (${res.code}): ${res.msg}`);
+    return { items: res.data.items || [], pageToken: res.data.page_token, hasMore: res.data.has_more };
+  }
+
+  async readMessages(chatId, { pageSize = 20, startTime, endTime, pageToken } = {}) {
+    const params = { container_id_type: 'chat', container_id: chatId, page_size: pageSize };
+    if (startTime) params.start_time = startTime;
+    if (endTime) params.end_time = endTime;
+    if (pageToken) params.page_token = pageToken;
+    const res = await this.client.im.message.list({ params });
+    if (res.code !== 0) throw new Error(`readMessages failed (${res.code}): ${res.msg}`);
+    return { items: (res.data.items || []).map(m => this._formatMessage(m)), hasMore: res.data.has_more, pageToken: res.data.page_token };
+  }
+
+  async getMessage(messageId) {
+    const res = await this.client.im.message.get({ path: { message_id: messageId } });
+    if (res.code !== 0) throw new Error(`getMessage failed (${res.code}): ${res.msg}`);
+    return this._formatMessage(res.data);
+  }
+
+  async replyMessage(messageId, text, msgType = 'text') {
+    const content = msgType === 'text' ? JSON.stringify({ text }) : text;
+    const res = await this.client.im.message.reply({
+      path: { message_id: messageId },
+      data: { content, msg_type: msgType },
+    });
+    if (res.code !== 0) throw new Error(`replyMessage failed (${res.code}): ${res.msg}`);
+    return { messageId: res.data.message_id };
+  }
+
+  async forwardMessage(messageId, receiverId, receiveIdType = 'chat_id') {
+    const res = await this.client.im.message.forward({
+      path: { message_id: messageId },
+      data: { receive_id: receiverId },
+      params: { receive_id_type: receiveIdType },
+    });
+    if (res.code !== 0) throw new Error(`forwardMessage failed (${res.code}): ${res.msg}`);
+    return { messageId: res.data.message_id };
+  }
+
+  // --- Docs ---
+
+  async searchDocs(query, { pageSize = 10, pageToken } = {}) {
+    const res = await this.client.request({
+      method: 'POST',
+      url: '/open-apis/suite/docs-api/search/object',
+      data: { search_key: query, count: pageSize, offset: pageToken ? parseInt(pageToken) : 0, owner_ids: [], chat_ids: [], docs_types: [] },
+    });
+    if (res.code !== 0) throw new Error(`searchDocs failed (${res.code}): ${res.msg}`);
+    return { items: res.data.docs_entities || [], hasMore: res.data.has_more };
+  }
+
+  async readDoc(documentId) {
+    const res = await this.client.docx.document.rawContent({ path: { document_id: documentId }, params: { lang: 0 } });
+    if (res.code !== 0) throw new Error(`readDoc failed (${res.code}): ${res.msg}`);
+    return { content: res.data.content };
+  }
+
+  async createDoc(title, folderId) {
+    const res = await this.client.docx.document.create({ data: { title, folder_token: folderId || '' } });
+    if (res.code !== 0) throw new Error(`createDoc failed (${res.code}): ${res.msg}`);
+    return { documentId: res.data.document?.document_id };
+  }
+
+  async getDocBlocks(documentId) {
+    const res = await this.client.docx.documentBlock.list({ path: { document_id: documentId }, params: { page_size: 500 } });
+    if (res.code !== 0) throw new Error(`getDocBlocks failed (${res.code}): ${res.msg}`);
+    return { items: res.data.items || [] };
+  }
+
+  // --- Bitable ---
+
+  async listBitableTables(appToken) {
+    const res = await this.client.bitable.appTable.list({ path: { app_token: appToken } });
+    if (res.code !== 0) throw new Error(`listTables failed (${res.code}): ${res.msg}`);
+    return { items: res.data.items || [] };
+  }
+
+  async listBitableFields(appToken, tableId) {
+    const res = await this.client.bitable.appTableField.list({ path: { app_token: appToken, table_id: tableId } });
+    if (res.code !== 0) throw new Error(`listFields failed (${res.code}): ${res.msg}`);
+    return { items: res.data.items || [] };
+  }
+
+  async searchBitableRecords(appToken, tableId, { filter, sort, pageSize = 20, pageToken } = {}) {
+    const data = {};
+    if (filter) data.filter = filter;
+    if (sort) data.sort = sort;
+    if (pageSize) data.page_size = pageSize;
+    if (pageToken) data.page_token = pageToken;
+    const res = await this.client.bitable.appTableRecord.search({
+      path: { app_token: appToken, table_id: tableId },
+      data,
+    });
+    if (res.code !== 0) throw new Error(`searchRecords failed (${res.code}): ${res.msg}`);
+    return { items: res.data.items || [], total: res.data.total, hasMore: res.data.has_more };
+  }
+
+  async createBitableRecord(appToken, tableId, fields) {
+    const res = await this.client.bitable.appTableRecord.create({
+      path: { app_token: appToken, table_id: tableId },
+      data: { fields },
+    });
+    if (res.code !== 0) throw new Error(`createRecord failed (${res.code}): ${res.msg}`);
+    return { recordId: res.data.record?.record_id };
+  }
+
+  async updateBitableRecord(appToken, tableId, recordId, fields) {
+    const res = await this.client.bitable.appTableRecord.update({
+      path: { app_token: appToken, table_id: tableId, record_id: recordId },
+      data: { fields },
+    });
+    if (res.code !== 0) throw new Error(`updateRecord failed (${res.code}): ${res.msg}`);
+    return { recordId: res.data.record?.record_id };
+  }
+
+  // --- Wiki ---
+
+  async listWikiSpaces() {
+    const res = await this.client.wiki.space.list({ params: { page_size: 50 } });
+    if (res.code !== 0) throw new Error(`listSpaces failed (${res.code}): ${res.msg}`);
+    return { items: res.data.items || [] };
+  }
+
+  async searchWiki(query) {
+    const res = await this.client.request({
+      method: 'POST',
+      url: '/open-apis/suite/docs-api/search/object',
+      data: { search_key: query, count: 20, offset: 0, owner_ids: [], chat_ids: [], docs_types: ['wiki'] },
+    });
+    if (res.code !== 0) throw new Error(`searchWiki failed (${res.code}): ${res.msg}`);
+    return { items: res.data.docs_entities || [] };
+  }
+
+  async getWikiNode(spaceId, nodeToken) {
+    const res = await this.client.wiki.space.getNode({
+      params: { token: nodeToken },
+    });
+    if (res.code !== 0) throw new Error(`getNode failed (${res.code}): ${res.msg}`);
+    return res.data.node;
+  }
+
+  async listWikiNodes(spaceId, { parentNodeToken, pageToken } = {}) {
+    const params = { page_size: 50 };
+    if (parentNodeToken) params.parent_node_token = parentNodeToken;
+    if (pageToken) params.page_token = pageToken;
+    const res = await this.client.wiki.spaceNode.list({
+      path: { space_id: spaceId },
+      params,
+    });
+    if (res.code !== 0) throw new Error(`listNodes failed (${res.code}): ${res.msg}`);
+    return { items: res.data.items || [], hasMore: res.data.has_more };
+  }
+
+  // --- Drive ---
+
+  async listFiles(folderToken, { pageSize = 50, pageToken } = {}) {
+    const params = { page_size: pageSize, folder_token: folderToken || '' };
+    if (pageToken) params.page_token = pageToken;
+    const res = await this.client.drive.file.list({ params });
+    if (res.code !== 0) throw new Error(`listFiles failed (${res.code}): ${res.msg}`);
+    return { items: res.data.files || [], hasMore: res.data.has_more };
+  }
+
+  async createFolder(name, parentToken) {
+    const res = await this.client.drive.file.createFolder({
+      data: { name, folder_token: parentToken || '' },
+    });
+    if (res.code !== 0) throw new Error(`createFolder failed (${res.code}): ${res.msg}`);
+    return { token: res.data.token };
+  }
+
+  // --- Contact ---
+
+  async findUserByIdentity({ emails, mobiles } = {}) {
+    const data = {};
+    if (emails) data.emails = Array.isArray(emails) ? emails : [emails];
+    if (mobiles) data.mobiles = Array.isArray(mobiles) ? mobiles : [mobiles];
+    const res = await this.client.contact.user.batchGetId({
+      data,
+      params: { user_id_type: 'open_id' },
+    });
+    if (res.code !== 0) throw new Error(`findUser failed (${res.code}): ${res.msg}`);
+    return { userList: res.data.user_list || [] };
+  }
+
+  // --- Chat ID Resolution ---
+
+  async listAllChats() {
+    const allChats = [];
+    let pageToken;
+    let hasMore = true;
+    while (hasMore) {
+      const res = await this.client.im.chat.list({ params: { page_size: 100, page_token: pageToken } });
+      if (res.code !== 0) throw new Error(`listAllChats failed (${res.code}): ${res.msg}`);
+      allChats.push(...(res.data.items || []));
+      pageToken = res.data.page_token;
+      hasMore = res.data.has_more && !!pageToken;
+    }
+    return allChats;
+  }
+
+  // --- Helpers ---
+
+  _formatMessage(m) {
+    if (!m) return null;
+    let body = m.body?.content || '';
+    try { body = JSON.parse(body); } catch {}
+    return {
+      messageId: m.message_id,
+      chatId: m.chat_id,
+      senderId: m.sender?.id,
+      senderType: m.sender?.sender_type,
+      msgType: m.msg_type,
+      content: body,
+      createTime: this._normalizeTimestamp(m.create_time),
+      updateTime: this._normalizeTimestamp(m.update_time),
+    };
+  }
+
+  _normalizeTimestamp(ts) {
+    if (!ts) return null;
+    const n = parseInt(ts);
+    // Feishu returns millisecond strings; normalize to seconds
+    return String(n > 1e12 ? Math.floor(n / 1000) : n);
+  }
+}
+
+module.exports = { LarkOfficialClient };

package/src/test-all.js

@@ -0,0 +1,324 @@
+#!/usr/bin/env node
+/**
+ * Comprehensive test for all feishu-user-plugin tools.
+ * Sends test messages to "飞书plugin测试群".
+ */
+require('dotenv').config({ path: require('path').join(__dirname, '..', '.env') });
+const { LarkUserClient } = require('./client');
+const { LarkOfficialClient } = require('./official');
+
+const TEST_GROUP = '飞书plugin测试群';
+const results = [];
+
+function log(tool, status, detail = '') {
+  const icon = status === 'PASS' ? '✅' : status === 'SKIP' ? '⏭️' : '❌';
+  results.push({ tool, status, detail });
+  console.log(`${icon} ${tool}: ${status} ${detail}`);
+}
+
+async function main() {
+  // --- Init clients ---
+  let userClient, officialClient;
+
+  // 1. get_login_status — Cookie auth
+  try {
+    userClient = new LarkUserClient(process.env.LARK_COOKIE);
+    await userClient.init();
+    log('get_login_status', 'PASS', `user=${userClient.userName || userClient.userId}`);
+  } catch (e) {
+    log('get_login_status', 'FAIL', e.message);
+    console.error('Cookie auth failed, cannot continue user identity tests.');
+    return;
+  }
+
+  // 2. Official client init
+  try {
+    officialClient = new LarkOfficialClient(process.env.LARK_APP_ID, process.env.LARK_APP_SECRET);
+    officialClient.loadUAT();
+    log('official_client_init', 'PASS', `hasUAT=${officialClient.hasUAT}`);
+  } catch (e) {
+    log('official_client_init', 'FAIL', e.message);
+  }
+
+  // ========== User Identity Tests ==========
+
+  // 3. search_contacts — search group
+  let groupId = null;
+  try {
+    const res = await userClient.search(TEST_GROUP);
+    const group = res.find(r => r.type === 'group');
+    if (group) {
+      groupId = group.id;
+      log('search_contacts (group)', 'PASS', `found "${group.title}" id=${group.id}`);
+    } else {
+      log('search_contacts (group)', 'FAIL', `group "${TEST_GROUP}" not found. results: ${JSON.stringify(res)}`);
+    }
+  } catch (e) {
+    log('search_contacts (group)', 'FAIL', e.message);
+  }
+
+  // 4. search_contacts — search user
+  let testUserId = null;
+  try {
+    const res = await userClient.search(userClient.userName || '吴坤儒');
+    const user = res.find(r => r.type === 'user');
+    if (user) {
+      testUserId = user.id;
+      log('search_contacts (user)', 'PASS', `found "${user.title}" id=${user.id}`);
+    } else {
+      log('search_contacts (user)', 'FAIL', 'no user found');
+    }
+  } catch (e) {
+    log('search_contacts (user)', 'FAIL', e.message);
+  }
+
+  // 5. get_chat_info
+  if (groupId) {
+    try {
+      const info = await userClient.getGroupInfo(groupId);
+      if (info && info.name) {
+        log('get_chat_info', 'PASS', `name="${info.name}" members=${info.memberCount}`);
+      } else {
+        log('get_chat_info', 'FAIL', 'no info returned');
+      }
+    } catch (e) {
+      log('get_chat_info', 'FAIL', e.message);
+    }
+  }
+
+  // 6. get_user_info
+  if (testUserId) {
+    try {
+      const name = await userClient.getUserName(testUserId, '0');
+      log('get_user_info', 'PASS', `name="${name}"`);
+    } catch (e) {
+      log('get_user_info', 'FAIL', e.message);
+    }
+  }
+
+  // 7. send_as_user (text)
+  if (groupId) {
+    try {
+      const r = await userClient.sendMessage(groupId, '[自动化测试] send_as_user: 文本消息测试');
+      log('send_as_user (text)', r.success ? 'PASS' : 'FAIL', `status=${r.status}`);
+    } catch (e) {
+      log('send_as_user (text)', 'FAIL', e.message);
+    }
+  }
+
+  // 8. send_to_group
+  try {
+    const searchRes = await userClient.search(TEST_GROUP);
+    const group = searchRes.find(r => r.type === 'group');
+    if (group) {
+      const r = await userClient.sendMessage(group.id, '[自动化测试] send_to_group: 群消息测试');
+      log('send_to_group', r.success ? 'PASS' : 'FAIL', `status=${r.status}`);
+    } else {
+      log('send_to_group', 'FAIL', 'group not found');
+    }
+  } catch (e) {
+    log('send_to_group', 'FAIL', e.message);
+  }
+
+  // 9. send_post_as_user (rich text)
+  if (groupId) {
+    try {
+      const paragraphs = [
+        [{ tag: 'text', text: '[自动化测试] send_post_as_user: ' }, { tag: 'text', text: '富文本消息测试' }],
+        [{ tag: 'text', text: '第二段落 - ' }, { tag: 'a', href: 'https://example.com', text: '链接测试' }],
+      ];
+      const r = await userClient.sendPost(groupId, '自动化测试 - 富文本', paragraphs);
+      log('send_post_as_user', r.success ? 'PASS' : 'FAIL', `status=${r.status}`);
+    } catch (e) {
+      log('send_post_as_user', 'FAIL', e.message);
+    }
+  }
+
+  // 10. send_image_as_user (skip — needs image_key)
+  log('send_image_as_user', 'SKIP', 'needs image_key from upload');
+
+  // 11. send_file_as_user (skip — needs file_key)
+  log('send_file_as_user', 'SKIP', 'needs file_key from upload');
+
+  // 12. send_sticker_as_user (skip — needs sticker IDs)
+  log('send_sticker_as_user', 'SKIP', 'needs sticker_id/sticker_set_id');
+
+  // 13. send_audio_as_user (skip — needs audio_key)
+  log('send_audio_as_user', 'SKIP', 'needs audio_key from upload');
+
+  // 14. create_p2p_chat
+  if (testUserId) {
+    try {
+      const chatId = await userClient.createChat(testUserId);
+      log('create_p2p_chat', chatId ? 'PASS' : 'FAIL', `chatId=${chatId}`);
+    } catch (e) {
+      log('create_p2p_chat', 'FAIL', e.message);
+    }
+  }
+
+  // ========== Official API Tests ==========
+
+  if (!officialClient) {
+    log('official_api_tests', 'SKIP', 'no official client');
+  } else {
+
+    // 15. list_chats
+    let ocChatId = null;
+    try {
+      const res = await officialClient.listChats({ pageSize: 5 });
+      if (res.items && res.items.length > 0) {
+        // find test group
+        const testChat = res.items.find(c => c.name && c.name.includes('plugin测试'));
+        ocChatId = testChat ? testChat.chat_id : res.items[0].chat_id;
+        log('list_chats', 'PASS', `found ${res.items.length} chats, using ${ocChatId}`);
+      } else {
+        log('list_chats', 'FAIL', 'no chats found');
+      }
+    } catch (e) {
+      log('list_chats', 'FAIL', e.message);
+    }
+
+    // 16. read_messages
+    let testMessageId = null;
+    if (ocChatId) {
+      try {
+        const res = await officialClient.readMessages(ocChatId, { pageSize: 10 });
+        // Find a text message to reply to
+        const textMsg = res.items.find(m => m.msgType === 'text');
+        if (textMsg) testMessageId = textMsg.messageId;
+        log('read_messages', 'PASS', `got ${res.items.length} messages, text msg=${testMessageId || 'none'}`);
+      } catch (e) {
+        log('read_messages', 'FAIL', e.message);
+      }
+    }
+
+    // 17. reply_message
+    if (testMessageId) {
+      try {
+        const res = await officialClient.replyMessage(testMessageId, '[自动化测试] reply_message: bot回复测试');
+        log('reply_message', res.messageId ? 'PASS' : 'FAIL', `messageId=${res.messageId}`);
+      } catch (e) {
+        log('reply_message', 'FAIL', e.message);
+      }
+    } else {
+      log('reply_message', 'SKIP', 'no text message to reply to');
+    }
+
+    // 18. forward_message (skip — would duplicate messages)
+    log('forward_message', 'SKIP', 'skipped to avoid duplicate messages');
+
+    // 19. search_docs
+    try {
+      const res = await officialClient.searchDocs('测试');
+      log('search_docs', 'PASS', `found ${(res.items || []).length} docs`);
+    } catch (e) {
+      log('search_docs', 'FAIL', e.message);
+    }
+
+    // 20. read_doc (skip — needs doc ID)
+    log('read_doc', 'SKIP', 'needs document_id from search_docs');
+
+    // 21. create_doc (skip — would create real doc)
+    log('create_doc', 'SKIP', 'skipped to avoid creating unnecessary docs');
+
+    // 22. list_bitable_tables (skip — needs app_token)
+    log('list_bitable_tables', 'SKIP', 'needs bitable app_token');
+
+    // 23. list_bitable_fields (skip)
+    log('list_bitable_fields', 'SKIP', 'needs app_token + table_id');
+
+    // 24. search_bitable_records (skip)
+    log('search_bitable_records', 'SKIP', 'needs app_token + table_id');
+
+    // 25. create_bitable_record (skip)
+    log('create_bitable_record', 'SKIP', 'needs app_token + table_id + fields');
+
+    // 26. update_bitable_record (skip)
+    log('update_bitable_record', 'SKIP', 'needs app_token + table_id + record_id');
+
+    // 27. list_wiki_spaces
+    try {
+      const res = await officialClient.listWikiSpaces();
+      log('list_wiki_spaces', 'PASS', `found ${(res.items || []).length} spaces`);
+    } catch (e) {
+      log('list_wiki_spaces', 'FAIL', e.message);
+    }
+
+    // 28. search_wiki
+    try {
+      const res = await officialClient.searchWiki('测试');
+      log('search_wiki', 'PASS', `found ${(res.items || []).length} nodes`);
+    } catch (e) {
+      log('search_wiki', 'FAIL', e.message);
+    }
+
+    // 29. list_wiki_nodes (skip — needs space_id)
+    log('list_wiki_nodes', 'SKIP', 'needs space_id from list_wiki_spaces');
+
+    // 30. list_files
+    try {
+      const res = await officialClient.listFiles();
+      log('list_files', 'PASS', `found ${(res.items || []).length} files`);
+    } catch (e) {
+      log('list_files', 'FAIL', e.message);
+    }
+
+    // 31. create_folder (skip)
+    log('create_folder', 'SKIP', 'skipped to avoid creating unnecessary folders');
+
+    // 32. find_user
+    try {
+      const res = await officialClient.findUserByIdentity({ emails: 'test@test.com' });
+      log('find_user', 'PASS', `returned ${(res.userList || []).length} users (expected 0 for test email)`);
+    } catch (e) {
+      log('find_user', 'FAIL', e.message);
+    }
+
+    // ========== UAT Tests ==========
+
+    if (officialClient.hasUAT) {
+      // 33. list_user_chats
+      let p2pChatId = null;
+      try {
+        const res = await officialClient.listChatsAsUser({ pageSize: 20 });
+        const items = res.items || [];
+        // find a p2p chat
+        const p2p = items.find(c => c.chat_mode === 'p2p');
+        if (p2p) p2pChatId = p2p.chat_id;
+        log('list_user_chats', 'PASS', `found ${items.length} chats, p2p=${p2pChatId || 'none'}`);
+      } catch (e) {
+        log('list_user_chats', 'FAIL', e.message);
+      }
+
+      // 34. read_p2p_messages
+      if (p2pChatId) {
+        try {
+          const res = await officialClient.readMessagesAsUser(p2pChatId, { pageSize: 3 });
+          log('read_p2p_messages', 'PASS', `got ${(res.items || []).length} messages`);
+        } catch (e) {
+          log('read_p2p_messages', 'FAIL', e.message);
+        }
+      } else {
+        log('read_p2p_messages', 'SKIP', 'no P2P chat found');
+      }
+    } else {
+      log('list_user_chats', 'SKIP', 'no UAT configured');
+      log('read_p2p_messages', 'SKIP', 'no UAT configured');
+    }
+  }
+
+  // ========== Summary ==========
+  console.log('\n========== TEST SUMMARY ==========');
+  const pass = results.filter(r => r.status === 'PASS').length;
+  const fail = results.filter(r => r.status === 'FAIL').length;
+  const skip = results.filter(r => r.status === 'SKIP').length;
+  console.log(`PASS: ${pass}  FAIL: ${fail}  SKIP: ${skip}  TOTAL: ${results.length}`);
+  if (fail > 0) {
+    console.log('\nFailed tests:');
+    for (const r of results.filter(r => r.status === 'FAIL')) {
+      console.log(`  ❌ ${r.tool}: ${r.detail}`);
+    }
+  }
+}
+
+main().catch(console.error);