koishi-plugin-prism 0.1.7 → 0.1.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -6,12 +6,12 @@
6
6
 
7
7
  ## 🌟 功能特性
8
8
 
9
- * 🎮 **玩家入场与结算**:通过 `/login` 和 `/logout` 指令开启或结算计费场次,支持 `/入场` 别名。
9
+ * 🎮 **玩家入场与结算**:通过 `/login` 和 `/logout` 指令开启或结算计费场次,支持 `/入场` 别名;命令回复会引用触发消息,结账账单可私聊通知管理员与指定用户。
10
10
  * 💳 **账户钱包与资产管理**:支持查询钱包余额(`/wallet`)和持有的道具资产(`/items`)。
11
11
  * 🀄 **麻将桌位集成**:包含 `/mahjong <tableId>` 以及便捷的 `/上桌` / `/下桌` 控制。`上桌` 仅允许已通过 `login`/`入场` 开启默认入场会话的玩家使用。`list` 会按音乐游戏和麻将桌分组,并对同一玩家的多个计时会话去重;麻将桌显示当前人数和容量。未满桌候座由机器人进程暂存,机器人重启后不会保留。
12
12
  * 🔌 **硬件设备状态与电源管理**:可直接在聊天中查看设备状态(`/show`)、远程开启/关闭电源(`/on`、`/off`)、远程投币(`/coin`)和模拟刷卡(`/scan`)。
13
13
  * 🎟️ **礼物兑换码**:使用 `/redeem <code>` 兑换系统发放的福利礼包。
14
- * 🛠️ **管理员高级指令**:允许管理员在聊天中查看玩家(`/admin.players`)、创建新玩家账户(`/admin.create-player`)、充值余额(`/admin.grant-balance`)、手动结账(`/admin.checkout`)以及制作礼包兑换码(`/admin.redeem-code`)。
14
+ * 🛠️ **管理员快捷指令**:允许管理员为指定平台用户增加或扣除余额,并覆盖结账金额后立即结账。
15
15
 
16
16
  ## ⚙️ 配置说明
17
17
 
@@ -29,8 +29,12 @@
29
29
  | `defaultScanProvider` | `string` | `"aime"` | 默认模拟刷卡时的读卡器协议提供商(如 `"aime"`)。 |
30
30
  | `currencyName` | `string` | `"金币"` | 账户货币在显示时的自定义单位名称。 |
31
31
  | `resolveDisplayName` | `function` | - | 可选。自定义用于获取群内昵称作为玩家注册名的异步逻辑。 |
32
- | `enableStaffCommands` | `boolean` | `false` | 是否开启管理员/店员的高级控制指令。 |
33
- | `staffUserIds` | `string[]` | `[]` | 允许执行管理员指令的平台用户 ID(如 QQ 号)白名单。 |
32
+ | `enableStaffCommands` | `boolean` | `false` | 是否开启管理员快捷指令。 |
33
+ | `staffUserIds` | `string[]` | `[]` | 允许执行管理员快捷指令的平台用户 ID(如 QQ 号)白名单。空列表不授予目标用户操作权限。 |
34
+ | `staffSessionToken` | `string` | - | 管理员写操作所需的 Staff 管理 Token。 |
35
+ | `logoutNotifyUserIds` | `string[]` | `[]` | 结账成功后额外私聊完整账单的平台用户 ID。通知收件人为该列表与 `staffUserIds` 的去重并集。 |
36
+
37
+ 管理员快捷指令必须同时配置 `enableStaffCommands: true`、`staffUserIds` 和 `staffSessionToken`。目标用户参数使用 Koishi 的 `user` 选择器;只有白名单内的管理员可以操作其他用户。
34
38
 
35
39
  ## 📝 机器人指令列表
36
40
 
@@ -38,6 +42,8 @@
38
42
  * `register` - 绑定或注册当前平台账号到 PRiSM 账户。
39
43
  * `login` / `入场` - 开启当前玩家的计费场次。
40
44
  * `logout` - 结算当前玩家的计费场次。
45
+ 玩家在未产生任何费用时退场,机器人会简洁显示“本次未产生费用”和当前余额;存在收费或优惠明细时仍显示完整结算账单。
46
+ 结账成功后,机器人会向 `staffUserIds` 与 `logoutNotifyUserIds` 中的用户私聊同一份账单,账单会明确显示结账玩家身份。
41
47
  * `billing` - 预览当前玩家本场计费的消费费用。
42
48
  * `wallet` - 查看当前玩家的钱包余额。
43
49
  * `items` - 查看当前玩家持有的道具或资产。
@@ -53,12 +59,11 @@
53
59
  * `mahjong <tableId>` / `上桌 <tableId>` - 加入指定麻将桌;仅允许已通过 `login`/`入场` 开启默认入场会话的玩家使用。
54
60
  * `下桌 <tableId>` - 离开指定麻将桌。
55
61
 
56
- ### 管理员指令 (需在白名单内并开启)
57
- * `admin.players` - 列出系统内注册的所有玩家。
58
- * `admin.create-player <displayName>` - 创建一个新的 PRiSM 玩家。
59
- * `admin.grant-balance <playerId> <amount>` - 为指定玩家发放充值余额。
60
- * `admin.redeem-code <code> <presentId>` - 快速创建单次使用的兑换码。
61
- * `admin.checkout <playerId>` - 代替并强制为指定玩家结账。
62
+ ### 管理员快捷指令
63
+ 启用 `enableStaffCommands`、配置 `staffUserIds` 白名单与 `staffSessionToken` 后可使用:
64
+ * `add <target:user> <amount:number>` - 为目标用户增加余额。
65
+ * `del <target:user> <amount:number>` - 从目标用户扣除余额。
66
+ * `overwrite <target:user> <amount:number> [reason:text]` - 覆盖目标用户本次结账金额,并立即执行结账;未填写原因时使用默认管理员调价原因。
62
67
 
63
68
  ## 🛠️ 本地开发与构建
64
69
 
package/lib/index.d.ts CHANGED
@@ -24,6 +24,7 @@ export type PrismKoishiPluginConfig = {
24
24
  currencyName: string;
25
25
  enableStaffCommands?: boolean;
26
26
  staffUserIds?: string[];
27
+ logoutNotifyUserIds?: string[];
27
28
  mahjongTables?: string;
28
29
  mahjongTableSize?: number;
29
30
  mahjongLabelPrefix?: string;
@@ -56,6 +57,7 @@ export type KoishiLikeContext = {
56
57
  export type KoishiActionContext = {
57
58
  session: {
58
59
  userId: string;
60
+ messageId?: string;
59
61
  senderId?: string;
60
62
  senderName?: string;
61
63
  username?: string;
@@ -63,6 +65,7 @@ export type KoishiActionContext = {
63
65
  getUser?(id: string): Promise<{
64
66
  name?: string;
65
67
  }>;
68
+ broadcast?(userIds: string[], content: string): Promise<void>;
66
69
  };
67
70
  };
68
71
  };
package/lib/index.js CHANGED
@@ -20,6 +20,7 @@ exports.Config = koishi_1.Schema.object({
20
20
  loginSessionLabel: koishi_1.Schema.string().default("音游区间").description("默认入场场次标签 (防重复入场)"),
21
21
  enableStaffCommands: koishi_1.Schema.boolean().default(false).description("是否启用管理员指令"),
22
22
  staffUserIds: koishi_1.Schema.array(koishi_1.Schema.string()).default([]).description("允许执行管理员指令的平台用户ID列表"),
23
+ logoutNotifyUserIds: koishi_1.Schema.array(koishi_1.Schema.string()).default([]).description("结账账单私聊通知的平台用户ID列表"),
23
24
  powerOffInterval: koishi_1.Schema.number().default(0).description("无人自动关机等待秒数 (0为禁用)"),
24
25
  mahjongTables: koishi_1.Schema.string().description("麻将桌配置"),
25
26
  mahjongTableSize: koishi_1.Schema.number().default(4).description("麻将桌人数限制"),
@@ -52,47 +53,41 @@ const USAGE = {
52
53
  prism_redeem: "/prism redeem <兑换码>",
53
54
  list: "/list",
54
55
  show: "/show [设备ID]",
55
- staff_create_player: "/prism.admin.create-player <玩家昵称>",
56
- staff_grant_balance: "/prism.admin.grant-balance <玩家ID> <金额>",
57
- staff_redeem_code: "/prism.admin.redeem-code <兑换码> <礼物ID>",
58
- staff_checkout: "/prism.admin.checkout <玩家ID>",
59
56
  };
60
57
  function applyPrismKoishiPlugin(ctx, config) {
61
58
  const service = new PrismKoishiService(ctx, config);
62
59
  const wrap = (handler) => async (context, ...args) => {
63
60
  try {
64
- return await handler(context, ...args);
61
+ const message = await handler(context, ...args);
62
+ return context.session?.messageId ? `${(0, koishi_1.h)("quote", { id: context.session.messageId })}${message}` : message;
65
63
  }
66
64
  catch (error) {
67
- return service.handleCommandError(error);
65
+ const message = service.handleCommandError(error);
66
+ return context.session?.messageId ? `${(0, koishi_1.h)("quote", { id: context.session.messageId })}${message}` : message;
68
67
  }
69
68
  };
70
69
  ctx.command("register", "绑定或注册当前平台用户到 PRiSM").action(wrap(async (context) => service.register(await service.sender(context))));
71
- ctx.command("login", "开启当前玩家的计费场次").action(wrap(async (context) => service.login(await service.sender(context))));
72
- ctx.command("入场", "入场 (alias of login)").action(wrap(async (context) => service.login(await service.sender(context))));
70
+ ctx.command("login [target:user]", "开启玩家计费场次").action(wrap(async (context, target) => service.loginForTarget(await service.sender(context), target)));
71
+ ctx.command("入场 [target:user]", "入场").action(wrap(async (context, target) => service.loginForTarget(await service.sender(context), target)));
73
72
  ctx.command("mahjong <tableId>", "加入指定麻将桌").action(wrap(async (context, tableId) => service.mahjongJoin(await service.sender(context), tableId)));
74
73
  ctx.command("上桌 <tableId>", "加入指定麻将桌").action(wrap(async (context, tableId) => service.mahjongJoin(await service.sender(context), tableId)));
75
74
  ctx.command("下桌 <tableId>", "离开指定麻将桌").action(wrap(async (context, tableId) => service.mahjongLeave(await service.sender(context), tableId)));
76
- ctx.command("logout", "结算当前玩家的计费场次").action(wrap(async (context) => service.logout(await service.sender(context))));
77
- ctx.command("billing", "预览当前玩家的结账费用").action(wrap(async (context) => service.billing(await service.sender(context))));
78
- ctx.command("wallet", "查看当前玩家钱包余额").action(wrap(async (context) => service.wallet(await service.sender(context))));
79
- ctx.command("items", "查看当前玩家持有资产").action(wrap(async (context) => service.items(await service.sender(context))));
75
+ ctx.command("logout [target:user]", "结算玩家计费场次").action(wrap(async (context, target) => service.withTarget(await service.sender(context), target, (sender) => service.logout(sender, context.session?.bot))));
76
+ ctx.command("billing [target:user]", "预览玩家结账费用").action(wrap(async (context, target) => service.withTarget(await service.sender(context), target, (sender) => service.billing(sender))));
77
+ ctx.command("wallet [target:user]", "查看玩家钱包").action(wrap(async (context, target) => service.withTarget(await service.sender(context), target, (sender) => service.wallet(sender))));
78
+ ctx.command("items [target:user]", "查看玩家资产").action(wrap(async (context, target) => service.withTarget(await service.sender(context), target, (sender) => service.items(sender))));
80
79
  ctx.command("list", "查看当前在线玩家列表").action(wrap(async (context) => service.listActiveSessions(await service.sender(context))));
81
80
  ctx.command("show [deviceId]", "查看设备电源状态").action(wrap(async (context, deviceId) => service.listDeviceStates(deviceId)));
82
- ctx.command("history", "查看当前玩家历史场次").action(wrap(async (context) => service.history(await service.sender(context))));
81
+ ctx.command("history [target:user]", "查看玩家历史").action(wrap(async (context, target) => service.withTarget(await service.sender(context), target, (sender) => service.history(sender))));
83
82
  ctx.command("lock", "向默认门锁设备发送开门指令").action(wrap(async (context) => service.lock(await service.sender(context))));
84
83
  ctx.command("on <deviceId>", "请求启动指定设备电源").action(wrap(async (context, deviceId) => service.powerOn(await service.sender(context), deviceId)));
85
84
  ctx.command("off <deviceId>", "请求关闭指定设备电源").action(wrap(async (context, deviceId) => service.powerOff(await service.sender(context), deviceId)));
86
85
  ctx.command("coin <deviceId> [count]", "请求向指定设备投币").action(wrap(async (context, deviceId, count) => service.coin(await service.sender(context), deviceId, count)));
87
86
  ctx.command("scan <deviceId> <subject>", "请求指定设备模拟刷卡").action(wrap(async (context, deviceId, subject) => service.scan(await service.sender(context), deviceId, subject)));
88
87
  ctx.command("redeem <code>", "兑换 PRiSM 礼物码").action(wrap(async (context, code) => service.redeem(await service.sender(context), code)));
89
- if (config.enableStaffCommands) {
90
- ctx.command("admin.players", "列出 PRiSM 玩家").action(wrap(async (context) => service.staffPlayers(await service.sender(context))));
91
- ctx.command("admin.create-player <displayName>", "创建 PRiSM 玩家").action(wrap(async (context, displayName) => service.staffCreatePlayer(await service.sender(context), displayName)));
92
- ctx.command("admin.grant-balance <playerId> <amount>", "给指定玩家发放充值余额").action(wrap(async (context, playerId, amount) => service.staffGrantBalance(await service.sender(context), playerId, amount)));
93
- ctx.command("admin.redeem-code <code> <presentId>", "创建单次使用兑换码").action(wrap(async (context, code, presentId) => service.staffRedeemCode(await service.sender(context), code, presentId)));
94
- ctx.command("admin.checkout <playerId>", "替指定玩家结账").action(wrap(async (context, playerId) => service.staffCheckout(await service.sender(context), playerId)));
95
- }
88
+ ctx.command("add <target:user> <amount:number>", "增加玩家余额").action(wrap(async (context, target, amount) => service.adjustTargetBalance(await service.sender(context), target, amount, 1)));
89
+ ctx.command("del <target:user> <amount:number>", "扣除玩家余额").action(wrap(async (context, target, amount) => service.adjustTargetBalance(await service.sender(context), target, amount, -1)));
90
+ 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)));
96
91
  const intervalMs = (config.powerOffInterval ?? 0) * 1000;
97
92
  if (intervalMs > 0 && typeof ctx.setInterval === "function") {
98
93
  ctx.setInterval(() => {
@@ -278,35 +273,18 @@ class PrismApiClient {
278
273
  token: this.config.integrationToken,
279
274
  });
280
275
  }
281
- // Staff commands
282
- async listStaffPlayers() {
283
- return this.request("GET", "/rpc/staff/players", {
284
- token: this.requireStaffSessionToken(),
285
- });
286
- }
287
- async createStaffPlayer(displayName) {
288
- return this.request("POST", "/rpc/staff/players", {
289
- token: this.requireStaffSessionToken(),
290
- body: { displayName },
291
- });
292
- }
293
- async grantStaffAssets(playerId, assets) {
294
- return this.request("POST", "/rpc/staff/players/:playerId/adjustments/assets", {
276
+ async adjustStaffAssets(playerId, adjustments) {
277
+ return this.request("POST", "/rpc/staff/players/:playerId/assets/adjustments", {
295
278
  token: this.requireStaffSessionToken(),
296
279
  params: { playerId },
297
- body: { assets },
298
- });
299
- }
300
- async createStaffRedeemCode(input) {
301
- return this.request("POST", "/rpc/staff/redeem-codes", {
302
- token: this.requireStaffSessionToken(),
303
- body: input,
280
+ body: { adjustments },
304
281
  });
305
282
  }
306
- async staffCheckout(playerId) {
307
- return this.request("POST", "/rpc/staff/players/:playerId/settlements/checkout", {
283
+ async checkoutWithOverride(playerId, total, reason) {
284
+ return this.request("POST", "/rpc/staff/players/:playerId/checkout/override", {
308
285
  token: this.requireStaffSessionToken(),
309
286
  params: { playerId },
287
+ body: { total, reason },
310
288
  });
311
289
  }
312
290
  }
@@ -374,10 +352,55 @@ class PrismKoishiService {
374
352
  await this.client.resolveOrRegisterIdentity(this.identity(sender));
375
353
  return "注册成功";
376
354
  }
355
+ async loginForTarget(actor, targetSubject) {
356
+ return this.withTarget(actor, targetSubject, async (sender, isTargeted) => {
357
+ await this.client.startSessionByIdentity(this.identity(sender), this.loginSessionBody());
358
+ return isTargeted ? `✅ 已为用户 ${sender.id} 入场成功` : "✅ 入场成功";
359
+ });
360
+ }
377
361
  async login(sender) {
378
362
  await this.client.startSessionByIdentity(this.identity(sender), this.loginSessionBody());
379
363
  return "✅ 入场成功";
380
364
  }
365
+ async withTarget(actor, targetSubject, action) {
366
+ const target = this.targetSender(actor, targetSubject);
367
+ if (typeof target === "string")
368
+ return target;
369
+ return action(target, target !== actor);
370
+ }
371
+ async adjustTargetBalance(actor, targetSubject, rawAmount, direction) {
372
+ return this.withTarget(actor, targetSubject, async (sender) => {
373
+ const amount = Number(rawAmount);
374
+ if (!Number.isFinite(amount) || amount <= 0)
375
+ return "金额必须大于 0";
376
+ const player = await this.resolvePlayer(sender);
377
+ const playerId = String(player.id ?? "");
378
+ if (!playerId)
379
+ return "找不到玩家";
380
+ const isAddition = direction === 1;
381
+ await this.client.adjustStaffAssets(playerId, [{
382
+ assetType: "currency",
383
+ assetCode: "paid",
384
+ quantityDelta: amount * direction,
385
+ reason: isAddition ? "Koishi 管理员增加余额" : "Koishi 管理员扣除余额",
386
+ }]);
387
+ return `✅ 已为用户 ${sender.id}${isAddition ? "增加" : "扣除"} ${formatNumber(amount)} ${this.config.currencyName}`;
388
+ });
389
+ }
390
+ async overwriteTargetCheckout(actor, targetSubject, rawAmount, rawReason) {
391
+ return this.withTarget(actor, targetSubject, async (sender) => {
392
+ const total = Number(rawAmount);
393
+ if (!Number.isFinite(total) || total < 0)
394
+ return "金额必须为非负数";
395
+ const player = await this.resolvePlayer(sender);
396
+ const playerId = String(player.id ?? "");
397
+ if (!playerId)
398
+ return "找不到玩家";
399
+ const reason = cleanText(rawReason) || "Koishi 管理员手动调价";
400
+ await this.client.checkoutWithOverride(playerId, total, reason);
401
+ return `✅ 已为用户 ${sender.id} 覆盖结账为 ${formatNumber(total)} ${this.config.currencyName}`;
402
+ });
403
+ }
381
404
  async mahjongJoin(sender, rawTableId) {
382
405
  const tableId = cleanText(rawTableId);
383
406
  if (!tableId)
@@ -455,7 +478,7 @@ class PrismKoishiService {
455
478
  const result = (await this.client.previewCheckoutByIdentity(this.identity(sender)));
456
479
  return this.formatCheckoutPreview(result, sender);
457
480
  }
458
- async logout(sender) {
481
+ async logout(sender, bot) {
459
482
  const result = (await this.client.confirmCheckoutByIdentity(this.identity(sender)));
460
483
  const settlement = result?.playerSettlement ?? result?.settlement ?? {};
461
484
  const records = result?.settlements ?? [];
@@ -484,7 +507,12 @@ class PrismKoishiService {
484
507
  adjustments: result?.adjustments ?? [],
485
508
  assetHoldings: result?.assetHoldings ?? [],
486
509
  };
487
- return this.formatCheckoutPreview(synthetic, sender, "✅ 退场成功 · 结算账单");
510
+ const receipt = await this.formatCheckoutPreview(synthetic, sender, "✅ 退场成功 · 结算账单");
511
+ const recipients = [...new Set([...(this.config.staffUserIds ?? []), ...(this.config.logoutNotifyUserIds ?? [])])];
512
+ if (recipients.length > 0 && bot?.broadcast) {
513
+ await bot.broadcast(recipients, receipt);
514
+ }
515
+ return receipt;
488
516
  }
489
517
  async wallet(sender) {
490
518
  const result = (await this.client.getWalletByIdentity(this.identity(sender)));
@@ -583,87 +611,6 @@ class PrismKoishiService {
583
611
  .map((d) => `${d.label || d.deviceId}: ${d.state?.state ?? "unknown"}`)
584
612
  .join("\n");
585
613
  }
586
- async staffPlayers(sender) {
587
- const denied = this.staffDenied(sender);
588
- if (denied)
589
- return denied;
590
- const result = (await this.client.listStaffPlayers());
591
- const players = (result?.players ?? []);
592
- if (players.length === 0)
593
- return "🫥 窝里目前没有玩家呢";
594
- return [
595
- `👥 窝里目前共有 ${players.length} 人`,
596
- "",
597
- ...players.map((p) => {
598
- const lines = [`玩家: ${p?.displayName ?? p?.id ?? ""} (${p?.id ?? ""})`];
599
- if (p?.status)
600
- lines.push(`状态: ${p.status}`);
601
- if (p?.walletTotal != null)
602
- lines.push(`余额: ${p.walletTotal} ${this.config.currencyName}`);
603
- return lines.join("\n");
604
- }),
605
- ].join("\n");
606
- }
607
- async staffCreatePlayer(sender, rawDisplayName) {
608
- const displayName = cleanText(rawDisplayName);
609
- if (!displayName)
610
- return commandUsage("staff_create_player");
611
- const denied = this.staffDenied(sender);
612
- if (denied)
613
- return denied;
614
- const result = (await this.client.createStaffPlayer?.(displayName));
615
- const player = result?.player ?? {};
616
- return `创建成功\n玩家: ${player?.displayName ?? displayName}\nID: ${player?.id ?? ""}`;
617
- }
618
- async staffGrantBalance(sender, rawPlayerId, rawAmount) {
619
- const playerId = cleanText(rawPlayerId);
620
- const amount = cleanText(rawAmount);
621
- if (!playerId || !amount)
622
- return commandUsage("staff_grant_balance");
623
- const denied = this.staffDenied(sender);
624
- if (denied)
625
- return denied;
626
- await this.client.grantStaffAssets?.(playerId, [
627
- {
628
- assetType: "currency",
629
- assetCode: "paid",
630
- amount: Number(amount),
631
- mergeStrategy: "stack",
632
- activeAt: null,
633
- expiresAt: null,
634
- },
635
- ]);
636
- return `✅ 已为玩家 ${playerId} 发放 ${amount} ${this.config.currencyName}`;
637
- }
638
- async staffRedeemCode(sender, rawCode, rawPresentId) {
639
- const code = cleanText(rawCode);
640
- const presentId = cleanText(rawPresentId);
641
- if (!code || !presentId)
642
- return commandUsage("staff_redeem_code");
643
- const denied = this.staffDenied(sender);
644
- if (denied)
645
- return denied;
646
- const result = (await this.client.createStaffRedeemCode?.({
647
- code,
648
- presentId,
649
- activeAt: null,
650
- expiresAt: null,
651
- maxUseCount: 1,
652
- }));
653
- const redeemCode = result?.redeemCode?.code ?? code;
654
- return `成功生成 1 个兑换码:\n${redeemCode}`;
655
- }
656
- async staffCheckout(sender, rawPlayerId) {
657
- const playerId = cleanText(rawPlayerId);
658
- if (!playerId)
659
- return commandUsage("staff_checkout");
660
- const denied = this.staffDenied(sender);
661
- if (denied)
662
- return denied;
663
- const result = (await this.client.staffCheckout?.(playerId));
664
- const settlement = result?.settlement ?? {};
665
- return `\n✅ 已为用户 ${playerId} 退场\n消费: ${formatNumber(settlement?.total ?? 0)} ${this.config.currencyName}`;
666
- }
667
614
  async autoPowerOffLoop() {
668
615
  const interval = this.config.powerOffInterval ?? 0;
669
616
  if (interval <= 0)
@@ -797,6 +744,15 @@ class PrismKoishiService {
797
744
  displayName: sender.name || `${this.config.provider.toUpperCase()} ${sender.id}`,
798
745
  };
799
746
  }
747
+ targetSender(actor, targetSubject) {
748
+ const subject = cleanText(targetSubject);
749
+ if (!subject)
750
+ return actor;
751
+ const denied = this.targetStaffDenied(actor);
752
+ if (denied)
753
+ return denied;
754
+ return { id: subject, name: subject };
755
+ }
800
756
  loginSessionBody() {
801
757
  const pricingConfigIds = (this.config.loginPricingConfigIds ?? [])
802
758
  .map((id) => id.trim())
@@ -817,6 +773,14 @@ class PrismKoishiService {
817
773
  return "权限不足";
818
774
  return null;
819
775
  }
776
+ targetStaffDenied(sender) {
777
+ if (!this.config.enableStaffCommands)
778
+ return "员工命令未启用";
779
+ const allowed = this.config.staffUserIds ?? [];
780
+ if (!allowed.includes(sender.id))
781
+ return "权限不足";
782
+ return null;
783
+ }
820
784
  async formatCheckoutPreview(result, sender, title = "【结算账单】") {
821
785
  if (result?.billing && result?.session) {
822
786
  return formatLegacyBilling(result, this.config.currencyName);
@@ -849,6 +813,24 @@ class PrismKoishiService {
849
813
  const lines = [];
850
814
  lines.push(title);
851
815
  lines.push(await this.resolvePlayerDisplay(sender, playerId));
816
+ let balance = 0;
817
+ let hasBalance = false;
818
+ for (const holding of assetHoldings) {
819
+ const code = String(holding?.assetCode ?? "").toLowerCase();
820
+ if (code.includes("paid") || code.includes("free") || code.includes("currency")) {
821
+ balance += toNumber(holding?.quantity ?? 0);
822
+ hasBalance = true;
823
+ }
824
+ }
825
+ const hasNonZeroSessionTotal = sessionPreviews.some((session) => toNumber(session?.total ?? 0) !== 0);
826
+ const hasNonZeroAdjustment = hasAdjustmentEntries(adjustments, sessionPreviews);
827
+ if (!hasNonZeroSessionTotal && !hasNonZeroAdjustment) {
828
+ lines.push("");
829
+ lines.push("本次未产生费用");
830
+ if (hasBalance)
831
+ lines.push(`余额:${formatNumber(balance)}${currency}`);
832
+ return lines.join("\n");
833
+ }
852
834
  const validStarts = sessionPreviews.map((s) => parseDateTime(s?.startedAt)).filter(Boolean);
853
835
  const validEnds = sessionPreviews.map((s) => sessionDisplayEnd(s, previewedAt)).filter(Boolean);
854
836
  if (validStarts.length > 0) {
@@ -881,20 +863,9 @@ class PrismKoishiService {
881
863
  lines.push(` └ ${adjLabel}:${formatNumber(amount)}${currency}`);
882
864
  }
883
865
  }
884
- let balance = 0;
885
- let hasBalance = false;
886
- for (const holding of assetHoldings) {
887
- const code = String(holding?.assetCode ?? "").toLowerCase();
888
- if (code.includes("paid") || code.includes("free") || code.includes("currency")) {
889
- balance += toNumber(holding?.quantity ?? 0);
890
- hasBalance = true;
891
- }
892
- }
893
866
  lines.push("");
894
867
  lines.push(`计费总价:${formatNumber(subtotal)}${currency}`);
895
- const hasDiscount = adjustments.some((adj) => toNumber(firstDefined(adj ?? {}, "amount", "saved", 0)) !== 0)
896
- || sessionPreviews.some((sp) => (sp?.adjustments ?? []).some((adj) => toNumber(firstDefined(adj ?? {}, "amount", "saved", 0)) !== 0));
897
- if (hasDiscount)
868
+ if (hasNonZeroAdjustment)
898
869
  lines.push(`优惠后价格:${formatNumber(total)}${currency}`);
899
870
  if (hasBalance)
900
871
  lines.push(`扣款后余额:${formatNumber(balance)}${currency}`);
@@ -1059,6 +1030,9 @@ function toNumber(value) {
1059
1030
  return asFloat;
1060
1031
  return 0;
1061
1032
  }
1033
+ function hasAdjustmentEntries(adjustments, sessionPreviews) {
1034
+ 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));
1035
+ }
1062
1036
  function formatNumber(value) {
1063
1037
  if (typeof value === "boolean")
1064
1038
  return value ? "1" : "0";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "koishi-plugin-prism",
3
- "version": "0.1.7",
3
+ "version": "0.1.10",
4
4
  "description": "PRiSM Next 计费与设备管理系统的 Koishi 机器人集成插件",
5
5
  "main": "./lib/index.js",
6
6
  "exports": {