@zhin.js/plugin-rps 1.0.3 → 1.0.5

package/commands/rps/[action:string=].js

@@ -0,0 +1,16 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineCommand } from '@zhin.js/command';
+import { messageFromCommandInput, normalizeRpsAction } from '@zhin.js/game-kit';
+import { RPS_HELP, runRpsCommand } from "../../lib/rps-command.js";
+import { resolveGameServices } from "../../lib/runtime-store.js";
+export default defineCommand({
+    description: 'RPS',
+    async execute({ params, input, use, owner }) {
+        const action = normalizeRpsAction(String(params.action ?? ''));
+        if (!action || action === 'help')
+            return RPS_HELP;
+        const services = resolveGameServices({ use, owner });
+        const message = messageFromCommandInput(input);
+        return runRpsCommand(services, message, action);
+    },
+});

package/commands/rps/[action:string=].ts

@@ -1,6 +1,6 @@
 import { defineCommand } from '@zhin.js/command';
 import { messageFromCommandInput, normalizeRpsAction } from '@zhin.js/game-kit';
-import { RPS_HELP, runRpsCommandText } from '../../src/rps-command.js';
+import { RPS_HELP, runRpsCommand } from '../../src/rps-command.js';
 import { resolveGameServices } from '../../src/runtime-store.js';
 
 export default defineCommand({
@@ -10,6 +10,6 @@ export default defineCommand({
     if (!action || action === 'help') return RPS_HELP;
     const services = resolveGameServices({ use, owner });
     const message = messageFromCommandInput(input);
-    return runRpsCommandText(services, message, action);
+    return runRpsCommand(services, message, action);
   },
 });

package/lib/game-flow.d.ts

@@ -1,13 +1,7 @@
-import type { Message, Plugin } from '@zhin.js/core';
-import type { RpsSessionRow } from './models.js';
-import { RPS_PREFIX, type RpsMove } from './engine.js';
+import type { GameMessageLike, GameReply } from '@zhin.js/game-kit';
+import { RPS_PREFIX } from './engine.js';
 import type { SessionService } from './session-service.js';
-export declare function sendOrEditView(plugin: Plugin | null, services: SessionService, message: Message<any>, session: RpsSessionRow, lastRound?: {
-    player: RpsMove;
-    bot: RpsMove;
-    result: 0 | 1 | 2;
-}): Promise<string | void>;
-export declare function startGame(plugin: Plugin | null, services: SessionService, message: Message<any>): Promise<string | undefined>;
-export declare function handleChoice(plugin: Plugin | null, services: SessionService, message: Message<any>, sessionId: string, choiceId: string): Promise<string | null>;
-export declare function continueGame(plugin: Plugin | null, services: SessionService, message: Message<any>): Promise<string>;
+export declare function startGame(services: SessionService, message: GameMessageLike): Promise<GameReply | undefined>;
+export declare function handleChoice(services: SessionService, message: GameMessageLike, sessionId: string, choiceId: string): Promise<GameReply | null>;
+export declare function continueGame(services: SessionService, message: GameMessageLike): Promise<GameReply>;
 export { RPS_PREFIX };

package/lib/game-flow.js

@@ -1,30 +1,14 @@
-import { plainTextFromSendContent, recordGameOutcome } from '@zhin.js/game-kit';
 import { RPS_PREFIX, WIN_TARGET, randomBotMove, resolveRound, } from './engine.js';
 import { buildRpsView } from './view.js';
-export async function sendOrEditView(plugin, services, message, session, lastRound) {
-    const content = buildRpsView(session, lastRound, message.$channel.type);
-    if (!plugin)
-        return plainTextFromSendContent(content);
-    const adapter = plugin.root.inject(message.$adapter);
-    if (session.board_message_id) {
-        const msgId = await adapter.editMessage({
-            messageId: session.board_message_id,
-            context: String(message.$adapter),
-            endpoint: message.$endpoint,
-            id: message.$channel.id,
-            type: message.$channel.type,
-            content,
-        });
-        if (msgId !== session.board_message_id) {
-            await services.updateSession(session.id, { board_message_id: msgId });
-        }
-        return;
-    }
-    const msgId = await message.$reply?.(content);
-    if (msgId)
-        await services.updateSession(session.id, { board_message_id: msgId });
+/**
+ * Plugin Runtime: render the board as text. Interactive in-place board editing
+ * (the old Adapter.editMessage path) is not part of the runtime flow; commands
+ * and the choice middleware return fresh text each turn.
+ */
+function renderView(session, message, lastRound) {
+    return buildRpsView(session, lastRound, message.$channel.type);
 }
-export async function startGame(plugin, services, message) {
+export async function startGame(services, message) {
     const ch = `${message.$adapter}-${message.$endpoint}-${message.$channel.type}:${message.$channel.id}`;
     const active = await services.getActiveByChannel(ch);
     if (active) {
@@ -34,10 +18,9 @@ export async function startGame(plugin, services, message) {
         return `本频道 ${active.player_name} 正在猜拳对决中。`;
     }
     const session = await services.createSession(message);
-    const text = await sendOrEditView(plugin, services, message, session);
-    return typeof text === 'string' ? text : undefined;
+    return renderView(session, message);
 }
-export async function handleChoice(plugin, services, message, sessionId, choiceId) {
+export async function handleChoice(services, message, sessionId, choiceId) {
     const session = await services.getById(sessionId);
     if (!session)
         return '对局不存在。';
@@ -48,8 +31,11 @@ export async function handleChoice(plugin, services, message, sessionId, choiceI
         return '这是别人的对局。';
     if (choiceId === 'restart') {
         await services.updateSession(session.id, { status: 'aborted' });
-        // text-only 模式（plugin===null）下 startGame 的唯一输出就是返回文本
-        return (await startGame(plugin, services, message)) ?? null;
+        return (await startGame(services, message)) ?? null;
+    }
+    if (choiceId === 'quit') {
+        await services.updateSession(session.id, { status: 'aborted' });
+        return renderView((await services.getById(session.id)), message);
     }
     const player = choiceId;
     if (!['rock', 'paper', 'scissors'].includes(player))
@@ -74,21 +60,13 @@ export async function handleChoice(plugin, services, message, sessionId, choiceI
         status,
     });
     const updated = (await services.getById(session.id));
-    if (status === 'won')
-        void recordGameOutcome(message, 'rps', 'won', playerWins * 10);
-    else if (status === 'lost')
-        void recordGameOutcome(message, 'rps', 'lost');
-    const text = await sendOrEditView(plugin, services, message, updated, { player, bot, result });
-    return typeof text === 'string' ? text : null;
+    return renderView(updated, message, { player, bot, result });
 }
-export async function continueGame(plugin, services, message) {
+export async function continueGame(services, message) {
     const session = await services.getActiveForUser(`${message.$adapter}-${message.$endpoint}-${message.$channel.type}:${message.$channel.id}`, message.$sender.id);
     if (!session)
         return '你没有进行中的猜拳，发送「猜拳 开始」。';
-    const text = await sendOrEditView(plugin, services, message, session);
-    if (typeof text === 'string')
-        return text;
-    return '已刷新猜拳界面。';
+    return renderView(session, message);
 }
 export { RPS_PREFIX };
 //# sourceMappingURL=game-flow.js.map

package/lib/game-flow.js.map

@@ -1 +1 @@
-{"version":3,"file":"game-flow.js","sourceRoot":"","sources":["../src/game-flow.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"game-flow.js","sourceRoot":"","sources":["../src/game-flow.ts"],"names":[],"mappings":"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"}

package/lib/index.d.ts

@@ -1,6 +1,5 @@
 export { RPS_HELP } from './rps-command.js';
 export { gameServicesToken, resolveGameServices } from './runtime-store.js';
-export { createInMemoryRpsDb, mountRpsMemoryServices } from './memory-db.js';
 /**
  * 已由 plugin.ts 接线：commands/ 命令、middlewares/ 文本与选项中间件、
  * 游戏大厅注册（registerRuntimeGame）、过期会话 cron（scheduleHostToken）、

package/lib/index.js

@@ -1,6 +1,5 @@
 export { RPS_HELP } from './rps-command.js';
 export { gameServicesToken, resolveGameServices } from './runtime-store.js';
-export { createInMemoryRpsDb, mountRpsMemoryServices } from './memory-db.js';
 /**
  * 已由 plugin.ts 接线：commands/ 命令、middlewares/ 文本与选项中间件、
  * 游戏大厅注册（registerRuntimeGame）、过期会话 cron（scheduleHostToken）、

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAE7E;;;;GAIG"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE5E;;;;GAIG"}

package/lib/models.d.ts

@@ -15,7 +15,6 @@ declare module '@zhin.js/core' {
             bot_wins: number;
             round: number;
             status: RpsSessionStatus;
-            board_message_id: string;
             updated_at: number;
             created_at: number;
         };

package/lib/models.js

@@ -12,7 +12,6 @@ export function defineHostTables(db) {
         bot_wins: { type: 'integer', default: 0 },
         round: { type: 'integer', default: 0 },
         status: { type: 'text', default: 'active' },
-        board_message_id: { type: 'text', default: '' },
         updated_at: { type: 'integer', default: 0 },
         created_at: { type: 'integer', default: 0 },
     });

package/lib/models.js.map

@@ -1 +1 @@
-{"version":3,"file":"models.js","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AA6BA,MAAM,UAAU,gBAAgB,CAC9B,EAA2E;IAE3E,EAAE,CAAC,MAAM,CAAC,cAAc,EAAE;QACxB,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE;QACnC,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE;QAC1C,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE;QAC3C,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE;QAC/C,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE;QAC7C,WAAW,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE;QAC9C,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE;QAC5C,WAAW,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;QAC1C,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;QAC5C,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;QACzC,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;QACtC,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE;QAC3C,gBAAgB,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;QAC/C,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;QAC3C,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;KAC5C,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AA4BA,MAAM,UAAU,gBAAgB,CAC9B,EAA2E;IAE3E,EAAE,CAAC,MAAM,CAAC,cAAc,EAAE;QACxB,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE;QACnC,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE;QAC1C,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE;QAC3C,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE;QAC/C,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE;QAC7C,WAAW,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE;QAC9C,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE;QAC5C,WAAW,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;QAC1C,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;QAC5C,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;QACzC,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;QACtC,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE;QAC3C,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;QAC3C,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;KAC5C,CAAC,CAAC;AACL,CAAC"}

package/lib/rps-command.d.ts

@@ -1,6 +1,4 @@
-import type { Message, Plugin } from '@zhin.js/core';
+import { type GameMessageLike, type GameReply } from '@zhin.js/game-kit';
 import type { SessionService } from './session-service.js';
 export declare const RPS_HELP: string;
-export declare function runRpsCommand(plugin: Plugin | null, services: SessionService, message: Message<any>, action: string): Promise<string | undefined>;
-/** Plugin Runtime / smoke: text-only, no Adapter.editMessage. */
-export declare function runRpsCommandText(services: SessionService, message: Message<any>, action: string): Promise<string>;
+export declare function runRpsCommand(services: SessionService, message: GameMessageLike, action: string): Promise<GameReply>;

package/lib/rps-command.js

@@ -1,5 +1,5 @@
-import { channelKey } from '@zhin.js/game-kit';
-import { continueGame, startGame } from './game-flow.js';
+import { channelKey, } from '@zhin.js/game-kit';
+import { continueGame, handleChoice, startGame } from './game-flow.js';
 export const RPS_HELP = [
     '✊✋✌️ 猜拳对决（三局两胜）',
     '猜拳 / rps — 帮助',
@@ -7,7 +7,7 @@ export const RPS_HELP = [
     '猜拳 继续 — 刷新界面',
     '猜拳 放弃 — 结束对局',
 ].join('\n');
-export async function runRpsCommand(plugin, services, message, action) {
+export async function runRpsCommand(services, message, action) {
     const ch = channelKey(message);
     const userId = message.$sender.id;
     if (!action || action === 'help') {
@@ -22,20 +22,15 @@ export async function runRpsCommand(plugin, services, message, action) {
         return lines.join('\n');
     }
     if (action === 'start')
-        return startGame(plugin, services, message);
+        return (await startGame(services, message)) ?? '';
     if (action === 'continue')
-        return continueGame(plugin, services, message);
+        return continueGame(services, message);
     if (action === 'quit') {
         const row = await services.getActiveForUser(ch, userId);
         if (!row)
             return '你没有进行中的猜拳。';
-        await services.updateSession(row.id, { status: 'aborted' });
-        return '已放弃猜拳对局。';
+        return (await handleChoice(services, message, row.id, 'quit')) ?? '';
     }
     return `未知子命令：${action}\n\n${RPS_HELP}`;
 }
-/** Plugin Runtime / smoke: text-only, no Adapter.editMessage. */
-export async function runRpsCommandText(services, message, action) {
-    return (await runRpsCommand(null, services, message, action)) ?? '';
-}
 //# sourceMappingURL=rps-command.js.map

package/lib/rps-command.js.map

@@ -1 +1 @@
-{"version":3,"file":"rps-command.js","sourceRoot":"","sources":["../src/rps-command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGzD,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,iBAAiB;IACjB,eAAe;IACf,aAAa;IACb,cAAc;IACd,cAAc;CACf,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAqB,EACrB,QAAwB,EACxB,OAAqB,EACrB,MAAc;IAEd,MAAM,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;IAElC,IAAI,CAAC,MAAM,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;QACrD,MAAM,KAAK,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC7B,IAAI,MAAM,EAAE,CAAC;YACX,KAAK,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,WAAW,MAAM,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACrF,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACpE,IAAI,MAAM,KAAK,UAAU;QAAE,OAAO,YAAY,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAE1E,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,gBAAgB,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACxD,IAAI,CAAC,GAAG;YAAE,OAAO,YAAY,CAAC;QAC9B,MAAM,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QAC5D,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,OAAO,SAAS,MAAM,OAAO,QAAQ,EAAE,CAAC;AAC1C,CAAC;AAED,iEAAiE;AACjE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,QAAwB,EACxB,OAAqB,EACrB,MAAc;IAEd,OAAO,CAAC,MAAM,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;AACtE,CAAC"}
+{"version":3,"file":"rps-command.js","sourceRoot":"","sources":["../src/rps-command.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,GAGX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGvE,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,iBAAiB;IACjB,eAAe;IACf,aAAa;IACb,cAAc;IACd,cAAc;CACf,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAwB,EACxB,OAAwB,EACxB,MAAc;IAEd,MAAM,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;IAElC,IAAI,CAAC,MAAM,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;QACrD,MAAM,KAAK,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC7B,IAAI,MAAM,EAAE,CAAC;YACX,KAAK,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,WAAW,MAAM,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACrF,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,CAAC,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1E,IAAI,MAAM,KAAK,UAAU;QAAE,OAAO,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAElE,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,gBAAgB,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACxD,IAAI,CAAC,GAAG;YAAE,OAAO,YAAY,CAAC;QAC9B,OAAO,CAAC,MAAM,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACvE,CAAC;IAED,OAAO,SAAS,MAAM,OAAO,QAAQ,EAAE,CAAC;AAC1C,CAAC"}

package/lib/session-service.d.ts

@@ -1,15 +1,9 @@
-import type { Database, Message, Models } from '@zhin.js/core';
+import type { Database, Models } from '@zhin.js/core';
+import { BaseSessionService, type GameMessageLike } from '@zhin.js/game-kit';
 import type { RpsSessionRow } from './models.js';
 export type RpsDatabase = Database<unknown, Models, string>;
-export declare class SessionService {
-    private readonly db;
+export declare class SessionService extends BaseSessionService<RpsSessionRow> {
     constructor(db: RpsDatabase);
-    getActiveByChannel(channel: string): Promise<RpsSessionRow | null>;
-    getActiveForUser(channel: string, userId: string): Promise<RpsSessionRow | null>;
-    getById(id: string): Promise<RpsSessionRow | null>;
-    getActiveByBoardMessageId(messageId: string): Promise<RpsSessionRow | null>;
-    createSession(message: Message<any>): Promise<RpsSessionRow>;
-    updateSession(id: string, patch: Partial<RpsSessionRow>): Promise<void>;
-    abortStale(idleMs: number): Promise<number>;
+    createSession(message: GameMessageLike): Promise<RpsSessionRow>;
 }
 export declare function createServices(db: RpsDatabase): SessionService;

package/lib/session-service.js

@@ -1,37 +1,25 @@
-import { channelKey, generateSessionId, boardMessageMatches } from '@zhin.js/game-kit';
-function getModel(db) {
-    const model = db.models.get('rps_sessions');
-    if (!model)
-        throw new Error('rps_sessions not registered');
-    return model;
-}
-export class SessionService {
-    db;
+import { BaseSessionService, channelKey, generateSessionId, } from '@zhin.js/game-kit';
+export class SessionService extends BaseSessionService {
     constructor(db) {
-        this.db = db;
-    }
-    async getActiveByChannel(channel) {
-        const rows = await getModel(this.db).findAll({ channel_key: channel, status: 'active' });
-        return rows[0] ?? null;
-    }
-    async getActiveForUser(channel, userId) {
-        const row = await this.getActiveByChannel(channel);
-        if (!row || row.player_id !== userId)
-            return null;
-        return row;
-    }
-    async getById(id) {
-        return getModel(this.db).findOne({ id });
-    }
-    async getActiveByBoardMessageId(messageId) {
-        if (!messageId)
-            return null;
-        const rows = await getModel(this.db).findAll({});
-        for (const row of rows) {
-            if (boardMessageMatches(row.board_message_id ?? '', messageId))
-                return row;
-        }
-        return null;
+        super(db, {
+            gameId: 'rps',
+            table: 'rps_sessions',
+            userFields: ['player_id'],
+            projectOutcomes: (session) => session.status === 'won'
+                ? [{
+                        userId: session.player_id,
+                        userName: session.player_name,
+                        result: 'won',
+                        score: session.player_wins * 10,
+                    }]
+                : session.status === 'lost'
+                    ? [{
+                            userId: session.player_id,
+                            userName: session.player_name,
+                            result: 'lost',
+                        }]
+                    : [],
+        });
     }
     async createSession(message) {
         const now = Date.now();
@@ -48,28 +36,10 @@ export class SessionService {
             bot_wins: 0,
             round: 0,
             status: 'active',
-            board_message_id: '',
             updated_at: now,
             created_at: now,
         };
-        await getModel(this.db).create(row);
-        return row;
-    }
-    async updateSession(id, patch) {
-        await getModel(this.db).updateWhere({ id }, { ...patch, updated_at: Date.now() });
-    }
-    async abortStale(idleMs) {
-        const cutoff = Date.now() - idleMs;
-        const model = getModel(this.db);
-        const rows = await model.findAll({ status: 'active' });
-        let n = 0;
-        for (const row of rows) {
-            if (row.updated_at < cutoff) {
-                await model.updateWhere({ id: row.id }, { status: 'aborted', updated_at: Date.now() });
-                n++;
-            }
-        }
-        return n;
+        return this.createRow(row);
     }
 }
 export function createServices(db) {

package/lib/session-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-service.js","sourceRoot":"","sources":["../src/session-service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-service.js","sourceRoot":"","sources":["../src/session-service.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kBAAkB,EAClB,UAAU,EACV,iBAAiB,GAGlB,MAAM,mBAAmB,CAAC;AAK3B,MAAM,OAAO,cAAe,SAAQ,kBAAiC;IACnE,YAAY,EAAe;QACzB,KAAK,CAAC,EAAmD,EAAE;YACzD,MAAM,EAAE,KAAK;YACb,KAAK,EAAE,cAAc;YACrB,UAAU,EAAE,CAAC,WAAW,CAAC;YACzB,eAAe,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,KAAK,KAAK;gBACpD,CAAC,CAAC,CAAC;wBACC,MAAM,EAAE,OAAO,CAAC,SAAS;wBACzB,QAAQ,EAAE,OAAO,CAAC,WAAW;wBAC7B,MAAM,EAAE,KAAK;wBACb,KAAK,EAAE,OAAO,CAAC,WAAW,GAAG,EAAE;qBAChC,CAAC;gBACJ,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,MAAM;oBACzB,CAAC,CAAC,CAAC;4BACC,MAAM,EAAE,OAAO,CAAC,SAAS;4BACzB,QAAQ,EAAE,OAAO,CAAC,WAAW;4BAC7B,MAAM,EAAE,MAAM;yBACf,CAAC;oBACJ,CAAC,CAAC,EAAE;SACT,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAAwB;QAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,GAAG,GAAkB;YACzB,EAAE,EAAE,iBAAiB,EAAE;YACvB,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC;YACjC,QAAQ,EAAE,OAAO,CAAC,SAAS;YAC3B,YAAY,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI;YACnC,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE;YAC/B,WAAW,EAAE,UAAU,CAAC,OAAO,CAAC;YAChC,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE;YAC7B,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE;YAC/D,WAAW,EAAE,CAAC;YACd,QAAQ,EAAE,CAAC;YACX,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,QAAQ;YAChB,UAAU,EAAE,GAAG;YACf,UAAU,EAAE,GAAG;SAChB,CAAC;QACF,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,UAAU,cAAc,CAAC,EAAe;IAC5C,OAAO,IAAI,cAAc,CAAC,EAAE,CAAC,CAAC;AAChC,CAAC"}

package/lib/view.js

@@ -22,6 +22,8 @@ export function buildRpsView(session, lastRound, channelType) {
             lines.push('🏆 **你赢得比赛！**');
         else if (session.status === 'lost')
             lines.push('💀 **机器人赢得比赛。**');
+        else
+            lines.push('🏳️ **本局已放弃。**');
     }
     else if (!lastRound) {
         lines.push('', '出拳吧！');
@@ -31,11 +33,14 @@ export function buildRpsView(session, lastRound, channelType) {
     }
     const choices = terminal
         ? [{ id: 'restart', label: '🔄 再来一局', style: 'primary', keepEnabledWhenTerminal: true }]
-        : ['rock', 'paper', 'scissors'].map((m) => ({
-            id: m,
-            label: MOVE_LABELS[m],
-            style: 'secondary',
-        }));
+        : [
+            ...['rock', 'paper', 'scissors'].map((m) => ({
+                id: m,
+                label: MOVE_LABELS[m],
+                style: 'secondary',
+            })),
+            { id: 'quit', label: '🏳️ 放弃', style: 'danger' },
+        ];
     return buildChoiceKeyboard({
         gamePrefix: RPS_PREFIX,
         sessionId: session.id,
@@ -43,7 +48,7 @@ export function buildRpsView(session, lastRound, channelType) {
         choices,
         terminal,
         buttonsPerRow: 3,
-        fallbackHint: '回复数字出拳（1石头 2布 3剪刀）',
+        fallbackHint: '回复数字：1石头 2布 3剪刀 4放弃',
         interactionProfile: terminal ? 'terminal' : 'gameplay',
         channelType,
     });

package/lib/view.js.map

@@ -1 +1 @@
-{"version":3,"file":"view.js","sourceRoot":"","sources":["../src/view.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGxD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAgB,MAAM,aAAa,CAAC;AAEhF,MAAM,UAAU,YAAY,CAC1B,OAAsB,EACtB,SAAgE,EAChE,WAAoB;IAEpB,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC;IAC7C,MAAM,KAAK,GAAG;QACZ,eAAe;QACf,EAAE;QACF,YAAY,OAAO,CAAC,WAAW,UAAU,OAAO,CAAC,QAAQ,YAAY,UAAU,KAAK;KACrF,CAAC;IAEF,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,MAAM,WAAW,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrF,KAAK,CAAC,IAAI,CACR,SAAS,CAAC,MAAM,KAAK,CAAC;YACpB,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;gBACtB,CAAC,CAAC,YAAY;gBACd,CAAC,CAAC,cAAc,CACrB,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;aACrD,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACpE,CAAC;SAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IACzB,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,OAAO,GAAG,QAAQ;QACtB,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAkB,EAAE,uBAAuB,EAAE,IAAI,EAAE,CAAC;QACjG,CAAC,CAAE,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,CAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACvD,EAAE,EAAE,CAAC;YACL,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC;YACrB,KAAK,EAAE,WAAoB;SAC5B,CAAC,CAAC,CAAC;IAER,OAAO,mBAAmB,CAAC;QACzB,UAAU,EAAE,UAAU;QACtB,SAAS,EAAE,OAAO,CAAC,EAAE;QACrB,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;QAC3B,OAAO;QACP,QAAQ;QACR,aAAa,EAAE,CAAC;QAChB,YAAY,EAAE,oBAAoB;QAClC,kBAAkB,EAAE,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU;QACtD,WAAW;KACZ,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"view.js","sourceRoot":"","sources":["../src/view.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGxD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAgB,MAAM,aAAa,CAAC;AAEhF,MAAM,UAAU,YAAY,CAC1B,OAAsB,EACtB,SAAgE,EAChE,WAAoB;IAEpB,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC;IAC7C,MAAM,KAAK,GAAG;QACZ,eAAe;QACf,EAAE;QACF,YAAY,OAAO,CAAC,WAAW,UAAU,OAAO,CAAC,QAAQ,YAAY,UAAU,KAAK;KACrF,CAAC;IAEF,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,MAAM,WAAW,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrF,KAAK,CAAC,IAAI,CACR,SAAS,CAAC,MAAM,KAAK,CAAC;YACpB,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;gBACtB,CAAC,CAAC,YAAY;gBACd,CAAC,CAAC,cAAc,CACrB,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;aACrD,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;;YAC7D,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACpC,CAAC;SAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IACzB,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,OAAO,GAAG,QAAQ;QACtB,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAkB,EAAE,uBAAuB,EAAE,IAAI,EAAE,CAAC;QACjG,CAAC,CAAC;YACE,GAAI,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,CAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC1D,EAAE,EAAE,CAAC;gBACL,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC;gBACrB,KAAK,EAAE,WAAoB;aAC5B,CAAC,CAAC;YACH,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAiB,EAAE;SAC1D,CAAC;IAEN,OAAO,mBAAmB,CAAC;QACzB,UAAU,EAAE,UAAU;QACtB,SAAS,EAAE,OAAO,CAAC,EAAE;QACrB,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;QAC3B,OAAO;QACP,QAAQ;QACR,aAAa,EAAE,CAAC;QAChB,YAAY,EAAE,qBAAqB;QACnC,kBAAkB,EAAE,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU;QACtD,WAAW;KACZ,CAAC,CAAC;AACL,CAAC"}

package/middlewares/rps-alias.js

@@ -0,0 +1,18 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineGameCommandAliasMiddleware, isRpsAction, messageFromCommandInput, normalizeRpsAction, } from '@zhin.js/game-kit';
+import { RPS_HELP, runRpsCommand } from "../lib/rps-command.js";
+import { resolveGameServices } from "../lib/runtime-store.js";
+export default defineGameCommandAliasMiddleware({
+    aliases: ['猜拳', 'rps'],
+    async run(action, input, context) {
+        const normalized = normalizeRpsAction(String(action ?? ''));
+        if (normalized === 'help')
+            return RPS_HELP;
+        // action 无法识别：放行给后续中间件，避免劫持普通聊天
+        if (!isRpsAction(normalized))
+            return null;
+        const services = resolveGameServices(context);
+        const message = messageFromCommandInput(input);
+        return runRpsCommand(services, message, normalized);
+    },
+});

package/middlewares/rps-alias.ts

@@ -1,18 +1,21 @@
 import {
   defineGameCommandAliasMiddleware,
+  isRpsAction,
   messageFromCommandInput,
   normalizeRpsAction,
 } from '@zhin.js/game-kit';
-import { RPS_HELP, runRpsCommandText } from '../src/rps-command.js';
+import { RPS_HELP, runRpsCommand } from '../src/rps-command.js';
 import { resolveGameServices } from '../src/runtime-store.js';
 
 export default defineGameCommandAliasMiddleware({
   aliases: ['猜拳', 'rps'],
   async run(action, input, context) {
     const normalized = normalizeRpsAction(String(action ?? ''));
-    if (!normalized || normalized === 'help') return RPS_HELP;
+    if (normalized === 'help') return RPS_HELP;
+    // action 无法识别：放行给后续中间件，避免劫持普通聊天
+    if (!isRpsAction(normalized)) return null;
     const services = resolveGameServices(context);
     const message = messageFromCommandInput(input);
-    return runRpsCommandText(services, message, normalized);
+    return runRpsCommand(services, message, normalized);
   },
 });

package/middlewares/rps-choice.js

@@ -0,0 +1,58 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineMiddleware } from '@zhin.js/middleware';
+import { buildChoiceFallbackMap, channelKey, messageFromCommandInput, parseChoicePayload, resolveGameTextPayload, } from '@zhin.js/game-kit';
+import { resolveGameServices } from "../lib/runtime-store.js";
+import { handleChoice, RPS_PREFIX } from "../lib/game-flow.js";
+/**
+ * 文本入口：按钮 payload（`rps:session:rock|paper|scissors|restart`）与数字 fallback
+ * （『1石头 2布 3剪刀』，对应 view 的 fallbackHint）。
+ */
+export default defineMiddleware({
+    target: 'inbound',
+    async handle(context, next) {
+        const raw = context.input.content?.trim() ?? '';
+        if (!raw) {
+            await next();
+            return;
+        }
+        const services = resolveGameServices(context);
+        const message = messageFromCommandInput(context.input);
+        const ch = channelKey(message);
+        // 直接 payload（QQ 指令预填 / Sandbox action→text）
+        const payloadFromText = resolveGameTextPayload(raw);
+        if (payloadFromText?.startsWith(`${RPS_PREFIX}:`)) {
+            const parsed = parseChoicePayload(payloadFromText, RPS_PREFIX);
+            if (parsed) {
+                const session = await services.getById(parsed.sessionId);
+                if (session?.channel_key === ch) {
+                    const reply = await handleChoice(services, message, parsed.sessionId, parsed.choiceId);
+                    if (reply)
+                        await context.input.$reply(reply);
+                    return;
+                }
+            }
+            await next();
+            return;
+        }
+        const session = await services.getActiveForUser(ch, message.$sender.id);
+        if (!session || session.status !== 'active') {
+            await next();
+            return;
+        }
+        const map = buildChoiceFallbackMap(RPS_PREFIX, session.id, [
+            { id: 'rock', label: '石头' },
+            { id: 'paper', label: '布' },
+            { id: 'scissors', label: '剪刀' },
+            { id: 'quit', label: '放弃' },
+        ]);
+        const payload = resolveGameTextPayload(raw, map);
+        const parsed = payload ? parseChoicePayload(payload, RPS_PREFIX) : null;
+        if (!parsed || parsed.sessionId !== session.id) {
+            await next();
+            return;
+        }
+        const reply = await handleChoice(services, message, session.id, parsed.choiceId);
+        if (reply)
+            await context.input.$reply(reply);
+    },
+});

package/middlewares/rps-choice.ts

@@ -33,7 +33,7 @@ export default defineMiddleware<Message>({
       if (parsed) {
         const session = await services.getById(parsed.sessionId);
         if (session?.channel_key === ch) {
-          const reply = await handleChoice(null, services, message, parsed.sessionId, parsed.choiceId);
+          const reply = await handleChoice(services, message, parsed.sessionId, parsed.choiceId);
           if (reply) await context.input.$reply(reply);
           return;
         }
@@ -52,6 +52,7 @@ export default defineMiddleware<Message>({
       { id: 'rock', label: '石头' },
       { id: 'paper', label: '布' },
       { id: 'scissors', label: '剪刀' },
+      { id: 'quit', label: '放弃' },
     ]);
     const payload = resolveGameTextPayload(raw, map);
     const parsed = payload ? parseChoicePayload(payload, RPS_PREFIX) : null;
@@ -60,7 +61,7 @@ export default defineMiddleware<Message>({
       return;
     }
 
-    const reply = await handleChoice(null, services, message, session.id, parsed.choiceId);
+    const reply = await handleChoice(services, message, session.id, parsed.choiceId);
     if (reply) await context.input.$reply(reply);
   },
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/plugin-rps",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Zhin.js 猜拳游戏 — 石头剪刀布三局两胜 (Plugin Runtime)",
   "type": "module",
   "main": "./lib/index.js",
@@ -14,7 +14,7 @@
     "./package.json": "./package.json"
   },
   "files": [
-    "plugin.ts",
+    "plugin.js",
     "schema.json",
     "commands",
     "middlewares",
@@ -24,11 +24,11 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@zhin.js/command": "1.0.2",
-    "@zhin.js/core": "1.4.0",
-    "@zhin.js/game-kit": "2.0.0",
-    "@zhin.js/middleware": "1.0.2",
-    "@zhin.js/plugin-runtime": "1.1.0"
+    "@zhin.js/command": "1.0.4",
+    "@zhin.js/core": "1.4.2",
+    "@zhin.js/game-kit": "2.0.2",
+    "@zhin.js/middleware": "1.0.4",
+    "@zhin.js/plugin-runtime": "1.1.1"
   },
   "devDependencies": {
     "typescript": "^6.0.3",
@@ -49,7 +49,7 @@
   "zhin": {
     "protocol": 1,
     "type": "plugin",
-    "entry": "./plugin.ts",
+    "entry": "./plugin.js",
     "engine": "^1.0.0",
     "runtime": "trusted",
     "features": [

package/plugin.js

@@ -0,0 +1,36 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineGamePlugin } from '@zhin.js/game-kit';
+import { defineHostTables } from "./lib/models.js";
+import { gameServicesToken } from "./lib/runtime-store.js";
+import { createServices, } from "./lib/session-service.js";
+/**
+ * Plugin Runtime:
+ * - Commands under `commands/` are authoritative (help + start/continue/quit via in-memory DB).
+ * - DB: prefer databaseHostToken; else in-memory SessionService.
+ * - Choice middleware under `middlewares/` handles RPS choice payloads (Sandbox action→text).
+ */
+export default defineGamePlugin({
+    name: 'rps',
+    metadata: {
+        displayName: 'RPS',
+    },
+    game: {
+        id: 'rps',
+        title: '猜拳对决',
+        icon: '✊',
+        description: '石头剪刀布，三局两胜',
+        commandPrefix: '/猜拳',
+        quickStart: '开始',
+        aliases: ['rps'],
+        menus: [
+            { id: 'start', label: '🎮 开始对局' },
+            { id: 'continue', label: '🔄 继续' },
+            { id: 'help', label: '📖 玩法说明' },
+        ],
+    },
+    tables: ['rps_sessions'],
+    servicesToken: gameServicesToken,
+    defineHostTables,
+    createServices: (database) => createServices(database),
+    session: (services) => services,
+});

package/src/game-flow.ts

@@ -1,5 +1,4 @@
-import type { Adapter, Message, Plugin } from '@zhin.js/core';
-import { plainTextFromSendContent, recordGameOutcome } from '@zhin.js/game-kit';
+import type { GameMessageLike, GameReply } from '@zhin.js/game-kit';
 import type { RpsSessionRow } from './models.js';
 import {
   RPS_PREFIX,
@@ -11,42 +10,23 @@ import {
 import type { SessionService } from './session-service.js';
 import { buildRpsView } from './view.js';
 
-export async function sendOrEditView(
-  plugin: Plugin | null,
-  services: SessionService,
-  message: Message<any>,
+/**
+ * Plugin Runtime: render the board as text. Interactive in-place board editing
+ * (the old Adapter.editMessage path) is not part of the runtime flow; commands
+ * and the choice middleware return fresh text each turn.
+ */
+function renderView(
   session: RpsSessionRow,
+  message: GameMessageLike,
   lastRound?: { player: RpsMove; bot: RpsMove; result: 0 | 1 | 2 },
-): Promise<string | void> {
-  const content = buildRpsView(session, lastRound, message.$channel.type);
-  if (!plugin) return plainTextFromSendContent(content);
-
-  const adapter = plugin.root.inject(message.$adapter) as Adapter;
-
-  if (session.board_message_id) {
-    const msgId = await adapter.editMessage({
-      messageId: session.board_message_id,
-      context: String(message.$adapter),
-      endpoint: message.$endpoint,
-      id: message.$channel.id,
-      type: message.$channel.type,
-      content,
-    });
-    if (msgId !== session.board_message_id) {
-      await services.updateSession(session.id, { board_message_id: msgId });
-    }
-    return;
-  }
-
-  const msgId = await message.$reply?.(content);
-  if (msgId) await services.updateSession(session.id, { board_message_id: msgId });
+): GameReply {
+  return buildRpsView(session, lastRound, message.$channel.type);
 }
 
 export async function startGame(
-  plugin: Plugin | null,
   services: SessionService,
-  message: Message<any>,
-): Promise<string | undefined> {
+  message: GameMessageLike,
+): Promise<GameReply | undefined> {
   const ch = `${message.$adapter}-${message.$endpoint}-${message.$channel.type}:${message.$channel.id}`;
   const active = await services.getActiveByChannel(ch);
   if (active) {
@@ -56,17 +36,15 @@ export async function startGame(
     return `本频道 ${active.player_name} 正在猜拳对决中。`;
   }
   const session = await services.createSession(message);
-  const text = await sendOrEditView(plugin, services, message, session);
-  return typeof text === 'string' ? text : undefined;
+  return renderView(session, message);
 }
 
 export async function handleChoice(
-  plugin: Plugin | null,
   services: SessionService,
-  message: Message<any>,
+  message: GameMessageLike,
   sessionId: string,
   choiceId: string,
-): Promise<string | null> {
+): Promise<GameReply | null> {
   const session = await services.getById(sessionId);
   if (!session) return '对局不存在。';
   if (session.status !== 'active' && choiceId !== 'restart') {
@@ -76,8 +54,11 @@ export async function handleChoice(
 
   if (choiceId === 'restart') {
     await services.updateSession(session.id, { status: 'aborted' });
-    // text-only 模式（plugin===null）下 startGame 的唯一输出就是返回文本
-    return (await startGame(plugin, services, message)) ?? null;
+    return (await startGame(services, message)) ?? null;
+  }
+  if (choiceId === 'quit') {
+    await services.updateSession(session.id, { status: 'aborted' });
+    return renderView((await services.getById(session.id))!, message);
   }
 
   const player = choiceId as RpsMove;
@@ -102,25 +83,19 @@ export async function handleChoice(
   });
 
   const updated = (await services.getById(session.id))!;
-  if (status === 'won') void recordGameOutcome(message, 'rps', 'won', playerWins * 10);
-  else if (status === 'lost') void recordGameOutcome(message, 'rps', 'lost');
-  const text = await sendOrEditView(plugin, services, message, updated, { player, bot, result });
-  return typeof text === 'string' ? text : null;
+  return renderView(updated, message, { player, bot, result });
 }
 
 export async function continueGame(
-  plugin: Plugin | null,
   services: SessionService,
-  message: Message<any>,
-): Promise<string> {
+  message: GameMessageLike,
+): Promise<GameReply> {
   const session = await services.getActiveForUser(
     `${message.$adapter}-${message.$endpoint}-${message.$channel.type}:${message.$channel.id}`,
     message.$sender.id,
   );
   if (!session) return '你没有进行中的猜拳，发送「猜拳 开始」。';
-  const text = await sendOrEditView(plugin, services, message, session);
-  if (typeof text === 'string') return text;
-  return '已刷新猜拳界面。';
+  return renderView(session, message);
 }
 
 export { RPS_PREFIX };

package/src/index.ts

@@ -1,6 +1,5 @@
 export { RPS_HELP } from './rps-command.js';
 export { gameServicesToken, resolveGameServices } from './runtime-store.js';
-export { createInMemoryRpsDb, mountRpsMemoryServices } from './memory-db.js';
 
 /**
  * 已由 plugin.ts 接线：commands/ 命令、middlewares/ 文本与选项中间件、

package/src/models.ts

@@ -17,7 +17,6 @@ declare module '@zhin.js/core' {
       bot_wins: number;
       round: number;
       status: RpsSessionStatus;
-      board_message_id: string;
       updated_at: number;
       created_at: number;
     };
@@ -43,7 +42,6 @@ export function defineHostTables(
     bot_wins: { type: 'integer', default: 0 },
     round: { type: 'integer', default: 0 },
     status: { type: 'text', default: 'active' },
-    board_message_id: { type: 'text', default: '' },
     updated_at: { type: 'integer', default: 0 },
     created_at: { type: 'integer', default: 0 },
   });

package/src/rps-command.ts

@@ -1,6 +1,9 @@
-import type { Message, Plugin } from '@zhin.js/core';
-import { channelKey } from '@zhin.js/game-kit';
-import { continueGame, startGame } from './game-flow.js';
+import {
+  channelKey,
+  type GameMessageLike,
+  type GameReply,
+} from '@zhin.js/game-kit';
+import { continueGame, handleChoice, startGame } from './game-flow.js';
 import type { SessionService } from './session-service.js';
 
 export const RPS_HELP = [
@@ -12,11 +15,10 @@ export const RPS_HELP = [
 ].join('\n');
 
 export async function runRpsCommand(
-  plugin: Plugin | null,
   services: SessionService,
-  message: Message<any>,
+  message: GameMessageLike,
   action: string,
-): Promise<string | undefined> {
+): Promise<GameReply> {
   const ch = channelKey(message);
   const userId = message.$sender.id;
 
@@ -31,24 +33,14 @@ export async function runRpsCommand(
     return lines.join('\n');
   }
 
-  if (action === 'start') return startGame(plugin, services, message);
-  if (action === 'continue') return continueGame(plugin, services, message);
+  if (action === 'start') return (await startGame(services, message)) ?? '';
+  if (action === 'continue') return continueGame(services, message);
 
   if (action === 'quit') {
     const row = await services.getActiveForUser(ch, userId);
     if (!row) return '你没有进行中的猜拳。';
-    await services.updateSession(row.id, { status: 'aborted' });
-    return '已放弃猜拳对局。';
+    return (await handleChoice(services, message, row.id, 'quit')) ?? '';
   }
 
   return `未知子命令：${action}\n\n${RPS_HELP}`;
 }
-
-/** Plugin Runtime / smoke: text-only, no Adapter.editMessage. */
-export async function runRpsCommandText(
-  services: SessionService,
-  message: Message<any>,
-  action: string,
-): Promise<string> {
-  return (await runRpsCommand(null, services, message, action)) ?? '';
-}

package/src/session-service.ts

@@ -1,43 +1,39 @@
-import type { Database, Message, Models, RelatedModel } from '@zhin.js/core';
-import { channelKey, generateSessionId, boardMessageMatches } from '@zhin.js/game-kit';
+import type { Database, Models } from '@zhin.js/core';
+import {
+  BaseSessionService,
+  channelKey,
+  generateSessionId,
+  type GameMessageLike,
+  type GameSessionDatabase,
+} from '@zhin.js/game-kit';
 import type { RpsSessionRow } from './models.js';
 
 export type RpsDatabase = Database<unknown, Models, string>;
 
-function getModel(db: RpsDatabase) {
-  const model = db.models.get('rps_sessions');
-  if (!model) throw new Error('rps_sessions not registered');
-  return model as RelatedModel<unknown, Models, 'rps_sessions'>;
-}
-
-export class SessionService {
-  constructor(private readonly db: RpsDatabase) {}
-
-  async getActiveByChannel(channel: string): Promise<RpsSessionRow | null> {
-    const rows = await getModel(this.db).findAll({ channel_key: channel, status: 'active' });
-    return rows[0] ?? null;
-  }
-
-  async getActiveForUser(channel: string, userId: string): Promise<RpsSessionRow | null> {
-    const row = await this.getActiveByChannel(channel);
-    if (!row || row.player_id !== userId) return null;
-    return row;
-  }
-
-  async getById(id: string): Promise<RpsSessionRow | null> {
-    return getModel(this.db).findOne({ id });
+export class SessionService extends BaseSessionService<RpsSessionRow> {
+  constructor(db: RpsDatabase) {
+    super(db as unknown as GameSessionDatabase<RpsSessionRow>, {
+      gameId: 'rps',
+      table: 'rps_sessions',
+      userFields: ['player_id'],
+      projectOutcomes: (session) => session.status === 'won'
+        ? [{
+            userId: session.player_id,
+            userName: session.player_name,
+            result: 'won',
+            score: session.player_wins * 10,
+          }]
+        : session.status === 'lost'
+          ? [{
+              userId: session.player_id,
+              userName: session.player_name,
+              result: 'lost',
+            }]
+          : [],
+    });
   }
 
-  async getActiveByBoardMessageId(messageId: string): Promise<RpsSessionRow | null> {
-    if (!messageId) return null;
-    const rows = await getModel(this.db).findAll({});
-    for (const row of rows) {
-      if (boardMessageMatches(row.board_message_id ?? '', messageId)) return row;
-    }
-    return null;
-  }
-
-  async createSession(message: Message<any>): Promise<RpsSessionRow> {
+  async createSession(message: GameMessageLike): Promise<RpsSessionRow> {
     const now = Date.now();
     const row: RpsSessionRow = {
       id: generateSessionId(),
@@ -52,34 +48,13 @@ export class SessionService {
       bot_wins: 0,
       round: 0,
       status: 'active',
-      board_message_id: '',
       updated_at: now,
       created_at: now,
     };
-    await getModel(this.db).create(row);
-    return row;
-  }
-
-  async updateSession(id: string, patch: Partial<RpsSessionRow>): Promise<void> {
-    await getModel(this.db).updateWhere({ id }, { ...patch, updated_at: Date.now() });
-  }
-
-  async abortStale(idleMs: number): Promise<number> {
-    const cutoff = Date.now() - idleMs;
-    const model = getModel(this.db);
-    const rows = await model.findAll({ status: 'active' });
-    let n = 0;
-    for (const row of rows) {
-      if (row.updated_at < cutoff) {
-        await model.updateWhere({ id: row.id }, { status: 'aborted', updated_at: Date.now() });
-        n++;
-      }
-    }
-    return n;
+    return this.createRow(row);
   }
 }
 
 export function createServices(db: RpsDatabase): SessionService {
   return new SessionService(db);
 }
-

package/src/view.ts

@@ -31,6 +31,7 @@ export function buildRpsView(
     lines.push('');
     if (session.status === 'won') lines.push('🏆 **你赢得比赛！**');
     else if (session.status === 'lost') lines.push('💀 **机器人赢得比赛。**');
+    else lines.push('🏳️ **本局已放弃。**');
   } else if (!lastRound) {
     lines.push('', '出拳吧！');
   } else {
@@ -39,11 +40,14 @@ export function buildRpsView(
 
   const choices = terminal
     ? [{ id: 'restart', label: '🔄 再来一局', style: 'primary' as const, keepEnabledWhenTerminal: true }]
-    : (['rock', 'paper', 'scissors'] as RpsMove[]).map((m) => ({
-        id: m,
-        label: MOVE_LABELS[m],
-        style: 'secondary' as const,
-      }));
+    : [
+        ...(['rock', 'paper', 'scissors'] as RpsMove[]).map((m) => ({
+          id: m,
+          label: MOVE_LABELS[m],
+          style: 'secondary' as const,
+        })),
+        { id: 'quit', label: '🏳️ 放弃', style: 'danger' as const },
+      ];
 
   return buildChoiceKeyboard({
     gamePrefix: RPS_PREFIX,
@@ -52,7 +56,7 @@ export function buildRpsView(
     choices,
     terminal,
     buttonsPerRow: 3,
-    fallbackHint: '回复数字出拳（1石头 2布 3剪刀）',
+    fallbackHint: '回复数字：1石头 2布 3剪刀 4放弃',
     interactionProfile: terminal ? 'terminal' : 'gameplay',
     channelType,
   });

package/lib/memory-db.d.ts

@@ -1,6 +0,0 @@
-import type { DatabaseHost } from '@zhin.js/plugin-runtime';
-import { type RpsDatabase, type SessionService } from './session-service.js';
-/** In-memory rps_sessions for Plugin Runtime slice-2 (no DatabaseFeature). */
-export declare function createInMemoryRpsDb(): RpsDatabase;
-export declare function mountRpsMemoryServices(): SessionService;
-export declare function mountRpsHostServices(host: DatabaseHost): SessionService;

package/lib/memory-db.js

@@ -1,18 +0,0 @@
-import { createHostGameDb, createInMemoryGameDb } from '@zhin.js/game-kit';
-import { defineHostTables } from './models.js';
-import { createServices } from './session-service.js';
-const RPS_TABLES = ['rps_sessions'];
-/** In-memory rps_sessions for Plugin Runtime slice-2 (no DatabaseFeature). */
-export function createInMemoryRpsDb() {
-    return createInMemoryGameDb(RPS_TABLES);
-}
-export function mountRpsMemoryServices() {
-    const services = createServices(createInMemoryRpsDb());
-    return services;
-}
-export function mountRpsHostServices(host) {
-    defineHostTables(host);
-    const services = createServices(createHostGameDb(host, RPS_TABLES));
-    return services;
-}
-//# sourceMappingURL=memory-db.js.map

package/lib/memory-db.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"memory-db.js","sourceRoot":"","sources":["../src/memory-db.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAyC,MAAM,sBAAsB,CAAC;AAE7F,MAAM,UAAU,GAAG,CAAC,cAAc,CAAU,CAAC;AAE7C,8EAA8E;AAC9E,MAAM,UAAU,mBAAmB;IACjC,OAAO,oBAAoB,CAAC,UAAU,CAA2B,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,MAAM,QAAQ,GAAG,cAAc,CAAC,mBAAmB,EAAE,CAAC,CAAC;IACvD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAkB;IACrD,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACvB,MAAM,QAAQ,GAAG,cAAc,CAAC,gBAAgB,CAAC,IAAI,EAAE,UAAU,CAA2B,CAAC,CAAC;IAC9F,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/plugin.ts

@@ -1,63 +0,0 @@
-import { definePlugin, databaseHostToken, scheduleHostToken } from '@zhin.js/plugin-runtime';
-import {
-  registerRuntimeGame,
-  initGameRecordHost,
-  DEFAULT_GAME_STALE_CRON,
-  DEFAULT_GAME_STALE_IDLE_MS,
-} from '@zhin.js/game-kit';
-import { mountRpsHostServices, mountRpsMemoryServices } from './src/memory-db.js';
-import { gameServicesToken } from './src/runtime-store.js';
-import type { SessionService } from './src/session-service.js';
-
-/**
- * Plugin Runtime:
- * - Commands under `commands/` are authoritative (help + start/continue/quit via in-memory DB).
- * - DB: prefer databaseHostToken; else in-memory SessionService.
- * - Choice middleware under `middlewares/` handles RPS choice payloads (Sandbox action→text).
- */
-export default definePlugin({
-  name: 'rps',
-  metadata: {
-    displayName: 'RPS',
-  },
-  setup(context) {
-    let services: SessionService;
-    if (context.resources.has(databaseHostToken)) {
-      const host = context.resources.use(databaseHostToken);
-      services = mountRpsHostServices(host);
-      context.lifecycle.add(initGameRecordHost(host));
-    } else {
-      services = mountRpsMemoryServices();
-    }
-    context.resources.provide(gameServicesToken, services);
-    const disposeHub = registerRuntimeGame({
-      id: 'rps',
-      title: '猜拳对决',
-      icon: '✊',
-      description: '石头剪刀布，三局两胜',
-      commandPrefix: '/猜拳',
-      quickStart: '开始',
-      aliases: ['rps'],
-      menus: [
-        { id: 'start', label: '🎮 开始对局' },
-        { id: 'continue', label: '🔄 继续' },
-        { id: 'help', label: '📖 玩法说明' },
-      ],
-    });
-    context.lifecycle.add(disposeHub);
-
-    if (context.resources.has(scheduleHostToken)) {
-      const schedule = context.resources.use(scheduleHostToken);
-      const disposeCron = schedule.register({
-        id: 'rps/abort-stale',
-        cron: DEFAULT_GAME_STALE_CRON,
-        description: 'Abort stale rps sessions',
-        async execute() {
-          if (!services.abortStale) return;
-          await services.abortStale(DEFAULT_GAME_STALE_IDLE_MS);
-        },
-      });
-      context.lifecycle.add(disposeCron);
-    }
-  },
-});

package/src/memory-db.ts

@@ -1,22 +0,0 @@
-import { createHostGameDb, createInMemoryGameDb } from '@zhin.js/game-kit';
-import type { DatabaseHost } from '@zhin.js/plugin-runtime';
-import { defineHostTables } from './models.js';
-import { createServices, type RpsDatabase, type SessionService } from './session-service.js';
-
-const RPS_TABLES = ['rps_sessions'] as const;
-
-/** In-memory rps_sessions for Plugin Runtime slice-2 (no DatabaseFeature). */
-export function createInMemoryRpsDb(): RpsDatabase {
-  return createInMemoryGameDb(RPS_TABLES) as unknown as RpsDatabase;
-}
-
-export function mountRpsMemoryServices(): SessionService {
-  const services = createServices(createInMemoryRpsDb());
-  return services;
-}
-
-export function mountRpsHostServices(host: DatabaseHost): SessionService {
-  defineHostTables(host);
-  const services = createServices(createHostGameDb(host, RPS_TABLES) as unknown as RpsDatabase);
-  return services;
-}