koishi-plugin-prism 0.1.18 → 0.1.20

package/README.md

@@ -8,7 +8,7 @@
 
 * 🎮 **玩家入场与结算**：通过 `/login` 和 `/logout` 指令开启或结算计费场次，支持 `/入场` 别名；命令回复会引用触发消息，结账账单可私聊通知管理员与指定用户。
 * 💳 **账户钱包与资产管理**：支持查询钱包余额（`/wallet`）和持有的道具资产（`/items`）。
-* 🀄 **麻将桌位集成**：包含 `/mahjong <tableId>` 以及便捷的 `/上桌` / `/下桌` 控制。`上桌` 仅允许已通过 `login`/`入场` 开启默认入场会话的玩家使用。`list` 按 session 标签分组：有非音乐游戏 session 的玩家归入最新的非音乐标签，纯音乐玩家归入音乐标签；麻将桌额外显示当前人数和容量。已开局桌位会从后端活跃 session 自动恢复，未满桌候座仍由机器人进程暂存，重启后不会保留。
+* 🀄 **麻将桌位集成**：包含 `/mahjong <tableId>`、`/上桌 <桌号>`、自动识别当前桌位的 `/下桌`，以及用于查看桌名、别名和状态的 `/麻将列表`。`上桌` 仅允许已通过 `login`/`入场` 开启默认入场会话的玩家使用。`list` 按 session 标签分组：有非音乐游戏 session 的玩家归入最新的非音乐标签，纯音乐玩家归入音乐标签；麻将桌额外显示当前人数和容量。已开局桌位会从后端活跃 session 自动恢复，未满桌候座仍由机器人进程暂存，重启后不会保留。
 * 🔌 **硬件设备状态与电源管理**：可直接在聊天中查看设备状态（`/show`）、远程开启/关闭电源（`/on`、`/off`）、远程投币（`/coin`）和模拟刷卡（`/scan`）。
 * 🎟️ **礼物兑换码**：使用 `/redeem <code>` 兑换系统发放的福利礼包。
 * 🛠️ **管理员快捷指令**：允许管理员为指定平台用户增加或扣除余额，并覆盖结账金额后立即结账。
@@ -58,6 +58,7 @@ pricingConfigIds: [pricing-mahjong-a]
 玩家在未产生任何费用时退场，机器人会简洁显示“本次未产生费用”和当前余额；存在收费或优惠明细时仍显示完整结算账单。
 结账成功后，机器人会向 `staffUserIds` 与 `logoutNotifyUserIds` 中的用户私聊同一份账单，账单会明确显示结账玩家身份。
 账单和管理员代操作回执均使用“平台昵称（QQ：号码）”称呼玩家；平台暂时无法提供昵称时显示“未知昵称（QQ：号码）”，不会显示内部玩家 ID。
+管理员 `/add` 增加免费余额；`/del` 按结账相同的顺序从可用免费余额、再从付费余额扣除，余额不足时会返回余额不足提示。
 * `billing` - 预览当前玩家本场计费的消费费用。
 * `wallet` - 查看当前玩家的钱包余额。
 * `items` - 查看当前玩家持有的道具或资产。
@@ -70,8 +71,9 @@ pricingConfigIds: [pricing-mahjong-a]
 * `coin <deviceId> [count]` - 请求向指定设备投币指定枚数。
 * `scan <deviceId> <subject>` - 请求向设备发送模拟刷卡。
 * `redeem <code>` - 兑换礼物码。
-* `mahjong <tableId>` / `上桌 <tableId>` - 加入指定麻将桌；仅允许已通过 `login`/`入场` 开启默认入场会话的玩家使用。
-* `下桌 <tableId>` - 离开指定麻将桌。
+* `mahjong <tableId>` / `上桌 [tableId]` - 加入指定麻将桌；`/上桌` 未提供桌号时会引导查看 `/麻将列表`。仅允许已通过 `login`/`入场` 开启默认入场会话的玩家使用。
+* `下桌` - 自动离开当前所在麻将桌。
+* `麻将列表` - 查看已配置机器的桌名、命令别名，以及空闲、等位或游玩中状态。
 
 ### 管理员快捷指令
 启用 `enableStaffCommands`、配置 `staffUserIds` 白名单与 `staffSessionToken` 后可使用：

package/lib/index.js

@@ -50,7 +50,8 @@ exports.PrismBotClientError = PrismBotClientError;
 const LOCAL_TZ_OFFSET_MINUTES = 8 * 60;
 const USAGE = {
     mahjong_join: "/上桌 <桌号>",
-    mahjong_leave: "/下桌 <桌号>",
+    mahjong_leave: "/下桌",
+    mahjong_list: "/麻将列表",
     prism_on: "/prism on <设备ID>",
     prism_off: "/prism off <设备ID|all>",
     prism_coin: "/prism coin <设备ID> [数量]",
@@ -75,8 +76,9 @@ function applyPrismKoishiPlugin(ctx, config) {
     ctx.command("login [target:user]", "开启玩家计费场次").action(wrap(async (context, target) => service.loginForTarget(await service.sender(context), target, context.session?.bot)));
     ctx.command("入场 [target:user]", "入场").action(wrap(async (context, target) => service.loginForTarget(await service.sender(context), target, context.session?.bot)));
     ctx.command("mahjong <tableId>", "加入指定麻将桌").action(wrap(async (context, tableId) => service.mahjongJoin(await service.sender(context), tableId)));
-    ctx.command("上桌 <tableId>", "加入指定麻将桌").action(wrap(async (context, tableId) => service.mahjongJoin(await service.sender(context), tableId)));
-    ctx.command("下桌 <tableId>", "离开指定麻将桌").action(wrap(async (context, tableId) => service.mahjongLeave(await service.sender(context), tableId)));
+    ctx.command("上桌 [tableId]", "加入指定麻将桌").action(wrap(async (context, tableId) => service.mahjongJoin(await service.sender(context), tableId)));
+    ctx.command("下桌", "离开当前所在麻将桌").action(wrap(async (context) => service.mahjongLeave(await service.sender(context))));
+    ctx.command("麻将列表", "查看麻将机状态与别名").action(wrap(async () => service.listMahjongTables()));
     ctx.command("logout [target:user]", "结算玩家计费场次").action(wrap(async (context, target) => service.withTarget(await service.sender(context), target, (sender) => service.logout(sender, context.session?.bot), context.session?.bot)));
     ctx.command("billing [target:user]", "预览玩家结账费用").action(wrap(async (context, target) => service.withTarget(await service.sender(context), target, (sender) => service.billing(sender), context.session?.bot)));
     ctx.command("wallet [target:user]", "查看玩家钱包").action(wrap(async (context, target) => service.withTarget(await service.sender(context), target, (sender) => service.wallet(sender), context.session?.bot)));
@@ -278,6 +280,12 @@ class PrismApiClient {
             body: { ...this.identityBody(identity), adjustments },
         });
     }
+    async adjustWalletByIdentity(identity, amount, reason) {
+        return this.request("POST", "/rpc/integration/players/by-identity/wallet/adjustment", {
+            token: this.config.integrationToken,
+            body: { ...this.identityBody(identity), amount, reason },
+        });
+    }
     async checkoutWithOverrideByIdentity(identity, total, reason) {
         return this.request("POST", "/rpc/integration/players/by-identity/checkout/override", {
             token: this.config.integrationToken,
@@ -368,12 +376,7 @@ class PrismKoishiService {
             if (!Number.isFinite(amount) || amount <= 0)
                 return "金额必须大于 0";
             const isAddition = direction === 1;
-            await this.client.adjustAssetsByIdentity(this.identity(sender), [{
-                    assetType: "currency",
-                    assetCode: "paid",
-                    quantityDelta: amount * direction,
-                    reason: isAddition ? "Koishi 管理员增加余额" : "Koishi 管理员扣除余额",
-                }]);
+            await this.client.adjustWalletByIdentity(this.identity(sender), amount * direction, isAddition ? "Koishi 管理员增加余额" : "Koishi 管理员扣除余额");
             return `✅ 已为用户 ${formatPlayerReference(sender, this.config.provider)}${isAddition ? "增加" : "扣除"} ${formatNumber(amount)} ${this.config.currencyName}`;
         }, bot);
     }
@@ -390,10 +393,10 @@ class PrismKoishiService {
     async mahjongJoin(sender, rawTableId) {
         const tableId = cleanText(rawTableId);
         if (!tableId)
-            return commandUsage("mahjong_join");
+            return "请指定麻将桌，例如 /上桌 a；可先使用 /麻将列表 查看可用桌位。";
         const tableConfig = this.mahjongTableConfigs().get(tableId);
         if (!tableConfig)
-            return `找不到 ${tableId} 桌的麻将计费配置。`;
+            return `未找到麻将桌「${tableId}」。可先使用 /麻将列表 查看可用桌位。`;
         const tableKey = tableConfig.tableId;
         const tableSubject = tableConfig.displayName || `${tableKey} 桌`;
         const player = await this.resolvePlayer(sender);
@@ -406,11 +409,11 @@ class PrismKoishiService {
         }
         const existing = this.mahjongTableForPlayer(playerId);
         if (existing)
-            return `你已经在 ${existing} 桌了。`;
+            return `你已经在 ${existing}，无需重复上桌。`;
         const state = this.mahjongTables.get(tableKey) ?? { waiting: [], activeSessions: {} };
         this.mahjongTables.set(tableKey, state);
         if (Object.keys(state.activeSessions).length > 0) {
-            return `${tableSubject}已经开始计费，请先等当前这一桌结束。`;
+            return `「${tableSubject}」正在游玩中（${Object.keys(state.activeSessions).length}/${this.config.mahjongTableSize ?? 4}），请等待本局结束后再上桌。`;
         }
         state.waiting.push({
             playerId,
@@ -437,20 +440,19 @@ class PrismKoishiService {
         }
         return `${tableSubject}已满，麻将计费已开始。`;
     }
-    async mahjongLeave(sender, rawTableId) {
-        const tableId = cleanText(rawTableId);
-        if (!tableId)
-            return commandUsage("mahjong_leave");
-        const tableConfig = this.mahjongTableConfigs().get(tableId);
-        const tableKey = tableConfig?.tableId ?? tableId;
-        const tableSubject = tableConfig?.displayName || `${tableId} 桌`;
+    async mahjongLeave(sender) {
         const activeResult = (await this.client.listActiveSessions());
         this.syncMahjongTableStates((activeResult.sessions ?? []));
-        const state = this.mahjongTables.get(tableKey);
-        if (!state)
-            return `你不在 ${tableSubject}。`;
         const player = await this.resolvePlayer(sender);
         const playerId = String(player.id ?? "");
+        const tableKey = this.mahjongTableForPlayer(playerId);
+        if (!tableKey)
+            return "你当前未在任何麻将桌上。";
+        const tableConfig = uniqueMahjongConfigs(this.mahjongTableConfigs()).find((table) => table.tableId === tableKey);
+        const tableSubject = tableConfig?.displayName || tableKey;
+        const state = this.mahjongTables.get(tableKey);
+        if (!state)
+            return "你当前未在任何麻将桌上。";
         const waitingBefore = state.waiting.length;
         state.waiting = state.waiting.filter((seat) => seat.playerId !== playerId);
         if (state.waiting.length !== waitingBefore) {
@@ -458,11 +460,31 @@ class PrismKoishiService {
         }
         const sessionId = state.activeSessions[playerId];
         if (!sessionId)
-            return `你不在 ${tableSubject}。`;
+            return "你当前未在任何麻将桌上。";
         delete state.activeSessions[playerId];
         await this.client.stopSessionByIdentity(this.identity(sender), sessionId);
         return `已离开 ${tableSubject}，麻将计费已停止。`;
     }
+    async listMahjongTables() {
+        const activeResult = (await this.client.listActiveSessions());
+        this.syncMahjongTableStates((activeResult.sessions ?? []));
+        const tableSize = this.config.mahjongTableSize ?? 4;
+        const tables = uniqueMahjongConfigs(this.mahjongTableConfigs());
+        if (tables.length === 0)
+            return "当前没有配置任何麻将机。";
+        const lines = [`🀄️ 麻将机列表（${tables.length} 台）`];
+        for (const table of tables) {
+            const state = this.mahjongTables.get(table.tableId) ?? { waiting: [], activeSessions: {} };
+            const activeCount = Object.keys(state.activeSessions).length;
+            const waitingCount = state.waiting.length;
+            const statuses = [
+                ...(activeCount > 0 ? [`游玩中 ${activeCount}/${tableSize}`] : []),
+                ...(waitingCount > 0 ? [`等位 ${waitingCount}/${tableSize}`] : []),
+            ];
+            lines.push(`- ${table.displayName}｜别名：${table.aliases.length > 0 ? table.aliases.join("、") : "无"}｜${statuses.join("；") || "空闲"}`);
+        }
+        return lines.join("\n");
+    }
     async billing(sender) {
         const result = (await this.client.previewCheckoutByIdentity(this.identity(sender)));
         return this.formatCheckoutPreview(result, sender);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-prism",
-  "version": "0.1.18",
+  "version": "0.1.20",
   "description": "PRiSM Next 计费与设备管理系统的 Koishi 机器人集成插件",
   "main": "./lib/index.js",
   "exports": {