koishi-plugin-kkk 3.2.1 → 3.2.2

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # 更新日志
 
+## 3.2.2
+
+### 卡片解析：按 UP 主模糊匹配，候选也发得出来了
+
+- **认错 UP 主的问题修了**：B站卡片的 OCR 文本里，「UP主」的上一行**不一定是昵称** —— 你那张卡的上一行是封面上的「半身像」，真名「雾小霜暗区突围」在**第一行**。以前只认「UP主前一行」，于是拿「半身像」去搜，标题又对不上，六个候选一个都不敢选（就是你看到的「没能唯一定位…候选 6 条」）。现在**首行、UP主前后行**都当候选，搜索时**任意一个对上**就算作者命中，命中的那个会写进日志和提示语。
+- **候选列表在个人号上发不出去的问题修了**：候选以前是**一条 markdown 表格**，只有 QQ 官方机器人渲染，个人号（NapCat 等）发过去整条消息都出不去 —— 用户只看到「正在提取卡片信息…」然后就没了下文。现在**按平台分开发**：官方 QQ 还是表格 + 按钮（点一下直接解析）；个人号改成纯文本，一条条列「标题 —— UP」+ 完整链接，点链接或复制发回来就能解析。
+- 顺手：抖音搜索也带上作者加分（之前只看标题，噪声大时容易选错）。
+
+实测（用你那条 OCR）：候选名首选「雾小霜暗区突围」；拿它去 B站搜「根本就没有这些大金」，命中作者=雾小霜暗区突围、标题=根本就没有这些大金，**自动定位成功**。
 ## 3.2.1
 
 ### 出错时自动上报，进群报个编号就行

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-kkk",
-  "version": "3.2.1",
+  "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('没能从这张卡片里认出作品，直接发链接给我吧')

package/src/karin/module/utils/CardParser.ts

@@ -236,15 +236,57 @@ export const ocrImageText = async (imageUrl: string): Promise<string> => {
  * 从 OCR 文本里认 UP 主名。
  * B站个人卡片的排版是「昵称 / UP主 / 粉丝数…」，所以拿「UP主」上一行最稳。
  */
-export const extractUpName = (text: string): string => {
-  const lines = String(text ?? '').split(/\r?\n/).map((line) => line.trim()).filter(Boolean)
-  if (!lines.length) return ''
+export const extractUpName = (text: string): string => extractUpNames(text)[0] ?? ''
+
+/** 明显不是昵称的标签词 */
+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主前后行），搜索端**任一命中**就算作者对上，
+ * 谁真的搜得到就用谁 —— 不再赌某一种排版。
+ */
+export const extractUpNames = (text: string): string[] => {
+  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: string) =>
-    /(粉丝|播放|点赞|弹幕|投币|收藏|关注|转发|评论|分享)/.test(line) || /^\d+(\.\d+)?[万亿]?$/.test(line)
-  const idx = lines.findIndex((line) => /^(up主|UP主|up|UP)$/.test(line))
-  if (idx > 0) return lines[idx - 1]
-  if (idx === 0 && lines[1]) return lines[1]
-  return lines.find((line) => !isStat(line)) ?? ''
+    /(粉丝|播放|点赞|弹幕|投币|收藏|关注|转发|评论|分享|投稿)/.test(line) ||
+    /^[\d,.]+(\.\d+)?[万亿]?$/.test(line) ||
+    /^[*＊·.]+$/.test(line)
+  const clean = (line: string): string => line
+    .replace(/^[*＊·\s]+/, '')
+    .replace(/[*＊·\s]+$/, '')
+    .replace(/["“”'']/g, '')
+    .trim()
+  const candidates: string[] = []
+  const push = (line?: string) => {
+    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) 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
 }
 
 /* ------------------------------------------------------------------ *
@@ -305,9 +347,9 @@ const getWbiKeys = async (): Promise<{ imgKey: string; subKey: string; buvid3: s
 export const searchBiliVideos = async (
   keyword: string,
   title = '',
-  author = '',
+  author: string | string[] = '',
   limit = 8
-): Promise<Array<{ bvid: string; title: string; author: string; score: number; titleMatch: boolean; authorMatch: boolean }>> => {
+): Promise<Array<{ bvid: string; title: string; author: string; score: number; titleMatch: boolean; authorMatch: boolean; matchedAuthor: string }>> => {
   try {
     const { imgKey, subKey, buvid3 } = await getWbiKeys()
     const mixinKey = MIXIN_KEY_ENC_TAB.map((n) => (imgKey + subKey)[n]).join('').slice(0, 32)
@@ -329,7 +371,13 @@ export const searchBiliVideos = async (
     }
     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: any) => item?.bvid)
       .map((item: any, index: number) => {
@@ -340,9 +388,15 @@ export const searchBiliVideos = async (
         let score = 0
         let titleMatch = false
         let authorMatch = false
-        if (authorKey && a) {
-          if (a === authorKey) { score += 120; authorMatch = true }
-          else if (a.includes(authorKey) || authorKey.includes(a)) { score += 70; authorMatch = true }
+        let matchedAuthor = ''
+        for (const authorKey of authorKeys) {
+          if (!a) break
+          if (a === authorKey) { score += 120; authorMatch = true; matchedAuthor = authorKey; break }
+          if (a.includes(authorKey) || authorKey.includes(a)) {
+            // 模糊命中：分少一点，并且只取最好的那次
+            if (!authorMatch) { score += 70; matchedAuthor = authorKey }
+            authorMatch = true
+          }
         }
         if (titleKey && t) {
           if (t === titleKey) { score += 100; titleMatch = true }
@@ -353,7 +407,7 @@ export const searchBiliVideos = async (
             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: any, right: any) => right.score - left.score)
       .slice(0, Math.max(1, Math.min(20, limit)))
@@ -367,7 +421,11 @@ export const searchBiliVideos = async (
  * 抖音搜索（直接用 amagi 的 search 端点）
  * ------------------------------------------------------------------ */
 
-export const searchDouyinWorks = async (keyword: string, limit = 8): Promise<Array<{ aweme_id: string; desc: string; author: string; score: number }>> => {
+export const searchDouyinWorks = async (
+  keyword: string,
+  limit = 8,
+  authors: string[] = []
+): Promise<Array<{ aweme_id: string; desc: string; author: string; score: number }>> => {
   try {
     // 这版接口库的抖音 fetcher 不一定有 search（实测 6.6.0 上没有），没有就干脆跳过
     const fetcher: any = douyinFetcher as any
@@ -379,16 +437,25 @@ export const searchDouyinWorks = async (keyword: string, limit = 8): Promise<Arr
     const list: any[] =
       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: any) => item?.aweme_id)
       .map((item: any, index: number) => {
         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)
@@ -443,7 +510,17 @@ export const resolveCardToUrl = async (
 
   // ② OCR 封面拿文字线索
   const ocrText = await ocrImageText(card.cover)
-  const upName = card.author || extractUpName(ocrText)
+  /**
+   * UP 主名可以有好几个来源：卡片摘要里的 author、OCR 里「UP主」前后行、OCR 首行。
+   *
+   * 实测踩过的坑：卡片摘要给的是「半身像」（封面上的字），OCR 首行才是真昵称
+   * 「雾小霜暗区突围」—— 只认一个来源时，作者永远匹配不上，六个候选一个都不敢选。
+   * 这里全部当候选，谁匹配上算谁的。
+   */
+  const upNames = [card.author, ...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) {
     logger.mark('[卡片解析] OCR 没有给出可用关键词')
@@ -456,19 +533,22 @@ export const resolveCardToUrl = async (
   const looksBili = /bilibili|哔哩|B站|UP主/i.test(hint)
 
   // ③ 先按最可能的平台搜，命中就返回
-  const tryBili = async (): Promise<{ url?: string; candidates: CardCandidate[] }> => {
-    const hits = await searchBiliVideos(keyword, card.title, upName, 8)
+  const tryBili = async (): Promise<{ url?: string; candidates: CardCandidate[]; matchedAuthor?: string }> => {
+    const hits = await searchBiliVideos(keyword, card.title, upNames, 8)
     const candidates = hits.slice(0, 6).map((item) => ({
       platform: 'bilibili' as const, 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) {
+      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 (): Promise<{ url?: string; candidates: CardCandidate[] }> => {
-    const hits = await searchDouyinWorks(keyword || card.title, 8)
+    const hits = await searchDouyinWorks(keyword || card.title, 8, upNames)
     const candidates = hits.slice(0, 6).map((item) => ({
       platform: 'douyin' as const, id: item.aweme_id, title: item.desc, author: item.author, score: item.score
     }))
@@ -486,7 +566,9 @@ export const resolveCardToUrl = async (
       candidates.push(...hit.candidates)
       if (hit.url) {
         logger.mark('[卡片解析] 定位成功: ' + hit.url)
-        return { url: hit.url, platform: hit.url.includes('bilibili') ? 'bilibili' : 'douyin', card, candidates, ocrText, upName }
+        // 提示语里报「真正匹配上的那个 UP 名」，而不是卡片摘要里那个不准的
+        const matched = (hit as any).matchedAuthor || upName
+        return { url: hit.url, platform: hit.url.includes('bilibili') ? 'bilibili' : 'douyin', card, candidates, ocrText, upName: matched }
       }
     }
   }