koishi-plugin-kkk 3.2.0 → 3.2.2

package/lib/index.js

@@ -704,18 +704,40 @@ function registerCommands(ctx, logger, autoParse) {
                         return;
                 }
                 if (resolved && resolved.candidates && resolved.candidates.length) {
-                    const { cmdInput } = await Promise.resolve().then(() => __importStar(require('./karin/module/utils/QqPanel')));
-                    const table = ['| # | 标题 | UP / 作者 | 操作 |', '| :---: | :--- | :--- | :---: |'];
-                    resolved.candidates.slice(0, 6).forEach((item, index) => {
-                        const link = item.platform === 'bilibili'
-                            ? 'https://www.bilibili.com/video/' + item.id
-                            : 'https://www.douyin.com/video/' + item.id;
-                        const title = String(item.title || '（无标题）').replace(/[|\n]/g, ' ').slice(0, 26);
-                        const author = String(item.author || '-').replace(/[|\n]/g, ' ').slice(0, 12);
-                        table.push('| ' + (index + 1) + ' | ' + title + ' | ' + author + ' | ' + cmdInput('解析 ' + link, '解析') + ' |');
+                    const top = resolved.candidates.slice(0, 6);
+                    const tip = '没能唯一确定这个作品（识别到：' + ((resolved.upName) || '未知') + '），下面是候选：';
+                    const linkOf = (item) => item.platform === 'bilibili'
+                        ? 'https://www.bilibili.com/video/' + item.id
+                        : 'https://www.douyin.com/video/' + item.id;
+                    /**
+                     * **按平台分成两种发法**。
+                     *
+                     * QQ 官方机器人认 markdown，候选直接排成表格、操作列是按钮，点一下就走解析（最省事）。
+                     * 个人号（OneBot / NapCat）**不渲染 markdown**：实测这条候选消息发过去整条都发不出来 ——
+                     * 用户只看到「正在提取卡片信息…」然后再无音讯，六个候选白搜。那边改成纯文本 + 完整链接，
+                     * QQ 客户端会把裸链接变成可点的蓝色链接，复制粘贴也方便。
+                     */
+                    const officialQq = /^qq/i.test(String(session.platform ?? ''));
+                    if (officialQq) {
+                        const { cmdInput } = await Promise.resolve().then(() => __importStar(require('./karin/module/utils/QqPanel')));
+                        const table = ['| # | 标题 | UP / 作者 | 操作 |', '| :---: | :--- | :--- | :---: |'];
+                        top.forEach((item, index) => {
+                            const title = String(item.title || '（无标题）').replace(/[|\n]/g, ' ').slice(0, 26);
+                            const author = String(item.author || '-').replace(/[|\n]/g, ' ').slice(0, 12);
+                            table.push('| ' + (index + 1) + ' | ' + title + ' | ' + author + ' | ' + cmdInput('解析 ' + linkOf(item), '解析') + ' |');
+                        });
+                        await send([{ type: 'markdown', attrs: { content: tip + '点按钮直接解析' + String.fromCharCode(10) + table.join(String.fromCharCode(10)) } }]);
+                        return;
+                    }
+                    const lines = [tip];
+                    top.forEach((item, index) => {
+                        const title = String(item.title || '（无标题）').replace(/\s+/g, ' ').slice(0, 40);
+                        const author = String(item.author || '-').replace(/\s+/g, ' ').slice(0, 16);
+                        lines.push((index + 1) + '. ' + title + ' —— ' + author);
+                        lines.push(linkOf(item));
                     });
-                    const tip = '没能唯一确定这个作品（识别到：' + ((resolved.upName) || '未知') + '），下面是候选，点按钮直接解析：';
-                    await send([{ type: 'markdown', attrs: { content: tip + String.fromCharCode(10) + table.join(String.fromCharCode(10)) } }]);
+                    lines.push('把想看的那个链接发给我就能解析。');
+                    await send(lines.join(String.fromCharCode(10)));
                     return;
                 }
                 await send('没能从这张卡片里认出作品，直接发链接给我吧');

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveCardToUrl = exports.searchDouyinWorks = exports.searchBiliVideos = exports.extractUpName = exports.ocrImageText = exports.extractCardInfo = void 0;
+exports.resolveCardToUrl = exports.searchDouyinWorks = exports.searchBiliVideos = exports.extractUpNames = exports.extractUpName = exports.ocrImageText = exports.extractCardInfo = void 0;
 /**
  * QQ 卡片消息解析（小程序卡片 / 分享卡片）。
  *
@@ -239,19 +239,66 @@ exports.ocrImageText = ocrImageText;
  * 从 OCR 文本里认 UP 主名。
  * B站个人卡片的排版是「昵称 / UP主 / 粉丝数…」，所以拿「UP主」上一行最稳。
  */
-const extractUpName = (text) => {
-    const lines = String(text ?? '').split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
-    if (!lines.length)
-        return '';
-    const isStat = (line) => /(粉丝|播放|点赞|弹幕|投币|收藏|关注|转发|评论|分享)/.test(line) || /^\d+(\.\d+)?[万亿]?$/.test(line);
-    const idx = lines.findIndex((line) => /^(up主|UP主|up|UP)$/.test(line));
+const extractUpName = (text) => (0, exports.extractUpNames)(text)[0] ?? '';
+exports.extractUpName = extractUpName;
+/** 明显不是昵称的标签词 */
+const NICK_LABELS = new Set(['up', 'up主', 'upzhu', 'v', '粉丝', '关注', '获赞', '播放', '点赞', '弹幕', '投币', '收藏', '转发', '评论', '分享', '投稿', '作品', '简介', '主页', '更多', '展开', '未知', '半身像']);
+/**
+ * 从 OCR 文本里认**所有可能**的 UP 主名（按可能性排序）。
+ *
+ * 为什么要多个：B站个人卡片实测长这样（OCR 把结构压扁了、顺序也不一定）——
+ *
+ *     雾小霜暗区突围 1,052 半身像 UP主 4993粉丝 1,087 *未知" 5.3万播放1806点赞 11弹幕
+ *
+ * 真名是**第一行的「雾小霜暗区突围」**，而「UP主」前一行是「半身像」（封面上的字）。
+ * 只取「UP主前一行」这条老规则就会拿「半身像」去搜，标题又对不上，于是六个候选一个都不敢选。
+ * 现在两条都当候选（首行 + UP主前后行），搜索端**任一命中**就算作者对上，
+ * 谁真的搜得到就用谁 —— 不再赌某一种排版。
+ */
+const extractUpNames = (text) => {
+    const raw = String(text ?? '');
+    // OCR 有时整段只有一行（空格分隔），这时按空白切
+    const byLine = raw.split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
+    const tokens = byLine.length >= 2 ? byLine : raw.split(/[\s\u3000|/]+/).map((item) => item.trim()).filter(Boolean);
+    const isStat = (line) => /(粉丝|播放|点赞|弹幕|投币|收藏|关注|转发|评论|分享|投稿)/.test(line) ||
+        /^[\d,.]+(\.\d+)?[万亿]?$/.test(line) ||
+        /^[*＊·.]+$/.test(line);
+    const clean = (line) => line
+        .replace(/^[*＊·\s]+/, '')
+        .replace(/[*＊·\s]+$/, '')
+        .replace(/["“”'']/g, '')
+        .trim();
+    const candidates = [];
+    const push = (line) => {
+        if (!line)
+            return;
+        const value = clean(line);
+        if (value.length < 2 || value.length > 20)
+            return;
+        if (isStat(value))
+            return;
+        if (NICK_LABELS.has(value.toLowerCase()))
+            return;
+        if (/^[\d,.万]+$/.test(value))
+            return;
+        if (!candidates.includes(value))
+            candidates.push(value);
+    };
+    // ① UP主 前后各一行/一个词
+    const idx = tokens.findIndex((token) => /^(up主|up|upzhu)$/i.test(clean(token)));
     if (idx > 0)
-        return lines[idx - 1];
-    if (idx === 0 && lines[1])
-        return lines[1];
-    return lines.find((line) => !isStat(line)) ?? '';
+        push(tokens[idx - 1]);
+    if (idx >= 0)
+        push(tokens[idx + 1]);
+    // ② 第一行（B站卡片昵称就在最上面）
+    push(tokens[0]);
+    // ③ 任何一行像「粉丝数」这种统计的**前面**一行
+    const statIdx = tokens.findIndex((token) => /粉丝|关注/.test(token));
+    if (statIdx > 0)
+        push(tokens[statIdx - 1]);
+    return candidates;
 };
-exports.extractUpName = extractUpName;
+exports.extractUpNames = extractUpNames;
 /* ------------------------------------------------------------------ *
  * B站搜索（自带 Wbi 签名）
  * ------------------------------------------------------------------ */
@@ -331,7 +378,13 @@ const searchBiliVideos = async (keyword, title = '', author = '', limit = 8) =>
         }
         const raw = Array.isArray(json?.data?.result) ? json.data.result : [];
         const titleKey = normalizeText(title || keyword);
-        const authorKey = normalizeText(author);
+        /**
+         * 作者可以有**多个候选**（卡片摘要里的那个 + OCR 认出来的那几个），
+         * 结果只要命中任意一个就算作者对上了，用命中的那个算分。
+         */
+        const authorKeys = (Array.isArray(author) ? author : [author])
+            .map((item) => normalizeText(item))
+            .filter((item, index, list) => item.length >= 2 && list.indexOf(item) === index);
         return raw
             .filter((item) => item?.bvid)
             .map((item, index) => {
@@ -342,13 +395,22 @@ const searchBiliVideos = async (keyword, title = '', author = '', limit = 8) =>
             let score = 0;
             let titleMatch = false;
             let authorMatch = false;
-            if (authorKey && a) {
+            let matchedAuthor = '';
+            for (const authorKey of authorKeys) {
+                if (!a)
+                    break;
                 if (a === authorKey) {
                     score += 120;
                     authorMatch = true;
+                    matchedAuthor = authorKey;
+                    break;
                 }
-                else if (a.includes(authorKey) || authorKey.includes(a)) {
-                    score += 70;
+                if (a.includes(authorKey) || authorKey.includes(a)) {
+                    // 模糊命中：分少一点，并且只取最好的那次
+                    if (!authorMatch) {
+                        score += 70;
+                        matchedAuthor = authorKey;
+                    }
                     authorMatch = true;
                 }
             }
@@ -368,7 +430,7 @@ const searchBiliVideos = async (keyword, title = '', author = '', limit = 8) =>
                     score += Math.round(sim * 40);
                 }
             }
-            return { bvid: String(item.bvid), title: itemTitle, author: itemAuthor, score: score - index, titleMatch, authorMatch };
+            return { bvid: String(item.bvid), title: itemTitle, author: itemAuthor, score: score - index, titleMatch, authorMatch, matchedAuthor };
         })
             .sort((left, right) => right.score - left.score)
             .slice(0, Math.max(1, Math.min(20, limit)));
@@ -382,7 +444,7 @@ exports.searchBiliVideos = searchBiliVideos;
 /* ------------------------------------------------------------------ *
  * 抖音搜索（直接用 amagi 的 search 端点）
  * ------------------------------------------------------------------ */
-const searchDouyinWorks = async (keyword, limit = 8) => {
+const searchDouyinWorks = async (keyword, limit = 8, authors = []) => {
     try {
         // 这版接口库的抖音 fetcher 不一定有 search（实测 6.6.0 上没有），没有就干脆跳过
         const fetcher = amagiClient_1.douyinFetcher;
@@ -393,16 +455,30 @@ const searchDouyinWorks = async (keyword, limit = 8) => {
         const res = await fetcher.search({ query: String(keyword ?? '').trim(), type: 'video', number: limit });
         const list = res?.data?.data?.aweme_list ?? res?.data?.aweme_list ?? res?.aweme_list ?? [];
         const titleKey = normalizeText(keyword);
+        const authorKeys = authors.map((item) => normalizeText(item)).filter((item) => item.length >= 2);
         return list
             .filter((item) => item?.aweme_id)
             .map((item, index) => {
             const desc = String(item.desc ?? '');
             const sim = titleSimilarity(normalizeText(desc), titleKey);
+            // 作者对上一样加分：抖音搜索噪声大，光靠标题常常分不出是哪一条
+            const authorKey = normalizeText(String(item.author?.nickname ?? ''));
+            let authorScore = 0;
+            for (const key of authorKeys) {
+                if (!authorKey)
+                    break;
+                if (authorKey === key) {
+                    authorScore = 60;
+                    break;
+                }
+                if (authorKey.includes(key) || key.includes(authorKey))
+                    authorScore = Math.max(authorScore, 35);
+            }
             return {
                 aweme_id: String(item.aweme_id),
                 desc,
                 author: String(item.author?.nickname ?? ''),
-                score: Math.round(sim * 100) - index
+                score: Math.round(sim * 100) + authorScore - index
             };
         })
             .sort((left, right) => right.score - left.score)
@@ -429,7 +505,17 @@ const resolveCardToUrl = async (content) => {
     }
     // ② OCR 封面拿文字线索
     const ocrText = await (0, exports.ocrImageText)(card.cover);
-    const upName = card.author || (0, exports.extractUpName)(ocrText);
+    /**
+     * UP 主名可以有好几个来源：卡片摘要里的 author、OCR 里「UP主」前后行、OCR 首行。
+     *
+     * 实测踩过的坑：卡片摘要给的是「半身像」（封面上的字），OCR 首行才是真昵称
+     * 「雾小霜暗区突围」—— 只认一个来源时，作者永远匹配不上，六个候选一个都不敢选。
+     * 这里全部当候选，谁匹配上算谁的。
+     */
+    const upNames = [card.author, ...(0, exports.extractUpNames)(ocrText)]
+        .map((item) => String(item ?? '').trim())
+        .filter((item, index, list) => item.length >= 2 && list.indexOf(item) === index);
+    const upName = upNames[0] ?? '';
     const keyword = card.title || upName || ocrText.replace(/\s+/g, ' ').slice(0, 40);
     if (!keyword) {
         node_karin_1.logger.mark('[卡片解析] OCR 没有给出可用关键词');
@@ -441,19 +527,21 @@ const resolveCardToUrl = async (content) => {
     const looksBili = /bilibili|哔哩|B站|UP主/i.test(hint);
     // ③ 先按最可能的平台搜，命中就返回
     const tryBili = async () => {
-        const hits = await (0, exports.searchBiliVideos)(keyword, card.title, upName, 8);
+        const hits = await (0, exports.searchBiliVideos)(keyword, card.title, upNames, 8);
         const candidates = hits.slice(0, 6).map((item) => ({
             platform: 'bilibili', id: item.bvid, title: item.title, author: item.author, score: item.score
         }));
         const strict = hits.filter((item) => item.authorMatch || item.titleMatch);
         // 只有「标题和作者都命中」才敢自动继续，否则交给用户挑
         const best = (strict.length ? strict : hits)[0];
-        if (best && best.titleMatch && best.authorMatch)
-            return { url: 'https://www.bilibili.com/video/' + best.bvid, candidates };
+        if (best && best.titleMatch && best.authorMatch) {
+            node_karin_1.logger.mark('[卡片解析] 作者命中「' + (best.matchedAuthor || '') + '」：' + best.author + '，标题: ' + best.title);
+            return { url: 'https://www.bilibili.com/video/' + best.bvid, candidates, matchedAuthor: best.author };
+        }
         return { candidates };
     };
     const tryDouyin = async () => {
-        const hits = await (0, exports.searchDouyinWorks)(keyword || card.title, 8);
+        const hits = await (0, exports.searchDouyinWorks)(keyword || card.title, 8, upNames);
         const candidates = hits.slice(0, 6).map((item) => ({
             platform: 'douyin', id: item.aweme_id, title: item.desc, author: item.author, score: item.score
         }));
@@ -471,7 +559,9 @@ const resolveCardToUrl = async (content) => {
             candidates.push(...hit.candidates);
             if (hit.url) {
                 node_karin_1.logger.mark('[卡片解析] 定位成功: ' + hit.url);
-                return { url: hit.url, platform: hit.url.includes('bilibili') ? 'bilibili' : 'douyin', card, candidates, ocrText, upName };
+                // 提示语里报「真正匹配上的那个 UP 名」，而不是卡片摘要里那个不准的
+                const matched = hit.matchedAuthor || upName;
+                return { url: hit.url, platform: hit.url.includes('bilibili') ? 'bilibili' : 'douyin', card, candidates, ocrText, upName: matched };
             }
         }
     }

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.DEFAULT_REPORT_GROUP = exports.DEFAULT_REPORT_URL = void 0;
+exports.errorHelpSegments = exports.uploadErrorReport = exports.groupLinkOf = exports.REPORT_LOG_LINES = exports.REPORT_GROUP = exports.REPORT_TOKEN = exports.REPORT_URL = void 0;
 exports.reportConfig = reportConfig;
 /**
  * 错误上报。
@@ -25,37 +25,50 @@ const runtime_1 = require("../../../compat/runtime");
 const qqOptions_1 = require("../../../qqOptions");
 const root_1 = require("../../root");
 const build_metadata_1 = require("./build-metadata");
-/** 默认收集站（面板里可改） */
-exports.DEFAULT_REPORT_URL = 'https://err.tangbot.xyz';
-/** 默认反馈群（面板里可改） */
-exports.DEFAULT_REPORT_GROUP = '1050229473';
-/** 上传超时（毫秒）：超了就放弃，不拖住错误卡片 */
-const UPLOAD_TIMEOUT_MS = 8000;
+/**
+ * 收集站地址：**写死，不开放配置**。
+ * 自建的人改这一行重新构建即可 —— 面板里只留「是否上传」一个开关，少一个能填错的地方。
+ */
+exports.REPORT_URL = 'https://err.tangbot.xyz';
+/**
+ * 上报令牌：**写死**。
+ * 服务端 \`KKK_ERR_TOKEN\` 的默认值就是它，所以两边开箱即用、什么都不用配。
+ * 它写在开源插件里，等于公开 —— 服务端那边另有 IP 限流兜着，挡的是随机刷接口的流量。
+ */
+exports.REPORT_TOKEN = 'kkk-err-9f3c1d7a5b2e4c80';
+/** 反馈群：写死（QQ 客户端点群链接就能进） */
+exports.REPORT_GROUP = '1050229473';
+/** 上报多少行日志：写死（本次请求的日志 + 宿主日志文件尾部各取这么多行） */
+exports.REPORT_LOG_LINES = 200;
+/**
+ * 上传超时（毫秒）：超了就放弃，不拖住错误卡片。
+ *
+ * 上报是**在渲染错误卡片之前**做的（编号要印在卡片上），所以站点挂掉时这 5 秒会加到
+ * 报错送达上 —— 正常情况一次上传 50 毫秒左右，只有连不上站点才会等到超时。
+ */
+const UPLOAD_TIMEOUT_MS = 5000;
 /** 上报日志单行最长字符数 */
 const LOG_LINE_LIMIT = 2000;
 /** 整份上报最多多大（压缩前），超了继续砍日志 */
 const PAYLOAD_LIMIT_BYTES = 2 * 1024 * 1024;
 /** 读取宿主日志文件时最多读多少字节 */
 const LOG_FILE_TAIL_BYTES = 512 * 1024;
-/** 读面板里的「错误上报」配置（缺省值来自 qqFields.json） */
+/**
+ * 上报配置。
+ *
+ * 面板里**只有「上传错误信息」一个开关**（通用 → 错误上报）：地址、令牌、群号、日志行数全部写死，
+ * 用户没有可以填错的地方。关掉开关就完全不上传。
+ */
 function reportConfig() {
-    let options = {};
+    let enabled = true;
     try {
-        options = (0, qqOptions_1.readQqOptions)(((0, runtime_1.tryGetRuntime)()?.config ?? {}));
+        const options = (0, qqOptions_1.readQqOptions)(((0, runtime_1.tryGetRuntime)()?.config ?? {}));
+        enabled = options.errorReportUpload !== false;
     }
     catch {
-        options = ((0, runtime_1.tryGetRuntime)()?.config ?? {});
+        enabled = (0, runtime_1.tryGetRuntime)()?.config?.errorReportUpload !== false;
     }
-    const url = String(options.errorReportUrl ?? '').trim() || exports.DEFAULT_REPORT_URL;
-    const logLines = Number(options.errorReportLogLines);
-    return {
-        enabled: options.errorReportUpload !== false,
-        // 末尾斜杠统一去掉，拼 /api/v1/reports 时不会出现双斜杠
-        url: url.replace(/\/+$/, ''),
-        token: String(options.errorReportToken ?? '').trim(),
-        logLines: Number.isFinite(logLines) ? Math.min(1000, Math.max(0, Math.trunc(logLines))) : 200,
-        group: String(options.errorReportGroup ?? '').trim() || exports.DEFAULT_REPORT_GROUP
-    };
+    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;

package/lib/qqFields.json

@@ -224,48 +224,5 @@
         "default": true,
         "label": "上传错误信息",
         "description": "插件出错时，自动把**错误信息、运行环境（Koishi 版本、装了哪些插件、适配器）、最近的日志**上传到收集站，站长在网页上就能查到，不用你截图、也不用翻日志文件。**默认开启**。上传失败不影响报错本身（错误卡片照常发）。不想要就在这里关掉。"
-    },
-    {
-        "key": "errorReportUrl",
-        "group": "通用",
-        "renderIn": "app",
-        "section": "错误上报",
-        "type": "string",
-        "default": "https://err.tangbot.xyz",
-        "label": "上报服务器地址",
-        "description": "错误收集站的地址，**默认 https://err.tangbot.xyz**。自建的话填自己的域名（不要带结尾斜杠）。上报内容会 POST 到「地址 + /api/v1/reports」。"
-    },
-    {
-        "key": "errorReportToken",
-        "group": "通用",
-        "renderIn": "app",
-        "section": "错误上报",
-        "type": "string",
-        "default": "",
-        "secret": true,
-        "label": "上报令牌",
-        "description": "收集站要求的令牌，要和服务器端的 KKK_ERR_TOKEN 一致；填错会返回 401，日志里会写「上传失败 HTTP 401」。服务器启动时会打印这个令牌（没设就随机生成一个）。"
-    },
-    {
-        "key": "errorReportLogLines",
-        "group": "通用",
-        "renderIn": "app",
-        "section": "错误上报",
-        "type": "number",
-        "default": 200,
-        "min": 0,
-        "max": 1000,
-        "label": "上报日志行数",
-        "description": "上报时带多少行日志：本次请求捕获的日志 + 宿主日志文件的尾部（宿主那份最多 300 行）。0 = 完全不上传日志。单行超长的（比如 OneBot 把 4.6MB 的 base64 塞进报错）会自动折叠，不会把上报撑爆。"
-    },
-    {
-        "key": "errorReportGroup",
-        "group": "通用",
-        "renderIn": "app",
-        "section": "错误上报",
-        "type": "string",
-        "default": "1050229473",
-        "label": "问题反馈群号",
-        "description": "错误消息里带上这个群号，用户拿着上报编号进群提问。QQ 官方机器人会把它渲染成**可点的加群链接**（https://qm.qq.com/q/群号），个人号（NapCat 等）直接给纯文本链接，QQ 客户端同样会变成可点。"
     }
 ]

package/package.json

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

package/scripts/smoke-cardparse.cjs

@@ -0,0 +1,58 @@
+/**
+ * 卡片解析（OCR 找 UP 主）冒烟测试。
+ *
+ * 覆盖线上踩过的那个坑：B站卡片的 OCR 文本里「UP主」**上一行不是昵称**，
+ * 真名在第一行 —— 老规则只看「UP主前一行」，于是拿封面上的「半身像」去搜，
+ * 标题又对不上，六个候选一个都不敢选（用户看到的「没能唯一定位…候选 6 条」）。
+ *
+ * 这里只测纯函数（不联网）：候选名的顺序、噪声过滤、去重。
+ * 用法：node scripts/smoke-cardparse.cjs
+ */
+const path = require('node:path')
+
+const pluginRoot = path.resolve(__dirname, '..')
+const libRoot = path.join(pluginRoot, 'lib')
+
+/** 兼容层要先绑定运行时，CardParser 读配置/日志都走它 */
+const runtime = require(path.join(libRoot, 'compat', 'runtime.js'))
+const noop = () => {}
+runtime.bindRuntime({
+  ctx: { get: () => undefined, logger: () => ({ info: noop, warn: noop, error: noop, debug: noop, mark: noop }), bots: [], registry: new Map() },
+  config: { app: {} },
+  dataRoot: path.join(pluginRoot, 'data-smoke-cardparse'),
+  master: () => []
+})
+
+const { extractUpNames, extractUpName } = require(path.join(libRoot, 'karin/module/utils/CardParser.js'))
+
+const results = []
+const check = (name, ok, detail) => {
+  results.push({ name, ok })
+  console.log((ok ? '  ✅ ' : '  ❌ ') + name + (detail ? '  —— ' + detail : ''))
+}
+
+console.log('\n[1] 线上那条真实 OCR（真名在第一行、「UP主」前一行是封面文字）')
+const live = '雾小霜暗区突围\n1,052\n半身像\nUP主\n4993粉丝\n1,087\n*未知"\n5.3万播放1806点赞\n11弹幕'
+const liveNames = extractUpNames(live)
+check('首选就是真昵称「雾小霜暗区突围」', liveNames[0] === '雾小霜暗区突围', liveNames.join(' / '))
+check('封面文字「半身像」不会混进来', !liveNames.includes('半身像'), liveNames.join(' / '))
+check('统计行（4993粉丝 / 5.3万播放…）不当昵称', !liveNames.some((item) => /粉丝|播放|点赞|弹幕|^[\d,.]+$/.test(item)), liveNames.join(' / '))
+check('旧入口 extractUpName 与首选一致', extractUpName(live) === '雾小霜暗区突围', extractUpName(live))
+
+console.log('\n[2] OCR 把整段压成一行（空格分隔）也要认出来')
+const flat = '雾小霜暗区突围 1,052 半身像 UP主 4993粉丝 1,087 *未知" 5.3万播放1806点赞 11弹幕'
+check('单行也能拿到真昵称', extractUpNames(flat)[0] === '雾小霜暗区突围', JSON.stringify(extractUpNames(flat)))
+
+console.log('\n[3] 标准 B站排版（昵称在「UP主」上一行）保持原样')
+const classic = '影视飓风\nUP主\n123.4万粉丝\n1.2亿播放'
+check('昵称「影视飓风」', extractUpNames(classic)[0] === '影视飓风', JSON.stringify(extractUpNames(classic)))
+
+console.log('\n[4] 边界：空文本 / 只有统计 / 重复行')
+check('空文本返回空数组', extractUpNames('').length === 0)
+check('只有统计行时没有候选', extractUpNames('1.2万粉丝\n3,456\n7.8万播放').length === 0, JSON.stringify(extractUpNames('1.2万粉丝\n3,456\n7.8万播放')))
+check('大小写不同的 UP主 都能识别', extractUpNames('某某某\nup主\n100粉丝')[0] === '某某某', JSON.stringify(extractUpNames('某某某\nup主\n100粉丝')))
+check('候选不重复', (() => { const list = extractUpNames('小明明\nUP主\n小明明\n99粉丝'); return list.length === new Set(list).size })(), JSON.stringify(extractUpNames('小明明\nUP主\n小明明\n99粉丝')))
+
+const failed = results.filter((item) => !item.ok)
+console.log('\n=== ' + (results.length - failed.length) + '/' + results.length + ' 通过 ===')
+process.exitCode = failed.length ? 1 : 0

package/src/index.ts

@@ -705,18 +705,40 @@ function registerCommands (
           if (await runTextCommand(session, '#解析 ' + resolved.url)) return
         }
         if (resolved && resolved.candidates && resolved.candidates.length) {
-          const { cmdInput } = await import('./karin/module/utils/QqPanel')
-          const table = ['| # | 标题 | UP / 作者 | 操作 |', '| :---: | :--- | :--- | :---: |']
-          resolved.candidates.slice(0, 6).forEach((item: any, index: number) => {
-            const link = item.platform === 'bilibili'
-              ? 'https://www.bilibili.com/video/' + item.id
-              : 'https://www.douyin.com/video/' + item.id
-            const title = String(item.title || '（无标题）').replace(/[|\n]/g, ' ').slice(0, 26)
-            const author = String(item.author || '-').replace(/[|\n]/g, ' ').slice(0, 12)
-            table.push('| ' + (index + 1) + ' | ' + title + ' | ' + author + ' | ' + cmdInput('解析 ' + link, '解析') + ' |')
+          const top = resolved.candidates.slice(0, 6)
+          const tip = '没能唯一确定这个作品（识别到：' + ((resolved.upName) || '未知') + '），下面是候选：'
+          const linkOf = (item: any) => item.platform === 'bilibili'
+            ? 'https://www.bilibili.com/video/' + item.id
+            : 'https://www.douyin.com/video/' + item.id
+          /**
+           * **按平台分成两种发法**。
+           *
+           * QQ 官方机器人认 markdown，候选直接排成表格、操作列是按钮，点一下就走解析（最省事）。
+           * 个人号（OneBot / NapCat）**不渲染 markdown**：实测这条候选消息发过去整条都发不出来 ——
+           * 用户只看到「正在提取卡片信息…」然后再无音讯，六个候选白搜。那边改成纯文本 + 完整链接，
+           * QQ 客户端会把裸链接变成可点的蓝色链接，复制粘贴也方便。
+           */
+          const officialQq = /^qq/i.test(String((session as any).platform ?? ''))
+          if (officialQq) {
+            const { cmdInput } = await import('./karin/module/utils/QqPanel')
+            const table = ['| # | 标题 | UP / 作者 | 操作 |', '| :---: | :--- | :--- | :---: |']
+            top.forEach((item: any, index: number) => {
+              const title = String(item.title || '（无标题）').replace(/[|\n]/g, ' ').slice(0, 26)
+              const author = String(item.author || '-').replace(/[|\n]/g, ' ').slice(0, 12)
+              table.push('| ' + (index + 1) + ' | ' + title + ' | ' + author + ' | ' + cmdInput('解析 ' + linkOf(item), '解析') + ' |')
+            })
+            await send([{ type: 'markdown', attrs: { content: tip + '点按钮直接解析' + String.fromCharCode(10) + table.join(String.fromCharCode(10)) } }])
+            return
+          }
+          const lines = [tip]
+          top.forEach((item: any, index: number) => {
+            const title = String(item.title || '（无标题）').replace(/\s+/g, ' ').slice(0, 40)
+            const author = String(item.author || '-').replace(/\s+/g, ' ').slice(0, 16)
+            lines.push((index + 1) + '. ' + title + ' —— ' + author)
+            lines.push(linkOf(item))
           })
-          const tip = '没能唯一确定这个作品（识别到：' + ((resolved.upName) || '未知') + '），下面是候选，点按钮直接解析：'
-          await send([{ type: 'markdown', attrs: { content: tip + String.fromCharCode(10) + table.join(String.fromCharCode(10)) } }])
+          lines.push('把想看的那个链接发给我就能解析。')
+          await send(lines.join(String.fromCharCode(10)))
           return
         }
         await send('没能从这张卡片里认出作品，直接发链接给我吧')