koishi-plugin-kkk 4.0.0 → 4.0.1

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # 更新日志
 
+## 4.0.1
+
+> 修一个 4.0.0 带出来的问题：开了「强制在线播放」之后，**番剧还是会下载完直接发文件**，
+> 在发不出视频文件的机器人上（比如 B站私聊机器人）就卡在上传那一步报错。
+> 普通视频不受影响 —— 它一直都是给链接的。
+
+### 修：番剧不走「强制在线播放」
+
+- 「在线播放器设置」里的「强制在线播放的适配器」（默认填的是 `bilibili`）对**普通视频**
+  一直是生效的：解析完给一条在线播放链接，不发视频文件。
+- 但**番剧**走的是另一条分支，那一条漏了这一步 —— 于是照旧把视频下下来发文件，
+  碰上发不出视频文件的机器人就卡在上传那一步报错。
+- 现在两条分支一致了：**番剧也只给在线播放链接**，不再尝试发文件。
+
 ## 4.0.0
 
 > 这是 3.0 之后攒的一次大版本。下面把 **3.0 到 4.0 之间所有你用得出来的变化**

package/lib/build-metadata.json

@@ -1,10 +1,10 @@
 {
-  "version": "4.0.0",
-  "buildTime": "2026-10-05T14:30:11.577Z",
-  "buildTimestamp": 1791210611583,
+  "version": "4.0.1",
+  "buildTime": "2026-10-06T06:35:53.430Z",
+  "buildTimestamp": 1791268553468,
   "name": "koishi-plugin-kkk",
   "description": "抖音 / B站 / 快手 / 小红书 视频解析与动态推送，带 QQ 交互面板与弹幕烧录（karin-plugin-kkk 的 Koishi 移植版）",
   "homepage": "https://github.com/maimai993/koishi-plugin-kkk#readme",
-  "commitHash": "d495df3b2707919944e94f53a90a94f1f79ffafa",
-  "shortCommitHash": "d495df3"
+  "commitHash": "46d0341ac561e5273722748b928b2284fd83904f",
+  "shortCommitHash": "46d0341"
 }

package/lib/karin/platform/bilibili/bilibili.js

@@ -661,6 +661,18 @@ class Bilibili extends utils_1.Base {
                 break;
             }
             case 'bangumi_video_info': {
+                /**
+                 * **强制在线播放**（通用 → 在线播放器设置 → 强制在线播放的适配器）：
+                 * 和 `one_video` 一样，**进分支第一件事**就调。
+                 *
+                 * ⚠️ 以前只有 `one_video` 调了这一句，番剧这条分支没有 ——
+                 * 于是「B站私聊机器人（platform === 'bilibili'）」这类发不出视频文件的适配器上，
+                 * **普通视频走在线播放、番剧却照旧下载后发文件**，最后卡在上传那一步报错
+                 * （用户反馈：「我不是设置了强制在线播放吗？为什么解析番剧还是会直接发文件」）。
+                 * 标记之后下面 `getvideo → sendPreparedVideo` 读 `isOnlinePlayerRequest()`
+                 * 会走播放页那条路，不再碰上传。
+                 */
+                (0, player_1.applyForceOnlinePlayer)(this.e);
                 const videoInfo = await this.amagi.bilibili.fetcher.fetchBangumiInfo({
                     [iddata.isEpid ? 'ep_id' : 'season_id']: iddata.realid
                 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-kkk",
-  "version": "4.0.0",
+  "version": "4.0.1",
   "description": "抖音 / B站 / 快手 / 小红书 视频解析与动态推送，带 QQ 交互面板与弹幕烧录（karin-plugin-kkk 的 Koishi 移植版）",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",

package/scripts/probe-force-online-player.cjs

@@ -0,0 +1,178 @@
+/**
+ * 探针：「强制在线播放的适配器」有没有覆盖到**每一条会发视频文件的分支**。
+ *
+ * ## 这个 bug 是怎么来的
+ *
+ * 「强制在线播放」（通用 → 在线播放器设置，`forceOnlinePlayer`，默认 `bilibili`）
+ * 是靠平台 handler 一进来就调 `applyForceOnlinePlayer(e)` 生效的 —— 它把本次解析
+ * 标记成在线播放，后面 `sendPreparedVideo` 才会走播放页而不是上传文件。
+ *
+ * 但只有 `bilibili.ts` 的 `one_video` 这一支调了，**`bangumi_video_info`（番剧）没调** ——
+ * 于是 B站私聊机器人（platform === 'bilibili'，发不出视频文件）上出现：
+ * 普通视频给链接、番剧照旧下载后发文件、最后卡在上传那一步报错。
+ * 用户原话：「我不是设置了强制在线播放吗？为什么解析番剧还是会直接发文件」。
+ *
+ * 这类漏调**没有任何编译期信号**（tsc 一条不报，构建也过），只能靠静态闸门盯住。
+ *
+ * ## 盯什么
+ *
+ * 1. 静态：四个平台 handler 里，凡是**会走到发送视频**的 `case` 分支，
+ *    体内必须出现 `applyForceOnlinePlayer(`；
+ * 2. 运行时：名单解析（逗号 / 数组 / 中文逗号 / 空）、
+ *    适配器在名单里 → 本次真的被标记成在线播放、不在名单里 → 不动。
+ */
+const fs = require('node:fs')
+const path = require('node:path')
+
+const root = path.join(__dirname, '..')
+const lib = path.join(root, 'lib')
+
+let failed = 0
+const check = (name, ok, detail) => {
+  console.log((ok ? '  \u2714 ' : '  \u2718 ') + name + (detail ? '  \u2192 ' + detail : ''))
+  if (!ok) failed++
+}
+
+/** 这四个平台 handler 里出现这些调用，说明这一支会真的把视频发出去 */
+const SENDS_VIDEO = /getvideo\(|sendPreparedVideo\(|prepareVideo\(|downloadVideo\(|uploadFile\(/
+
+/**
+ * 去掉注释再判 —— ⚠️ 不去掉会**误报**：
+ * 直播那一支的注释里写着「prepareVideo() 把视频下下来…sendPreparedVideo() 再上传」，
+ * 正文一行调用都没有，按正文判会把它算成「漏了」。
+ */
+const stripComments = (s) =>
+  s.replace(/\/\*[\s\S]*?\*\//g, '').replace(/(^|\s)\/\/[^\n]*/g, '$1')
+
+/** 把源码按顶层 `case 'xxx': {` 切成一段一段（缩进 6 空格的那层 switch） */
+const splitBranches = (src) => {
+  const marks = [...src.matchAll(/\n {6}case '([^']+)':\s*\{/g)]
+  return marks.map((m, i) => {
+    const start = m.index
+    /** 下一个 case 之前；同时**不能越过 switch 的收尾**（缩进 4 空格的 `}`），
+     *  否则最后一支会一路吃到后面的类方法（那些方法名本身就是 `prepareVideo`） */
+    const next = i + 1 < marks.length ? marks[i + 1].index : src.length
+    const close = src.indexOf('\n    }', start)
+    const end = close > 0 && close < next ? close : next
+    return { name: m[1], start, end, body: stripComments(src.slice(start, end)) }
+  })
+}
+
+console.log('=== 1. 静态：会发视频的分支都调了 applyForceOnlinePlayer ===')
+
+for (const file of ['bilibili/bilibili.ts', 'douyin/douyin.ts', 'kuaishou/kuaishou.ts', 'xiaohongshu/xiaohongshu.ts']) {
+  const src = fs.readFileSync(path.join(root, 'src', 'karin', 'platform', file), 'utf8')
+  const branches = splitBranches(src)
+  const offending = []
+  let videoBranches = 0
+  for (const branch of branches) {
+    if (!SENDS_VIDEO.test(branch.body)) continue
+    videoBranches++
+    if (!/applyForceOnlinePlayer\(/.test(branch.body)) offending.push(branch.name)
+  }
+  check(file + '：' + videoBranches + ' 个会发视频的分支都标记了强制在线播放',
+    offending.length === 0, offending.length ? '漏了 ' + offending.join(', ') : branches.map((b) => b.name).join(', '))
+}
+
+{
+  /**
+   * 单独点名两支（不依赖上面的正则判据，改坏了上面的闸门也不会把这两条一起放过去）：
+   * B站**普通视频**和**番剧**是两条不同的分支，以前只有前者调了。
+   */
+  const src = fs.readFileSync(path.join(root, 'src', 'karin', 'platform', 'bilibili', 'bilibili.ts'), 'utf8')
+  for (const name of ['one_video', 'bangumi_video_info']) {
+    const branch = splitBranches(src).find((b) => b.name === name)
+    check('  B站 ' + name + ' 这一支调了 applyForceOnlinePlayer',
+      !!branch && /applyForceOnlinePlayer\(this\.e\)/.test(branch.body))
+  }
+  /** 顺序也不能反：必须在发视频之前标记 */
+  const bangumi = splitBranches(src).find((b) => b.name === 'bangumi_video_info').body
+  const firstSend = Math.min(
+    ...['getvideo(', 'sendPreparedVideo('].map((k) => {
+      const at = bangumi.indexOf(k)
+      return at < 0 ? Number.MAX_SAFE_INTEGER : at
+    }))
+  const firstMark = bangumi.indexOf('applyForceOnlinePlayer(')
+  check('  番剧分支里标记发生在「发视频」之前（顺序不能反）',
+    firstMark >= 0 && firstMark < firstSend, '标记 @' + firstMark + ' / 发送 @' + firstSend)
+}
+
+console.log('=== 2. 运行时：名单解析 + 真的把本次标记成在线播放 ===')
+
+const runtime = require(path.join(lib, 'compat/runtime.js'))
+runtime.bindRuntime({
+  ctx: { config: { port: 5200, prefix: '' } },
+  config: { playerEnabled: true, forceOnlinePlayer: 'bilibili' },
+  dataRoot: fs.mkdtempSync(path.join(require('node:os').tmpdir(), 'kkk-probe-force-'))
+})
+require(path.join(lib, 'compat/logger.js')).setLogger({ debug () {}, info () {}, mark () {}, warn () {}, error () {} })
+
+const player = require(path.join(lib, 'player', 'index.js'))
+const { runWithParseOverride, getParseOverride } = require(path.join(lib, 'karin', 'module', 'utils', 'ParseOverride.js'))
+
+check('默认配置下 bilibili 在强制名单里', player.isForceOnlinePlayerAdapter('bilibili') === true)
+check('qq 不在名单里（不强制）', player.isForceOnlinePlayerAdapter('qq') === false)
+check('大小写不敏感（Bilibili 也算）', player.isForceOnlinePlayerAdapter('Bilibili') === true)
+check('空 / 未配置不强制', player.isForceOnlinePlayerAdapter('') === false && player.isForceOnlinePlayerAdapter(undefined) === false)
+
+/** 直接换一份配置验「逗号分隔 + 中文逗号 + 数组」三种写法 */
+const withConfig = (value, fn) => {
+  runtime.bindRuntime({
+    ctx: { config: { port: 5200, prefix: '' } },
+    config: { playerEnabled: true, forceOnlinePlayer: value },
+    dataRoot: fs.mkdtempSync(path.join(require('node:os').tmpdir(), 'kkk-probe-force-'))
+  })
+  try { return fn() } finally {
+    runtime.bindRuntime({
+      ctx: { config: { port: 5200, prefix: '' } },
+      config: { playerEnabled: true, forceOnlinePlayer: 'bilibili' },
+      dataRoot: fs.mkdtempSync(path.join(require('node:os').tmpdir(), 'kkk-probe-force-'))
+    })
+  }
+}
+check('英文逗号分隔（bilibili,onebot）',
+  withConfig('bilibili,onebot', () => player.isForceOnlinePlayerAdapter('onebot') === true))
+check('中文逗号分隔（bilibili，onebot）',
+  withConfig('bilibili，onebot', () => player.isForceOnlinePlayerAdapter('onebot') === true))
+check('数组写法（["bilibili","onebot"]）',
+  withConfig(['bilibili', 'onebot'], () => player.isForceOnlinePlayerAdapter('onebot') === true))
+check('留空 = 不强制', withConfig('', () => player.isForceOnlinePlayerAdapter('bilibili') === false))
+
+/** 真跑一遍：适配器在名单里 → 本次被标记；不在 → 不动 */
+const run = async () => {
+  await runWithParseOverride({}, async () => {
+    const ok = player.applyForceOnlinePlayer({ bot: { bot: { platform: 'bilibili' } } })
+    check('名单里的适配器：applyForceOnlinePlayer 返回 true', ok === true, String(ok))
+    check('  → 本次真的被标记成在线播放', player.isOnlinePlayerRequest() === true, String(getParseOverride()?.onlinePlayer))
+  })
+  await runWithParseOverride({}, async () => {
+    const ok = player.applyForceOnlinePlayer({ bot: { bot: { platform: 'qq' } } })
+    check('名单外的适配器：不标记', ok === false && player.isOnlinePlayerRequest() === false)
+  })
+  /** 平台名可能挂在 e.platform 上（兼容层真实 Bot 在 bot.bot） */
+  await runWithParseOverride({}, async () => {
+    const ok = player.applyForceOnlinePlayer({ platform: 'bilibili' })
+    check('  → e.platform 这种挂法也认', ok === true, String(ok))
+  })
+  /**
+   * 播放器总开关关掉时不标记 —— 没有播放页可去，
+   * 标记了反而会让视频「下载完却什么都不发」。
+   */
+  runtime.bindRuntime({
+    ctx: { config: { port: 5200, prefix: '' } },
+    config: { playerEnabled: false, forceOnlinePlayer: 'bilibili' },
+    dataRoot: fs.mkdtempSync(path.join(require('node:os').tmpdir(), 'kkk-probe-force-'))
+  })
+  await runWithParseOverride({}, async () => {
+    const ok = player.applyForceOnlinePlayer({ bot: { bot: { platform: 'bilibili' } } })
+    check('总开关关掉时即使平台在名单里也不标记', ok === false && player.isOnlinePlayerRequest() === false)
+  })
+}
+
+run().then(() => {
+  console.log(failed === 0 ? '\n✔ 全部通过' : '\n✘ 有 ' + failed + ' 项没通过')
+  process.exit(failed === 0 ? 0 : 1)
+}).catch((error) => {
+  console.log('探针自己崩了: ' + String(error?.stack ?? error))
+  process.exit(1)
+})

package/src/karin/platform/bilibili/bilibili.ts

@@ -734,6 +734,18 @@ export class Bilibili extends Base {
         break
       }
       case 'bangumi_video_info': {
+        /**
+         * **强制在线播放**（通用 → 在线播放器设置 → 强制在线播放的适配器）：
+         * 和 `one_video` 一样，**进分支第一件事**就调。
+         *
+         * ⚠️ 以前只有 `one_video` 调了这一句，番剧这条分支没有 ——
+         * 于是「B站私聊机器人（platform === 'bilibili'）」这类发不出视频文件的适配器上，
+         * **普通视频走在线播放、番剧却照旧下载后发文件**，最后卡在上传那一步报错
+         * （用户反馈：「我不是设置了强制在线播放吗？为什么解析番剧还是会直接发文件」）。
+         * 标记之后下面 `getvideo → sendPreparedVideo` 读 `isOnlinePlayerRequest()`
+         * 会走播放页那条路，不再碰上传。
+         */
+        applyForceOnlinePlayer(this.e)
         const videoInfo = await this.amagi.bilibili.fetcher.fetchBangumiInfo({
           [iddata.isEpid ? 'ep_id' : 'season_id']: iddata.realid
         })