lightclawbot 1.2.6 → 1.2.8

package/dist/src/socket/events/message-private.js

@@ -0,0 +1,82 @@
+/**
+ * 私信消息处理器（message:private）
+ *
+ * 职责：对消息做多层过滤，将合法消息放入处理队列
+ */
+import { CHANNEL_KEY, EVENT_MESSAGE_PRIVATE, KIND_FILE_DOWNLOAD, FILE_DOWNLOAD_STATUS } from '../../config.js';
+import { isDuplicate } from '../../dedup.js';
+import { isGroupMessage, extractChatId, recordSessionInHistory } from '../utils/message.js';
+import { handleFileDownloadReq } from './file-download.js';
+import { getModuleLogger } from '../../utils/logger.js';
+const log = getModuleLogger('socket.message-private');
+/** 生成私聊消息去重 key */
+const dedupKey = (msgId) => `private:${msgId}`;
+/** 判断消息是否包含有效内容（文字或附件） */
+function hasValidPayload(data) {
+    return !!(data.content?.trim() || (data.files && data.files.length > 0));
+}
+/** 处理私聊文本消息（非群聊分支） */
+function handlePrivateTextMessage(data, deps) {
+    const { account, handleMessage } = deps;
+    const chatId = extractChatId(data);
+    handleMessage({
+        senderId: data.from,
+        text: data.content || '',
+        messageId: data.msgId,
+        files: data.files ?? [],
+        timestamp: data.timestamp,
+        agentId: data.agentId,
+        chatId,
+    });
+    // 异步登记 sessionId 到历史记录
+    setImmediate(() => {
+        try {
+            recordSessionInHistory({
+                userId: data.from,
+                agentId: data.agentId,
+                chatId,
+                accountId: account.accountId,
+            });
+        }
+        catch (err) {
+            log.warn(`[${CHANNEL_KEY}] recordSessionInHistory 失败: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    });
+}
+/** 注册 message:private 事件监听 */
+export function bindMessagePrivateHandler(socket, deps) {
+    const { botClientId, onEvent, reliableEmitter, account, handleGroupMessage } = deps;
+    socket.on(EVENT_MESSAGE_PRIVATE, (data, ack) => {
+        ack?.();
+        // ① 回环防御：过滤 bot 自身发出的消息
+        if (data.from === botClientId)
+            return;
+        // ② 文件下载信令分发（独立链路，不入 AI 处理队列）
+        if (data.kind === KIND_FILE_DOWNLOAD) {
+            const status = data.extra?.transferData?.status;
+            if (status === FILE_DOWNLOAD_STATUS.REQ && !isDuplicate(dedupKey(data.msgId))) {
+                onEvent?.();
+                void handleFileDownloadReq(data, botClientId, reliableEmitter, account);
+            }
+            return;
+        }
+        // ③ 跳过非文本控制消息
+        if (data.kind && data.kind !== 'text')
+            return;
+        // ④ 内容校验 + 去重
+        if (!hasValidPayload(data))
+            return;
+        if (isDuplicate(dedupKey(data.msgId)))
+            return;
+        onEvent?.();
+        // ⑤ 群聊/私聊分流
+        if (isGroupMessage(data)) {
+            handleGroupMessage(data);
+            log.info(`[${CHANNEL_KEY}] 处理群聊消息: groupId=${data?.extra?.groupId}, from=${data.from}, content="${(data.content || '').slice(0, 60)}", files=${data.files?.length ?? 0}`);
+        }
+        else {
+            log.info(`[${CHANNEL_KEY}] 处理私聊消息: agent=${data.agentId}, from=${data.from}, content="${(data.content || '').slice(0, 60)}", files=${data.files?.length ?? 0}`);
+            handlePrivateTextMessage(data, deps);
+        }
+    });
+}