@zhin.js/plugin-rps 1.0.0

package/lib/view.js

@@ -0,0 +1,49 @@
+import { buildChoiceKeyboard } from '@zhin.js/game-shared';
+import { MOVE_LABELS, RPS_PREFIX, WIN_TARGET } from './engine.js';
+export function buildRpsView(session, lastRound) {
+    const terminal = session.status !== 'active';
+    const lines = [
+        '✊✋✌️ **猜拳对决**',
+        '',
+        `比分 · 你 **${session.player_wins}** : **${session.bot_wins}** 机器人（先 ${WIN_TARGET} 胜）`,
+    ];
+    if (lastRound) {
+        lines.push('');
+        lines.push(`你出 ${MOVE_LABELS[lastRound.player]}，机器人出 ${MOVE_LABELS[lastRound.bot]}`);
+        lines.push(lastRound.result === 0
+            ? '🤝 平局！'
+            : lastRound.result === 1
+                ? '🎉 你赢了这一局！'
+                : '😅 机器人赢了这一局。');
+    }
+    if (terminal) {
+        lines.push('');
+        if (session.status === 'won')
+            lines.push('🏆 **你赢得比赛！**');
+        else if (session.status === 'lost')
+            lines.push('💀 **机器人赢得比赛。**');
+    }
+    else if (!lastRound) {
+        lines.push('', '出拳吧！');
+    }
+    else {
+        lines.push('', '继续出拳：');
+    }
+    const choices = terminal
+        ? [{ id: 'restart', label: '🔄 再来一局', style: 'primary' }]
+        : ['rock', 'paper', 'scissors'].map((m) => ({
+            id: m,
+            label: MOVE_LABELS[m],
+            style: 'secondary',
+        }));
+    return buildChoiceKeyboard({
+        gamePrefix: RPS_PREFIX,
+        sessionId: session.id,
+        narrative: lines.join('\n'),
+        choices,
+        terminal,
+        buttonsPerRow: 3,
+        fallbackHint: '回复数字出拳（1石头 2布 3剪刀）',
+    });
+}
+//# sourceMappingURL=view.js.map

package/lib/view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.js","sourceRoot":"","sources":["../src/view.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAG3D,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAgB,MAAM,aAAa,CAAC;AAEhF,MAAM,UAAU,YAAY,CAC1B,OAAsB,EACtB,SAAgE;IAEhE,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,CAAC;QAClE,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;KACnC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@zhin.js/plugin-rps",
+  "version": "1.0.0",
+  "description": "Zhin.js 猜拳游戏 — 石头剪刀布三局两胜",
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "development": "./src/index.ts",
+      "import": "./lib/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "plugin.yml",
+    "README.md"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "zhin.js": "4.1.0"
+  },
+  "dependencies": {
+    "@zhin.js/game-shared": "1.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^6.0.3",
+    "zhin.js": "4.1.0"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "rimraf lib"
+  }
+}

package/plugin.yml

@@ -0,0 +1,2 @@
+name: "@zhin.js/plugin-rps"
+description: "猜拳对决"

package/src/commands.ts

@@ -0,0 +1,102 @@
+import { Message, MessageCommand, getActionFromMessage, type Plugin } from 'zhin.js';
+import {
+  buildChoiceFallbackMap,
+  channelKey,
+  normalizeRpsAction,
+  parseChoicePayload,
+  registerGameTextMiddleware,
+} from '@zhin.js/game-shared';
+import { handleChoice, RPS_PREFIX } from './game-flow.js';
+import { runRpsCommand } from './rps-command.js';
+import type { SessionService } from './session-service.js';
+
+function registerPattern(
+  plugin: Plugin,
+  pattern: string,
+  desc: string,
+  getServices: () => SessionService | null,
+): void {
+  plugin.addCommand(
+    new MessageCommand(pattern)
+      .desc(desc)
+      .action(async (message, result) => {
+        const services = getServices();
+        if (!services) return '猜拳需要启用 database 配置。';
+        const raw = (result.params.action as string | undefined) ?? '';
+        return runRpsCommand(plugin, services, message, normalizeRpsAction(raw));
+      }),
+  );
+}
+
+export function registerCommands(plugin: Plugin, getServices: () => SessionService | null): void {
+  registerPattern(plugin, 'rps [action:word]', '猜拳（rps）', getServices);
+  registerPattern(plugin, '猜拳 [action:word]', '猜拳（中文）', getServices);
+}
+
+async function resolveChoice(
+  message: Message<any>,
+  services: SessionService,
+): Promise<{ sessionId: string; choiceId: string } | null> {
+  const action = getActionFromMessage(message);
+  if (!action) return null;
+
+  const parsed = parseChoicePayload(action.payload, RPS_PREFIX);
+  if (parsed) return { sessionId: parsed.sessionId, choiceId: parsed.choiceId };
+
+  const choiceId = action.id || action.payload;
+  if (!choiceId) return null;
+
+  const ch = channelKey(message);
+  const session =
+    await services.getActiveForUser(ch, message.$sender.id)
+    ?? (action.sourceMessageId
+      ? await services.getActiveByBoardMessageId(action.sourceMessageId)
+      : null);
+  if (!session || session.channel_key !== ch) return null;
+
+  const valid = ['rock', 'paper', 'scissors', 'restart'];
+  if (!valid.includes(choiceId)) return null;
+  return { sessionId: session.id, choiceId };
+}
+
+export function registerInteractive(plugin: Plugin, getServices: () => SessionService | null): void {
+  plugin.registerInteractiveHandler(`${RPS_PREFIX}:`, async (message) => {
+    const services = getServices();
+    if (!services) return false;
+    const choice = await resolveChoice(message, services);
+    if (!choice) return false;
+    const err = await handleChoice(plugin, services, message, choice.sessionId, choice.choiceId);
+    if (err) await message.$reply?.(err);
+    return true;
+  });
+}
+
+export function registerTextFallback(plugin: Plugin, getServices: () => SessionService | null): void {
+  registerGameTextMiddleware(plugin, async (message, next) => {
+    const services = getServices();
+    if (!services) return next();
+
+    const action = getActionFromMessage(message);
+    if (action?.payload.startsWith(`${RPS_PREFIX}:`)) return next();
+
+    const ch = channelKey(message);
+    const session = await services.getActiveForUser(ch, message.$sender.id);
+    if (!session || session.status !== 'active') return next();
+
+    const raw = message.$raw?.trim() ?? '';
+    const n = /^(\d+)$/.exec(raw);
+    if (!n) return next();
+
+    const map = buildChoiceFallbackMap(RPS_PREFIX, session.id, [
+      { id: 'rock', label: '石头' },
+      { id: 'paper', label: '布' },
+      { id: 'scissors', label: '剪刀' },
+    ]);
+    const payload = map[n[1]!];
+    const parsed = payload ? parseChoicePayload(payload, RPS_PREFIX) : null;
+    if (!parsed || parsed.sessionId !== session.id) return next();
+
+    const err = await handleChoice(plugin, services, message, session.id, parsed.choiceId);
+    if (err) await message.$reply?.(err);
+  }, 'rps:text');
+}

package/src/engine.ts

@@ -0,0 +1,44 @@
+export const RPS_PREFIX = 'rps';
+
+export type RpsMove = 'rock' | 'paper' | 'scissors';
+
+export const MOVE_LABELS: Record<RpsMove, string> = {
+  rock: '✊ 石头',
+  paper: '✋ 布',
+  scissors: '✌️ 剪刀',
+};
+
+const BEATS: Record<RpsMove, RpsMove> = {
+  rock: 'scissors',
+  paper: 'rock',
+  scissors: 'paper',
+};
+
+export function randomBotMove(): RpsMove {
+  const moves: RpsMove[] = ['rock', 'paper', 'scissors'];
+  return moves[Math.floor(Math.random() * moves.length)]!;
+}
+
+/** 1=玩家胜 2=机器人胜 0=平局 */
+export function resolveRound(player: RpsMove, bot: RpsMove): 0 | 1 | 2 {
+  if (player === bot) return 0;
+  return BEATS[player] === bot ? 1 : 2;
+}
+
+export function parseMove(raw: string): RpsMove | null {
+  const t = raw.trim().toLowerCase();
+  const map: Record<string, RpsMove> = {
+    rock: 'rock',
+    paper: 'paper',
+    scissors: 'scissors',
+    石头: 'rock',
+    布: 'paper',
+    剪刀: 'scissors',
+    r: 'rock',
+    p: 'paper',
+    s: 'scissors',
+  };
+  return map[t] ?? null;
+}
+
+export const WIN_TARGET = 3;

package/src/game-flow.ts

@@ -0,0 +1,127 @@
+import type { Adapter, Message, Plugin } from 'zhin.js';
+import type { RpsSessionRow } from './models.js';
+import {
+  RPS_PREFIX,
+  WIN_TARGET,
+  randomBotMove,
+  resolveRound,
+  type RpsMove,
+} from './engine.js';
+import type { SessionService } from './session-service.js';
+import { buildRpsView } from './view.js';
+
+export async function sendOrEditView(
+  plugin: Plugin,
+  services: SessionService,
+  message: Message<any>,
+  session: RpsSessionRow,
+  lastRound?: { player: RpsMove; bot: RpsMove; result: 0 | 1 | 2 },
+): Promise<void> {
+  const content = buildRpsView(session, lastRound);
+  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 });
+}
+
+export async function startGame(
+  plugin: Plugin,
+  services: SessionService,
+  message: Message<any>,
+): Promise<string | undefined> {
+  const ch = `${message.$adapter}-${message.$endpoint}-${message.$channel.type}:${message.$channel.id}`;
+  const active = await services.getActiveByChannel(ch);
+  if (active) {
+    if (active.player_id === message.$sender.id) {
+      return '你已有进行中的猜拳，发送「猜拳 继续」刷新，或「猜拳 放弃」。';
+    }
+    return `本频道 ${active.player_name} 正在猜拳对决中。`;
+  }
+  const session = await services.createSession(message);
+  await sendOrEditView(plugin, services, message, session);
+  return undefined;
+}
+
+export async function handleChoice(
+  plugin: Plugin,
+  services: SessionService,
+  message: Message<any>,
+  sessionId: string,
+  choiceId: string,
+): Promise<string | null> {
+  const session = await services.getById(sessionId);
+  if (!session) return '对局不存在。';
+  if (session.status !== 'active' && choiceId !== 'restart') {
+    return '对局已结束，请点击再来一局。';
+  }
+  if (session.player_id !== message.$sender.id) return '这是别人的对局。';
+
+  if (choiceId === 'restart') {
+    await services.updateSession(session.id, {
+      player_wins: 0,
+      bot_wins: 0,
+      round: 0,
+      status: 'active',
+      board_message_id: '',
+    });
+    const updated = (await services.getById(session.id))!;
+    await sendOrEditView(plugin, services, message, updated);
+    return null;
+  }
+
+  const player = choiceId as RpsMove;
+  if (!['rock', 'paper', 'scissors'].includes(player)) return '无效出拳。';
+
+  const bot = randomBotMove();
+  const result = resolveRound(player, bot);
+  let playerWins = session.player_wins;
+  let botWins = session.bot_wins;
+  if (result === 1) playerWins++;
+  if (result === 2) botWins++;
+
+  let status: RpsSessionRow['status'] = 'active';
+  if (playerWins >= WIN_TARGET) status = 'won';
+  else if (botWins >= WIN_TARGET) status = 'lost';
+
+  await services.updateSession(session.id, {
+    player_wins: playerWins,
+    bot_wins: botWins,
+    round: session.round + 1,
+    status,
+  });
+
+  const updated = (await services.getById(session.id))!;
+  await sendOrEditView(plugin, services, message, updated, { player, bot, result });
+  return null;
+}
+
+export async function continueGame(
+  plugin: Plugin,
+  services: SessionService,
+  message: Message<any>,
+): Promise<string> {
+  const session = await services.getActiveForUser(
+    `${message.$adapter}-${message.$endpoint}-${message.$channel.type}:${message.$channel.id}`,
+    message.$sender.id,
+  );
+  if (!session) return '你没有进行中的猜拳，发送「猜拳 开始」。';
+  await sendOrEditView(plugin, services, message, session);
+  return '已刷新猜拳界面。';
+}
+
+export { RPS_PREFIX };

package/src/hub-register.ts

@@ -0,0 +1,30 @@
+import { getPlugin } from 'zhin.js';
+import { ensureGameHubService } from '@zhin.js/game-shared';
+import { runRpsCommand, RPS_HELP } from './rps-command.js';
+import type { SessionService } from './session-service.js';
+
+export function registerRpsHub(getServices: () => SessionService | null): () => void {
+  const plugin = getPlugin();
+  ensureGameHubService(plugin);
+  return plugin.registerGame({
+    id: 'rps',
+    title: '猜拳对决',
+    icon: '✊',
+    description: '石头剪刀布，三局两胜',
+    commandPrefix: '猜拳',
+    quickStart: '开始',
+    aliases: ['rps'],
+    menus: [
+      { id: 'start', label: '🎮 开始对局', style: 'primary' },
+      { id: 'continue', label: '🔄 继续' },
+      { id: 'help', label: '📖 玩法说明' },
+    ],
+    runAction: async (actionId, ctx) => {
+      const services = getServices();
+      if (!services) return '猜拳需要启用 database 配置。';
+      return runRpsCommand(ctx.plugin, services, ctx.message, actionId);
+    },
+  });
+}
+
+export { RPS_HELP };

package/src/index.ts

@@ -0,0 +1,36 @@
+import { Cron, formatCompact, usePlugin, type DatabaseFeature } from 'zhin.js';
+import { registerModels } from './models.js';
+import {
+  createServices,
+  resolveGameDatabase,
+  type SessionService,
+} from './session-service.js';
+import { registerCommands, registerInteractive, registerTextFallback } from './commands.js';
+import { registerRpsHub } from './hub-register.js';
+
+const plugin = usePlugin();
+const { logger, useContext, addCron } = plugin;
+
+registerModels(plugin);
+
+let services: SessionService | null = null;
+
+useContext('database', (dbFeature: DatabaseFeature) => {
+  services = createServices(resolveGameDatabase(dbFeature));
+  logger.info(formatCompact({ 模块: '猜拳', 数据模型: '已就绪' }));
+});
+
+registerRpsHub(() => services);
+registerCommands(plugin, () => services);
+registerInteractive(plugin, () => services);
+registerTextFallback(plugin, () => services);
+
+addCron(
+  new Cron('0 */15 * * * *', async () => {
+    if (!services) return;
+    const n = await services.abortStale(30 * 60 * 1000);
+    if (n > 0) logger.debug(formatCompact({ 猜拳: '清理超时局', count: n }));
+  }),
+);
+
+logger.info(formatCompact({ 模块: '猜拳', 状态: '已加载' }));

package/src/models.ts

@@ -0,0 +1,47 @@
+import type { Models, Plugin } from 'zhin.js';
+
+export type RpsSessionStatus = 'active' | 'won' | 'lost' | 'aborted';
+
+declare module 'zhin.js' {
+  interface Models {
+    rps_sessions: {
+      id: string;
+      adapter: string;
+      endpoint: string;
+      channel_type: string;
+      channel_id: string;
+      channel_key: string;
+      player_id: string;
+      player_name: string;
+      player_wins: number;
+      bot_wins: number;
+      round: number;
+      status: RpsSessionStatus;
+      board_message_id: string;
+      updated_at: number;
+      created_at: number;
+    };
+  }
+}
+
+export type RpsSessionRow = Models['rps_sessions'];
+
+export function registerModels(plugin: Plugin): void {
+  plugin.defineModel('rps_sessions', {
+    id: { type: 'text', primary: true },
+    adapter: { type: 'text', nullable: false },
+    endpoint: { type: 'text', nullable: false },
+    channel_type: { type: 'text', nullable: false },
+    channel_id: { type: 'text', nullable: false },
+    channel_key: { type: 'text', nullable: false },
+    player_id: { type: 'text', nullable: false },
+    player_name: { type: 'text', default: '' },
+    player_wins: { type: 'integer', default: 0 },
+    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

@@ -0,0 +1,45 @@
+import type { Message, Plugin } from 'zhin.js';
+import { channelKey } from '@zhin.js/game-shared';
+import { continueGame, startGame } from './game-flow.js';
+import type { SessionService } from './session-service.js';
+
+export const RPS_HELP = [
+  '✊✋✌️ 猜拳对决（三局两胜）',
+  '猜拳 / rps — 帮助',
+  '猜拳 开始 — 新对局',
+  '猜拳 继续 — 刷新界面',
+  '猜拳 放弃 — 结束对局',
+].join('\n');
+
+export async function runRpsCommand(
+  plugin: Plugin,
+  services: SessionService,
+  message: Message<any>,
+  action: string,
+): Promise<string | undefined> {
+  const ch = channelKey(message);
+  const userId = message.$sender.id;
+
+  if (!action || action === 'help') {
+    const active = await services.getActiveByChannel(ch);
+    const lines = [RPS_HELP, ''];
+    if (active) {
+      lines.push(`进行中：${active.player_name} · ${active.player_wins}:${active.bot_wins}`);
+    } else {
+      lines.push('暂无对局，发送「猜拳 开始」或从游戏大厅进入。');
+    }
+    return lines.join('\n');
+  }
+
+  if (action === 'start') return startGame(plugin, services, message);
+  if (action === 'continue') return continueGame(plugin, services, message);
+
+  if (action === 'quit') {
+    const row = await services.getActiveForUser(ch, userId);
+    if (!row) return '你没有进行中的猜拳。';
+    await services.updateSession(row.id, { status: 'aborted' });
+    return '已放弃猜拳对局。';
+  }
+
+  return `未知子命令：${action}\n\n${RPS_HELP}`;
+}

package/src/session-service.ts

@@ -0,0 +1,92 @@
+import type { Database, DatabaseFeature, Message, Models, RelatedModel } from 'zhin.js';
+import { channelKey, generateSessionId } from '@zhin.js/game-shared';
+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 });
+  }
+
+  async getActiveByBoardMessageId(messageId: string): Promise<RpsSessionRow | null> {
+    if (!messageId) return null;
+    const rows = await getModel(this.db).findAll({ status: 'active' });
+    for (const row of rows) {
+      const stored = row.board_message_id;
+      if (!stored) continue;
+      if (stored === messageId || stored.endsWith(`:${messageId}`)) return row;
+      const tail = stored.split(':').pop();
+      if (tail && messageId.endsWith(tail)) return row;
+    }
+    return null;
+  }
+
+  async createSession(message: Message<any>): Promise<RpsSessionRow> {
+    const now = Date.now();
+    const row: RpsSessionRow = {
+      id: generateSessionId(),
+      adapter: String(message.$adapter),
+      endpoint: message.$endpoint,
+      channel_type: message.$channel.type,
+      channel_id: message.$channel.id,
+      channel_key: channelKey(message),
+      player_id: message.$sender.id,
+      player_name: message.$sender.name?.trim() || message.$sender.id,
+      player_wins: 0,
+      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;
+  }
+}
+
+export function createServices(db: RpsDatabase): SessionService {
+  return new SessionService(db);
+}
+
+export function resolveGameDatabase(feature: DatabaseFeature): RpsDatabase {
+  return feature.db;
+}

package/src/view.ts

@@ -0,0 +1,56 @@
+import { buildChoiceKeyboard } from '@zhin.js/game-shared';
+import type { SendContent } from 'zhin.js';
+import type { RpsSessionRow } from './models.js';
+import { MOVE_LABELS, RPS_PREFIX, WIN_TARGET, type RpsMove } from './engine.js';
+
+export function buildRpsView(
+  session: RpsSessionRow,
+  lastRound?: { player: RpsMove; bot: RpsMove; result: 0 | 1 | 2 },
+): SendContent {
+  const terminal = session.status !== 'active';
+  const lines = [
+    '✊✋✌️ **猜拳对决**',
+    '',
+    `比分 · 你 **${session.player_wins}** : **${session.bot_wins}** 机器人（先 ${WIN_TARGET} 胜）`,
+  ];
+
+  if (lastRound) {
+    lines.push('');
+    lines.push(`你出 ${MOVE_LABELS[lastRound.player]}，机器人出 ${MOVE_LABELS[lastRound.bot]}`);
+    lines.push(
+      lastRound.result === 0
+        ? '🤝 平局！'
+        : lastRound.result === 1
+          ? '🎉 你赢了这一局！'
+          : '😅 机器人赢了这一局。',
+    );
+  }
+
+  if (terminal) {
+    lines.push('');
+    if (session.status === 'won') lines.push('🏆 **你赢得比赛！**');
+    else if (session.status === 'lost') lines.push('💀 **机器人赢得比赛。**');
+  } else if (!lastRound) {
+    lines.push('', '出拳吧！');
+  } else {
+    lines.push('', '继续出拳：');
+  }
+
+  const choices = terminal
+    ? [{ id: 'restart', label: '🔄 再来一局', style: 'primary' as const }]
+    : (['rock', 'paper', 'scissors'] as RpsMove[]).map((m) => ({
+        id: m,
+        label: MOVE_LABELS[m],
+        style: 'secondary' as const,
+      }));
+
+  return buildChoiceKeyboard({
+    gamePrefix: RPS_PREFIX,
+    sessionId: session.id,
+    narrative: lines.join('\n'),
+    choices,
+    terminal,
+    buttonsPerRow: 3,
+    fallbackHint: '回复数字出拳（1石头 2布 3剪刀）',
+  });
+}