koishi-plugin-kkk 3.3.0-beta.3 → 3.3.2

package/CHANGELOG.md

@@ -1,14 +1,21 @@
 # 更新日志
 
-## 3.3.0-beta.3
+## 3.3.2
+
+> 修 3.3.1 的一个**致命笔误**：播放器模块里一行 import 多写了一层 `..`，导致插件在**加载时**就失败（`Cannot find module '../../compat/runtime'`），整个插件都起不来。构建链路只做转译不解析路径，所以当时没拦住 —— 现在补了一个「每个编译产物都 require 得动」的自测（scripts/smoke-require.cjs）。
+
+## 3.3.1
+
+> 3.3.0-beta.1 ~ beta.3 是给先行测试的人用的预览版，内容全部并进这一版；从 3.2.2 直接升上来就行。
 
 ### 修了两个「设置根本没生效」的问题
 
 - **「强制在线播放的适配器」这类设置以前是静默失效的**：运行时配置是一份**手写白名单**，新加的开关（强制在线播放的适配器、面板「在线看」列、按需切片、解析去重…）忘了往里补一行，运行时读到的就是 undefined —— 表现就是 B站私聊明明配了强制在线播放，**还是去下载并发视频文件**。现在改成「字段表里的默认值打底 + 归一化覆盖」，以后再加开关不会漏。
 - **不支持的适配器不再尝试合并转发**：判断「这个适配器支不支持聊天记录」用的是**黑名单**（只排除 QQ 官方），于是任何自定义适配器都被当成支持 —— B站私聊适配器（platform 就是 bilibili）也被算进去了，整条转发发出去「没有拿到消息 ID」，连退回来的逐条发送也失败，用户什么都没收到。现在改成**白名单**（OneBot 系平台名，或适配器自带 sendGroupForwardMsg/sendPrivateForwardMsg），并会在日志里写明「适配器 xxx 不支持合并转发，本次逐条发送」。
-## 3.3.0-beta.2
 
-> **预览版**：给愿意先试的人用。npm 上默认安装的（latest）还是 3.2.2，想装这个用 npm i koishi-plugin-kkk@beta（或者面板里的「检查更新」换成 beta 通道）。
+### 播放链接显示「已过期」的原因说清楚了
+
+- **端口被别的实例占掉，链接就会指向「另一台机器人」**：同机跑两台 Koishi（正式 + 测试）时只有一台能监听播放器端口。占不到端口的那台退回 Koishi 自己的端口，而域名反代的是独立端口 —— 用户点开链接访问的其实是**抢到端口的那台实例**，它的会话表里没有这个 token，页面就显示「链接已过期」。现在遇到这种情况会打一条**明确的警告**（写清「链接会显示已过期，请换端口或停掉占端口的那台实例」），不再是含糊的「启动失败」；生成链接时也会提醒一次。
 
 ### 控制台里的设置全部隐藏，面板补上「Koishi 设置」
 

package/lib/player/index.js

@@ -199,6 +199,8 @@ function forceOnlinePlayerAdapters() {
     }
 }
 /** 这个**适配器**是不是在「强制在线播放」名单里 */
+/** 「本实例独立端口没监听上」这条只提醒一次，不然每条链接都刷一行 */
+let warnedStandaloneMismatch = false;
 function isForceOnlinePlayerAdapter(platform) {
     if (!platform)
         return false;
@@ -366,8 +368,20 @@ let warnedLocalBase = false;
 function buildPlayerLink(token) {
     const config = (0, runtime_1.tryGetRuntime)()?.config ?? {};
     const base = String(config.playerBaseUrl ?? '').replace(/\/+$/, '');
-    if (base)
+    if (base) {
+        /**
+         * 本实例**没监听上独立端口**，但链接指向公网域名 —— 那个域名反代的是独立端口，
+         * 于是用户点开访问的其实是**抢到端口的另一台实例**（它的会话表里没有这个 token），
+         * 页面就会显示「链接已过期」。线上真实故障，这里至少要说清楚一次。
+         */
+        if (!(0, server_1.isStandalonePlayerReady)() && !warnedStandaloneMismatch) {
+            warnedStandaloneMismatch = true;
+            node_karin_1.logger.warn('[在线播放] 本实例没有监听上独立端口（被别的进程占了），但链接指向 ' + base
+                + ' —— 如果那个域名反代到同一个端口，用户点开会看到「链接已过期」（其实连的是抢到端口的那台实例）。'
+                + '请换一个「播放器端口」，或者停掉同机另一台占着该端口的 Koishi 实例');
+        }
         return base + '/kkk/player/' + token;
+    }
     const port = Number(config.playerPort) > 0 ? Number(config.playerPort) : koishiPort();
     const link = 'http://' + localAddress() + ':' + port + '/kkk/player/' + token;
     if (!warnedLocalBase) {

package/lib/player/server.js

@@ -36,7 +36,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PLAYER_ROUTE_PREFIX = void 0;
+exports.isStandalonePlayerReady = exports.PLAYER_ROUTE_PREFIX = void 0;
 exports.sanitizeDownloadName = sanitizeDownloadName;
 exports.downloadDisposition = downloadDisposition;
 exports.handlePlayerRequest = handlePlayerRequest;
@@ -64,10 +64,26 @@ const node_fs_1 = __importDefault(require("node:fs"));
 const node_http_1 = __importDefault(require("node:http"));
 const node_path_1 = __importDefault(require("node:path"));
 const node_karin_1 = require("../compat/node-karin.js");
+// 注意只有一层 .. ：src/player/server.ts → src/compat/runtime（写两层会变成根目录下的 compat，直接 MODULE_NOT_FOUND）
+const runtime_1 = require("../compat/runtime");
 const page_1 = require("./page");
 const store_1 = require("./store");
 /** 路由前缀 */
 exports.PLAYER_ROUTE_PREFIX = '/kkk/player/';
+/** 独立端口是否真的监听上了：没监听上时链接指向的公网域名很可能打不到本实例 */
+let standaloneReady = false;
+/** 查询独立端口是否监听上了（给「生成链接」那边做提示用） */
+const isStandalonePlayerReady = () => standaloneReady;
+exports.isStandalonePlayerReady = isStandalonePlayerReady;
+/** 面板里配的「播放器公网地址」（没配就是空串） */
+function publicBaseUrl() {
+    try {
+        return String((0, runtime_1.tryGetRuntime)()?.config?.playerBaseUrl ?? '').trim();
+    }
+    catch {
+        return '';
+    }
+}
 const TEXT_TYPE = 'text/plain; charset=utf-8';
 const HTML_TYPE = 'text/html; charset=utf-8';
 /** 过期 / 无效令牌的统一回应：页面直接渲染「链接已过期」，接口退回纯文本 */
@@ -405,13 +421,23 @@ function registerPlayerRoutes({ ctx, port }) {
             });
         });
         server.on('error', (error) => {
-            node_karin_1.logger.warn('[在线播放] 播放器端口 ' + port + ' 启动失败（' + String(error?.code ?? error?.message ?? error)
-                + '），已退回 Koishi 自己的端口；请在配置里换一个端口或留空');
+            const code = String(error?.code ?? error?.message ?? error);
+            /**
+             * 端口被别的进程占了：**必须说清楚后果** —— 线上真实故障就是「用户点开播放链接看到『链接已过期』」。
+             *
+             * 成因：这台实例退回 Koishi 自己的端口，而另一台实例（比如同机的测试实例）抢到了这个端口；
+             * 域名反代到该端口 → 用户访问的其实是**另一台实例**，它当然没有这个会话。
+             */
+            node_karin_1.logger.error('[在线播放] 播放器端口 ' + port + ' 被占用（' + code + '），本次退回 Koishi 自己的端口'
+                + (publicBaseUrl() ? '。注意：域名 ' + publicBaseUrl() + ' 反代的就是 ' + port + ' 的话，用户点开链接会看到「链接已过期」'
+                    + ' —— 说明这台实例不是 8888 的占用者（同机另一个 Koishi 实例抢到了），换一个端口或先停掉那台实例' : ''));
+            standaloneReady = false;
             // 端口被占用不能把插件带崩：退回 ctx.server 再挂一遍
             registerOnKoishi(ctx, disposers);
         });
         try {
             server.listen(port, () => {
+                standaloneReady = true;
                 node_karin_1.logger.info('[在线播放] 播放器已监听独立端口 ' + port);
             });
             disposers.push(() => { try {

package/package.json

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

package/scripts/smoke-require.cjs

@@ -0,0 +1,91 @@
+/**
+ * 「每个编译产物都 require 得动」冒烟测试。
+ *
+ * 起因（线上真实故障）：给 player/server.ts 加了一行
+ * `import { tryGetRuntime } from '../../compat/runtime'` —— 多写了一层 `..`，
+ * 编译出来变成 `require("../../compat/runtime")`（指向插件根目录下的 compat，不存在）。
+ * TypeScript 那条链路只做转译、不解析路径，构建时毫无提示；**插件在用户机器上直接加载失败**：
+ *
+ *     [W] config failed to load kkk
+ *     Error: Cannot find module '../../compat/runtime'
+ *
+ * 这个测试就是把 lib 下每个 .js 都 require 一遍 —— 路径写错、模块顶层就抛异常，全都跑不掉。
+ *
+ * 用法：node scripts/smoke-require.cjs
+ */
+const fs = require('node:fs')
+const path = require('node:path')
+const { createRequire } = require('node:module')
+
+const pluginRoot = path.resolve(__dirname, '..')
+const libRoot = path.join(pluginRoot, 'lib')
+
+/** 绑定最小运行时：很多模块在顶层就读配置/日志 */
+const runtime = require(path.join(libRoot, 'compat', 'runtime.js'))
+const noop = () => {}
+runtime.bindRuntime({
+  ctx: {
+    get: () => undefined,
+    logger: () => ({ info: noop, warn: noop, error: noop, debug: noop, mark: noop }),
+    bots: [],
+    registry: new Map(),
+    on: noop,
+    middleware: noop
+  },
+  config: { app: {} },
+  dataRoot: path.join(pluginRoot, 'data-smoke-require'),
+  pluginRoot,
+  master: () => []
+})
+
+const walk = (dir) => {
+  const out = []
+  for (const item of fs.readdirSync(dir, { withFileTypes: true })) {
+    const full = path.join(dir, item.name)
+    if (item.isDirectory()) out.push(...walk(full))
+    else if (item.name.endsWith('.js')) out.push(full)
+  }
+  return out
+}
+
+const req = createRequire(path.join(libRoot, 'index.js'))
+const files = walk(libRoot)
+const failures = []
+let ok = 0
+let esm = 0
+/** 缺第三方依赖（宿主没装）的模块：单独列出，不算失败 */
+const optional = []
+for (const file of files) {
+  try {
+    req(file)
+    ok++
+  } catch (error) {
+    const message = String(error?.message ?? error)
+    /** 模板类模块是 ESM（用 import 加载的），require 报这个是**预期**的，不算失败 */
+    const isEsm = error?.code === 'ERR_REQUIRE_ESM' || error?.code === 'ERR_REQUIRE_ASYNC_MODULE'
+      || /Cannot use import statement outside a module|require\(\) of ES Module/.test(message)
+    if (isEsm) { esm++; continue }
+    /**
+     * 缺**第三方包**（cors / node:sqlite 之类）不算这次要抓的问题：有些模块是动态 import 的可选路径，
+     * 依赖装没装取决于宿主环境。**相对路径**找不到才是真问题（就是这次线上的那种），照旧算失败。
+     */
+    const missing = /Cannot find module '([^']+)'/.exec(message)
+    if (missing && !missing[1].startsWith('.')) {
+      optional.push(path.relative(libRoot, file) + ' → 缺依赖 ' + missing[1])
+      continue
+    }
+    failures.push({ file: path.relative(libRoot, file), message })
+  }
+}
+
+console.log('检查了 ' + files.length + ' 个编译产物：require 成功 ' + ok + ' 个，ESM（预期跳过）' + esm + ' 个，缺第三方依赖（预期跳过）' + optional.length + ' 个')
+for (const item of optional) console.log('  · ' + item)
+if (failures.length === 0) {
+  console.log('\n=== 通过：每个模块都加载得动（没有写错的 import 路径 / 顶层异常） ===')
+  // 用 process.exit：require 这些模块时可能有别的东西把 exitCode 置成了非 0
+  process.exit(0)
+} else {
+  for (const item of failures) console.log('  ❌ ' + item.file + ' → ' + item.message.split('\n')[0])
+  console.log('\n=== 失败：' + failures.length + ' 个模块加载不了 ===')
+  process.exit(1)
+}

package/src/player/index.ts

@@ -22,7 +22,7 @@ import { PLUGIN_DIR_NAME, tryGetRuntime } from '../compat/runtime'
 // 解析阶段（「下载进度」指令读的就是这里登记的状态）
 import { DOWNLOAD_STAGES, clearParseStage, updateDownloadStage } from '../karin/module/utils/Network/Downloader'
 import { getParseOverride } from '../karin/module/utils/ParseOverride'
-import { registerPlayerRoutes } from './server'
+import { isStandalonePlayerReady, registerPlayerRoutes } from './server'
 import {
   normalizeExpireMinutes,
   registerPlayerSession,
@@ -151,6 +151,9 @@ export function forceOnlinePlayerAdapters (): string[] {
 }
 
 /** 这个**适配器**是不是在「强制在线播放」名单里 */
+/** 「本实例独立端口没监听上」这条只提醒一次，不然每条链接都刷一行 */
+let warnedStandaloneMismatch = false
+
 export function isForceOnlinePlayerAdapter (platform?: string): boolean {
   if (!platform) return false
   return forceOnlinePlayerAdapters().includes(String(platform).toLowerCase())
@@ -318,7 +321,20 @@ let warnedLocalBase = false
 export function buildPlayerLink (token: string): string {
   const config: any = tryGetRuntime()?.config ?? {}
   const base = String(config.playerBaseUrl ?? '').replace(/\/+$/, '')
-  if (base) return base + '/kkk/player/' + token
+  if (base) {
+    /**
+     * 本实例**没监听上独立端口**，但链接指向公网域名 —— 那个域名反代的是独立端口，
+     * 于是用户点开访问的其实是**抢到端口的另一台实例**（它的会话表里没有这个 token），
+     * 页面就会显示「链接已过期」。线上真实故障，这里至少要说清楚一次。
+     */
+    if (!isStandalonePlayerReady() && !warnedStandaloneMismatch) {
+      warnedStandaloneMismatch = true
+      logger.warn('[在线播放] 本实例没有监听上独立端口（被别的进程占了），但链接指向 ' + base
+        + ' —— 如果那个域名反代到同一个端口，用户点开会看到「链接已过期」（其实连的是抢到端口的那台实例）。'
+        + '请换一个「播放器端口」，或者停掉同机另一台占着该端口的 Koishi 实例')
+    }
+    return base + '/kkk/player/' + token
+  }
   const port = Number(config.playerPort) > 0 ? Number(config.playerPort) : koishiPort()
   const link = 'http://' + localAddress() + ':' + port + '/kkk/player/' + token
   if (!warnedLocalBase) {

package/src/player/server.ts

@@ -23,6 +23,9 @@ import path from 'node:path'
 
 import { logger } from 'node-karin'
 
+// 注意只有一层 .. ：src/player/server.ts → src/compat/runtime（写两层会变成根目录下的 compat，直接 MODULE_NOT_FOUND）
+import { tryGetRuntime } from '../compat/runtime'
+
 import { renderExpiredPage, renderPlayerPage } from './page'
 import {
   getPlayerSession,
@@ -58,6 +61,21 @@ export interface PlayerHttpResponse {
 /** 路由前缀 */
 export const PLAYER_ROUTE_PREFIX = '/kkk/player/'
 
+/** 独立端口是否真的监听上了：没监听上时链接指向的公网域名很可能打不到本实例 */
+let standaloneReady = false
+
+/** 查询独立端口是否监听上了（给「生成链接」那边做提示用） */
+export const isStandalonePlayerReady = (): boolean => standaloneReady
+
+/** 面板里配的「播放器公网地址」（没配就是空串） */
+function publicBaseUrl (): string {
+  try {
+    return String((tryGetRuntime()?.config as any)?.playerBaseUrl ?? '').trim()
+  } catch {
+    return ''
+  }
+}
+
 const TEXT_TYPE = 'text/plain; charset=utf-8'
 const HTML_TYPE = 'text/html; charset=utf-8'
 
@@ -387,13 +405,23 @@ export function registerPlayerRoutes ({ ctx, port }: { ctx: any, port: number })
       })
     })
     server.on('error', (error: any) => {
-      logger.warn('[在线播放] 播放器端口 ' + port + ' 启动失败（' + String(error?.code ?? error?.message ?? error)
-        + '），已退回 Koishi 自己的端口；请在配置里换一个端口或留空')
+      const code = String(error?.code ?? error?.message ?? error)
+      /**
+       * 端口被别的进程占了：**必须说清楚后果** —— 线上真实故障就是「用户点开播放链接看到『链接已过期』」。
+       *
+       * 成因：这台实例退回 Koishi 自己的端口，而另一台实例（比如同机的测试实例）抢到了这个端口；
+       * 域名反代到该端口 → 用户访问的其实是**另一台实例**，它当然没有这个会话。
+       */
+      logger.error('[在线播放] 播放器端口 ' + port + ' 被占用（' + code + '），本次退回 Koishi 自己的端口'
+        + (publicBaseUrl() ? '。注意：域名 ' + publicBaseUrl() + ' 反代的就是 ' + port + ' 的话，用户点开链接会看到「链接已过期」'
+          + ' —— 说明这台实例不是 8888 的占用者（同机另一个 Koishi 实例抢到了），换一个端口或先停掉那台实例' : ''))
+      standaloneReady = false
       // 端口被占用不能把插件带崩：退回 ctx.server 再挂一遍
       registerOnKoishi(ctx, disposers)
     })
     try {
       server.listen(port, () => {
+        standaloneReady = true
         logger.info('[在线播放] 播放器已监听独立端口 ' + port)
       })
       disposers.push(() => { try { server.close() } catch { /* 忽略 */ } })