@zhin.js/game-kit 1.0.1

package/lib/game-records.js

@@ -0,0 +1,206 @@
+import { MessageCommand, } from '@zhin.js/core';
+import { channelKey } from './board-sender.js';
+import { getRegisteredGame, getRegisteredGames } from './game-hub-feature.js';
+import { createHostGameDb } from './memory-db.js';
+import { generateCompactId } from './random.js';
+let legacyDb = null;
+let hostDatabases = new WeakMap();
+const hostRegistrations = [];
+function activeDatabase() {
+    return hostRegistrations[hostRegistrations.length - 1]?.database ?? legacyDb;
+}
+function getRecordModel(database) {
+    const model = database.models.get('game_records');
+    if (!model)
+        throw new Error('game_records not registered');
+    return model;
+}
+export function registerGameRecordModels(plugin) {
+    plugin.defineModel('game_records', {
+        id: { type: 'text', primary: true },
+        user_id: { type: 'text', nullable: false },
+        user_name: { type: 'text', default: '' },
+        channel_key: { type: 'text', nullable: false },
+        game_id: { type: 'text', nullable: false },
+        result: { type: 'text', nullable: false },
+        score: { type: 'integer', default: 0 },
+        created_at: { type: 'integer', default: 0 },
+    });
+}
+export function initGameRecordDatabase(dbFeature) {
+    legacyDb = dbFeature.db;
+}
+const GAME_RECORDS_DEFINITION = {
+    id: { type: 'text', primary: true },
+    user_id: { type: 'text', nullable: false },
+    user_name: { type: 'text', default: '' },
+    channel_key: { type: 'text', nullable: false },
+    game_id: { type: 'text', nullable: false },
+    result: { type: 'text', nullable: false },
+    score: { type: 'integer', default: 0 },
+    created_at: { type: 'integer', default: 0 },
+};
+/**
+ * Plugin Runtime 下用 databaseHostToken 初始化战绩库。
+ * 幂等：多个游戏插件 setup 都会调用，只建一次；无 token 时保持跳过（内存/静默）。
+ */
+export function initGameRecordHost(host) {
+    let database = hostDatabases.get(host);
+    if (!database) {
+        host.define('game_records', GAME_RECORDS_DEFINITION);
+        database = createHostGameDb(host, ['game_records']);
+        hostDatabases.set(host, database);
+    }
+    const registration = Object.freeze({ host, database });
+    hostRegistrations.push(registration);
+    return () => {
+        const index = hostRegistrations.lastIndexOf(registration);
+        if (index >= 0)
+            hostRegistrations.splice(index, 1);
+    };
+}
+function recordId() {
+    return generateCompactId('gr');
+}
+/** 对局结束时写入战绩（database 未就绪时静默跳过） */
+export async function recordGameOutcome(message, gameId, result, score = 0) {
+    const db = activeDatabase();
+    if (!db)
+        return;
+    const row = {
+        id: recordId(),
+        user_id: message.$sender.id,
+        user_name: String(message.$sender.name ?? message.$sender.id),
+        channel_key: channelKey(message),
+        game_id: gameId,
+        result,
+        score,
+        created_at: Date.now(),
+    };
+    await getRecordModel(db).create(row);
+}
+export async function getUserGameStats(userId, channelKeyFilter) {
+    const db = activeDatabase();
+    if (!db)
+        return [];
+    const where = channelKeyFilter
+        ? { user_id: userId, channel_key: channelKeyFilter }
+        : { user_id: userId };
+    const rows = await getRecordModel(db).findAll(where);
+    const byGame = new Map();
+    for (const row of rows) {
+        let stat = byGame.get(row.game_id);
+        if (!stat) {
+            stat = {
+                gameId: row.game_id,
+                wins: 0,
+                losses: 0,
+                draws: 0,
+                totalScore: 0,
+                games: 0,
+            };
+            byGame.set(row.game_id, stat);
+        }
+        stat.games++;
+        stat.totalScore += row.score;
+        if (row.result === 'won')
+            stat.wins++;
+        else if (row.result === 'lost')
+            stat.losses++;
+        else if (row.result === 'draw')
+            stat.draws++;
+    }
+    return [...byGame.values()].sort((a, b) => b.wins - a.wins);
+}
+export async function getGameLeaderboard(gameId, channelKeyFilter, limit = 10) {
+    const db = activeDatabase();
+    if (!db)
+        return [];
+    const rows = await getRecordModel(db).findAll({
+        game_id: gameId,
+        channel_key: channelKeyFilter,
+    });
+    const byUser = new Map();
+    for (const row of rows) {
+        let entry = byUser.get(row.user_id);
+        if (!entry) {
+            entry = {
+                userId: row.user_id,
+                userName: row.user_name,
+                wins: 0,
+                totalScore: 0,
+                games: 0,
+            };
+            byUser.set(row.user_id, entry);
+        }
+        entry.games++;
+        entry.totalScore += row.score;
+        if (row.result === 'won')
+            entry.wins++;
+    }
+    return [...byUser.values()]
+        .sort((a, b) => b.wins - a.wins || b.totalScore - a.totalScore)
+        .slice(0, limit);
+}
+function gameTitle(gameId) {
+    const g = getRegisteredGame(gameId);
+    return g ? `${g.icon} ${g.title}` : gameId;
+}
+function formatUserStats(stats) {
+    if (!stats.length)
+        return '暂无战绩记录，快去 `/游戏` 开一局吧！';
+    const lines = stats.map((s) => {
+        const title = gameTitle(s.gameId);
+        return `• ${title}：${s.wins} 胜 ${s.losses} 负${s.draws ? ` ${s.draws} 平` : ''}（${s.games} 局，得分 ${s.totalScore}）`;
+    });
+    return ['📊 **你的战绩**', '', ...lines].join('\n');
+}
+function formatLeaderboard(gameId, entries) {
+    const title = gameTitle(gameId);
+    if (!entries.length) {
+        return `${title} 在本群暂无排行，发送 \`/游戏\` 开始第一局！`;
+    }
+    const lines = entries.map((e, i) => `${i + 1}. ${e.userName} — ${e.wins} 胜 / ${e.games} 局（得分 ${e.totalScore}）`);
+    return [`🏆 **${title} 本群排行**`, '', ...lines].join('\n');
+}
+export function mountGameRecordCommands(root) {
+    const disposers = [];
+    disposers.push(root.addCommand(new MessageCommand('/战绩')
+        .desc('查看本人在本群的游戏战绩')
+        .action(async (message) => {
+        const stats = await getUserGameStats(message.$sender.id, channelKey(message));
+        return formatUserStats(stats);
+    })), root.addCommand(new MessageCommand('/排行')
+        .desc('查看本群某游戏排行榜')
+        .action(async (message, ...args) => {
+        const query = args.join(' ').trim();
+        const games = getRegisteredGames();
+        if (!games.length)
+            return '暂无已注册游戏。';
+        let gameId = games[0].id;
+        if (query) {
+            const hit = games.find((g) => g.id === query
+                || g.title.includes(query)
+                || g.commandPrefix.includes(query)
+                || g.aliases?.some((a) => a.includes(query)));
+            if (!hit) {
+                const names = games.map((g) => g.title).join('、');
+                return `未找到游戏「${query}」。可选：${names}`;
+            }
+            gameId = hit.id;
+        }
+        const board = await getGameLeaderboard(gameId, channelKey(message));
+        return formatLeaderboard(gameId, board);
+    })));
+    return () => {
+        for (const d of disposers)
+            d();
+    };
+}
+/** 测试专用 */
+export function resetGameRecordsForTests() {
+    legacyDb = null;
+    hostDatabases = new WeakMap();
+    hostRegistrations.splice(0);
+}
+//# sourceMappingURL=game-records.js.map

package/lib/game-records.js.map

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

package/lib/game-session.d.ts

@@ -0,0 +1,64 @@
+/**
+ * 通用游戏会话接口
+ * 定义回合制游戏的基础会话结构
+ */
+import type { Message } from '@zhin.js/core';
+/** 会话状态 */
+export type GameStatus = 'active' | 'won' | 'draw' | 'aborted';
+/** 通用游戏会话接口 */
+export interface GameSession {
+    /** 会话 ID */
+    id: string;
+    /** 适配器名称 */
+    adapter: string;
+    /** Endpoint 名称 */
+    endpoint: string;
+    /** 频道类型 */
+    channel_type: 'private' | 'group' | 'channel';
+    /** 频道 ID */
+    channel_id: string;
+    /** 频道唯一键 */
+    channel_key: string;
+    /** 棋盘消息 ID（用于编辑） */
+    board_message_id: string;
+    /** 当前状态 */
+    status: GameStatus;
+    /** 更新时间戳 */
+    updated_at: number;
+    /** 创建时间戳 */
+    created_at: number;
+}
+/** 回合制游戏会话（2 人对战） */
+export interface TurnBasedSession extends GameSession {
+    /** 玩家 1 ID */
+    player_1: string;
+    /** 玩家 2 ID */
+    player_2: string;
+    /** 玩家 1 显示名 */
+    player_1_name: string;
+    /** 玩家 2 显示名 */
+    player_2_name: string;
+    /** 当前回合（1 或 2） */
+    turn: 1 | 2;
+    /** 胜者（0=无，1=玩家1，2=玩家2） */
+    winner: 0 | 1 | 2;
+    /** 步数 */
+    move_count: number;
+}
+/** 生成会话 ID */
+export declare function generateSessionId(): string;
+/** 获取当前回合玩家 ID */
+export declare function currentPlayerId(session: TurnBasedSession): string;
+/** 判断用户是否为本局玩家 */
+export declare function isPlayer(session: TurnBasedSession, userId: string): boolean;
+/** 判断是否轮到该用户 */
+export declare function isPlayerTurn(session: TurnBasedSession, userId: string): boolean;
+/** 获取玩家编号（1 或 2），非玩家返回 null */
+export declare function playerNumber(session: TurnBasedSession, userId: string): 1 | 2 | null;
+/** 切换回合 */
+export declare function nextTurn(current: 1 | 2): 1 | 2;
+/** 从 Message 提取发送者显示名 */
+export declare function senderDisplayName(message: Message<any>): string;
+/** 比对出站 board_message_id 与平台回调 messageId（含 composite id） */
+export declare function boardMessageMatches(stored: string, messageId: string): boolean;
+//# sourceMappingURL=game-session.d.ts.map

package/lib/game-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-session.d.ts","sourceRoot":"","sources":["../src/game-session.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAG7C,WAAW;AACX,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;AAE/D,eAAe;AACf,MAAM,WAAW,WAAW;IAC1B,YAAY;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,YAAY;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,YAAY,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IAC9C,YAAY;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW;IACX,MAAM,EAAE,UAAU,CAAC;IACnB,YAAY;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY;IACZ,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAqB;AACrB,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,cAAc;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB;IAClB,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC;IACZ,0BAA0B;IAC1B,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAClB,SAAS;IACT,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,cAAc;AACd,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,kBAAkB;AAClB,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAEjE;AAED,kBAAkB;AAClB,wBAAgB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAE3E;AAED,gBAAgB;AAChB,wBAAgB,YAAY,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAE/E;AAED,+BAA+B;AAC/B,wBAAgB,YAAY,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAIpF;AAED,WAAW;AACX,wBAAgB,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAE9C;AAED,yBAAyB;AACzB,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAG/D;AAED,4DAA4D;AAC5D,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAK9E"}

package/lib/game-session.js

@@ -0,0 +1,44 @@
+import { generateCompactId } from './random.js';
+/** 生成会话 ID */
+export function generateSessionId() {
+    return generateCompactId('s');
+}
+/** 获取当前回合玩家 ID */
+export function currentPlayerId(session) {
+    return session.turn === 1 ? session.player_1 : session.player_2;
+}
+/** 判断用户是否为本局玩家 */
+export function isPlayer(session, userId) {
+    return session.player_1 === userId || session.player_2 === userId;
+}
+/** 判断是否轮到该用户 */
+export function isPlayerTurn(session, userId) {
+    return currentPlayerId(session) === userId;
+}
+/** 获取玩家编号（1 或 2），非玩家返回 null */
+export function playerNumber(session, userId) {
+    if (session.player_1 === userId)
+        return 1;
+    if (session.player_2 === userId)
+        return 2;
+    return null;
+}
+/** 切换回合 */
+export function nextTurn(current) {
+    return current === 1 ? 2 : 1;
+}
+/** 从 Message 提取发送者显示名 */
+export function senderDisplayName(message) {
+    const name = message.$sender.name?.trim();
+    return name || message.$sender.id;
+}
+/** 比对出站 board_message_id 与平台回调 messageId（含 composite id） */
+export function boardMessageMatches(stored, messageId) {
+    if (!stored || !messageId)
+        return false;
+    if (stored === messageId || stored.endsWith(`:${messageId}`))
+        return true;
+    const tail = stored.split(':').pop();
+    return !!(tail && messageId.endsWith(tail));
+}
+//# sourceMappingURL=game-session.js.map

package/lib/game-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-session.js","sourceRoot":"","sources":["../src/game-session.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AA+ChD,cAAc;AACd,MAAM,UAAU,iBAAiB;IAC/B,OAAO,iBAAiB,CAAC,GAAG,CAAC,CAAC;AAChC,CAAC;AAED,kBAAkB;AAClB,MAAM,UAAU,eAAe,CAAC,OAAyB;IACvD,OAAO,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;AAClE,CAAC;AAED,kBAAkB;AAClB,MAAM,UAAU,QAAQ,CAAC,OAAyB,EAAE,MAAc;IAChE,OAAO,OAAO,CAAC,QAAQ,KAAK,MAAM,IAAI,OAAO,CAAC,QAAQ,KAAK,MAAM,CAAC;AACpE,CAAC;AAED,gBAAgB;AAChB,MAAM,UAAU,YAAY,CAAC,OAAyB,EAAE,MAAc;IACpE,OAAO,eAAe,CAAC,OAAO,CAAC,KAAK,MAAM,CAAC;AAC7C,CAAC;AAED,+BAA+B;AAC/B,MAAM,UAAU,YAAY,CAAC,OAAyB,EAAE,MAAc;IACpE,IAAI,OAAO,CAAC,QAAQ,KAAK,MAAM;QAAE,OAAO,CAAC,CAAC;IAC1C,IAAI,OAAO,CAAC,QAAQ,KAAK,MAAM;QAAE,OAAO,CAAC,CAAC;IAC1C,OAAO,IAAI,CAAC;AACd,CAAC;AAED,WAAW;AACX,MAAM,UAAU,QAAQ,CAAC,OAAc;IACrC,OAAO,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED,yBAAyB;AACzB,MAAM,UAAU,iBAAiB,CAAC,OAAqB;IACrD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;IAC1C,OAAO,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;AACpC,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,SAAiB;IACnE,IAAI,CAAC,MAAM,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,SAAS,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1E,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;IACrC,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AAC9C,CAAC"}

package/lib/grid-keyboard.d.ts

@@ -0,0 +1,67 @@
+/**
+ * 通用网格按钮键盘构建器
+ * 支持井字棋（3×3）、五子棋（15×15）、四子棋（7×6）等
+ */
+import { type SendContent } from '@zhin.js/core';
+import { type ChoiceOption } from './choice-keyboard.js';
+export interface GridCell<T = unknown> {
+    /** 单元格状态（游戏自定义，如 0=空, 1=X, 2=O） */
+    state: T;
+    /** 按钮显示文本 */
+    label: string;
+    /** 是否禁用（已落子或终局） */
+    disabled: boolean;
+    /** 高亮（胜利连线等） */
+    highlight?: boolean;
+}
+export interface GridKeyboardOptions<T = unknown> {
+    /** 游戏前缀（如 'ttt', 'gomoku', 'c4'） */
+    gamePrefix: string;
+    /** 会话 ID */
+    sessionId: string;
+    /** 行数 */
+    rows: number;
+    /** 列数 */
+    cols: number;
+    /** 单元格数据，按行优先 [row * cols + col] */
+    cells: GridCell<T>[];
+    /** 状态行文本 */
+    statusLine: string;
+    /** 是否终局（全部按钮禁用） */
+    terminal?: boolean;
+    /** 省略 ASCII 文本棋盘（QQ 等平台） */
+    omitAsciiBoard?: boolean;
+    /** ASCII 棋盘渲染器（可选，省略则不渲染 ASCII） */
+    renderAscii?: (cells: GridCell<T>[], rows: number, cols: number, highlight?: number[]) => string;
+    /** 高亮的单元格索引（胜利连线等） */
+    highlight?: number[];
+    /** fallback 提示文本 */
+    fallbackHint?: string;
+    /** 终局时在棋盘下方追加的选项（如「再来一局」，不受 terminal 禁用） */
+    postChoices?: ChoiceOption[];
+    /** postChoices 使用的 profile，默认 terminal */
+    postChoicesProfile?: 'terminal';
+    /** terminal 私聊 auto-enter */
+    channelType?: string;
+}
+/**
+ * 构建 fallback 数字映射（仅可落子的格子）
+ */
+export declare function buildGridFallbackMap(gamePrefix: string, sessionId: string, cells: GridCell[]): Record<string, string>;
+/**
+ * 构建网格按钮键盘消息内容
+ */
+export declare function buildGridKeyboard<T>(options: GridKeyboardOptions<T>): SendContent;
+/**
+ * 解析网格 payload：`{prefix}:{sessionId}:{cellIndex}`
+ */
+export declare function parseGridPayload(payload: string, expectedPrefix?: string): {
+    prefix: string;
+    sessionId: string;
+    cell: number;
+} | null;
+/**
+ * 解析按钮 ID 格式：`c{cellIndex}`（QQ 等平台 action 可能只回传 button_id）
+ */
+export declare function parseCellButtonId(value: string): number | null;
+//# sourceMappingURL=grid-keyboard.d.ts.map

package/lib/grid-keyboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid-keyboard.d.ts","sourceRoot":"","sources":["../src/grid-keyboard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAW,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAA0B,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAIjF,MAAM,WAAW,QAAQ,CAAC,CAAC,GAAG,OAAO;IACnC,mCAAmC;IACnC,KAAK,EAAE,CAAC,CAAC;IACT,aAAa;IACb,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB,CAAC,CAAC,GAAG,OAAO;IAC9C,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS;IACT,IAAI,EAAE,MAAM,CAAC;IACb,SAAS;IACT,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IACrB,YAAY;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4BAA4B;IAC5B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mCAAmC;IACnC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,MAAM,CAAC;IACjG,sBAAsB;IACtB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,oBAAoB;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,YAAY,EAAE,CAAC;IAC7B,0CAA0C;IAC1C,kBAAkB,CAAC,EAAE,UAAU,CAAC;IAChC,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,QAAQ,EAAE,GAChB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUxB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,WAAW,CA+EjF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,MAAM,GACtB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAQ5D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM9D"}

package/lib/grid-keyboard.js

@@ -0,0 +1,104 @@
+/**
+ * 通用网格按钮键盘构建器
+ * 支持井字棋（3×3）、五子棋（15×15）、四子棋（7×6）等
+ */
+import { segment } from '@zhin.js/core';
+import { buildChoiceFallbackMap } from './choice-keyboard.js';
+import { applyInteractionProfile } from './interaction-profiles.js';
+/**
+ * 构建 fallback 数字映射（仅可落子的格子）
+ */
+export function buildGridFallbackMap(gamePrefix, sessionId, cells) {
+    const map = {};
+    let n = 1;
+    for (let i = 0; i < cells.length; i++) {
+        if (!cells[i].disabled) {
+            map[String(n)] = `${gamePrefix}:${sessionId}:${i}`;
+            n++;
+        }
+    }
+    return map;
+}
+/**
+ * 构建网格按钮键盘消息内容
+ */
+export function buildGridKeyboard(options) {
+    const { gamePrefix, sessionId, rows, cols, cells, statusLine, terminal, omitAsciiBoard, renderAscii, highlight, fallbackHint, postChoices, postChoicesProfile = 'terminal', channelType, } = options;
+    const buttonRows = [];
+    for (let r = 0; r < rows; r++) {
+        const row = [];
+        for (let c = 0; c < cols; c++) {
+            const i = r * cols + c;
+            const cell = cells[i];
+            row.push(segment.button({
+                id: `c${i}`,
+                label: cell.label,
+                payload: `${gamePrefix}:${sessionId}:${i}`,
+                disabled: terminal || cell.disabled,
+                style: cell.highlight ? 'primary' : 'secondary',
+            }));
+        }
+        buttonRows.push(row);
+    }
+    const fallback = buildGridFallbackMap(gamePrefix, sessionId, cells);
+    const textLines = [statusLine];
+    if (!omitAsciiBoard && renderAscii) {
+        textLines.push('', renderAscii(cells, rows, cols, highlight));
+    }
+    if (postChoices?.length) {
+        buttonRows.push(postChoices.map((choice) => {
+            const base = segment.button({
+                id: choice.id,
+                label: choice.label,
+                payload: `${gamePrefix}:${sessionId}:${choice.id}`,
+                disabled: choice.disabled ?? false,
+                style: choice.style ?? 'primary',
+            });
+            return segment.button(applyInteractionProfile(base.data, {
+                profile: postChoicesProfile,
+                channelType,
+            }));
+        }));
+        Object.assign(fallback, buildChoiceFallbackMap(gamePrefix, sessionId, postChoices));
+    }
+    const parts = [
+        segment.text(textLines.join('\n')),
+        segment.keyboard(buttonRows, {
+            fallback: fallbackHint || Object.keys(fallback).length > 0
+                ? {
+                    hint: fallbackHint ?? '回复数字选择',
+                    map: fallback,
+                }
+                : undefined,
+        }).toElement(),
+    ];
+    return parts;
+}
+/**
+ * 解析网格 payload：`{prefix}:{sessionId}:{cellIndex}`
+ */
+export function parseGridPayload(payload, expectedPrefix) {
+    const m = /^([a-z0-9_]+):([^:]+):(\d+)$/i.exec(payload);
+    if (!m)
+        return null;
+    const prefix = m[1];
+    if (expectedPrefix && prefix !== expectedPrefix)
+        return null;
+    const cell = Number(m[3]);
+    if (!Number.isInteger(cell) || cell < 0)
+        return null;
+    return { prefix, sessionId: m[2], cell };
+}
+/**
+ * 解析按钮 ID 格式：`c{cellIndex}`（QQ 等平台 action 可能只回传 button_id）
+ */
+export function parseCellButtonId(value) {
+    const m = /^c(\d+)$/.exec(value);
+    if (!m)
+        return null;
+    const cell = Number(m[1]);
+    if (!Number.isInteger(cell) || cell < 0)
+        return null;
+    return cell;
+}
+//# sourceMappingURL=grid-keyboard.js.map

package/lib/grid-keyboard.js.map

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

package/lib/help-card.d.ts

@@ -0,0 +1,12 @@
+import type { RegisteredGame } from './game-hub-feature.js';
+import { type CommandHelpSource } from './command-help.js';
+export declare const HELP_CARD_CANVAS: "#d8dce3";
+export declare const HELP_CARD_WIDTH = 560;
+export interface BotHelpCardInput {
+    games: readonly RegisteredGame[];
+    commands?: readonly CommandHelpSource[];
+    channelType?: string;
+}
+export declare function buildBotHelpHtml(input: BotHelpCardInput): string;
+export declare function buildHubHelpHtml(games: readonly RegisteredGame[], commands?: readonly CommandHelpSource[]): string;
+//# sourceMappingURL=help-card.d.ts.map

package/lib/help-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-card.d.ts","sourceRoot":"","sources":["../src/help-card.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,mBAAmB,CAAC;AAE3B,eAAO,MAAM,gBAAgB,WAA4B,CAAC;AAC1D,eAAO,MAAM,eAAe,MAAM,CAAC;AAsBnC,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IACjC,QAAQ,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CA+FhE;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,cAAc,EAAE,EAChC,QAAQ,CAAC,EAAE,SAAS,iBAAiB,EAAE,GACtC,MAAM,CAwCR"}