koishi-plugin-kkk 3.4.1 → 3.5.0

package/CHANGELOG.md

@@ -1,5 +1,95 @@
 # 更新日志
 
+## 3.5.0
+
+> 这一版三件事：**B站互动视频能玩了**（能一路选剧情、还能出剧情图）、**合并转发里能单独控制流程图**，
+> 另外把渲染统一成了浏览器 —— **彻底删掉 shotkit 内核**（它在 Windows 上加载不了远程图片，
+> 卡片里的封面、头像一直是空白框）。
+
+### B站互动视频：剧情能选着玩
+
+群里发一条互动视频的链接，机器人照常把视频和卡片发出来，然后**一段一段问你怎么选**：
+
+- QQ 官方机器人上是按钮（点一下就行；最后一个按钮固定是「渲染流程图」）；
+  其它适配器发纯文字，一行一个选项（回复字母、数字，或者直接回选项原文都认）。
+- 只有第一组选项带标题和玩法说明，之后只发选项本身，不会越聊越长；发新一条时会撤回上一条选项。
+- **认不出的回复不会插话**：群里别人正常聊天、你自己随便说句话，机器人都不会来一句「没听懂」，
+  也不会重发选项，就安静等着。等不到人（180 秒）就收尾：
+  「互动视频先玩到这里～想接着玩就再发一次链接」。
+- 走到结局会撤回最后一条选项，说一句「互动视频走到结局了」，并把结局位置再画一张图。
+- 剧情是**后台跑的**，不会拖慢解析：视频该发还是马上发。
+
+**剧情图（流程图）**：把整条剧情画成一张思维导图，有哪几条分支、哪里是结局，一张图看完 ——
+你走过的分支会加粗高亮（图例写着「高亮的是你已经走过的路」），B站 的默认选项标「默认」；
+分支太多一次画不完，会注明「剧情太长，图上只画了前半部分分支」。
+
+- 开关在 **通用 → 解析时发送的内容 → 流程图**（默认不勾）。不勾也能正常玩剧情，只是不出图。
+- 想随时补一张：QQ 官方是选项按钮里的「渲染流程图」，其它平台回复「渲染流程图」；
+  当前没有进行中的剧情时会提示「现在没有正在进行的互动视频，发一条互动视频链接就能玩」。
+- 只有互动视频有这套玩法，普通视频完全不受影响；接口取不到剧情数据时安静跳过，不会报错刷屏。
+- 顺带修好了面板里「流程图」这个勾选项一直不出现的问题：面板的候选项是打包时写死的，
+  之前的补丁找错了地方、还静默失败 —— 控制台里能看到、面板里没有。现在两边都有。
+
+### 合并转发：流程图可以单独勾
+
+- 「合并转发内容」的候选里多了 **流程图**（B站页和通用页各一份）：勾了就进聊天记录，
+  不勾就照旧单独发出去 —— 和文字、图片、视频、文件是同一套规则，**不会丢内容**。
+- 抖音 / 快手 / 小红书 的列表里没有这一项：它们没有剧情图，加了也是永远匹配不到的假选项
+  （和当初去掉「语音 / markdown」是同一个理由）。
+- 另外堵了一个隐患：剧情图是后台画的，可能比解析结束还晚 —— 以前这种「晚到的内容」会被收进
+  一个已经发完的收集袋，再也没人发出去（表现就是内容凭空消失）。现在解析一结束就关掉袋子，
+  晚到的一律直发。
+
+### 渲染：只用浏览器，删掉 shotkit 内核
+
+- 以前「优先渲染器」可以在 **shotkit 内核**（默认）和**浏览器**之间选。内核在 Windows 上
+  **加载不了 https 资源** —— 卡片里的远程封面、头像全是空白框；它还会照样去请求这些地址、
+  一直等到超时（实测页面里只要有一个连不上的图片，截图就从 1.5 秒变成 22 秒）。
+- 3.5.0 起**只支持浏览器渲染**：装 koishi-plugin-puppeteer 或同类插件即可。
+  面板里那个「优先渲染器」选项已经撤掉，老配置里的值会被忽略（不用手改）。
+- 没装浏览器渲染服务时会直说「需要安装浏览器渲染服务（koishi-plugin-puppeteer 或同类插件）
+  才能渲染图片」，不再悄悄换内核，也不会给你一张缺图、裂图的卡片。
+- 只对内核有用的那套「摘掉远程图片」处理一并删掉（浏览器本来就能正常加载远程图）；
+  以前为内核做的性能降级（全屏噪点层替换、失效字体剔除）保留了下来 —— 对浏览器同样是净赚。
+
+### 出错时的卡片与诊断
+
+- **错误卡片终于发得出去**：以前一遇到大报错，卡片会渲染成 2880×40000（45MB）甚至更长，
+  光渲染 20 多秒，而这么大的图 QQ 必然拒收 —— 等于「报错本身也发不出去」。
+  现在日志只留末尾 200 行、每行截断、超长 base64 折起来，卡片稳定在能发出去的尺寸。
+- 卡片上会印 **上报编号 + 详情页地址 + 反馈群**。加群链接以前是拿群号拼的，点开是 404，
+  现在是真的分享链接。
+- 卡片新增「解析库错误诊断」：AMAGI 码 / 平台业务码 / HTTP 状态 / 请求 ID / 实际请求次数 / 耗时，
+  外加平台原文、请求轨迹，以及「这类错误重试有没有用」的判断；报错归到哪个平台也修了
+  （以前小红书的报错一律被算成 system）。
+- 卡片上的适配器一栏终于显示**真的适配器名和版本**（取的是实现端，比如 NapCat 自己的版本）——
+  以前读的是 Koishi 的字段，那里压根没有版本号，于是卡片上永远挂着一个空的版本号。
+- 「kkk版本」诊断卡片：多了构建一致性徽章、本版变更（随包带的更新日志），以及一句隐私声明 ——
+  这张图**不采集**账号、主机名、用户目录、网络地址、环境变量、启动参数和适配器凭据；
+  之所以要写清楚，是因为它可能被发到群里。
+- 「kkk更新日志」渲染失败时改发**纯文字**（截断后发送），不再是「什么都看不到，只剩一张错误卡片」。
+
+---
+
+## 3.4.2
+
+### 出错上报的内容更全，也更好看懂
+
+- 上报的「来源信息」以前常常是一排「—」：推送任务的会话是合成的，没有群号这些东西。现在改用框架自己的接口补：
+  机器人名、群名（用 bot.getGuild 查出来）、用户名都会显示，卡在哪一步（阶段）也会自动标出来 —— 一眼就知道是谁在哪个群、发的什么。
+- **顺便把配置也传上去了**，复现问题时有依据：你改过的设置、画质、发送内容、推送列表都会带过去。
+  两条硬规矩：**Cookie 一个都不传**（接口库里的 SESSDATA / bili_jct / 抖音那一串整块丢掉），凡是名字像 token / secret / password 的字段一律显示成 ***。
+- **日志只传本插件（kkk）的行**：以前会把整台机器所有插件的日志尾巴都传上去，现在只挑 kkk 相关的，看的人不用再大海捞针。
+
+### 机器人掉线时不再是一句英文报错
+
+- 适配器掉线后，机器人的对象还在，但底层连接已经没了 —— 这时推送会让适配器内部炸出一句
+  TypeError: this._request is not a function，你只看到一堆英文堆栈。
+  现在会提前拦住，并说清楚：机器人 2092582839 当前不在线（status=0），这条消息发不出去；等它重新上线后下次推送会正常发出。
+- 指定的机器人掉线时**不会偷偷换成另一个机器人发**（那样会串号），只会如实报出来。
+
+---
+
 ## 3.4.1
 
 ### 抖音解析失败时的提示看得懂了