koishi-plugin-prism 0.1.4 → 0.1.6

package/README.md

@@ -24,7 +24,7 @@
 | `provider` | `string` | `"qq"` | 当前绑定的账号提供商平台名称（如 `"qq"`，`"discord"`）。 |
 | `autoRegister` | `boolean` | `true` | 当玩家未注册时，是否在首次操作（如入场/查钱包）时自动在 PRiSM 中创建新玩家。 |
 | `loginPricingConfigIds` | `string[]` | `[]` | 默认入场计费规则 ID 列表。 |
-| `loginSessionLabel` | `string` | - | 默认入场会话的备注文本（如 `"音游区间"`）。 |
+| `loginSessionLabel` | `string` | `"音游区间"` | 默认入场会话的标签文本。后端会按该标签对同一玩家的活跃会话去重，重复入场会被拒绝并提示。留空则不启用去重。 |
 | `defaultDoorDeviceId` | `string` | - | 默认门锁设备的 ID，用于开门指令。 |
 | `defaultScanProvider` | `string` | `"aime"` | 默认模拟刷卡时的读卡器协议提供商（如 `"aime"`）。 |
 | `currencyName` | `string` | `"金币"` | 账户货币在显示时的自定义单位名称。 |

package/lib/index.js

@@ -16,7 +16,10 @@ exports.Config = koishi_1.Schema.object({
     currencyName: koishi_1.Schema.string().default("猫粮").description("代币名称"),
     defaultDoorDeviceId: koishi_1.Schema.string().default("front-door").description("默认开门设备ID"),
     defaultScanProvider: koishi_1.Schema.string().default("aime").description("默认刷卡提供商"),
+    loginPricingConfigIds: koishi_1.Schema.array(koishi_1.Schema.string()).default([]).description("默认入场绑定的计费策略ID"),
+    loginSessionLabel: koishi_1.Schema.string().default("音游区间").description("默认入场场次标签 (防重复入场)"),
     enableStaffCommands: koishi_1.Schema.boolean().default(false).description("是否启用管理员指令"),
+    staffUserIds: koishi_1.Schema.array(koishi_1.Schema.string()).default([]).description("允许执行管理员指令的平台用户ID列表"),
     powerOffInterval: koishi_1.Schema.number().default(0).description("无人自动关机等待秒数 (0为禁用)"),
     mahjongTables: koishi_1.Schema.string().description("麻将桌配置"),
     mahjongTableSize: koishi_1.Schema.number().default(4).description("麻将桌人数限制"),
@@ -709,6 +712,15 @@ class PrismKoishiService {
             return null;
         }
     }
+    async resolvePlayerDisplay(sender, playerId) {
+        if (!sender)
+            return playerId || "未知玩家";
+        const platformName = await this.resolvePlatformName(sender.id);
+        const name = platformName
+            || (sender.name && sender.name !== sender.id ? sender.name : playerId)
+            || sender.id;
+        return `玩家：${name}（${this.config.provider.toUpperCase()}：${sender.id}）`;
+    }
     mahjongTableForPlayer(playerId) {
         for (const [tableId, state] of this.mahjongTables) {
             if (state.activeSessions[playerId])
@@ -752,7 +764,7 @@ class PrismKoishiService {
             return "权限不足";
         return null;
     }
-    formatCheckoutPreview(result, sender, title = "【结算账单】") {
+    async formatCheckoutPreview(result, sender, title = "【结算账单】") {
         if (result?.billing && result?.session) {
             return formatLegacyBilling(result, this.config.currencyName);
         }
@@ -782,57 +794,57 @@ class PrismKoishiService {
         const adjustments = result?.adjustments ?? [];
         const assetHoldings = result?.assetHoldings ?? [];
         const lines = [];
-        const headerParts = [title];
-        if (playerId) {
-            const identitySuffix = sender ? `（${this.config.provider.toUpperCase()}：${sender.id}）` : "";
-            headerParts.push(`玩家ID：${playerId}${identitySuffix}`);
-        }
-        else if (sender) {
-            headerParts.push(`玩家：${sender.name || sender.id}（${this.config.provider.toUpperCase()}：${sender.id}）`);
-        }
-        lines.push(headerParts.join("\n"));
+        lines.push(title);
+        lines.push(await this.resolvePlayerDisplay(sender, playerId));
         const validStarts = sessionPreviews.map((s) => parseDateTime(s?.startedAt)).filter(Boolean);
         const validEnds = sessionPreviews.map((s) => sessionDisplayEnd(s, previewedAt)).filter(Boolean);
         if (validStarts.length > 0) {
             const overallStart = minDate(validStarts);
             const overallEnd = validEnds.length > 0 ? maxDate(validEnds) : now(this.config);
-            lines.push(`⏰全场到店时段：${formatHM(overallStart)}–${formatHM(overallEnd)}`);
+            lines.push(`⏰ 游玩时间：${formatHM(overallStart)}–${formatHM(overallEnd)}`);
         }
-        lines.push("");
         for (const sPrev of sessionPreviews) {
             const label = sPrev?.label || "计时区间";
             const startDt = parseDateTime(sPrev?.startedAt);
             const endDt = sessionDisplayEnd(sPrev, previewedAt);
             const status = sPrev?.status ?? "active";
             const sTotal = toNumber(sPrev?.total ?? 0);
+            lines.push("");
             lines.push(label);
             if (startDt && endDt) {
+                const minutes = Math.floor((endDt.getTime() - startDt.getTime()) / 60_000);
                 lines.push(`游玩时段：${formatHM(startDt)}-${formatHM(endDt)}`);
-                lines.push(`游玩时长：${formatDurationValue(Math.floor((endDt.getTime() - startDt.getTime()) / 60_000))}　｜　消费：${formatNumber(sTotal)}${currency}`);
+                lines.push(`游玩时长：${formatDurationValue(minutes)}｜消费：${formatNumber(sTotal)}${currency}`);
             }
             else if (startDt) {
                 lines.push(`入场：${formatHM(startDt)}  （${status === "active" ? "计费中" : "已关闭"}）`);
             }
-            lines.push("");
+            const sessionAdjustments = (sPrev?.adjustments ?? []);
+            for (const adj of sessionAdjustments) {
+                const amount = toNumber(firstDefined(adj ?? {}, "amount", "saved", 0));
+                if (amount === 0)
+                    continue;
+                const adjLabel = firstDefined(adj ?? {}, "label", "name", "source") ?? "优惠";
+                lines.push(`  └ ${adjLabel}：${formatNumber(amount)}${currency}`);
+            }
         }
-        lines.push("————————————");
-        const balanceParts = [];
+        let balance = 0;
+        let hasBalance = false;
         for (const holding of assetHoldings) {
-            const qty = toNumber(holding?.quantity ?? 0);
             const code = String(holding?.assetCode ?? "").toLowerCase();
             if (code.includes("paid") || code.includes("free") || code.includes("currency")) {
-                balanceParts.push(`${formatNumber(qty)}${currency}`);
+                balance += toNumber(holding?.quantity ?? 0);
+                hasBalance = true;
             }
         }
-        if (balanceParts.length > 0)
-            lines.push(`扣款后余额：${balanceParts.join("＋")}`);
+        lines.push("");
         lines.push(`计费总价：${formatNumber(subtotal)}${currency}`);
-        const hasDiscount = adjustments.some((adj) => {
-            const amount = toNumber(firstDefined(adj ?? {}, "amount", "saved", 0));
-            return amount !== 0;
-        });
+        const hasDiscount = adjustments.some((adj) => toNumber(firstDefined(adj ?? {}, "amount", "saved", 0)) !== 0)
+            || sessionPreviews.some((sp) => (sp?.adjustments ?? []).some((adj) => toNumber(firstDefined(adj ?? {}, "amount", "saved", 0)) !== 0));
         if (hasDiscount)
             lines.push(`优惠后价格：${formatNumber(total)}${currency}`);
+        if (hasBalance)
+            lines.push(`扣款后余额：${formatNumber(balance)}${currency}`);
         return lines.join("\n");
     }
     handleCommandError(error) {
@@ -846,6 +858,18 @@ class PrismKoishiService {
     }
 }
 function humanReadableBotError(error) {
+    if (error.code === "DUPLICATE_SESSION_LABEL") {
+        return "❌ 您已经处于入场状态，请勿重复发送入场命令。";
+    }
+    if (error.code === "PLAYER_HAS_NO_UNSETTLED_SESSIONS") {
+        return "您当前没有未结算的账单，无需结账。";
+    }
+    if (error.code === "ACTIVE_SESSION_NOT_FOUND") {
+        return "您当前没有进行中的计费场次。";
+    }
+    if (error.code === "PLAYER_IDENTITY_NOT_FOUND") {
+        return "未找到您的玩家身份，请先注册或绑定账号。";
+    }
     if (error.code === "INSUFFICIENT_BALANCE") {
         return "余额不足，暂时不能结账。请先充值，或由店员在后台改价后再结账。";
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-prism",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "PRiSM Next 计费与设备管理系统的 Koishi 机器人集成插件",
   "main": "./lib/index.js",
   "exports": {
@@ -48,4 +48,4 @@
     "test": "bun test test",
     "typecheck": "tsc -p tsconfig.json"
   }
-}
+}