@dasaying/feishu-doc-mcp 1.0.0 → 1.1.0

package/dist/index.js

@@ -21,7 +21,7 @@ import { InMemoryTaskMessageQueue, InMemoryTaskStore, isTerminal } from '@modelc
 import '@modelcontextprotocol/sdk/server/auth/errors.js';
 import { Hono } from 'hono';
 import { cors } from 'hono/cors';
-import * as z17 from 'zod/v4';
+import * as z18 from 'zod/v4';
 import '@modelcontextprotocol/sdk/shared/auth.js';
 import 'hono/bearer-auth';
 import { ErrorCode, JSONRPCMessageSchema, isInitializeRequest, isJSONRPCRequest, DEFAULT_NEGOTIATED_PROTOCOL_VERSION, SUPPORTED_PROTOCOL_VERSIONS, isJSONRPCResultResponse, isJSONRPCErrorResponse } from '@modelcontextprotocol/sdk/types.js';
@@ -47,7 +47,7 @@ var __decorateParam = (index, decorator) => (target, key) => decorator(target, k
 // package.json
 var package_default = {
   name: "@dasaying/feishu-doc-mcp",
-  version: "1.0.0",
+  version: "1.1.0",
   description: "\u98DE\u4E66\u4E91\u6587\u6863 MCP \u670D\u52A1\u5668 - \u652F\u6301 Markdown \u6587\u6863\u4E0A\u4F20\u3001\u8BFB\u53D6\u548C\u6279\u91CF\u64CD\u4F5C\u3002Feishu (Lark) Document MCP Server - Support Markdown upload, read and batch operations."};
 var JsonRpcErrorCode = /* @__PURE__ */ ((JsonRpcErrorCode2) => {
   JsonRpcErrorCode2[JsonRpcErrorCode2["ParseError"] = -32700] = "ParseError";
@@ -3918,6 +3918,7 @@ var FileSystemProvider = class {
   }
   getTenantPath(tenantId) {
     const sanitizedTenantId = sanitization.sanitizePath(tenantId, {
+      rootDir: this.storagePath,
       toPosix: true
     }).sanitizedPath;
     if (sanitizedTenantId.includes("/") || sanitizedTenantId.includes("..")) {
@@ -6197,7 +6198,7 @@ var FEISHU_CONFIG = {
   TOKEN_URL: "https://open.feishu.cn/open-apis/authen/v2/oauth/token",
   REFRESH_TOKEN_URL: "https://open.feishu.cn/open-apis/authen/v2/oauth/token",
   // API 权限范围（包含 offline_access 以支持 refresh_token）
-  SCOPES: "contact:user.base:readonly docx:document wiki:wiki drive:drive offline_access",
+  SCOPES: "contact:user.base:readonly docx:document wiki:wiki drive:drive bitable:app offline_access",
   // 文件上传相关（使用素材上传 API，导入后自动删除源文件）
   UPLOAD_URL: "https://open.feishu.cn/open-apis/drive/v1/medias/upload_all",
   // 文档创建相关
@@ -6943,12 +6944,14 @@ var FeishuService = class {
       const content = await this.apiProvider.getDocumentContent(
         auth.accessToken,
         documentId,
-        options.documentType
+        options.documentType,
+        options.wikiSpaceId
       );
       const metadata = await this.apiProvider.getDocumentMetadata(
         auth.accessToken,
         documentId,
-        options.documentType
+        options.documentType,
+        options.wikiSpaceId
       );
       const conversionResult = this.convertToMarkdown(content, options);
       let downloadedImages = 0;
@@ -6980,7 +6983,7 @@ var FeishuService = class {
         downloadedImages,
         downloadedAttachments
       };
-      if (outputFile) result.outputFile = outputFile;
+      if (outputFile !== void 0) result.outputFile = outputFile;
       return result;
     } catch (error) {
       logger.error(
@@ -7051,6 +7054,157 @@ var FeishuService = class {
       results
     };
   }
+  /**
+   * readBitable method 读取多维表格.
+   */
+  async readBitable(bitableToken, options, context) {
+    logger.info("\u8BFB\u53D6\u591A\u7EF4\u8868\u683C", { ...context, bitableToken, options });
+    try {
+      const finalAppId = options.appId || FEISHU_CONFIG.DEFAULT_APP_ID;
+      if (!finalAppId) {
+        throw new McpError(-32602 /* InvalidParams */, "\u672A\u914D\u7F6E\u5E94\u7528 ID");
+      }
+      const auth = await this.getAuth(finalAppId, context);
+      if (!auth) {
+        throw new McpError(
+          -32602 /* InvalidParams */,
+          "\u672A\u627E\u5230\u6709\u6548\u7684\u8BA4\u8BC1\u4FE1\u606F"
+        );
+      }
+      const validAuth = await this.ensureValidToken(auth, context);
+      const metadata = await this.apiProvider.getBitableMetadata(
+        validAuth.accessToken,
+        bitableToken
+      );
+      const tables = await this.apiProvider.getBitableTables(
+        validAuth.accessToken,
+        bitableToken
+      );
+      const tableResults = [];
+      for (const table of tables) {
+        const fields = await this.apiProvider.getBitableFields(
+          validAuth.accessToken,
+          bitableToken,
+          table.tableId
+        );
+        const allRecords = [];
+        let pageToken;
+        let hasMore = true;
+        while (hasMore) {
+          const recordsResult = await this.apiProvider.getBitableRecords(
+            validAuth.accessToken,
+            bitableToken,
+            table.tableId,
+            100,
+            pageToken
+          );
+          allRecords.push(...recordsResult.records);
+          hasMore = recordsResult.hasMore;
+          pageToken = recordsResult.pageToken;
+        }
+        let markdown2 = "";
+        if (options.outputFormat === "markdown" || !options.outputFormat) {
+          markdown2 = this.convertBitableToMarkdown(
+            table.name,
+            fields,
+            allRecords
+          );
+        }
+        tableResults.push({
+          tableId: table.tableId,
+          name: table.name,
+          markdown: markdown2,
+          records: allRecords
+        });
+      }
+      let fullMarkdown = "";
+      if (options.outputFormat === "markdown" || !options.outputFormat) {
+        fullMarkdown = `# ${metadata.name}
+
+`;
+        for (const table of tableResults) {
+          fullMarkdown += table.markdown + "\n\n";
+        }
+      }
+      logger.info("\u591A\u7EF4\u8868\u683C\u8BFB\u53D6\u6210\u529F", {
+        ...context,
+        bitableToken,
+        name: metadata.name,
+        tableCount: tables.length
+      });
+      return {
+        success: true,
+        bitableToken,
+        name: metadata.name,
+        content: fullMarkdown,
+        tables: tableResults
+      };
+    } catch (error) {
+      logger.error(
+        "\u8BFB\u53D6\u591A\u7EF4\u8868\u683C\u5931\u8D25",
+        error instanceof Error ? error : new Error(String(error)),
+        context
+      );
+      return {
+        success: false,
+        bitableToken,
+        error: error instanceof Error ? error.message : String(error)
+      };
+    }
+  }
+  /**
+   * convertBitableToMarkdown method 将多维表格转换为 Markdown.
+   */
+  convertBitableToMarkdown(tableName, fields, records) {
+    if (records.length === 0) {
+      return `## ${tableName}
+
+*\uFF08\u7A7A\u8868\u683C\uFF09*
+`;
+    }
+    let markdown2 = `## ${tableName}
+
+`;
+    const headers = fields.map((f) => f.fieldName);
+    markdown2 += "| " + headers.join(" | ") + " |\n";
+    markdown2 += "| " + headers.map(() => "---").join(" | ") + " |\n";
+    for (const record of records) {
+      const row = fields.map((field) => {
+        const value = record.fields[field.fieldName];
+        if (value === null || value === void 0) {
+          return "";
+        }
+        if (Array.isArray(value)) {
+          return value.map((v) => this.formatCellValue(v)).join(", ");
+        }
+        return this.formatCellValue(value);
+      });
+      markdown2 += "| " + row.join(" | ") + " |\n";
+    }
+    return markdown2;
+  }
+  /**
+   * formatCellValue method 格式化单元格值.
+   */
+  formatCellValue(value) {
+    if (value === null || value === void 0) {
+      return "";
+    }
+    if (typeof value === "object") {
+      if ("text" in value && typeof value.text === "string") {
+        return value.text;
+      }
+      if ("name" in value && typeof value.name === "string") {
+        return value.name;
+      }
+      if ("link" in value && typeof value.link === "string") {
+        return value.link;
+      }
+      return JSON.stringify(value);
+    }
+    const primitiveValue = value;
+    return String(primitiveValue).replace(/\|/g, "\\|").replace(/\n/g, " ");
+  }
   /**
    * readWikiRecursive method 递归读取知识库.
    */
@@ -7165,6 +7319,9 @@ var FeishuService = class {
   async downloadResources(resources, options, accessToken) {
     let images = 0;
     let attachments = 0;
+    if (!options.downloadImages && !options.downloadAttachments) {
+      return { images, attachments };
+    }
     for (const resource of resources) {
       if (resource.type === "image" && options.downloadImages) {
         const savePath = `${options.assetsPath ?? "./assets"}/${resource.fileToken}`;
@@ -7917,7 +8074,7 @@ var FeishuApiProvider = class {
   async createDocument(accessToken, title, content, targetType, targetId, parentNodeToken) {
     const ctx = requestContextService.createRequestContext({
       operation: "feishu.createDocument",
-      tenantId: "feishu-service"
+      tenantId: "feishu_service"
     });
     logger.info("\u5F00\u59CB\u521B\u5EFA\u98DE\u4E66\u6587\u6863", {
       ...ctx,
@@ -8251,6 +8408,140 @@ var FeishuApiProvider = class {
       return result;
     });
   }
+  /**
+   * getBitableMetadata method 获取多维表格元数据.
+   */
+  async getBitableMetadata(accessToken, bitableToken) {
+    const ctx = requestContextService.createRequestContext({
+      operation: "feishu.getBitableMetadata",
+      tenantId: "feishu_service"
+    });
+    logger.info("\u83B7\u53D6\u591A\u7EF4\u8868\u683C\u5143\u6570\u636E", { ...ctx, bitableToken });
+    try {
+      const url2 = `${FEISHU_CONFIG.BASE_URL}/bitable/v1/apps/${bitableToken}`;
+      const response = await this.requestWithAuth(url2, accessToken, { method: "GET" });
+      if (response.code !== 0 || !response.data) {
+        throw new McpError(
+          -32603 /* InternalError */,
+          response.msg ?? "\u83B7\u53D6\u591A\u7EF4\u8868\u683C\u5143\u6570\u636E\u5931\u8D25"
+        );
+      }
+      return {
+        name: response.data.app.name,
+        revision: response.data.app.revision,
+        isAdvanced: response.data.app.is_advanced
+      };
+    } catch (error) {
+      logger.error("\u83B7\u53D6\u591A\u7EF4\u8868\u683C\u5143\u6570\u636E\u5931\u8D25", error instanceof Error ? error : new Error(String(error)), ctx);
+      throw error instanceof McpError ? error : new McpError(
+        -32603 /* InternalError */,
+        `\u83B7\u53D6\u591A\u7EF4\u8868\u683C\u5143\u6570\u636E\u5931\u8D25: ${String(error)}`
+      );
+    }
+  }
+  /**
+   * getBitableTables method 获取多维表格的所有数据表.
+   */
+  async getBitableTables(accessToken, bitableToken) {
+    const ctx = requestContextService.createRequestContext({
+      operation: "feishu.getBitableTables",
+      tenantId: "feishu_service"
+    });
+    logger.info("\u83B7\u53D6\u591A\u7EF4\u8868\u683C\u6570\u636E\u8868\u5217\u8868", { ...ctx, bitableToken });
+    try {
+      const url2 = `${FEISHU_CONFIG.BASE_URL}/bitable/v1/apps/${bitableToken}/tables?page_size=100`;
+      const response = await this.requestWithAuth(url2, accessToken, { method: "GET" });
+      if (response.code !== 0 || !response.data) {
+        throw new McpError(
+          -32603 /* InternalError */,
+          response.msg ?? "\u83B7\u53D6\u6570\u636E\u8868\u5217\u8868\u5931\u8D25"
+        );
+      }
+      return response.data.items.map((table) => ({
+        tableId: table.table_id,
+        name: table.name,
+        revision: table.revision
+      }));
+    } catch (error) {
+      logger.error("\u83B7\u53D6\u6570\u636E\u8868\u5217\u8868\u5931\u8D25", error instanceof Error ? error : new Error(String(error)), ctx);
+      throw error instanceof McpError ? error : new McpError(
+        -32603 /* InternalError */,
+        `\u83B7\u53D6\u6570\u636E\u8868\u5217\u8868\u5931\u8D25: ${String(error)}`
+      );
+    }
+  }
+  /**
+   * getBitableFields method 获取数据表的字段信息.
+   */
+  async getBitableFields(accessToken, bitableToken, tableId) {
+    const ctx = requestContextService.createRequestContext({
+      operation: "feishu.getBitableFields",
+      tenantId: "feishu_service"
+    });
+    logger.info("\u83B7\u53D6\u6570\u636E\u8868\u5B57\u6BB5", { ...ctx, bitableToken, tableId });
+    try {
+      const url2 = `${FEISHU_CONFIG.BASE_URL}/bitable/v1/apps/${bitableToken}/tables/${tableId}/fields?page_size=100`;
+      const response = await this.requestWithAuth(url2, accessToken, { method: "GET" });
+      if (response.code !== 0 || !response.data) {
+        throw new McpError(
+          -32603 /* InternalError */,
+          response.msg ?? "\u83B7\u53D6\u5B57\u6BB5\u4FE1\u606F\u5931\u8D25"
+        );
+      }
+      return response.data.items.map((field) => ({
+        fieldId: field.field_id,
+        fieldName: field.field_name,
+        type: field.type,
+        property: field.property
+      }));
+    } catch (error) {
+      logger.error("\u83B7\u53D6\u5B57\u6BB5\u4FE1\u606F\u5931\u8D25", error instanceof Error ? error : new Error(String(error)), ctx);
+      throw error instanceof McpError ? error : new McpError(
+        -32603 /* InternalError */,
+        `\u83B7\u53D6\u5B57\u6BB5\u4FE1\u606F\u5931\u8D25: ${String(error)}`
+      );
+    }
+  }
+  /**
+   * getBitableRecords method 获取数据表的记录.
+   */
+  async getBitableRecords(accessToken, bitableToken, tableId, pageSize = 100, pageToken) {
+    const ctx = requestContextService.createRequestContext({
+      operation: "feishu.getBitableRecords",
+      tenantId: "feishu_service"
+    });
+    logger.info("\u83B7\u53D6\u6570\u636E\u8868\u8BB0\u5F55", { ...ctx, bitableToken, tableId, pageSize });
+    try {
+      let url2 = `${FEISHU_CONFIG.BASE_URL}/bitable/v1/apps/${bitableToken}/tables/${tableId}/records?page_size=${pageSize}`;
+      if (pageToken) {
+        url2 += `&page_token=${pageToken}`;
+      }
+      const response = await this.requestWithAuth(url2, accessToken, { method: "GET" });
+      if (response.code !== 0 || !response.data) {
+        throw new McpError(
+          -32603 /* InternalError */,
+          response.msg ?? "\u83B7\u53D6\u8BB0\u5F55\u5931\u8D25"
+        );
+      }
+      const result = {
+        records: response.data.items.map((record) => ({
+          recordId: record.record_id,
+          fields: record.fields
+        })),
+        hasMore: response.data.has_more
+      };
+      if (response.data.page_token) {
+        result.pageToken = response.data.page_token;
+      }
+      return result;
+    } catch (error) {
+      logger.error("\u83B7\u53D6\u8BB0\u5F55\u5931\u8D25", error instanceof Error ? error : new Error(String(error)), ctx);
+      throw error instanceof McpError ? error : new McpError(
+        -32603 /* InternalError */,
+        `\u83B7\u53D6\u8BB0\u5F55\u5931\u8D25: ${String(error)}`
+      );
+    }
+  }
   /**
    * healthCheck method 健康检查.
    */
@@ -8402,7 +8693,7 @@ var FeishuApiProvider = class {
   async uploadMarkdownFile(accessToken, fileName, content) {
     const ctx = requestContextService.createRequestContext({
       operation: "feishu.uploadMarkdownFile",
-      tenantId: "feishu-service"
+      tenantId: "feishu_service"
     });
     try {
       logger.debug("\u5F00\u59CB\u4E0A\u4F20Markdown\u6587\u4EF6", {
@@ -8510,7 +8801,7 @@ var FeishuApiProvider = class {
   async createImportTask(accessToken, fileToken, title, targetFolderId) {
     const ctx = requestContextService.createRequestContext({
       operation: "feishu.createImportTask",
-      tenantId: "feishu-service"
+      tenantId: "feishu_service"
     });
     try {
       const url2 = `${FEISHU_CONFIG.BASE_URL}/drive/v1/import_tasks`;
@@ -8590,7 +8881,7 @@ var FeishuApiProvider = class {
     const maxAttempts = 30;
     const ctx = requestContextService.createRequestContext({
       operation: "feishu.waitForImportCompletion",
-      tenantId: "feishu-service"
+      tenantId: "feishu_service"
     });
     logger.info("\u5F00\u59CB\u7B49\u5F85\u5BFC\u5165\u4EFB\u52A1\u5B8C\u6210", {
       ...ctx,
@@ -8773,18 +9064,18 @@ var FeishuApiProvider = class {
   /**
    * getDocumentContent method 获取文档内容.
    */
-  async getDocumentContent(accessToken, documentId, documentType) {
+  async getDocumentContent(accessToken, documentId, documentType, wikiSpaceId) {
     const ctx = requestContextService.createRequestContext({
       operation: "feishu.getDocumentContent",
-      tenantId: "feishu-service"
+      tenantId: "feishu_service"
     });
-    logger.info("\u83B7\u53D6\u6587\u6863\u5185\u5BB9", { ...ctx, documentId, documentType });
+    logger.info("\u83B7\u53D6\u6587\u6863\u5185\u5BB9", { ...ctx, documentId, documentType, wikiSpaceId });
     try {
       let url2;
       if (documentType === "drive") {
         url2 = `${FEISHU_CONFIG.BASE_URL}/docx/v1/documents/${documentId}/blocks`;
       } else {
-        url2 = `${FEISHU_CONFIG.BASE_URL}/wiki/v2/spaces/${documentId}/nodes`;
+        url2 = `${FEISHU_CONFIG.BASE_URL}/docx/v1/documents/${documentId}/blocks`;
       }
       const response = await this.requestWithAuth(url2, accessToken, { method: "GET" });
       if (response.code !== 0 || !response.data) {
@@ -8794,6 +9085,16 @@ var FeishuApiProvider = class {
         );
       }
       const blocks = response.data.blocks ?? response.data.items ?? [];
+      logger.debug("\u98DE\u4E66 API \u8FD4\u56DE\u7684 blocks \u6570\u636E", {
+        ...ctx,
+        blockCount: blocks.length,
+        sampleBlocks: blocks.slice(0, 5).map((b) => ({
+          block_id: b.block_id,
+          block_type: b.block_type,
+          keys: Object.keys(b),
+          data: JSON.stringify(b).substring(0, 500)
+        }))
+      });
       return {
         documentId,
         title: "",
@@ -8820,19 +9121,14 @@ var FeishuApiProvider = class {
   /**
    * getDocumentMetadata method 获取文档元数据.
    */
-  async getDocumentMetadata(accessToken, documentId, documentType) {
+  async getDocumentMetadata(accessToken, documentId, documentType, wikiSpaceId) {
     const ctx = requestContextService.createRequestContext({
       operation: "feishu.getDocumentMetadata",
-      tenantId: "feishu-service"
+      tenantId: "feishu_service"
     });
-    logger.info("\u83B7\u53D6\u6587\u6863\u5143\u6570\u636E", { ...ctx, documentId, documentType });
+    logger.info("\u83B7\u53D6\u6587\u6863\u5143\u6570\u636E", { ...ctx, documentId, documentType, wikiSpaceId });
     try {
-      let url2;
-      if (documentType === "drive") {
-        url2 = `${FEISHU_CONFIG.BASE_URL}/docx/v1/documents/${documentId}`;
-      } else {
-        url2 = `${FEISHU_CONFIG.BASE_URL}/wiki/v2/spaces/${documentId}`;
-      }
+      const url2 = `${FEISHU_CONFIG.BASE_URL}/docx/v1/documents/${documentId}`;
       const response = await this.requestWithAuth(url2, accessToken, { method: "GET" });
       if (response.code !== 0 || !response.data) {
         throw new McpError(
@@ -8873,7 +9169,7 @@ var FeishuApiProvider = class {
   async downloadFile(accessToken, fileToken, savePath) {
     const ctx = requestContextService.createRequestContext({
       operation: "feishu.downloadFile",
-      tenantId: "feishu-service"
+      tenantId: "feishu_service"
     });
     logger.info("\u4E0B\u8F7D\u6587\u4EF6", { ...ctx, fileToken, savePath });
     try {
@@ -9103,7 +9399,7 @@ var ContentConverterProvider = class {
   convert(content, _options) {
     const ctx = requestContextService.createRequestContext({
       operation: "contentConverter.convert",
-      tenantId: "feishu-service"
+      tenantId: "feishu_service"
     });
     logger.info("\u5F00\u59CB\u8F6C\u6362\u6587\u6863\u5185\u5BB9", {
       ...ctx,
@@ -9188,6 +9484,13 @@ var ContentConverterProvider = class {
     const block = blockMap.get(blockId);
     if (!block) return "";
     const result = [];
+    if (block.blockType === "table") {
+      const tableMarkdown = this.convertTableWithCells(block, blockMap);
+      if (tableMarkdown) {
+        result.push(tableMarkdown);
+      }
+      return result.join("\n\n");
+    }
     const markdown2 = this.convertBlock(block, depth);
     if (markdown2) {
       result.push(markdown2);
@@ -9247,12 +9550,14 @@ var ContentConverterProvider = class {
         return this.convertFileBlock(block);
       case "table":
         return this.convertTableBlock(block);
+      case "table_cell":
+        return this.convertTableCellBlock(block);
       case "page":
         return "";
       default:
         const ctx = requestContextService.createRequestContext({
           operation: "contentConverter.convertBlock",
-          tenantId: "feishu-service"
+          tenantId: "feishu_service"
         });
         logger.warning("\u4E0D\u652F\u6301\u7684\u5757\u7C7B\u578B", {
           ...ctx,
@@ -9266,18 +9571,78 @@ var ContentConverterProvider = class {
    * extractText method 提取块中的文本内容.
    */
   extractText(block) {
-    if (!block.content?.text) return "";
-    return block.content.text.map((run2) => {
-      let text = run2.text;
-      if (run2.style) {
-        if (run2.style.bold) text = `**${text}**`;
-        if (run2.style.italic) text = `*${text}*`;
-        if (run2.style.strikethrough) text = `~~${text}~~`;
-        if (run2.style.inlineCode) text = `\`${text}\``;
-        if (run2.style.link) text = `[${text}](${run2.style.link.url})`;
-      }
-      return text;
-    }).join("");
+    if (!block.content) return "";
+    const blockContent = block.content;
+    let elements;
+    if (blockContent.page && typeof blockContent.page === "object") {
+      elements = blockContent.page.elements;
+    } else if (blockContent.heading1 && typeof blockContent.heading1 === "object") {
+      elements = blockContent.heading1.elements;
+    } else if (blockContent.heading2 && typeof blockContent.heading2 === "object") {
+      elements = blockContent.heading2.elements;
+    } else if (blockContent.heading3 && typeof blockContent.heading3 === "object") {
+      elements = blockContent.heading3.elements;
+    } else if (blockContent.heading4 && typeof blockContent.heading4 === "object") {
+      elements = blockContent.heading4.elements;
+    } else if (blockContent.heading5 && typeof blockContent.heading5 === "object") {
+      elements = blockContent.heading5.elements;
+    } else if (blockContent.heading6 && typeof blockContent.heading6 === "object") {
+      elements = blockContent.heading6.elements;
+    } else if (blockContent.heading7 && typeof blockContent.heading7 === "object") {
+      elements = blockContent.heading7.elements;
+    } else if (blockContent.heading8 && typeof blockContent.heading8 === "object") {
+      elements = blockContent.heading8.elements;
+    } else if (blockContent.heading9 && typeof blockContent.heading9 === "object") {
+      elements = blockContent.heading9.elements;
+    } else if (blockContent.text && typeof blockContent.text === "object") {
+      elements = blockContent.text.elements;
+    } else if (blockContent.bullet && typeof blockContent.bullet === "object") {
+      elements = blockContent.bullet.elements;
+    } else if (blockContent.ordered && typeof blockContent.ordered === "object") {
+      elements = blockContent.ordered.elements;
+    } else if (blockContent.code && typeof blockContent.code === "object") {
+      elements = blockContent.code.elements;
+    } else if (blockContent.quote && typeof blockContent.quote === "object") {
+      elements = blockContent.quote.elements;
+    } else if (blockContent.todo && typeof blockContent.todo === "object") {
+      elements = blockContent.todo.elements;
+    } else if (blockContent.callout && typeof blockContent.callout === "object") {
+      elements = blockContent.callout.elements;
+    } else if (blockContent.elements && Array.isArray(blockContent.elements)) {
+      elements = blockContent.elements;
+    }
+    if (elements && Array.isArray(elements)) {
+      return elements.map((element) => {
+        if (!element.text_run?.content) return "";
+        let text = element.text_run.content;
+        const style = element.text_run.text_element_style;
+        if (style) {
+          if (style.bold) text = `**${text}**`;
+          if (style.italic) text = `*${text}*`;
+          if (style.strikethrough) text = `~~${text}~~`;
+          if (style.inline_code) text = `\`${text}\``;
+          if (style.link?.url) text = `[${text}](${style.link.url})`;
+        }
+        return text;
+      }).join("");
+    }
+    if (blockContent.text && Array.isArray(blockContent.text)) {
+      return blockContent.text.map((run2) => {
+        let text = run2.text;
+        if (run2.style) {
+          if (run2.style.bold) text = `**${text}**`;
+          if (run2.style.italic) text = `*${text}*`;
+          if (run2.style.strikethrough) text = `~~${text}~~`;
+          if (run2.style.inlineCode) text = `\`${text}\``;
+          if (run2.style.link) text = `[${text}](${run2.style.link.url})`;
+        }
+        return text;
+      }).join("");
+    }
+    if (typeof blockContent.text === "string") {
+      return blockContent.text;
+    }
+    return "";
   }
   /**
    * convertCodeBlock method 转换代码块.
@@ -9328,13 +9693,74 @@ ${text}
   /**
    * convertTableBlock method 转换表格块.
    */
-  convertTableBlock(block) {
-    const ctx = requestContextService.createRequestContext({
-      operation: "contentConverter.convertTableBlock",
-      tenantId: "feishu-service"
-    });
-    logger.warning("\u8868\u683C\u8F6C\u6362\u6682\u672A\u5B8C\u5168\u5B9E\u73B0", { ...ctx, blockId: block.blockId });
-    return "<!-- Table content -->";
+  convertTableBlock(_block) {
+    return "";
+  }
+  /**
+   * convertTableCellBlock method 转换表格单元格块.
+   */
+  convertTableCellBlock(block) {
+    return this.extractText(block);
+  }
+  /**
+   * convertTableWithCells method 转换表格及其所有单元格.
+   */
+  convertTableWithCells(tableBlock, blockMap) {
+    if (!tableBlock.children || tableBlock.children.length === 0) {
+      return "<!-- Empty table -->";
+    }
+    const tableContent = tableBlock.content;
+    const rowSize = tableContent?.table?.property?.row_size ?? 0;
+    const columnSize = tableContent?.table?.property?.column_size ?? 0;
+    if (rowSize === 0 || columnSize === 0) {
+      return "<!-- Invalid table -->";
+    }
+    const rows = [];
+    for (let i = 0; i < rowSize; i++) {
+      rows.push(new Array(columnSize).fill(""));
+    }
+    let cellIndex = 0;
+    for (const cellId of tableBlock.children) {
+      const cell = blockMap.get(cellId);
+      if (!cell || cell.blockType !== "table_cell") continue;
+      const rowIndex = Math.floor(cellIndex / columnSize);
+      const columnIndex = cellIndex % columnSize;
+      cellIndex++;
+      if (rowIndex < rowSize && columnIndex < columnSize) {
+        let cellText = "";
+        if (cell.children && cell.children.length > 0) {
+          const childTexts = [];
+          for (const childId of cell.children) {
+            const childBlock = blockMap.get(childId);
+            if (childBlock) {
+              const text = this.extractText(childBlock);
+              if (text) {
+                childTexts.push(text);
+              }
+            }
+          }
+          cellText = childTexts.join(" ");
+        } else {
+          cellText = this.extractText(cell);
+        }
+        if (rows[rowIndex] && columnIndex < columnSize) {
+          rows[rowIndex][columnIndex] = cellText;
+        }
+      }
+    }
+    const lines = [];
+    if (rows.length === 0 || !rows[0]) {
+      return "<!-- Empty table -->";
+    }
+    lines.push("| " + rows[0].join(" | ") + " |");
+    lines.push("| " + rows[0].map(() => "---").join(" | ") + " |");
+    for (let i = 1; i < rows.length; i++) {
+      const row = rows[i];
+      if (row) {
+        lines.push("| " + row.join(" | ") + " |");
+      }
+    }
+    return lines.join("\n");
   }
 };
 ContentConverterProvider = __decorateClass([
@@ -9522,9 +9948,9 @@ ResourceRegistry = __decorateClass([
   injectable(),
   __decorateParam(0, injectAll(ResourceDefinitions, { isOptional: true }))
 ], ResourceRegistry);
-var registerResources = (container25) => {
+var registerResources = (container26) => {
   for (const resource of allResourceDefinitions) {
-    container25.register(ResourceDefinitions, { useValue: resource });
+    container26.register(ResourceDefinitions, { useValue: resource });
   }
 };
 
@@ -9759,7 +10185,7 @@ async function authCallbackLogic(input, appContext, _sdkContext) {
   try {
     const context = requestContextService.createRequestContext({
       operation: "feishu.handleAuthCallback",
-      tenantId: "feishu-service"
+      tenantId: "feishu_service"
     });
     const result = await feishuService.handleAuthCallback(
       input.code,
@@ -9907,7 +10333,7 @@ async function uploadLogic(input, appContext, _sdkContext) {
   });
   const context = requestContextService.createRequestContext({
     operation: "feishu.uploadMarkdown",
-    tenantId: "feishu-service"
+    tenantId: "feishu_service"
   });
   let content;
   let documentTitle = input.title;
@@ -10073,7 +10499,7 @@ async function updateLogic(input, appContext, _sdkContext) {
   });
   const context = requestContextService.createRequestContext({
     operation: "feishu.updateDocument",
-    tenantId: "feishu-service"
+    tenantId: "feishu_service"
   });
   let content;
   let workingDirectory = input.workingDirectory;
@@ -10215,7 +10641,7 @@ async function listFoldersLogic(input, appContext, _sdkContext) {
   );
   const ctx = requestContextService.createRequestContext({
     operation: "feishu.listFolders",
-    tenantId: "feishu-service"
+    tenantId: "feishu_service"
   });
   try {
     const folders = await feishuService.listFolders(
@@ -10311,7 +10737,7 @@ async function listWikisLogic(input, appContext, _sdkContext) {
   );
   const ctx = requestContextService.createRequestContext({
     operation: "feishu.listWikis",
-    tenantId: "feishu-service"
+    tenantId: "feishu_service"
   });
   try {
     const wikis = await feishuService.listWikis(ctx, input.appId);
@@ -10430,7 +10856,7 @@ async function listWikiNodesLogic(input, appContext, _sdkContext) {
   );
   const ctx = requestContextService.createRequestContext({
     operation: "feishu.listWikiNodes",
-    tenantId: "feishu-service"
+    tenantId: "feishu_service"
   });
   const nodes = await feishuService.getWikiNodes(
     ctx,
@@ -10518,7 +10944,7 @@ async function getUserInfoLogic(input, appContext, _sdkContext) {
   const storage = container.resolve(StorageService);
   const ctx = requestContextService.createRequestContext({
     operation: "feishu.getUserInfo",
-    tenantId: "feishu-service"
+    tenantId: "feishu_service"
   });
   const appId = input.appId || "cli_a9e211f948381bdf";
   const auth = await storage.get(`feishu/auth/${appId}`, ctx);
@@ -10592,7 +11018,7 @@ async function setDefaultAppLogic(input, appContext, _sdkContext) {
   const storage = container.resolve(StorageService);
   const ctx = requestContextService.createRequestContext({
     operation: "feishu.setDefaultApp",
-    tenantId: "feishu-service"
+    tenantId: "feishu_service"
   });
   const auth = await storage.get(
     `feishu/auth/${input.appId}`,
@@ -10676,7 +11102,7 @@ async function listAppsLogic(_input, appContext, _sdkContext) {
     const storage = container.resolve(StorageService);
     const ctx = requestContextService.createRequestContext({
       operation: "feishu.listApps",
-      tenantId: "feishu-service"
+      tenantId: "feishu_service"
     });
     const defaultAppId = await storage.get(
       "feishu/config/default_app",
@@ -10871,7 +11297,7 @@ async function batchUploadLogic(input, appContext, _sdkContext) {
   );
   const context = requestContextService.createRequestContext({
     operation: "feishu.batchUploadMarkdown",
-    tenantId: "feishu-service"
+    tenantId: "feishu_service"
   });
   const baseWorkingDirectory = input.workingDirectory || process.cwd();
   const uploadDocument = async (doc, index) => {
@@ -11090,7 +11516,7 @@ async function readLogic(input, appContext, _sdkContext) {
   });
   const context = requestContextService.createRequestContext({
     operation: "feishu.readDocument",
-    tenantId: "feishu-service"
+    tenantId: "feishu_service"
   });
   if (input.documentType === "wiki" && !input.wikiSpaceId) {
     throw new McpError(
@@ -11270,7 +11696,7 @@ async function batchReadLogic(input, appContext, _sdkContext) {
   });
   const context = requestContextService.createRequestContext({
     operation: "feishu.batchReadDocuments",
-    tenantId: "feishu-service"
+    tenantId: "feishu_service"
   });
   const feishuService = container.resolve(
     FeishuServiceToken
@@ -11413,7 +11839,7 @@ async function recursiveReadLogic(input, appContext, _sdkContext) {
   });
   const context = requestContextService.createRequestContext({
     operation: "feishu.readWikiRecursive",
-    tenantId: "feishu-service"
+    tenantId: "feishu_service"
   });
   const feishuService = container.resolve(
     FeishuServiceToken
@@ -11502,6 +11928,136 @@ var feishuReadWikiRecursiveTool = {
   logic: withToolAuth(["tool:feishu:read"], recursiveReadLogic),
   responseFormatter: responseFormatter14
 };
+var TOOL_NAME15 = "feishu_read_bitable";
+var TOOL_TITLE15 = "\u8BFB\u53D6\u98DE\u4E66\u591A\u7EF4\u8868\u683C";
+var TOOL_DESCRIPTION15 = `\u8BFB\u53D6\u98DE\u4E66\u591A\u7EF4\u8868\u683C\uFF08Bitable\uFF09\uFF0C\u5E76\u8F6C\u6362\u4E3A Markdown \u683C\u5F0F\u3002
+
+\u591A\u7EF4\u8868\u683C\u662F\u98DE\u4E66\u7684\u4E00\u79CD\u6570\u636E\u7BA1\u7406\u5DE5\u5177\uFF0C\u7C7B\u4F3C\u4E8E\u7535\u5B50\u8868\u683C\uFF0C\u4F46\u529F\u80FD\u66F4\u5F3A\u5927\u3002
+
+\u529F\u80FD\u7279\u6027\uFF1A
+- \u8BFB\u53D6\u591A\u7EF4\u8868\u683C\u7684\u6240\u6709\u6570\u636E\u8868\uFF08Sheet\uFF09
+- \u81EA\u52A8\u8F6C\u6362\u4E3A Markdown \u8868\u683C\u683C\u5F0F
+- \u652F\u6301\u5206\u9875\u8BFB\u53D6\u5927\u91CF\u6570\u636E
+- \u5904\u7406\u591A\u79CD\u5B57\u6BB5\u7C7B\u578B\uFF08\u6587\u672C\u3001\u6570\u5B57\u3001\u65E5\u671F\u3001\u94FE\u63A5\u7B49\uFF09
+
+**\u6CE8\u610F\u4E8B\u9879\uFF1A**
+- \u9700\u8981\u5148\u5B8C\u6210\u98DE\u4E66 OAuth \u6388\u6743
+- \u9700\u8981\u5E94\u7528\u5177\u6709 bitable:bitable \u6743\u9650
+- \u591A\u7EF4\u8868\u683C token \u53EF\u4EE5\u4ECE\u6587\u6863 URL \u4E2D\u83B7\u53D6
+`.trim();
+var TOOL_ANNOTATIONS15 = {
+  readOnlyHint: true,
+  destructiveHint: false,
+  idempotentHint: true,
+  openWorldHint: true
+};
+var InputSchema15 = z.object({
+  bitableToken: z.string().min(1).describe("\u591A\u7EF4\u8868\u683C token\u3002\u53EF\u4EE5\u4ECE\u591A\u7EF4\u8868\u683C URL \u4E2D\u83B7\u53D6\u3002"),
+  outputFormat: z.enum(["markdown", "json"]).default("markdown").describe("\u8F93\u51FA\u683C\u5F0F\uFF1Amarkdown\uFF08Markdown \u8868\u683C\uFF09\u6216 json\uFF08JSON \u6570\u636E\uFF09\u3002"),
+  appId: z.string().optional().describe("\u98DE\u4E66\u5E94\u7528 ID\u3002\u5982\u679C\u4E0D\u63D0\u4F9B\uFF0C\u5C06\u4F7F\u7528\u9ED8\u8BA4\u914D\u7F6E\u7684\u5E94\u7528\u3002")
+}).describe("\u8BFB\u53D6\u98DE\u4E66\u591A\u7EF4\u8868\u683C\u7684\u53C2\u6570\u3002");
+var OutputSchema15 = z.object({
+  success: z.boolean().describe("\u8BFB\u53D6\u662F\u5426\u6210\u529F\u3002"),
+  bitableToken: z.string().describe("\u591A\u7EF4\u8868\u683C token\u3002"),
+  name: z.string().optional().describe("\u591A\u7EF4\u8868\u683C\u540D\u79F0\u3002"),
+  content: z.string().optional().describe("Markdown \u5185\u5BB9\uFF08\u6240\u6709\u8868\u683C\uFF09\u3002"),
+  tables: z.array(
+    z.object({
+      tableId: z.string().describe("\u6570\u636E\u8868 ID\u3002"),
+      name: z.string().describe("\u6570\u636E\u8868\u540D\u79F0\u3002"),
+      markdown: z.string().optional().describe("Markdown \u8868\u683C\u5185\u5BB9\u3002"),
+      records: z.array(
+        z.object({
+          recordId: z.string().describe("\u8BB0\u5F55 ID\u3002"),
+          fields: z.record(z.string(), z.unknown()).describe("\u5B57\u6BB5\u6570\u636E\u3002")
+        })
+      ).optional().describe("\u8BB0\u5F55\u5217\u8868\u3002")
+    })
+  ).optional().describe("\u6570\u636E\u8868\u5217\u8868\u3002"),
+  error: z.string().optional().describe("\u9519\u8BEF\u4FE1\u606F\u3002")
+}).describe("\u591A\u7EF4\u8868\u683C\u8BFB\u53D6\u7ED3\u679C\u3002");
+async function readBitableLogic(input, appContext, _sdkContext) {
+  logger.debug("\u5F00\u59CB\u8BFB\u53D6\u98DE\u4E66\u591A\u7EF4\u8868\u683C", {
+    ...appContext,
+    bitableToken: input.bitableToken,
+    outputFormat: input.outputFormat
+  });
+  const context = requestContextService.createRequestContext({
+    operation: "feishu.readBitable",
+    tenantId: "feishu_service"
+  });
+  const feishuService = container.resolve(
+    FeishuServiceToken
+  );
+  const options = {
+    outputFormat: input.outputFormat
+  };
+  if (input.appId) options.appId = input.appId;
+  const result = await feishuService.readBitable(
+    input.bitableToken,
+    options,
+    context
+  );
+  if (result.success) {
+    logger.info("\u98DE\u4E66\u591A\u7EF4\u8868\u683C\u8BFB\u53D6\u6210\u529F", {
+      ...context,
+      bitableToken: result.bitableToken,
+      name: result.name,
+      tableCount: result.tables?.length
+    });
+  } else {
+    logger.warning("\u98DE\u4E66\u591A\u7EF4\u8868\u683C\u8BFB\u53D6\u5931\u8D25", {
+      ...context,
+      error: result.error
+    });
+  }
+  return {
+    success: result.success,
+    bitableToken: result.bitableToken,
+    name: result.name,
+    content: result.content,
+    tables: result.tables,
+    error: result.error
+  };
+}
+function responseFormatter15(result) {
+  const md = markdown();
+  if (result.success) {
+    md.h2("\u2705 \u591A\u7EF4\u8868\u683C\u8BFB\u53D6\u6210\u529F").keyValue("\u8868\u683C\u540D\u79F0", result.name ?? "\u672A\u77E5").keyValue("\u591A\u7EF4\u8868\u683C Token", result.bitableToken).keyValue("\u6570\u636E\u8868\u6570\u91CF", String(result.tables?.length ?? 0));
+    if (result.tables && result.tables.length > 0) {
+      md.blankLine().h3("\u{1F4CA} \u6570\u636E\u8868\u5217\u8868");
+      for (const table of result.tables) {
+        md.text(`- **${table.name}** (${table.records?.length ?? 0} \u6761\u8BB0\u5F55)`);
+      }
+    }
+    if (result.content) {
+      md.blankLine().h3("\u{1F4DD} \u8868\u683C\u5185\u5BB9").blankLine().text(
+        result.content.length > 2e3 ? result.content.substring(0, 2e3) + "\n\n... (\u5185\u5BB9\u8FC7\u957F\uFF0C\u5DF2\u622A\u65AD)" : result.content
+      );
+    }
+  } else {
+    md.h2("\u274C \u591A\u7EF4\u8868\u683C\u8BFB\u53D6\u5931\u8D25").paragraph(result.error ?? "\u672A\u77E5\u9519\u8BEF");
+    md.blankLine().blockquote(
+      "\u8BF7\u68C0\u67E5\u9519\u8BEF\u4FE1\u606F\uFF0C\u786E\u4FDD\u5DF2\u5B8C\u6210 OAuth \u8BA4\u8BC1\u4E14\u6709\u6743\u9650\u8BBF\u95EE\u8BE5\u591A\u7EF4\u8868\u683C\u3002"
+    );
+  }
+  return [
+    {
+      type: "text",
+      text: md.build()
+    }
+  ];
+}
+var feishuReadBitableTool = {
+  name: TOOL_NAME15,
+  title: TOOL_TITLE15,
+  description: TOOL_DESCRIPTION15,
+  inputSchema: InputSchema15,
+  outputSchema: OutputSchema15,
+  annotations: TOOL_ANNOTATIONS15,
+  logic: withToolAuth(["tool:feishu:read"], readBitableLogic),
+  responseFormatter: responseFormatter15
+};
 
 // src/mcp-server/tools/definitions/index.ts
 var allToolDefinitions = [
@@ -11523,6 +12079,8 @@ var allToolDefinitions = [
   // 飞书文档：批量读取
   feishuReadWikiRecursiveTool,
   // 飞书文档：递归读取知识库
+  feishuReadBitableTool,
+  // 飞书文档：读取多维表格
   // 飞书管理工具
   feishuListFoldersTool,
   // 飞书管理：列出文件夹
@@ -11547,7 +12105,7 @@ function createMcpToolHandler({
   inputSchema: _inputSchema,
   // Captured for type inference, not used at runtime
   logic,
-  responseFormatter: responseFormatter15 = defaultResponseFormatter2
+  responseFormatter: responseFormatter16 = defaultResponseFormatter2
 }) {
   return async (input, callContext) => {
     const sdkContext = callContext;
@@ -11569,7 +12127,7 @@ function createMcpToolHandler({
       );
       return {
         structuredContent: result,
-        content: responseFormatter15(result)
+        content: responseFormatter16(result)
       };
     } catch (error) {
       const mcpError = ErrorHandler.handleError(error, {
@@ -12021,9 +12579,9 @@ ToolRegistry = __decorateClass([
   injectable(),
   __decorateParam(0, injectAll(ToolDefinitions, { isOptional: true }))
 ], ToolRegistry);
-var registerTools = (container25) => {
+var registerTools = (container26) => {
   for (const tool of allToolDefinitions) {
-    container25.register(ToolDefinitions, { useValue: tool });
+    container26.register(ToolDefinitions, { useValue: tool });
   }
 };
 
@@ -12084,33 +12642,33 @@ async function createMcpServerInstance() {
 globalThis.crypto?.webcrypto ?? // Node.js [18-16] REPL
 globalThis.crypto ?? // Node.js >18
 import('crypto').then((m) => m.webcrypto);
-z17.object({
-  client_id: z17.string(),
-  redirect_uri: z17.string().optional().refine((value) => value === void 0 || URL.canParse(value), { message: "redirect_uri must be a valid URL" })
+z18.object({
+  client_id: z18.string(),
+  redirect_uri: z18.string().optional().refine((value) => value === void 0 || URL.canParse(value), { message: "redirect_uri must be a valid URL" })
 });
-z17.object({
-  response_type: z17.literal("code"),
-  code_challenge: z17.string(),
-  code_challenge_method: z17.literal("S256"),
-  scope: z17.string().optional(),
-  state: z17.string().optional(),
-  resource: z17.url().optional()
+z18.object({
+  response_type: z18.literal("code"),
+  code_challenge: z18.string(),
+  code_challenge_method: z18.literal("S256"),
+  scope: z18.string().optional(),
+  state: z18.string().optional(),
+  resource: z18.url().optional()
 });
-z17.object({ grant_type: z17.string() });
-z17.object({
-  code: z17.string(),
-  code_verifier: z17.string(),
-  redirect_uri: z17.string().optional(),
-  resource: z17.url().optional()
+z18.object({ grant_type: z18.string() });
+z18.object({
+  code: z18.string(),
+  code_verifier: z18.string(),
+  redirect_uri: z18.string().optional(),
+  resource: z18.url().optional()
 });
-z17.object({
-  refresh_token: z17.string(),
-  scope: z17.string().optional(),
-  resource: z17.url().optional()
+z18.object({
+  refresh_token: z18.string(),
+  scope: z18.string().optional(),
+  resource: z18.url().optional()
 });
-z17.object({
-  client_id: z17.string(),
-  client_secret: z17.string().optional()
+z18.object({
+  client_id: z18.string(),
+  client_secret: z18.string().optional()
 });
 var isOldBunVersion = () => {
   const version = typeof Bun !== "undefined" ? Bun.version : void 0;