koishi-plugin-kkk 3.3.2 → 3.3.3

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # 更新日志
 
+## 3.3.3
+
+### 同一条卡片消息不再解析两遍
+
+- **卡片消息被重复投递时只处理第一遍**：QQ 会把同一次发送投递多遍（客户端重发、指令按钮 = 消息 + 交互事件），实测同一条 B站卡片会在几秒内进来两次 —— 于是 OCR + 搜索各跑两遍、面板也可能发两条，看起来就是「解析完了又解析一遍」。现在卡片这条链路在 OCR **之前**就去重（按「平台 + 频道 + 用户 + 卡片正文」），并且**先把图片链接的签名参数去掉再比**：同一条卡片重投时链接会重新签名，直接拿原文比会当成两条不同的消息。
+- 顺带加了排查用的 debug 日志：收到卡片时会打 `收到卡片消息（messageId=…，平台=…）`，同一条卡片的两次投递 messageId 是否相同，一眼就能看出是平台重复投递还是别的插件又发了一遍。
+
 ## 3.3.2
 
 > 修 3.3.1 的一个**致命笔误**：播放器模块里一行 import 多写了一层 `..`，导致插件在**加载时**就失败（`Cannot find module '../../compat/runtime'`），整个插件都起不来。构建链路只做转译不解析路径，所以当时没拦住 —— 现在补了一个「每个编译产物都 require 得动」的自测（scripts/smoke-require.cjs）。

package/lib/index.js

@@ -706,6 +706,33 @@ function registerCommands(ctx, logger, autoParse) {
                     logger.debug('卡片来源不是 B站（%s），跳过卡片解析', cardPlatform || '未知');
                     return next();
                 }
+                /**
+                 * **同一条卡片消息被投递多遍时，只处理第一遍**。
+                 *
+                 * 线上实测：同一条 B站卡片会在几秒内进来两次（平台重投 / 另一个中间件再发一遍），
+                 * 于是 OCR + 搜索各跑两遍、面板也可能发两条 —— 用户看到的就是「解析完了又解析一遍」。
+                 *
+                 * 去重键里的卡片正文要**先去掉 URL 的签名参数**：同一条卡片重投时图片链接会被重新签名，
+                 * 直接拿原文哈希会认为是两条不同的消息（踩过这个坑，第二次照样 OCR）。
+                 */
+                const cardSignature = raw
+                    .replace(/https?:\/\/[^\s"'<>]+/g, (url) => url.split("?")[0])
+                    .replace(/\s+/g, " ")
+                    .trim()
+                    .slice(0, 2000);
+                /**
+                 * 打一条「收到卡片」的日志（debug 级，排查重复投递用）。
+                 *
+                 * 同一条卡片连着来两次、而 **messageId 也相同** → 这条事件被重复投递/重复处理；
+                 * messageId 不同 → 平台那边确实又发了一条。排查「到底谁重复了」就看它。
+                 */
+                logger.debug('收到卡片消息（messageId=%s，平台=%s）', String(session.messageId ?? '无'), String(session.platform ?? '未知'));
+                const { acquireParseLock } = await Promise.resolve().then(() => __importStar(require("./karin/module/utils/ParseLock")));
+                const cardKey = ["card", String(session.platform ?? ""), String(session.channelId ?? ""), String(session.userId ?? ""), cardSignature].join(":");
+                if (!acquireParseLock(cardKey)) {
+                    logger.debug("短时间内重复的同一条卡片消息，已忽略（不再重复 OCR/搜索）: %s", cardKey.slice(0, 120));
+                    return;
+                }
                 const send = async (content) => {
                     try {
                         await session.send(content);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-kkk",
-  "version": "3.3.2",
+  "version": "3.3.3",
   "description": "抖音 / B站 / 快手 / 小红书 视频解析与动态推送，带 QQ 交互面板与弹幕烧录（karin-plugin-kkk 的 Koishi 移植版）",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",

package/src/index.ts

@@ -708,6 +708,35 @@ function registerCommands (
           logger.debug('卡片来源不是 B站（%s），跳过卡片解析', cardPlatform || '未知')
           return next()
         }
+        /**
+         * **同一条卡片消息被投递多遍时，只处理第一遍**。
+         *
+         * 线上实测：同一条 B站卡片会在几秒内进来两次（平台重投 / 另一个中间件再发一遍），
+         * 于是 OCR + 搜索各跑两遍、面板也可能发两条 —— 用户看到的就是「解析完了又解析一遍」。
+         *
+         * 去重键里的卡片正文要**先去掉 URL 的签名参数**：同一条卡片重投时图片链接会被重新签名，
+         * 直接拿原文哈希会认为是两条不同的消息（踩过这个坑，第二次照样 OCR）。
+         */
+        const cardSignature = raw
+          .replace(/https?:\/\/[^\s"'<>]+/g, (url: string) => url.split("?")[0])
+          .replace(/\s+/g, " ")
+          .trim()
+          .slice(0, 2000)
+        /**
+         * 打一条「收到卡片」的日志（debug 级，排查重复投递用）。
+         *
+         * 同一条卡片连着来两次、而 **messageId 也相同** → 这条事件被重复投递/重复处理；
+         * messageId 不同 → 平台那边确实又发了一条。排查「到底谁重复了」就看它。
+         */
+        logger.debug('收到卡片消息（messageId=%s，平台=%s）',
+          String((session as any).messageId ?? '无'),
+          String((session as any).platform ?? '未知'))
+        const { acquireParseLock } = await import("./karin/module/utils/ParseLock")
+        const cardKey = ["card", String((session as any).platform ?? ""), String((session as any).channelId ?? ""), String((session as any).userId ?? ""), cardSignature].join(":")
+        if (!acquireParseLock(cardKey)) {
+          logger.debug("短时间内重复的同一条卡片消息，已忽略（不再重复 OCR/搜索）: %s", cardKey.slice(0, 120))
+          return
+        }
         const send = async (content: any) => {
           try {
             await (session as any).send(content)