evolclaw 2.2.0 → 2.4.0

package/dist/channels/feishu.js

@@ -2,7 +2,7 @@ import * as lark from '@larksuiteoapi/node-sdk';
 import fs from 'fs';
 import path from 'path';
 import imageType from 'image-type';
-import { ensureDir } from '../config.js';
+import { sanitizeFileName, saveToUploads, validateImage } from '../utils/media-cache.js';
 import { logger } from '../utils/logger.js';
 import { hasRichContent, renderAllRichContent, checkDependencies } from '../utils/rich-content-renderer.js';
 export class FeishuChannel {
@@ -16,11 +16,12 @@ export class FeishuChannel {
     seenThreads = new Set(); // 已见的 thread_id，用于判断话题创建消息
     userNameCache = new Map(); // userId -> userName
     recallHandler;
+    interactionCallback;
     connected = false;
     enableRichContent;
     constructor(config) {
         this.config = config;
-        this.enableRichContent = config.enableRichContent ?? true; // 默认启用
+        this.enableRichContent = config.enableRichContent ?? false; // 默认关闭
     }
     /**
      * 预填充已知的 thread_id（重启后从数据库恢复，避免误判话题创建）
@@ -112,7 +113,7 @@ export class FeishuChannel {
                                 const quotedContent = res.data.items[0].body.content;
                                 if (quotedMsgType === 'text') {
                                     const parsed = JSON.parse(quotedContent);
-                                    quotedText = `> ${parsed.text}\n\n`;
+                                    quotedText = `> 以下是引用的原消息\n> ================\n> ${parsed.text}\n> ================\n\n`;
                                 }
                                 else if (quotedMsgType === 'post') {
                                     const parsed = JSON.parse(quotedContent);
@@ -128,7 +129,7 @@ export class FeishuChannel {
                                             text += '\n';
                                         }
                                     }
-                                    quotedText = `> ${text.trim()}\n\n`;
+                                    quotedText = `> 以下是引用的原消息\n> ================\n> ${text.trim()}\n> ================\n\n`;
                                 }
                                 else if (quotedMsgType === 'image') {
                                     const parsed = JSON.parse(quotedContent);
@@ -139,10 +140,10 @@ export class FeishuChannel {
                                     const imageData = await this.downloadAndSaveImage(imageKey, msg.chat_id, msg.parent_id, projectPath);
                                     if (imageData) {
                                         quotedImages.push(imageData);
-                                        quotedText = `> [引用的图片]\n\n`;
+                                        quotedText = `> 以下是引用的原消息\n> ================\n> [引用的图片]\n> ================\n\n`;
                                     }
                                     else {
-                                        quotedText = `> [图片消息]\n\n`;
+                                        quotedText = `> 以下是引用的原消息\n> ================\n> [图片消息]\n> ================\n\n`;
                                     }
                                 }
                                 else if (quotedMsgType === 'file') {
@@ -154,14 +155,14 @@ export class FeishuChannel {
                                         : process.cwd();
                                     const quotedFilePath = await this.downloadFile(quotedFileKey, quotedFileName, msg.parent_id, projectPath);
                                     if (quotedFilePath) {
-                                        quotedText = `> [引用的文件：${quotedFileName}]\n> 文件已保存到：${quotedFilePath}\n\n`;
+                                        quotedText = `> 以下是引用的原消息\n> ================\n> [引用的文件：${quotedFileName}]\n> 文件已保存到：${quotedFilePath}\n> ================\n\n`;
                                     }
                                     else {
-                                        quotedText = `> [文件消息]\n\n`;
+                                        quotedText = `> 以下是引用的原消息\n> ================\n> [文件消息]\n> ================\n\n`;
                                     }
                                 }
                                 else {
-                                    quotedText = `> [${quotedMsgType}消息]\n\n`;
+                                    quotedText = `> 以下是引用的原消息\n> ================\n> [${quotedMsgType}消息]\n> ================\n\n`;
                                 }
                             }
                             catch (err) {
@@ -267,7 +268,46 @@ export class FeishuChannel {
                     }
                 },
                 'im.message.message_read_v1': async () => { },
-                'im.message.reaction.created_v1': async () => { }
+                'im.message.reaction.created_v1': async () => { },
+                'card.action.trigger': async (data) => {
+                    try {
+                        const action = data?.action;
+                        if (!action?.value)
+                            return;
+                        const value = action.value;
+                        const requestId = value._request_id;
+                        if (!requestId) {
+                            logger.debug('[Feishu] Card action without _request_id, ignoring');
+                            return;
+                        }
+                        // Legacy field change (non-form select_static with _field_key): ignore silently
+                        if (value._field_key) {
+                            logger.debug(`[Feishu] Legacy field change: requestId=${requestId}, field=${value._field_key}`);
+                            return;
+                        }
+                        // Form submit: `action.form_value` contains all field values from form container
+                        const formValues = action.form_value || {};
+                        const response = {
+                            type: 'interaction.response',
+                            id: requestId,
+                            action: value._action || 'submit',
+                            values: { ...formValues, ...value },
+                            operatorId: data.operator?.open_id,
+                        };
+                        // Remove internal fields from values
+                        delete response.values._request_id;
+                        delete response.values._action;
+                        delete response.values._card_title;
+                        logger.info(`[Feishu] Card action: requestId=${requestId}, action=${response.action}, values=${JSON.stringify(response.values)}`);
+                        this.interactionCallback?.(response);
+                        // Return updated card (buttons disabled + result shown)
+                        const cardTitle = value._card_title || '操作';
+                        return this.buildResolvedCard(cardTitle, response);
+                    }
+                    catch (err) {
+                        logger.error('[Feishu] Failed to handle card action:', err);
+                    }
+                },
             });
             this.wsClient = new lark.WSClient({
                 appId: this.config.appId,
@@ -290,6 +330,9 @@ export class FeishuChannel {
     onRecall(handler) {
         this.recallHandler = handler;
     }
+    onInteraction(callback) {
+        this.interactionCallback = callback;
+    }
     onProjectPathRequest(provider) {
         this.projectPathProvider = provider;
     }
@@ -323,6 +366,19 @@ export class FeishuChannel {
             logger.warn('[Feishu] Attempted to send empty message, skipping');
             return;
         }
+        // 飞书消息内容限制约 30KB（text）/ 150KB（post），安全阈值 28000 字符
+        // 超长消息自动拆分，按段落边界分割
+        const MAX_CONTENT_LENGTH = 28000;
+        if (content.length > MAX_CONTENT_LENGTH) {
+            logger.info(`[Feishu] Message too long (${content.length} chars), splitting into parts`);
+            const parts = splitLongMessage(content, MAX_CONTENT_LENGTH);
+            for (let i = 0; i < parts.length; i++) {
+                // 首条消息保留 reply 选项，后续消息不再 reply
+                const partOptions = i === 0 ? options : { ...options, replyToMessageId: undefined };
+                await this.sendMessage(chatId, parts[i], partOptions);
+            }
+            return;
+        }
         logger.debug(`[Feishu] sendMessage called, chatId: ${chatId}, content length: ${content.length}`);
         try {
             // 检测富内容并渲染（受 enableRichContent 开关控制，且依赖必须可用）
@@ -348,7 +404,7 @@ export class FeishuChannel {
             const useMarkdown = !options?.forceText && hasMarkdownSyntax(content);
             const hasMention = !!(options?.mentionUserIds && options.mentionUserIds.length > 0);
             const hasRichImages = richItemsWithKeys.length > 0;
-            // 如果有富内容图片、Markdown 或 @，使用 post 格式
+            // 消息类型决策：有 Markdown / @ / 富内容图片 → post，否则 text
             const msgType = (useMarkdown || hasMention || hasRichImages) ? 'post' : 'text';
             let msgContent;
             if (msgType === 'post') {
@@ -406,7 +462,7 @@ export class FeishuChannel {
             }
             else {
                 await this.client.im.message.create({
-                    params: { receive_id_type: 'chat_id' },
+                    params: { receive_id_type: chatId.startsWith('ou_') ? 'open_id' : chatId.startsWith('on_') ? 'union_id' : 'chat_id' },
                     data: { receive_id: chatId, msg_type: msgType, content: msgContent }
                 });
             }
@@ -423,6 +479,12 @@ export class FeishuChannel {
                 logger.warn('[Feishu] Message withdrawn (230011), retrying without reply');
                 return this.sendMessage(chatId, content, { ...options, replyToMessageId: undefined });
             }
+            // 230025: 消息内容超长，截断后重试
+            if (error.response?.data?.code === 230025) {
+                logger.warn(`[Feishu] Message too long (230025, ${content.length} chars), truncating`);
+                const truncated = content.slice(0, 28000) + '\n\n⚠️ 消息过长，已截断';
+                return this.sendMessage(chatId, truncated, options);
+            }
             logger.error('[Feishu] Failed to send message:', error);
             throw error;
         }
@@ -471,7 +533,7 @@ export class FeishuChannel {
             }
             else {
                 await this.client.im.message.create({
-                    params: { receive_id_type: 'chat_id' },
+                    params: { receive_id_type: chatId.startsWith('ou_') ? 'open_id' : chatId.startsWith('on_') ? 'union_id' : 'chat_id' },
                     data: {
                         receive_id: chatId,
                         msg_type: 'file',
@@ -519,7 +581,7 @@ export class FeishuChannel {
             }
             else {
                 await this.client.im.message.create({
-                    params: { receive_id_type: 'chat_id' },
+                    params: { receive_id_type: chatId.startsWith('ou_') ? 'open_id' : chatId.startsWith('on_') ? 'union_id' : 'chat_id' },
                     data: { receive_id: chatId, msg_type: 'image', content: msgContent }
                 });
             }
@@ -609,28 +671,17 @@ export class FeishuChannel {
                     logger.warn('[Feishu] Empty response from image download');
                     return null;
                 }
-                // 使用 image-type 检测真实的图片格式
-                const type = await imageType(buffer);
-                if (!type) {
-                    logger.warn('[Feishu] Unable to detect image type');
-                    return null;
-                }
-                // 白名单验证：只允许常见的图片格式
-                const allowedMimes = ['image/png', 'image/jpeg', 'image/gif', 'image/webp'];
-                if (!allowedMimes.includes(type.mime)) {
-                    logger.warn('[Feishu] Unsupported image type:', type.mime);
-                    return null;
-                }
-                // 大小限制：10MB
-                if (buffer.length > 10 * 1024 * 1024) {
-                    logger.warn('[Feishu] Image too large:', buffer.length, 'bytes');
+                // 统一图片验证（类型白名单 + 大小限制）
+                const result = await validateImage(buffer);
+                if (result.mime === null) {
+                    logger.warn(`[Feishu] Image validation failed: ${result.reason}`);
                     return null;
                 }
                 const base64Data = buffer.toString('base64');
-                logger.debug('[Feishu] Image downloaded successfully, type:', type.mime, 'size:', base64Data.length);
+                logger.debug('[Feishu] Image downloaded successfully, type:', result.mime, 'size:', base64Data.length);
                 return {
                     data: base64Data,
-                    mimeType: type.mime // 使用真实检测的 MIME 类型
+                    mimeType: result.mime
                 };
             }
             logger.error('[Feishu] Image download failed: no valid method');
@@ -671,11 +722,7 @@ export class FeishuChannel {
                     logger.warn('[Feishu] Empty response from file download');
                     return null;
                 }
-                const uploadsDir = path.join(projectPath, '.evolclaw', 'uploads');
-                ensureDir(uploadsDir);
-                const filePath = path.join(uploadsDir, fileName);
-                fs.writeFileSync(filePath, buffer);
-                logger.info('[Feishu] File downloaded successfully:', filePath, 'size:', buffer.length);
+                const { filePath } = saveToUploads(buffer, sanitizeFileName(fileName), projectPath);
                 return filePath;
             }
             logger.error('[Feishu] File download failed: no valid method');
@@ -686,6 +733,102 @@ export class FeishuChannel {
             return null;
         }
     }
+    async sendInteraction(chatId, interaction, options) {
+        if (!this.client)
+            return false;
+        const card = buildInteractionCard(interaction);
+        if (!card)
+            return false;
+        try {
+            let messageId;
+            if (options?.replyToMessageId) {
+                const replyData = {
+                    msg_type: 'interactive',
+                    content: JSON.stringify(card),
+                };
+                if (options.replyInThread)
+                    replyData.reply_in_thread = true;
+                const res = await this.client.im.message.reply({
+                    path: { message_id: options.replyToMessageId },
+                    data: replyData,
+                });
+                messageId = res?.data?.message_id;
+            }
+            else {
+                const res = await this.client.im.message.create({
+                    params: { receive_id_type: chatId.startsWith('ou_') ? 'open_id' : chatId.startsWith('on_') ? 'union_id' : 'chat_id' },
+                    data: {
+                        receive_id: chatId,
+                        msg_type: 'interactive',
+                        content: JSON.stringify(card),
+                    },
+                });
+                messageId = res?.data?.message_id;
+            }
+            logger.info(`[Feishu] Sent interaction card: ${interaction.id}, messageId=${messageId}`);
+            return messageId || false;
+        }
+        catch (error) {
+            const detail = error?.response?.data || error?.message || error;
+            logger.error(`[Feishu] Failed to send interaction card (id=${interaction.id}, replyTo=${options?.replyToMessageId || 'none'}):`, detail);
+            return false;
+        }
+    }
+    async patchInteractionCard(messageId, card) {
+        if (!this.client)
+            return;
+        try {
+            await this.client.im.message.patch({
+                path: { message_id: messageId },
+                data: { content: JSON.stringify(card) },
+            });
+        }
+        catch (error) {
+            logger.warn(`[Feishu] Failed to patch card ${messageId}:`, error?.response?.data || error?.message);
+        }
+    }
+    buildResolvedCard(cardTitle, response) {
+        const action = response.action;
+        const labelMap = {
+            'allow': '✅ 已允许',
+            'always': '🔓 已设为始终允许',
+            'deny': '❌ 已拒绝',
+            'cancel': '取消',
+            'submit': '✅ 已提交',
+        };
+        const statusText = labelMap[action] || `✅ ${action}`;
+        const now = new Date().toLocaleTimeString('zh-CN', { hour: '2-digit', minute: '2-digit' });
+        // Build summary of selected values
+        const elements = [];
+        if (response.values && action === 'submit') {
+            const entries = Object.entries(response.values).filter(([k]) => !k.startsWith('_'));
+            if (entries.length > 0) {
+                const lines = entries.map(([k, v]) => {
+                    const display = Array.isArray(v) ? v.join(', ') : String(v);
+                    return `**${k}**: ${display}`;
+                });
+                elements.push({ tag: 'markdown', content: lines.join('\n') });
+            }
+        }
+        elements.push({ tag: 'markdown', content: `操作时间：${now}` });
+        return {
+            toast: {
+                type: 'success',
+                content: statusText,
+            },
+            card: {
+                type: 'raw',
+                data: {
+                    config: { wide_screen_mode: true },
+                    header: {
+                        template: action === 'deny' ? 'red' : 'green',
+                        title: { tag: 'plain_text', content: `${cardTitle} — ${statusText}` },
+                    },
+                    elements,
+                },
+            },
+        };
+    }
     addAckReaction(messageId) {
         if (!this.client)
             return;
@@ -697,6 +840,260 @@ export class FeishuChannel {
         }).catch(() => { });
     }
 }
+// ── 交互卡片构建工具 ──
+export function buildInteractionCard(interaction) {
+    const { kind } = interaction;
+    if (kind.kind === 'action') {
+        return buildActionCard(interaction.id, kind);
+    }
+    if (kind.kind === 'form') {
+        return buildFormCard(interaction.id, kind);
+    }
+    // menu kind: not rendered as card (handled via menu.response JSON)
+    return null;
+}
+export function buildActionCard(requestId, action) {
+    const elements = [];
+    // Body text
+    if (action.body) {
+        elements.push({ tag: 'markdown', content: action.body });
+    }
+    // Buttons row
+    const buttons = action.buttons.map(btn => {
+        const buttonEl = {
+            tag: 'button',
+            text: { tag: 'plain_text', content: btn.label },
+            type: btn.style === 'danger' ? 'danger' : btn.style === 'primary' ? 'primary' : 'default',
+            value: {
+                _request_id: requestId,
+                _action: btn.key,
+                _card_title: action.title,
+            },
+        };
+        if (btn.confirm) {
+            buttonEl.confirm = {
+                title: { tag: 'plain_text', content: btn.confirm.title },
+                text: { tag: 'plain_text', content: btn.confirm.body },
+            };
+        }
+        return buttonEl;
+    });
+    elements.push({
+        tag: 'action',
+        actions: buttons,
+    });
+    return {
+        config: { wide_screen_mode: true },
+        header: {
+            template: 'blue',
+            title: { tag: 'plain_text', content: action.title },
+        },
+        elements,
+    };
+}
+export function buildFormCard(requestId, form) {
+    // Use Feishu card v2 form container: all fields wrapped in a `form` tag.
+    // On submit, callback receives `action.form_value` with all field values keyed by `name`.
+    // This eliminates per-field callbacks when selecting dropdown options.
+    const formElements = [];
+    // Body text
+    if (form.body) {
+        formElements.push({ tag: 'markdown', content: form.body });
+    }
+    // Fields — inside form, components use `name` (not `value`) for identification
+    for (const field of form.fields) {
+        formElements.push(buildFormFieldElement(field));
+        if (field.hint) {
+            formElements.push({
+                tag: 'note',
+                elements: [{ tag: 'plain_text', content: field.hint }],
+            });
+        }
+    }
+    // Submit button (inside form, uses form_action_type)
+    const submitBtn = {
+        tag: 'button',
+        text: { tag: 'plain_text', content: form.submitLabel || '确认' },
+        type: form.submitStyle === 'danger' ? 'danger' : 'primary',
+        form_action_type: 'submit',
+        name: 'submit',
+        value: {
+            _request_id: requestId,
+            _action: 'submit',
+            _card_title: form.title,
+        },
+    };
+    if (form.submitConfirm) {
+        submitBtn.confirm = {
+            title: { tag: 'plain_text', content: form.submitConfirm.title },
+            text: { tag: 'plain_text', content: form.submitConfirm.body },
+        };
+    }
+    const actions = [submitBtn];
+    if (form.cancelable !== false) {
+        actions.push({
+            tag: 'button',
+            text: { tag: 'plain_text', content: '取消' },
+            type: 'default',
+            // Cancel is NOT form_action_type — it's a regular button that triggers callback directly
+            value: {
+                _request_id: requestId,
+                _action: 'cancel',
+                _card_title: form.title,
+            },
+        });
+    }
+    formElements.push({ tag: 'action', actions });
+    return {
+        schema: '2.0',
+        config: { update_multi: true },
+        header: {
+            template: 'blue',
+            title: { tag: 'plain_text', content: form.title },
+        },
+        body: {
+            elements: [
+                {
+                    tag: 'form',
+                    name: requestId,
+                    elements: formElements,
+                },
+            ],
+        },
+    };
+}
+/** Build a field element for use inside a form container (uses `name` for identification) */
+export function buildFormFieldElement(field) {
+    switch (field.type) {
+        case 'select': {
+            const options = field.options.map(opt => ({
+                text: { tag: 'plain_text', content: opt.label },
+                value: opt.value,
+            }));
+            const selectedOpt = field.options.find(opt => opt.selected);
+            return {
+                tag: 'select_static',
+                name: field.key,
+                placeholder: { tag: 'plain_text', content: field.placeholder || `选择${field.label}` },
+                options,
+                ...(selectedOpt ? { initial_option: selectedOpt.value } : {}),
+            };
+        }
+        case 'text': {
+            return {
+                tag: 'input',
+                name: field.key,
+                placeholder: { tag: 'plain_text', content: field.placeholder || `输入${field.label}` },
+                ...(field.defaultValue != null ? { default_value: String(field.defaultValue) } : {}),
+            };
+        }
+        case 'toggle': {
+            const checked = field.defaultValue ?? false;
+            return {
+                tag: 'select_static',
+                name: field.key,
+                placeholder: { tag: 'plain_text', content: field.label },
+                options: [
+                    { text: { tag: 'plain_text', content: '开启' }, value: 'true' },
+                    { text: { tag: 'plain_text', content: '关闭' }, value: 'false' },
+                ],
+                initial_option: checked ? 'true' : 'false',
+            };
+        }
+        case 'multi-select': {
+            const options = field.options.map(opt => ({
+                text: { tag: 'plain_text', content: opt.label },
+                value: opt.value,
+            }));
+            const selectedValues = field.options.filter(opt => opt.selected).map(opt => opt.value);
+            return {
+                tag: 'multi_select_static',
+                name: field.key,
+                placeholder: { tag: 'plain_text', content: `选择${field.label}` },
+                options,
+                ...(selectedValues.length > 0 ? { initial_options: selectedValues } : {}),
+            };
+        }
+        default:
+            return { tag: 'markdown', content: `[不支持的字段类型: ${field.type}]` };
+    }
+}
+export function buildFieldElement(requestId, field) {
+    switch (field.type) {
+        case 'select': {
+            const options = field.options.map(opt => ({
+                text: { tag: 'plain_text', content: opt.label },
+                value: opt.value,
+            }));
+            const selectedOpt = field.options.find(opt => opt.selected);
+            return {
+                tag: 'action',
+                actions: [{
+                        tag: 'select_static',
+                        placeholder: { tag: 'plain_text', content: field.placeholder || `选择${field.label}` },
+                        options,
+                        ...(selectedOpt ? { initial_option: selectedOpt.value } : {}),
+                        value: {
+                            _request_id: requestId,
+                            _field_key: field.key,
+                        },
+                    }],
+            };
+        }
+        case 'text': {
+            // Feishu cards don't have a native text input component.
+            // Use a note element as placeholder label; actual input via form submit.
+            return {
+                tag: 'note',
+                elements: [
+                    { tag: 'plain_text', content: `${field.label}: ${field.placeholder || '(请在提交时输入)'}` },
+                ],
+            };
+        }
+        case 'toggle': {
+            const checked = field.defaultValue ?? false;
+            return {
+                tag: 'action',
+                actions: [{
+                        tag: 'select_static',
+                        placeholder: { tag: 'plain_text', content: field.label },
+                        options: [
+                            { text: { tag: 'plain_text', content: '开启' }, value: 'true' },
+                            { text: { tag: 'plain_text', content: '关闭' }, value: 'false' },
+                        ],
+                        initial_option: checked ? 'true' : 'false',
+                        value: {
+                            _request_id: requestId,
+                            _field_key: field.key,
+                        },
+                    }],
+            };
+        }
+        case 'multi-select': {
+            // Feishu cards: use multi_select_static (checker)
+            const options = field.options.map(opt => ({
+                text: { tag: 'plain_text', content: opt.label },
+                value: opt.value,
+            }));
+            const selectedValues = field.options.filter(opt => opt.selected).map(opt => opt.value);
+            return {
+                tag: 'action',
+                actions: [{
+                        tag: 'multi_select_static',
+                        placeholder: { tag: 'plain_text', content: `选择${field.label}` },
+                        options,
+                        ...(selectedValues.length > 0 ? { initial_options: selectedValues } : {}),
+                        value: {
+                            _request_id: requestId,
+                            _field_key: field.key,
+                        },
+                    }],
+            };
+        }
+        default:
+            return { tag: 'markdown', content: `[不支持的字段类型: ${field.type}]` };
+    }
+}
 function displayWidth(str) {
     let width = 0;
     for (const ch of str) {
@@ -735,6 +1132,26 @@ function convertTablesToText(text) {
         return '```\n' + [headerStr, sepStr, ...rowStrs].join('\n') + '\n```';
     });
 }
+/**
+ * 按段落边界拆分超长消息
+ * 优先在 \n\n 处分割，其次 \n，最后强制截断
+ */
+function splitLongMessage(content, maxLength) {
+    const parts = [];
+    let remaining = content;
+    while (remaining.length > maxLength) {
+        let splitAt = remaining.lastIndexOf('\n\n', maxLength);
+        if (splitAt <= 0)
+            splitAt = remaining.lastIndexOf('\n', maxLength);
+        if (splitAt <= 0)
+            splitAt = maxLength;
+        parts.push(remaining.slice(0, splitAt).trimEnd());
+        remaining = remaining.slice(splitAt).trimStart();
+    }
+    if (remaining)
+        parts.push(remaining);
+    return parts;
+}
 export function markdownToFeishuPost(markdown, defaultTitle) {
     const match = markdown.match(/^# (.+)$/m);
     const title = match?.[1] ?? defaultTitle ?? '';
@@ -747,6 +1164,29 @@ export function markdownToFeishuPost(markdown, defaultTitle) {
         }
     };
 }
+/**
+ * 将 Markdown 内容转为飞书消息卡片格式（interactive msg_type）
+ * 飞书卡片的 markdown 组件支持完整 Markdown 渲染（代码块、表格、列表等）
+ * 当前消息类型决策统一走 post + md tag，此函数为 interactive 卡片场景预留。
+ */
+export function markdownToFeishuCard(markdown, defaultTitle) {
+    const match = markdown.match(/^# (.+)$/m);
+    const title = match?.[1] ?? defaultTitle;
+    let body = match ? markdown.replace(/^# .+\n?/, '') : markdown;
+    body = convertTablesToText(body).trim();
+    const card = {
+        config: { wide_screen_mode: true },
+        elements: [
+            { tag: 'markdown', content: body }
+        ]
+    };
+    if (title) {
+        card.header = {
+            title: { tag: 'plain_text', content: title }
+        };
+    }
+    return card;
+}
 export function hasMarkdownSyntax(text) {
     const markdownPatterns = [
         /^#{1,6}\s/m, /\*\*.*?\*\*/, /\*.*?\*/, /__.*?__/, /_.*?_/, /~~.*?~~/,
@@ -755,73 +1195,93 @@ export function hasMarkdownSyntax(text) {
     ];
     return markdownPatterns.some(pattern => pattern.test(text));
 }
+import { normalizeChannelInstances } from '../config.js';
 export class FeishuChannelPlugin {
     name = 'feishu';
     isEnabled(config) {
-        const feishuConfig = config.channels?.feishu;
-        if (feishuConfig?.enabled === false)
+        const raw = config.channels?.feishu;
+        if (!raw)
+            return false;
+        if (Array.isArray(raw)) {
+            return raw.some(inst => inst.enabled !== false && inst.appId && inst.appSecret);
+        }
+        if (raw.enabled === false)
             return false;
-        return !!(feishuConfig?.appId && feishuConfig?.appSecret);
+        return !!(raw.appId && raw.appSecret);
+    }
+    async createChannels(config) {
+        const instances = normalizeChannelInstances(config.channels?.feishu, 'feishu');
+        const result = [];
+        for (const inst of instances) {
+            if (inst.enabled === false || !inst.appId || !inst.appSecret)
+                continue;
+            const channel = new FeishuChannel({
+                appId: inst.appId,
+                appSecret: inst.appSecret,
+                enableRichContent: config.enableRichContent,
+            });
+            const adapter = {
+                channelName: inst.name,
+                sendText: (id, text, context) => channel.sendMessage(id, text, context),
+                sendFile: (id, filePath, context) => channel.sendFile(id, filePath, context),
+                sendImage: (id, png, context) => channel.sendImage(id, png, context),
+                acknowledge: (messageId) => { channel.addAckReaction(messageId); return Promise.resolve(); },
+                sendInteraction: (id, interaction, context) => channel.sendInteraction(id, interaction, context),
+                patchInteractionCard: (messageId, card) => channel.patchInteractionCard(messageId, card),
+                onInteraction: (callback) => channel.onInteraction(callback),
+            };
+            const policy = {
+                canSwitchProject: (chatType, identity) => identity === 'owner',
+                canListProjects: (chatType, identity) => identity === 'owner',
+                canCreateSession: (chatType, identity) => true,
+                canDeleteSession: (chatType, identity) => true,
+                canImportCliSession: (chatType, identity) => identity === 'owner',
+                messagePrefix: (chatType, peerName) => (chatType === 'group' && peerName) ? `[${peerName}] ` : '',
+                showMiddleResult: (chatType, identity) => {
+                    const mode = inst.showActivities ?? config.showActivities ?? 'all';
+                    if (mode === 'none')
+                        return false;
+                    if (mode === 'dm-only')
+                        return chatType === 'private';
+                    if (mode === 'owner-dm-only')
+                        return chatType === 'private' && identity === 'owner';
+                    return true;
+                },
+                showIdleMonitor: (chatType, identity) => {
+                    const mode = inst.showActivities ?? config.showActivities ?? 'all';
+                    if (mode === 'none')
+                        return false;
+                    if (mode === 'dm-only')
+                        return chatType === 'private';
+                    if (mode === 'owner-dm-only')
+                        return chatType === 'private' && identity === 'owner';
+                    return true;
+                },
+                accumulateErrors: (chatType, identity) => true,
+            };
+            const options = {
+                fileMarkerPattern: /\[SEND_FILE:(?:(\w+):)?([^\]]+)\]/g,
+                supportsImages: true,
+                flushDelay: inst.flushDelay,
+            };
+            result.push({
+                channelType: 'feishu',
+                adapter,
+                channel,
+                policy,
+                options,
+                connect: () => channel.connect(),
+                disconnect: () => channel.disconnect(),
+                onProjectPathRequest: (channelId) => Promise.resolve(config.projects?.defaultPath || process.cwd()),
+            });
+        }
+        return result;
     }
     async createChannel(config) {
-        const feishuConfig = config.channels?.feishu;
-        if (!feishuConfig?.appId || !feishuConfig?.appSecret) {
+        const instances = await this.createChannels(config);
+        if (instances.length === 0) {
             throw new Error('Feishu config missing');
         }
-        const channel = new FeishuChannel({
-            appId: feishuConfig.appId,
-            appSecret: feishuConfig.appSecret,
-            enableRichContent: feishuConfig.enableRichContent,
-        });
-        const adapter = {
-            name: 'feishu',
-            sendText: (id, text, context) => channel.sendMessage(id, text, context),
-            sendFile: (id, filePath, context) => channel.sendFile(id, filePath, context),
-            sendImage: (id, png, context) => channel.sendImage(id, png, context),
-            acknowledge: (messageId) => { channel.addAckReaction(messageId); return Promise.resolve(); },
-        };
-        const policy = {
-            canSwitchProject: (chatType, identity) => identity === 'owner',
-            canListProjects: (chatType, identity) => identity === 'owner',
-            canCreateSession: (chatType, identity) => true,
-            canDeleteSession: (chatType, identity) => true,
-            canImportCliSession: (chatType, identity) => identity === 'owner',
-            messagePrefix: (chatType, peerName) => (chatType === 'group' && peerName) ? `[${peerName}] ` : '',
-            showMiddleResult: (chatType, identity) => {
-                const mode = feishuConfig.showActivities ?? config.showActivities ?? 'all';
-                if (mode === 'none')
-                    return false;
-                if (mode === 'dm-only')
-                    return chatType === 'private';
-                if (mode === 'owner-dm-only')
-                    return chatType === 'private' && identity === 'owner';
-                return true;
-            },
-            showIdleMonitor: (chatType, identity) => {
-                const mode = feishuConfig.showActivities ?? config.showActivities ?? 'all';
-                if (mode === 'none')
-                    return false;
-                if (mode === 'dm-only')
-                    return chatType === 'private';
-                if (mode === 'owner-dm-only')
-                    return chatType === 'private' && identity === 'owner';
-                return true;
-            },
-            accumulateErrors: (chatType, identity) => true,
-        };
-        const options = {
-            fileMarkerPattern: /\[SEND_FILE:(?:(\w+):)?([^\]]+)\]/g,
-            supportsImages: true,
-            flushDelay: feishuConfig.flushDelay,
-        };
-        return {
-            adapter,
-            channel,
-            policy,
-            options,
-            connect: () => channel.connect(),
-            disconnect: () => channel.disconnect(),
-            onProjectPathRequest: (channelId) => Promise.resolve(config.projects?.defaultPath || process.cwd()),
-        };
+        return instances[0];
     }
 }