koishi-plugin-prism 0.1.2 → 0.1.4

package/{dist-types/src → lib}/index.d.ts

@@ -58,6 +58,12 @@ export type KoishiActionContext = {
         userId: string;
         senderId?: string;
         senderName?: string;
+        username?: string;
+        bot?: {
+            getUser?(id: string): Promise<{
+                name?: string;
+            }>;
+        };
     };
 };
 export declare function applyPrismKoishiPlugin(ctx: KoishiLikeContext, config: PrismKoishiPluginConfig): void;

package/{dist-types/src → lib}/index.js

@@ -64,31 +64,31 @@ function applyPrismKoishiPlugin(ctx, config) {
             return service.handleCommandError(error);
         }
     };
-    ctx.command("register", "绑定或注册当前平台用户到 PRiSM").action(wrap(async (context) => service.register(service.sender(context))));
-    ctx.command("login", "开启当前玩家的计费场次").action(async (context) => service.login(service.sender(context)));
-    ctx.command("入场", "入场 (alias of login)").action(wrap(async (context) => service.login(service.sender(context))));
-    ctx.command("mahjong <tableId>", "加入指定麻将桌").action(wrap(async (context, tableId) => service.mahjongJoin(service.sender(context), tableId)));
-    ctx.command("上桌 <tableId>", "加入指定麻将桌").action(wrap(async (context, tableId) => service.mahjongJoin(service.sender(context), tableId)));
-    ctx.command("下桌 <tableId>", "离开指定麻将桌").action(wrap(async (context, tableId) => service.mahjongLeave(service.sender(context), tableId)));
-    ctx.command("logout", "结算当前玩家的计费场次").action(wrap(async (context) => service.logout(service.sender(context))));
-    ctx.command("billing", "预览当前玩家的结账费用").action(wrap(async (context) => service.billing(service.sender(context))));
-    ctx.command("wallet", "查看当前玩家钱包余额").action(wrap(async (context) => service.wallet(service.sender(context))));
-    ctx.command("items", "查看当前玩家持有资产").action(wrap(async (context) => service.items(service.sender(context))));
-    ctx.command("list", "查看当前在线玩家列表").action(wrap(async (context) => service.listActiveSessions(service.sender(context))));
+    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("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("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(service.sender(context))));
-    ctx.command("lock", "向默认门锁设备发送开门指令").action(wrap(async (context) => service.lock(service.sender(context))));
-    ctx.command("on <deviceId>", "请求启动指定设备电源").action(wrap(async (context, deviceId) => service.powerOn(service.sender(context), deviceId)));
-    ctx.command("off <deviceId>", "请求关闭指定设备电源").action(wrap(async (context, deviceId) => service.powerOff(service.sender(context), deviceId)));
-    ctx.command("coin <deviceId> [count]", "请求向指定设备投币").action(wrap(async (context, deviceId, count) => service.coin(service.sender(context), deviceId, count)));
-    ctx.command("scan <deviceId> <subject>", "请求指定设备模拟刷卡").action(wrap(async (context, deviceId, subject) => service.scan(service.sender(context), deviceId, subject)));
-    ctx.command("redeem <code>", "兑换 PRiSM 礼物码").action(wrap(async (context, code) => service.redeem(service.sender(context), code)));
+    ctx.command("history", "查看当前玩家历史场次").action(wrap(async (context) => service.history(await service.sender(context))));
+    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(service.sender(context))));
-        ctx.command("admin.create-player <displayName>", "创建 PRiSM 玩家").action(wrap(async (context, displayName) => service.staffCreatePlayer(service.sender(context), displayName)));
-        ctx.command("admin.grant-balance <playerId> <amount>", "给指定玩家发放充值余额").action(wrap(async (context, playerId, amount) => service.staffGrantBalance(service.sender(context), playerId, amount)));
-        ctx.command("admin.redeem-code <code> <presentId>", "创建单次使用兑换码").action(wrap(async (context, code, presentId) => service.staffRedeemCode(service.sender(context), code, presentId)));
-        ctx.command("admin.checkout <playerId>", "替指定玩家结账").action(wrap(async (context, playerId) => service.staffCheckout(service.sender(context), playerId)));
+        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)));
     }
     const intervalMs = (config.powerOffInterval ?? 0) * 1000;
     if (intervalMs > 0 && typeof ctx.setInterval === "function") {
@@ -351,9 +351,20 @@ class PrismKoishiService {
             });
         }
     }
-    sender(context) {
+    async sender(context) {
         const id = context.session?.senderId || context.session?.userId || "";
-        const name = context.session?.senderName || id;
+        let name = id;
+        try {
+            if (context.session?.bot?.getUser) {
+                const user = await context.session.bot.getUser(id);
+                if (user?.name) {
+                    name = user.name;
+                }
+            }
+        }
+        catch {
+            name = context.session?.username || context.session?.senderName || id;
+        }
         return { id, name };
     }
     async register(sender) {

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "koishi-plugin-prism",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "PRiSM Next 计费与设备管理系统的 Koishi 机器人集成插件",
-  "main": "./dist-types/index.js",
+  "main": "./lib/index.js",
   "exports": {
-    ".": "./dist-types/index.js",
+    ".": "./lib/index.js",
     "./package.json": "./package.json"
   },
   "files": [
-    "dist-types",
+    "lib",
     "README.md"
   ],
   "koishi": {

package/dist-types/test/plugin.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist-types/test/plugin.test.js

@@ -1,302 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const bun_test_1 = require("bun:test");
-const src_1 = require("../src");
-function createMockKoishiContext(registered) {
-    return {
-        command(name, description) {
-            const command = { description, action: () => "" };
-            registered.set(name, command);
-            return {
-                action(handler) {
-                    command.action = handler;
-                    return this;
-                },
-            };
-        },
-        setInterval() { },
-    };
-}
-function createDefaultClient() {
-    const calls = [];
-    return {
-        calls,
-        async resolveOrRegisterIdentity(input) {
-            calls.push(["resolveOrRegisterIdentity", input]);
-            return { id: "player-1", displayName: "Neri", status: "active" };
-        },
-        async startSessionByIdentity(input, body) {
-            calls.push(["startSessionByIdentity", input, body]);
-            return {
-                session: {
-                    id: "session-1",
-                    playerId: "player-1",
-                    startedAt: "2026-06-07T10:00:00.000Z",
-                    status: "active",
-                },
-            };
-        },
-        async previewCheckoutByIdentity(input) {
-            calls.push(["previewCheckoutByIdentity", input]);
-            return {
-                settlementPreview: {
-                    playerId: "player-1",
-                    subtotal: 25,
-                    total: 22,
-                },
-                sessionPreviews: [
-                    {
-                        sessionId: "session-1",
-                        label: "音游区间",
-                        startedAt: "2026-06-07T18:00:00.000Z",
-                        endedAt: "2026-06-07T19:00:00.000Z",
-                        status: "closed",
-                        subtotal: 25,
-                        total: 22,
-                    },
-                ],
-                adjustments: [{ amount: -3 }],
-                assetHoldings: [{ assetCode: "paid", quantity: 100 }],
-            };
-        },
-        async confirmCheckoutByIdentity(input) {
-            calls.push(["confirmCheckoutByIdentity", input]);
-            return {
-                settlement: { playerId: "player-1", subtotal: 25, total: 22 },
-                settlements: [],
-                chargeItems: [],
-                adjustments: [],
-                assetHoldings: [{ assetCode: "paid", quantity: 78 }],
-            };
-        },
-        async stopSessionByIdentity(input, sessionId) {
-            calls.push(["stopSessionByIdentity", input, sessionId]);
-            return {};
-        },
-        async getWalletByIdentity(input) {
-            calls.push(["getWalletByIdentity", input]);
-            return {
-                total: { available: 100, all: 100 },
-                paid: { available: 60 },
-                free: { available: 40 },
-            };
-        },
-        async getAssetsByIdentity(input) {
-            calls.push(["getAssetsByIdentity", input]);
-            return { holdings: [{ assetName: "Monthly pass", quantity: 1, expireAt: null }] };
-        },
-        async getSessionHistoryByIdentity(input) {
-            calls.push(["getSessionHistoryByIdentity", input]);
-            return { sessions: [{ sessionId: "session-1", createdAt: "2026-06-07T18:00:00.000Z", closedAt: "2026-06-07T19:00:00.000Z", total: 25 }] };
-        },
-        async requestDeviceCommandByIdentity(input, command) {
-            calls.push(["requestDeviceCommandByIdentity", input, command]);
-            return { command: { id: "command-1" } };
-        },
-        async requestScanByIdentity(input, scan) {
-            calls.push(["requestScanByIdentity", input, scan]);
-            return { command: { id: "scan-1" } };
-        },
-        async redeemCodeByIdentity(input, code) {
-            calls.push(["redeemCodeByIdentity", input, code]);
-            return { holdings: [{ assetName: "Coupon", quantity: 1 }] };
-        },
-        async listStaffPlayers() {
-            calls.push(["listStaffPlayers"]);
-            return { players: [{ id: "player-1", displayName: "Neri", status: "active", walletTotal: 100 }] };
-        },
-        async listActiveSessions() {
-            calls.push(["listActiveSessions"]);
-            return {
-                sessions: [
-                    {
-                        id: "session-1",
-                        playerId: "player-1",
-                        playerDisplayName: "Player 296",
-                        startedAt: "2026-07-08T11:38:31.000Z",
-                        label: "音游区间",
-                        identities: [{ provider: "qq", subject: "2034994588" }],
-                    },
-                ],
-            };
-        },
-        async listDeviceStates() {
-            calls.push(["listDeviceStates"]);
-            return { deviceStates: [{ deviceId: "ai-1", label: "maimai", state: { state: "on" } }] };
-        },
-        async createStaffPlayer(displayName) {
-            calls.push(["createStaffPlayer", displayName]);
-            return { player: { id: "player-new", displayName } };
-        },
-        async grantStaffAssets(playerId, grants) {
-            calls.push(["grantStaffAssets", playerId, grants]);
-            return { holdings: [] };
-        },
-        async createStaffRedeemCode(input) {
-            calls.push(["createStaffRedeemCode", input]);
-            return { redeemCode: { id: "code-1", code: "PRISM-2026" } };
-        },
-        async staffCheckout(playerId) {
-            calls.push(["staffCheckout", playerId]);
-            return { settlement: { total: 25 } };
-        },
-    };
-}
-(0, bun_test_1.describe)("applyPrismKoishiPlugin", () => {
-    (0, bun_test_1.it)("registers all player commands and basic flows work", async () => {
-        const registered = new Map();
-        const ctx = createMockKoishiContext(registered);
-        const client = createDefaultClient();
-        const config = {
-            provider: "qq",
-            autoRegister: true,
-            loginPricingConfigIds: ["pricing-music-standard"],
-            loginSessionLabel: "音游区间",
-            defaultDoorDeviceId: "front-door",
-            defaultScanProvider: "aime",
-            currencyName: "猫粮",
-            client: client,
-        };
-        (0, src_1.applyPrismKoishiPlugin)(ctx, config);
-        const expected = [
-            "register",
-            "login",
-            "入场",
-            "mahjong <tableId>",
-            "上桌 <tableId>",
-            "下桌 <tableId>",
-            "logout",
-            "billing",
-            "wallet",
-            "items",
-            "list",
-            "show [deviceId]",
-            "history",
-            "lock",
-            "on <deviceId>",
-            "off <deviceId>",
-            "coin <deviceId> [count]",
-            "scan <deviceId> <subject>",
-            "redeem <code>",
-        ];
-        (0, bun_test_1.expect)([...registered.keys()]).toEqual(expected);
-        await (0, bun_test_1.expect)(registered.get("login")?.action({ session: { userId: "123456", senderName: "Tester" } })).resolves.toContain("✅ 入场成功");
-        await (0, bun_test_1.expect)(registered.get("wallet")?.action({ session: { userId: "123456" } })).resolves.toContain("100 猫粮");
-        const billingResult = await registered.get("billing")?.action({ session: { userId: "123456", senderName: "Tester" } });
-        (0, bun_test_1.expect)(billingResult).toContain("计费总价：25猫粮");
-        (0, bun_test_1.expect)(billingResult).toContain("玩家ID：player-1");
-        const listResult = await registered.get("list")?.action({ session: { userId: "123456" } });
-        (0, bun_test_1.expect)(listResult).toContain("窝里目前共有 1 人");
-        (0, bun_test_1.expect)(listResult).toContain("2034994588");
-    });
-    (0, bun_test_1.it)("uses platform display name when resolver is provided", async () => {
-        const registered = new Map();
-        const ctx = createMockKoishiContext(registered);
-        const client = createDefaultClient();
-        const config = {
-            provider: "qq",
-            autoRegister: true,
-            defaultDoorDeviceId: "front-door",
-            defaultScanProvider: "aime",
-            currencyName: "猫粮",
-            resolveDisplayName: () => Promise.resolve("🎀hanahana🎀"),
-            client: client,
-        };
-        (0, src_1.applyPrismKoishiPlugin)(ctx, config);
-        const listResult = await registered.get("list")?.action({ session: { userId: "123456" } });
-        (0, bun_test_1.expect)(listResult).toContain("🎀hanahana🎀");
-        (0, bun_test_1.expect)(listResult).toContain("2034994588");
-    });
-    (0, bun_test_1.it)("shows device states and power commands", async () => {
-        const registered = new Map();
-        const ctx = createMockKoishiContext(registered);
-        const client = createDefaultClient();
-        const config = {
-            provider: "qq",
-            autoRegister: true,
-            defaultDoorDeviceId: "front-door",
-            defaultScanProvider: "aime",
-            currencyName: "猫粮",
-            client: client,
-        };
-        (0, src_1.applyPrismKoishiPlugin)(ctx, config);
-        const list = await registered.get("show [deviceId]")?.action({ session: { userId: "123456" } });
-        (0, bun_test_1.expect)(list).toContain("maimai: on");
-        const res = await registered.get("show [deviceId]")?.action({ session: { userId: "123456" } }, "ai-1");
-        (0, bun_test_1.expect)(res).toContain("maimai: on");
-        const onResult = await registered.get("on <deviceId>")?.action({ session: { userId: "123456" } }, "ai-1");
-        (0, bun_test_1.expect)(onResult).toContain("ai-1 启动成功");
-        const coinResult = await registered.get("coin <deviceId> [count]")?.action({ session: { userId: "123456" } }, "ai-1", "2");
-        (0, bun_test_1.expect)(coinResult).toContain("2 个币");
-        const scanResult = await registered.get("scan <deviceId> <subject>")?.action({ session: { userId: "123456" } }, "aime-1", "card-4321");
-        (0, bun_test_1.expect)(scanResult).toContain("尾号为 4321");
-        const redeemResult = await registered.get("redeem <code>")?.action({ session: { userId: "123456" } }, "PRISM-2026");
-        (0, bun_test_1.expect)(redeemResult).toContain("兑换成功");
-    });
-    (0, bun_test_1.it)("registers and runs mahjong commands", async () => {
-        const registered = new Map();
-        const ctx = createMockKoishiContext(registered);
-        const client = createDefaultClient();
-        const config = {
-            provider: "qq",
-            autoRegister: true,
-            defaultDoorDeviceId: "front-door",
-            defaultScanProvider: "aime",
-            currencyName: "猫粮",
-            mahjongTables: "a,四麻A : 🀄️ M.LEAGUE联名比赛专用机 = pricing-mahjong-a",
-            mahjongTableSize: 4,
-            client: client,
-        };
-        (0, src_1.applyPrismKoishiPlugin)(ctx, config);
-        const joinResult = await registered.get("上桌 <tableId>")?.action({ session: { userId: "2034994588", senderName: "hanahana" } }, "a");
-        (0, bun_test_1.expect)(joinResult).toContain("已加入 🀄️ M.LEAGUE联名比赛专用机");
-        (0, bun_test_1.expect)(joinResult).toContain("1/4 人");
-        const leaveResult = await registered.get("下桌 <tableId>")?.action({ session: { userId: "2034994588", senderName: "hanahana" } }, "a");
-        (0, bun_test_1.expect)(leaveResult).toContain("已离开");
-    });
-    (0, bun_test_1.it)("registers and runs staff admin commands when enabled", async () => {
-        const registered = new Map();
-        const ctx = createMockKoishiContext(registered);
-        const client = createDefaultClient();
-        const config = {
-            provider: "qq",
-            autoRegister: true,
-            defaultDoorDeviceId: "front-door",
-            defaultScanProvider: "aime",
-            currencyName: "猫粮",
-            enableStaffCommands: true,
-            staffUserIds: [],
-            client: client,
-        };
-        (0, src_1.applyPrismKoishiPlugin)(ctx, config);
-        const adminNames = [...registered.keys()].filter((name) => name.startsWith("admin."));
-        (0, bun_test_1.expect)(adminNames).toEqual([
-            "admin.players",
-            "admin.create-player <displayName>",
-            "admin.grant-balance <playerId> <amount>",
-            "admin.redeem-code <code> <presentId>",
-            "admin.checkout <playerId>",
-        ]);
-        await (0, bun_test_1.expect)(registered.get("admin.players")?.action({ session: { userId: "admin" } })).resolves.toContain("Neri");
-        await (0, bun_test_1.expect)(registered.get("admin.create-player <displayName>")?.action({ session: { userId: "admin" } }, "Mika")).resolves.toContain("player-new");
-        await (0, bun_test_1.expect)(registered.get("admin.grant-balance <playerId> <amount>")?.action({ session: { userId: "admin" } }, "player-1", "100")).resolves.toContain("发放");
-        await (0, bun_test_1.expect)(registered.get("admin.redeem-code <code> <presentId>")?.action({ session: { userId: "admin" } }, "PRISM-2026", "present-1")).resolves.toContain("PRISM-2026");
-        await (0, bun_test_1.expect)(registered.get("admin.checkout <playerId>")?.action({ session: { userId: "admin" } }, "player-1")).resolves.toContain("25");
-    });
-    (0, bun_test_1.it)("denies staff commands when not enabled", async () => {
-        const registered = new Map();
-        const ctx = createMockKoishiContext(registered);
-        const client = createDefaultClient();
-        const config = {
-            provider: "qq",
-            autoRegister: true,
-            defaultDoorDeviceId: "front-door",
-            defaultScanProvider: "aime",
-            currencyName: "猫粮",
-            client: client,
-        };
-        (0, src_1.applyPrismKoishiPlugin)(ctx, config);
-        const adminNames = [...registered.keys()].filter((name) => name.startsWith("admin."));
-        (0, bun_test_1.expect)(adminNames).toEqual([]);
-    });
-});