evolclaw 3.1.10 → 3.2.0

package/dist/channels/aun.js

@@ -7,7 +7,7 @@ import { logger, localTimestamp } from '../utils/logger.js';
 import { LogWriter } from '../utils/log-writer.js';
 import { normalizeChannelInstances, getChannelShowActivities } from '../utils/channel-helpers.js';
 import { resolvePaths, getPackageRoot, agentMdPath as agentMdPathFn, agentDir as agentDirPath, resolveRoot } from '../paths.js';
-import { saveToUploads, sanitizeFileName } from '../utils/media-cache.js';
+import { saveToUploads, sanitizeFileName, bufferToInboundImage } from '../utils/media-cache.js';
 import { appendAidEvent } from '../utils/instance-registry.js';
 import { appendMessageLog, buildOutboundEntry } from '../core/message/message-log.js';
 import { chatDirPath } from '../core/session/session-fs-store.js';
@@ -58,6 +58,37 @@ function getEvolclawVersion() {
     }
     return _cachedVersion;
 }
+/**
+ * 把 AUNChannel 投递的 opts 映射成渠道无关的 InboundMessage。
+ *
+ * registerBridge 适配回调用它替代手抄字段——历史上手抄漏掉了
+ * sameDevice/sameNetwork/sameEgressIp，proximity 在此被吞，eck-debug 永远 false。
+ * 抽成纯函数后可单测锁字段，杜绝再漏。
+ */
+export function aunOptsToInbound(opts, channel, channelType) {
+    return {
+        channel,
+        channelType,
+        channelId: opts.channelId,
+        selfAID: opts.selfAID,
+        groupId: opts.groupId,
+        content: opts.content,
+        chatType: opts.chatType || 'private',
+        peerId: opts.peerId || '',
+        peerName: opts.peerName,
+        peerType: opts.peerType,
+        sameDevice: opts.sameDevice,
+        sameNetwork: opts.sameNetwork,
+        sameEgressIp: opts.sameEgressIp,
+        messageId: opts.messageId,
+        mentions: opts.mentions,
+        mentionAids: opts.mentionAids,
+        threadId: opts.threadId,
+        replyContext: opts.replyContext,
+        source: opts.source,
+        images: opts.images,
+    };
+}
 export class AUNChannel {
     config;
     client = null;
@@ -427,6 +458,7 @@ export class AUNChannel {
     _selfName; // 本地 agent.md 中的 name，首次 connect 时读取
     _chatId = ''; // aid:device_id:slot_id — 多实例回声过滤
     seenMessages = new Map();
+    groupNameCache = new Map(); // groupId → 群显示名（进程内缓存，群名极少变）
     peerInfoCache = new Map();
     messageSeqMap = new Map(); // messageId → seq (for ack)
     sentCount = new Map(); // channelId → 已发消息计数（用于判断最终回复）
@@ -591,13 +623,16 @@ export class AUNChannel {
             logger.debug(`${this.logPrefix()}[DIAG] message.received: kind=${kind} keys=${keys}`);
             this.handleIncomingPrivateMessage(data);
         });
-        client.on('group.message_created', (data) => {
-            this.trace('IN', 'group.message_created', data);
-            const gid = (data && typeof data === 'object') ? data.group_id ?? '' : '';
-            const sender = (data && typeof data === 'object') ? data.sender_aid ?? '' : '';
-            logger.debug(`${this.logPrefix()}[DIAG] group.message_created: group_id=${gid} sender=${sender}`);
-            this.handleIncomingGroupMessage(data);
-        });
+        // pureIdentity（控制 AID）：协议层不接群消息，不注册 group 创建监听
+        if (!this.config.pureIdentity) {
+            client.on('group.message_created', (data) => {
+                this.trace('IN', 'group.message_created', data);
+                const gid = (data && typeof data === 'object') ? data.group_id ?? '' : '';
+                const sender = (data && typeof data === 'object') ? data.sender_aid ?? '' : '';
+                logger.debug(`${this.logPrefix()}[DIAG] group.message_created: group_id=${gid} sender=${sender}`);
+                this.handleIncomingGroupMessage(data);
+            });
+        }
         client.on('connection.state', (data) => {
             // trace is handled inside handleConnectionState with throttling
             this.handleConnectionState(data);
@@ -626,11 +661,14 @@ export class AUNChannel {
             const d = data;
             logger.warn(`${this.logPrefix()} Message undecryptable: from=${d.from} mid=${d.message_id} err=${d._decrypt_error}`);
         });
-        client.on('group.message_undecryptable', (data) => {
-            this.trace('IN', 'group.message_undecryptable', data);
-            const d = data;
-            logger.warn(`${this.logPrefix()} Group message undecryptable: group=${d.group_id} from=${d.from} mid=${d.message_id} err=${d._decrypt_error}`);
-        });
+        // pureIdentity（控制 AID）：不注册 group 解密失败监听
+        if (!this.config.pureIdentity) {
+            client.on('group.message_undecryptable', (data) => {
+                this.trace('IN', 'group.message_undecryptable', data);
+                const d = data;
+                logger.warn(`${this.logPrefix()} Group message undecryptable: group=${d.group_id} from=${d.from} mid=${d.message_id} err=${d._decrypt_error}`);
+            });
+        }
         // Authenticate（拿权威 gateway 用于日志/状态；connect 内部也会复用 token）
         try {
             logger.info(`${this.logPrefix()} Authenticating as ${aidName}...`);
@@ -676,7 +714,8 @@ export class AUNChannel {
             this._aid = this.client.aid ?? undefined;
             const deviceId = this.client._device_id ?? '';
             this._chatId = this._aid ? `${this._aid}:${deviceId}:` : '';
-            this._selfName = this.loadSelfName(aidName);
+            // pureIdentity（控制 AID）：无 agent.md，跳过自身 agent.md 拉取，省一次 404
+            this._selfName = this.config.pureIdentity ? undefined : this.loadSelfName(aidName);
             if (this._selfName && this.aidStatsCollector)
                 this.aidStatsCollector.setSelfName(this.config.aid, this._selfName);
             this.connected = true;
@@ -697,7 +736,10 @@ export class AUNChannel {
             appendAidEvent({ ts: Date.now(), iso: new Date().toISOString(), event: 'connected', aid: this.config.aid, gateway: this.gatewayUrl });
             appendAidLifecycle({ ts: Date.now(), iso: new Date().toISOString(), event: 'connected', aid: this.config.aid, gateway: this.gatewayUrl });
             // Send welcome message to owner after first connection
-            await this.sendWelcomeMessage();
+            // pureIdentity（控制 AID）：跳过 evolagent onboarding（根除 warn 噪声 + 永不 agentmdPut）
+            if (!this.config.pureIdentity) {
+                await this.sendWelcomeMessage();
+            }
         }
         catch (e) {
             this.trace('OUT', 'client.connect.error', { error: String(e) });
@@ -848,43 +890,55 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
     }
     // ── Event handlers ──────────────────────────────────────────
     /**
-     * 判断附件是否为图片，返回 MIME 类型（非图片返回空）。
-     * 多重检测：附件元数据字段 → 文件名后缀 → 文件 magic bytes。
+     * 统一处理入站附件：下载 → 图片识别+base64 注入 → 拼接文本。
+     *
+     * - 图片：base64 注入视觉通道（不再追加 [文件: …] 文本行，避免冗余）
+     * - 非图片：拼 [文件: name → path]，并提示用 Read 工具读取
+     *
+     * @param baseText 已解析的正文（私聊 text / 群聊 strippedText）
+     * @param channelId 下载归属（私聊 fromAid / 群聊 groupId）
+     * @param preCollected 已收集的附件（群聊路径会提前 collect，避免重复）
      */
-    detectImageMime(att, filePath) {
-        const extToMime = {
-            '.png': 'image/png', '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg',
-            '.gif': 'image/gif', '.webp': 'image/webp',
-        };
-        // 1. 附件元数据字段（content_type / mime_type / mimeType）
-        const metaCt = (att?.content_type || att?.mime_type || att?.mimeType || '');
-        if (typeof metaCt === 'string' && metaCt.startsWith('image/'))
-            return metaCt;
-        // 2. 文件名后缀
-        const name = (att?.filename || att?.object_key || filePath || '').toLowerCase();
-        for (const [ext, mime] of Object.entries(extToMime)) {
-            if (name.endsWith(ext))
-                return mime;
-        }
-        // 3. magic bytes
-        try {
-            const { openSync, readSync, closeSync } = require('node:fs');
-            const fd = openSync(filePath, 'r');
-            const head = Buffer.alloc(12);
-            readSync(fd, head, 0, 12, 0);
-            closeSync(fd);
-            if (head[0] === 0x89 && head[1] === 0x50 && head[2] === 0x4e && head[3] === 0x47)
-                return 'image/png';
-            if (head[0] === 0xff && head[1] === 0xd8 && head[2] === 0xff)
-                return 'image/jpeg';
-            if (head[0] === 0x47 && head[1] === 0x49 && head[2] === 0x46)
-                return 'image/gif';
-            if (head[0] === 0x52 && head[1] === 0x49 && head[2] === 0x46 && head[3] === 0x46 &&
-                head[8] === 0x57 && head[9] === 0x45 && head[10] === 0x42 && head[11] === 0x50)
-                return 'image/webp';
-        }
-        catch { /* not readable, skip */ }
-        return '';
+    async processAttachments(payload, baseText, channelId, preCollected) {
+        const rawAttachments = preCollected ?? this.collectAllAttachments(payload);
+        const images = [];
+        let finalText = baseText;
+        if (rawAttachments.length === 0 || !this.client) {
+            return { finalText, images };
+        }
+        const fileParts = [];
+        for (const att of rawAttachments) {
+            const filePath = await this.downloadAttachment(att, channelId);
+            if (!filePath)
+                continue;
+            const name = sanitizeFileName(att.filename || att.object_key?.split('/').pop() || 'file');
+            let img = null;
+            try {
+                const { readFileSync } = await import('node:fs');
+                img = await bufferToInboundImage(readFileSync(filePath), {
+                    contentType: att.content_type, mimeType: att.mime_type, filename: name,
+                });
+            }
+            catch { /* read failed, treat as non-image file */ }
+            if (img) {
+                images.push(img);
+                // 图片已注入视觉通道，不追加 [文件: …] 文本行
+            }
+            else {
+                fileParts.push(`[文件: ${name} → ${filePath}]`);
+            }
+        }
+        const parts = [];
+        if (baseText)
+            parts.push(baseText);
+        if (fileParts.length > 0) {
+            parts.push(...fileParts);
+            parts.push('请使用 Read 工具读取文件内容。');
+        }
+        if (parts.length > 0)
+            finalText = parts.join('\n\n');
+        logger.info(`${this.logPrefix()} [attachments] count=${rawAttachments.length} images=${images.length} files=${fileParts.length}`);
+        return { finalText, images };
     }
     async downloadAttachment(att, channelId) {
         const ownerAid = att.owner_aid || this._aid || '';
@@ -956,6 +1010,9 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
         const threadId = typeof payload === 'object' && payload !== null ? payload.thread_id : undefined;
         const messageId = msg.message_id ?? '';
         const seq = msg.seq;
+        // Observer forward (inbound)：在所有过滤之前转发原始明文 payload。
+        // forwardInbound 内部排除 self-echo 与 from-owner。
+        this.forwardInbound(fromAid, seq, payload);
         // 回声过滤：自己发出的消息会被 gateway fanout 回来，
         // 只有 from_aid == self 且 chat_id 不匹配时才丢弃（说明是其它实例发的）
         const msgChatId = typeof payload === 'object' && payload !== null && payload.chat_id;
@@ -974,37 +1031,7 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
             mentions.push(this._aid);
         }
         // Process attachments (顶层 + 嵌套在 merge.items / quote.quote 中的)
-        const rawAttachments = this.collectAllAttachments(payload);
-        let finalText = text;
-        const inboundImages = [];
-        if (rawAttachments.length > 0 && this.client) {
-            const fileParts = [];
-            for (const att of rawAttachments) {
-                const filePath = await this.downloadAttachment(att, fromAid);
-                if (filePath) {
-                    const name = sanitizeFileName(att.filename || att.object_key?.split('/').pop() || 'file');
-                    const mime = this.detectImageMime(att, filePath);
-                    if (mime) {
-                        try {
-                            const { readFileSync } = await import('node:fs');
-                            inboundImages.push({ data: readFileSync(filePath).toString('base64'), mimeType: mime });
-                        }
-                        catch { /* fallback to file path */ }
-                    }
-                    fileParts.push(`[文件: ${name} → ${filePath}]`);
-                }
-            }
-            if (fileParts.length > 0) {
-                const parts = [];
-                if (text)
-                    parts.push(text);
-                parts.push(...fileParts);
-                if (inboundImages.length === 0)
-                    parts.push('请使用 Read 工具读取文件内容。');
-                finalText = parts.join('\n\n');
-            }
-            logger.info(`${this.logPrefix()} [img-debug] private attachments=${rawAttachments.length} images=${inboundImages.length}`);
-        }
+        const { finalText, images: inboundImages } = await this.processAttachments(payload, text, fromAid);
         // 私聊 channelId = 对端 AID（不再读 payload.chat_id 含 device 三段式）
         // device_id 仅 SDK 内部多实例去重用，evolclaw session 层面跨端共享会话
         const chatId = fromAid;
@@ -1074,6 +1101,9 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
         const threadId = typeof payload === 'object' && payload !== null ? payload.thread_id : undefined;
         const messageId = msg.message_id ?? '';
         const seq = msg.seq;
+        // Observer forward (inbound)：群聊消息在所有过滤之前转发原始明文 payload。
+        // forwardInbound 内部排除 self-echo 与 from-owner。
+        this.forwardInbound(senderAid, seq, payload);
         // Extract structured mentions from payload (e.g. payload.mentions: ["evolai.agentid.pub"])
         const payloadMentions = Array.isArray(payload?.mentions)
             ? payload.mentions.filter((m) => typeof m === 'string')
@@ -1210,35 +1240,7 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
             ? ['all']
             : mentionedSelf && this._aid ? [this._aid] : [];
         // Process attachments
-        let finalText = strippedText;
-        const inboundImages = [];
-        if (hasAttachments && this.client) {
-            const fileParts = [];
-            for (const att of rawAttachments) {
-                const filePath = await this.downloadAttachment(att, groupId);
-                if (filePath) {
-                    const name = sanitizeFileName(att.filename || att.object_key?.split('/').pop() || 'file');
-                    const mime = this.detectImageMime(att, filePath);
-                    if (mime) {
-                        try {
-                            const { readFileSync } = await import('node:fs');
-                            inboundImages.push({ data: readFileSync(filePath).toString('base64'), mimeType: mime });
-                        }
-                        catch { /* fallback to file path */ }
-                    }
-                    fileParts.push(`[文件: ${name} → ${filePath}]`);
-                }
-            }
-            if (fileParts.length > 0) {
-                const parts = [];
-                if (strippedText)
-                    parts.push(strippedText);
-                parts.push(...fileParts);
-                if (inboundImages.length === 0)
-                    parts.push('请使用 Read 工具读取文件内容。');
-                finalText = parts.join('\n\n');
-            }
-        }
+        const { finalText, images: inboundImages } = await this.processAttachments(payload, strippedText, groupId, rawAttachments);
         const selfAgentDir = path.join(resolvePaths().agentsDir, this.config.aid);
         const peerIdentity = await PeerIdentityCache.resolve('aun', senderAid, selfAgentDir, this.store, false);
         const shortAid = this.getShortAid(senderAid);
@@ -1262,6 +1264,12 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
         logger.info(`${this.logPrefix()} Group dispatched: group=${groupId} sender=${shortAid}(${displayName}) mode=${dispatchMode} mid=${messageId} chatmode=${msgChatmode ?? 'none'} text=${finalText.slice(0, 60)}`);
         appendAidEvent({ ts: Date.now(), iso: new Date().toISOString(), event: 'message_in', aid: this.config.aid, from: senderAid, msgId: messageId, kind: 'text', len: finalText.length, groupId });
         this.aidStatsCollector?.recordInbound(this.config.aid, senderAid, Buffer.byteLength(finalText, 'utf-8'), finalText, payloadType === 'event', msgEncrypted, msgChatmode);
+        // 渲染用完整 @ 列表：结构化 payload.mentions + 正文 @aid 兜底，去重（含 self / "all"）。
+        // 与上面用于过滤/回复的精简 mentions 独立——这份不丢任何被 @ 的 AID。
+        const renderMentionAids = Array.from(new Set([
+            ...payloadMentions,
+            ...this.extractMentionAidsFromText(text),
+        ]));
         this.dispatchMessage({
             channelId: groupId,
             groupId,
@@ -1277,6 +1285,7 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
             seq,
             threadId,
             mentions,
+            mentionAids: renderMentionAids.length > 0 ? renderMentionAids : undefined,
             replyContext: this.buildGroupReplyContext(threadId, senderAid, msgEncrypted, messageId, msgChatmode),
             images: inboundImages.length > 0 ? inboundImages : undefined,
         });
@@ -1347,32 +1356,68 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
             messageId: event.messageId,
             threadId: event.threadId,
             mentions: mentionObjects,
+            mentionAids: event.mentionAids,
             replyContext,
             images: event.images,
         }).catch(err => {
             logger.error(`${this.logPrefix()} Message handler error:`, err);
         });
-        // Observer forward: inbound
-        this.forwardToOwners('inbound', {
-            from: event.userId || event.channelId || '',
-            to: this.config.aid,
-            seq: event.seq,
-            payload: { type: 'text', text: event.text },
-        });
+    }
+    // ── 观察者模式（Observer Mode） ──────────────────────────────
+    //
+    // observable=true 时，Agent 收发的每条 AUN 消息（原始信封 + 解密后明文
+    // payload）镜像一份给 owners[]。入站在所有过滤之前转发；出站在真实发送
+    // 成功后转发。外层一律明文。详见 docs/observer-mode-design.md。
+    // observable / owners 不在此处缓存——由 daemon 注入 resolver，从 EvolAgent 的
+    // in-memory merged config（启动/重启/热重载时统一更新的唯一缓存）读取，避免重复缓存。
+    observerConfigResolver;
+    /** 注入观察者配置读取器（daemon 侧从 EvolAgent merged config 读）。 */
+    setObserverConfigResolver(fn) {
+        this.observerConfigResolver = fn;
+    }
+    /** 读取 observable 开关 + owners；无 resolver（如未接入 daemon）时视为关闭。 */
+    getObserverConfig() {
+        return this.observerConfigResolver?.() ?? { observable: false, owners: [] };
+    }
+    /**
+     * 入站转发：到达本 AID 的消息全部转发，排除 self-echo。
+     * 若消息发送方本身是 owner，则不转发给该 owner，但仍转发给其他 owner。
+     * 调用点须在所有过滤逻辑之前，payload 为 SDK 解密后的明文。
+     */
+    forwardInbound(from, seq, payload) {
+        if (!this.connected || !this.client)
+            return;
+        const { observable, owners } = this.getObserverConfig();
+        if (!observable || owners.length === 0)
+            return;
+        if (this._aid && from === this._aid)
+            return; // self-echo：已在出站转过
+        // 排除来源 owner（不把"owner A 发来的"再转回 A），但仍转给其他 owner。
+        const recipientOwners = owners.filter(o => o !== from);
+        if (recipientOwners.length === 0)
+            return;
+        this.emitForward('inbound', { from, to: this.config.aid, seq, payload }, recipientOwners);
     }
     /**
-     * 观察者模式转发：将消息副本以 observer.forward 格式发给所有 owners。
-     * 仅在 AgentConfig.observable === true 时执行；owners 为空或无法加载配置时静默跳过。
+     * 出站转发：Agent 经 AUN 真实发出的消息全部转发。
+     * to 为对端（私聊 AID / 群 ID），payload 为实际发送的明文 payload。
+     * 若 to 本身是 owner，排除该 owner（不把"回复 A"转发给 A 自己）。
      */
-    forwardToOwners(direction, original) {
+    forwardOutbound(to, payload) {
         if (!this.connected || !this.client)
             return;
-        const agentConfig = loadAgent(this.config.aid);
-        if (!agentConfig?.observable)
+        const { observable, owners } = this.getObserverConfig();
+        if (!observable || owners.length === 0)
             return;
-        const owners = agentConfig.owners ?? [];
-        if (owners.length === 0)
+        // 过滤：若 to 本身是 owner，不转发给该 owner（避免"回复你"转给你自己）；
+        // 但仍转发给其他 owner。
+        const recipientOwners = owners.filter(o => o !== to);
+        if (recipientOwners.length === 0)
             return;
+        this.emitForward('outbound', { from: this.config.aid, to, payload }, recipientOwners);
+    }
+    /** 实际投递 observer.forward 给每个 owner，外层一律明文。 */
+    emitForward(direction, original, owners) {
         const forwardPayload = {
             type: 'observer.forward',
             direction,
@@ -1386,8 +1431,7 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
             },
         };
         for (const ownerAid of owners) {
-            const encrypt = this.shouldEncrypt(ownerAid);
-            this.callAndTrace('message.send', { to: ownerAid, payload: forwardPayload, encrypt })
+            this.callAndTrace('message.send', { to: ownerAid, payload: forwardPayload, encrypt: false })
                 .catch(e => logger.debug(`${this.logPrefix()} observer.forward to ${ownerAid} failed: ${e}`));
         }
     }
@@ -1866,12 +1910,8 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
                     appendAidEvent({ ts: Date.now(), iso: new Date().toISOString(), event: 'message_out', aid: this.config.aid, to: channelId, msgId: mid, kind: 'text', len: finalText.length, groupId: channelId });
                     this.aidStatsCollector?.recordOutbound(this.config.aid, channelId, Buffer.byteLength(finalText, 'utf-8'), finalText, false, encrypt, context?.metadata?.chatmode);
                     this.appendOutboundJsonl(channelId, finalText, mid, encrypt, context, true, 'text', source);
-                    // Observer forward: outbound (group)
-                    this.forwardToOwners('outbound', {
-                        from: this.config.aid,
-                        to: channelId,
-                        payload: { type: 'text', text: finalText },
-                    });
+                    // Observer forward: outbound (group) — 转发实际发出的明文 payload
+                    this.forwardOutbound(channelId, payload);
                 }
             }
             else {
@@ -1885,12 +1925,8 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
                     appendAidEvent({ ts: Date.now(), iso: new Date().toISOString(), event: 'message_out', aid: this.config.aid, to: targetAid, msgId: result.message_id, kind: 'text', len: finalText.length });
                     this.aidStatsCollector?.recordOutbound(this.config.aid, targetAid, Buffer.byteLength(finalText, 'utf-8'), finalText, false, encrypt, context?.metadata?.chatmode);
                     this.appendOutboundJsonl(targetAid, finalText, result.message_id, encrypt, context, false, 'text', source);
-                    // Observer forward: outbound (private)
-                    this.forwardToOwners('outbound', {
-                        from: this.config.aid,
-                        to: targetAid,
-                        payload: { type: 'text', text: finalText },
-                    });
+                    // Observer forward: outbound (private) — 转发实际发出的明文 payload
+                    this.forwardOutbound(targetAid, payload);
                 }
             }
             return true;
@@ -1908,6 +1944,7 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
                         if (!result || !result.message_id) {
                             logger.warn(`${this.logPrefix()} group.send fallback returned no message_id: ${JSON.stringify(result)}`);
                         }
+                        this.forwardOutbound(channelId, payload);
                     }
                     else {
                         this.trace('OUT', 'message.send.fallback', params);
@@ -1916,6 +1953,7 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
                         if (!result || !result.message_id) {
                             logger.warn(`${this.logPrefix()} message.send fallback returned no message_id: ${JSON.stringify(result)}`);
                         }
+                        this.forwardOutbound(targetAid, payload);
                     }
                     return true;
                 }
@@ -2011,6 +2049,7 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
                 const tid = putRes?.thought_id;
                 logger.info(`${this.logPrefix()} thought.put ok group=${targetId} task=${taskId} stage=${stage} encrypt=${encrypt} tid=${tid ?? '?'}`);
                 this.eventBus?.publish?.({ type: 'message:thought-put', agentName: this.config.aid, channelId, taskId, text: thoughtText });
+                this.forwardOutbound(channelId, payload);
                 if (thoughtText) {
                     this.aidStatsCollector?.recordOutbound(this.config.aid, channelId, Buffer.byteLength(thoughtText, 'utf-8'), thoughtText, false, encrypt, context?.metadata?.chatmode ?? 'proactive');
                     this.appendOutboundJsonl(channelId, thoughtText, tid ?? `thought-${Date.now()}`, encrypt, context, true, 'thought', 'daemon');
@@ -2022,6 +2061,7 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
                 const tid = putRes?.thought_id;
                 logger.info(`${this.logPrefix()} thought.put ok p2p=${this.peerLabel(targetId)} task=${taskId} stage=${stage} encrypt=${encrypt} tid=${tid ?? '?'}`);
                 this.eventBus?.publish?.({ type: 'message:thought-put', agentName: this.config.aid, channelId, taskId, text: thoughtText });
+                this.forwardOutbound(channelId, payload);
                 if (thoughtText) {
                     this.aidStatsCollector?.recordOutbound(this.config.aid, targetId, Buffer.byteLength(thoughtText, 'utf-8'), thoughtText, false, encrypt, context?.metadata?.chatmode ?? 'proactive');
                     this.appendOutboundJsonl(channelId, thoughtText, tid ?? `thought-${Date.now()}`, encrypt, context, false, 'thought', 'daemon');
@@ -2058,12 +2098,14 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
                 const result = await this.callAndTrace('group.send', params);
                 const mid = result?.message?.message_id ?? result?.message_id ?? null;
                 logger.info(`${this.logPrefix()} group.send (${payload.type}) ok: group=${channelId} mid=${mid} encrypt=${encrypt}`);
+                this.forwardOutbound(channelId, finalPayload);
                 return mid;
             }
             else {
                 params.to = targetAid;
                 const result = await this.callAndTrace('message.send', params);
                 logger.info(`${this.logPrefix()} message.send (${payload.type}) ok: to=${this.peerLabel(targetAid)} mid=${result?.message_id} encrypt=${encrypt}`);
+                this.forwardOutbound(targetAid, finalPayload);
                 return result?.message_id ?? null;
             }
         }
@@ -2233,6 +2275,7 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
                 }
             }
             logger.info(`${this.logPrefix()} File sent: ${filename} (${formatSize(stat.size)}) → ${channelId}`);
+            this.forwardOutbound(channelId, filePayload);
             return true;
         }
         catch (e) {
@@ -2348,6 +2391,7 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
         };
         const method = isGroup ? 'group.send' : 'message.send';
         sendOne(method, statusPayload, 'status');
+        this.forwardOutbound(channelId, statusPayload);
         this.aidStatsCollector?.recordOutbound(this.config.aid, channelId, JSON.stringify(statusPayload).length, undefined, true);
         // 群聊显示 group id 简称，P2P 显示 peer label；从 context.metadata 读取 chatmode
         const targetLabel = this.isGroupId(channelId) ? channelId : this.peerLabel(channelId);
@@ -2545,6 +2589,32 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
         const result = await agentmdSync(aid, { store: this.store ?? undefined });
         return result.content ?? '';
     }
+    /**
+     * 取群显示名（group.get → group.name），进程内缓存。
+     * 走长连接 callAndTrace，失败/未连接返回 undefined —— 绝不抛出阻塞消息处理。
+     */
+    async getGroupName(groupId) {
+        if (!groupId)
+            return undefined;
+        const cached = this.groupNameCache.get(groupId);
+        if (cached !== undefined)
+            return cached || undefined;
+        if (!this.client)
+            return undefined;
+        try {
+            const result = await this.callAndTrace('group.get', { group_id: groupId });
+            const name = result?.group?.name;
+            if (typeof name === 'string' && name) {
+                this.groupNameCache.set(groupId, name);
+                return name;
+            }
+            this.groupNameCache.set(groupId, ''); // 负缓存：避免反复 RPC（空串视为无名）
+            return undefined;
+        }
+        catch {
+            return undefined; // 不写缓存，下次仍可重试
+        }
+    }
 }
 // Plugin implementation
 export class AUNChannelPlugin {
@@ -2709,7 +2779,8 @@ export class AUNChannelPlugin {
                             logger.warn(`[AUN] Unhandled payload kind: ${payload.kind}`);
                     }
                 }, acknowledge: (messageId) => { channel.acknowledge(messageId); return Promise.resolve(); }, onInteraction: (cb) => { channel.interactionCallback = cb; }, uploadAgentMd: (content) => channel.uploadAgentMd(content),
-                downloadAgentMd: (aid) => channel.downloadAgentMd(aid), _selfAid: () => channel.getStatus().aid,
+                downloadAgentMd: (aid) => channel.downloadAgentMd(aid),
+                getGroupName: (groupId) => channel.getGroupName(groupId), _selfAid: () => channel.getStatus().aid,
                 _selfName: () => channel.getSelfName(),
             };
             const policy = {
@@ -2756,24 +2827,7 @@ export class AUNChannelPlugin {
                 onProjectPathRequest: (channelId) => Promise.resolve(config.projects?.defaultPath || process.cwd()),
                 registerBridge(bridge, channelType) {
                     bridge.register(adapter.channelName, (handler) => channel.onMessage(async (opts) => {
-                        handler({
-                            channel: adapter.channelName,
-                            channelType,
-                            channelId: opts.channelId,
-                            selfAID: opts.selfAID,
-                            groupId: opts.groupId,
-                            content: opts.content,
-                            chatType: opts.chatType || 'private',
-                            peerId: opts.peerId || '',
-                            peerName: opts.peerName,
-                            peerType: opts.peerType,
-                            messageId: opts.messageId,
-                            mentions: opts.mentions,
-                            threadId: opts.threadId,
-                            replyContext: opts.replyContext,
-                            source: opts.source,
-                            images: opts.images,
-                        });
+                        handler(aunOptsToInbound(opts, adapter.channelName, channelType));
                     }), (channelId, text, replyContext) => channel.sendMessage(channelId, text, replyContext), adapter, channelType);
                 },
                 registerHooks(ctx) {

package/dist/channels/feishu.js

@@ -1,7 +1,7 @@
 import fs from 'fs';
 import path from 'path';
 import imageType from 'image-type';
-import { sanitizeFileName, saveToUploads, validateImage } from '../utils/media-cache.js';
+import { sanitizeFileName, saveToUploads, bufferToInboundImage } from '../utils/media-cache.js';
 import { logger } from '../utils/logger.js';
 import { hasRichContent, renderAllRichContent, checkDependencies } from '../utils/rich-content-renderer.js';
 import { formatItemsAsText } from '../core/message/items-formatter.js';
@@ -207,7 +207,7 @@ export class FeishuChannel {
                             // 清理残留的 mention 占位符（@_user_N 代表机器人）
                             content = content.replace(/@_user_\d+/g, '').trim();
                             const finalContent = quotedText + content;
-                            await this.messageHandler({ channelId: msg.chat_id, content: finalContent, images: quotedImages.length > 0 ? quotedImages : undefined, peerId, peerName, messageId: msg.message_id, mentions: mentions.length > 0 ? mentions : undefined, threadId, rootId, chatType });
+                            await this.messageHandler({ channelId: msg.chat_id, content: finalContent, images: quotedImages.length > 0 ? quotedImages : undefined, peerId, peerName, messageId: msg.message_id, mentions: mentions.length > 0 ? mentions : undefined, mentionAids: mentions.length > 0 ? mentions.map((m) => m.userId) : undefined, threadId, rootId, chatType });
                         }
                         // 处理图片消息
                         else if (msg.message_type === 'image') {
@@ -789,18 +789,14 @@ export class FeishuChannel {
                     logger.warn('[Feishu] Empty response from image download');
                     return null;
                 }
-                // 统一图片验证（类型白名单 + 大小限制）
-                const result = await validateImage(buffer);
-                if (result.mime === null) {
-                    logger.warn(`[Feishu] Image validation failed: ${result.reason}`);
+                // 统一图片识别 + base64 注入（magic bytes → 元数据 → 后缀）
+                const img = await bufferToInboundImage(buffer);
+                if (!img) {
+                    logger.warn('[Feishu] Image validation failed (not a supported image)');
                     return null;
                 }
-                const base64Data = buffer.toString('base64');
-                logger.debug('[Feishu] Image downloaded successfully, type:', result.mime, 'size:', base64Data.length);
-                return {
-                    data: base64Data,
-                    mimeType: result.mime
-                };
+                logger.debug('[Feishu] Image downloaded successfully, type:', img.mimeType, 'size:', img.data.length);
+                return img;
             }
             logger.error('[Feishu] Image download failed: no valid method');
             return null;
@@ -1523,12 +1519,12 @@ export class FeishuChannelPlugin {
                 disconnect: () => channel.disconnect(),
                 onProjectPathRequest: (channelId) => Promise.resolve(config.projects?.defaultPath || process.cwd()),
                 registerBridge(bridge, channelType) {
-                    bridge.register(adapter.channelName, (handler) => channel.onMessage(async ({ channelId: chatId, content, images, peerId, peerName, messageId, mentions, threadId, rootId, chatType, source }) => {
+                    bridge.register(adapter.channelName, (handler) => channel.onMessage(async ({ channelId: chatId, content, images, peerId, peerName, messageId, mentions, mentionAids, threadId, rootId, chatType, source }) => {
                         await handler({
                             channel: adapter.channelName, channelType, channelId: chatId, content, images,
                             selfAID: inst.agentName,
                             chatType: chatType || 'private',
-                            peerId: peerId || '', peerName, messageId, mentions, threadId,
+                            peerId: peerId || '', peerName, messageId, mentions, mentionAids, threadId,
                             replyContext: threadId ? { replyToMessageId: rootId ?? threadId, replyInThread: true } : undefined,
                             source,
                         });