@zhin.js/plugin-guess-number 1.0.0

package/lib/commands.d.ts

@@ -0,0 +1,5 @@
+import { type Plugin } from 'zhin.js';
+import type { SessionService } from './session-service.js';
+export declare function registerCommands(plugin: Plugin, getServices: () => SessionService | null): void;
+export declare function registerGuessMiddleware(plugin: Plugin, getServices: () => SessionService | 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,EAA2B,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAI/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAoB3D,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,cAAc,GAAG,IAAI,GAAG,IAAI,CAG/F;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,cAAc,GAAG,IAAI,GAAG,IAAI,CAgBtG"}

package/lib/commands.js

@@ -0,0 +1,38 @@
+import { MessageCommand } from 'zhin.js';
+import { channelKey, normalizeGuessAction, registerGameTextMiddleware } from '@zhin.js/game-shared';
+import { processGuess } from './game-flow.js';
+import { runGuessCommand } from './guess-command.js';
+function registerPattern(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 ?? '';
+        return runGuessCommand(services, message, normalizeGuessAction(raw));
+    }));
+}
+export function registerCommands(plugin, getServices) {
+    registerPattern(plugin, 'guess [action:word]', '猜数字（guess）', getServices);
+    registerPattern(plugin, '猜数 [action:word]', '猜数字（中文）', getServices);
+}
+export function registerGuessMiddleware(plugin, getServices) {
+    registerGameTextMiddleware(plugin, async (message, next) => {
+        const services = getServices();
+        if (!services)
+            return next();
+        const raw = message.$raw?.trim() ?? '';
+        const m = /^(\d+)$/.exec(raw);
+        if (!m)
+            return next();
+        const ch = channelKey(message);
+        const session = await services.getActiveForUser(ch, message.$sender.id);
+        if (!session)
+            return next();
+        const reply = await processGuess(services, message, Number(m[1]));
+        if (reply)
+            await message.$reply?.(reply);
+    }, 'guess-number:text');
+}
+//# sourceMappingURL=commands.js.map

package/lib/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,cAAc,EAAe,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AACpG,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD,SAAS,eAAe,CACtB,MAAc,EACd,OAAe,EACf,IAAY,EACZ,WAAwC;IAExC,MAAM,CAAC,UAAU,CACf,IAAI,cAAc,CAAC,OAAO,CAAC;SACxB,IAAI,CAAC,IAAI,CAAC;SACV,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE;QAChC,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;QAC/B,IAAI,CAAC,QAAQ;YAAE,OAAO,sBAAsB,CAAC;QAC7C,MAAM,GAAG,GAAI,MAAM,CAAC,MAAM,CAAC,MAA6B,IAAI,EAAE,CAAC;QAC/D,OAAO,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC;IACvE,CAAC,CAAC,CACL,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,WAAwC;IACvF,eAAe,CAAC,MAAM,EAAE,qBAAqB,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;IAC1E,eAAe,CAAC,MAAM,EAAE,kBAAkB,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAc,EAAE,WAAwC;IAC9F,0BAA0B,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;QACzD,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;QAC/B,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,EAAE,CAAC;QAE7B,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACvC,MAAM,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,CAAC;YAAE,OAAO,IAAI,EAAE,CAAC;QAEtB,MAAM,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;QAC/B,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,gBAAgB,CAAC,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACxE,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,EAAE,CAAC;QAE5B,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAClE,IAAI,KAAK;YAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC,EAAE,mBAAmB,CAAC,CAAC;AAC1B,CAAC"}

package/lib/engine.d.ts

@@ -0,0 +1,9 @@
+export declare const GUESS_PREFIX = "guess";
+export declare const MIN = 1;
+export declare const MAX = 100;
+export declare const MAX_ATTEMPTS = 7;
+export type GuessResult = 'win' | 'low' | 'high' | 'invalid';
+export declare function newSecret(): number;
+export declare function evaluateGuess(secret: number, value: number): GuessResult;
+export declare function hintText(result: Exclude<GuessResult, 'win' | 'invalid'>, rangeMin: number, rangeMax: number): string;
+//# 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,YAAY,UAAU,CAAC;AACpC,eAAO,MAAM,GAAG,IAAI,CAAC;AACrB,eAAO,MAAM,GAAG,MAAM,CAAC;AACvB,eAAO,MAAM,YAAY,IAAI,CAAC;AAE9B,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;AAE7D,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAIxE;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,KAAK,GAAG,SAAS,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGpH"}

package/lib/engine.js

@@ -0,0 +1,20 @@
+export const GUESS_PREFIX = 'guess';
+export const MIN = 1;
+export const MAX = 100;
+export const MAX_ATTEMPTS = 7;
+export function newSecret() {
+    return MIN + Math.floor(Math.random() * (MAX - MIN + 1));
+}
+export function evaluateGuess(secret, value) {
+    if (!Number.isInteger(value) || value < MIN || value > MAX)
+        return 'invalid';
+    if (value === secret)
+        return 'win';
+    return value < secret ? 'low' : 'high';
+}
+export function hintText(result, rangeMin, rangeMax) {
+    if (result === 'low')
+        return `📈 **太小了！** 范围 ${rangeMin} ~ ${rangeMax}`;
+    return `📉 **太大了！** 范围 ${rangeMin} ~ ${rangeMax}`;
+}
+//# sourceMappingURL=engine.js.map

package/lib/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC;AACpC,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;AACrB,MAAM,CAAC,MAAM,GAAG,GAAG,GAAG,CAAC;AACvB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC;AAI9B,MAAM,UAAU,SAAS;IACvB,OAAO,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,KAAa;IACzD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,GAAG,IAAI,KAAK,GAAG,GAAG;QAAE,OAAO,SAAS,CAAC;IAC7E,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IACnC,OAAO,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAA+C,EAAE,QAAgB,EAAE,QAAgB;IAC1G,IAAI,MAAM,KAAK,KAAK;QAAE,OAAO,kBAAkB,QAAQ,MAAM,QAAQ,EAAE,CAAC;IACxE,OAAO,kBAAkB,QAAQ,MAAM,QAAQ,EAAE,CAAC;AACpD,CAAC"}

package/lib/game-flow.d.ts

@@ -0,0 +1,5 @@
+import type { Message } from 'zhin.js';
+import type { SessionService } from './session-service.js';
+export declare function startGame(services: SessionService, message: Message<any>): Promise<string>;
+export declare function processGuess(services: SessionService, message: Message<any>, value: number): Promise<string | null>;
+//# 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,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,GACpB,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED,wBAAsB,YAAY,CAChC,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,EACrB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA6CxB"}

package/lib/game-flow.js

@@ -0,0 +1,54 @@
+import { evaluateGuess, hintText, MAX, MIN } from './engine.js';
+import { formatStatus } from './session-service.js';
+export async function startGame(services, message) {
+    const ch = `${message.$adapter}-${message.$endpoint}-${message.$channel.type}:${message.$channel.id}`;
+    const mine = await services.getActiveForUser(ch, message.$sender.id);
+    if (mine) {
+        return `${formatStatus(mine)}\n\n（你已有进行中的局，继续猜数字，或发送「猜数 放弃」）`;
+    }
+    const session = await services.createSession(message);
+    return formatStatus(session);
+}
+export async function processGuess(services, message, value) {
+    const ch = `${message.$adapter}-${message.$endpoint}-${message.$channel.type}:${message.$channel.id}`;
+    const session = await services.getActiveForUser(ch, message.$sender.id);
+    if (!session)
+        return null;
+    const result = evaluateGuess(session.secret, value);
+    if (result === 'invalid') {
+        return `请输入 ${MIN} ~ ${MAX} 之间的整数。`;
+    }
+    const attempts = session.attempts + 1;
+    if (result === 'win') {
+        await services.updateSession(session.id, { attempts, status: 'won' });
+        return [
+            '🎉 **猜对了！**',
+            '',
+            `答案就是 **${session.secret}**，你用了 ${attempts} 次。`,
+            '发送「猜数 开始」再来一局。',
+        ].join('\n');
+    }
+    if (attempts >= session.max_attempts) {
+        await services.updateSession(session.id, { attempts, status: 'lost' });
+        return [
+            '💀 **机会用完了！**',
+            '',
+            `正确答案是 **${session.secret}**。`,
+            '发送「猜数 开始」再来一局。',
+        ].join('\n');
+    }
+    let rangeMin = session.range_min;
+    let rangeMax = session.range_max;
+    if (result === 'low')
+        rangeMin = Math.max(rangeMin, value + 1);
+    else
+        rangeMax = Math.min(rangeMax, value - 1);
+    await services.updateSession(session.id, { attempts, range_min: rangeMin, range_max: rangeMax });
+    const left = session.max_attempts - attempts;
+    return [
+        hintText(result, rangeMin, rangeMax),
+        '',
+        `剩余 **${left}** 次机会，继续猜吧！`,
+    ].join('\n');
+}
+//# 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/guess-command.d.ts

@@ -0,0 +1,5 @@
+import type { Message } from 'zhin.js';
+import { type SessionService } from './session-service.js';
+export declare const GUESS_HELP: string;
+export declare function runGuessCommand(services: SessionService, message: Message<any>, action: string): Promise<string>;
+//# sourceMappingURL=guess-command.d.ts.map

package/lib/guess-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guess-command.d.ts","sourceRoot":"","sources":["../src/guess-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAU,MAAM,SAAS,CAAC;AAG/C,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEzE,eAAO,MAAM,UAAU,QAOX,CAAC;AAEb,wBAAsB,eAAe,CACnC,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAyBjB"}

package/lib/guess-command.js

@@ -0,0 +1,37 @@
+import { channelKey } from '@zhin.js/game-shared';
+import { startGame } from './game-flow.js';
+import { formatStatus } from './session-service.js';
+export const GUESS_HELP = [
+    '🔢 猜数字（1~100，7 次机会）',
+    '猜数 / guess — 帮助',
+    '猜数 开始 — 新一局',
+    '猜数 放弃 — 结束当前局',
+    '',
+    '进行中直接回复数字即可。',
+].join('\n');
+export async function runGuessCommand(services, message, action) {
+    const ch = channelKey(message);
+    const userId = message.$sender.id;
+    if (!action || action === 'help') {
+        const active = await services.getActiveForUser(ch, userId);
+        const lines = [GUESS_HELP, ''];
+        if (active) {
+            lines.push(formatStatus(active));
+        }
+        else {
+            lines.push('暂无对局，发送「猜数 开始」。');
+        }
+        return lines.join('\n');
+    }
+    if (action === 'start')
+        return startGame(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${GUESS_HELP}`;
+}
+//# sourceMappingURL=guess-command.js.map

package/lib/guess-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guess-command.js","sourceRoot":"","sources":["../src/guess-command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAuB,MAAM,sBAAsB,CAAC;AAEzE,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,qBAAqB;IACrB,iBAAiB;IACjB,aAAa;IACb,eAAe;IACf,EAAE;IACF,cAAc;CACf,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,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,gBAAgB,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC3D,MAAM,KAAK,GAAG,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAC/B,IAAI,MAAM,EAAE,CAAC;YACX,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAE5D,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,aAAa,CAAC;QAC/B,MAAM,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QAC5D,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,OAAO,SAAS,MAAM,OAAO,UAAU,EAAE,CAAC;AAC5C,CAAC"}

package/lib/hub-register.d.ts

@@ -0,0 +1,5 @@
+import { GUESS_HELP } from './guess-command.js';
+import type { SessionService } from './session-service.js';
+export declare function registerGuessHub(getServices: () => SessionService | null): () => void;
+export { GUESS_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,EAAmB,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,cAAc,GAAG,IAAI,GAAG,MAAM,IAAI,CAqBrF;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/lib/hub-register.js

@@ -0,0 +1,28 @@
+import { getPlugin } from 'zhin.js';
+import { ensureGameHubService } from '@zhin.js/game-shared';
+import { runGuessCommand, GUESS_HELP } from './guess-command.js';
+export function registerGuessHub(getServices) {
+    const plugin = getPlugin();
+    ensureGameHubService(plugin);
+    return plugin.registerGame({
+        id: 'guess',
+        title: '猜数字',
+        icon: '🔢',
+        description: '1~100 七步猜中神秘数',
+        commandPrefix: '猜数',
+        quickStart: '开始',
+        aliases: ['guess'],
+        menus: [
+            { id: 'start', label: '🎮 开始新局', style: 'primary' },
+            { id: 'help', label: '📖 玩法说明' },
+        ],
+        runAction: async (actionId, ctx) => {
+            const services = getServices();
+            if (!services)
+                return '猜数字需要启用 database 配置。';
+            return runGuessCommand(services, ctx.message, actionId);
+        },
+    });
+}
+export { GUESS_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,eAAe,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGjE,MAAM,UAAU,gBAAgB,CAAC,WAAwC;IACvE,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,OAAO,MAAM,CAAC,YAAY,CAAC;QACzB,EAAE,EAAE,OAAO;QACX,KAAK,EAAE,KAAK;QACZ,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,eAAe;QAC5B,aAAa,EAAE,IAAI;QACnB,UAAU,EAAE,IAAI;QAChB,OAAO,EAAE,CAAC,OAAO,CAAC;QAClB,KAAK,EAAE;YACL,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,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,eAAe,CAAC,QAAQ,EAAE,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC1D,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/lib/index.d.ts

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

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/lib/index.js

@@ -0,0 +1,25 @@
+import { Cron, formatCompact, usePlugin } from 'zhin.js';
+import { registerModels } from './models.js';
+import { createServices, resolveGameDatabase, } from './session-service.js';
+import { registerCommands, registerGuessMiddleware } from './commands.js';
+import { registerGuessHub } from './hub-register.js';
+const plugin = usePlugin();
+const { logger, useContext, addCron } = plugin;
+registerModels(plugin);
+let services = null;
+useContext('database', (dbFeature) => {
+    services = createServices(resolveGameDatabase(dbFeature));
+    logger.info(formatCompact({ 模块: '猜数字', 数据模型: '已就绪' }));
+});
+registerGuessHub(() => services);
+registerCommands(plugin, () => services);
+registerGuessMiddleware(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({ 模块: '猜数字', 状态: '已加载' }));
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAwB,MAAM,SAAS,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EACL,cAAc,EACd,mBAAmB,GAEpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;AAC3B,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;AAE/C,cAAc,CAAC,MAAM,CAAC,CAAC;AAEvB,IAAI,QAAQ,GAA0B,IAAI,CAAC;AAE3C,UAAU,CAAC,UAAU,EAAE,CAAC,SAA0B,EAAE,EAAE;IACpD,QAAQ,GAAG,cAAc,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC;IAC1D,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;AACzD,CAAC,CAAC,CAAC;AAEH,gBAAgB,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC;AACjC,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC;AACzC,uBAAuB,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC;AAEhD,OAAO,CACL,IAAI,IAAI,CAAC,gBAAgB,EAAE,KAAK,IAAI,EAAE;IACpC,IAAI,CAAC,QAAQ;QAAE,OAAO;IACtB,MAAM,CAAC,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IACpD,IAAI,CAAC,GAAG,CAAC;QAAE,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACrE,CAAC,CAAC,CACH,CAAC;AAEF,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC"}

package/lib/models.d.ts

@@ -0,0 +1,27 @@
+import type { Models, Plugin } from 'zhin.js';
+export type GuessSessionStatus = 'active' | 'won' | 'lost' | 'aborted';
+declare module 'zhin.js' {
+    interface Models {
+        guess_sessions: {
+            id: string;
+            adapter: string;
+            endpoint: string;
+            channel_type: string;
+            channel_id: string;
+            channel_key: string;
+            player_id: string;
+            player_name: string;
+            secret: number;
+            range_min: number;
+            range_max: number;
+            attempts: number;
+            max_attempts: number;
+            status: GuessSessionStatus;
+            updated_at: number;
+            created_at: number;
+        };
+    }
+}
+export type GuessSessionRow = Models['guess_sessions'];
+export declare function registerModels(plugin: Plugin): void;
+//# sourceMappingURL=models.d.ts.map

package/lib/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAE9C,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;AAEvE,OAAO,QAAQ,SAAS,CAAC;IACvB,UAAU,MAAM;QACd,cAAc,EAAE;YACd,EAAE,EAAE,MAAM,CAAC;YACX,OAAO,EAAE,MAAM,CAAC;YAChB,QAAQ,EAAE,MAAM,CAAC;YACjB,YAAY,EAAE,MAAM,CAAC;YACrB,UAAU,EAAE,MAAM,CAAC;YACnB,WAAW,EAAE,MAAM,CAAC;YACpB,SAAS,EAAE,MAAM,CAAC;YAClB,WAAW,EAAE,MAAM,CAAC;YACpB,MAAM,EAAE,MAAM,CAAC;YACf,SAAS,EAAE,MAAM,CAAC;YAClB,SAAS,EAAE,MAAM,CAAC;YAClB,QAAQ,EAAE,MAAM,CAAC;YACjB,YAAY,EAAE,MAAM,CAAC;YACrB,MAAM,EAAE,kBAAkB,CAAC;YAC3B,UAAU,EAAE,MAAM,CAAC;YACnB,UAAU,EAAE,MAAM,CAAC;SACpB,CAAC;KACH;CACF;AAED,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAEvD,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAmBnD"}

package/lib/models.js

@@ -0,0 +1,21 @@
+export function registerModels(plugin) {
+    plugin.defineModel('guess_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: '' },
+        secret: { type: 'integer', nullable: false },
+        range_min: { type: 'integer', default: 1 },
+        range_max: { type: 'integer', default: 100 },
+        attempts: { type: 'integer', default: 0 },
+        max_attempts: { type: 'integer', default: 7 },
+        status: { type: 'text', default: 'active' },
+        updated_at: { type: 'integer', default: 0 },
+        created_at: { type: 'integer', default: 0 },
+    });
+}
+//# sourceMappingURL=models.js.map

package/lib/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AA6BA,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,MAAM,CAAC,WAAW,CAAC,gBAAgB,EAAE;QACnC,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,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE;QAC5C,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;QAC1C,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE;QAC5C,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;QACzC,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;QAC7C,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/session-service.d.ts

@@ -0,0 +1,17 @@
+import type { Database, DatabaseFeature, Message, Models } from 'zhin.js';
+import type { GuessSessionRow } from './models.js';
+export type GuessDatabase = Database<unknown, Models, string>;
+export declare class SessionService {
+    private readonly db;
+    constructor(db: GuessDatabase);
+    getActiveByChannel(channel: string): Promise<GuessSessionRow | null>;
+    getActiveForUser(channel: string, userId: string): Promise<GuessSessionRow | null>;
+    getById(id: string): Promise<GuessSessionRow | null>;
+    createSession(message: Message<any>): Promise<GuessSessionRow>;
+    updateSession(id: string, patch: Partial<GuessSessionRow>): Promise<void>;
+    abortStale(idleMs: number): Promise<number>;
+}
+export declare function createServices(db: GuessDatabase): SessionService;
+export declare function resolveGameDatabase(feature: DatabaseFeature): GuessDatabase;
+export declare function formatStatus(session: GuessSessionRow): string;
+//# sourceMappingURL=session-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-service.d.ts","sourceRoot":"","sources":["../src/session-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAgB,MAAM,SAAS,CAAC;AAGxF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAQ9D,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,aAAa;IAExC,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAKpE,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IASlF,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAIpD,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC;IAwB9D,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzE,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAalD;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,aAAa,GAAG,cAAc,CAEhE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,aAAa,CAE3E;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAU7D"}

package/lib/session-service.js

@@ -0,0 +1,86 @@
+import { channelKey, generateSessionId } from '@zhin.js/game-shared';
+import { MAX, MAX_ATTEMPTS, MIN, newSecret } from './engine.js';
+function getModel(db) {
+    const model = db.models.get('guess_sessions');
+    if (!model)
+        throw new Error('guess_sessions not registered');
+    return model;
+}
+export class SessionService {
+    db;
+    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 rows = await getModel(this.db).findAll({
+            channel_key: channel,
+            player_id: userId,
+            status: 'active',
+        });
+        return rows[0] ?? null;
+    }
+    async getById(id) {
+        return getModel(this.db).findOne({ id });
+    }
+    async createSession(message) {
+        const now = Date.now();
+        const row = {
+            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,
+            secret: newSecret(),
+            range_min: MIN,
+            range_max: MAX,
+            attempts: 0,
+            max_attempts: MAX_ATTEMPTS,
+            status: 'active',
+            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;
+    }
+}
+export function createServices(db) {
+    return new SessionService(db);
+}
+export function resolveGameDatabase(feature) {
+    return feature.db;
+}
+export function formatStatus(session) {
+    const left = session.max_attempts - session.attempts;
+    return [
+        '🔢 **猜数字**',
+        '',
+        `我想了一个 **${session.range_min} ~ ${session.range_max}** 之间的整数。`,
+        `你还有 **${left}** 次机会（已猜 ${session.attempts} 次）。`,
+        '',
+        '直接回复数字即可，例如：`50`',
+    ].join('\n');
+}
+//# sourceMappingURL=session-service.js.map

package/lib/session-service.js.map

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

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@zhin.js/plugin-guess-number",
+  "version": "1.0.0",
+  "description": "Zhin.js 猜数字 — 1~100 七步之内猜中",
+  "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-guess-number"
+description: "猜数字"

package/src/commands.ts

@@ -0,0 +1,46 @@
+import { Message, MessageCommand, type Plugin } from 'zhin.js';
+import { channelKey, normalizeGuessAction, registerGameTextMiddleware } from '@zhin.js/game-shared';
+import { processGuess } from './game-flow.js';
+import { runGuessCommand } from './guess-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 runGuessCommand(services, message, normalizeGuessAction(raw));
+      }),
+  );
+}
+
+export function registerCommands(plugin: Plugin, getServices: () => SessionService | null): void {
+  registerPattern(plugin, 'guess [action:word]', '猜数字（guess）', getServices);
+  registerPattern(plugin, '猜数 [action:word]', '猜数字（中文）', getServices);
+}
+
+export function registerGuessMiddleware(plugin: Plugin, getServices: () => SessionService | null): void {
+  registerGameTextMiddleware(plugin, async (message, next) => {
+    const services = getServices();
+    if (!services) return next();
+
+    const raw = message.$raw?.trim() ?? '';
+    const m = /^(\d+)$/.exec(raw);
+    if (!m) return next();
+
+    const ch = channelKey(message);
+    const session = await services.getActiveForUser(ch, message.$sender.id);
+    if (!session) return next();
+
+    const reply = await processGuess(services, message, Number(m[1]));
+    if (reply) await message.$reply?.(reply);
+  }, 'guess-number:text');
+}

package/src/engine.ts

@@ -0,0 +1,21 @@
+export const GUESS_PREFIX = 'guess';
+export const MIN = 1;
+export const MAX = 100;
+export const MAX_ATTEMPTS = 7;
+
+export type GuessResult = 'win' | 'low' | 'high' | 'invalid';
+
+export function newSecret(): number {
+  return MIN + Math.floor(Math.random() * (MAX - MIN + 1));
+}
+
+export function evaluateGuess(secret: number, value: number): GuessResult {
+  if (!Number.isInteger(value) || value < MIN || value > MAX) return 'invalid';
+  if (value === secret) return 'win';
+  return value < secret ? 'low' : 'high';
+}
+
+export function hintText(result: Exclude<GuessResult, 'win' | 'invalid'>, rangeMin: number, rangeMax: number): string {
+  if (result === 'low') return `📈 **太小了！** 范围 ${rangeMin} ~ ${rangeMax}`;
+  return `📉 **太大了！** 范围 ${rangeMin} ~ ${rangeMax}`;
+}

package/src/game-flow.ts

@@ -0,0 +1,68 @@
+import type { Message } from 'zhin.js';
+import { evaluateGuess, hintText, MAX, MIN } from './engine.js';
+import type { SessionService } from './session-service.js';
+import { formatStatus } from './session-service.js';
+
+export async function startGame(
+  services: SessionService,
+  message: Message<any>,
+): Promise<string> {
+  const ch = `${message.$adapter}-${message.$endpoint}-${message.$channel.type}:${message.$channel.id}`;
+  const mine = await services.getActiveForUser(ch, message.$sender.id);
+  if (mine) {
+    return `${formatStatus(mine)}\n\n（你已有进行中的局，继续猜数字，或发送「猜数 放弃」）`;
+  }
+  const session = await services.createSession(message);
+  return formatStatus(session);
+}
+
+export async function processGuess(
+  services: SessionService,
+  message: Message<any>,
+  value: number,
+): Promise<string | null> {
+  const ch = `${message.$adapter}-${message.$endpoint}-${message.$channel.type}:${message.$channel.id}`;
+  const session = await services.getActiveForUser(ch, message.$sender.id);
+  if (!session) return null;
+
+  const result = evaluateGuess(session.secret, value);
+  if (result === 'invalid') {
+    return `请输入 ${MIN} ~ ${MAX} 之间的整数。`;
+  }
+
+  const attempts = session.attempts + 1;
+
+  if (result === 'win') {
+    await services.updateSession(session.id, { attempts, status: 'won' });
+    return [
+      '🎉 **猜对了！**',
+      '',
+      `答案就是 **${session.secret}**，你用了 ${attempts} 次。`,
+      '发送「猜数 开始」再来一局。',
+    ].join('\n');
+  }
+
+  if (attempts >= session.max_attempts) {
+    await services.updateSession(session.id, { attempts, status: 'lost' });
+    return [
+      '💀 **机会用完了！**',
+      '',
+      `正确答案是 **${session.secret}**。`,
+      '发送「猜数 开始」再来一局。',
+    ].join('\n');
+  }
+
+  let rangeMin = session.range_min;
+  let rangeMax = session.range_max;
+  if (result === 'low') rangeMin = Math.max(rangeMin, value + 1);
+  else rangeMax = Math.min(rangeMax, value - 1);
+
+  await services.updateSession(session.id, { attempts, range_min: rangeMin, range_max: rangeMax });
+
+  const left = session.max_attempts - attempts;
+  return [
+    hintText(result, rangeMin, rangeMax),
+    '',
+    `剩余 **${left}** 次机会，继续猜吧！`,
+  ].join('\n');
+}

package/src/guess-command.ts

@@ -0,0 +1,44 @@
+import type { Message, Plugin } from 'zhin.js';
+import { channelKey } from '@zhin.js/game-shared';
+import { startGame } from './game-flow.js';
+import { formatStatus, type SessionService } from './session-service.js';
+
+export const GUESS_HELP = [
+  '🔢 猜数字（1~100，7 次机会）',
+  '猜数 / guess — 帮助',
+  '猜数 开始 — 新一局',
+  '猜数 放弃 — 结束当前局',
+  '',
+  '进行中直接回复数字即可。',
+].join('\n');
+
+export async function runGuessCommand(
+  services: SessionService,
+  message: Message<any>,
+  action: string,
+): Promise<string> {
+  const ch = channelKey(message);
+  const userId = message.$sender.id;
+
+  if (!action || action === 'help') {
+    const active = await services.getActiveForUser(ch, userId);
+    const lines = [GUESS_HELP, ''];
+    if (active) {
+      lines.push(formatStatus(active));
+    } else {
+      lines.push('暂无对局，发送「猜数 开始」。');
+    }
+    return lines.join('\n');
+  }
+
+  if (action === 'start') return startGame(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${GUESS_HELP}`;
+}

package/src/hub-register.ts

@@ -0,0 +1,29 @@
+import { getPlugin } from 'zhin.js';
+import { ensureGameHubService } from '@zhin.js/game-shared';
+import { runGuessCommand, GUESS_HELP } from './guess-command.js';
+import type { SessionService } from './session-service.js';
+
+export function registerGuessHub(getServices: () => SessionService | null): () => void {
+  const plugin = getPlugin();
+  ensureGameHubService(plugin);
+  return plugin.registerGame({
+    id: 'guess',
+    title: '猜数字',
+    icon: '🔢',
+    description: '1~100 七步猜中神秘数',
+    commandPrefix: '猜数',
+    quickStart: '开始',
+    aliases: ['guess'],
+    menus: [
+      { id: 'start', label: '🎮 开始新局', style: 'primary' },
+      { id: 'help', label: '📖 玩法说明' },
+    ],
+    runAction: async (actionId, ctx) => {
+      const services = getServices();
+      if (!services) return '猜数字需要启用 database 配置。';
+      return runGuessCommand(services, ctx.message, actionId);
+    },
+  });
+}
+
+export { GUESS_HELP };

package/src/index.ts

@@ -0,0 +1,35 @@
+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, registerGuessMiddleware } from './commands.js';
+import { registerGuessHub } 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({ 模块: '猜数字', 数据模型: '已就绪' }));
+});
+
+registerGuessHub(() => services);
+registerCommands(plugin, () => services);
+registerGuessMiddleware(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,49 @@
+import type { Models, Plugin } from 'zhin.js';
+
+export type GuessSessionStatus = 'active' | 'won' | 'lost' | 'aborted';
+
+declare module 'zhin.js' {
+  interface Models {
+    guess_sessions: {
+      id: string;
+      adapter: string;
+      endpoint: string;
+      channel_type: string;
+      channel_id: string;
+      channel_key: string;
+      player_id: string;
+      player_name: string;
+      secret: number;
+      range_min: number;
+      range_max: number;
+      attempts: number;
+      max_attempts: number;
+      status: GuessSessionStatus;
+      updated_at: number;
+      created_at: number;
+    };
+  }
+}
+
+export type GuessSessionRow = Models['guess_sessions'];
+
+export function registerModels(plugin: Plugin): void {
+  plugin.defineModel('guess_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: '' },
+    secret: { type: 'integer', nullable: false },
+    range_min: { type: 'integer', default: 1 },
+    range_max: { type: 'integer', default: 100 },
+    attempts: { type: 'integer', default: 0 },
+    max_attempts: { type: 'integer', default: 7 },
+    status: { type: 'text', default: 'active' },
+    updated_at: { type: 'integer', default: 0 },
+    created_at: { type: 'integer', default: 0 },
+  });
+}

package/src/session-service.ts

@@ -0,0 +1,96 @@
+import type { Database, DatabaseFeature, Message, Models, RelatedModel } from 'zhin.js';
+import { channelKey, generateSessionId } from '@zhin.js/game-shared';
+import { MAX, MAX_ATTEMPTS, MIN, newSecret } from './engine.js';
+import type { GuessSessionRow } from './models.js';
+
+export type GuessDatabase = Database<unknown, Models, string>;
+
+function getModel(db: GuessDatabase) {
+  const model = db.models.get('guess_sessions');
+  if (!model) throw new Error('guess_sessions not registered');
+  return model as RelatedModel<unknown, Models, 'guess_sessions'>;
+}
+
+export class SessionService {
+  constructor(private readonly db: GuessDatabase) {}
+
+  async getActiveByChannel(channel: string): Promise<GuessSessionRow | null> {
+    const rows = await getModel(this.db).findAll({ channel_key: channel, status: 'active' });
+    return rows[0] ?? null;
+  }
+
+  async getActiveForUser(channel: string, userId: string): Promise<GuessSessionRow | null> {
+    const rows = await getModel(this.db).findAll({
+      channel_key: channel,
+      player_id: userId,
+      status: 'active',
+    });
+    return rows[0] ?? null;
+  }
+
+  async getById(id: string): Promise<GuessSessionRow | null> {
+    return getModel(this.db).findOne({ id });
+  }
+
+  async createSession(message: Message<any>): Promise<GuessSessionRow> {
+    const now = Date.now();
+    const row: GuessSessionRow = {
+      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,
+      secret: newSecret(),
+      range_min: MIN,
+      range_max: MAX,
+      attempts: 0,
+      max_attempts: MAX_ATTEMPTS,
+      status: 'active',
+      updated_at: now,
+      created_at: now,
+    };
+    await getModel(this.db).create(row);
+    return row;
+  }
+
+  async updateSession(id: string, patch: Partial<GuessSessionRow>): 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: GuessDatabase): SessionService {
+  return new SessionService(db);
+}
+
+export function resolveGameDatabase(feature: DatabaseFeature): GuessDatabase {
+  return feature.db;
+}
+
+export function formatStatus(session: GuessSessionRow): string {
+  const left = session.max_attempts - session.attempts;
+  return [
+    '🔢 **猜数字**',
+    '',
+    `我想了一个 **${session.range_min} ~ ${session.range_max}** 之间的整数。`,
+    `你还有 **${left}** 次机会（已猜 ${session.attempts} 次）。`,
+    '',
+    '直接回复数字即可，例如：`50`',
+  ].join('\n');
+}