koishi-plugin-kkk 3.3.2 → 3.4.0

package/lib/index.js

@@ -146,67 +146,66 @@ const NATIVE_KEYS = ['masters', 'dataPath', 'debug', 'autoParse', 'webUiAuth'];
  * 一样会把已有值带上，面板里的设置不会被清空。
  */
 const WEBUI_GUIDE = [
-    '**所有设置都在 WebUI 配置面板里改**，地址：/kkk（打开 Koishi 控制台后，左侧边栏也有一个「**kkk 配置**」入口）。',
+    '两种改法都行，改哪边都生效，改完记得点保存。',
     '',
-    '面板里包含：接口库 / 通用（含**错误上报**、在线播放器、合并转发）/ 抖音 / 哔哩哔哩 / 快手 / 小红书 / **QQ 适配器** / 推送列表。' +
-        '改完点右下角保存即可 —— 会写回 koishi.yml 并热重载，**不用重启**。',
+    '一、就在这个页面改：下面的设置项都在，常用的有「是否发解析面板」「画质档体积上限」「超长图自动切片」「在线播放器」「错误上报」等。',
     '',
-    '**Koishi 控制台里的设置项已经全部隐藏**（值仍然保留，在这里点保存也不会把它们弄丢），免得两边各改一半、互相覆盖。',
+    '二、用配置面板改：打开 Koishi 控制台后，左侧边栏有一个「kkk 配置」入口，也可以直接访问 /kkk。',
+    '面板界面更直观，接口库、抖音、哔哩哔哩、快手、小红书、推送列表都在里面，改完点右下角保存，不用重启 Koishi。',
     '',
-    '面板里还有一组「**Koishi 设置**」（数据目录、调试日志、自动解析、面板是否要求先登录控制台）。' +
-        '只有 masters（主人账号）没有面板入口 —— 它属于 Koishi 的权限体系，而面板是免登录页面，' +
-        '需要直接改 koishi.yml 里本插件的配置段（改完重启 Koishi）。'
+    '两边的说明和默认值都是同一份，不会出现「面板里有、控制台里没有」。' +
+        '面板是免登录页面，所以「主人账号」只能在控制台或 koishi.yml 里改。'
 ].join('\n');
 exports.Config = koishi_1.Schema.intersect([
     koishi_1.Schema.object({
         webuiGuide: koishi_1.Schema.const('').description(WEBUI_GUIDE),
-        // 全部隐藏：控制台表单里不显示，配置统一在控制台侧边栏的「kkk 配置」面板里改
-        qq: (0, qqOptions_1.buildQqSchema)(koishi_1.Schema).hidden().description('QQ 适配器（只对 QQ 平台生效）'),
+        /**
+         * 常用设置（面板 / 切片 / 在线播放器 / 错误上报）。
+         *
+         * 这里**不做嵌套分组**：Koishi 的插件配置表单是按 schema 的形状渲染的，
+         * 想在里面再分小节就得把值也改成嵌套结构 —— 而面板（/kkk）写回 koishi.yml 用的是扁平结构，
+         * 两边一旦不一致，控制台一保存就会把这些设置丢回默认值。
+         * 所以保持扁平，靠「字段顺序 + 每条说人话的说明」来保证可读性。
+         */
+        qq: (0, qqOptions_1.buildQqSchema)(koishi_1.Schema).description('常用设置：面板、切片、在线播放器、错误上报'),
         advanced: koishi_1.Schema.object({
-            masters: koishi_1.Schema.array(koishi_1.Schema.string()).default([]).description('主人账号（用户 ID，例如 123456789）：接收报错通知，以及执行只有主人能用的指令'),
-            dataPath: koishi_1.Schema.string().default('data').description('数据目录：配置、数据库、临时文件都放在这里'),
-            debug: koishi_1.Schema.boolean().default(false).description('在日志里输出调试信息，排查问题时才需要打开'),
-            autoParse: koishi_1.Schema.boolean().default(true).description('群里有人发链接（或回复一条带链接的消息）就自动解析，不用打指令'),
-            webUiAuth: koishi_1.Schema.boolean().default(true).description('配置面板 /kkk 是否要求先登录 Koishi 控制台（默认开）。装了 auth 插件的部署只有登录后才能打开面板；没装 auth 插件时本来就没有登录这一说，这里不生效'),
-        }).collapse().hidden().description('Koishi 原生设置（一般不用改，已折叠）'),
-    }).description('配置入口：请在 WebUI 面板（/kkk）里修改'),
+            masters: koishi_1.Schema.array(koishi_1.Schema.string()).default([])
+                .description('主人账号，填用户 ID（不是 QQ 号），例如 123456789。可以收到报错通知，也能执行只有主人能用的指令'),
+            dataPath: koishi_1.Schema.string().default('data')
+                .description('数据目录：配置、数据库、临时文件都放在这里。改完要重启 Koishi'),
+            debug: koishi_1.Schema.boolean().default(false)
+                .description('在日志里输出调试信息。排查问题时才需要打开，平时会很吵'),
+            autoParse: koishi_1.Schema.boolean().default(true)
+                .description('群里有人发链接（或者回复一条带链接的消息）就自动解析，不用打指令'),
+            webUiAuth: koishi_1.Schema.boolean().default(true)
+                .description('配置面板 /kkk 是否要求先登录 Koishi 控制台。装了 auth 插件的部署建议保持打开；没装 auth 插件时本来就没有登录这一步，这里不生效'),
+        }).description('Koishi 原生设置（一般不用改）'),
+    }),
     koishi_1.Schema.object({
         /**
-         * 合并转发（两级开关）。
-         *
-         * 面板（/kkk 的 SPA）是上游打包好的产物，加不了新字段，所以这里单独给一组能在
-         * **控制台**里改的表单：全局开关 + 每个平台各自的开关与「合并哪些内容」。
-         * 值写回 config.json 的对应位置（app.fakeForward / app.forwardContent / <平台>.forward …）。
+         * 合并转发（两级开关）：值写回 config.json 的 app.fakeForward / app.forwardContent / <平台>.forward。
+         * 面板里也有同一组开关（见 scripts/patch-webui.mjs），改哪边都行，两边读的是同一份配置。
          */
         forward: koishi_1.Schema.object({
-            guide: koishi_1.Schema.const('').description('**合并转发**：打开后，一次解析产生的所有内容会等解析全部结束、合并成一条转发发出；' +
-                '关掉就是一边解析一边逐条发。\n\n' +
-                '**全局优先**：上面的「全局」打开 → 所有平台都合并，下面的平台开关不再起作用；' +
-                '全局关着时，才轮到各平台自己的开关。\n\n' +
-                '**默认全部关闭**。\n\n' +
-                '⚠️ 合并转发开着时，视频这类大文件如果塞进转发节点，某些适配器（如 NapCat）会整条拒绝 —— ' +
-                '这时它会自动改成单独发送，不会丢内容。\n\n' +
-                '另外：**markdown 只有 QQ 官方 bot 支持**，OneBot（NapCat / Lagrange 等个人号）不渲染，' +
-                '所以那边图片一律按普通图片段发（切片、图集都是），配置里的 markdown 选项对它没有意义。'),
             global: koishi_1.Schema.boolean().default(false)
-                .description('全局合并转发：打开后所有平台都合并（优先级高于下面的平台开关）'),
+                .description('全局合并转发。打开后所有平台都把一次解析的内容合成一条聊天记录发出；关着时下面各平台的开关才起作用。默认关闭'),
             globalContent: koishi_1.Schema.array(koishi_1.Schema.union(['text', 'image', 'video', 'file'])).default([])
-                .description('全局转发里合并哪些内容：text 文字 / image 图片 / video 视频 / file 文件。留空 = 用默认（text、image）。**语音和 markdown 不在候选里**：QQ 的聊天记录不支持语音气泡，markdown 只有官方 bot 认而官方适配器没有合并转发能力；没列出来的内容单独直发'),
-            douyin: koishi_1.Schema.boolean().default(false).description('抖音：单独打开合并转发（全局关着时生效）'),
+                .description('全局合并转发里放哪些内容：text 文字 / image 图片 / video 视频 / file 文件。没勾的单独直发，留空等于只放文字和图片。视频体积大时有些适配器（比如 NapCat）会拒绝整个聊天记录，这时会自动改成单独发送，不会丢内容'),
+            douyin: koishi_1.Schema.boolean().default(false).description('抖音：单独打开合并转发（全局关着时才起作用）'),
             douyinContent: koishi_1.Schema.array(koishi_1.Schema.union(['text', 'image', 'video', 'file'])).default([])
-                .description('抖音转发合并哪些内容（留空 = 用全局那份）'),
-            bilibili: koishi_1.Schema.boolean().default(false).description('B站：单独打开合并转发（全局关着时生效）'),
+                .description('抖音合并转发里放哪些内容，留空表示用全局那一份'),
+            bilibili: koishi_1.Schema.boolean().default(false).description('B站：单独打开合并转发（全局关着时才起作用）'),
             bilibiliContent: koishi_1.Schema.array(koishi_1.Schema.union(['text', 'image', 'video', 'file'])).default([])
-                .description('B站转发合并哪些内容（留空 = 用全局那份）'),
-            kuaishou: koishi_1.Schema.boolean().default(false).description('快手：单独打开合并转发（全局关着时生效）'),
+                .description('B站合并转发里放哪些内容，留空表示用全局那一份'),
+            kuaishou: koishi_1.Schema.boolean().default(false).description('快手：单独打开合并转发（全局关着时才起作用）'),
             kuaishouContent: koishi_1.Schema.array(koishi_1.Schema.union(['text', 'image', 'video', 'file'])).default([])
-                .description('快手转发合并哪些内容（留空 = 用全局那份）'),
-            xiaohongshu: koishi_1.Schema.boolean().default(false).description('小红书：单独打开合并转发（全局关着时生效）'),
+                .description('快手合并转发里放哪些内容，留空表示用全局那一份'),
+            xiaohongshu: koishi_1.Schema.boolean().default(false).description('小红书：单独打开合并转发（全局关着时才起作用）'),
             xiaohongshuContent: koishi_1.Schema.array(koishi_1.Schema.union(['text', 'image', 'video', 'file'])).default([])
-                .description('小红书转发合并哪些内容（留空 = 用全局那份）')
-        }).collapse().hidden().description('合并转发（全局 + 各平台）'),
-        upstream: (0, schema_1.buildUpstreamSchema)(pluginRootDir).hidden().description('插件自身的配置（与 Karin 版 config.json 一致）。每项都带着上游默认值，枚举型字段是下拉框；' +
-            '**与默认值不同**的项会在启动时写回 config.json，保持默认值的项不写（这样你直接改文件的内容不会被覆盖）')
+                .description('小红书合并转发里放哪些内容，留空表示用全局那一份')
+        }).description('合并转发：把一次解析的内容合成一条聊天记录发出'),
+        upstream: (0, schema_1.buildUpstreamSchema)(pluginRootDir).description('插件配置：接口库（Cookie / 代理 / API 服务）、抖音 / B站 / 快手 / 小红书 的解析与推送、推送订阅列表。'
+            + '每项都带默认值，枚举型是下拉框；和默认值不同的项会写回 config.json，保持默认值的不写（这样你直接改文件的内容不会被覆盖）')
     })
 ]);
 exports.usage = `
@@ -706,6 +705,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/lib/karin/module/utils/ErrorHandler/handler.js

@@ -4,6 +4,8 @@ exports.wrapWithErrorHandler = exports.handleBusinessError = void 0;
 const node_karin_1 = require("../../../../compat/node-karin.js");
 const module_1 = require("../../../module");
 const EmojiReaction_1 = require("../../../module/utils/EmojiReaction");
+// 注意路径只有四层 ..：ErrorHandler → utils → module → karin → src（多一层就指到仓库根了）
+const runtime_1 = require("../../../../compat/runtime");
 const ErrorReport_1 = require("../ErrorReport");
 const ImageSlice_1 = require("../ImageSlice");
 const render_1 = require("./render");
@@ -51,19 +53,37 @@ const handleBusinessError = async (error, options, logs, event) => {
                     return 'handled';
             }
         }
-        let img = await (0, render_1.renderErrorImage)(ctx);
         /**
-         * 错误卡片也会超长（实测 2880×40000 / 45MB），直接发必被 QQ 拒收 ——
-         * 统一切片：官方 QQ 切成一条 markdown，OneBot 切成若干图片段（它不渲染 markdown），
-         * 失败就退回原图。
+         * **「出错只发文字」开关**（面板 通用 → 错误上报 → 出错只发文字，配置项 errorNoCard）。
+         *
+         * 打开后：**不渲染错误卡片**（省掉十几秒渲染 + 一张几 MB 的大图），
+         * 只把「错误报告已上传，ID：xxx / 可以前往 QQ 群内寻找帮助」那几行发出去 —— **上报照旧**。
+         * 传空数组进去就行：下面几个发送函数本来就是「卡片 + 提示文案」拼一起发的（见 sender 的 errorHelpSegments）。
          */
+        let textOnly = false;
         try {
-            const sliced = await (0, ImageSlice_1.sliceImageToElements)(img, (0, ImageSlice_1.platformOf)(event));
-            if (sliced?.length)
-                img = sliced;
+            textOnly = (0, runtime_1.tryGetRuntime)()?.config?.errorNoCard === true;
         }
-        catch (sliceError) {
-            node_karin_1.logger.debug('[ErrorHandler] 错误卡片切片失败，按原图发送: ' + String(sliceError?.message ?? sliceError));
+        catch { /* 读不到配置就按老的来（渲染卡片） */ }
+        let img = [];
+        if (textOnly) {
+            node_karin_1.logger.mark('[ErrorHandler] 配置为「出错只发文字」，跳过错误卡片渲染（错误上报与提示文案照旧）');
+        }
+        else {
+            img = await (0, render_1.renderErrorImage)(ctx);
+            /**
+             * 错误卡片也会超长（实测 2880×40000 / 45MB），直接发必被 QQ 拒收 ——
+             * 统一切片：官方 QQ 切成一条 markdown，OneBot 切成若干图片段（它不渲染 markdown），
+             * 失败就退回原图。
+             */
+            try {
+                const sliced = await (0, ImageSlice_1.sliceImageToElements)(img, (0, ImageSlice_1.platformOf)(event));
+                if (sliced?.length)
+                    img = sliced;
+            }
+            catch (sliceError) {
+                node_karin_1.logger.debug('[ErrorHandler] 错误卡片切片失败，按原图发送: ' + String(sliceError?.message ?? sliceError));
+            }
         }
         await (0, sender_1.sendErrorToTrigger)(ctx, img);
         await (0, sender_1.sendErrorToMaster)(ctx, img);

package/lib/karin/module/utils/ErrorReport.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.errorHelpSegments = exports.uploadErrorReport = exports.groupLinkOf = exports.REPORT_LOG_LINES = exports.REPORT_GROUP = exports.REPORT_TOKEN = exports.REPORT_URL = void 0;
+exports.errorHelpSegments = exports.uploadErrorReport = exports.groupLinkOf = exports.GROUP_INVITE_URL = exports.REPORT_LOG_LINES = exports.REPORT_GROUP = exports.REPORT_TOKEN = exports.REPORT_URL = void 0;
 exports.reportConfig = reportConfig;
 /**
  * 错误上报。
@@ -70,8 +70,15 @@ function reportConfig() {
     }
     return { enabled, url: exports.REPORT_URL, token: exports.REPORT_TOKEN, logLines: exports.REPORT_LOG_LINES, group: exports.REPORT_GROUP };
 }
-/** 反馈群链接：QQ 官方的加群链接格式，面板里只填群号 */
-const groupLinkOf = (group) => 'https://qm.qq.com/q/' + group;
+/**
+ * 反馈群的加群链接。
+ *
+ * ⚠️ **不能拿群号拼**：qm.qq.com/q/ 后面跟的是 QQ 给的**分享码**（一长串字母），
+ * 不是群号 —— 写成 https://qm.qq.com/q/1050229473 点开就是 404（用户实测反馈过）。
+ * 这里写死正确的分享链接；群号仍然照常显示在文案里。
+ */
+exports.GROUP_INVITE_URL = 'https://qm.qq.com/q/viymkIPvvq';
+const groupLinkOf = (_group) => exports.GROUP_INVITE_URL;
 exports.groupLinkOf = groupLinkOf;
 /**
  * 已安装插件清单（名字 + 版本）。

package/lib/karin/module/utils/ImageSlice.js

@@ -255,7 +255,24 @@ const sendSlicedImage = async (e, input) => {
      * 不加超时整条流程就停在这里，用户看到的就是「没反应」。
      */
     const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+    /**
+     * 适配器多久没返回算「卡住」。
+     *
+     * 线上踩坑（用户实测）：一条 3MB 的评论卡走 QQ 官方上传经常要 15~40 秒，
+     * 而老代码 **15 秒就判「发送未成功」** → 去切片再发一遍 → 群里出现两张（第一张其实发出去了），
+     * 日志就是那句「普通发送未成功（发送超过 15s 没有返回），大图不重试，改走切片」。
+     *
+     * 现在拆成三段：
+     *   15 秒 —— 只在日志里提示「还在传，继续等」（不判失败）；
+     *   120 秒 —— 到这里才怀疑它卡住；
+     *   再等 30 秒宽限 —— 等那个迟到的结果，成功了就当成功（不再重复发）。
+     */
+    const SEND_NOTICE_MS = 15000;
+    const SEND_HARD_TIMEOUT_MS = 120000;
+    const SEND_GRACE_MS = 30000;
+    const TIMED_OUT = Symbol('send-timeout');
     const tryNormalSendOnce = async () => {
+        const startedAt = Date.now();
         const sendPromise = (async () => {
             try {
                 const result = await e.reply(node_karin_1.segment.image(source));
@@ -269,13 +286,42 @@ const sendSlicedImage = async (e, input) => {
                 return (0, sendError_1.classifySendFailure)(error);
             }
         })();
-        const timeoutPromise = new Promise((resolve) => {
-            const timer = setTimeout(() => resolve({
-                kind: 'transient', message: '发送超过 15s 没有返回', retryable: true
-            }), 15000);
-            timer.unref?.();
-        });
-        return await Promise.race([sendPromise, timeoutPromise]);
+        const notice = setTimeout(() => {
+            node_karin_1.logger.mark('[图片切片] 适配器还没返回（已 ' + Math.round(SEND_NOTICE_MS / 1000) + 's），继续等 —— 大图上传本来就要几十秒，超时不代表没发出去');
+        }, SEND_NOTICE_MS);
+        notice.unref?.();
+        const raced = await Promise.race([
+            sendPromise,
+            new Promise((resolve) => {
+                const timer = setTimeout(() => resolve(TIMED_OUT), SEND_HARD_TIMEOUT_MS);
+                timer.unref?.();
+            })
+        ]);
+        clearTimeout(notice);
+        if (raced !== TIMED_OUT)
+            return raced;
+        /**
+         * 硬超时后再宽限一会儿：适配器可能只是慢，这一等能把「其实发出去了」的迟到结果等回来，
+         * 避免外层去切片、把同一张图又发一遍。
+         */
+        node_karin_1.logger.mark('[图片切片] 适配器 ' + Math.round(SEND_HARD_TIMEOUT_MS / 1000) + 's 没有返回，再等 ' + Math.round(SEND_GRACE_MS / 1000) + 's 看它是卡住还是在上传');
+        const graced = await Promise.race([
+            sendPromise,
+            new Promise((resolve) => {
+                const timer = setTimeout(() => resolve(TIMED_OUT), SEND_GRACE_MS);
+                timer.unref?.();
+            })
+        ]);
+        if (graced !== TIMED_OUT) {
+            node_karin_1.logger.mark('[图片切片] 那次「超时」的发送其实成功了（适配器 ' + Math.round((Date.now() - startedAt) / 1000) + 's 才返回），不再切片重发');
+            return graced;
+        }
+        // 到这里才真的当作「发不出去」；注意它仍然是**不确定**，不是确定失败，所以不重试
+        return {
+            kind: 'unconfirmed',
+            message: '发送超过 ' + Math.round((SEND_HARD_TIMEOUT_MS + SEND_GRACE_MS) / 1000) + 's 没有返回（适配器可能还卡在上传）',
+            retryable: false
+        };
     };
     /**
      * 带**重试**的普通发送（用户要求）。

package/lib/karin/module/utils/QqPanel.js

@@ -397,6 +397,59 @@ async function recallLastPanel(e) {
         node_karin_1.logger.debug('[QQ面板] 撤回上一条面板失败: ' + String(error));
     }
 }
+/**
+ * ── 「信息卡片」和「markdown 选择表」分开记、分开撤 ───────────────────────
+ *
+ * 用户要求：**卡片不要和「选清晰度 / 选第几集」的 markdown 一起发**，
+ * 分开发并且**只撤回 markdown**（卡片留着给用户看）。
+ *
+ * 所以这里多一份「上一条卡片」的记录：
+ *   - 选清晰度 / 翻页 / 选集时只撤 markdown（原来的 lastPanelMessages）；
+ *   - **只有再发一张新卡片时**才把上一张卡片撤掉（否则番剧翻页几次群里就堆一排卡片）。
+ */
+const lastPanelCards = new Map();
+/** 记住刚刚发出的信息卡片（只在发新卡片时撤回） */
+function rememberPanelCard(e, messageId) {
+    if (!messageId)
+        return;
+    try {
+        const key = String(e.contact?.peer ?? e.channelId ?? '');
+        if (!key)
+            return;
+        lastPanelCards.set(key, { id: String(messageId), at: Date.now() });
+        if (lastPanelCards.size > 128)
+            lastPanelCards.delete(lastPanelCards.keys().next().value);
+    }
+    catch { /* 记不住也不影响功能 */ }
+}
+/** 撤回这个频道上一条「信息卡片」（发新卡片前调用；配置关掉撤回时什么都不做） */
+async function recallLastPanelCard(e) {
+    const runtime = (0, runtime_1.tryGetRuntime)();
+    if (!runtime || runtime.config?.recallPanel === false)
+        return;
+    try {
+        const key = String(e.contact?.peer ?? e.channelId ?? '');
+        const entry = key ? lastPanelCards.get(key) : undefined;
+        if (!entry)
+            return;
+        lastPanelCards.delete(key);
+        if (Date.now() - entry.at > LAST_PANEL_TTL)
+            return;
+        await e.bot?.recallMsg?.(entry.id, key);
+    }
+    catch (error) {
+        node_karin_1.logger.debug('[QQ面板] 撤回上一条卡片失败: ' + String(error));
+    }
+}
+/** 只撤掉某条消息（例如「加载中…」），不动上面两份记录 */
+async function recallMessageById(e, id) {
+    if (!id)
+        return;
+    try {
+        await e.bot?.recallMsg?.(id, String(e.contact?.peer ?? e.channelId ?? ''));
+    }
+    catch { /* 撤不掉就留着 */ }
+}
 /**
  * 面板渲染比较慢（大卡片要十几秒），先回一句「加载中…」再渲染。
  * 返回这条提示的消息 id，渲染完由调用方撤回。
@@ -656,7 +709,21 @@ async function sendBangumiPanelPage(e, episodes, cardData, page = 1) {
         if (!card)
             return false;
         const parseCommand = (0, runtime_1.commandInvocation)('解析');
-        const lines = ['![#' + card.width + 'px #' + card.height + 'px](' + card.url + ')'];
+        /**
+         * **卡片单独发一条**（用户要求：不要和「选第几集」的表格挤在一起），
+         * 并且不记进「上一条面板」—— 翻页 / 选集时只撤表格。
+         * 翻页会重新渲染卡片，所以这里先撤掉上一张卡片，免得翻几次堆一排（见 recallLastPanelCard）。
+         */
+        const lines = [];
+        try {
+            const cardLines = ["![#" + card.width + "px #" + card.height + "px](" + card.url + ")"];
+            await recallLastPanelCard(e);
+            const sentCard = await sendPanelMarkdown(cardLines, (content) => e.reply(content));
+            rememberPanelCard(e, sentCard?.sent?.messageId);
+        }
+        catch (error) {
+            node_karin_1.logger.debug("[QQ面板] 番剧卡片单独发送失败（不影响选集表格）: " + String(error?.message ?? error));
+        }
         /**
          * 一格：纯数字按钮，点下去就是选这一集。
          *
@@ -772,9 +839,26 @@ async function sendQqParsePanel(e, request) {
     // 这一段要拉弹幕 + 渲染卡片（十几秒），先给一句「加载中…」，也顺便撤掉上一条面板
     const loadingId = await showLoadingTip(e);
     const card = await uploadPanelCard(e, request, info.detail, info.hotDanmaku ?? []);
+    /**
+     * **卡片单独发一条**（用户要求：不要和「选清晰度」的 markdown 挤在一条消息里）。
+     *
+     * 而且它**不记进「上一条面板」** —— 下一步选清晰度/翻页时只撤 markdown 那张表，
+     * 卡片留在群里；只有再解析一次（发新卡片）时才会把旧的撤掉（见 rememberPanelCard）。
+     */
+    let cardSent = false;
     if (card && card.url) {
         // QQ markdown 的图片必须写成 ![#宽px #高px](url)
-        lines.push('![#' + (card.width || 1440) + 'px #' + (card.height || 1080) + 'px](' + card.url + ')');
+        const cardLines = ["![#" + (card.width || 1440) + "px #" + (card.height || 1080) + "px](" + card.url + ")"];
+        try {
+            await recallLastPanelCard(e);
+            await recallMessageById(e, loadingId);
+            const sentCard = await sendPanelMarkdown(cardLines, (content) => e.reply(content));
+            rememberPanelCard(e, sentCard?.sent?.messageId);
+            cardSent = true;
+        }
+        catch (error) {
+            node_karin_1.logger.debug("[QQ面板] 信息卡片单独发送失败（不影响选择表）: " + String(error?.message ?? error));
+        }
     }
     // 按钮里只放短令牌，链接存在内存里（见 rememberPanelRequest 的说明）；
     // 顺带把各档体积存进去：解析时能在「收到请求，开始下载」里提示会不会变成文件发送
@@ -933,7 +1017,13 @@ async function sendQqParsePanel(e, request) {
     if (runtime.config.qqPanelSourceLink !== false && request.url)
         lines.push(sourceLink('打开原站', request.url));
     // 带链接发不出去时自动去掉链接行重发（不然整条面板、整个解析都会被一个链接拖死）
-    await sendPanelMarkdown(lines, (content) => replaceLoadingTip(e, loadingId, content));
+    const { sent } = await sendPanelMarkdown(lines, async (content) => {
+        // 卡片已经撤过「加载中…」了；卡片没发出去（或渲染失败）时这里补撤一次
+        if (!cardSent)
+            await recallMessageById(e, loadingId);
+        return await e.reply(content);
+    });
+    rememberPanelMessage(e, sent?.messageId);
     node_karin_1.logger.debug('[QQ面板] 已发送解析面板: ' + request.platform + ' ' + request.id + '（' + shown.length + '/' + info.options.length + ' 档画质）');
     return true;
 }

package/lib/karin/platform/xiaohongshu/xiaohongshu.js

@@ -239,21 +239,66 @@ class Xiaohongshu extends module_1.Base {
                 node_karin_2.logger.warn('[小红书] 发送图文图片失败: ' + String(error?.message ?? error).slice(0, 120));
             }
         }
+        /**
+         * 带「先提示、再宽限」的超时包装（和图片发送那边同一套口径，见 ImageSlice 的 SEND_* 常量）。
+         *
+         * 老写法是「到点就 Promise.race 出 null」—— 很多请求只是**慢**，不是挂了（小红书接口尤其如此），
+         * 早放弃的代价就是「评论区凭空少了内容」。现在分三段：
+         *   noticeMs 只在日志里提示一句「还在拉，继续等」；
+         *   hardMs 才怀疑它挂住；
+         *   graceMs 再等一会儿那个迟到的结果，回来了就当成功。
+         *
+         * @returns 任务结果；真超时返回 null（调用方按「拿不到数据」处理即可）
+         */
+        const withNoticeTimeout = async (label, task, options) => {
+            const timedOut = Symbol("timeout");
+            const startedAt = Date.now();
+            const seconds = (ms) => Math.round(ms / 1000);
+            const notice = setTimeout(() => {
+                node_karin_2.logger.mark("[小红书] " + label + "还在进行（已 " + seconds(options.noticeMs) + "s），继续等 —— 接口只是慢，不代表失败");
+            }, options.noticeMs);
+            notice.unref?.();
+            /** 包一层：任务本身抛错时也要能让 Promise.race 正常结束，错由调用方的 try/catch 接住 */
+            const guarded = task.catch((error) => { throw error; });
+            const raced = await Promise.race([
+                guarded,
+                new Promise((resolve) => {
+                    const timer = setTimeout(() => resolve(timedOut), options.hardMs);
+                    timer.unref?.();
+                })
+            ]);
+            clearTimeout(notice);
+            if (raced !== timedOut)
+                return raced;
+            node_karin_2.logger.mark("[小红书] " + label + "已 " + seconds(options.hardMs) + "s 没有返回，再等 " + seconds(options.graceMs) + "s 看它是挂住还是只是慢");
+            const graced = await Promise.race([
+                guarded,
+                new Promise((resolve) => {
+                    const timer = setTimeout(() => resolve(timedOut), options.graceMs);
+                    timer.unref?.();
+                })
+            ]);
+            if (graced !== timedOut) {
+                node_karin_2.logger.mark("[小红书] " + label + "其实成功了（" + seconds(Date.now() - startedAt) + "s 才返回），这次不算超时");
+                return graced;
+            }
+            node_karin_2.logger.warn("[小红书] " + label + "超时（共 " + seconds(Date.now() - startedAt) + "s），本次跳过");
+            return null;
+        };
         /**
          * 卡片发完后再去拉表情表（给评论区做表情转换用）。
          * 这里挂掉/超时都不影响已经发出去的卡片。
          */
         try {
-            const EmojiList = await Promise.race([
-                this.amagi.xiaohongshu.fetcher.fetchEmojiList(),
-                new Promise((resolve) => setTimeout(() => resolve(null), 8000))
-            ]);
+            const EmojiList = await withNoticeTimeout('表情表拉取', this.amagi.xiaohongshu.fetcher.fetchEmojiList(), {
+                noticeMs: 8000, hardMs: 30000, graceMs: 10000
+            });
             if (EmojiList) {
                 formattedEmojis = (0, exports.XiaohongshuEmoji)(EmojiList.data);
                 node_karin_2.logger.mark('[小红书] 表情表已获取，共 ' + (Array.isArray(formattedEmojis) ? formattedEmojis.length : 0) + ' 条');
             }
             else {
-                node_karin_2.logger.warn('[小红书] 表情表超时（8s），评论区将不做表情转换');
+                node_karin_2.logger.warn('[小红书] 表情表没拿到（超时），评论区将不做表情转换');
             }
         }
         catch (error) {
@@ -270,13 +315,13 @@ class Xiaohongshu extends module_1.Base {
             /** 评论是否拉取失败 —— 失败也要把评论卡渲染出来（只是内容为空 + 一句提示） */
             let commentFailed = false;
             try {
-                // 评论同样加超时：上游这条链路本来就常挂，别把整条解析拖死
-                CommentData = await Promise.race([
-                    this.fetchConfiguredNoteComments(data),
-                    new Promise((resolve) => setTimeout(() => resolve(null), 15000))
-                ]);
+                // 评论同样加超时：上游这条链路本来就常挂，别把整条解析拖死。
+                // 但**「慢」不是「挂」**：15 秒只提示、60 秒才怀疑、再给 15 秒宽限（见 withNoticeTimeout）。
+                CommentData = await withNoticeTimeout('评论拉取', this.fetchConfiguredNoteComments(data), {
+                    noticeMs: 15000, hardMs: 60000, graceMs: 15000
+                });
                 if (!CommentData)
-                    throw new Error('拉取评论超时（15s）');
+                    throw new Error('拉取评论超时（提示 15s / 硬超时 60s + 宽限 15s 都没等到）');
             }
             catch (error) {
                 /**

package/lib/ktr/template/other/handlerError/components/handlerError.js

@@ -387,7 +387,7 @@ const handlerError = (props) => {
                                                 }, children: "Support" })] }), (0, jsx_runtime_1.jsxs)("div", { className: "grid grid-cols-2 gap-x-6 gap-y-6 text-2xl leading-relaxed py-6", style: {
                                             borderTop: `1px solid ${dark ? 'rgba(248,113,113,0.2)' : 'rgba(220,38,38,0.12)'}`,
                                             borderBottom: `1px solid ${dark ? 'rgba(248,113,113,0.2)' : 'rgba(220,38,38,0.12)'}`
-                                        }, children: [(0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)("p", { className: "font-semibold mb-1", style: { color: accentColor }, children: "GitHub Issue" }), (0, jsx_runtime_1.jsx)("p", { className: "text-xl break-all", style: { color: secondaryColor }, children: "https://github.com/maimai993/koishi-plugin-kkk/issues/new/choose" })] }), (0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)("p", { className: "font-semibold mb-1", style: { color: accentColor }, children: "GitHub Repository" }), (0, jsx_runtime_1.jsx)("p", { className: "text-xl break-all", style: { color: secondaryColor }, children: "https://github.com/maimai993/koishi-plugin-kkk" })] }), (0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)("p", { className: "font-semibold mb-1", style: { color: accentColor }, children: "QQ \u7FA4" }), (0, jsx_runtime_1.jsx)("p", { className: "text-xl", style: { color: secondaryColor }, children: data.report?.group ?? '1050229473' }), (0, jsx_runtime_1.jsx)("p", { className: "text-lg break-all opacity-80", style: { color: secondaryColor }, children: data.report?.groupUrl ?? 'https://qm.qq.com/q/1050229473' })] }), (0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)("p", { className: "font-semibold mb-1", style: { color: accentColor }, children: "\u9644\u5E26\u4FE1\u606F" }), (0, jsx_runtime_1.jsx)("p", { className: "text-xl", style: { color: secondaryColor }, children: "\u6B64\u56FE\u7247 + \u89E6\u53D1\u547D\u4EE4 + \u5BF9\u5E94\u914D\u7F6E\uFF08\u81EA\u884C\u8131\u654F\u5904\u7406\uFF09" })] }), data.report && ((0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)("p", { className: "font-semibold mb-1", style: { color: accentColor }, children: "\u9519\u8BEF\u4E0A\u62A5\u7F16\u53F7" }), (0, jsx_runtime_1.jsx)("p", { className: "text-xl break-all font-mono", style: { color: secondaryColor }, children: data.report.id }), (0, jsx_runtime_1.jsx)("p", { className: "text-lg break-all opacity-80", style: { color: secondaryColor }, children: data.report.url })] }))] }), (0, jsx_runtime_1.jsxs)("div", { className: "flex items-center gap-4 mt-6 text-xl", style: { color: mutedColor }, children: [(0, jsx_runtime_1.jsx)("span", { className: "font-mono", children: "Tips:" }), (0, jsx_runtime_1.jsx)("span", { children: "\u4FE1\u606F\u8D8A\u5B8C\u6574\uFF0C\u5B9A\u4F4D\u8D8A\u5FEB\u3002" })] })] })] })] })] }));
+                                        }, children: [(0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)("p", { className: "font-semibold mb-1", style: { color: accentColor }, children: "GitHub Issue" }), (0, jsx_runtime_1.jsx)("p", { className: "text-xl break-all", style: { color: secondaryColor }, children: "https://github.com/maimai993/koishi-plugin-kkk/issues/new/choose" })] }), (0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)("p", { className: "font-semibold mb-1", style: { color: accentColor }, children: "GitHub Repository" }), (0, jsx_runtime_1.jsx)("p", { className: "text-xl break-all", style: { color: secondaryColor }, children: "https://github.com/maimai993/koishi-plugin-kkk" })] }), (0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)("p", { className: "font-semibold mb-1", style: { color: accentColor }, children: "QQ \u7FA4" }), (0, jsx_runtime_1.jsx)("p", { className: "text-xl", style: { color: secondaryColor }, children: data.report?.group ?? '1050229473' }), (0, jsx_runtime_1.jsx)("p", { className: "text-lg break-all opacity-80", style: { color: secondaryColor }, children: data.report?.groupUrl ?? 'https://qm.qq.com/q/viymkIPvvq' })] }), (0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)("p", { className: "font-semibold mb-1", style: { color: accentColor }, children: "\u9644\u5E26\u4FE1\u606F" }), (0, jsx_runtime_1.jsx)("p", { className: "text-xl", style: { color: secondaryColor }, children: "\u6B64\u56FE\u7247 + \u89E6\u53D1\u547D\u4EE4 + \u5BF9\u5E94\u914D\u7F6E\uFF08\u81EA\u884C\u8131\u654F\u5904\u7406\uFF09" })] }), data.report && ((0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)("p", { className: "font-semibold mb-1", style: { color: accentColor }, children: "\u9519\u8BEF\u4E0A\u62A5\u7F16\u53F7" }), (0, jsx_runtime_1.jsx)("p", { className: "text-xl break-all font-mono", style: { color: secondaryColor }, children: data.report.id }), (0, jsx_runtime_1.jsx)("p", { className: "text-lg break-all opacity-80", style: { color: secondaryColor }, children: data.report.url })] }))] }), (0, jsx_runtime_1.jsxs)("div", { className: "flex items-center gap-4 mt-6 text-xl", style: { color: mutedColor }, children: [(0, jsx_runtime_1.jsx)("span", { className: "font-mono", children: "Tips:" }), (0, jsx_runtime_1.jsx)("span", { children: "\u4FE1\u606F\u8D8A\u5B8C\u6574\uFF0C\u5B9A\u4F4D\u8D8A\u5FEB\u3002" })] })] })] })] })] }));
 };
 exports.handlerError = handlerError;
 exports.handlerError.displayName = 'handlerError';