@zhin.js/plugin-idiom-chain 1.0.0

package/lib/session-service.d.ts

@@ -0,0 +1,25 @@
+import type { Database, DatabaseFeature, Message, Models } from 'zhin.js';
+import type { MatchMode } from './engine.js';
+import type { ChainSessionRow } from './models.js';
+export type ChainDatabase = Database<unknown, Models, string>;
+export declare function parseUsed(value: string | string[] | unknown): Set<string>;
+export declare function serializeUsed(set: Set<string>): string;
+export declare class SessionService {
+    private readonly db;
+    constructor(db: ChainDatabase);
+    getActiveByChannel(channel: string): Promise<ChainSessionRow | null>;
+    getActiveForUser(channel: string, userId: string): Promise<ChainSessionRow | null>;
+    getById(id: string): Promise<ChainSessionRow | null>;
+    getActiveByBoardMessageId(messageId: string): Promise<ChainSessionRow | null>;
+    createSession(message: Message<any>, starter: {
+        text: string;
+        nextChar: string;
+        used: string[];
+        matchMode: MatchMode;
+    }): Promise<ChainSessionRow>;
+    updateSession(id: string, patch: Partial<ChainSessionRow>): Promise<void>;
+    abortStale(idleMs: number): Promise<number>;
+}
+export declare function createServices(db: ChainDatabase): SessionService;
+export declare function resolveGameDatabase(feature: DatabaseFeature): ChainDatabase;
+//# 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;AAExF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAQ9D,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,CASzE;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAEtD;AAED,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;IAMlF,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAIpD,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAW7E,aAAa,CACjB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,EACrB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,SAAS,CAAA;KAAE,GAChF,OAAO,CAAC,eAAe,CAAC;IA+BrB,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"}

package/lib/session-service.js

@@ -0,0 +1,108 @@
+import { channelKey, generateSessionId } from '@zhin.js/game-shared';
+function getModel(db) {
+    const model = db.models.get('idiom_chain_sessions');
+    if (!model)
+        throw new Error('idiom_chain_sessions not registered');
+    return model;
+}
+export function parseUsed(value) {
+    if (Array.isArray(value))
+        return new Set(value.filter((x) => typeof x === 'string'));
+    if (typeof value !== 'string' || !value)
+        return new Set();
+    try {
+        const v = JSON.parse(value);
+        return Array.isArray(v) ? new Set(v.filter((x) => typeof x === 'string')) : new Set();
+    }
+    catch {
+        return new Set();
+    }
+}
+export function serializeUsed(set) {
+    return JSON.stringify([...set]);
+}
+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, starter) {
+        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,
+            last_idiom: starter.text,
+            next_char: starter.nextChar,
+            match_mode: starter.matchMode,
+            used_idioms: serializeUsed(new Set(starter.used)),
+            player_score: 0,
+            bot_score: 0,
+            streak: 0,
+            best_streak: 0,
+            wrong_count: 0,
+            hints_used: 0,
+            turn: 'player',
+            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;
+}
+//# 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 { ChainSessionRow } from './models.js';
+declare const MAX_WRONG = 3;
+export declare function buildChainView(session: ChainSessionRow, eventLines?: string[]): SendContent;
+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;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD,QAAA,MAAM,SAAS,IAAI,CAAC;AAMpB,wBAAgB,cAAc,CAC5B,OAAO,EAAE,eAAe,EACxB,UAAU,GAAE,MAAM,EAAO,GACxB,WAAW,CAgDb;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/lib/view.js

@@ -0,0 +1,54 @@
+import { buildChoiceKeyboard } from '@zhin.js/game-shared';
+import { CHAIN_PREFIX, getGloss, idiomCount, modeLabel, promptLine } from './engine.js';
+const MAX_WRONG = 3;
+function sessionMode(session) {
+    return session.match_mode === 'char' ? 'char' : 'pinyin';
+}
+export function buildChainView(session, eventLines = []) {
+    const terminal = session.status !== 'active';
+    const mode = sessionMode(session);
+    const lines = [
+        `📜 **成语接龙** · ${modeLabel(mode)}`,
+        '',
+        `词库 **${idiomCount()}** 条 · 局分 ${session.player_score}:${session.bot_score} · 连击 **${session.streak}**（最佳 ${session.best_streak}）`,
+    ];
+    if (session.last_idiom) {
+        const gloss = getGloss(session.last_idiom);
+        lines.push('', `上一句：**${session.last_idiom}**${gloss ? `（${gloss}）` : ''}`);
+        lines.push(promptLine(session.last_idiom, mode));
+    }
+    if (session.wrong_count > 0 && session.status === 'active') {
+        lines.push(`⚠️ 失误 ${session.wrong_count}/${MAX_WRONG}`);
+    }
+    if (eventLines.length) {
+        lines.push('', ...eventLines);
+    }
+    if (terminal) {
+        lines.push('');
+        if (session.status === 'won')
+            lines.push('🏆 **你赢了本局！** 机器人接不上啦。');
+        else if (session.status === 'lost')
+            lines.push('💀 **机器人获胜。** 发送「接龙 开始」再来。');
+    }
+    else {
+        lines.push('', '直接回复四字成语，或点下方按钮：');
+    }
+    const choices = terminal
+        ? [{ id: 'restart', label: '🔄 再来一局', style: 'primary' }]
+        : [
+            { id: 'hint', label: '💡 提示', style: 'secondary' },
+            { id: 'skip', label: '⏭️ 跳过', style: 'secondary' },
+            { id: 'quit', label: '🏳️ 认输', style: 'danger' },
+        ];
+    return buildChoiceKeyboard({
+        gamePrefix: CHAIN_PREFIX,
+        sessionId: session.id,
+        narrative: lines.join('\n'),
+        choices,
+        terminal,
+        buttonsPerRow: 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,38 @@
+{
+  "name": "@zhin.js/plugin-idiom-chain",
+  "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": "tsc --build",
+    "clean": "rimraf lib"
+  }
+}

package/plugin.yml

@@ -0,0 +1,2 @@
+name: "@zhin.js/plugin-idiom-chain"
+description: "成语接龙"

package/src/chain-command.ts

@@ -0,0 +1,57 @@
+import type { Message, Plugin } from 'zhin.js';
+import { channelKey } from '@zhin.js/game-shared';
+import { continueGame, startGame } from './game-flow.js';
+import { idiomCount, modeLabel, promptLine } from './engine.js';
+import type { MatchMode } from './engine.js';
+import type { SessionService } from './session-service.js';
+
+export const CHAIN_HELP = [
+  '📜 成语接龙（文字接龙 · 四字成语）',
+  `开源词库 ${idiomCount()} 条 · 机器人先出第一句`,
+  '接龙 / chain — 帮助',
+  '接龙 开始 / 同音 — 同音接龙（默认，首字同音即可）',
+  '接龙 同字 — 严格同字接龙',
+  '接龙 继续 — 刷新界面',
+  '接龙 放弃 — 结束对局',
+  '',
+  '进行中：直接回复四字成语',
+  '按钮：提示 · 跳过 · 认输（失误 3 次判负）',
+].join('\n');
+
+export async function runChainCommand(
+  plugin: Plugin,
+  services: SessionService,
+  message: Message<any>,
+  action: string,
+): Promise<string | undefined> {
+  const ch = channelKey(message);
+  const userId = message.$sender.id;
+
+  if (!action || action === 'help') {
+    const active = await services.getActiveByChannel(ch);
+    const lines = [CHAIN_HELP, ''];
+    if (active) {
+      const mode: MatchMode = active.match_mode === 'char' ? 'char' : 'pinyin';
+      lines.push(
+        `进行中：${active.player_name} · ${modeLabel(mode)} · 局分 ${active.player_score}:${active.bot_score} · 连击 ${active.streak}`,
+      );
+      if (active.last_idiom) lines.push(promptLine(active.last_idiom, mode));
+    } else {
+      lines.push('暂无对局，发送「接龙 开始」或「接龙 同字」。');
+    }
+    return lines.join('\n');
+  }
+
+  if (action === 'start_pinyin') return startGame(plugin, services, message, 'pinyin');
+  if (action === 'start_char') return startGame(plugin, services, message, 'char');
+  if (action === 'continue') return continueGame(plugin, 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${CHAIN_HELP}`;
+}

package/src/commands.ts

@@ -0,0 +1,112 @@
+import { Message, MessageCommand, getActionFromMessage, type Plugin } from 'zhin.js';
+import {
+  buildChoiceFallbackMap,
+  channelKey,
+  normalizeChainAction,
+  parseChoicePayload,
+  registerGameTextMiddleware,
+} from '@zhin.js/game-shared';
+import { CHAIN_PREFIX, handleChoice, processIdiomText } from './game-flow.js';
+import { runChainCommand } from './chain-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 runChainCommand(plugin, services, message, normalizeChainAction(raw));
+      }),
+  );
+}
+
+export function registerCommands(plugin: Plugin, getServices: () => SessionService | null): void {
+  registerPattern(plugin, 'chain [action:word]', '成语接龙（chain）', 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, CHAIN_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'];
+  if (!valid.includes(choiceId)) return null;
+  return { sessionId: session.id, choiceId };
+}
+
+export function registerInteractive(plugin: Plugin, getServices: () => SessionService | null): void {
+  plugin.registerInteractiveHandler(`${CHAIN_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 (err) 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(`${CHAIN_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(CHAIN_PREFIX, session.id, [
+        { id: 'hint', label: '提示' },
+        { id: 'skip', label: '跳过' },
+        { id: 'quit', label: '认输' },
+      ]);
+      const payload = map[n[1]!];
+      const parsed = payload ? parseChoicePayload(payload, CHAIN_PREFIX) : null;
+      if (parsed?.sessionId === session.id) {
+        const err = await handleChoice(plugin, services, message, session.id, parsed.choiceId);
+        if (err) await message.$reply?.(err);
+        return;
+      }
+    }
+
+    if (/^[\u4e00-\u9fff]{2,8}$/.test(raw)) {
+      await processIdiomText(plugin, services, message, raw);
+      return;
+    }
+
+    return next();
+  }, 'idiom-chain:text');
+}

package/src/engine.ts

@@ -0,0 +1,18 @@
+export const CHAIN_PREFIX = 'chain';
+
+export type { MatchMode, IdiomEntry, ValidateResult } from './idiom-provider.js';
+export {
+  idiomCount,
+  normalizeInput,
+  isKnownIdiom,
+  getGloss,
+  lastChar,
+  lastSyllableNoTone,
+  modeLabel,
+  getValidNext,
+  pickBotIdiom,
+  pickStarterIdiom,
+  pickHintIdiom,
+  validatePlayerIdiom,
+  promptLine,
+} from './idiom-provider.js';