@zhin.js/plugin-word-riddle 1.0.0

package/lib/session-service.js

@@ -0,0 +1,108 @@
+import { channelKey, generateSessionId } from '@zhin.js/game-shared';
+import { pickRoundQueue } from './data/riddles.js';
+function getModel(db) {
+    const model = db.models.get('word_riddle_sessions');
+    if (!model)
+        throw new Error('word_riddle_sessions not registered');
+    return model;
+}
+export function parseQueue(value) {
+    if (Array.isArray(value))
+        return value.filter((x) => typeof x === 'string');
+    if (typeof value !== 'string' || !value)
+        return [];
+    try {
+        const v = JSON.parse(value);
+        return Array.isArray(v) ? v.filter((x) => typeof x === 'string') : [];
+    }
+    catch {
+        return [];
+    }
+}
+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 row = await this.getActiveByChannel(channel);
+        if (!row || row.player_id !== userId)
+            return null;
+        return row;
+    }
+    async getById(id) {
+        return getModel(this.db).findOne({ id });
+    }
+    async getActiveByBoardMessageId(messageId) {
+        if (!messageId)
+            return null;
+        const rows = await getModel(this.db).findAll({ status: 'active' });
+        for (const row of rows) {
+            const stored = row.board_message_id;
+            if (!stored)
+                continue;
+            if (stored === messageId || stored.endsWith(`:${messageId}`))
+                return row;
+        }
+        return null;
+    }
+    async createSession(message, mode) {
+        const now = Date.now();
+        const queue = pickRoundQueue(mode).map((r) => r.id);
+        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,
+            mode,
+            queue: JSON.stringify(queue),
+            index: 0,
+            score: 0,
+            streak: 0,
+            best_streak: 0,
+            hints_used: 0,
+            wrong_count: 0,
+            status: 'active',
+            board_message_id: '',
+            updated_at: now,
+            created_at: now,
+        };
+        await getModel(this.db).create(row);
+        return row;
+    }
+    async updateSession(id, patch) {
+        await getModel(this.db).updateWhere({ id }, { ...patch, updated_at: Date.now() });
+    }
+    async abortStale(idleMs) {
+        const cutoff = Date.now() - idleMs;
+        const model = getModel(this.db);
+        const rows = await model.findAll({ status: 'active' });
+        let n = 0;
+        for (const row of rows) {
+            if (row.updated_at < cutoff) {
+                await model.updateWhere({ id: row.id }, { status: 'aborted', updated_at: Date.now() });
+                n++;
+            }
+        }
+        return n;
+    }
+}
+export function createServices(db) {
+    return new SessionService(db);
+}
+export function resolveGameDatabase(feature) {
+    return feature.db;
+}
+export function currentRiddleId(session) {
+    const queue = parseQueue(session.queue);
+    return queue[session.index] ?? null;
+}
+//# 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/lib/view.d.ts

@@ -0,0 +1,6 @@
+import type { SendContent } from 'zhin.js';
+import type { RiddleSessionRow } from './models.js';
+declare const MAX_WRONG = 3;
+export declare function buildRiddleView(session: RiddleSessionRow, eventLines?: string[]): SendContent | string;
+export { MAX_WRONG };
+//# sourceMappingURL=view.d.ts.map

package/lib/view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../src/view.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD,QAAA,MAAM,SAAS,IAAI,CAAC;AAEpB,wBAAgB,eAAe,CAC7B,OAAO,EAAE,gBAAgB,EACzB,UAAU,GAAE,MAAM,EAAO,GACxB,WAAW,GAAG,MAAM,CA8CtB;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/lib/view.js

@@ -0,0 +1,50 @@
+import { buildChoiceKeyboard } from '@zhin.js/game-shared';
+import { getRiddleById, RIDDLE_PREFIX, typeLabel } from './engine.js';
+import { currentRiddleId, parseQueue } from './session-service.js';
+const MAX_WRONG = 3;
+export function buildRiddleView(session, eventLines = []) {
+    const queue = parseQueue(session.queue);
+    const terminal = session.status !== 'active';
+    const riddleId = currentRiddleId(session);
+    const entry = riddleId ? getRiddleById(riddleId) : undefined;
+    const lines = [
+        `🧩 **${typeLabel(session.mode)}**`,
+        '',
+        `进度 ${Math.min(session.index + 1, queue.length)}/${queue.length} · 得分 **${session.score}** · 连击 **${session.streak}**（最佳 ${session.best_streak}）`,
+    ];
+    if (terminal) {
+        lines.push('', '🎊 **本轮题目已全部完成！**', `最终得分：**${session.score}**`);
+    }
+    else if (entry) {
+        lines.push('', `❓ ${entry.question}`);
+        if (session.wrong_count > 0) {
+            lines.push(`⚠️ 本题失误 ${session.wrong_count}/${MAX_WRONG}`);
+        }
+        lines.push('', session.mode === 'char' ? '请回复一个汉字。' : '请回复四字成语。');
+    }
+    if (eventLines.length)
+        lines.push('', ...eventLines);
+    if (!entry && !terminal)
+        return '题目加载失败，请重新开始。';
+    const choices = terminal
+        ? [
+            { id: 'restart_char', label: '🔤 再来字谜', style: 'primary' },
+            { id: 'restart_idiom', label: '📜 再来成语', style: 'primary' },
+        ]
+        : [
+            { id: 'hint', label: '💡 提示', style: 'secondary' },
+            { id: 'skip', label: '⏭️ 跳过', style: 'secondary' },
+            { id: 'quit', label: '🏳️ 结束', style: 'danger' },
+        ];
+    return buildChoiceKeyboard({
+        gamePrefix: RIDDLE_PREFIX,
+        sessionId: session.id,
+        narrative: lines.join('\n'),
+        choices,
+        terminal,
+        buttonsPerRow: terminal ? 2 : 3,
+        fallbackHint: '回复答案，或 1提示 2跳过 3结束',
+    });
+}
+export { MAX_WRONG };
+//# sourceMappingURL=view.js.map

package/lib/view.js.map

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

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@zhin.js/plugin-word-riddle",
+  "version": "1.0.0",
+  "description": "Zhin.js 猜谜 — 字谜与猜成语",
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "development": "./src/index.ts",
+      "import": "./lib/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "plugin.yml",
+    "README.md"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "zhin.js": "4.1.0"
+  },
+  "dependencies": {
+    "chinese-idiom-chengyu": "^1.1.0",
+    "@zhin.js/game-shared": "1.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^6.0.3",
+    "zhin.js": "4.1.0"
+  },
+  "scripts": {
+    "build:data": "node scripts/build-char-riddles.mjs",
+    "build": "pnpm run build:data && tsc --build && node -e \"import('node:fs/promises').then(fs=>fs.mkdir('lib/data',{recursive:true}).then(()=>fs.copyFile('src/data/char-riddles.json','lib/data/char-riddles.json')))\"",
+    "clean": "rimraf lib"
+  }
+}

package/plugin.yml

@@ -0,0 +1,2 @@
+name: "@zhin.js/plugin-word-riddle"
+description: "字谜与猜成语"

package/src/commands.ts

@@ -0,0 +1,112 @@
+import { Message, MessageCommand, getActionFromMessage, type Plugin } from 'zhin.js';
+import {
+  buildChoiceFallbackMap,
+  channelKey,
+  normalizeRiddleAction,
+  parseChoicePayload,
+  registerGameTextMiddleware,
+} from '@zhin.js/game-shared';
+import { handleChoice, processAnswerText, RIDDLE_PREFIX } from './game-flow.js';
+import { runRiddleCommand } from './riddle-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 runRiddleCommand(plugin, services, message, normalizeRiddleAction(raw));
+      }),
+  );
+}
+
+export function registerCommands(plugin: Plugin, getServices: () => SessionService | null): void {
+  registerPattern(plugin, 'riddle [action:word]', '猜谜（riddle）', getServices);
+  registerPattern(plugin, '猜谜 [action:word]', '猜谜（中文）', getServices);
+}
+
+async function resolveChoice(
+  message: Message<any>,
+  services: SessionService,
+): Promise<{ sessionId: string; choiceId: string } | null> {
+  const action = getActionFromMessage(message);
+  if (!action) return null;
+
+  const parsed = parseChoicePayload(action.payload, RIDDLE_PREFIX);
+  if (parsed) return { sessionId: parsed.sessionId, choiceId: parsed.choiceId };
+
+  const choiceId = action.id || action.payload;
+  if (!choiceId) return null;
+
+  const ch = channelKey(message);
+  const session =
+    await services.getActiveForUser(ch, message.$sender.id)
+    ?? (action.sourceMessageId
+      ? await services.getActiveByBoardMessageId(action.sourceMessageId)
+      : null);
+  if (!session || session.channel_key !== ch) return null;
+
+  const valid = ['hint', 'skip', 'quit', 'restart_char', 'restart_idiom'];
+  if (!valid.includes(choiceId)) return null;
+  return { sessionId: session.id, choiceId };
+}
+
+export function registerInteractive(plugin: Plugin, getServices: () => SessionService | null): void {
+  plugin.registerInteractiveHandler(`${RIDDLE_PREFIX}:`, async (message) => {
+    const services = getServices();
+    if (!services) return false;
+    const choice = await resolveChoice(message, services);
+    if (!choice) return false;
+    const err = await handleChoice(plugin, services, message, choice.sessionId, choice.choiceId);
+    if (typeof err === 'string') await message.$reply?.(err);
+    return true;
+  });
+}
+
+export function registerTextMiddleware(plugin: Plugin, getServices: () => SessionService | null): void {
+  registerGameTextMiddleware(plugin, async (message, next) => {
+    const services = getServices();
+    if (!services) return next();
+
+    const action = getActionFromMessage(message);
+    if (action?.payload.startsWith(`${RIDDLE_PREFIX}:`)) return next();
+
+    const ch = channelKey(message);
+    const session = await services.getActiveForUser(ch, message.$sender.id);
+    if (!session) return next();
+
+    const raw = message.$raw?.trim() ?? '';
+    if (!raw) return next();
+
+    const n = /^(\d+)$/.exec(raw);
+    if (n && session.status === 'active') {
+      const map = buildChoiceFallbackMap(RIDDLE_PREFIX, session.id, [
+        { id: 'hint', label: '提示' },
+        { id: 'skip', label: '跳过' },
+        { id: 'quit', label: '结束' },
+      ]);
+      const payload = map[n[1]!];
+      const parsed = payload ? parseChoicePayload(payload, RIDDLE_PREFIX) : null;
+      if (parsed?.sessionId === session.id) {
+        const err = await handleChoice(plugin, services, message, session.id, parsed.choiceId);
+        if (typeof err === 'string') await message.$reply?.(err);
+        return;
+      }
+    }
+
+    if (/^[\u4e00-\u9fff]{1,8}$/.test(raw)) {
+      await processAnswerText(plugin, services, message, raw);
+      return;
+    }
+
+    return next();
+  }, 'word-riddle:text');
+}