@wu529778790/open-im 1.11.1-beta.19 → 1.11.1-beta.20

package/dist/clawbot/event-handler.js

@@ -72,6 +72,7 @@ export function setupClawbotHandlers(config, sessionManager) {
             userId,
             chatId,
             text: enrichedText,
+            msgId,
             ctx,
             handleAIRequest,
             sendTextReply: (c, t) => sendTextReply(c, t),

package/dist/platform/handle-text-flow.d.ts

@@ -38,6 +38,8 @@ export interface HandleTextFlowParams {
     chatId: string;
     /** The trimmed text content of the message. */
     text: string;
+    /** Optional message ID for deduplication. */
+    msgId?: string;
     /** The platform event context (accessControl, commandHandler, requestQueue, etc.). */
     ctx: PlatformEventContext;
     /** The platform-specific AI request handler (from createPlatformAIRequestHandler). */

package/dist/platform/handle-text-flow.js

@@ -19,6 +19,27 @@ import { setActiveChatId } from '../shared/active-chats.js';
 import { setChatUser } from '../shared/chat-user-map.js';
 import { createLogger, auditLog } from '../logger.js';
 import { handleEnqueueResult, DEFAULT_QUEUE_FULL_MESSAGE, DEFAULT_QUEUED_MESSAGE } from '../shared/utils.js';
+import { walWrite, walCommit } from '../shared/message-wal.js';
+/* ── 幂等性：消息去重 ── */
+const DEDUP_TTL_MS = 60_000; // 1 分钟内的相同 msgId 视为重复
+const dedupCache = new Map(); // msgId → timestamp
+function isDuplicate(msgId) {
+    if (!msgId)
+        return false;
+    const now = Date.now();
+    const prev = dedupCache.get(msgId);
+    if (prev && now - prev < DEDUP_TTL_MS)
+        return true;
+    dedupCache.set(msgId, now);
+    // 清理过期条目
+    if (dedupCache.size > 1000) {
+        for (const [k, v] of dedupCache) {
+            if (now - v > DEDUP_TTL_MS)
+                dedupCache.delete(k);
+        }
+    }
+    return false;
+}
 const log = createLogger('TextFlow');
 /** Default access-denied message. */
 function defaultAccessDeniedMessage(userId) {
@@ -38,13 +59,21 @@ function defaultAccessDeniedMessage(userId) {
  * @returns true if the message was processed (handled or enqueued), false if denied.
  */
 export async function handleTextFlow(params) {
-    const { platform, userId, chatId, text, ctx, handleAIRequest, sendTextReply, workDir: workDirOverride, convId: convIdOverride, replyToMessageId, accessDeniedMessage = defaultAccessDeniedMessage, queueFullMessage = DEFAULT_QUEUE_FULL_MESSAGE, queuedMessage = DEFAULT_QUEUED_MESSAGE, customEnqueue, } = params;
+    const { platform, userId, chatId, text, msgId, ctx, handleAIRequest, sendTextReply, workDir: workDirOverride, convId: convIdOverride, replyToMessageId, accessDeniedMessage = defaultAccessDeniedMessage, queueFullMessage = DEFAULT_QUEUE_FULL_MESSAGE, queuedMessage = DEFAULT_QUEUED_MESSAGE, customEnqueue, } = params;
     // 1. Access control check
     if (!ctx.accessControl.isAllowed(userId)) {
         log.info(`[${platform}] Access denied for user: ${userId}`);
         await sendTextReply(chatId, accessDeniedMessage(userId));
         return false;
     }
+    // 1b. Deduplication check
+    if (isDuplicate(msgId)) {
+        log.info(`[${platform}] Duplicate message ignored: msgId=${msgId}`);
+        return true;
+    }
+    // 1c. WAL: persist message before processing
+    const walMsgId = msgId || `${platform}:${userId}:${Date.now()}`;
+    walWrite({ msgId: walMsgId, platform, userId, chatId, text: text.substring(0, 500), timestamp: Date.now() });
     // 2. Set active chat ID
     setActiveChatId(platform, chatId);
     // 3. Set chat-user mapping
@@ -69,6 +98,7 @@ export async function handleTextFlow(params) {
         };
         const handled = await ctx.commandHandler.dispatch(text, chatId, userId, platform, dispatchHandler, commandSender);
         if (handled) {
+            walCommit(walMsgId);
             return true;
         }
     }
@@ -105,5 +135,6 @@ export async function handleTextFlow(params) {
         });
         await handleEnqueueResult(enqueueResult, (text) => sendTextReply(chatId, text), { queueFull: queueFullMessage, queued: queuedMessage });
     }
+    walCommit(walMsgId);
     return true;
 }

package/dist/shared/message-wal.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Message WAL (Write-Ahead Log) — 消息持久化
+ *
+ * 进程崩溃时保留未处理的消息，重启后可重放。
+ * 实现：JSONL 文件，每条消息一行。
+ */
+export interface WALEntry {
+    msgId: string;
+    platform: string;
+    userId: string;
+    chatId: string;
+    text: string;
+    timestamp: number;
+    status: 'pending' | 'done';
+}
+/**
+ * 写入消息到 WAL（处理前调用）
+ */
+export declare function walWrite(entry: Omit<WALEntry, 'status'>): void;
+/**
+ * 标记消息为已处理（处理后调用）
+ */
+export declare function walCommit(msgId: string): void;
+/**
+ * 读取所有未处理的消息（重启时调用）
+ */
+export declare function walReadPending(): WALEntry[];
+/**
+ * 清空 WAL 文件（所有消息处理完后调用）
+ */
+export declare function walClear(): void;

package/dist/shared/message-wal.js

@@ -0,0 +1,91 @@
+/**
+ * Message WAL (Write-Ahead Log) — 消息持久化
+ *
+ * 进程崩溃时保留未处理的消息，重启后可重放。
+ * 实现：JSONL 文件，每条消息一行。
+ */
+import { createWriteStream, existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { APP_HOME } from '../constants.js';
+import { createLogger } from '../logger.js';
+const log = createLogger('MessageWAL');
+const WAL_DIR = join(APP_HOME, 'data');
+const WAL_FILE = join(WAL_DIR, 'messages.jsonl');
+let stream = null;
+function ensureDir() {
+    if (!existsSync(WAL_DIR))
+        mkdirSync(WAL_DIR, { recursive: true });
+}
+/**
+ * 写入消息到 WAL（处理前调用）
+ */
+export function walWrite(entry) {
+    try {
+        ensureDir();
+        const line = JSON.stringify({ ...entry, status: 'pending' }) + '\n';
+        if (!stream) {
+            stream = createWriteStream(WAL_FILE, { flags: 'a' });
+        }
+        stream.write(line);
+    }
+    catch (err) {
+        log.warn('WAL write failed:', err);
+    }
+}
+/**
+ * 标记消息为已处理（处理后调用）
+ */
+export function walCommit(msgId) {
+    try {
+        ensureDir();
+        // 读取所有条目，过滤掉已完成的
+        const entries = readAllEntries();
+        const pending = entries.filter(e => !(e.msgId === msgId && e.status === 'pending'));
+        // 重写文件（只保留未完成的）
+        writeFileSync(WAL_FILE, pending.map(e => JSON.stringify(e)).join('\n') + (pending.length ? '\n' : ''), 'utf-8');
+    }
+    catch (err) {
+        log.warn('WAL commit failed:', err);
+    }
+}
+/**
+ * 读取所有未处理的消息（重启时调用）
+ */
+export function walReadPending() {
+    try {
+        ensureDir();
+        const entries = readAllEntries();
+        return entries.filter(e => e.status === 'pending');
+    }
+    catch (err) {
+        log.warn('WAL read failed:', err);
+        return [];
+    }
+}
+/**
+ * 清空 WAL 文件（所有消息处理完后调用）
+ */
+export function walClear() {
+    try {
+        ensureDir();
+        writeFileSync(WAL_FILE, '', 'utf-8');
+    }
+    catch (err) {
+        log.warn('WAL clear failed:', err);
+    }
+}
+function readAllEntries() {
+    if (!existsSync(WAL_FILE))
+        return [];
+    const content = readFileSync(WAL_FILE, 'utf-8').trim();
+    if (!content)
+        return [];
+    return content.split('\n').map(line => {
+        try {
+            return JSON.parse(line);
+        }
+        catch {
+            return null;
+        }
+    }).filter((e) => e !== null);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wu529778790/open-im",
-  "version": "1.11.1-beta.19",
+  "version": "1.11.1-beta.20",
   "description": "Your AI coding assistant, in every chat app. Multi-platform IM bridge for Claude Code, Codex, and CodeBuddy.",
   "type": "module",
   "main": "dist/index.js",