@zhin.js/plugin-tic-tac-toe 1.0.0

package/README.md

@@ -0,0 +1,36 @@
+# @zhin.js/plugin-tic-tac-toe
+
+跨平台井字棋插件，基于 Zhin.js **interactive 消息段**（按钮）与文本降级（1–9 落子）。
+
+## 安装
+
+```yaml
+plugins:
+  - "@zhin.js/plugin-tic-tac-toe"
+database:
+  dialect: sqlite
+  storage: ./data/zhin.db
+```
+
+## 命令
+
+| 命令 | 说明 |
+|------|------|
+| `ttt` | 帮助与频道状态 |
+| `ttt join` | 群聊排队，满 2 人开局 |
+| `ttt leave` | 离开排队 |
+| `ttt bot` | 人机对战 |
+| `ttt quit` | 认输 |
+| `ttt spectate` | 观战订阅 |
+
+## 交互
+
+- **Native 按钮**：Sandbox、Telegram、Discord、KOOK、Lark、QQ 系等（见 `interactivePolicy: native`）
+- **文本降级**：回复 `1`–`9` 落子（与按钮 `fallback.map` 一致）
+
+## 开发
+
+```bash
+pnpm --filter @zhin.js/plugin-tic-tac-toe build
+pnpm vitest run plugins/games/tic-tac-toe/tests
+```

package/lib/board-view.d.ts

@@ -0,0 +1,24 @@
+import type { SendContent } from 'zhin.js';
+import { channelKey } from '@zhin.js/game-shared';
+import { type Board, type Cell } from './engine.js';
+/** 游戏前缀（用于 payload） */
+export declare const TTT_PREFIX = "ttt";
+export { channelKey };
+export declare function buildBoardInteractive(options: {
+    sessionId: string;
+    board: Board;
+    statusLine: string;
+    turnMark: Cell;
+    terminal?: boolean;
+    omitAsciiBoard?: boolean;
+    highlight?: number[];
+}): SendContent;
+export declare function buildFallbackMap(sessionId: string, board: Board): Record<string, string>;
+export declare function parseTttPayload(payload: string): {
+    sessionId: string;
+    cell: number;
+} | null;
+/** QQ 等平台回调可能只带 button_id（如 c4），不含 ttt: 前缀 payload */
+export declare function parseCellButtonId(value: string): number | null;
+export declare function markName(mark: Cell): string;
+//# sourceMappingURL=board-view.d.ts.map

package/lib/board-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-view.d.ts","sourceRoot":"","sources":["../src/board-view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,WAAW,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAKL,UAAU,EAEX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAGL,KAAK,KAAK,EACV,KAAK,IAAI,EAIV,MAAM,aAAa,CAAC;AAErB,uBAAuB;AACvB,eAAO,MAAM,UAAU,QAAQ,CAAC;AAEhC,OAAO,EAAE,UAAU,EAAE,CAAC;AAwBtB,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,IAAI,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB,GAAG,WAAW,CAgBd;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAExF;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAK3F;AAED,sDAAsD;AACtD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI9D;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE3C"}

package/lib/board-view.js

@@ -0,0 +1,58 @@
+import { buildGridKeyboard, buildGridFallbackMap, parseGridPayload, parseCellButtonId as parseButtonId, channelKey, } from '@zhin.js/game-shared';
+import { asciiBoard, cellLabel, EMPTY, X, } from './engine.js';
+/** 游戏前缀（用于 payload） */
+export const TTT_PREFIX = 'ttt';
+export { channelKey };
+/** 将井字棋棋盘转为通用 GridCell 数组 */
+function boardToCells(board, highlight) {
+    const highlightSet = new Set(highlight ?? []);
+    return board.map((cell, i) => ({
+        state: cell,
+        label: cell === EMPTY ? '·' : cellLabel(cell),
+        disabled: cell !== EMPTY,
+        highlight: highlightSet.has(i),
+    }));
+}
+/** 井字棋 ASCII 棋盘渲染器（适配 GridCell） */
+function renderTttAscii(cells, rows, cols, highlight) {
+    const board = cells.map((c) => c.state);
+    return asciiBoard(board, highlight);
+}
+export function buildBoardInteractive(options) {
+    const { sessionId, board, statusLine, terminal, omitAsciiBoard, highlight } = options;
+    return buildGridKeyboard({
+        gamePrefix: TTT_PREFIX,
+        sessionId,
+        rows: 3,
+        cols: 3,
+        cells: boardToCells(board, highlight),
+        statusLine,
+        terminal,
+        omitAsciiBoard,
+        renderAscii: renderTttAscii,
+        highlight,
+        fallbackHint: '落子：回复数字 1-9（仅空格）',
+    });
+}
+export function buildFallbackMap(sessionId, board) {
+    return buildGridFallbackMap(TTT_PREFIX, sessionId, boardToCells(board));
+}
+export function parseTttPayload(payload) {
+    const result = parseGridPayload(payload, TTT_PREFIX);
+    if (!result)
+        return null;
+    if (result.cell > 8)
+        return null;
+    return { sessionId: result.sessionId, cell: result.cell };
+}
+/** QQ 等平台回调可能只带 button_id（如 c4），不含 ttt: 前缀 payload */
+export function parseCellButtonId(value) {
+    const cell = parseButtonId(value);
+    if (cell === null || cell > 8)
+        return null;
+    return cell;
+}
+export function markName(mark) {
+    return mark === X ? '✕' : '○';
+}
+//# sourceMappingURL=board-view.js.map

package/lib/board-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-view.js","sourceRoot":"","sources":["../src/board-view.ts"],"names":[],"mappings":"AACA,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,IAAI,aAAa,EAClC,UAAU,GAEX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,UAAU,EACV,SAAS,EAGT,KAAK,EACL,CAAC,GAEF,MAAM,aAAa,CAAC;AAErB,uBAAuB;AACvB,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,CAAC;AAEhC,OAAO,EAAE,UAAU,EAAE,CAAC;AAEtB,6BAA6B;AAC7B,SAAS,YAAY,CAAC,KAAY,EAAE,SAAoB;IACtD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IAC9C,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7B,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC;QAC7C,QAAQ,EAAE,IAAI,KAAK,KAAK;QACxB,SAAS,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;KAC/B,CAAC,CAAC,CAAC;AACN,CAAC;AAED,mCAAmC;AACnC,SAAS,cAAc,CACrB,KAAuB,EACvB,IAAY,EACZ,IAAY,EACZ,SAAoB;IAEpB,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACxC,OAAO,UAAU,CAAC,KAAc,EAAE,SAAS,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAQrC;IACC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAEtF,OAAO,iBAAiB,CAAC;QACvB,UAAU,EAAE,UAAU;QACtB,SAAS;QACT,IAAI,EAAE,CAAC;QACP,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC;QACrC,UAAU;QACV,QAAQ;QACR,cAAc;QACd,WAAW,EAAE,cAAc;QAC3B,SAAS;QACT,YAAY,EAAE,kBAAkB;KACjC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,SAAiB,EAAE,KAAY;IAC9D,OAAO,oBAAoB,CAAC,UAAU,EAAE,SAAS,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACrD,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,MAAM,CAAC,IAAI,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACjC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AAC5D,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAU;IACjC,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;AAChC,CAAC"}

package/lib/commands.d.ts

@@ -0,0 +1,6 @@
+import { type Plugin } from 'zhin.js';
+import type { SessionServices } from './session-service.js';
+export declare function registerCommands(plugin: Plugin, getServices: () => SessionServices | null): void;
+export declare function registerInteractive(plugin: Plugin, getServices: () => SessionServices | null): void;
+export declare function registerTextFallback(plugin: Plugin, getServices: () => SessionServices | null): void;
+//# sourceMappingURL=commands.d.ts.map

package/lib/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiD,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAMrF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAgE5D,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,eAAe,GAAG,IAAI,GACxC,IAAI,CAGN;AAgBD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,eAAe,GAAG,IAAI,GAAG,IAAI,CAGnG;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,eAAe,GAAG,IAAI,GAAG,IAAI,CA+BpG"}

package/lib/commands.js

@@ -0,0 +1,111 @@
+import { MessageCommand, getActionFromMessage } from 'zhin.js';
+import { channelKey, normalizeTttAction } from '@zhin.js/game-shared';
+import { buildFallbackMap } from './board-view.js';
+import { parseBoard } from './engine.js';
+import { handleMove } from './game-flow.js';
+import { runTttCommand } from './ttt-command.js';
+function actionPayload(message) {
+    return getActionFromMessage(message)?.payload;
+}
+/** @deprecated 使用 game-shared parseChoicePayload；保留 ttt 专用解析 */
+function parseTttPayload(payload) {
+    const m = /^ttt:([^:]+):(\d)$/.exec(payload);
+    if (!m)
+        return null;
+    return { sessionId: m[1], cell: Number(m[2]) };
+}
+function parseCellButtonId(id) {
+    const m = /^c(\d)$/.exec(id);
+    if (!m)
+        return null;
+    const cell = Number(m[1]);
+    return cell >= 0 && cell <= 8 ? cell : null;
+}
+async function resolveTttMove(message, services) {
+    const action = getActionFromMessage(message);
+    if (!action)
+        return null;
+    const fromPayload = parseTttPayload(action.payload);
+    if (fromPayload)
+        return fromPayload;
+    const cell = parseCellButtonId(action.payload)
+        ?? parseCellButtonId(action.id ?? '');
+    if (cell == null)
+        return null;
+    const ch = channelKey(message);
+    const session = await services.session.getActiveForUser(ch, message.$sender.id)
+        ?? (action.sourceMessageId
+            ? await services.session.getActiveByBoardMessageId(action.sourceMessageId)
+            : null);
+    if (!session || session.channel_key !== ch)
+        return null;
+    return { sessionId: session.id, cell };
+}
+function registerTttPattern(plugin, pattern, desc, getServices) {
+    plugin.addCommand(new MessageCommand(pattern)
+        .desc(desc)
+        .action(async (message, result) => {
+        const services = getServices();
+        if (!services)
+            return '井字棋需要启用 database 配置。';
+        const raw = result.params.action ?? '';
+        const action = normalizeTttAction(raw);
+        return runTttCommand(plugin, services, message, action);
+    }));
+}
+export function registerCommands(plugin, getServices) {
+    registerTttPattern(plugin, 'ttt [action:word]', '井字棋（ttt）', getServices);
+    registerTttPattern(plugin, '井字棋 [action:word]', '井字棋（中文）', getServices);
+}
+async function handleTttAction(plugin, getServices, message) {
+    const services = getServices();
+    if (!services)
+        return false;
+    const move = await resolveTttMove(message, services);
+    if (!move)
+        return false;
+    const err = await handleMove(plugin, services, message, move.sessionId, move.cell);
+    if (err)
+        await message.$reply?.(err);
+    return true;
+}
+export function registerInteractive(plugin, getServices) {
+    plugin.registerInteractiveHandler('ttt:', (message) => handleTttAction(plugin, getServices, message));
+    plugin.registerInteractiveHandler('c', (message) => handleTttAction(plugin, getServices, message));
+}
+export function registerTextFallback(plugin, getServices) {
+    plugin.addMiddleware(async (message, next) => {
+        const services = getServices();
+        if (!services)
+            return next();
+        const inboundAction = actionPayload(message);
+        if (inboundAction?.startsWith('ttt:'))
+            return next();
+        const ch = channelKey(message);
+        const session = await services.session.getActiveForUser(ch, message.$sender.id);
+        if (!session)
+            return next();
+        const raw = message.$raw?.trim() ?? '';
+        let cell = null;
+        const direct = parseTttPayload(raw.startsWith('ttt:') ? raw : '');
+        if (direct && direct.sessionId === session.id) {
+            cell = direct.cell;
+        }
+        else {
+            const n = /^(\d)$/.exec(raw);
+            if (n) {
+                const map = buildFallbackMap(session.id, parseBoard(session.board));
+                const payload = map[n[1]];
+                const p = payload ? parseTttPayload(payload) : null;
+                if (p?.sessionId === session.id)
+                    cell = p.cell;
+            }
+        }
+        if (cell == null)
+            return next();
+        const err = await handleMove(plugin, services, message, session.id, cell);
+        if (err)
+            await message.$reply?.(err);
+    });
+}
+//# sourceMappingURL=commands.js.map

package/lib/commands.js.map

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

package/lib/engine.d.ts

@@ -0,0 +1,25 @@
+export declare const EMPTY = 0;
+export declare const X = 1;
+export declare const O = 2;
+export type Cell = typeof EMPTY | typeof X | typeof O;
+export type Board = Cell[];
+export type GameStatus = 'active' | 'won' | 'draw' | 'aborted';
+export declare function emptyBoard(): Board;
+export declare function parseBoard(raw: string | number[] | null | undefined): Board;
+export declare function cellLabel(cell: Cell): string;
+export declare function asciiBoard(board: Board, highlight?: number[]): string;
+export declare function checkWinner(board: Board): {
+    winner: Cell;
+    line: number[];
+} | null;
+export declare function isDraw(board: Board): boolean;
+export declare function validMove(board: Board, cell: number): boolean;
+export declare function applyMove(board: Board, cell: number, player: Cell): Board;
+export declare function opponent(player: Cell): Cell;
+/** Minimax for tic-tac-toe (O = AI by default when aiPlays O) */
+export declare function bestMove(board: Board, ai?: Cell): number;
+export declare function playerMark(playerId: string, session: {
+    playerX: string;
+    playerO: string;
+}): Cell | null;
+//# sourceMappingURL=engine.d.ts.map

package/lib/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,KAAK,IAAI,CAAC;AACvB,eAAO,MAAM,CAAC,IAAI,CAAC;AACnB,eAAO,MAAM,CAAC,IAAI,CAAC;AAEnB,MAAM,MAAM,IAAI,GAAG,OAAO,KAAK,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC;AACtD,MAAM,MAAM,KAAK,GAAG,IAAI,EAAE,CAAC;AAE3B,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;AAQ/D,wBAAgB,UAAU,IAAI,KAAK,CAElC;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,CAa3E;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAI5C;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAYrE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CASjF;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAE5C;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,GAAG,KAAK,CAKzE;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI,CAE3C;AAED,iEAAiE;AACjE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,GAAE,IAAQ,GAAG,MAAM,CAe3D;AA0BD,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAAG,IAAI,CAIvG"}

package/lib/engine.js

@@ -0,0 +1,117 @@
+export const EMPTY = 0;
+export const X = 1;
+export const O = 2;
+const WIN_LINES = [
+    [0, 1, 2], [3, 4, 5], [6, 7, 8],
+    [0, 3, 6], [1, 4, 7], [2, 5, 8],
+    [0, 4, 8], [2, 4, 6],
+];
+export function emptyBoard() {
+    return Array(9).fill(EMPTY);
+}
+export function parseBoard(raw) {
+    if (Array.isArray(raw))
+        return raw.map((v) => Number(v));
+    if (typeof raw === 'string') {
+        try {
+            const parsed = JSON.parse(raw);
+            if (Array.isArray(parsed) && parsed.length === 9) {
+                return parsed.map((v) => Number(v));
+            }
+        }
+        catch {
+            // fall through
+        }
+    }
+    return emptyBoard();
+}
+export function cellLabel(cell) {
+    if (cell === X)
+        return '✕';
+    if (cell === O)
+        return '○';
+    return '·';
+}
+export function asciiBoard(board, highlight) {
+    const mark = (i) => {
+        const base = cellLabel(board[i]);
+        return highlight?.includes(i) ? `[${base}]` : ` ${base} `;
+    };
+    return [
+        `${mark(0)}|${mark(1)}|${mark(2)}`,
+        '-+-+-',
+        `${mark(3)}|${mark(4)}|${mark(5)}`,
+        '-+-+-',
+        `${mark(6)}|${mark(7)}|${mark(8)}`,
+    ].join('\n');
+}
+export function checkWinner(board) {
+    for (const line of WIN_LINES) {
+        const [a, b, c] = line;
+        const v = board[a];
+        if (v !== EMPTY && v === board[b] && v === board[c]) {
+            return { winner: v, line };
+        }
+    }
+    return null;
+}
+export function isDraw(board) {
+    return board.every((c) => c !== EMPTY) && !checkWinner(board);
+}
+export function validMove(board, cell) {
+    return Number.isInteger(cell) && cell >= 0 && cell < 9 && board[cell] === EMPTY;
+}
+export function applyMove(board, cell, player) {
+    if (!validMove(board, cell))
+        throw new Error('invalid move');
+    const next = [...board];
+    next[cell] = player;
+    return next;
+}
+export function opponent(player) {
+    return player === X ? O : X;
+}
+/** Minimax for tic-tac-toe (O = AI by default when aiPlays O) */
+export function bestMove(board, ai = O) {
+    const human = opponent(ai);
+    let bestScore = -Infinity;
+    let move = -1;
+    for (let i = 0; i < 9; i++) {
+        if (board[i] !== EMPTY)
+            continue;
+        const next = applyMove(board, i, ai);
+        const score = minimax(next, 0, false, ai, human);
+        if (score > bestScore) {
+            bestScore = score;
+            move = i;
+        }
+    }
+    return move;
+}
+function minimax(board, depth, isAi, ai, human) {
+    const win = checkWinner(board);
+    if (win?.winner === ai)
+        return 10 - depth;
+    if (win?.winner === human)
+        return depth - 10;
+    if (isDraw(board))
+        return 0;
+    const player = isAi ? ai : human;
+    let best = isAi ? -Infinity : Infinity;
+    for (let i = 0; i < 9; i++) {
+        if (board[i] !== EMPTY)
+            continue;
+        const next = applyMove(board, i, player);
+        const score = minimax(next, depth + 1, !isAi, ai, human);
+        best = isAi ? Math.max(best, score) : Math.min(best, score);
+    }
+    return best;
+}
+export function playerMark(playerId, session) {
+    if (playerId === session.playerX)
+        return X;
+    if (playerId === session.playerO)
+        return O;
+    return null;
+}
+//# sourceMappingURL=engine.js.map

package/lib/engine.js.map

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

package/lib/game-flow.d.ts

@@ -0,0 +1,11 @@
+import type { Message, Plugin } from 'zhin.js';
+import type { TttSessionRow } from './models.js';
+import { BOT_ID } from './player-label.js';
+import type { SessionServices, TttPlayerRef } from './session-service.js';
+export { BOT_ID };
+export declare function isBotSession(session: TttSessionRow): boolean;
+export declare function sendOrEditBoard(plugin: Plugin, services: SessionServices, message: Message<any>, session: TttSessionRow, statusLine: string, terminal?: boolean, highlight?: number[]): Promise<string>;
+export declare function handleMove(plugin: Plugin, services: SessionServices, message: Message<any>, sessionId: string, cell: number): Promise<string | null>;
+export declare function startBotGame(plugin: Plugin, services: SessionServices, message: Message<any>): Promise<string>;
+export declare function startPvpGame(plugin: Plugin, services: SessionServices, message: Message<any>, playerX: TttPlayerRef, playerO: TttPlayerRef): Promise<void>;
+//# sourceMappingURL=game-flow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"game-flow.d.ts","sourceRoot":"","sources":["../src/game-flow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAejD,OAAO,EACL,MAAM,EAOP,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAE1E,OAAO,EAAE,MAAM,EAAE,CAAC;AAElB,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAE5D;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,EACrB,OAAO,EAAE,aAAa,EACtB,UAAU,EAAE,MAAM,EAClB,QAAQ,UAAQ,EAChB,SAAS,CAAC,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,MAAM,CAAC,CAkCjB;AAUD,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,EACrB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA+DxB;AAqBD,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,GACpB,OAAO,CAAC,MAAM,CAAC,CAiBjB;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,EACrB,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,IAAI,CAAC,CAYf"}

package/lib/game-flow.js

@@ -0,0 +1,143 @@
+import { buildBoardInteractive } from './board-view.js';
+import { applyMove, bestMove, checkWinner, isDraw, parseBoard, playerMark, validMove, X, O, cellLabel, } from './engine.js';
+import { BOT_ID, formatPlayerWithMark, formatRosterLine, formatTurnStatus, formatWinHeadline, playerRefForMark, senderDisplayName, } from './player-label.js';
+export { BOT_ID };
+export function isBotSession(session) {
+    return session.player_o === BOT_ID || session.player_x === BOT_ID;
+}
+export async function sendOrEditBoard(plugin, services, message, session, statusLine, terminal = false, highlight) {
+    const board = parseBoard(session.board);
+    const content = buildBoardInteractive({
+        sessionId: session.id,
+        board,
+        statusLine,
+        turnMark: session.turn,
+        terminal,
+        omitAsciiBoard: message.$adapter === 'qq',
+        highlight,
+    });
+    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.session.updateSession(session.id, { board_message_id: msgId });
+        }
+        return msgId;
+    }
+    const msgId = await message.$reply?.(content);
+    if (msgId) {
+        await services.session.updateSession(session.id, { board_message_id: msgId });
+    }
+    return msgId ?? '';
+}
+function turnCell(session) {
+    return session.turn === 1 ? X : O;
+}
+function playerIdForTurn(session) {
+    return session.turn === 1 ? session.player_x : session.player_o;
+}
+export async function handleMove(plugin, services, message, sessionId, cell) {
+    const session = await services.session.getById(sessionId);
+    if (!session || session.status !== 'active') {
+        return '对局不存在或已结束。';
+    }
+    if (session.channel_key !== `${message.$adapter}-${message.$endpoint}-${message.$channel.type}:${message.$channel.id}`) {
+        return '请在开局频道落子。';
+    }
+    const mark = playerMark(message.$sender.id, {
+        playerX: session.player_x,
+        playerO: session.player_o,
+    });
+    if (!mark) {
+        return '你不是本局玩家。';
+    }
+    if (mark !== turnCell(session)) {
+        const turn = turnCell(session);
+        const { id, name } = playerRefForMark(session, turn);
+        return `还没轮到你（当前轮到 ${formatPlayerWithMark(id, name, cellLabel(turn))}）。`;
+    }
+    const board = parseBoard(session.board);
+    if (!validMove(board, cell)) {
+        return '该位置不可落子。';
+    }
+    const nextBoard = applyMove(board, cell, mark);
+    const win = checkWinner(nextBoard);
+    const draw = !win && isDraw(nextBoard);
+    const moveCount = session.move_count + 1;
+    await services.session.recordMove(session.id, message.$sender.id, cell, moveCount);
+    await services.session.updateSession(session.id, {
+        board: JSON.stringify(nextBoard),
+        move_count: moveCount,
+        turn: session.turn === 1 ? 2 : 1,
+        status: win ? 'won' : draw ? 'draw' : 'active',
+        winner: win ? win.winner : 0,
+    });
+    const updated = (await services.session.getById(session.id));
+    if (win) {
+        const status = formatWinHeadline(updated, win.winner);
+        await sendOrEditBoard(plugin, services, message, updated, status, true, win.line);
+        return null;
+    }
+    if (draw) {
+        await sendOrEditBoard(plugin, services, message, updated, '平局。', true);
+        return null;
+    }
+    // 人机：玩家落子后立刻由服务端代下，避免先发「轮到机器人」再发终盘（QQ 被动消息多耗一次）
+    if (isBotSession(updated) && playerIdForTurn(updated) === BOT_ID) {
+        await runBotMove(plugin, services, message, updated);
+        return null;
+    }
+    const status = formatTurnStatus(updated, moveCount);
+    await sendOrEditBoard(plugin, services, message, updated, status, false);
+    return null;
+}
+async function runBotMove(plugin, services, message, session) {
+    const board = parseBoard(session.board);
+    const aiMark = session.player_o === BOT_ID ? O : X;
+    const cell = bestMove(board, aiMark);
+    if (cell < 0)
+        return;
+    const fakeMessage = {
+        ...message,
+        $sender: { ...message.$sender, id: BOT_ID, name: '机器人' },
+    };
+    await handleMove(plugin, services, fakeMessage, session.id, cell);
+}
+export async function startBotGame(plugin, services, message) {
+    const ch = `${message.$adapter}-${message.$endpoint}-${message.$channel.type}:${message.$channel.id}`;
+    const active = await services.session.getActiveByChannel(ch);
+    if (active)
+        return '当前频道已有进行中的对局。';
+    const session = await services.session.createSession({
+        message,
+        playerX: message.$sender.id,
+        playerO: BOT_ID,
+        playerXName: senderDisplayName(message.$sender),
+        playerOName: '机器人',
+        boardJson: JSON.stringify([0, 0, 0, 0, 0, 0, 0, 0, 0]),
+    });
+    const status = `${formatRosterLine(session)} · 你先手 (✕)`;
+    await sendOrEditBoard(plugin, services, message, session, status, false);
+    return '开局成功！点击棋盘或回复数字落子。';
+}
+export async function startPvpGame(plugin, services, message, playerX, playerO) {
+    const session = await services.session.createSession({
+        message,
+        playerX: playerX.id,
+        playerO: playerO.id,
+        playerXName: playerX.displayName,
+        playerOName: playerO.displayName,
+        boardJson: JSON.stringify([0, 0, 0, 0, 0, 0, 0, 0, 0]),
+    });
+    const opener = formatPlayerWithMark(session.player_x, session.player_x_name, '✕');
+    const status = `${formatRosterLine(session)} · 先手：${opener}`;
+    await sendOrEditBoard(plugin, services, message, session, status, false);
+}
+//# sourceMappingURL=game-flow.js.map

package/lib/game-flow.js.map

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

package/lib/hub-register.d.ts

@@ -0,0 +1,5 @@
+import { TTT_HELP } from './ttt-command.js';
+import type { SessionServices } from './session-service.js';
+export declare function registerTttHub(getServices: () => SessionServices | null): () => void;
+export { TTT_HELP };
+//# sourceMappingURL=hub-register.d.ts.map

package/lib/hub-register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub-register.d.ts","sourceRoot":"","sources":["../src/hub-register.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,eAAe,GAAG,IAAI,GAAG,MAAM,IAAI,CAuBpF;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/lib/hub-register.js

@@ -0,0 +1,30 @@
+import { getPlugin } from 'zhin.js';
+import { ensureGameHubService } from '@zhin.js/game-shared';
+import { runTttCommand, TTT_HELP } from './ttt-command.js';
+export function registerTttHub(getServices) {
+    const plugin = getPlugin();
+    ensureGameHubService(plugin);
+    return plugin.registerGame({
+        id: 'ttt',
+        title: '井字棋',
+        icon: '♟️',
+        description: '三子连珠，群聊排队或人机对战',
+        commandPrefix: '井字棋',
+        quickStart: '人机',
+        aliases: ['ttt'],
+        menus: [
+            { id: 'bot', label: '🤖 人机对战', style: 'primary' },
+            { id: 'join', label: '👥 加入排队', groupOnly: true },
+            { id: 'spectate', label: '👀 观战', groupOnly: true },
+            { id: 'help', label: '📖 玩法说明' },
+        ],
+        runAction: async (actionId, ctx) => {
+            const services = getServices();
+            if (!services)
+                return '井字棋需要启用 database 配置。';
+            return runTttCommand(ctx.plugin, services, ctx.message, actionId);
+        },
+    });
+}
+export { TTT_HELP };
+//# sourceMappingURL=hub-register.js.map

package/lib/hub-register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub-register.js","sourceRoot":"","sources":["../src/hub-register.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG3D,MAAM,UAAU,cAAc,CAAC,WAAyC;IACtE,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,OAAO,MAAM,CAAC,YAAY,CAAC;QACzB,EAAE,EAAE,KAAK;QACT,KAAK,EAAE,KAAK;QACZ,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,gBAAgB;QAC7B,aAAa,EAAE,KAAK;QACpB,UAAU,EAAE,IAAI;QAChB,OAAO,EAAE,CAAC,KAAK,CAAC;QAChB,KAAK,EAAE;YACL,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;YACjD,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE;YACjD,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE;YACnD,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE;SACjC;QACD,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE;YACjC,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;YAC/B,IAAI,CAAC,QAAQ;gBAAE,OAAO,sBAAsB,CAAC;YAC7C,OAAO,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACpE,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map