koishi-plugin-prism 0.1.10 → 0.1.15

package/README.md

@@ -8,7 +8,7 @@
 
 * 🎮 **玩家入场与结算**：通过 `/login` 和 `/logout` 指令开启或结算计费场次，支持 `/入场` 别名；命令回复会引用触发消息，结账账单可私聊通知管理员与指定用户。
 * 💳 **账户钱包与资产管理**：支持查询钱包余额（`/wallet`）和持有的道具资产（`/items`）。
-* 🀄 **麻将桌位集成**：包含 `/mahjong <tableId>` 以及便捷的 `/上桌` / `/下桌` 控制。`上桌` 仅允许已通过 `login`/`入场` 开启默认入场会话的玩家使用。`list` 会按音乐游戏和麻将桌分组，并对同一玩家的多个计时会话去重；麻将桌显示当前人数和容量。未满桌候座由机器人进程暂存，机器人重启后不会保留。
+* 🀄 **麻将桌位集成**：包含 `/mahjong <tableId>` 以及便捷的 `/上桌` / `/下桌` 控制。`上桌` 仅允许已通过 `login`/`入场` 开启默认入场会话的玩家使用。`list` 按 session 标签分组：有非音乐游戏 session 的玩家归入最新的非音乐标签，纯音乐玩家归入音乐标签；麻将桌额外显示当前人数和容量。已开局桌位会从后端活跃 session 自动恢复，未满桌候座仍由机器人进程暂存，重启后不会保留。
 * 🔌 **硬件设备状态与电源管理**：可直接在聊天中查看设备状态（`/show`）、远程开启/关闭电源（`/on`、`/off`）、远程投币（`/coin`）和模拟刷卡（`/scan`）。
 * 🎟️ **礼物兑换码**：使用 `/redeem <code>` 兑换系统发放的福利礼包。
 * 🛠️ **管理员快捷指令**：允许管理员为指定平台用户增加或扣除余额，并覆盖结账金额后立即结账。
@@ -31,10 +31,9 @@
 | `resolveDisplayName` | `function` | - | 可选。自定义用于获取群内昵称作为玩家注册名的异步逻辑。 |
 | `enableStaffCommands` | `boolean` | `false` | 是否开启管理员快捷指令。 |
 | `staffUserIds` | `string[]` | `[]` | 允许执行管理员快捷指令的平台用户 ID（如 QQ 号）白名单。空列表不授予目标用户操作权限。 |
-| `staffSessionToken` | `string` | - | 管理员写操作所需的 Staff 管理 Token。 |
 | `logoutNotifyUserIds` | `string[]` | `[]` | 结账成功后额外私聊完整账单的平台用户 ID。通知收件人为该列表与 `staffUserIds` 的去重并集。 |
 
-管理员快捷指令必须同时配置 `enableStaffCommands: true`、`staffUserIds` 和 `staffSessionToken`。目标用户参数使用 Koishi 的 `user` 选择器；只有白名单内的管理员可以操作其他用户。
+管理员快捷指令必须同时配置 `enableStaffCommands: true` 与 `staffUserIds`。它们使用现有 `integrationToken` 调用受限的余额调整和立即结账接口；目标用户参数使用 Koishi 的 `user` 选择器，只有白名单内的管理员可以操作其他用户。
 
 ## 📝 机器人指令列表
 
@@ -47,7 +46,7 @@
 * `billing` - 预览当前玩家本场计费的消费费用。
 * `wallet` - 查看当前玩家的钱包余额。
 * `items` - 查看当前玩家持有的道具或资产。
-* `list` - 查看当前在线/在店游玩玩家的列表，按音乐游戏和麻将桌分组并对同一玩家的多个计时会话去重；麻将桌显示当前人数和容量。未满桌候座由机器人进程暂存，机器人重启后不会保留。
+* `list` - 查看当前在线/在店游玩玩家的列表，按 session 标签分组并对同一玩家去重；存在非音乐游戏 session 时取最新的非音乐标签，麻将桌显示当前人数和容量。已开局桌位由后端 session 恢复；未满桌候座由机器人进程暂存，机器人重启后不会保留。
 * `show [deviceId]` - 查看设备电源与连接状态。
 * `history` - 查看自己的历史游玩记录。
 * `lock` - 发送开门指令。

package/lib/index.d.ts

@@ -40,7 +40,6 @@ export type PrismKoishiPluginConfig = {
     now?: () => Date;
     baseUrl?: string;
     integrationToken?: string;
-    staffSessionToken?: string;
     client?: any;
 };
 export type KoishiCommandRegistration = {

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("默认刷卡提供商"),
@@ -67,27 +66,27 @@ function applyPrismKoishiPlugin(ctx, config) {
         }
     };
     ctx.command("register", "绑定或注册当前平台用户到 PRiSM").action(wrap(async (context) => service.register(await service.sender(context))));
-    ctx.command("login [target:user]", "开启玩家计费场次").action(wrap(async (context, target) => service.loginForTarget(await service.sender(context), target)));
-    ctx.command("入场 [target:user]", "入场").action(wrap(async (context, target) => service.loginForTarget(await service.sender(context), target)));
+    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 [target:user]", "结算玩家计费场次").action(wrap(async (context, target) => service.withTarget(await service.sender(context), target, (sender) => service.logout(sender, context.session?.bot))));
-    ctx.command("billing [target:user]", "预览玩家结账费用").action(wrap(async (context, target) => service.withTarget(await service.sender(context), target, (sender) => service.billing(sender))));
-    ctx.command("wallet [target:user]", "查看玩家钱包").action(wrap(async (context, target) => service.withTarget(await service.sender(context), target, (sender) => service.wallet(sender))));
-    ctx.command("items [target:user]", "查看玩家资产").action(wrap(async (context, target) => service.withTarget(await service.sender(context), target, (sender) => service.items(sender))));
+    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 [target:user]", "查看玩家历史").action(wrap(async (context, target) => service.withTarget(await service.sender(context), target, (sender) => service.history(sender))));
+    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)));
-    ctx.command("add <target:user> <amount:number>", "增加玩家余额").action(wrap(async (context, target, amount) => service.adjustTargetBalance(await service.sender(context), target, amount, 1)));
-    ctx.command("del <target:user> <amount:number>", "扣除玩家余额").action(wrap(async (context, target, amount) => service.adjustTargetBalance(await service.sender(context), target, amount, -1)));
-    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)));
+    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(() => {
@@ -150,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: {
@@ -273,18 +266,16 @@ class PrismApiClient {
             token: this.config.integrationToken,
         });
     }
-    async adjustStaffAssets(playerId, adjustments) {
-        return this.request("POST", "/rpc/staff/players/:playerId/assets/adjustments", {
-            token: this.requireStaffSessionToken(),
-            params: { playerId },
-            body: { adjustments },
+    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 checkoutWithOverride(playerId, total, reason) {
-        return this.request("POST", "/rpc/staff/players/:playerId/checkout/override", {
-            token: this.requireStaffSessionToken(),
-            params: { playerId },
-            body: { total, reason },
+    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 },
         });
     }
 }
@@ -328,7 +319,6 @@ class PrismKoishiService {
             this.client = new PrismApiClient(http, {
                 baseUrl: config.baseUrl,
                 integrationToken: config.integrationToken,
-                staffSessionToken: config.staffSessionToken,
             });
         }
     }
@@ -352,54 +342,46 @@ class PrismKoishiService {
         await this.client.resolveOrRegisterIdentity(this.identity(sender));
         return "注册成功";
     }
-    async loginForTarget(actor, targetSubject) {
+    async loginForTarget(actor, targetSubject, bot) {
         return this.withTarget(actor, targetSubject, async (sender, isTargeted) => {
             await this.client.startSessionByIdentity(this.identity(sender), this.loginSessionBody());
-            return isTargeted ? `✅ 已为用户 ${sender.id} 入场成功` : "✅ 入场成功";
-        });
+            return isTargeted ? `✅ 已为用户 ${formatPlayerReference(sender)} 入场成功` : "✅ 入场成功";
+        }, bot);
     }
     async login(sender) {
         await this.client.startSessionByIdentity(this.identity(sender), this.loginSessionBody());
         return "✅ 入场成功";
     }
-    async withTarget(actor, targetSubject, action) {
-        const target = this.targetSender(actor, targetSubject);
+    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) {
+    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 player = await this.resolvePlayer(sender);
-            const playerId = String(player.id ?? "");
-            if (!playerId)
-                return "找不到玩家";
             const isAddition = direction === 1;
-            await this.client.adjustStaffAssets(playerId, [{
+            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) {
+    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 player = await this.resolvePlayer(sender);
-            const playerId = String(player.id ?? "");
-            if (!playerId)
-                return "找不到玩家";
             const reason = cleanText(rawReason) || "Koishi 管理员手动调价";
-            await this.client.checkoutWithOverride(playerId, total, reason);
-            return `✅ 已为用户 ${sender.id} 覆盖结账为 ${formatNumber(total)} ${this.config.currencyName}`;
-        });
+            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);
@@ -414,6 +396,7 @@ class PrismKoishiService {
         const playerId = String(player.id ?? "");
         const activeResult = (await this.client.listActiveSessions());
         const activeSessions = (activeResult.sessions ?? []);
+        this.syncMahjongTableStates(activeSessions);
         if (!this.hasEntrySession(playerId, activeSessions)) {
             return "请先入场后再上桌。";
         }
@@ -457,6 +440,8 @@ class PrismKoishiService {
         const tableConfig = this.mahjongTableConfigs().get(tableId);
         const tableKey = tableConfig?.tableId ?? tableId;
         const tableSubject = tableConfig?.displayName || `${tableId} 桌`;
+        const activeResult = (await this.client.listActiveSessions());
+        this.syncMahjongTableStates((activeResult.sessions ?? []));
         const state = this.mahjongTables.get(tableKey);
         if (!state)
             return `你不在 ${tableSubject}。`;
@@ -585,6 +570,7 @@ class PrismKoishiService {
     async listActiveSessions(sender) {
         const result = (await this.client.listActiveSessions());
         const sessions = (result?.sessions ?? []);
+        this.syncMahjongTableStates(sessions);
         const tableByLabel = new Map(uniqueMahjongConfigs(this.mahjongTableConfigs()).map((table) => [
             mahjongSessionLabel(table, this.config.mahjongLabelPrefix ?? "麻将桌"),
             table,
@@ -668,41 +654,44 @@ class PrismKoishiService {
             || "未知玩家";
     }
     async buildPlayerGroups(players, tableByLabel) {
-        const groups = {
-            music: [],
-            mahjong: uniqueMahjongConfigs(this.mahjongTableConfigs()).map((table) => ({ table, players: [] })),
-        };
-        const groupForTable = new Map(groups.mahjong.map((group) => [group.table.tableId, group]));
+        const groups = { groups: [] };
+        const groupByLabel = new Map();
+        const musicLabel = this.config.loginSessionLabel?.trim() || "音游区间";
         for (const player of players.values()) {
             player.displayName = await this.displayNameForPlayer(player);
-            const table = player.sessions
-                .map((session) => tableByLabel.get(session.label ?? ""))
-                .find((value) => Boolean(value));
-            if (table) {
-                groupForTable.get(table.tableId)?.players.push(player);
-            }
-            else {
-                groups.music.push(player);
+            const nonMusic = player.sessions.filter((session) => Boolean(session.label) && session.label !== musicLabel);
+            const source = nonMusic.length > 0 ? nonMusic : player.sessions;
+            const selected = source.reduce((latest, session) => !latest || sessionStartedAt(session) > sessionStartedAt(latest) ? session : latest, undefined);
+            const label = selected?.label || musicLabel;
+            let group = groupByLabel.get(label);
+            if (!group) {
+                group = { label, table: tableByLabel.get(label), players: [] };
+                groupByLabel.set(label, group);
+                groups.groups.push(group);
             }
+            group.players.push(player);
         }
         return groups;
     }
     mergeWaitingSeats(groups) {
         for (const [tableId, state] of this.mahjongTables) {
-            const group = groups.mahjong.find((candidate) => candidate.table.tableId === tableId);
-            if (!group)
+            const table = this.mahjongTableConfigs().get(tableId);
+            if (!table)
                 continue;
+            const label = mahjongSessionLabel(table, this.config.mahjongLabelPrefix ?? "麻将桌");
+            let group = groups.groups.find((candidate) => candidate.label === label);
+            if (!group) {
+                group = { label, table, players: [] };
+                groups.groups.push(group);
+            }
             for (const seat of state.waiting) {
                 if (group.players.some((player) => player.playerId === seat.playerId))
                     continue;
-                const existing = [groups.music, ...groups.mahjong.map((candidate) => candidate.players)]
-                    .flat()
+                const existing = groups.groups.flatMap((candidate) => candidate.players)
                     .find((player) => player.playerId === seat.playerId);
-                groups.music = groups.music.filter((player) => player.playerId !== seat.playerId);
-                for (const candidate of groups.mahjong) {
-                    if (candidate !== group) {
+                for (const candidate of groups.groups) {
+                    if (candidate !== group)
                         candidate.players = candidate.players.filter((player) => player.playerId !== seat.playerId);
-                    }
                 }
                 group.players.push(existing ?? { playerId: seat.playerId, sessions: [], displayName: seat.displayName });
             }
@@ -729,6 +718,32 @@ class PrismKoishiService {
     mahjongTableConfigs() {
         return parseMahjongTables(this.config.mahjongTables ?? "", this.config.mahjongLabelPrefix ?? "麻将桌");
     }
+    syncMahjongTableStates(sessions) {
+        const tables = uniqueMahjongConfigs(this.mahjongTableConfigs());
+        const tableByLabel = new Map(tables.map((table) => [
+            mahjongSessionLabel(table, this.config.mahjongLabelPrefix ?? "麻将桌"),
+            table,
+        ]));
+        const activeByTable = new Map();
+        for (const session of sessions) {
+            const table = tableByLabel.get(session.label ?? "");
+            const playerId = String(session.playerId ?? "");
+            const sessionId = String(session.id ?? "");
+            if (!table || !playerId || !sessionId)
+                continue;
+            const active = activeByTable.get(table.tableId) ?? {};
+            active[playerId] = sessionId;
+            activeByTable.set(table.tableId, active);
+        }
+        for (const table of tables) {
+            const state = this.mahjongTables.get(table.tableId) ?? { waiting: [], activeSessions: {} };
+            state.activeSessions = activeByTable.get(table.tableId) ?? {};
+            state.waiting = state.waiting.filter((seat) => !state.activeSessions[seat.playerId]);
+            if (state.waiting.length > 0 || Object.keys(state.activeSessions).length > 0 || this.mahjongTables.has(table.tableId)) {
+                this.mahjongTables.set(table.tableId, state);
+            }
+        }
+    }
     async resolvePlayer(sender) {
         return (await this.client.resolveOrRegisterIdentity(this.identity(sender)));
     }
@@ -744,14 +759,20 @@ class PrismKoishiService {
             displayName: sender.name || `${this.config.provider.toUpperCase()} ${sender.id}`,
         };
     }
-    targetSender(actor, targetSubject) {
-        const subject = cleanText(targetSubject);
+    async targetSender(actor, targetSubject, bot) {
+        const subject = normalizeTargetSubject(targetSubject);
         if (!subject)
             return actor;
         const denied = this.targetStaffDenied(actor);
         if (denied)
             return denied;
-        return { id: subject, name: subject };
+        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 ?? [])
@@ -966,17 +987,21 @@ function groupSessionsByPlayer(sessions) {
     }
     return players;
 }
+function sessionStartedAt(session) {
+    const value = Date.parse(session.startedAt ?? "");
+    return Number.isFinite(value) ? value : 0;
+}
 function formatPlayerGroups(groups, tableSize, mahjongLabelPrefix) {
-    const populatedMahjongGroups = groups.mahjong.filter((group) => group.players.length > 0);
-    const total = groups.music.length + populatedMahjongGroups.reduce((sum, group) => sum + group.players.length, 0);
+    const populatedGroups = groups.groups.filter((group) => group.players.length > 0);
+    const total = new Set(populatedGroups.flatMap((group) => group.players.map((player) => player.playerId))).size;
     if (total === 0)
         return "🫥 窝里目前没有玩家呢";
     const lines = [`[总计 ${total} 人]`];
-    if (groups.music.length > 0) {
-        lines.push(`🎵 音乐游戏 ( ${groups.music.length}人 )：\n${formatPlayerNames(groups.music)}`);
-    }
-    for (const group of populatedMahjongGroups) {
-        lines.push(`${formatMahjongTableLabel(group.table, mahjongLabelPrefix)} ( ${group.players.length}/${tableSize} )：\n${formatPlayerNames(group.players)}`);
+    for (const group of populatedGroups) {
+        const heading = group.table
+            ? `${formatMahjongTableLabel(group.table, mahjongLabelPrefix)} ( ${group.players.length}/${tableSize} )`
+            : `${group.label} ( ${group.players.length}人 )`;
+        lines.push(`${heading}：\n${formatPlayerNames(group.players)}`);
     }
     return lines.join("\n");
 }
@@ -1012,6 +1037,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;

package/package.json

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