koishi-plugin-vsinger-gacha 1.1.1 → 1.1.3

package/README.md

@@ -19,14 +19,12 @@ VSinger 收藏集抽卡插件（Koishi 4.x）：六位角色的官方收藏集
 - **图鉴长图**：液态玻璃背景 + 官方「大隐藏/小隐藏」角标 + 镭射标，超大图自动分张防 OOM
 - **管理指令**：给卡（管理员可凭空发，普通用户须自己拥有）、设/加积分、查积分
 
-## 安装
+## 安装（选择一种）
 
-插件**自带全部素材**（卡池数据 + 423 张缩略图 + 官方角标），装完即用；图鉴渲染是唯一可选依赖。
-
-### 方式 A：一条命令装（不用 npm 帐号）
+### 方式 A：npm 一行装（推荐）
 
 ```bash
-npm i https://github.com/zb23333ww/koishi-plugin-vsinger-gacha/releases/download/v1.0.0/koishi-plugin-vsinger-gacha-1.0.3.tgz
+npm i koishi-plugin-vsinger-gacha
 ```
 
 `koishi.yml` 加一行后重启：
@@ -36,16 +34,16 @@ plugins:
   vsinger-gacha: {}
 ```
 
-### 方式 B：下载 zip 手动放（完全不用网络命令）
-
-下载 [koishi-plugin-vsinger-gacha.zip](https://github.com/zb23333ww/koishi-plugin-vsinger-gacha/releases/download/v1.0.0/koishi-plugin-vsinger-gacha.zip) → 解压 → 整个文件夹放进 Koishi 项目的 `node_modules/` → `koishi.yml` 加 `vsinger-gacha: {}` → 重启。
-
-### 方式 C：npm 正式包（发布后可用）
+### 方式 B：下载 tgz 直装（npm 不可用时）
 
 ```bash
-npm i koishi-plugin-vsinger-gacha
+npm i https://github.com/zb23333ww/koishi-plugin-vsinger-gacha/releases/latest/download/koishi-plugin-vsinger-gacha.tgz
 ```
 
+### 方式 C：下载 zip 手动放
+
+[koishi-plugin-vsinger-gacha.zip](https://github.com/zb23333ww/koishi-plugin-vsinger-gacha/releases/latest/download/koishi-plugin-vsinger-gacha.zip) → 解压 → 整个文件夹放进 Koishi 的 `node_modules/` → 配置 → 重启。
+
 ### 图鉴（可选）
 
 `/抽卡`、`/签到`、积分、管理指令**零依赖**即可用。
@@ -63,6 +61,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` |
+
 ## 指令
 
 | 指令 | 说明 |
@@ -119,25 +130,20 @@ npm i @napi-rs/canvas
 MIT
 
 
-## 素材包（可选）
+## 素材库（卡图 + 动态卡）
 
-仓库不含 1.37GB 原图与 1.06GB 动态卡，放在 Releases：
+插件包只带**缩略图**（图鉴用）+ 卡池数据，原图和动态卡单独放在 Releases 的「素材库」：
 
-| Release 附件 | 大小 | 内容 |
+| 附件 | 大小 | 内容 |
 | --- | --- | --- |
-| `assets-cards.tar` | 1.6 GB | 423 张 PNG（1242×1863）+ 274 张镭射版 JPG |
-| `assets-videos.tar` | 1.1 GB | 145 个动态卡 mp4 |
-
-解压到 `cardsDir` 即可，或用 `npm run fetch-assets` 重新抓取。
+| [`assets-cards.tar`](https://github.com/zb23333ww/koishi-plugin-vsinger-gacha/releases/download/v1.0.0/assets-cards.tar) | 1.6 GB | 423 张官方原图（1242×1863）+ 274 张镭射版 |
+| [`assets-videos.tar`](https://github.com/zb23333ww/koishi-plugin-vsinger-gacha/releases/download/v1.0.0/assets-videos.tar) | 1.1 GB | 145 个动态卡 mp4 |
 
-## 开发
+解压到 `cardsDir`（默认 `data/vsinger-gacha/cards`）：
 
 ```bash
-npm i
-node test/e2e.cjs        # 需要 @koishijs/plugin-mock + @napi-rs/canvas
+tar xf assets-cards.tar  -C data/vsinger-gacha/cards
+tar xf assets-videos.tar -C data/vsinger-gacha/cards
 ```
 
-## 免责声明
-
-卡图、卡池信息来自哔哩哔哩「收藏集」公开接口，版权归哔哩哔哩及原作者所有；
-本插件仅用于个人学习与同好群内的收藏展示，请勿用于商业用途。
+**不装也能用**：卡图按需单张自动下载（约 1MB/张），图鉴直接用包内缩略图。

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.1",
+  "version": "1.1.3",
   "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": {
@@ -47,4 +47,4 @@
   "optionalDependencies": {
     "@napi-rs/canvas": "^0.1.52"
   }
-}
+}