evolclaw 2.1.2 → 2.2.0

package/dist/core/message-processor.js

@@ -1,80 +1,120 @@
 import path from 'path';
 import fs from 'fs';
+import { hasCompact } from '../agents/claude-runner.js';
 import { StreamFlusher } from '../utils/stream-flusher.js';
 import { StreamIdleMonitor } from '../utils/stream-idle-monitor.js';
 import { logger } from '../utils/logger.js';
 import { getErrorMessage, classifyError, ErrorType } from '../utils/error-utils.js';
-import { isOwner } from '../config.js';
+import { summarizeToolInput } from '../utils/permission-utils.js';
+import { getOwner } from '../config.js';
 /**
  * 统一消息处理器
  * 负责处理来自不同渠道的消息，协调事件流处理
  */
 export class MessageProcessor {
-    agentRunner;
     sessionManager;
     config;
     messageCache;
+    eventBus;
     commandHandler;
     channels = new Map();
     currentFlusher;
-    currentIsGroup = false;
     shouldSuppressActivities = false;
+    agentMap;
+    defaultAgentId;
+    interruptedSessions = new Map(); // sessionId → reason ('new_message' | 'stop' | ...)
+    /** 按 agentId 获取 agent，回退到默认 */
+    getAgent(agentId) {
+        if (agentId && this.agentMap.has(agentId))
+            return this.agentMap.get(agentId);
+        return this.agentMap.get(this.defaultAgentId) || this.agentMap.values().next().value;
+    }
+    /** 获取可用 agent 列表 */
+    getAvailableAgents() {
+        return [...this.agentMap.keys()];
+    }
     /** 判断是否为后台会话（仅主会话参与判断，话题会话独立） */
     async isBackgroundSession(session, channel, channelId) {
-        // 话题会话独立运行，不是后台任务
         if (session.threadId)
             return false;
-        // 主会话：与当前活跃会话比对
         const active = await this.sessionManager.getActiveSession(channel, channelId);
         return active ? session.id !== active.id : false;
     }
-    constructor(agentRunner, sessionManager, config, messageCache, commandHandler) {
-        this.agentRunner = agentRunner;
+    constructor(agentRunnerOrMap, sessionManager, config, messageCache, eventBus, commandHandler, defaultAgentId) {
         this.sessionManager = sessionManager;
         this.config = config;
         this.messageCache = messageCache;
+        this.eventBus = eventBus;
         this.commandHandler = commandHandler;
+        if (agentRunnerOrMap instanceof Map) {
+            this.agentMap = agentRunnerOrMap;
+            this.defaultAgentId = defaultAgentId || 'claude';
+        }
+        else {
+            // 向后兼容：单个 agentRunner
+            this.agentMap = new Map([[agentRunnerOrMap.name, agentRunnerOrMap]]);
+            this.defaultAgentId = agentRunnerOrMap.name;
+        }
+        // 监听中断事件，标记被中断的 session
+        this.eventBus.subscribe('message:interrupted', (event) => {
+            if ('sessionId' in event && event.sessionId) {
+                this.interruptedSessions.set(event.sessionId, event.reason || 'unknown');
+            }
+        });
     }
     /**
      * 注册渠道适配器
      */
-    registerChannel(adapter, options) {
-        this.channels.set(adapter.name, { adapter, options });
+    registerChannel(adapter, policy, options) {
+        this.channels.set(adapter.name, { adapter, options, policy });
+    }
+    /**
+     * 获取渠道适配器
+     */
+    getAdapter(channelName) {
+        return this.channels.get(channelName)?.adapter;
+    }
+    /**
+     * 获取渠道信息（含 policy）
+     */
+    getChannelInfo(channelName) {
+        return this.channels.get(channelName);
     }
     /**
      * 处理 compact 开始事件
      */
-    handleCompactStart() {
-        if (this.currentFlusher && !this.currentIsGroup && !this.shouldSuppressActivities) {
-            this.currentFlusher.addActivity('⏳ 会话压缩中...');
+    handleCompactStart(sessionId) {
+        if (sessionId) {
+            this.eventBus.publish({ type: 'agent:compact-start', sessionId });
+        }
+        if (this.currentFlusher && !this.shouldSuppressActivities) {
+            this.currentFlusher.addActivity('\u23f3 会话压缩中...');
         }
     }
     /**
      * 处理消息（主入口）
      */
     async processMessage(message) {
-        const isGroup = message.isGroup ?? false;
-        this.currentIsGroup = isGroup;
         const idleMs = (this.config.idleMonitor?.timeout ?? 120) * 1000;
-        const streamKey = `${message.channel}-${message.channelId}`;
         const channelInfo = this.channels.get(message.channel);
+        if (!channelInfo) {
+            logger.error(`[MessageProcessor] Unknown channel: ${message.channel}`);
+            return;
+        }
+        const { policy } = channelInfo;
+        // 解析会话（唯一的 getOrCreateSession 调用点）
+        const { session, absoluteProjectPath } = await this.resolveSession(message);
+        const streamKey = session.id;
+        const chatType = message.chatType || 'private';
+        const identityRole = session.identity?.role || 'anonymous';
+        // 按 session.agentId 选择 agent 后端
+        const agent = this.getAgent(session.agentId);
         const monitorEnabled = this.config.idleMonitor?.enabled !== false;
         const safeModeThreshold = this.config.idleMonitor?.safeModeThreshold ?? 3;
-        const isOwnerUser = isOwner(this.config, message.channel, message.userId || '');
-        // 非主人（群聊或单聊）：空闲监控静默/简短
-        const quietMode = isGroup || !isOwnerUser;
+        const showIdleMonitor = policy.showIdleMonitor(chatType, identityRole);
         // 计算是否抑制中间输出（工具活动 + 流式文本）
         const shouldSuppress = () => {
-            const mode = this.config.showActivities ?? 'all';
-            if (mode === 'all')
-                return false;
-            if (mode === 'dm-only')
-                return isGroup;
-            if (mode === 'owner-dm-only')
-                return isGroup || !isOwnerUser;
-            if (mode === 'none')
-                return true;
-            return false;
+            return !policy.showMiddleResult(chatType, identityRole);
         };
         this.shouldSuppressActivities = shouldSuppress();
         let monitor;
@@ -83,47 +123,43 @@ export class MessageProcessor {
         const resetTimer = (eventType, toolName) => {
             monitor?.recordEvent(eventType || 'unknown', toolName);
         };
+        // Cache background status to avoid async call inside setInterval
+        const isBackground = await this.isBackgroundSession(session, message.channel, message.channelId);
         const timeoutPromise = new Promise((_, reject) => {
             rejectFn = reject;
             if (!monitorEnabled)
                 return;
             monitor = new StreamIdleMonitor(idleMs);
-            monitorInterval = setInterval(async () => {
+            monitorInterval = setInterval(() => {
                 // Drain all pending levels in one tick
                 let result = monitor.check();
                 while (result) {
                     if (result.action === 'kill') {
                         logger.warn(`[MessageProcessor] Idle monitor: kill after ${result.idleSec}s idle, stream: ${streamKey}`);
-                        // 先发送诊断信息，让用户知道发生了什么
-                        if (channelInfo) {
-                            try {
-                                const msg = quietMode
-                                    ? `⚠️ 任务超时（${result.idleSec}秒无响应），已自动中断`
-                                    : result.message;
-                                await channelInfo.adapter.sendText(message.channelId, msg);
-                            }
-                            catch (e) {
+                        this.eventBus.publish({ type: 'agent:idle-timeout', sessionId: streamKey, idleSec: result.idleSec });
+                        // 后台任务也需要中断（释放资源），但不发送通知
+                        if (channelInfo && !isBackground) {
+                            const msg = showIdleMonitor
+                                ? result.message
+                                : `\u26a0\ufe0f 任务超时（${result.idleSec}秒无响应），已自动中断`;
+                            channelInfo.adapter.sendText(message.channelId, msg).catch(e => {
                                 logger.debug(`[MessageProcessor] Failed to send kill diagnostic message:`, e);
-                            }
+                            });
                         }
-                        try {
-                            await this.agentRunner.interrupt(streamKey);
-                        }
-                        catch (e) {
+                        agent.interrupt(streamKey).catch(e => {
                             logger.debug(`[MessageProcessor] Interrupt failed (may already be cleaned up):`, e);
-                        }
+                        });
                         rejectFn(new Error('SDK_TIMEOUT'));
                         return;
                     }
                     else {
-                        // notify or warn: send diagnostic message, task continues（非主人时静默）
+                        // notify or warn: send diagnostic message, task continues
                         logger.info(`[MessageProcessor] Idle monitor: ${result.action} after ${result.idleSec}s idle, stream: ${streamKey}`);
-                        if (channelInfo && !quietMode && !shouldSuppress()) {
-                            try {
-                                await channelInfo.adapter.sendText(message.channelId, result.message);
-                            }
-                            catch (e) {
-                                logger.debug(`[MessageProcessor] Failed to send idle monitor message:`, e);
+                        if (channelInfo && showIdleMonitor && !shouldSuppress()) {
+                            if (!isBackground) {
+                                channelInfo.adapter.sendText(message.channelId, result.message).catch(e => {
+                                    logger.debug(`[MessageProcessor] Failed to send idle monitor message:`, e);
+                                });
                             }
                         }
                     }
@@ -133,25 +169,23 @@ export class MessageProcessor {
         });
         try {
             await Promise.race([
-                this._processMessageInternal(message, resetTimer, isGroup, shouldSuppress),
+                this._processMessageInternal(message, session, absoluteProjectPath, resetTimer, shouldSuppress),
                 timeoutPromise
             ]);
         }
         catch (error) {
             // 超时错误：kill 级别已发送诊断信息，无需再发
             // 非超时错误走通用处理
-            // 记录错误到健康状态（仅主人的错误累计触发安全模式）
+            // 记录错误到健康状态（复用已有 session）
             if (channelInfo) {
                 try {
-                    const session = await this.sessionManager.getOrCreateSession(message.channel, message.channelId, this.config.projects?.defaultPath || process.cwd(), message.threadId);
                     const errorType = classifyError(error);
                     // 上下文过长是可恢复错误，不累计触发安全模式
                     if (errorType === ErrorType.CONTEXT_TOO_LONG) {
                         logger.info(`[MessageProcessor] Context too long error, skipping safe mode accumulation`);
                     }
-                    else if (quietMode) {
-                        // 群聊或非主人的错误只记日志，不累计
-                        logger.info(`[MessageProcessor] Non-owner/group error (user=${message.userId}, group=${isGroup}), skipping safe mode accumulation`);
+                    else if (!policy.accumulateErrors(chatType, identityRole)) {
+                        logger.info(`[MessageProcessor] Non-accumulating error (chatType=${chatType}, identity=${identityRole}), skipping safe mode accumulation`);
                     }
                     else {
                         const newCount = await this.sessionManager.recordError(session.id, errorType, error.message);
@@ -169,28 +203,27 @@ export class MessageProcessor {
                 clearInterval(monitorInterval);
         }
     }
-    /** 从 session 提取话题回复选项 */
-    getThreadSendOpts(session) {
-        const rootId = session.metadata?.feishu?.rootId;
-        return rootId ? { replyToMessageId: rootId, replyInThread: true } : undefined;
+    /** 从 session 提取渠道预构建的回复上下文 */
+    getReplyContext(session) {
+        return session.metadata?.replyContext;
     }
     /**
      * 检查是否需要进入安全模式（safeModeThreshold 为 0 时跳过）
-     * 仅单聊主人会话调用（群聊和非主人已在调用侧过滤）
      */
     async checkSafeMode(session, channelId, adapter, safeModeThreshold, consecutiveErrors) {
         if (safeModeThreshold <= 0)
             return;
         const health = await this.sessionManager.getHealthStatus(session.id);
-        const sendOpts = this.getThreadSendOpts(session);
+        const sendOpts = this.getReplyContext(session);
         const isThread = !!session.threadId;
         if (consecutiveErrors >= safeModeThreshold && !health.safeMode) {
             await this.sessionManager.setSafeMode(session.id, true);
             logger.warn(`[MessageProcessor] Session ${session.id} entered safe mode after ${consecutiveErrors} errors`);
+            this.eventBus.publish({ type: 'session:safe-mode-entered', sessionId: session.id, consecutiveErrors });
             const suggestions = isThread
                 ? `1. /repair - 检查并修复会话（推荐，保留历史）\n2. /clear - 清空会话历史\n3. /status - 查看详细状态`
                 : `1. /repair - 检查并修复会话（推荐，保留历史）\n2. /new [名称] - 创建新会话（清空历史）\n3. /status - 查看详细状态`;
-            await adapter.sendText(channelId, `⚠️ 安全模式已启用（连续 ${consecutiveErrors} 次异常）
+            await adapter.sendText(channelId, `\u26a0\ufe0f 安全模式已启用（连续 ${consecutiveErrors} 次异常）
 
 当前限制：
 - 无法记住之前的对话
@@ -200,10 +233,10 @@ export class MessageProcessor {
 ${suggestions}`, sendOpts);
         }
         else if (safeModeThreshold >= 2 && consecutiveErrors === safeModeThreshold - 1) {
-            await adapter.sendText(channelId, `⚠️ 检测到异常（${consecutiveErrors}/${safeModeThreshold}）\n\n如果问题持续，系统将自动进入安全模式。建议使用 /status 查看状态。`, sendOpts);
+            await adapter.sendText(channelId, `\u26a0\ufe0f 检测到异常（${consecutiveErrors}/${safeModeThreshold}）\n\n如果问题持续，系统将自动进入安全模式。建议使用 /status 查看状态。`, sendOpts);
         }
     }
-    async _processMessageInternal(message, resetTimer, isGroup, shouldSuppress) {
+    async _processMessageInternal(message, session, absoluteProjectPath, resetTimer, shouldSuppress) {
         const messageId = `${message.channel}_${message.channelId}_${message.timestamp || Date.now()}`;
         const channelInfo = this.channels.get(message.channel);
         if (!channelInfo) {
@@ -211,21 +244,9 @@ ${suggestions}`, sendOpts);
             return;
         }
         const { adapter, options } = channelInfo;
+        const agent = this.getAgent(session.agentId);
+        const streamKey = session.id;
         try {
-            // 检查是否为命令
-            if (this.commandHandler) {
-                const cmdResult = await this.commandHandler(message.content, message.channel, message.channelId, message.userId, message.threadId);
-                if (cmdResult) {
-                    // 话题消息：通过 rootId 回复到话题内
-                    const session = message.threadId ? await this.sessionManager.getOrCreateSession(message.channel, message.channelId, this.config.projects?.defaultPath || process.cwd(), message.threadId) : undefined;
-                    const rootId = session?.metadata?.feishu?.rootId;
-                    const sendOpts = rootId ? { replyToMessageId: rootId, replyInThread: true } : undefined;
-                    await adapter.sendText(message.channelId, cmdResult, sendOpts);
-                    return;
-                }
-            }
-            // 解析会话和项目路径
-            const { session, absoluteProjectPath } = await this.resolveSession(message);
             const isBackground = await this.isBackgroundSession(session, message.channel, message.channelId);
             // 记录收到消息
             logger.message({
@@ -234,10 +255,20 @@ ${suggestions}`, sendOpts);
                 dir: 'inbound',
                 status: 'received'
             });
+            this.eventBus.publish({
+                type: 'message:received',
+                sessionId: session.id,
+                channel: message.channel,
+                channelId: message.channelId,
+                content: message.content,
+                timestamp: Date.now()
+            });
             const imageInfo = message.images && message.images.length > 0 ? ` [${message.images.length} image(s)]` : '';
-            const modeInfo = isBackground ? ' [后台]' : '';
+            const modeInfo = isBackground ? ' [\u540e\u53f0]' : '';
             logger.info(`[${message.channel}] ${message.channelId}: ${message.content}${imageInfo}${modeInfo}`);
             // 记录开始处理
+            this.eventBus.publish({ type: 'message:processing', sessionId: session.id });
+            adapter.sendProcessingStatus?.(message.channelId, 'start', session.id, this.getReplyContext(session));
             logger.message({
                 msgId: messageId,
                 sessionId: session.id,
@@ -248,18 +279,16 @@ ${suggestions}`, sendOpts);
             // 创建 StreamFlusher，传入文件标记模式用于自动过滤
             // 使用动态判断，确保切换项目后不会继续输出
             let firstReply = true;
-            const messageIsGroup = isGroup; // 捕获 isGroup 供闭包使用
             const flusher = new StreamFlusher(async (text, isFinal) => {
                 const isCurrentlyBackground = await this.isBackgroundSession(session, message.channel, message.channelId);
                 if (!isCurrentlyBackground) {
                     const opts = {};
                     if (isFinal)
-                        opts.title = '最终回复:';
-                    // 话题会话：所有回复指向 rootId + reply_in_thread（确保消息进入话题）
-                    const rootId = session.metadata?.feishu?.rootId;
-                    if (rootId) {
-                        opts.replyToMessageId = rootId;
-                        opts.replyInThread = true;
+                        opts.title = '\u6700\u7ec8\u56de\u590d:';
+                    // 话题会话：使用 Channel 预构建的 replyContext（确保消息进入话题）
+                    const replyCtx = session.metadata?.replyContext;
+                    if (replyCtx) {
+                        Object.assign(opts, replyCtx);
                     }
                     else if (firstReply && message.messageId) {
                         // 主会话：首条消息引用回复用户原消息
@@ -269,28 +298,73 @@ ${suggestions}`, sendOpts);
                     await adapter.sendText(message.channelId, text, Object.keys(opts).length ? opts : undefined);
                 }
                 // 后台任务：静默，不发送输出
-            }, (this.config.flushDelay || 4) * 1000, options?.fileMarkerPattern, this.config.debug?.flusherDiag);
+            }, (options?.flushDelay ?? this.config.flushDelay ?? 3) * 1000, options?.fileMarkerPattern, this.config.debug?.flusherDiag);
             // 保存当前 flusher，用于 compact 事件
             this.currentFlusher = flusher;
             // 调用 AgentRunner（含上下文过长自动 compact 重试）
-            const streamKey = `${message.channel}-${message.channelId}`;
+            // 设置权限审批的消息发送回调（指向当前渠道）
+            agent.setSendPrompt(async (text) => {
+                await adapter.sendText(message.channelId, text, this.getReplyContext(session));
+            });
+            // 设置 per-session 权限模式
+            const permissionMode = session.metadata?.permissionMode || 'default';
+            agent.setMode(permissionMode);
+            // 标记会话为处理中（实时持久化，重启后可恢复）
+            this.sessionManager.markProcessing(session.id);
+            // 检查是否因新消息自动中断 — 包装 prompt 让 Agent 知道上下文
+            const prevInterruptReason = this.interruptedSessions.get(session.id);
+            this.interruptedSessions.delete(session.id);
+            const effectivePrompt = prevInterruptReason === 'new_message' && session.agentSessionId
+                ? `【新消息插入】\n\n${message.content}\n\n【请无视之前中断继续处理】`
+                : message.content;
             try {
-                const stream = await this.agentRunner.runQuery(session.id, message.content, absoluteProjectPath, session.agentSessionId, message.images, options?.systemPromptAppend, this.sessionManager);
-                this.agentRunner.registerStream(streamKey, stream);
-                await this.processEventStream(stream, session, message.channelId, adapter, options, flusher, isBackground, resetTimer, shouldSuppress);
+                // 动态构建运行时上下文提示
+                const contextParts = [];
+                // 1. 当前环境信息
+                const peerLabel = session.identity?.role || 'unknown';
+                const sessionName = session.name || '默认会话';
+                const peerName = message.peerName || session.metadata?.peerName;
+                const envParts = [
+                    `会话通道: ${message.channel}`,
+                    `当前项目: ${path.basename(absoluteProjectPath)}`,
+                ];
+                if (session.name)
+                    envParts.push(`会话名称: ${session.name}`);
+                envParts.push(`对端身份: ${peerLabel}`);
+                if (peerName)
+                    envParts.push(`对端名称: ${peerName}`);
+                contextParts.push(`[当前环境] ${envParts.join(' | ')}`);
+                // 2. 文件发送能力
+                const fileChannels = [...this.channels.entries()]
+                    .filter(([, info]) => info.adapter.sendFile)
+                    .map(([name]) => name);
+                const currentCanSend = fileChannels.includes(message.channel);
+                const crossChannels = fileChannels.filter(n => n !== message.channel);
+                if (currentCanSend || crossChannels.length > 0) {
+                    const hints = [];
+                    if (currentCanSend)
+                        hints.push(`[SEND_FILE:路径] 发送文件到当前通道`);
+                    if (crossChannels.length > 0)
+                        hints.push(`[SEND_FILE:${crossChannels[0]}:路径] 发送文件到指定通道（可用: ${crossChannels.join('/')}）`);
+                    contextParts.push(hints.join('，'));
+                }
+                const effectiveSystemPrompt = [options?.systemPromptAppend, ...contextParts].filter(Boolean).join('\n') || undefined;
+                const stream = await agent.runQuery(session.id, effectivePrompt, absoluteProjectPath, session.agentSessionId, message.images, effectiveSystemPrompt, this.sessionManager);
+                agent.registerStream(streamKey, stream);
+                await this.processEventStream(stream, session, flusher, resetTimer, shouldSuppress);
             }
             catch (error) {
-                if (classifyError(error) === ErrorType.CONTEXT_TOO_LONG && session.agentSessionId) {
+                if (classifyError(error) === ErrorType.CONTEXT_TOO_LONG && session.agentSessionId && hasCompact(agent)) {
                     // 尝试 compact 压缩会话
-                    flusher.addActivity('⚠️ 上下文过长，正在压缩会话...');
+                    flusher.addActivity('\u26a0\ufe0f 上下文过长，正在压缩会话...');
                     await flusher.flush();
-                    const compacted = await this.agentRunner.compactSession(session.id, session.agentSessionId, absoluteProjectPath);
+                    const compacted = await agent.compact(session.id, session.agentSessionId, absoluteProjectPath);
                     if (compacted) {
-                        // compact 成功，带 resume 重试
-                        flusher.addActivity('✅ 压缩完成，正在重试...');
-                        const retryStream = await this.agentRunner.runQuery(session.id, message.content, absoluteProjectPath, session.agentSessionId, message.images, options?.systemPromptAppend, this.sessionManager);
-                        this.agentRunner.registerStream(streamKey, retryStream);
-                        await this.processEventStream(retryStream, session, message.channelId, adapter, options, flusher, isBackground, resetTimer, shouldSuppress);
+                        // compact 成功，带 resume 重试（不重复原始消息，让 Agent 继续未完成的工作）
+                        flusher.addActivity('\u2705 压缩完成，正在重试...');
+                        const retryStream = await agent.runQuery(session.id, '上下文已自动压缩，请继续之前未完成的任务。', absoluteProjectPath, session.agentSessionId, undefined, options?.systemPromptAppend, this.sessionManager);
+                        agent.registerStream(streamKey, retryStream);
+                        await this.processEventStream(retryStream, session, flusher, resetTimer, shouldSuppress);
                     }
                     else {
                         throw new Error('CONTEXT_COMPACT_FAILED');
@@ -300,33 +374,63 @@ ${suggestions}`, sendOpts);
                     throw error;
                 }
             }
-            // 处理文件标记（Feishu 专用）- 提取并发送文件
-            if (options?.fileMarkerPattern && adapter.sendFile) {
-                const fullText = flusher.getFinalText();
-                const fileMatches = [...fullText.matchAll(options.fileMarkerPattern)];
-                for (const match of fileMatches) {
-                    const filePath = match[1].trim();
-                    // 占位符/示例检测：静默跳过，不打扰用户
-                    if (this.isPlaceholderPath(filePath)) {
-                        logger.info(`[${adapter.name}] Skipped placeholder file marker: [SEND_FILE:${filePath}]`);
-                        continue;
-                    }
-                    const resolvedPath = this.resolveFilePath(filePath, absoluteProjectPath);
-                    // 文件存在性检查：真实路径但文件不存在，告知用户
-                    if (!fs.existsSync(resolvedPath)) {
-                        logger.warn(`[${adapter.name}] File not found: ${resolvedPath}`);
-                        await adapter.sendText(message.channelId, `⚠️ 文件未找到: ${filePath}`, this.getThreadSendOpts(session));
+            // 处理文件标记 - 支持 [SEND_FILE:path] 和 [SEND_FILE:channel:path]
+            const FILE_MARKER_RE = /\[SEND_FILE:(?:(\w+):)?([^\]]+)\]/g;
+            const markerPattern = options?.fileMarkerPattern ?? FILE_MARKER_RE;
+            const fullText = flusher.getFinalText();
+            const fileMatches = [...fullText.matchAll(markerPattern)];
+            for (const match of fileMatches) {
+                // 兼容旧格式 (1组) 和新格式 (2组)
+                const hasChannelGroup = match.length >= 3;
+                const targetChannelName = hasChannelGroup ? (match[1] ?? message.channel) : message.channel;
+                const filePath = (hasChannelGroup ? match[2] : match[1]).trim();
+                if (this.isPlaceholderPath(filePath)) {
+                    logger.info(`[${adapter.name}] Skipped placeholder file marker: [SEND_FILE:${filePath}]`);
+                    continue;
+                }
+                // 跨通道仅限 owner
+                if (targetChannelName !== message.channel && session.identity?.role !== 'owner') {
+                    await adapter.sendText(message.channelId, `\u274c 跨通道发送仅限管理员`, this.getReplyContext(session));
+                    continue;
+                }
+                const resolvedPath = this.resolveFilePath(filePath, absoluteProjectPath);
+                if (!fs.existsSync(resolvedPath)) {
+                    logger.warn(`[${adapter.name}] File not found: ${resolvedPath}`);
+                    await adapter.sendText(message.channelId, `\u26a0\ufe0f 文件未找到: ${filePath}`, this.getReplyContext(session));
+                    continue;
+                }
+                // 找目标 adapter
+                const targetInfo = this.channels.get(targetChannelName);
+                if (!targetInfo) {
+                    await adapter.sendText(message.channelId, `\u274c 通道 ${targetChannelName} 未启用或不存在`, this.getReplyContext(session));
+                    continue;
+                }
+                if (!targetInfo.adapter.sendFile) {
+                    await adapter.sendText(message.channelId, `\u274c 通道 ${targetChannelName} 不支持文件发送`, this.getReplyContext(session));
+                    continue;
+                }
+                // 找目标 channelId
+                let targetChannelId = message.channelId;
+                if (targetChannelName !== message.channel) {
+                    const ownerPeerId = getOwner(this.config, targetChannelName);
+                    targetChannelId = ownerPeerId ? (this.sessionManager.getOwnerChatId(targetChannelName, ownerPeerId) ?? '') : '';
+                    if (!targetChannelId) {
+                        await adapter.sendText(message.channelId, `\u274c 未找到 ${targetChannelName} 的私聊会话，请先在该通道发送一条消息`, this.getReplyContext(session));
                         continue;
                     }
-                    logger.info(`[${adapter.name}] Sending file: ${resolvedPath}`);
-                    try {
-                        await adapter.sendFile(message.channelId, resolvedPath);
-                    }
-                    catch (error) {
-                        logger.error(`[${adapter.name}] Failed to send file: ${resolvedPath}`, error);
-                        await adapter.sendText(message.channelId, `❌ 文件发送失败: ${filePath}`, this.getThreadSendOpts(session));
+                }
+                logger.info(`[${adapter.name}] Sending file via ${targetChannelName}: ${resolvedPath}`);
+                try {
+                    await targetInfo.adapter.sendFile(targetChannelId, resolvedPath, this.getReplyContext(session));
+                    this.eventBus.publish({ type: 'agent:file-sent', sessionId: session.id, filePath: resolvedPath, channel: targetChannelName });
+                    if (targetChannelName !== message.channel) {
+                        await adapter.sendText(message.channelId, `\ud83d\udcce 文件已通过 ${targetChannelName} 发送`, this.getReplyContext(session));
                     }
                 }
+                catch (error) {
+                    logger.error(`[${adapter.name}] Failed to send file: ${resolvedPath}`, error);
+                    await adapter.sendText(message.channelId, `\u274c 文件发送失败: ${filePath}`, this.getReplyContext(session));
+                }
             }
             // Flush 剩余内容（文件标记已在 flush 时自动移除）
             await flusher.flush(true);
@@ -334,19 +438,31 @@ ${suggestions}`, sendOpts);
             const healthStatus = await this.sessionManager.getHealthStatus(session.id);
             if (healthStatus.safeMode) {
                 const hint = session.threadId
-                    ? '\n\n⚠️ 当前处于安全模式（无上下文记忆）。使用 /repair 修复 或 /clear 清空会话'
-                    : '\n\n⚠️ 当前处于安全模式（无上下文记忆）。使用 /repair 修复 或 /new 新建会话';
-                await adapter.sendText(message.channelId, hint, this.getThreadSendOpts(session));
+                    ? '\n\n\u26a0\ufe0f 当前处于安全模式（无上下文记忆）。使用 /repair 修复 或 /clear 清空会话'
+                    : '\n\n\u26a0\ufe0f 当前处于安全模式（无上下文记忆）。使用 /repair 修复 或 /new 新建会话';
+                await adapter.sendText(message.channelId, hint, this.getReplyContext(session));
             }
             // 清理 activeStreams（正常完成）
-            this.agentRunner.cleanupStream(streamKey);
-            // 记录成功响应（重置错误计数）
+            agent.cleanupStream(streamKey);
+            // 清除处理中状态 + 记录成功响应
+            this.sessionManager.clearProcessing(session.id);
+            // 注意：不在此处清除 interruptedSessions，由下一条消息的 prompt 包装逻辑消费
+            const interruptReason = this.interruptedSessions.get(session.id);
+            adapter.sendProcessingStatus?.(message.channelId, interruptReason ? 'interrupted' : 'done', session.id, this.getReplyContext(session));
             await this.sessionManager.recordSuccess(session.id);
+            this.eventBus.publish({
+                type: 'message:completed',
+                sessionId: session.id,
+                channel: message.channel,
+                channelId: message.channelId,
+                durationMs: Date.now() - startTime,
+                timestamp: Date.now()
+            });
             const isFinallyBackground = await this.isBackgroundSession(session, message.channel, message.channelId);
             if (isFinallyBackground) {
                 const projectName = path.basename(session.projectPath);
                 const count = this.messageCache.getCount(session.id);
-                await adapter.sendText(message.channelId, `[后台-${projectName}] ✓ 任务完成 (${count}条消息已缓存)`);
+                await adapter.sendText(message.channelId, `[\u540e\u53f0-${projectName}] \u2713 任务完成 (${count}条消息已缓存)`);
             }
             const duration = Date.now() - startTime;
             // 记录处理完成
@@ -366,7 +482,31 @@ ${suggestions}`, sendOpts);
             });
         }
         catch (error) {
+            // 清理流和处理中状态（异常时也要清除）
+            agent.cleanupStream(streamKey);
+            try {
+                this.sessionManager.clearProcessing(session.id);
+            }
+            catch { }
+            // 注意：不在此处清除 interruptedSessions，由下一条消息的 prompt 包装逻辑消费
+            // 区分超时 / 中断 / 错误
+            const errType = classifyError(error);
+            const procStatus = errType === ErrorType.SDK_TIMEOUT ? 'timeout'
+                : errType === ErrorType.STREAM_ERROR ? 'interrupted'
+                    : 'error';
+            try {
+                adapter.sendProcessingStatus?.(message.channelId, procStatus, session.id, this.getReplyContext(session));
+            }
+            catch { }
             logger.error(`[${message.channel}] Error:`, error);
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            const errorType = errType;
+            this.eventBus.publish({
+                type: 'message:error',
+                sessionId: message.channelId,
+                error: errorMsg,
+                errorType: String(errorType)
+            });
             // 记录处理失败
             logger.message({
                 msgId: messageId,
@@ -388,7 +528,7 @@ ${suggestions}`, sendOpts);
                 let sendOpts;
                 try {
                     const session = await this.sessionManager.getOrCreateSession(message.channel, message.channelId, this.config.projects?.defaultPath || process.cwd(), message.threadId);
-                    sendOpts = this.getThreadSendOpts(session);
+                    sendOpts = this.getReplyContext(session);
                 }
                 catch { }
                 await adapter.sendText(message.channelId, userMessage, sendOpts);
@@ -399,131 +539,148 @@ ${suggestions}`, sendOpts);
      * 解析会话和项目路径
      */
     async resolveSession(message) {
-        // 话题会话：传入 rootId metadata（首条消息的 messageId 作为 rootId）
-        const metadata = message.threadId && message.messageId
-            ? { feishu: { rootId: message.messageId } }
+        // 话题会话：使用 Channel 预构建的 replyContext
+        const metadata = message.replyContext
+            ? { replyContext: message.replyContext }
             : undefined;
-        const session = await this.sessionManager.getOrCreateSession(message.channel, message.channelId, this.config.projects?.defaultPath || process.cwd(), message.threadId, metadata);
+        const session = await this.sessionManager.getOrCreateSession(message.channel, message.channelId, this.config.projects?.defaultPath || process.cwd(), message.threadId, metadata, undefined, message.peerId);
         const absoluteProjectPath = path.isAbsolute(session.projectPath)
             ? session.projectPath
             : path.resolve(process.cwd(), session.projectPath);
         return { session, absoluteProjectPath };
     }
     /**
-     * 处理事件流
+     * 处理标准事件流（AgentEvent）
+     *
+     * 此方法只消费标准 AgentEvent 类型，不引用任何 SDK 特有事件。
+     * SDK 事件 → AgentEvent 的转换在 AgentRunner.transformStream() 中完成。
      */
-    async processEventStream(stream, session, channelId, adapter, options, flusher, isBackground, resetTimer, shouldSuppress) {
-        let hasTextDelta = false;
+    async processEventStream(stream, session, flusher, resetTimer, shouldSuppress) {
         let hasReceivedText = false;
-        let lastSessionId;
+        let hasErrorResult = false; // 是否已有 tool_result/error 事件输出过错误
         try {
             for await (const event of stream) {
-                // 每收到事件重置空闲超时，传入事件类型和工具名
-                const toolName = event.type === 'assistant'
-                    ? event.message?.content?.find((c) => c.type === 'tool_use')?.name
-                    : undefined;
+                // 每收到事件重置空闲超时
+                const toolName = event.type === 'tool_use' ? event.name : undefined;
                 resetTimer(event.type, toolName);
-                // 记录所有事件类型（INFO级别，便于诊断）
-                logger.info(`[MessageProcessor] Event: type=${event.type}, subtype=${event.subtype || 'none'}`);
-                // 提取 session_id（只在首次或变化时更新）
-                if (event.session_id && event.session_id !== lastSessionId) {
-                    logger.info(`[MessageProcessor] Extracted session_id: ${event.session_id} for session: ${session.id}`);
-                    this.agentRunner.updateSessionId(session.id, event.session_id);
-                    lastSessionId = event.session_id;
+                // 记录所有事件类型
+                logger.info(`[MessageProcessor] Event: type=${event.type}`);
+                // session_id 已在 AgentRunner.transformStream 中处理，此处仅记录
+                if (event.type === 'session_id') {
+                    logger.info(`[MessageProcessor] Session ID updated: ${event.sessionId} for session: ${session.id}`);
+                    continue;
                 }
                 const isCurrentlyBackground = await this.isBackgroundSession(session, session.channel, session.channelId);
                 // === 前台任务：正常处理所有事件 ===
                 if (!isCurrentlyBackground) {
-                    // 流式文本事件（抑制时跳过，只累积到 allText）
-                    if (event.type === 'text_delta' && event.text) {
-                        hasTextDelta = true;
+                    // 流式文本
+                    if (event.type === 'text') {
                         hasReceivedText = true;
+                        this.eventBus.publish({ type: 'message:text', sessionId: session.id, text: event.text, isFinal: false });
                         if (!shouldSuppress()) {
                             flusher.addText(event.text);
                         }
                     }
-                    // 系统事件：compact_boundary（群聊时静默）
-                    if (event.type === 'system' && event.subtype === 'compact_boundary') {
-                        if (!this.currentIsGroup && !shouldSuppress()) {
-                            const preTokens = event.compact_metadata?.pre_tokens || 0;
-                            flusher.addActivity(`💡 会话压缩完成，继续执行...（压缩前 tokens: ${preTokens}）`);
+                    // compact 完成
+                    if (event.type === 'compact') {
+                        this.eventBus.publish({ type: 'agent:compact-complete', sessionId: session.id, preTokens: event.preTokens });
+                        if (!shouldSuppress()) {
+                            flusher.addActivity(`\ud83d\udca1 会话压缩完成，继续执行...（压缩前 tokens: ${event.preTokens}）`);
                         }
                     }
-                    // 系统事件：task_progress（子任务进度）
-                    if (event.type === 'system' && event.subtype === 'task_progress') {
-                        const tools = event.tool_uses ?? 0;
-                        const duration = event.duration_ms ? `${Math.round(event.duration_ms / 1000)}s` : '';
-                        const summary = event.summary;
-                        const stats = [tools > 0 ? `${tools}次工具调用` : '', duration].filter(Boolean).join(', ');
-                        if (summary && !shouldSuppress()) {
-                            flusher.addActivity(`⏳ 子任务: ${summary}${stats ? ` (${stats})` : ''}`);
+                    // 子任务进度
+                    if (event.type === 'task_progress') {
+                        const tools = event.toolUses ?? 0;
+                        const duration = event.durationMs ? `${Math.round(event.durationMs / 1000)}s` : '';
+                        const stats = [tools > 0 ? `${tools}\u6b21\u5de5\u5177\u8c03\u7528` : '', duration].filter(Boolean).join(', ');
+                        if (event.summary && !shouldSuppress()) {
+                            flusher.addActivity(`\u23f3 \u5b50\u4efb\u52a1: ${event.summary}${stats ? ` (${stats})` : ''}`);
                         }
                         else if (stats && !shouldSuppress()) {
-                            flusher.addActivity(`⏳ 子任务进行中: ${stats}`);
+                            flusher.addActivity(`\u23f3 \u5b50\u4efb\u52a1\u8fdb\u884c\u4e2d: ${stats}`);
                         }
                     }
-                    // Assistant 事件：提取工具调用和文本内容
-                    if (event.type === 'assistant' && event.message?.content) {
-                        for (const content of event.message.content) {
-                            if (content.type === 'tool_use') {
-                                if (!shouldSuppress()) {
-                                    const desc = this.formatToolDescription(content);
-                                    flusher.addActivity(`🔧 ${content.name}${desc ? ': ' + desc : ''}`);
-                                }
-                            }
-                            else if (content.type === 'text' && content.text && !hasTextDelta) {
-                                // 仅在没有 text_delta 事件时从 assistant 事件提取文本，避免重复
-                                hasReceivedText = true;
-                                if (!shouldSuppress()) {
-                                    flusher.addTextBlock(content.text);
-                                }
-                            }
+                    // 工具调用
+                    if (event.type === 'tool_use') {
+                        this.eventBus.publish({
+                            type: 'tool:use',
+                            sessionId: session.id,
+                            toolName: event.name,
+                            input: event.input,
+                            timestamp: Date.now()
+                        });
+                        if (!shouldSuppress()) {
+                            const desc = summarizeToolInput(event.name, event.input || {});
+                            flusher.addActivity(`\ud83d\udd27 ${event.name}${desc ? ': ' + desc : ''}`);
                         }
                     }
-                    // 工具结果事件：显示失败信息（包括权限拒绝、执行失败等所有场景）
+                    // 工具结果
                     if (event.type === 'tool_result') {
-                        logger.debug(`[MessageProcessor] tool_result: is_error=${event.is_error}, error=${event.error}, content=${typeof event.content}`);
-                        if (event.is_error && !shouldSuppress()) {
-                            const toolName = event.tool_name || '工具';
-                            const errorMsg = event.error || (typeof event.content === 'string' ? event.content : JSON.stringify(event.content)) || '执行失败';
-                            flusher.addActivity(`⚠️ ${toolName}: ${errorMsg}`);
+                        logger.debug(`[MessageProcessor] tool_result: name=${event.name}, is_error=${event.isError}`);
+                        this.eventBus.publish({
+                            type: 'tool:result',
+                            sessionId: session.id,
+                            toolName: event.name,
+                            isError: event.isError,
+                            content: event.result,
+                            timestamp: Date.now()
+                        });
+                        if (event.isError && !shouldSuppress()) {
+                            hasErrorResult = true;
+                            let errorMsg = event.error || (typeof event.result === 'string' ? event.result : JSON.stringify(event.result)) || '\u6267\u884c\u5931\u8d25';
+                            // 移除 XML 风格的错误标签
+                            errorMsg = errorMsg.replace(/<tool_use_error>(.*?)<\/tool_use_error>/gs, '$1');
+                            flusher.addActivity(`\u26a0\ufe0f ${event.name || '\u5de5\u5177'}: ${errorMsg}`);
                         }
                     }
-                    // Result 事件：最终输出
-                    if (event.type === 'result' && event.result) {
-                        logger.debug(`[MessageProcessor] result event: hasReceivedText=${hasReceivedText}, shouldSuppress=${shouldSuppress()}, result="${event.result}"`);
-                        if (shouldSuppress()) {
-                            // 抑制模式：直接发送 result（跳过中间输出）
-                            flusher.addText(event.result);
+                    // 运行时错误（Codex: turn.failed / item error）
+                    if (event.type === 'error') {
+                        logger.warn(`[MessageProcessor] error event: ${event.errorType}: ${event.error}`);
+                        if (!hasErrorResult && !shouldSuppress()) {
+                            hasErrorResult = true;
+                            flusher.addActivity(`\u26a0\ufe0f ${event.error}`);
                         }
-                        else if (!hasReceivedText) {
-                            // 非抑制模式 + 无流式文本：使用 result 作为兜底
-                            flusher.addText(event.result);
+                    }
+                    // 完成事件
+                    if (event.type === 'complete') {
+                        logger.debug(`[MessageProcessor] complete event: hasReceivedText=${hasReceivedText}, isError=${event.isError}, shouldSuppress=${shouldSuppress()}`);
+                        // 失败且无前置错误输出：显示 errors 摘要
+                        if (event.isError && !hasErrorResult && !shouldSuppress()) {
+                            const errorSummary = event.errors?.join('; ') || '\u4efb\u52a1\u6267\u884c\u5931\u8d25';
+                            flusher.addActivity(`\u26a0\ufe0f ${errorSummary}`);
+                        }
+                        // 成功结果文本：suppressed 模式下总是添加，否则仅在无流式文本时添加
+                        if (event.result) {
+                            if (shouldSuppress()) {
+                                flusher.addText(event.result);
+                            }
+                            else if (!hasReceivedText) {
+                                flusher.addText(event.result);
+                            }
                         }
-                        // 非抑制模式 + 有流式文本：已通过 text_delta 累积，无需再添加
-                        await flusher.flush(true); // isFinal=true 标记最终输出
+                        await flusher.flush(true);
                     }
                     continue;
                 }
-                // === 后台任务：只处理 result 事件，仅缓存不发送 ===
-                if (event.type !== 'result') {
+                // === 后台任务：只处理 complete 事件，仅缓存不发送 ===
+                if (event.type !== 'complete') {
                     continue;
                 }
                 if (event.subtype === 'success') {
                     this.messageCache.addEvent(session.id, {
                         type: 'completed',
-                        message: event.result,
+                        message: event.result || '',
                         timestamp: Date.now(),
                         metadata: {
-                            duration: event.duration_ms,
-                            cost: event.total_cost_usd
+                            duration: event.durationMs,
+                            cost: event.costUsd
                         }
                     });
                 }
-                else if (event.is_error === true) {
+                else if (event.isError === true) {
                     this.messageCache.addEvent(session.id, {
                         type: 'error',
-                        message: event.errors?.join('\n') || '未知错误',
+                        message: event.errors?.join('\n') || '\u672a\u77e5\u9519\u8bef',
                         timestamp: Date.now(),
                         metadata: {
                             errorType: event.subtype
@@ -533,27 +690,13 @@ ${suggestions}`, sendOpts);
             }
         }
         catch (error) {
-            // 捕获 SDK 进程崩溃或流迭代错误
             logger.error('[MessageProcessor] Stream processing error:', error);
             if (error instanceof Error && error.message.includes('process exited')) {
-                flusher.addActivity('❌ Claude Code 进程异常退出，请重试');
+                flusher.addActivity('\u274c Claude Code \u8fdb\u7a0b\u5f02\u5e38\u9000\u51fa\uff0c\u8bf7\u91cd\u8bd5');
             }
-            throw error; // 重新抛出，让外层处理
+            throw error;
         }
     }
-    /**
-     * 格式化工具描述（通用）
-     */
-    formatToolDescription(toolUse) {
-        const input = toolUse.input || {};
-        return (input.description ||
-            input.file_path ||
-            input.pattern ||
-            (typeof input.command === 'string' ? input.command.substring(0, 80) : undefined) ||
-            (typeof input.prompt === 'string' ? input.prompt.substring(0, 80) : undefined) ||
-            (typeof input.query === 'string' ? input.query.substring(0, 80) : undefined) ||
-            '');
-    }
     /**
      * 解析文件路径，支持相对路径和绝对路径
      * 优先在项目根目录查找，兜底尝试 .openclaw/workspace/
@@ -583,18 +726,18 @@ ${suggestions}`, sendOpts);
         if (!filePath)
             return true;
         // 精确占位符
-        const exactPlaceholders = ['...', '…', 'path', 'file', 'file_path', 'filepath',
-            '路径', '文件路径', '文件', 'filename', 'xxx'];
+        const exactPlaceholders = ['...', '\u2026', 'path', 'file', 'file_path', 'filepath',
+            '\u8def\u5f84', '\u6587\u4ef6\u8def\u5f84', '\u6587\u4ef6', 'filename', 'xxx'];
         if (exactPlaceholders.includes(filePath.toLowerCase()))
             return true;
         // 示例路径前缀
-        if (/^(\/path\/to\/|\.\/path\/to\/|example\/|示例|\/example)/i.test(filePath))
+        if (/^(\/path\/to\/|\.\/path\/to\/|example\/|\u793a\u4f8b|\/example)/i.test(filePath))
             return true;
         // 含模板变量
         if (/\$\{.+\}|\{\{.+\}\}|<.+>/.test(filePath))
             return true;
         // 纯标点/特殊字符（非路径字符）
-        if (/^[.\s…]+$/.test(filePath))
+        if (/^[.\s\u2026]+$/.test(filePath))
             return true;
         // 含正则/代码特殊字符（Agent 在说明中引用了代码或正则表达式）
         if (/[\\[\]{}*+?|^$]/.test(filePath))