@zhin.js/plugin-word-riddle 1.0.0

package/README.md

@@ -0,0 +1,20 @@
+# @zhin.js/plugin-word-riddle
+
+字谜 + 猜成语。每局随机 **10** 题，支持提示、跳过与连击计分。
+
+## 词库来源
+
+| 模式 | 来源 | 规模 |
+|------|------|------|
+| 字谜 | [riddle_demo](https://github.com/ytygxfmgzx/riddle_demo) CSV（构建为 `char-riddles.json`） | ~2.8 万 |
+| 猜成语 | npm [`chinese-idiom-chengyu`](https://www.npmjs.com/package/chinese-idiom-chengyu)（MIT） | ~2.9 万 |
+
+字谜数据在 `pnpm build` 时由 `scripts/build-char-riddles.mjs` 生成；本地可缓存 `data/riddles.csv` 避免重复下载。
+
+## 命令
+
+- `猜谜` / `猜谜 开始` — 字谜模式
+- `猜谜 成语` — 猜成语模式
+- `猜谜 继续` — 刷新界面
+
+需启用 `database` 配置以持久化对局。

package/lib/commands.d.ts

@@ -0,0 +1,6 @@
+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 registerInteractive(plugin: Plugin, getServices: () => SessionService | null): void;
+export declare function registerTextMiddleware(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,EAAiD,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAUrF,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;AA4BD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,cAAc,GAAG,IAAI,GAAG,IAAI,CAUlG;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,cAAc,GAAG,IAAI,GAAG,IAAI,CAsCrG"}

package/lib/commands.js

@@ -0,0 +1,94 @@
+import { MessageCommand, getActionFromMessage } 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';
+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 runRiddleCommand(plugin, services, message, normalizeRiddleAction(raw));
+    }));
+}
+export function registerCommands(plugin, getServices) {
+    registerPattern(plugin, 'riddle [action:word]', '猜谜（riddle）', getServices);
+    registerPattern(plugin, '猜谜 [action:word]', '猜谜（中文）', getServices);
+}
+async function resolveChoice(message, services) {
+    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, getServices) {
+    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, getServices) {
+    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');
+}
+//# 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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"}