feishu-mcp 0.0.19 → 0.1.1

package/dist/mcp/tools/feishuTools.js

@@ -196,7 +196,7 @@ export function registerFeishuTools(server, feishuService) {
         }
     });
     // 添加获取画板内容工具
-    server.tool('get_feishu_whiteboard_content', 'Retrieves the content and structure of a Feishu whiteboard. This tool fetches all nodes (elements) from a whiteboard, including shapes, text, mind maps, and other graphical elements. Use this to analyze whiteboard content, extract information, or understand the structure of collaborative diagrams. The whiteboard ID can be obtained from the board.token field when getting document blocks with block_type: 43.', {
+    server.tool('get_feishu_whiteboard_content', 'Retrieves the content and structure of a Feishu whiteboard. Use this to analyze whiteboard content, extract information, or understand the structure of collaborative diagrams. The whiteboard ID can be obtained from the board.token field when getting document blocks with block_type: 43.', {
         whiteboardId: WhiteboardIdSchema,
     }, async ({ whiteboardId }) => {
         try {
@@ -207,7 +207,28 @@ export function registerFeishuTools(server, feishuService) {
             }
             Logger.info(`开始获取飞书画板内容，画板ID: ${whiteboardId}`);
             const whiteboardContent = await feishuService.getWhiteboardContent(whiteboardId);
-            Logger.info(`飞书画板内容获取成功，节点数量: ${whiteboardContent.nodes?.length || 0}`);
+            const nodeCount = whiteboardContent.nodes?.length || 0;
+            Logger.info(`飞书画板内容获取成功，节点数量: ${nodeCount}`);
+            // 检查节点数量是否超过100
+            if (nodeCount > 200) {
+                Logger.info(`画板节点数量过多 (${nodeCount} > 200)，返回缩略图`);
+                try {
+                    const thumbnailBuffer = await feishuService.getWhiteboardThumbnail(whiteboardId);
+                    const thumbnailBase64 = thumbnailBuffer.toString('base64');
+                    return {
+                        content: [
+                            {
+                                type: 'image',
+                                data: thumbnailBase64,
+                                mimeType: 'image/png'
+                            }
+                        ],
+                    };
+                }
+                catch (thumbnailError) {
+                    Logger.warn(`获取画板缩略图失败，返回基本信息: ${thumbnailError}`);
+                }
+            }
             return {
                 content: [{ type: 'text', text: JSON.stringify(whiteboardContent, null, 2) }],
             };

package/dist/server.js

@@ -1,5 +1,8 @@
 import express from 'express';
 import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { isInitializeRequest } from '@modelcontextprotocol/sdk/types.js';
+import { randomUUID } from 'node:crypto';
 import { Logger } from './utils/logger.js';
 import { SSEConnectionManager } from './manager/sseConnectionManager.js';
 import { FeishuMcp } from './mcp/feishuMcp.js';
@@ -27,6 +30,118 @@ export class FeishuMcpServer {
     }
     async startHttpServer(port) {
         const app = express();
+        const transports = {};
+        // Parse JSON requests for the Streamable HTTP endpoint only, will break SSE endpoint
+        app.use("/mcp", express.json());
+        app.post('/mcp', async (req, res) => {
+            try {
+                Logger.log("Received StreamableHTTP request", {
+                    method: req.method,
+                    url: req.url,
+                    headers: req.headers,
+                    body: req.body,
+                    query: req.query,
+                    params: req.params
+                });
+                // Check for existing session ID
+                const sessionId = req.headers['mcp-session-id'];
+                let transport;
+                if (sessionId && transports[sessionId]) {
+                    // Reuse existing transport
+                    Logger.log("Reusing existing StreamableHTTP transport for sessionId", sessionId);
+                    transport = transports[sessionId];
+                }
+                else if (!sessionId && isInitializeRequest(req.body)) {
+                    // New initialization request
+                    transport = new StreamableHTTPServerTransport({
+                        sessionIdGenerator: () => randomUUID(),
+                        onsessioninitialized: (sessionId) => {
+                            // Store the transport by session ID
+                            Logger.log(`[StreamableHTTP connection] ${sessionId}`);
+                            transports[sessionId] = transport;
+                        }
+                    });
+                    // Clean up transport and server when closed
+                    transport.onclose = () => {
+                        if (transport.sessionId) {
+                            Logger.log(`[StreamableHTTP delete] ${transports[transport.sessionId]}`);
+                            delete transports[transport.sessionId];
+                        }
+                    };
+                    // Create and connect server instance
+                    const server = new FeishuMcp();
+                    await server.connect(transport);
+                }
+                else {
+                    // Invalid request
+                    res.status(400).json({
+                        jsonrpc: '2.0',
+                        error: {
+                            code: -32000,
+                            message: 'Bad Request: No valid session ID provided',
+                        },
+                        id: null,
+                    });
+                    return;
+                }
+                // Handle the request
+                await transport.handleRequest(req, res, req.body);
+            }
+            catch (error) {
+                console.error('Error handling MCP request:', error);
+                if (!res.headersSent) {
+                    res.status(500).json({
+                        jsonrpc: '2.0',
+                        error: {
+                            code: -32603,
+                            message: 'Internal server error',
+                        },
+                        id: null,
+                    });
+                }
+            }
+        });
+        // Handle GET requests for server-to-client notifications via Streamable HTTP
+        app.get('/mcp', async (req, res) => {
+            try {
+                Logger.log("Received StreamableHTTP request get");
+                const sessionId = req.headers['mcp-session-id'];
+                if (!sessionId || !transports[sessionId]) {
+                    res.status(400).send('Invalid or missing session ID');
+                    return;
+                }
+                const transport = transports[sessionId];
+                await transport.handleRequest(req, res);
+            }
+            catch (error) {
+                console.error('Error handling GET request:', error);
+                if (!res.headersSent) {
+                    res.status(500).send('Internal server error');
+                }
+            }
+        });
+        // Handle DELETE requests for session termination
+        app.delete('/mcp', async (req, res) => {
+            try {
+                const sessionId = req.headers['mcp-session-id'];
+                if (!sessionId || !transports[sessionId]) {
+                    res.status(400).send('Invalid or missing session ID');
+                    return;
+                }
+                const transport = transports[sessionId];
+                await transport.handleRequest(req, res);
+                // Clean up resources after session termination
+                if (transport.sessionId) {
+                    delete transports[transport.sessionId];
+                }
+            }
+            catch (error) {
+                console.error('Error handling DELETE request:', error);
+                if (!res.headersSent) {
+                    res.status(500).send('Internal server error');
+                }
+            }
+        });
         app.get('/sse', async (req, res) => {
             const sseTransport = new SSEServerTransport('/messages', res);
             const sessionId = sseTransport.sessionId;
@@ -82,10 +197,11 @@ export class FeishuMcpServer {
                 res.status(500).json({ code: 500, msg: e.message || '获取token失败' });
             }
         });
-        app.listen(port, () => {
+        app.listen(port, '0.0.0.0', () => {
             Logger.info(`HTTP server listening on port ${port}`);
             Logger.info(`SSE endpoint available at http://localhost:${port}/sse`);
             Logger.info(`Message endpoint available at http://localhost:${port}/messages`);
+            Logger.info(`StreamableHTTP endpoint available at http://localhost:${port}/mcp`);
         });
     }
 }

package/dist/services/blockFactory.js

@@ -9,6 +9,7 @@ export var BlockType;
     BlockType["HEADING"] = "heading";
     BlockType["LIST"] = "list";
     BlockType["IMAGE"] = "image";
+    BlockType["MERMAID"] = "mermaid";
 })(BlockType || (BlockType = {}));
 /**
  * 对齐方式枚举
@@ -75,6 +76,8 @@ export class BlockFactory {
                 return this.createListBlock(options);
             case BlockType.IMAGE:
                 return this.createImageBlock(options);
+            case BlockType.MERMAID:
+                return this.createMermaidBlock(options);
             default:
                 Logger.error(`不支持的块类型: ${type}`);
                 throw new Error(`不支持的块类型: ${type}`);
@@ -225,4 +228,22 @@ export class BlockFactory {
             }
         };
     }
+    /**
+     * 创建Mermaid
+     * @param options Mermaid块选项
+     * @returns Mermaid块内容对象
+     */
+    createMermaidBlock(options = {}) {
+        const { code } = options;
+        return {
+            block_type: 40,
+            add_ons: {
+                component_id: '',
+                component_type_id: 'blk_631fefbbae02400430b8f9f4',
+                record: JSON.stringify({
+                    data: code,
+                }),
+            },
+        };
+    }
 }

package/dist/services/feishuApiService.js

@@ -382,6 +382,35 @@ export class FeishuApiService extends BaseApiService {
         });
         return this.createDocumentBlock(documentId, parentBlockId, blockContent, index);
     }
+    /**
+     * 创建Mermaid块
+     * @param documentId 文档ID或URL
+     * @param parentBlockId 父块ID
+     * @param mermaidCode Mermaid代码
+     * @param index 插入位置索引
+     * @returns 创建结果
+     */
+    async createMermaidBlock(documentId, parentBlockId, mermaidCode, index = 0) {
+        const normalizedDocId = ParamUtils.processDocumentId(documentId);
+        const endpoint = `/docx/v1/documents/${normalizedDocId}/blocks/${parentBlockId}/children?document_revision_id=-1`;
+        const blockContent = {
+            block_type: 40,
+            add_ons: {
+                component_id: "",
+                component_type_id: "blk_631fefbbae02400430b8f9f4",
+                record: JSON.stringify({
+                    data: mermaidCode,
+                })
+            }
+        };
+        const payload = {
+            children: [blockContent],
+            index
+        };
+        Logger.info(`请求创建Mermaid块: ${JSON.stringify(payload).slice(0, 500)}...`);
+        const response = await this.post(endpoint, payload);
+        return response;
+    }
     /**
      * 删除文档中的块，支持批量删除
      * @param documentId 文档ID或URL
@@ -577,6 +606,14 @@ export class FeishuApiService extends BaseApiService {
                         };
                     }
                     break;
+                case BlockType.MERMAID:
+                    if ('mermaid' in options && options.mermaid) {
+                        const mermaidOptions = options.mermaid;
+                        blockConfig.options = {
+                            code: mermaidOptions.code,
+                        };
+                    }
+                    break;
                 default:
                     Logger.warn(`未知的块类型: ${blockType}，尝试作为标准类型处理`);
                     if ('text' in options) {
@@ -640,6 +677,13 @@ export class FeishuApiService extends BaseApiService {
                             height: imageOptions.height || 100
                         };
                     }
+                    else if ("mermaid" in options) {
+                        blockConfig.type = BlockType.MERMAID;
+                        const mermaidConfig = options.mermaid;
+                        blockConfig.options = {
+                            code: mermaidConfig.code,
+                        };
+                    }
                     break;
             }
             // 记录调试信息
@@ -955,15 +999,7 @@ export class FeishuApiService extends BaseApiService {
      */
     async getWhiteboardContent(whiteboardId) {
         try {
-            // 从URL中提取画板ID
-            let normalizedWhiteboardId = whiteboardId;
-            if (whiteboardId.includes('feishu.cn/board/')) {
-                // 从URL中提取画板ID
-                const matches = whiteboardId.match(/board\/([^\/\?]+)/);
-                if (matches) {
-                    normalizedWhiteboardId = matches[1];
-                }
-            }
+            const normalizedWhiteboardId = ParamUtils.processWhiteboardId(whiteboardId);
             const endpoint = `/board/v1/whiteboards/${normalizedWhiteboardId}/nodes`;
             Logger.info(`开始获取画板内容，画板ID: ${normalizedWhiteboardId}`);
             const response = await this.get(endpoint);
@@ -974,6 +1010,27 @@ export class FeishuApiService extends BaseApiService {
             this.handleApiError(error, '获取画板内容失败');
         }
     }
+    /**
+     * 获取画板缩略图
+     * @param whiteboardId 画板ID或URL
+     * @returns 画板缩略图的二进制数据
+     */
+    async getWhiteboardThumbnail(whiteboardId) {
+        try {
+            const normalizedWhiteboardId = ParamUtils.processWhiteboardId(whiteboardId);
+            const endpoint = `/board/v1/whiteboards/${normalizedWhiteboardId}/download_as_image`;
+            Logger.info(`开始获取画板缩略图，画板ID: ${normalizedWhiteboardId}`);
+            // 使用通用的request方法获取二进制响应
+            const response = await this.request(endpoint, 'GET', {}, true, {}, 'arraybuffer');
+            const thumbnailBuffer = Buffer.from(response);
+            Logger.info(`画板缩略图获取成功，大小: ${thumbnailBuffer.length} 字节`);
+            return thumbnailBuffer;
+        }
+        catch (error) {
+            this.handleApiError(error, '获取画板缩略图失败');
+            return Buffer.from([]); // 永远不会执行到这里
+        }
+    }
     /**
      * 从路径或URL获取图片的Base64编码
      * @param imagePathOrUrl 图片路径或URL

package/dist/types/feishuSchema.js

@@ -103,7 +103,7 @@ export const ListBlockSchema = z.object({
     align: AlignSchemaWithValidation,
 });
 // 块类型枚举 - 用于批量创建块工具
-export const BlockTypeEnum = z.string().describe("Block type (required). Supports: 'text', 'code', 'heading', 'list', 'image', as well as 'heading1' through 'heading9'. " +
+export const BlockTypeEnum = z.string().describe("Block type (required). Supports: 'text', 'code', 'heading', 'list', 'image','mermaid',as well as 'heading1' through 'heading9'. " +
     "For headings, we recommend using 'heading' with level property, but 'heading1'-'heading9' are also supported. " +
     "For images, use 'image' to create empty image blocks that can be filled later. " +
     "For text blocks, you can include both regular text and equation elements in the same block.");
@@ -116,6 +116,14 @@ export const ImageBlockSchema = z.object({
     width: ImageWidthSchema,
     height: ImageHeightSchema
 });
+// Mermaid代码参数定义
+export const MermaidCodeSchema = z.string().describe('Mermaid code (required). The complete Mermaid chart code, e.g. \'graph TD; A-->B;\'. ' +
+    'IMPORTANT: When node text contains special characters like parentheses (), brackets [], or arrows -->, ' +
+    'wrap the entire text in double quotes to prevent parsing errors. ' +
+    'Example: A["finish()/返回键"] instead of A[finish()/返回键].');
+export const MermaidBlockSchema = z.object({
+    code: MermaidCodeSchema,
+});
 // 块配置定义 - 用于批量创建块工具
 export const BlockConfigSchema = z.object({
     blockType: BlockTypeEnum,
@@ -125,6 +133,7 @@ export const BlockConfigSchema = z.object({
         z.object({ heading: HeadingBlockSchema }).describe("Heading block options. Used with both 'heading' and 'headingN' formats."),
         z.object({ list: ListBlockSchema }).describe("List block options. Used when blockType is 'list'."),
         z.object({ image: ImageBlockSchema }).describe("Image block options. Used when blockType is 'image'. Creates empty image blocks."),
+        z.object({ mermaid: MermaidBlockSchema }).describe("Mermaid block options.  Used when blockType is 'mermaid'."),
         z.record(z.any()).describe("Fallback for any other block options")
     ]).describe('Options for the specific block type. Provide the corresponding options object based on blockType.'),
 });

package/dist/utils/document.js

@@ -136,127 +136,127 @@ export function renderFeishuAuthResultHtml(data) {
         expiresIn = expiresIn - now;
     if (refreshExpiresIn && refreshExpiresIn > 1000000000)
         refreshExpiresIn = refreshExpiresIn - now;
-    const tokenBlock = data && !isError ? `
-    <div class="card">
-      <h3>Token 信息</h3>
-      <ul class="kv-list">
-        <li><b>token_type:</b> <span>${data.token_type || ''}</span></li>
-        <li><b>access_token:</b> <span class="foldable" onclick="toggleFold(this)">点击展开/收起</span><pre class="fold scrollable">${data.access_token || ''}</pre></li>
-        <li><b>expires_in:</b> <span>${formatExpire(expiresIn)}</span></li>
-        <li><b>refresh_token:</b> <span class="foldable" onclick="toggleFold(this)">点击展开/收起</span><pre class="fold scrollable">${data.refresh_token || ''}</pre></li>
-        <li><b>refresh_token_expires_in:</b> <span>${formatExpire(refreshExpiresIn)}</span></li>
-        <li><b>scope:</b> <pre class="scope">${(data.scope || '').replace(/ /g, '\n')}</pre></li>
-      </ul>
-      <div class="success-action">
-        <span class="success-msg">授权成功，继续完成任务</span>
-        <button class="copy-btn" onclick="copySuccessMsg(this)">点击复制到粘贴板</button>
-      </div>
-    </div>
+    const tokenBlock = data && !isError ? `
+    <div class="card">
+      <h3>Token 信息</h3>
+      <ul class="kv-list">
+        <li><b>token_type:</b> <span>${data.token_type || ''}</span></li>
+        <li><b>access_token:</b> <span class="foldable" onclick="toggleFold(this)">点击展开/收起</span><pre class="fold scrollable">${data.access_token || ''}</pre></li>
+        <li><b>expires_in:</b> <span>${formatExpire(expiresIn)}</span></li>
+        <li><b>refresh_token:</b> <span class="foldable" onclick="toggleFold(this)">点击展开/收起</span><pre class="fold scrollable">${data.refresh_token || ''}</pre></li>
+        <li><b>refresh_token_expires_in:</b> <span>${formatExpire(refreshExpiresIn)}</span></li>
+        <li><b>scope:</b> <pre class="scope">${(data.scope || '').replace(/ /g, '\n')}</pre></li>
+      </ul>
+      <div class="success-action">
+        <span class="success-msg">授权成功，继续完成任务</span>
+        <button class="copy-btn" onclick="copySuccessMsg(this)">点击复制到粘贴板</button>
+      </div>
+    </div>
   ` : '';
     let userBlock = '';
     const userInfo = data && data.userInfo && data.userInfo.data;
     if (userInfo) {
-        userBlock = `
-      <div class="card user-card">
-        <div class="avatar-wrap">
-          <img src="${userInfo.avatar_big || userInfo.avatar_thumb || userInfo.avatar_url || ''}" class="avatar" />
-        </div>
-        <div class="user-info">
-          <div class="user-name">${userInfo.name || ''}</div>
-          <div class="user-en">${userInfo.en_name || ''}</div>
-        </div>
-      </div>
+        userBlock = `
+      <div class="card user-card">
+        <div class="avatar-wrap">
+          <img src="${userInfo.avatar_big || userInfo.avatar_thumb || userInfo.avatar_url || ''}" class="avatar" />
+        </div>
+        <div class="user-info">
+          <div class="user-name">${userInfo.name || ''}</div>
+          <div class="user-en">${userInfo.en_name || ''}</div>
+        </div>
+      </div>
     `;
     }
-    const errorBlock = isError ? `
-    <div class="card error-card">
-      <h3>授权失败</h3>
-      <div class="error-msg">${escapeHtml(data.error || '')}</div>
-      <div class="error-code">错误码: ${data.code || ''}</div>
-    </div>
+    const errorBlock = isError ? `
+    <div class="card error-card">
+      <h3>授权失败</h3>
+      <div class="error-msg">${escapeHtml(data.error || '')}</div>
+      <div class="error-code">错误码: ${data.code || ''}</div>
+    </div>
   ` : '';
-    return `
-    <html>
-      <head>
-        <title>飞书授权结果</title>
-        <meta charset="utf-8"/>
-        <meta name="viewport" content="width=device-width,initial-scale=1"/>
-        <style>
-          body { background: #f7f8fa; font-family: 'Segoe UI', Arial, sans-serif; margin:0; padding:0; }
-          .container { max-width: 600px; margin: 40px auto; padding: 16px; }
-          .card { background: #fff; border-radius: 12px; box-shadow: 0 2px 12px #0001; margin-bottom: 24px; padding: 24px 20px; }
-          .user-card { display: flex; align-items: center; gap: 24px; }
-          .avatar-wrap { flex-shrink: 0; }
-          .avatar { width: 96px; height: 96px; border-radius: 50%; box-shadow: 0 2px 8px #0002; display: block; margin: 0 auto; }
-          .user-info { flex: 1; }
-          .user-name { font-size: 1.5em; font-weight: bold; margin-bottom: 4px; }
-          .user-en { color: #888; margin-bottom: 10px; }
-          .kv-list { list-style: none; padding: 0; margin: 0; }
-          .kv-list li { margin-bottom: 6px; word-break: break-all; }
-          .kv-list b { color: #1976d2; }
-          .scope { background: #f0f4f8; border-radius: 4px; padding: 6px; font-size: 0.95em; white-space: pre-line; }
-          .foldable { color: #1976d2; cursor: pointer; text-decoration: underline; margin-left: 8px; }
-          .fold { display: none; background: #f6f6f6; border-radius: 4px; padding: 6px; margin: 4px 0; font-size: 0.92em; max-width: 100%; overflow-x: auto; word-break: break-all; }
-          .scrollable { max-width: 100%; overflow-x: auto; font-family: 'Fira Mono', 'Consolas', 'Menlo', monospace; font-size: 0.93em; }
-          .success-action { margin-top: 18px; display: flex; align-items: center; gap: 16px; }
-          .success-msg { color: #388e3c; font-weight: bold; }
-          .copy-btn { background: #1976d2; color: #fff; border: none; border-radius: 4px; padding: 6px 16px; font-size: 1em; cursor: pointer; transition: background 0.2s; }
-          .copy-btn:hover { background: #125ea2; }
-          .error-card { border-left: 6px solid #e53935; background: #fff0f0; color: #b71c1c; }
-          .error-msg { font-size: 1.1em; margin-bottom: 8px; }
-          .error-code { color: #b71c1c; font-size: 0.95em; }
-          .raw-block { margin-top: 24px; }
-          .raw-toggle { color: #1976d2; cursor: pointer; text-decoration: underline; margin-bottom: 8px; display: inline-block; }
-          .raw-pre { display: none; background: #23272e; color: #fff; border-radius: 6px; padding: 12px; font-size: 0.95em; overflow-x: auto; max-width: 100%; }
-          @media (max-width: 700px) {
-            .container { max-width: 98vw; padding: 4vw; }
-            .card { padding: 4vw 3vw; }
-            .avatar { width: 64px; height: 64px; }
-          }
-        </style>
-        <script>
-          function toggleFold(el) {
-            var pre = el.nextElementSibling;
-            if (pre.style.display === 'block') {
-              pre.style.display = 'none';
-            } else {
-              pre.style.display = 'block';
-            }
-          }
-          function toggleRaw() {
-            var pre = document.getElementById('raw-pre');
-            if (pre.style.display === 'block') {
-              pre.style.display = 'none';
-            } else {
-              pre.style.display = 'block';
-            }
-          }
-          function copySuccessMsg(btn) {
-            var text = '授权成功，继续完成任务';
-            navigator.clipboard.writeText(text).then(function() {
-              btn.innerText = '已复制';
-              btn.disabled = true;
-              setTimeout(function() {
-                btn.innerText = '点击复制到粘贴板';
-                btn.disabled = false;
-              }, 2000);
-            });
-          }
-        </script>
-      </head>
-      <body>
-        <div class="container">
-          <h2 style="margin-bottom:24px;">飞书授权结果</h2>
-          ${errorBlock}
-          ${tokenBlock}
-          ${userBlock}
-          <div class="card raw-block">
-            <span class="raw-toggle" onclick="toggleRaw()">点击展开/收起原始数据</span>
-            <pre id="raw-pre" class="raw-pre">${escapeHtml(JSON.stringify(data, null, 2))}</pre>
-          </div>
-        </div>
-      </body>
-    </html>
+    return `
+    <html>
+      <head>
+        <title>飞书授权结果</title>
+        <meta charset="utf-8"/>
+        <meta name="viewport" content="width=device-width,initial-scale=1"/>
+        <style>
+          body { background: #f7f8fa; font-family: 'Segoe UI', Arial, sans-serif; margin:0; padding:0; }
+          .container { max-width: 600px; margin: 40px auto; padding: 16px; }
+          .card { background: #fff; border-radius: 12px; box-shadow: 0 2px 12px #0001; margin-bottom: 24px; padding: 24px 20px; }
+          .user-card { display: flex; align-items: center; gap: 24px; }
+          .avatar-wrap { flex-shrink: 0; }
+          .avatar { width: 96px; height: 96px; border-radius: 50%; box-shadow: 0 2px 8px #0002; display: block; margin: 0 auto; }
+          .user-info { flex: 1; }
+          .user-name { font-size: 1.5em; font-weight: bold; margin-bottom: 4px; }
+          .user-en { color: #888; margin-bottom: 10px; }
+          .kv-list { list-style: none; padding: 0; margin: 0; }
+          .kv-list li { margin-bottom: 6px; word-break: break-all; }
+          .kv-list b { color: #1976d2; }
+          .scope { background: #f0f4f8; border-radius: 4px; padding: 6px; font-size: 0.95em; white-space: pre-line; }
+          .foldable { color: #1976d2; cursor: pointer; text-decoration: underline; margin-left: 8px; }
+          .fold { display: none; background: #f6f6f6; border-radius: 4px; padding: 6px; margin: 4px 0; font-size: 0.92em; max-width: 100%; overflow-x: auto; word-break: break-all; }
+          .scrollable { max-width: 100%; overflow-x: auto; font-family: 'Fira Mono', 'Consolas', 'Menlo', monospace; font-size: 0.93em; }
+          .success-action { margin-top: 18px; display: flex; align-items: center; gap: 16px; }
+          .success-msg { color: #388e3c; font-weight: bold; }
+          .copy-btn { background: #1976d2; color: #fff; border: none; border-radius: 4px; padding: 6px 16px; font-size: 1em; cursor: pointer; transition: background 0.2s; }
+          .copy-btn:hover { background: #125ea2; }
+          .error-card { border-left: 6px solid #e53935; background: #fff0f0; color: #b71c1c; }
+          .error-msg { font-size: 1.1em; margin-bottom: 8px; }
+          .error-code { color: #b71c1c; font-size: 0.95em; }
+          .raw-block { margin-top: 24px; }
+          .raw-toggle { color: #1976d2; cursor: pointer; text-decoration: underline; margin-bottom: 8px; display: inline-block; }
+          .raw-pre { display: none; background: #23272e; color: #fff; border-radius: 6px; padding: 12px; font-size: 0.95em; overflow-x: auto; max-width: 100%; }
+          @media (max-width: 700px) {
+            .container { max-width: 98vw; padding: 4vw; }
+            .card { padding: 4vw 3vw; }
+            .avatar { width: 64px; height: 64px; }
+          }
+        </style>
+        <script>
+          function toggleFold(el) {
+            var pre = el.nextElementSibling;
+            if (pre.style.display === 'block') {
+              pre.style.display = 'none';
+            } else {
+              pre.style.display = 'block';
+            }
+          }
+          function toggleRaw() {
+            var pre = document.getElementById('raw-pre');
+            if (pre.style.display === 'block') {
+              pre.style.display = 'none';
+            } else {
+              pre.style.display = 'block';
+            }
+          }
+          function copySuccessMsg(btn) {
+            var text = '授权成功，继续完成任务';
+            navigator.clipboard.writeText(text).then(function() {
+              btn.innerText = '已复制';
+              btn.disabled = true;
+              setTimeout(function() {
+                btn.innerText = '点击复制到粘贴板';
+                btn.disabled = false;
+              }, 2000);
+            });
+          }
+        </script>
+      </head>
+      <body>
+        <div class="container">
+          <h2 style="margin-bottom:24px;">飞书授权结果</h2>
+          ${errorBlock}
+          ${tokenBlock}
+          ${userBlock}
+          <div class="card raw-block">
+            <span class="raw-toggle" onclick="toggleRaw()">点击展开/收起原始数据</span>
+            <pre id="raw-pre" class="raw-pre">${escapeHtml(JSON.stringify(data, null, 2))}</pre>
+          </div>
+        </div>
+      </body>
+    </html>
   `;
 }
 function escapeHtml(str) {

package/dist/utils/paramUtils.js

@@ -159,6 +159,44 @@ export class ParamUtils {
         // 限制在1-9范围内
         return Math.max(1, Math.min(9, level));
     }
+    /**
+     * 处理画板ID参数
+     * 验证并规范化画板ID，支持从URL中提取
+     *
+     * @param whiteboardId 画板ID或URL
+     * @returns 规范化的画板ID
+     * @throws 如果画板ID无效则抛出错误
+     */
+    static processWhiteboardId(whiteboardId) {
+        if (!whiteboardId) {
+            throw new ParamValidationError('whiteboardId', '画板ID不能为空');
+        }
+        try {
+            // 从URL中提取画板ID
+            let normalizedWhiteboardId = whiteboardId;
+            if (whiteboardId.includes('feishu.cn/board/')) {
+                // 从URL中提取画板ID
+                const matches = whiteboardId.match(/board\/([^\/\?]+)/);
+                if (matches) {
+                    normalizedWhiteboardId = matches[1];
+                }
+                else {
+                    throw new ParamValidationError('whiteboardId', '无法从URL中提取画板ID');
+                }
+            }
+            // 验证画板ID格式（基本格式检查）
+            if (!/^[a-zA-Z0-9_-]{5,}$/.test(normalizedWhiteboardId)) {
+                throw new ParamValidationError('whiteboardId', '画板ID格式无效');
+            }
+            return normalizedWhiteboardId;
+        }
+        catch (error) {
+            if (error instanceof ParamValidationError) {
+                throw error;
+            }
+            throw new ParamValidationError('whiteboardId', formatErrorMessage(error));
+        }
+    }
     /**
      * 批量处理通用参数
      * 验证并规范化常用参数集