koishi-plugin-prism 0.1.20 → 0.1.23

package/README.md

@@ -57,6 +57,7 @@ pricingConfigIds: [pricing-mahjong-a]
 * `logout` - 结算当前玩家的计费场次。
 玩家在未产生任何费用时退场，机器人会简洁显示“本次未产生费用”和当前余额；存在收费或优惠明细时仍显示完整结算账单。
 结账成功后，机器人会向 `staffUserIds` 与 `logoutNotifyUserIds` 中的用户私聊同一份账单，账单会明确显示结账玩家身份。
+同一玩家在前一次退场结账尚未完成时重复发送 `/logout` 或 `/退场`，机器人会复用同一次结账请求与账单，避免重复扣款。
 账单和管理员代操作回执均使用“平台昵称（QQ：号码）”称呼玩家；平台暂时无法提供昵称时显示“未知昵称（QQ：号码）”，不会显示内部玩家 ID。
 管理员 `/add` 增加免费余额；`/del` 按结账相同的顺序从可用免费余额、再从付费余额扣除，余额不足时会返回余额不足提示。
 * `billing` - 预览当前玩家本场计费的消费费用。
@@ -74,6 +75,7 @@ pricingConfigIds: [pricing-mahjong-a]
 * `mahjong <tableId>` / `上桌 [tableId]` - 加入指定麻将桌；`/上桌` 未提供桌号时会引导查看 `/麻将列表`。仅允许已通过 `login`/`入场` 开启默认入场会话的玩家使用。
 * `下桌` - 自动离开当前所在麻将桌。
 * `麻将列表` - 查看已配置机器的桌名、命令别名，以及空闲、等位或游玩中状态。
+* `api测速 [次数]` - 连续查询自己的钱包，显示 Bot 到 PRiSM API 的最小、平均与最大延迟（默认 3 次，最多 10 次）。
 
 ### 管理员快捷指令
 启用 `enableStaffCommands`、配置 `staffUserIds` 白名单与 `staffSessionToken` 后可使用：

package/lib/index.js

@@ -52,6 +52,7 @@ const USAGE = {
     mahjong_join: "/上桌 <桌号>",
     mahjong_leave: "/下桌",
     mahjong_list: "/麻将列表",
+    api_benchmark: "/api测速 [次数]",
     prism_on: "/prism on <设备ID>",
     prism_off: "/prism off <设备ID|all>",
     prism_coin: "/prism coin <设备ID> [数量]",
@@ -82,6 +83,7 @@ function applyPrismKoishiPlugin(ctx, config) {
     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)));
+    ctx.command("api测速 [count:number]", "测试 Bot 到 PRiSM API 的钱包查询延迟").action(wrap(async (context, count) => service.benchmarkApi(await service.sender(context), count)));
     ctx.command("items [target:user]", "查看玩家资产").action(wrap(async (context, target) => service.withTarget(await service.sender(context), target, (sender) => service.items(sender), context.session?.bot)));
     ctx.command("list", "查看当前在线玩家列表").action(wrap(async (context) => service.listActiveSessions(await service.sender(context))));
     ctx.command("show [deviceId]", "查看设备电源状态").action(wrap(async (context, deviceId) => service.listDeviceStates(deviceId)));
@@ -217,10 +219,10 @@ class PrismApiClient {
             body: this.identityBody(identity),
         });
     }
-    async confirmCheckoutByIdentity(identity) {
+    async confirmCheckoutByIdentity(identity, closeSessionsBeforeBalanceCheck = true) {
         return this.request("POST", "/rpc/integration/players/by-identity/checkout/confirm", {
             token: this.config.integrationToken,
-            body: this.identityBody(identity),
+            body: { ...this.identityBody(identity), closeSessionsBeforeBalanceCheck },
         });
     }
     async redeemCodeByIdentity(identity, code) {
@@ -297,6 +299,7 @@ class PrismApiClient {
 class PrismKoishiService {
     config;
     mahjongTables = new Map();
+    logoutInFlight = new Map();
     client;
     constructor(ctx, config) {
         this.config = config;
@@ -490,7 +493,21 @@ class PrismKoishiService {
         return this.formatCheckoutPreview(result, sender);
     }
     async logout(sender, bot) {
-        const result = (await this.client.confirmCheckoutByIdentity(this.identity(sender)));
+        const existing = this.logoutInFlight.get(sender.id);
+        if (existing)
+            return existing;
+        const task = this.performLogout(sender, bot);
+        this.logoutInFlight.set(sender.id, task);
+        try {
+            return await task;
+        }
+        finally {
+            if (this.logoutInFlight.get(sender.id) === task)
+                this.logoutInFlight.delete(sender.id);
+        }
+    }
+    async performLogout(sender, bot) {
+        const result = (await this.client.confirmCheckoutByIdentity(this.identity(sender), false));
         const settlement = result?.playerSettlement ?? result?.settlement ?? {};
         const records = result?.settlements ?? [];
         const sessionPreviews = records.map((rec) => {
@@ -529,6 +546,26 @@ class PrismKoishiService {
         const result = (await this.client.getWalletByIdentity(this.identity(sender)));
         return formatWallet(result, this.config.currencyName);
     }
+    async benchmarkApi(sender, rawCount) {
+        const count = rawCount == null || rawCount === "" ? 3 : Number(rawCount);
+        if (!Number.isInteger(count) || count < 1 || count > 10)
+            return "次数须为 1 到 10 的整数。";
+        const samples = [];
+        for (let index = 0; index < count; index++) {
+            const startedAt = performance.now();
+            await this.client.getWalletByIdentity(this.identity(sender));
+            samples.push(performance.now() - startedAt);
+        }
+        const min = Math.min(...samples);
+        const max = Math.max(...samples);
+        const average = samples.reduce((sum, sample) => sum + sample, 0) / samples.length;
+        return [
+            `📡 PRiSM API 测速（钱包查询，${count} 次）`,
+            `最小：${formatNumber(min)} ms`,
+            `平均：${formatNumber(average)} ms`,
+            `最大：${formatNumber(max)} ms`,
+        ].join("\n");
+    }
     async items(sender) {
         const holdings = extractRows((await this.client.getAssetsByIdentity(this.identity(sender))));
         if (holdings.length === 0)
@@ -914,8 +951,19 @@ class PrismKoishiService {
         lines.push(`计费总价：${formatNumber(subtotal)}${currency}`);
         if (hasNonZeroAdjustment)
             lines.push(`优惠后价格：${formatNumber(total)}${currency}`);
-        if (hasBalance)
-            lines.push(`扣款后余额：${formatNumber(balance)}${currency}`);
+        if (hasBalance) {
+            const isPreview = result?.settlementPreview != null && result?.settlement == null;
+            if (isPreview) {
+                const projectedBalance = balance - toNumber(total);
+                lines.push(`当前余额：${formatNumber(balance)}${currency}`);
+                lines.push(projectedBalance >= 0
+                    ? `预计结账后余额：${formatNumber(projectedBalance)}${currency}`
+                    : `预计结账后余额：余额不足（还差 ${formatNumber(-projectedBalance)}${currency}）`);
+            }
+            else {
+                lines.push(`扣款后余额：${formatNumber(balance)}${currency}`);
+            }
+        }
         return lines.join("\n");
     }
     handleCommandError(error) {

package/package.json

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