koishi-plugin-kkk 3.8.0 → 3.9.1

package/CHANGELOG.md

@@ -1,5 +1,55 @@
 # 更新日志
 
+## 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 自带的数据库服务。
+> 数据统一落在宿主配置的那个库里（sqlite / mysql / postgres 都行），备份和迁移跟着宿主走，
+> 不用再单独惦记插件数据目录里那几个 `.db` 文件。
+> **代价：过滤词 / 过滤标签和解析统计历史会从零开始**（订阅关系不受影响，每次启动自动从推送列表重建）。
+
+### 数据库改用 Koishi 原生数据库服务
+
+- 以前插件自己在数据目录里开三个 sqlite 文件（`douyin.db` / `bilibili.db` / `statistics.db`）；
+  现在所有数据都走 Koishi 的 `ctx.database`，表由插件注册（`kkk.douyin.*` / `kkk.bilibili.*` / `kkk.statistics.*`），
+  落在宿主配置的那一个库里（sqlite / mysql / postgres 都行），插件不再创建任何 sqlite 文件。
+- **`database` 服务变成必选**：没有配置数据库插件时 Koishi 会直接不加载本插件（以前是可选的，因为那时插件自己建库）。
+- **旧库不迁移**：三个旧 `.db` 文件保留不动，但不再被读取。订阅关系每次启动都会从配置里的推送列表
+  （`config.json` 的 `pushlist`）自动重建，**不受影响**；**过滤词 / 过滤标签、解析统计历史会从零开始**。
+- 想保留过滤词或统计历史的，可以在切换前自己从旧 `.db` 里导出，或改配置里的推送列表重新加过滤规则。
+
 ## 3.8.0
 
 > 抖音解析修好了。抖音那边改了风控规则，**换 cookie 是没用的** —— 问题出在解析用的那个库太旧；

package/lib/build-metadata.json

@@ -1,10 +1,10 @@
 {
-  "version": "3.8.0",
-  "buildTime": "2026-09-26T03:37:45.450Z",
-  "buildTimestamp": 1790393865451,
+  "version": "3.9.1",
+  "buildTime": "2026-09-29T10:19:42.069Z",
+  "buildTimestamp": 1790677182093,
   "name": "koishi-plugin-kkk",
   "description": "抖音 / B站 / 快手 / 小红书 视频解析与动态推送，带 QQ 交互面板与弹幕烧录（karin-plugin-kkk 的 Koishi 移植版）",
   "homepage": "https://github.com/maimai993/koishi-plugin-kkk#readme",
-  "commitHash": "d5bd8abb16c68f3f03575a4f8de736512e55e94b",
-  "shortCommitHash": "d5bd8ab"
+  "commitHash": "0dde6fc426986698fb0e937768eb4aa86d24f2d4",
+  "shortCommitHash": "0dde6fc"
 }

package/lib/index.js

@@ -119,13 +119,18 @@ try {
 catch { /* 同上 */ }
 exports.name = 'kkk';
 exports.inject = {
+    // database：**必选**。订阅关系、推送缓存、解析统计全走 Koishi 原生数据库服务
+    // （表由 ctx.model.extend 注册，落在宿主自己的库里，插件不再自己开 sqlite 文件）。
+    // 之前它是 optional，因为那会儿插件自己建库；现在没有数据库服务就没有地方存数据，
+    // 直接声明成必选，让 Koishi 在没有配置数据库插件时明确地不加载本插件。
+    required: ['database'],
     // server 只给「插件自带控制台」用，已经移除；这里留着不需要的服务反而会拖慢加载
     // ffmpeg：由 koishi-plugin-ffmpeg-path 提供，兼容层的 ffmpeg()/ffprobe() 会优先用它
     // assets：koishi-plugin-assets-qqbot-part-file 之类提供的图床服务，
     // 面板卡片要上传成 https 地址才能放进 QQ 的 markdown 图片里
     // 渲染：只用浏览器渲染服务（koishi-plugin-puppeteer 或同类插件）
     // 3.5.0 起不再支持 shotkit 内核（它在 Windows 上加载不了 https 资源，卡片会缺图）
-    optional: ['puppeteer', 'database', 'http', 'ffmpeg', 'assets', 'server', 'console']
+    optional: ['puppeteer', 'http', 'ffmpeg', 'assets', 'server', 'console']
 };
 /**
  * 配置表单 = 「Koishi 集成选项」 + 「上游插件配置」。
@@ -1112,11 +1117,11 @@ async function apply(ctx, rawConfig) {
             logger.warn('加载 app %s 失败（该功能暂不可用）: %s', app, error?.message ?? error);
         }
     }
-    // 初始化数据库实例（对应 Karin 版 setup.ts 的 initAllDatabases）
+    // 初始化数据库实例（走 Koishi 原生数据库服务 ctx.database）
     // 原实现用顶层 await 立即初始化，CJS 下改成在这里显式引导，否则 module/db 导出的实例是 null
     try {
         const { bootstrapDatabases } = await Promise.resolve().then(() => __importStar(require('./karin/module/db')));
-        const { douyinDB, bilibiliDB, statisticsDB } = await bootstrapDatabases();
+        const { douyinDB, bilibiliDB, statisticsDB } = await bootstrapDatabases(ctx);
         logger.debug('数据库初始化完成：%s / %s / %s', douyinDB.constructor.name, bilibiliDB.constructor.name, statisticsDB.constructor.name);
     }
     catch (error) {