evolclaw 3.1.11 → 3.2.0

package/dist/channels/aun.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) });
@@ -968,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;
@@ -1056,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')
@@ -1216,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,
@@ -1231,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,
         });
@@ -1301,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,
@@ -1340,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}`));
         }
     }
@@ -1820,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 {
@@ -1839,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;
@@ -1862,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);
@@ -1870,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;
                 }
@@ -1965,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');
@@ -1976,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');
@@ -2012,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;
             }
         }
@@ -2187,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) {
@@ -2302,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);
@@ -2499,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 {
@@ -2663,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 = {
@@ -2710,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

@@ -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') {
@@ -1519,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,
                         });

package/dist/cli/agent.js

@@ -450,26 +450,32 @@ export async function agentCreateInteractive(opts = {}) {
 export async function agentCreateNonInteractive(opts) {
     const p = resolvePaths();
     const { isValidAid, aidCreate } = await import('../aun/aid/index.js');
+    opts.onPhase?.('validating', 'begin');
+    /** 校验失败：透出 failed 进度并返回原结构（控制流不变）。 */
+    const failValidating = (error) => {
+        opts.onPhase?.('validating', 'failed', error);
+        return { ok: false, error };
+    };
     if (!isValidAid(opts.aid)) {
-        return { ok: false, error: `Invalid AID "${opts.aid}": must be a valid multi-level domain (e.g. mybot.agentid.pub)` };
+        return failValidating(`Invalid AID "${opts.aid}": must be a valid multi-level domain (e.g. mybot.agentid.pub)`);
     }
     const agentDirPath = path.join(p.agentsDir, opts.aid);
     const configExists = fs.existsSync(path.join(agentDirPath, 'config.json'));
     if (configExists && !opts.force) {
-        return { ok: false, error: `Agent "${opts.aid}" already exists: ${agentDirPath}/config.json (use --force to overwrite)` };
+        return failValidating(`Agent "${opts.aid}" already exists: ${agentDirPath}/config.json (use --force to overwrite)`);
     }
     // Baseagent
     const available = detectAvailableBaseagents();
     if (available.length === 0) {
-        return { ok: false, error: `No usable baseagent detected. Install claude/gemini CLI or optional dependency @openai/codex-sdk.` };
+        return failValidating(`No usable baseagent detected. Install claude/gemini CLI or optional dependency @openai/codex-sdk.`);
     }
     let baseagent;
     if (opts.baseagent) {
         if (!BASEAGENT_CANDIDATES.includes(opts.baseagent)) {
-            return { ok: false, error: `Invalid baseagent: ${opts.baseagent} (options: ${BASEAGENT_CANDIDATES.join('/')})` };
+            return failValidating(`Invalid baseagent: ${opts.baseagent} (options: ${BASEAGENT_CANDIDATES.join('/')})`);
         }
         if (!available.includes(opts.baseagent)) {
-            return { ok: false, error: `${opts.baseagent} is not available in the current environment (available: ${available.join('/')})` };
+            return failValidating(`${opts.baseagent} is not available in the current environment (available: ${available.join('/')})`);
         }
         baseagent = opts.baseagent;
     }
@@ -477,20 +483,22 @@ export async function agentCreateNonInteractive(opts) {
         baseagent = pickDefaultBaseagent(available);
     }
     if (!path.isAbsolute(opts.project)) {
-        return { ok: false, error: `--project must be absolute: ${opts.project}` };
+        return failValidating(`--project must be absolute: ${opts.project}`);
     }
     if (!fs.existsSync(opts.project)) {
         try {
             fs.mkdirSync(opts.project, { recursive: true });
         }
         catch (e) {
-            return { ok: false, error: `Failed to create ${opts.project}: ${e?.message || e}` };
+            return failValidating(`Failed to create ${opts.project}: ${e?.message || e}`);
         }
     }
     if (opts.owner && !isValidAid(opts.owner)) {
-        return { ok: false, error: `Invalid owner: ${opts.owner}` };
+        return failValidating(`Invalid owner: ${opts.owner}`);
     }
+    opts.onPhase?.('validating', 'done');
     // Register AID
+    opts.onPhase?.('registering_aid', 'begin');
     let aidCreated = false;
     try {
         const result = await aidCreate(opts.aid);
@@ -499,9 +507,12 @@ export async function agentCreateNonInteractive(opts) {
         }
         catch { /* ignore */ }
         aidCreated = !result.alreadyExisted;
+        opts.onPhase?.('registering_aid', 'done', aidCreated ? 'created' : 'existed');
     }
     catch (e) {
-        return { ok: false, error: `AID creation failed: ${e?.message || e}` };
+        const error = `AID creation failed: ${e?.message || e}`;
+        opts.onPhase?.('registering_aid', 'failed', error);
+        return { ok: false, error };
     }
     // Force 模式下若 agent 已存在且已 initialized，保留该状态（避免重复发欢迎）
     let preservedInitialized = false;
@@ -526,9 +537,12 @@ export async function agentCreateNonInteractive(opts) {
         chatmode: { ...DEFAULT_CHATMODE },
         dispatch: DEFAULT_DISPATCH,
     };
+    opts.onPhase?.('config_saved', 'begin');
     saveAgent(agentConfig);
     ensureAgentDirSkeleton(opts.aid);
+    opts.onPhase?.('config_saved', 'done');
     // Generate and upload agent.md
+    opts.onPhase?.('uploading_agentmd', 'begin');
     let agentmdUploaded = false;
     try {
         const { buildInitialAgentMd, agentmdPut } = await import('../aun/aid/index.js');
@@ -550,6 +564,7 @@ export async function agentCreateNonInteractive(opts) {
                     await new Promise(r => setTimeout(r, RETRY_DELAY_MS));
                 await agentmdPut(content, { aid: opts.aid, aunPath });
                 agentmdUploaded = true;
+                opts.onPhase?.('uploading_agentmd', 'done');
                 break;
             }
             catch (e) {
@@ -559,11 +574,13 @@ export async function agentCreateNonInteractive(opts) {
         if (!agentmdUploaded) {
             console.warn(`⚠ agent.md upload failed: ${lastError?.message || lastError}`);
             console.warn(`  Retry later with: evolclaw aid agentmd put ${opts.aid}`);
+            opts.onPhase?.('uploading_agentmd', 'warn', `upload failed: ${lastError?.message || lastError}`);
         }
         await new Promise(r => setTimeout(r, 0));
     }
     catch (e) {
         console.warn(`⚠ agent.md generation failed: ${e?.message || e}`);
+        opts.onPhase?.('uploading_agentmd', 'warn', `generation failed: ${e?.message || e}`);
     }
     // Attempt hot-load via IPC (if daemon is running).
     // Cold-starting a new agent (connecting AUN WebSocket) routinely takes
@@ -571,16 +588,24 @@ export async function agentCreateNonInteractive(opts) {
     // report while the daemon actually finishes bringing the agent online.
     let hotLoaded = false;
     let hotLoadError;
+    opts.onPhase?.('hot_loading', 'begin');
     try {
         const ipcResult = await ipcQuery(p.socket, { type: 'evolagent.load', aid: opts.aid }, 30_000);
         if (ipcResult?.ok) {
             hotLoaded = true;
+            opts.onPhase?.('hot_loading', 'done');
         }
         else if (ipcResult) {
             hotLoadError = ipcResult.error;
+            opts.onPhase?.('hot_loading', 'warn', hotLoadError);
+        }
+        else {
+            opts.onPhase?.('hot_loading', 'warn', 'daemon not running');
         }
     }
-    catch { /* daemon not running */ }
+    catch {
+        opts.onPhase?.('hot_loading', 'warn', 'daemon not running'); /* daemon not running */
+    }
     return {
         ok: true,
         aid: opts.aid,
@@ -858,6 +883,9 @@ export async function agentDelete(aid, purge = false) {
     }
     else {
         fs.unlinkSync(configPath);
+        // 清理构建进度文件（非 purge 删除只移除 config.json，需显式清理 create-status.json）
+        const { removeCreateStatus } = await import('../core/message/create-status.js');
+        removeCreateStatus(agentDir);
     }
     // Trigger resync so daemon drops the agent
     try {