koishi-plugin-kkk 2.0.1-beta.1 → 2.1.0

package/CHANGELOG.md

@@ -1,24 +1,72 @@
 # 更新日志
 
-## 2.0.1-beta.1（预览版）
+## 2.1.0
 
-> 这是一个**预览版**（npm 上的 `beta` 标签），装着还没正式发布的一批改动。
-> 正式版仍请用 `latest`（当前 **2.0.0**）。预览版建议先在小范围群里试，遇到问题把日志发我。
+> 这一版把之前两个预览版（`2.0.1-beta.1` / `2.0.1-beta.2`，内容已一并收进来）和一次新联动一起发了：
+> **卡片渲染接上了新的高速截图服务 `kkkshot`**，另外修掉几个实测反馈的问题。
 >
-> 这一版只动了一处：把「短时间内不重复解析」从写死的 20 秒变成**可开关 + 可自定义分钟数**。
+> 升级不需要改配置：所有新开关都有默认值；老配置缺这些键时行为与以前一致。
+
+### 本版重点
+- **卡片渲染快 2 倍以上**：新增**联动插件 `koishi-plugin-kkkshot`**（注册 `kkkshot` 服务）。
+  装了它，kkk 会**默认优先用它渲染卡片**；没有装（或它渲染失败）就自动退回 `koishi-plugin-puppeteer`，
+  行为与以前完全一致。本机实测同一张卡片：**1.54s → 0.60s**（详见下面「配套插件」）。
+- **「短时间不重复解析」变成可配置**：通用里新增这个开关 + 「重复解析间隔（分钟）」，
+  去重覆盖面也从「抖音 / B站」扩到**快手 / 小红书**。
+- **合并转发开关语义修正**：打开才合并（触发者身份），**关掉就不合并**、内容逐条发；
+  并且修好了「在面板里打开它却不生效」（面板保存现在会真的写进 config.json）。
+- **权限字段能填用户 ID 了**：修掉「选『指定账号』填 ID 一保存就报 `reading 'logger'`」。
 
 ### 新增
+- **配套插件 `koishi-plugin-kkkshot`（可选）**：给 kkk 用的高速截图服务，注册 `kkkshot` 服务后
+  kkk 检测到它就**默认用它渲染卡片**。它和常规 puppeteer 用法的区别：
+  - **常驻页面池**（默认 2 个页面反复用）而不是每次新建页面再关掉；
+  - 导航只要 `domcontentloaded`，然后**只等字体和图片**（`document.fonts.ready` + 图片 `complete`），
+    不再用 `networkidle0` 白等那一整段静默期；
+  - 按卡片元素自己的盒子 `clip` 截图（贴合卡片、不带白边），页面底色设成卡片底色；
+  - **优先复用 `ctx.puppeteer` 的浏览器**（省内存），没有才自己启动；
+  - 页面用满 `recycleAfter`（默认 100）次回收重建，长跑不涨内存；启动时预热一个页面。
+  - 加载顺序：`kkk` 把 `kkkshot` 声明成**可选依赖** —— 装了就用，没装就退回 puppeteer，不会因为少装它报错。
 - **通用 →「短时间不重复解析」**（默认开启）：同一条链接在一段时间内只解析一次。
   QQ 的指令按钮是「发一条消息 + 再发一个交互事件」，用户连点、客户端重发也会把同一条链接投递两遍，
   跑两遍就是两次「开始解析」、两次下载、两次发送（第二次还常因为缓存已被清理而失败）。
-  去重键包含会话、作品 ID、画质与弹幕开关 —— 换画质、换作品、换群都不会被误伤。
-  关掉这个开关后**每条消息都会解析**，需要反复调试同一条链接时可以临时关掉。
+  去重键包含会话、作品 ID、画质与弹幕开关 —— 换画质、换作品、换群都不会被误伤；关掉后每条消息都会解析。
 - **通用 →「重复解析间隔（分钟）」**（默认 1，可填 1 ~ 60）：上面那个开关打开时才生效，
-  用来决定「多长时间内算重复」；开关关掉时这一项会变灰不可改。填得越大越省事，
-  但也意味着这段时间里你手动再发一次同一条链接会被忽略（想立刻重解析就把开关关掉）。
-  填歪了会自动兜底：超出范围夹到最近的边界（填 0 → 1 分钟，填 90 → 60 分钟），非数字按默认 1 分钟。
-- 去重覆盖面从「抖音 / B站」扩到 **快手 / 小红书**：这两条链路以前完全没有去重，
-  同一条链接被重复投递（连点、客户端重发）会跑两遍；现在四个平台共用同一把锁、同一个开关。
+  开关关掉时这一项在面板里会变灰不可改。取值兜底：超出范围夹到最近的边界（0 → 1 分钟，90 → 60 分钟），
+  非数字按默认 1 分钟。
+- 去重覆盖面扩到 **快手 / 小红书**（这两条链路以前完全没有去重）。
+
+### 修复
+- **「合并转发打开了没用」**（用户实测）：开关在面板里打开、保存也提示「已保存」，
+  但日志还是「「解析结果合并转发」关着，本次按逐条发送处理」。根因在「面板/控制台设置 → config.json」的同步规则：
+  老规则把「传进来的值正好等于上游默认值」当成「用户没动过」直接跳过，而 `app.fakeForward` 的**默认值就是 true** ——
+  于是「把它打开」等于回到默认值，永远写不进 config.json，插件读到的还是 false。
+  现在**面板保存走 authoritative 模式**（表单里那份配置就是用户想要的，值等于默认值也照写），
+  控制台那条路仍保持保守规则（不拿表单里的默认值盖掉手改的 config.json）；
+  保存后日志会打一行「面板设置已写入 config.json: xxx」，方便确认到底写进去了没有。
+- **「关闭合并转发 还是合并的」**（用户实测）：通用里那个开关以前**只管「转发用谁的身份展示」**，
+  关掉之后照样合并成一条转发。现在它的语义是**要不要合并**：
+  打开 → 一次解析产生的所有内容合并成一条转发（用触发者身份展示）；
+  **关掉 → 不合并**，内容像以前一样一条一条发（过程提示本来就不进转发，这条不受影响）。
+  面板里的标签也从「伪造合并转发消息」改成「**解析结果合并转发**」，说明写清了这两句；
+  控制台字段说明、配置注释同步更新；冒烟里加了「关掉不合并 / 再打开又合并」的用例守着。
+- **选了「指定账号」填上 ID，一保存就报 `Cannot read properties of null (reading 'logger')`**（严重）：
+  这句报错其实是**被盖掉**的 —— 真正的原因是字段值没通过 Schema 校验。
+  `loginPerm` / `permission` / `errorLogSendTo` 这几个「允许手填账号」的字段被渲染成了**枚举下拉**
+  （union of consts），手填的用户 ID 不在选项里，保存时 cordis 的 `resolveConfig` 抛错，
+  而它 emit 的 `internal/error` 又被 `@cordisjs/logger` 的监听器再抛一个 `reading 'logger'` ——
+  用户就只看到这一句，完全看不出该改哪里。
+  现在这几个字段改成普通文本（数组那个是字符串数组）：**用户 ID、关键字、多个用逗号分隔**都能保存，
+  非法类型仍然会被 Schema 拒掉（校验没有形同虚设）；保存失败时的提示也换成能照做的说法，
+  并在日志里带上调用栈，下次再遇到不用猜。
+- **文案说错了**：原来写「选「指定账号」后填 QQ 号」—— Koishi 这边匹配的是**用户 ID**（session.userId），
+  不是 QQ 号。面板的下拉说明与输入框占位符、控制台里的字段说明、以及插件设置里那句
+   「主人账号（QQ 号）」都改成了「用户 ID」。
+
+### 变更
+- 面板标签：**「伪造合并转发消息」→「解析结果合并转发」**（名字要能看出「关掉就逐条发」）。
+- **合并转发开关的语义**：从「只决定展示身份」变成「决定要不要合并」（身份固定为触发者）。
+- 「谁可以触发扫码登录」与「错误日志接收人」的说明统一成「填用户 ID」。
 
 ## 2.0.0