koishi-plugin-rocom 1.0.5 → 1.0.6

package/lib/commands/merchant.js

@@ -103,11 +103,16 @@ function parseMerchantSubscriptionArgs(args, defaultItems) {
     if (parts[0] === '1' || parts[0] === '0') {
         mentionAll = parts.shift() === '1';
     }
-    const items = parts.length ? parts : defaultItems;
+    const matchAll = parts.length === 1 && parts[0] === '全部';
+    if (matchAll)
+        parts.shift();
+    const items = matchAll ? [] : (parts.length ? parts : defaultItems);
+    const source = matchAll ? '全部商品' : (parts.length ? TEXT.customSource : TEXT.defaultSource);
     return {
         mention_all: mentionAll,
+        match_all: matchAll,
         items,
-        source: parts.length ? TEXT.customSource : TEXT.defaultSource,
+        source,
     };
 }
 function getSubscriptionTarget(session) {
@@ -158,13 +163,26 @@ async function checkMerchantSubscriptions(deps) {
     let matchedCount = 0;
     let pushedCount = 0;
     for (const [key, sub] of Object.entries(subs)) {
-        const matched = sub.items.filter((item) => productNames.some(n => n.includes(item)));
-        if (!matched.length)
+        const matchAll = !!sub.match_all;
+        const matched = matchAll
+            ? productNames
+            : sub.items.filter((item) => productNames.some(n => n.includes(item)));
+        if (!matchAll && !matched.length)
             continue;
-        matchedCount++;
-        if (sub.last_push_round === roundInfo.round_id && sameStringArray(matched, sub.last_matched_items || []))
+        if (matchAll && !products.length)
             continue;
-        const msg = `\ud83d\udd14 \u8fdc\u884c\u5546\u4eba\u5237\u65b0\u63d0\u9192\n\u5f53\u524d\u5546\u54c1\uff1a${productNames.join('\u3001')}\n\u5339\u914d\u8ba2\u9605\uff1a${matched.join('\u3001')}`;
+        matchedCount++;
+        if (matchAll) {
+            if (sub.last_push_round === roundInfo.round_id)
+                continue;
+        }
+        else {
+            if (sub.last_push_round === roundInfo.round_id && sameStringArray(matched, sub.last_matched_items || []))
+                continue;
+        }
+        const msg = matchAll
+            ? `\ud83d\udd14 \u8fdc\u884c\u5546\u4eba\u5237\u65b0\u63d0\u9192\n\u5f53\u524d\u5546\u54c1\uff1a${productNames.join('\u3001')}`
+            : `\ud83d\udd14 \u8fdc\u884c\u5546\u4eba\u5237\u65b0\u63d0\u9192\n\u5f53\u524d\u5546\u54c1\uff1a${productNames.join('\u3001')}\n\u5339\u914d\u8ba2\u9605\uff1a${matched.join('\u3001')}`;
         const platform = sub.platform || ctx.bots[0]?.platform;
         const channelId = sub.channel_id || sub.group_id || sub.user_id || key;
         if (!platform || !channelId) {
@@ -216,12 +234,13 @@ function register(deps) {
             channel_id: target.channelId,
             platform: target.platform,
             items: parsed.items,
+            match_all: parsed.match_all,
             mention_all: target.privateChat ? false : parsed.mention_all,
             last_push_round: existing?.last_push_round ?? null,
             last_matched_items: existing?.last_matched_items ?? [],
             updated_by: session.userId,
         });
-        return `\u2705 \u5df2\u8ba2\u9605\u8fdc\u884c\u5546\u4eba\u5546\u54c1\uff1a${parsed.items.join('\u3001')}\uff08${parsed.source}\uff09\uff1b${target.privateChat ? '个人订阅' : (parsed.mention_all ? '\u547d\u4e2d\u540e\u4f1a @\u5168\u4f53' : '\u547d\u4e2d\u540e\u4e0d @\u5168\u4f53')}`;
+        return `\u2705 \u5df2\u8ba2\u9605\u8fdc\u884c\u5546\u4eba\u5546\u54c1\uff1a${parsed.match_all ? '\u5168\u90e8\u5546\u54c1\uff08\u6bcf\u8f6e\u63a8\u9001\uff09' : parsed.items.join('\u3001')}\uff08${parsed.source}\uff09\uff1b${target.privateChat ? '个人订阅' : (parsed.mention_all ? '\u547d\u4e2d\u540e\u4f1a @\u5168\u4f53' : '\u547d\u4e2d\u540e\u4e0d @\u5168\u4f53')}`;
     });
     ctx.command(TEXT.viewSubscribe, '\u67e5\u770b\u5f53\u524d\u4f1a\u8bdd\u7684\u8fdc\u884c\u5546\u4eba\u8ba2\u9605')
         .action(async ({ session }) => {
@@ -231,8 +250,9 @@ function register(deps) {
         const sub = merchantSubMgr.get(target.key);
         const scopeName = target.privateChat ? '你' : '当前群组';
         if (!sub)
-            return `${scopeName}未订阅远行商人。\n用法：${TEXT.subscribe} [1/0] [商品名1] [商品名2] ...`;
-        return `${scopeName}订阅商品：${sub.items.join('、')}\n提醒方式：${target.privateChat ? '私聊提醒' : (sub.mention_all ? '@全体' : '普通提醒')}`;
+            return `${scopeName}未订阅远行商人。\n用法：${TEXT.subscribe} [1/0] [商品名1] [商品名2] ...\n或：${TEXT.subscribe} 全部（每轮直接推送整张商人图）`;
+        const itemsText = sub.match_all ? '全部商品（每轮推送）' : sub.items.join('、');
+        return `${scopeName}订阅商品：${itemsText}\n提醒方式：${target.privateChat ? '私聊提醒' : (sub.mention_all ? '@全体' : '普通提醒')}`;
     });
     ctx.command(TEXT.unsubscribe, '\u53d6\u6d88\u8fdc\u884c\u5546\u4eba\u8ba2\u9605')
         .action(async ({ session }) => {

package/lib/user.d.ts

@@ -13,6 +13,7 @@ export interface MerchantSubscription {
     user_id?: string;
     type?: string;
     mention_all: boolean;
+    match_all?: boolean;
     items: string[];
     last_push_round: string | null;
     last_matched_items: string[];

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-rocom",
   "description": "洛克王国查询与订阅插件",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "homepage": "https://github.com/staytomorrow/koishi-plugin-rocom",

package/readme.md

@@ -16,7 +16,7 @@ Koishi 版洛克王国数据查询插件。插件基于 WeGame / 后端接口提
 | --- | --- |
 | 账号管理 | QQ 扫码登录、微信扫码登录、凭证导入、绑定列表、切换账号、解绑、刷新凭证 |
 | 数据查询 | 档案、战绩、背包、阵容推荐、阵容详情、交换大厅 |
-| 商人提醒 | 远行商人查询、远行商人商品订阅、取消订阅 |
+| 商人提醒 | 远行商人查询、商品关键词订阅、全部订阅（每轮直推整图）、查看订阅、取消订阅 |
 | 百科查询 | 精灵 Wiki、技能 Wiki |
 | 查蛋配种 | 精灵查蛋、尺寸反查、候选结果、目标配种方案、配种判定 |
 | 管理维护 | 刷新所有凭证、删除失效绑定、自动刷新凭证 |
@@ -275,23 +275,34 @@ Koishi 版洛克王国数据查询插件。插件基于 WeGame / 后端接口提
 
 > 图片位置：远行商人商品截图。建议插入 `docs/images/merchant-current.png`。
 
-### `订阅远行商人 [商品名...]`
+### `订阅远行商人 [1/0] [商品名... | 全部]`
 
-在群聊中订阅远行商人商品提醒。群内操作仅 `adminUserIds` 中配置的 Bot 管理员可设置；私聊场景支持个人自行订阅（需开启 `merchantPrivateSubscriptionEnabled`）。
+在群聊中订阅远行商人提醒。群内操作仅 `adminUserIds` 中配置的 Bot 管理员可设置；私聊场景支持个人自行订阅（需开启 `merchantPrivateSubscriptionEnabled`）。
 
-查看当前订阅：
+参数说明：
+
+- 第一个可选参数 `1` / `0`：仅群聊生效。`1` 表示命中后 @全体成员，`0` 表示不 @全体。省略时默认 `0`。私聊订阅强制为不 @。
+- 后续参数为订阅商品名，按"包含关系"与当前商品名做模糊匹配（例如订阅 `国王球` 会命中 `国王球(大)`）。
+- 若只传一个特殊关键字 `全部`，则进入 **全部订阅模式**：忽略商品匹配，只要远行商人本轮有在售商品，就把整张远行商人渲染图直接推送给订阅方。每轮（`08:00 / 12:00 / 16:00 / 20:00`）只推一次。
+- 不传任何商品名时，使用配置里的 `merchantSubscriptionItems` 作为默认关键词。
+
+查看当前会话的订阅：
 
 ```text
-订阅远行商人
+查看远行商人订阅
 ```
 
-设置订阅商品：
+常见用法：
 
 ```text
-订阅远行商人 国王球 棱镜球 炫彩精灵蛋
+订阅远行商人                       # 使用配置中的默认关键词
+订阅远行商人 国王球 棱镜球 炫彩精灵蛋   # 按关键词匹配
+订阅远行商人 1 国王球              # 命中后 @全体
+订阅远行商人 全部                   # 每轮直接推送整张商人图
+订阅远行商人 1 全部                 # 每轮推送并 @全体
 ```
 
-插件会定时检查远行商人商品，当当前商品命中订阅关键词时推送提醒。
+按关键词订阅时，去重规则是"同一轮次 + 同一匹配商品集合"只推一次；全部订阅模式下仅按轮次去重，本轮推过就不再重复。
 
 > 图片位置：订阅远行商人结果截图。建议插入 `docs/images/merchant-subscribe.png`。
 
@@ -537,8 +548,9 @@ autoRefreshTime:
 请检查：
 
 - `merchantSubscriptionEnabled` 是否开启。
-- 群聊是否已经使用 `订阅远行商人 <商品名>` 设置订阅。
-- 商品名称是否能匹配当前远行商人商品。
+- 会话是否已经使用 `订阅远行商人` 设置订阅，可用 `查看远行商人订阅` 确认当前订阅内容。
+- 按关键词订阅时，商品名称是否能命中当前远行商人商品（按包含关系匹配）。
+- 全部订阅模式（`订阅远行商人 全部`）在本轮商品为空时不会推送；每轮 `08:00 / 12:00 / 16:00 / 20:00` 只推一次，已推过的轮次不会重复。
 - Bot 是否有向目标群聊发送消息的权限。
 
 > 图片位置：远行商人订阅排查截图。建议插入 `docs/images/faq-merchant-subscription.png`。