koishi-plugin-kkk 3.9.0 → 3.10.0

package/CHANGELOG.md

@@ -1,5 +1,83 @@
 # 更新日志
 
+## 3.10.0
+
+> 解析消息底部的「打开原站」链接换成了**代码块形式的跳转卡片**：
+> 整段复制后打开对应 App 会直接跳到那条作品，不再依赖 QQ 会不会把链接渲染成可点的东西。
+> 快手和小红书以前完全没有这条链接，现在补上了。
+
+### 原站跳转改成「复制码」
+
+- 发出的东西从 `[打开原站](链接)` 变成代码块：
+
+  ````
+  ```复制后打开抖音自动跳转 →
+  https://v.douyin.com/iQabcdef/  :1pm Mai:/ 2237886846@qq.com
+  ```
+  ````
+
+  各家 App 都认「剪贴板里有一条自家链接」——复制整段文本打开 App 会弹直达询问，
+  比点链接稳；官方 QQ 对 markdown 里的链接也经常直接拒收整条消息，代码块没有这个问题。
+- 提示文案放在**围栏的语种位**（` ``` ` 后面那截），不占正文一行，
+  代码块里就只有链接本身，全选复制不会带上多余文字。
+- **抖音附带唤起口令**：光有链接 App 不一定弹跳转，接一段口令才稳。
+  这是抖音 App 生成的固定串（每条作品都一样），不是模板。
+- **快手、小红书单独发一条**：这两个平台没有清晰度面板——原来的跳转代码挂在画质表格下面，
+  它们压根走不到，等于一条都没发过。现在在解析内容发完后补一条同格式的消息。
+- 开关沿用 WebUI 的「原站跳转」（QQ 适配器分组，`qqPanelSourceLink`，默认开）；
+  跳转发送失败只记日志，**不影响解析结果**。
+
+### 跳转链接用用户发的那条
+
+- 一开始让跳转链接和卡片右下角的二维码保持一致（`b23.tv/<bvid>`、抖音 `share_url`），
+  实测行不通：那种链接带 `xsec_token` / `u_code` 一串参数，**太长，App 剪贴板识别不了**。
+- 改成优先用用户原样发的那条（`b23.tv/xxx`、`v.douyin.com/xxx`、`v.kuaishou.com/xxx`、
+  `xhslink.com/o/xxx`）——那本来就是各家 App 自己生成的分享形态，最短也最容易被识别。
+  取不到时才退回插件拼的标准链接。
+- 卡片二维码**没动**：扫码不吃 URL 长度，换个链接反而要重测，保持原样。
+- 顺带修了快手卡片二维码：以前填的是视频 CDN 直链，扫出来是段播放地址而不是作品页，
+  现在指向作品页（`photoId` 取不到时仍退回原逻辑）。
+
+### markdown 只对 QQ / QQ 频道发
+
+- 能渲染 markdown 的只有官方 QQ 适配器和 QQ 频道，其它平台（OneBot / Discord / Telegram /
+  KOOK…）会把代码块的 ` ``` ` 围栏原样显示成一串反引号。
+- 判定从 OneBot 黑名单改成**平台白名单**（`qq` / `qqguild`）：这两个发 markdown 代码块，
+  其余一律发去围栏的纯文本（提示一行 + 链接一行），照样整段复制、App 一样认。
+
+## 3.9.1
+
+> 修 MySQL 上启动直接报 `ER_TOO_LONG_KEY`、插件起不来的问题。
+> 3.9.0 建的索引太宽了：索引字段现在按实际数据长度定长，最宽的索引从 4080 字节降到 1152 字节。
+
+### 修复 MySQL 索引过长（ER_TOO_LONG_KEY）
+
+- **现象**：MySQL 环境启动就报 `ER_TOO_LONG_KEY`（Specified key was too long），索引超过 3072 字节，表建不出来。
+- **原因**：字符串字段没给长度，MySQL 按 `VARCHAR(255)` 建，`utf8mb4` 下每字符 4 字节，
+  单个字段就是 1020 字节。抖音作品缓存表那个由 **四个** 字段组成的唯一键
+  （作品 id + sec_uid + 群号 + 推送类型）算下来 4080 字节，直接超了上限。
+  另有几张统计表卡在 3060 字节 —— 离上限只差 12 字节，随时会爆。
+- **处理**：凡是进索引（主键 / 唯一键）的字段，都按实际数据长度定长：
+
+  | 字段 | 长度 | 说明 |
+  | --- | --- | --- |
+  | 群号 / QQ 号 / botId / 作品 id / 动态 id | 64 | 最多几十个字符 |
+  | 抖音 `sec_uid` | 128 | 实际最长见过 76 |
+  | 平台 / 内容形态 / 日期 / 指标名 | 16–32 | 固定枚举、`YYYY-MM-DD` |
+  | 过滤词 / 过滤标签 | 128 | 自定义文本 |
+  | 备注、昵称等 | 不限制 | 不进索引，不影响 |
+
+  现在最宽的索引是 1152 字节（原来是 4080），其它都在 1024 以内。
+- **在 MySQL 上已经建出过半截 `kkk` 表的**，需要先删掉再启动 —— 已有索引不一定能被自动改过来：
+
+  ```sql
+  SELECT TABLE_NAME FROM information_schema.TABLES
+    WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME LIKE 'kkk%';
+  ```
+
+  确认是插件的表之后 `DROP` 掉，重启 Koishi 会按新定义重建。
+- sqlite / postgres 不受影响，也不用做上面这一步（字段长度本来就够）。
+
 ## 3.9.0
 
 > 插件不再自己建数据库了，全部改用 Koishi 自带的数据库服务。

package/lib/build-metadata.json

@@ -1,10 +1,10 @@
 {
-  "version": "3.9.0",
-  "buildTime": "2026-09-29T04:52:03.418Z",
-  "buildTimestamp": 1790657523454,
+  "version": "3.10.0",
+  "buildTime": "2026-09-29T18:43:09.611Z",
+  "buildTimestamp": 1790707389633,
   "name": "koishi-plugin-kkk",
   "description": "抖音 / B站 / 快手 / 小红书 视频解析与动态推送，带 QQ 交互面板与弹幕烧录（karin-plugin-kkk 的 Koishi 移植版）",
   "homepage": "https://github.com/maimai993/koishi-plugin-kkk#readme",
-  "commitHash": "e58bb629886c203412e751fa87ef69b52dc44f52",
-  "shortCommitHash": "e58bb62"
+  "commitHash": "ec43387a40b337a0c1430c7b2eef36668fa92fc5",
+  "shortCommitHash": "ec43387"
 }

package/lib/karin/apps/tools.js

@@ -229,7 +229,13 @@ const handleDouyin = (0, ParseForward_1.withParseForward)((0, ErrorHandler_1.wra
      * 面板按钮里继续用**原始分享链接**：`getDouyinID` 是靠跟随跳转拿 aweme_id 的，
      * 换成 `www.douyin.com/video/{id}` 反而可能撞上抖音的验证页。
      */
-    if (iddata.type === 'one_work' && await tryQqPanel(e, { platform: 'douyin', url, id: String(iddata.aweme_id) }, flags)) {
+    if (iddata.type === 'one_work' && await tryQqPanel(e, {
+        platform: 'douyin',
+        url,
+        id: String(iddata.aweme_id),
+        // 跳转块用用户原样发的那条（App 分享出来的短链，识别率最高）
+        jumpUrl: url
+    }, flags)) {
         return;
     }
     // 真的开始解析了才提示「本部署烧不了弹幕」——切换面板时要重发面板，那时提示是多余的
@@ -320,7 +326,12 @@ const handleBilibili = (0, ParseForward_1.withParseForward)((0, ErrorHandler_1.w
             platform: 'bilibili',
             url: 'https://www.bilibili.com/video/' + iddata.bvid + (iddata.p ? '?p=' + iddata.p : ''),
             id: String(iddata.bvid),
-            page: iddata.p
+            page: iddata.p,
+            /**
+             * 跳转块用**用户发出来的那条**（通常是 b23.tv 短链）：
+             * 上面那条规范链接带 ?p= 参数，长度上去了 App 剪贴板就认不出来。
+             */
+            jumpUrl: String(url)
         }, flags)) {
         return;
     }
@@ -385,7 +396,13 @@ const handleKuaishou = (0, ParseForward_1.withParseForward)((0, ErrorHandler_1.w
     }
     const iddata = await (0, kuaishou_1.getKuaishouID)(String(kuaishouUrl));
     const WorkData = await (0, kuaishou_1.fetchKuaishouData)(iddata.type, iddata);
-    const kuaishou = new kuaishou_1.Kuaishou(e, iddata);
+    /**
+     * 跳转块要用**用户发出来的那条**：`match(...g)` 拿到的是数组，
+     * `String(数组)` 会把多条链接用逗号拼成一串（一条链接时碰巧正确），
+     * 这里显式取第一个，保证只发出一条干净的原链接。
+     */
+    const kuaishouOrigin = Array.isArray(kuaishouUrl) && kuaishouUrl.length ? String(kuaishouUrl[0]) : String(kuaishouUrl ?? '');
+    const kuaishou = new kuaishou_1.Kuaishou(e, iddata, kuaishouOrigin);
     await (0, ParseOverride_1.runWithParseOverride)({
         ...flags.override,
         /** 面板按钮点出来的：只回「收到请求，开始下载」，不再发「检测到链接，开始解析」 */
@@ -427,7 +444,7 @@ const handleXiaohongshu = (0, ParseForward_1.withParseForward)((0, ErrorHandler_
         return;
     }
     const iddata = await (0, xiaohongshu_1.getXiaohongshuID)(url);
-    const xiaohongshu = new xiaohongshu_1.Xiaohongshu(e, iddata);
+    const xiaohongshu = new xiaohongshu_1.Xiaohongshu(e, iddata, url);
     await (0, ParseOverride_1.runWithParseOverride)({
         ...flags.override,
         fromPanel: flags.panelToken !== undefined || flags.panel !== undefined

package/lib/karin/module/db/model.js

@@ -27,6 +27,14 @@ exports.TABLE = {
     statsMetric: 'kkk.statistics.metric',
 };
 /* ------------------------------ 建表 ------------------------------ */
+/**
+ * 定长字符串字段。
+ *
+ * 走索引的字段必须给长度（见文件头「为什么索引字段都写了明确长度」），
+ * 这里的数字都是按实际数据留的余量：群号 / QQ 号 / 作品 id 这类最多几十个字符，
+ * 抖音 sec_uid 最长见过 76，给 128。
+ */
+const str = (length) => ({ type: 'string', length });
 /** 进程内只建一次（插件热重载时 apply 会再跑一遍，重复 extend 没意义） */
 let modelsReady = false;
 /**
@@ -39,162 +47,162 @@ const extendModels = (ctx) => {
     modelsReady = true;
     // ---------- 抖音 ----------
     ctx.model.extend(exports.TABLE.douyinBot, {
-        id: 'string',
-        createdAt: 'string',
-        updatedAt: 'string',
+        id: str(64),
+        createdAt: str(32),
+        updatedAt: str(32),
     }, { primary: 'id' });
     ctx.model.extend(exports.TABLE.douyinGroup, {
-        id: 'string',
-        botId: 'string',
-        createdAt: 'string',
-        updatedAt: 'string',
+        id: str(64),
+        botId: str(64),
+        createdAt: str(32),
+        updatedAt: str(32),
     }, { primary: ['id', 'botId'] });
     ctx.model.extend(exports.TABLE.douyinUser, {
-        sec_uid: 'string',
-        short_id: 'string',
+        sec_uid: str(128),
+        short_id: str(64),
         remark: 'string',
         living: 'boolean',
-        filterMode: 'string',
-        createdAt: 'string',
-        updatedAt: 'string',
+        filterMode: str(16),
+        createdAt: str(32),
+        updatedAt: str(32),
     }, { primary: 'sec_uid' });
     ctx.model.extend(exports.TABLE.douyinSubscription, {
-        groupId: 'string',
-        sec_uid: 'string',
-        createdAt: 'string',
-        updatedAt: 'string',
+        groupId: str(64),
+        sec_uid: str(128),
+        createdAt: str(32),
+        updatedAt: str(32),
     }, { primary: ['groupId', 'sec_uid'] });
     ctx.model.extend(exports.TABLE.douyinAwemeCache, {
         id: 'unsigned',
-        aweme_id: 'string',
-        sec_uid: 'string',
-        groupId: 'string',
-        pushType: 'string',
-        createdAt: 'string',
-        updatedAt: 'string',
+        aweme_id: str(64),
+        sec_uid: str(128),
+        groupId: str(64),
+        pushType: str(32),
+        createdAt: str(32),
+        updatedAt: str(32),
     }, { autoInc: true, unique: [['aweme_id', 'sec_uid', 'groupId', 'pushType']] });
     ctx.model.extend(exports.TABLE.douyinFilterWord, {
         id: 'unsigned',
-        sec_uid: 'string',
-        word: 'string',
-        createdAt: 'string',
-        updatedAt: 'string',
+        sec_uid: str(128),
+        word: str(128),
+        createdAt: str(32),
+        updatedAt: str(32),
     }, { autoInc: true, unique: [['sec_uid', 'word']] });
     ctx.model.extend(exports.TABLE.douyinFilterTag, {
         id: 'unsigned',
-        sec_uid: 'string',
-        tag: 'string',
-        createdAt: 'string',
-        updatedAt: 'string',
+        sec_uid: str(128),
+        tag: str(128),
+        createdAt: str(32),
+        updatedAt: str(32),
     }, { autoInc: true, unique: [['sec_uid', 'tag']] });
     ctx.model.extend(exports.TABLE.douyinListSnapshot, {
         id: 'unsigned',
-        sec_uid: 'string',
-        pushType: 'string',
-        aweme_id: 'string',
-        createdAt: 'string',
-        updatedAt: 'string',
+        sec_uid: str(128),
+        pushType: str(32),
+        aweme_id: str(64),
+        createdAt: str(32),
+        updatedAt: str(32),
     }, { autoInc: true, unique: [['sec_uid', 'pushType', 'aweme_id']] });
     // ---------- B站 ----------
     ctx.model.extend(exports.TABLE.bilibiliBot, {
-        id: 'string',
-        createdAt: 'string',
-        updatedAt: 'string',
+        id: str(64),
+        createdAt: str(32),
+        updatedAt: str(32),
     }, { primary: 'id' });
     ctx.model.extend(exports.TABLE.bilibiliGroup, {
-        id: 'string',
-        botId: 'string',
-        createdAt: 'string',
-        updatedAt: 'string',
+        id: str(64),
+        botId: str(64),
+        createdAt: str(32),
+        updatedAt: str(32),
     }, { primary: ['id', 'botId'] });
     ctx.model.extend(exports.TABLE.bilibiliUser, {
         host_mid: 'unsigned',
         remark: 'string',
-        filterMode: 'string',
-        createdAt: 'string',
-        updatedAt: 'string',
+        filterMode: str(16),
+        createdAt: str(32),
+        updatedAt: str(32),
     }, { primary: 'host_mid' });
     ctx.model.extend(exports.TABLE.bilibiliSubscription, {
-        groupId: 'string',
+        groupId: str(64),
         host_mid: 'unsigned',
-        createdAt: 'string',
-        updatedAt: 'string',
+        createdAt: str(32),
+        updatedAt: str(32),
     }, { primary: ['groupId', 'host_mid'] });
     ctx.model.extend(exports.TABLE.bilibiliDynamicCache, {
         id: 'unsigned',
-        dynamic_id: 'string',
+        dynamic_id: str(64),
         host_mid: 'unsigned',
-        groupId: 'string',
-        dynamic_type: 'string',
-        createdAt: 'string',
-        updatedAt: 'string',
+        groupId: str(64),
+        dynamic_type: str(32),
+        createdAt: str(32),
+        updatedAt: str(32),
     }, { autoInc: true, unique: [['dynamic_id', 'host_mid', 'groupId']] });
     ctx.model.extend(exports.TABLE.bilibiliFilterWord, {
         id: 'unsigned',
         host_mid: 'unsigned',
-        word: 'string',
-        createdAt: 'string',
-        updatedAt: 'string',
+        word: str(128),
+        createdAt: str(32),
+        updatedAt: str(32),
     }, { autoInc: true, unique: [['host_mid', 'word']] });
     ctx.model.extend(exports.TABLE.bilibiliFilterTag, {
         id: 'unsigned',
         host_mid: 'unsigned',
-        tag: 'string',
-        createdAt: 'string',
-        updatedAt: 'string',
+        tag: str(128),
+        createdAt: str(32),
+        updatedAt: str(32),
     }, { autoInc: true, unique: [['host_mid', 'tag']] });
     // ---------- 统计 ----------
     ctx.model.extend(exports.TABLE.statsParse, {
         id: 'unsigned',
-        groupId: 'string',
-        userId: 'string',
-        platform: 'string',
+        groupId: str(64),
+        userId: str(64),
+        platform: str(32),
         parseCount: 'unsigned',
-        createdAt: 'string',
-        updatedAt: 'string',
+        createdAt: str(32),
+        updatedAt: str(32),
     }, { autoInc: true, unique: [['groupId', 'userId', 'platform']] });
     ctx.model.extend(exports.TABLE.statsHistory, {
         id: 'unsigned',
-        date: 'string',
+        date: str(16),
         totalParses: 'unsigned',
         douyin: 'unsigned',
         bilibili: 'unsigned',
         kuaishou: 'unsigned',
         xiaohongshu: 'unsigned',
-        createdAt: 'string',
+        createdAt: str(32),
     }, { autoInc: true, unique: [['date']] });
     ctx.model.extend(exports.TABLE.statsGlobal, {
-        key: 'string',
+        key: str(64),
         value: 'unsigned',
-        updatedAt: 'string',
+        updatedAt: str(32),
     }, { primary: 'key' });
     ctx.model.extend(exports.TABLE.statsGroupHistory, {
-        groupId: 'string',
-        date: 'string',
-        platform: 'string',
+        groupId: str(64),
+        date: str(16),
+        platform: str(32),
         parseCount: 'unsigned',
-        updatedAt: 'string',
+        updatedAt: str(32),
     }, { primary: ['groupId', 'date', 'platform'] });
     ctx.model.extend(exports.TABLE.statsHour, {
-        groupId: 'string',
+        groupId: str(64),
         hour: 'unsigned',
-        platform: 'string',
+        platform: str(32),
         parseCount: 'unsigned',
-        updatedAt: 'string',
+        updatedAt: str(32),
     }, { primary: ['groupId', 'hour', 'platform'] });
     ctx.model.extend(exports.TABLE.statsWorkType, {
-        groupId: 'string',
-        platform: 'string',
-        workType: 'string',
+        groupId: str(64),
+        platform: str(32),
+        workType: str(32),
         parseCount: 'unsigned',
-        updatedAt: 'string',
+        updatedAt: str(32),
     }, { primary: ['groupId', 'platform', 'workType'] });
     ctx.model.extend(exports.TABLE.statsMetric, {
-        groupId: 'string',
-        metric: 'string',
-        bucket: 'string',
+        groupId: str(64),
+        metric: str(32),
+        bucket: str(32),
         parseCount: 'unsigned',
-        updatedAt: 'string',
+        updatedAt: str(32),
     }, { primary: ['groupId', 'metric', 'bucket'] });
 };
 exports.extendModels = extendModels;