koishi-plugin-vsinger-gacha 1.1.2 → 1.1.4

package/README.md

@@ -1,6 +1,7 @@
 # koishi-plugin-vsinger-gacha
 
 [![npm](https://img.shields.io/npm/v/koishi-plugin-vsinger-gacha?style=flat-square)](https://www.npmjs.com/package/koishi-plugin-vsinger-gacha)
+[![CI](https://github.com/zb23333ww/koishi-plugin-vsinger-gacha/actions/workflows/ci.yml/badge.svg)](https://github.com/zb23333ww/koishi-plugin-vsinger-gacha/actions/workflows/ci.yml)
 [![license](https://img.shields.io/github/license/zb23333ww/koishi-plugin-vsinger-gacha?style=flat-square)](LICENSE)
 
 > 六位 VSinger 角色的 B 站收藏集抽卡插件：423 张官方卡、43 个奖池、真实概率 + 保底、镭射版、签到积分与图鉴长图。
@@ -61,6 +62,19 @@ npm i @napi-rs/canvas
 - 想一次性缓存全部：`npm run fetch-assets -- --dir data/vsinger-gacha/cards`
 - 要动态卡 mp4（1.1GB）：下载 Release 的 `assets-videos.tar` 解压到 `cards/`
 
+## 兼容性
+
+| 项 | 说明 |
+| --- | --- |
+| **Koishi** | `>=4.17.0 <6`（4.18 与 5.x RC 均验证过） |
+| **Node** | `>=18` |
+| **适配器** | 任意 Satori 适配器可用；OneBot 额外支持**合并转发**，其它适配器自动退回普通消息 |
+| **发图** | 默认 `buffer`（base64，跨容器最稳）；可切 `file`（适配器能读同机文件时更省内存） |
+| **数据库** | 不需要，数据存 `data/vsinger-gacha/*.json` |
+| **图鉴** | 需要可选依赖 `@napi-rs/canvas`；没装时其它功能不受影响 |
+| **字体** | 包内自带中文子集，不依赖系统字体 |
+| **合并转发** | 配置 `forwardMode: auto / off` |
+
 ## 指令
 
 | 指令 | 说明 |

package/lib/index.js

@@ -31,6 +31,10 @@ const Config = Schema.intersect([
       .description('可选：openid ↔ QQ 映射表（如 /root/qqbot/data/id-map.json），用于统一用户标识'),
     debug: Schema.boolean().default(false)
       .description('调试模式：把收到的每条消息打到日志里'),
+    forwardMode: Schema.union(['auto', 'off']).default('auto')
+      .description('合并转发：auto=支持就转发、不支持自动退回普通消息；off=永远普通消息'),
+    imageMode: Schema.union(['auto', 'buffer', 'file']).default('auto')
+      .description('发图方式：auto=buffer（base64，跨容器最稳）；file=发本地路径（需适配器能读同机文件）'),
     sendVideos: Schema.boolean().default(true)
       .description('动态卡单独发送 mp4（需要本地 videos 目录有对应文件）'),
     autoDownload: Schema.boolean().default(true)
@@ -114,16 +118,32 @@ const normUser = (raw, session) => {
  * ★ 不用 file:// 路径：机器人框架 / OneBot 实现在容器里读不到宿主机路径
  *   → 直接用 buffer（Koishi 会编码成 data/base64，跨进程可用）
  */
-const fileEl = (file, mime) => {
+/** 机器人自身 uin / 显示名（不同适配器字段不一样） */
+function botUin(session) {
+  return String(session.selfId || (session.bot && session.bot.selfId) || (session.bot && session.bot.config && session.bot.config.selfId) || '');
+}
+function botName(session) {
+  return String((session.bot && (session.bot.username || session.bot.name)) || 'Bot');
+}
+
+function fileEl(file, mime, mode) {
   const mt = mime || (/\.jpe?g$/i.test(file) ? 'image/jpeg' : 'image/png');
+  if (mode === 'file') {
+    try {
+      return h.image(require('node:url').pathToFileURL(file).href);
+    } catch { /* 退回 buffer */ }
+  }
   return h.image(fs.readFileSync(file), mt);
-};
+}
 
 
 /** 发合并转发（OneBot 私有 API）；失败返回 false */
 async function sendForward(session, nodes) {
   const bot = session.bot;
-  if (!bot || !bot.internal) return false;
+  if (!bot || !bot.internal) {
+    sendForward.lastError = 'adapter 不支持 internal API';
+    return false;
+  }
   const gid = session.guildId || session.channelId;
   if (session.isDirect || !gid) return false;
   const internal = bot.internal;
@@ -151,9 +171,10 @@ async function sendForward(session, nodes) {
 /** 本地视频 → 消息元素（OneBot 要求视频单独一条消息） */
 function videoEl(file) {
   const buf = fs.readFileSync(file);
-  const b64 = 'data:video/mp4;base64,' + buf.toString('base64');
-  if (typeof h.video === 'function') return h.video(buf, 'video/mp4');
-  return h('video', { src: b64 });
+  if (typeof h.video === 'function') {
+    try { return h.video(buf, 'video/mp4'); } catch { /* 退回通用元素 */ }
+  }
+  return h('video', { src: 'data:video/mp4;base64,' + buf.toString('base64') });
 }
 
 /** 本地图片 → OneBot base64 段 */
@@ -294,17 +315,17 @@ function apply(ctx, config) {
       if (session.isDirect === false || session.guildId) {
         nodes.push({
           type: 'node',
-          data: { name: ctx.bots?.[0]?.username || '洛天依', uin: String(session.selfId || ''), content: [{ type: 'text', data: { text: title } }] },
+          data: { name: botName(session), uin: botUin(session), content: [{ type: 'text', data: { text: title } }] },
         });
         results.forEach((r, i) => {
           const rate = r.card.rate_pct == null ? '' : ` ${r.card.rate_pct}%`;
           const desc = `${r.tier}｜${r.card.card_name}${rate}${r.laser ? '｜✦镭射版' : ''}${r.card.video ? '｜动态' : ''}`;
           const content = [{ type: 'text', data: { text: desc } }];
           if (pics[i]) content.push(imgSeg(pics[i]));
-          nodes.push({ type: 'node', data: { name: '洛天依', uin: String(session.selfId || ''), content } });
+          nodes.push({ type: 'node', data: { name: botName(session), uin: botUin(session), content } });
         });
       }
-      const ok = nodes.length && await sendForward(session, nodes);
+      const ok = config.forwardMode !== 'off' && nodes.length && await sendForward(session, nodes);
       if (!ok && nodes.length) logger.warn('合并转发不可用（%s），退回普通发送', sendForward.lastError || 'unknown');
 
       // ★ 动态卡：单独发 mp4（OneBot 要求视频独占一条消息）
@@ -327,7 +348,7 @@ function apply(ctx, config) {
         await session.send(title + '\n' + lines.join('\n'));
         for (const f of pics) {
           if (!f) continue;
-          try { await session.send(fileEl(f)); } catch (e) { logger.warn('发卡图失败：%s', e.message); }
+          try { await session.send(fileEl(f, null, config.imageMode)); } catch (e) { logger.warn('发卡图失败：%s', e.message); }
         }
       }
       return;
@@ -359,18 +380,18 @@ function apply(ctx, config) {
     }
     lines.push('', '切换：/换池 序号（00 = 全部卡池）', '说明：/抽卡帮助');
 
-    const uin = String(session.selfId || '');
+    const uin = botUin(session);
     const nodes = [];
     const chunk = 18;
     for (let k = 0; k < lines.length; k += chunk) {
-      nodes.push({ type: 'node', data: { name: '洛天依', uin, content: [{ type: 'text', data: { text: lines.slice(k, k + chunk).join('\n') } }] } });
+      nodes.push({ type: 'node', data: { name: botName(session), uin, content: [{ type: 'text', data: { text: lines.slice(k, k + chunk).join('\n') } }] } });
     }
     if (nodes.length < 2) {
-      nodes.push({ type: 'node', data: { name: '洛天依', uin, content: [{ type: 'text', data: { text: '切换：/换池 序号（00 = 全部卡池）' } }] } });
+      nodes.push({ type: 'node', data: { name: botName(session), uin, content: [{ type: 'text', data: { text: '切换：/换池 序号（00 = 全部卡池）' } }] } });
     }
-    const ok = await sendForward(session, nodes);
+    const ok = config.forwardMode !== 'off' && await sendForward(session, nodes);
     if (!ok) {
-      logger.warn('卡池合并转发失败（%s），改发文本', sendForward.lastError);
+      if (config.forwardMode !== 'off') logger.warn('卡池合并转发失败（%s），改发文本', sendForward.lastError);
       return lines.join('\n');
     }
     return;
@@ -414,7 +435,7 @@ function apply(ctx, config) {
     const f = game.holoFile(c)
       || (config.autoDownload !== false ? await game.ensureImage(c) : (fs.existsSync(game.cardFile(c)) ? game.cardFile(c) : null));
     if (!f) return `「${c.v.card_name}」的卡图下载失败（网络问题），稍后再试`;
-    await session.send(fileEl(f, /\.jpe?g$/i.test(f) ? 'image/jpeg' : 'image/png'));
+    await session.send(fileEl(f, /\.jpe?g$/i.test(f) ? 'image/jpeg' : 'image/png', config.imageMode));
     return `🎴 ${c.v.card_name}\n档位：${tierName(c.v)} ｜ 概率：${c.v.rate_pct}% ｜ 你拥有 ×${u.owned[c.h]}${c.v.video ? ' ｜ 动态卡' : ''}`;
   });
 
@@ -431,10 +452,10 @@ function apply(ctx, config) {
         tagsDir,
         thumbsDir: path.join(assetsDir, 'thumbs'),
       });
-      const nodes = [{ type: 'node', data: { name: '洛天依', uin: String(session.selfId || ''), content: [{ type: 'text', data: { text: `${session.username || '你'} 的收藏集图鉴（${files.length} 张）` } }] } }];
-      for (const f of files) nodes.push({ type: 'node', data: { name: '洛天依', uin: String(session.selfId || ''), content: [imgSeg(f)] } });
-      const ok = await sendForward(session, nodes);
-      if (!ok) for (const f of files) await session.send(fileEl(f, 'image/jpeg'));
+      const nodes = [{ type: 'node', data: { name: botName(session), uin: botUin(session), content: [{ type: 'text', data: { text: `${session.username || '你'} 的收藏集图鉴（${files.length} 张）` } }] } }];
+      for (const f of files) nodes.push({ type: 'node', data: { name: botName(session), uin: botUin(session), content: [imgSeg(f)] } });
+      const ok = config.forwardMode !== 'off' && await sendForward(session, nodes);
+      if (!ok) for (const f of files) await session.send(fileEl(f, 'image/jpeg', config.imageMode));
     } catch (e) {
       logger.warn('图鉴失败：%s', e.stack || e.message);
       return `图鉴生成失败：${String(e.message).slice(0, 120)}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-vsinger-gacha",
-  "version": "1.1.2",
+  "version": "1.1.4",
   "description": "VSinger 收藏集抽卡 / 签到积分 / 图鉴（Koishi 插件，一次性安装）",
   "main": "lib/index.js",
   "files": [
@@ -22,7 +22,7 @@
   ],
   "license": "MIT",
   "peerDependencies": {
-    "koishi": "^4.17.0"
+    "koishi": ">=4.17.0 <6"
   },
   "koishi": {
     "description": {

package/scripts/ci-load.cjs

@@ -0,0 +1,17 @@
+/** CI 用：真实 Koishi + mock 适配器，确认插件能加载并注册指令 */
+const { Context } = require('koishi');
+const mockMod = require('@koishijs/plugin-mock');
+const plugin = require('../lib/index.js');
+
+const app = new Context({ prefix: ['/'] });
+app.plugin(mockMod.default ?? mockMod);
+app.plugin(plugin, { cardsDir: './data/cards' });
+
+app.start().then(() => {
+  const n = app.$commander._commandList.length;
+  console.log('指令数', n);
+  process.exit(n > 10 ? 0 : 1);
+}).catch((e) => {
+  console.error(e);
+  process.exit(1);
+});