koishi-plugin-prism 0.1.7 → 0.1.13

package/README.md

@@ -6,12 +6,12 @@
 
 ## 🌟 功能特性
 
-* 🎮 **玩家入场与结算**：通过 `/login` 和 `/logout` 指令开启或结算计费场次，支持 `/入场` 别名。
+* 🎮 **玩家入场与结算**：通过 `/login` 和 `/logout` 指令开启或结算计费场次，支持 `/入场` 别名；命令回复会引用触发消息，结账账单可私聊通知管理员与指定用户。
 * 💳 **账户钱包与资产管理**：支持查询钱包余额（`/wallet`）和持有的道具资产（`/items`）。
 * 🀄 **麻将桌位集成**：包含 `/mahjong <tableId>` 以及便捷的 `/上桌` / `/下桌` 控制。`上桌` 仅允许已通过 `login`/`入场` 开启默认入场会话的玩家使用。`list` 会按音乐游戏和麻将桌分组，并对同一玩家的多个计时会话去重；麻将桌显示当前人数和容量。未满桌候座由机器人进程暂存，机器人重启后不会保留。
 * 🔌 **硬件设备状态与电源管理**：可直接在聊天中查看设备状态（`/show`）、远程开启/关闭电源（`/on`、`/off`）、远程投币（`/coin`）和模拟刷卡（`/scan`）。
 * 🎟️ **礼物兑换码**：使用 `/redeem <code>` 兑换系统发放的福利礼包。
-* 🛠️ **管理员高级指令**：允许管理员在聊天中查看玩家（`/admin.players`）、创建新玩家账户（`/admin.create-player`）、充值余额（`/admin.grant-balance`）、手动结账（`/admin.checkout`）以及制作礼包兑换码（`/admin.redeem-code`）。
+* 🛠️ **管理员快捷指令**：允许管理员为指定平台用户增加或扣除余额，并覆盖结账金额后立即结账。
 
 ## ⚙️ 配置说明
 
@@ -29,8 +29,11 @@
 | `defaultScanProvider` | `string` | `"aime"` | 默认模拟刷卡时的读卡器协议提供商（如 `"aime"`）。 |
 | `currencyName` | `string` | `"金币"` | 账户货币在显示时的自定义单位名称。 |
 | `resolveDisplayName` | `function` | - | 可选。自定义用于获取群内昵称作为玩家注册名的异步逻辑。 |
-| `enableStaffCommands` | `boolean` | `false` | 是否开启管理员/店员的高级控制指令。 |
-| `staffUserIds` | `string[]` | `[]` | 允许执行管理员指令的平台用户 ID（如 QQ 号）白名单。 |
+| `enableStaffCommands` | `boolean` | `false` | 是否开启管理员快捷指令。 |
+| `staffUserIds` | `string[]` | `[]` | 允许执行管理员快捷指令的平台用户 ID（如 QQ 号）白名单。空列表不授予目标用户操作权限。 |
+| `logoutNotifyUserIds` | `string[]` | `[]` | 结账成功后额外私聊完整账单的平台用户 ID。通知收件人为该列表与 `staffUserIds` 的去重并集。 |
+
+管理员快捷指令必须同时配置 `enableStaffCommands: true` 与 `staffUserIds`。它们使用现有 `integrationToken` 调用受限的余额调整和立即结账接口；目标用户参数使用 Koishi 的 `user` 选择器，只有白名单内的管理员可以操作其他用户。
 
 ## 📝 机器人指令列表
 
@@ -38,6 +41,8 @@
 * `register` - 绑定或注册当前平台账号到 PRiSM 账户。
 * `login` / `入场` - 开启当前玩家的计费场次。
 * `logout` - 结算当前玩家的计费场次。
+玩家在未产生任何费用时退场，机器人会简洁显示“本次未产生费用”和当前余额；存在收费或优惠明细时仍显示完整结算账单。
+结账成功后，机器人会向 `staffUserIds` 与 `logoutNotifyUserIds` 中的用户私聊同一份账单，账单会明确显示结账玩家身份。
 * `billing` - 预览当前玩家本场计费的消费费用。
 * `wallet` - 查看当前玩家的钱包余额。
 * `items` - 查看当前玩家持有的道具或资产。
@@ -53,12 +58,11 @@
 * `mahjong <tableId>` / `上桌 <tableId>` - 加入指定麻将桌；仅允许已通过 `login`/`入场` 开启默认入场会话的玩家使用。
 * `下桌 <tableId>` - 离开指定麻将桌。
 
-### 管理员指令 (需在白名单内并开启)
-* `admin.players` - 列出系统内注册的所有玩家。
-* `admin.create-player <displayName>` - 创建一个新的 PRiSM 玩家。
-* `admin.grant-balance <playerId> <amount>` - 为指定玩家发放充值余额。
-* `admin.redeem-code <code> <presentId>` - 快速创建单次使用的兑换码。
-* `admin.checkout <playerId>` - 代替并强制为指定玩家结账。
+### 管理员快捷指令
+启用 `enableStaffCommands`、配置 `staffUserIds` 白名单与 `staffSessionToken` 后可使用：
+* `add <target:user> <amount:number>` - 为目标用户增加余额。
+* `del <target:user> <amount:number>` - 从目标用户扣除余额。
+* `overwrite <target:user> <amount:number> [reason:text]` - 覆盖目标用户本次结账金额，并立即执行结账；未填写原因时使用默认管理员调价原因。
 
 ## 🛠️ 本地开发与构建
 

package/lib/index.d.ts

@@ -24,6 +24,7 @@ export type PrismKoishiPluginConfig = {
     currencyName: string;
     enableStaffCommands?: boolean;
     staffUserIds?: string[];
+    logoutNotifyUserIds?: string[];
     mahjongTables?: string;
     mahjongTableSize?: number;
     mahjongLabelPrefix?: string;
@@ -39,7 +40,6 @@ export type PrismKoishiPluginConfig = {
     now?: () => Date;
     baseUrl?: string;
     integrationToken?: string;
-    staffSessionToken?: string;
     client?: any;
 };
 export type KoishiCommandRegistration = {
@@ -56,6 +56,7 @@ export type KoishiLikeContext = {
 export type KoishiActionContext = {
     session: {
         userId: string;
+        messageId?: string;
         senderId?: string;
         senderName?: string;
         username?: string;
@@ -63,6 +64,7 @@ export type KoishiActionContext = {
             getUser?(id: string): Promise<{
                 name?: string;
             }>;
+            broadcast?(userIds: string[], content: string): Promise<void>;
         };
     };
 };

package/lib/index.js

@@ -12,7 +12,6 @@ exports.Config = koishi_1.Schema.object({
     autoRegister: koishi_1.Schema.boolean().default(true).description("是否自动注册"),
     baseUrl: koishi_1.Schema.string().description("PRiSM 后端 API Base URL"),
     integrationToken: koishi_1.Schema.string().role("secret").description("集成 API Token"),
-    staffSessionToken: koishi_1.Schema.string().role("secret").description("Staff 管理 Token (可选)"),
     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("默认刷卡提供商"),
@@ -20,6 +19,7 @@ exports.Config = koishi_1.Schema.object({
     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列表"),
+    logoutNotifyUserIds: 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("麻将桌人数限制"),
@@ -52,47 +52,41 @@ const USAGE = {
     prism_redeem: "/prism redeem <兑换码>",
     list: "/list",
     show: "/show [设备ID]",
-    staff_create_player: "/prism.admin.create-player <玩家昵称>",
-    staff_grant_balance: "/prism.admin.grant-balance <玩家ID> <金额>",
-    staff_redeem_code: "/prism.admin.redeem-code <兑换码> <礼物ID>",
-    staff_checkout: "/prism.admin.checkout <玩家ID>",
 };
 function applyPrismKoishiPlugin(ctx, config) {
     const service = new PrismKoishiService(ctx, config);
     const wrap = (handler) => async (context, ...args) => {
         try {
-            return await handler(context, ...args);
+            const message = await handler(context, ...args);
+            return context.session?.messageId ? `${(0, koishi_1.h)("quote", { id: context.session.messageId })}${message}` : message;
         }
         catch (error) {
-            return service.handleCommandError(error);
+            const message = service.handleCommandError(error);
+            return context.session?.messageId ? `${(0, koishi_1.h)("quote", { id: context.session.messageId })}${message}` : message;
         }
     };
     ctx.command("register", "绑定或注册当前平台用户到 PRiSM").action(wrap(async (context) => service.register(await service.sender(context))));
-    ctx.command("login", "开启当前玩家的计费场次").action(wrap(async (context) => service.login(await service.sender(context))));
-    ctx.command("入场", "入场 (alias of login)").action(wrap(async (context) => service.login(await service.sender(context))));
+    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("logout", "结算当前玩家的计费场次").action(wrap(async (context) => service.logout(await service.sender(context))));
-    ctx.command("billing", "预览当前玩家的结账费用").action(wrap(async (context) => service.billing(await service.sender(context))));
-    ctx.command("wallet", "查看当前玩家钱包余额").action(wrap(async (context) => service.wallet(await service.sender(context))));
-    ctx.command("items", "查看当前玩家持有资产").action(wrap(async (context) => service.items(await service.sender(context))));
+    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("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)));
-    ctx.command("history", "查看当前玩家历史场次").action(wrap(async (context) => service.history(await service.sender(context))));
+    ctx.command("history [target:user]", "查看玩家历史").action(wrap(async (context, target) => service.withTarget(await service.sender(context), target, (sender) => service.history(sender), context.session?.bot)));
     ctx.command("lock", "向默认门锁设备发送开门指令").action(wrap(async (context) => service.lock(await service.sender(context))));
     ctx.command("on <deviceId>", "请求启动指定设备电源").action(wrap(async (context, deviceId) => service.powerOn(await service.sender(context), deviceId)));
     ctx.command("off <deviceId>", "请求关闭指定设备电源").action(wrap(async (context, deviceId) => service.powerOff(await service.sender(context), deviceId)));
     ctx.command("coin <deviceId> [count]", "请求向指定设备投币").action(wrap(async (context, deviceId, count) => service.coin(await service.sender(context), deviceId, count)));
     ctx.command("scan <deviceId> <subject>", "请求指定设备模拟刷卡").action(wrap(async (context, deviceId, subject) => service.scan(await service.sender(context), deviceId, subject)));
     ctx.command("redeem <code>", "兑换 PRiSM 礼物码").action(wrap(async (context, code) => service.redeem(await service.sender(context), code)));
-    if (config.enableStaffCommands) {
-        ctx.command("admin.players", "列出 PRiSM 玩家").action(wrap(async (context) => service.staffPlayers(await service.sender(context))));
-        ctx.command("admin.create-player <displayName>", "创建 PRiSM 玩家").action(wrap(async (context, displayName) => service.staffCreatePlayer(await service.sender(context), displayName)));
-        ctx.command("admin.grant-balance <playerId> <amount>", "给指定玩家发放充值余额").action(wrap(async (context, playerId, amount) => service.staffGrantBalance(await service.sender(context), playerId, amount)));
-        ctx.command("admin.redeem-code <code> <presentId>", "创建单次使用兑换码").action(wrap(async (context, code, presentId) => service.staffRedeemCode(await service.sender(context), code, presentId)));
-        ctx.command("admin.checkout <playerId>", "替指定玩家结账").action(wrap(async (context, playerId) => service.staffCheckout(await service.sender(context), playerId)));
-    }
+    ctx.command("add <target:user> <amount:number>", "增加玩家余额").action(wrap(async (context, target, amount) => service.adjustTargetBalance(await service.sender(context), target, amount, 1, context.session?.bot)));
+    ctx.command("del <target:user> <amount:number>", "扣除玩家余额").action(wrap(async (context, target, amount) => service.adjustTargetBalance(await service.sender(context), target, amount, -1, context.session?.bot)));
+    ctx.command("overwrite <target:user> <amount:number> [reason:text]", "覆盖结账金额并立即结账").action(wrap(async (context, target, amount, reason) => service.overwriteTargetCheckout(await service.sender(context), target, amount, reason, context.session?.bot)));
     const intervalMs = (config.powerOffInterval ?? 0) * 1000;
     if (intervalMs > 0 && typeof ctx.setInterval === "function") {
         ctx.setInterval(() => {
@@ -155,12 +149,6 @@ class PrismApiClient {
             throw new PrismBotClientError(error.message || "Network error", "NETWORK_ERROR", 500, {});
         }
     }
-    requireStaffSessionToken() {
-        if (!this.config.staffSessionToken) {
-            throw new PrismBotClientError("Staff session token is required for this Bot shortcut.", "STAFF_TOKEN_REQUIRED", 0, {});
-        }
-        return this.config.staffSessionToken;
-    }
     identityBody(identity) {
         return {
             identity: {
@@ -278,35 +266,16 @@ class PrismApiClient {
             token: this.config.integrationToken,
         });
     }
-    // Staff commands
-    async listStaffPlayers() {
-        return this.request("GET", "/rpc/staff/players", {
-            token: this.requireStaffSessionToken(),
-        });
-    }
-    async createStaffPlayer(displayName) {
-        return this.request("POST", "/rpc/staff/players", {
-            token: this.requireStaffSessionToken(),
-            body: { displayName },
-        });
-    }
-    async grantStaffAssets(playerId, assets) {
-        return this.request("POST", "/rpc/staff/players/:playerId/adjustments/assets", {
-            token: this.requireStaffSessionToken(),
-            params: { playerId },
-            body: { assets },
-        });
-    }
-    async createStaffRedeemCode(input) {
-        return this.request("POST", "/rpc/staff/redeem-codes", {
-            token: this.requireStaffSessionToken(),
-            body: input,
+    async adjustAssetsByIdentity(identity, adjustments) {
+        return this.request("POST", "/rpc/integration/players/by-identity/assets/adjustments", {
+            token: this.config.integrationToken,
+            body: { ...this.identityBody(identity), adjustments },
         });
     }
-    async staffCheckout(playerId) {
-        return this.request("POST", "/rpc/staff/players/:playerId/settlements/checkout", {
-            token: this.requireStaffSessionToken(),
-            params: { playerId },
+    async checkoutWithOverrideByIdentity(identity, total, reason) {
+        return this.request("POST", "/rpc/integration/players/by-identity/checkout/override", {
+            token: this.config.integrationToken,
+            body: { ...this.identityBody(identity), total, reason },
         });
     }
 }
@@ -350,7 +319,6 @@ class PrismKoishiService {
             this.client = new PrismApiClient(http, {
                 baseUrl: config.baseUrl,
                 integrationToken: config.integrationToken,
-                staffSessionToken: config.staffSessionToken,
             });
         }
     }
@@ -374,10 +342,47 @@ class PrismKoishiService {
         await this.client.resolveOrRegisterIdentity(this.identity(sender));
         return "注册成功";
     }
+    async loginForTarget(actor, targetSubject, bot) {
+        return this.withTarget(actor, targetSubject, async (sender, isTargeted) => {
+            await this.client.startSessionByIdentity(this.identity(sender), this.loginSessionBody());
+            return isTargeted ? `✅ 已为用户 ${formatPlayerReference(sender)} 入场成功` : "✅ 入场成功";
+        }, bot);
+    }
     async login(sender) {
         await this.client.startSessionByIdentity(this.identity(sender), this.loginSessionBody());
         return "✅ 入场成功";
     }
+    async withTarget(actor, targetSubject, action, bot) {
+        const target = await this.targetSender(actor, targetSubject, bot);
+        if (typeof target === "string")
+            return target;
+        return action(target, target !== actor);
+    }
+    async adjustTargetBalance(actor, targetSubject, rawAmount, direction, bot) {
+        return this.withTarget(actor, targetSubject, async (sender) => {
+            const amount = Number(rawAmount);
+            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 管理员扣除余额",
+                }]);
+            return `✅ 已为用户 ${sender.id}${isAddition ? "增加" : "扣除"} ${formatNumber(amount)} ${this.config.currencyName}`;
+        }, bot);
+    }
+    async overwriteTargetCheckout(actor, targetSubject, rawAmount, rawReason, bot) {
+        return this.withTarget(actor, targetSubject, async (sender) => {
+            const total = Number(rawAmount);
+            if (!Number.isFinite(total) || total < 0)
+                return "金额必须为非负数";
+            const reason = cleanText(rawReason) || "Koishi 管理员手动调价";
+            await this.client.checkoutWithOverrideByIdentity(this.identity(sender), total, reason);
+            return `✅ 已为用户 ${formatPlayerReference(sender)} 覆盖结账为 ${formatNumber(total)} ${this.config.currencyName}`;
+        }, bot);
+    }
     async mahjongJoin(sender, rawTableId) {
         const tableId = cleanText(rawTableId);
         if (!tableId)
@@ -455,7 +460,7 @@ class PrismKoishiService {
         const result = (await this.client.previewCheckoutByIdentity(this.identity(sender)));
         return this.formatCheckoutPreview(result, sender);
     }
-    async logout(sender) {
+    async logout(sender, bot) {
         const result = (await this.client.confirmCheckoutByIdentity(this.identity(sender)));
         const settlement = result?.playerSettlement ?? result?.settlement ?? {};
         const records = result?.settlements ?? [];
@@ -484,7 +489,12 @@ class PrismKoishiService {
             adjustments: result?.adjustments ?? [],
             assetHoldings: result?.assetHoldings ?? [],
         };
-        return this.formatCheckoutPreview(synthetic, sender, "✅ 退场成功 · 结算账单");
+        const receipt = await this.formatCheckoutPreview(synthetic, sender, "✅ 退场成功 · 结算账单");
+        const recipients = [...new Set([...(this.config.staffUserIds ?? []), ...(this.config.logoutNotifyUserIds ?? [])])];
+        if (recipients.length > 0 && bot?.broadcast) {
+            await bot.broadcast(recipients, receipt);
+        }
+        return receipt;
     }
     async wallet(sender) {
         const result = (await this.client.getWalletByIdentity(this.identity(sender)));
@@ -583,87 +593,6 @@ class PrismKoishiService {
             .map((d) => `${d.label || d.deviceId}: ${d.state?.state ?? "unknown"}`)
             .join("\n");
     }
-    async staffPlayers(sender) {
-        const denied = this.staffDenied(sender);
-        if (denied)
-            return denied;
-        const result = (await this.client.listStaffPlayers());
-        const players = (result?.players ?? []);
-        if (players.length === 0)
-            return "🫥 窝里目前没有玩家呢";
-        return [
-            `👥 窝里目前共有 ${players.length} 人`,
-            "",
-            ...players.map((p) => {
-                const lines = [`玩家: ${p?.displayName ?? p?.id ?? ""} (${p?.id ?? ""})`];
-                if (p?.status)
-                    lines.push(`状态: ${p.status}`);
-                if (p?.walletTotal != null)
-                    lines.push(`余额: ${p.walletTotal} ${this.config.currencyName}`);
-                return lines.join("\n");
-            }),
-        ].join("\n");
-    }
-    async staffCreatePlayer(sender, rawDisplayName) {
-        const displayName = cleanText(rawDisplayName);
-        if (!displayName)
-            return commandUsage("staff_create_player");
-        const denied = this.staffDenied(sender);
-        if (denied)
-            return denied;
-        const result = (await this.client.createStaffPlayer?.(displayName));
-        const player = result?.player ?? {};
-        return `创建成功\n玩家: ${player?.displayName ?? displayName}\nID: ${player?.id ?? ""}`;
-    }
-    async staffGrantBalance(sender, rawPlayerId, rawAmount) {
-        const playerId = cleanText(rawPlayerId);
-        const amount = cleanText(rawAmount);
-        if (!playerId || !amount)
-            return commandUsage("staff_grant_balance");
-        const denied = this.staffDenied(sender);
-        if (denied)
-            return denied;
-        await this.client.grantStaffAssets?.(playerId, [
-            {
-                assetType: "currency",
-                assetCode: "paid",
-                amount: Number(amount),
-                mergeStrategy: "stack",
-                activeAt: null,
-                expiresAt: null,
-            },
-        ]);
-        return `✅ 已为玩家 ${playerId} 发放 ${amount} ${this.config.currencyName}`;
-    }
-    async staffRedeemCode(sender, rawCode, rawPresentId) {
-        const code = cleanText(rawCode);
-        const presentId = cleanText(rawPresentId);
-        if (!code || !presentId)
-            return commandUsage("staff_redeem_code");
-        const denied = this.staffDenied(sender);
-        if (denied)
-            return denied;
-        const result = (await this.client.createStaffRedeemCode?.({
-            code,
-            presentId,
-            activeAt: null,
-            expiresAt: null,
-            maxUseCount: 1,
-        }));
-        const redeemCode = result?.redeemCode?.code ?? code;
-        return `成功生成 1 个兑换码:\n${redeemCode}`;
-    }
-    async staffCheckout(sender, rawPlayerId) {
-        const playerId = cleanText(rawPlayerId);
-        if (!playerId)
-            return commandUsage("staff_checkout");
-        const denied = this.staffDenied(sender);
-        if (denied)
-            return denied;
-        const result = (await this.client.staffCheckout?.(playerId));
-        const settlement = result?.settlement ?? {};
-        return `\n✅ 已为用户 ${playerId} 退场\n消费: ${formatNumber(settlement?.total ?? 0)} ${this.config.currencyName}`;
-    }
     async autoPowerOffLoop() {
         const interval = this.config.powerOffInterval ?? 0;
         if (interval <= 0)
@@ -797,6 +726,21 @@ class PrismKoishiService {
             displayName: sender.name || `${this.config.provider.toUpperCase()} ${sender.id}`,
         };
     }
+    async targetSender(actor, targetSubject, bot) {
+        const subject = normalizeTargetSubject(targetSubject);
+        if (!subject)
+            return actor;
+        const denied = this.targetStaffDenied(actor);
+        if (denied)
+            return denied;
+        try {
+            const user = await bot?.getUser?.(subject);
+            return { id: subject, name: user?.name || subject };
+        }
+        catch {
+            return { id: subject, name: subject };
+        }
+    }
     loginSessionBody() {
         const pricingConfigIds = (this.config.loginPricingConfigIds ?? [])
             .map((id) => id.trim())
@@ -817,6 +761,14 @@ class PrismKoishiService {
             return "权限不足";
         return null;
     }
+    targetStaffDenied(sender) {
+        if (!this.config.enableStaffCommands)
+            return "员工命令未启用";
+        const allowed = this.config.staffUserIds ?? [];
+        if (!allowed.includes(sender.id))
+            return "权限不足";
+        return null;
+    }
     async formatCheckoutPreview(result, sender, title = "【结算账单】") {
         if (result?.billing && result?.session) {
             return formatLegacyBilling(result, this.config.currencyName);
@@ -849,6 +801,24 @@ class PrismKoishiService {
         const lines = [];
         lines.push(title);
         lines.push(await this.resolvePlayerDisplay(sender, playerId));
+        let balance = 0;
+        let hasBalance = false;
+        for (const holding of assetHoldings) {
+            const code = String(holding?.assetCode ?? "").toLowerCase();
+            if (code.includes("paid") || code.includes("free") || code.includes("currency")) {
+                balance += toNumber(holding?.quantity ?? 0);
+                hasBalance = true;
+            }
+        }
+        const hasNonZeroSessionTotal = sessionPreviews.some((session) => toNumber(session?.total ?? 0) !== 0);
+        const hasNonZeroAdjustment = hasAdjustmentEntries(adjustments, sessionPreviews);
+        if (!hasNonZeroSessionTotal && !hasNonZeroAdjustment) {
+            lines.push("");
+            lines.push("本次未产生费用");
+            if (hasBalance)
+                lines.push(`余额：${formatNumber(balance)}${currency}`);
+            return lines.join("\n");
+        }
         const validStarts = sessionPreviews.map((s) => parseDateTime(s?.startedAt)).filter(Boolean);
         const validEnds = sessionPreviews.map((s) => sessionDisplayEnd(s, previewedAt)).filter(Boolean);
         if (validStarts.length > 0) {
@@ -881,20 +851,9 @@ class PrismKoishiService {
                 lines.push(`  └ ${adjLabel}：${formatNumber(amount)}${currency}`);
             }
         }
-        let balance = 0;
-        let hasBalance = false;
-        for (const holding of assetHoldings) {
-            const code = String(holding?.assetCode ?? "").toLowerCase();
-            if (code.includes("paid") || code.includes("free") || code.includes("currency")) {
-                balance += toNumber(holding?.quantity ?? 0);
-                hasBalance = true;
-            }
-        }
         lines.push("");
         lines.push(`计费总价：${formatNumber(subtotal)}${currency}`);
-        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)
+        if (hasNonZeroAdjustment)
             lines.push(`优惠后价格：${formatNumber(total)}${currency}`);
         if (hasBalance)
             lines.push(`扣款后余额：${formatNumber(balance)}${currency}`);
@@ -1041,6 +1000,16 @@ function parsePositiveInt(value, command, label, fallback) {
 function cleanText(value) {
     return value == null ? "" : String(value).trim();
 }
+function normalizeTargetSubject(value) {
+    const subject = cleanText(value);
+    const separator = subject.indexOf(":");
+    return separator > 0 ? subject.slice(separator + 1) : subject;
+}
+function formatPlayerReference(sender) {
+    return sender.name && sender.name !== sender.id
+        ? `${sender.name}（QQ：${sender.id}）`
+        : sender.id;
+}
 function toNumber(value) {
     if (value == null)
         return 0;
@@ -1059,6 +1028,9 @@ function toNumber(value) {
         return asFloat;
     return 0;
 }
+function hasAdjustmentEntries(adjustments, sessionPreviews) {
+    return adjustments.some((adjustment) => toNumber(firstDefined(adjustment ?? {}, "amount", "saved", 0)) !== 0) || sessionPreviews.some((session) => (session?.adjustments ?? []).some((adjustment) => toNumber(firstDefined(adjustment ?? {}, "amount", "saved", 0)) !== 0));
+}
 function formatNumber(value) {
     if (typeof value === "boolean")
         return value ? "1" : "0";

package/package.json

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