@zhin.js/plugin-idiom-chain 1.1.14 → 1.1.16

package/lib/view.js

@@ -1,3 +1,4 @@
+import { createMessages } from 'zhin.js/i18n';
 import { buildChoiceKeyboard } from '@zhin.js/game-kit';
 import { CHAIN_PREFIX, getGloss, idiomCount, modeLabel, promptLine } from './engine.js';
 const MAX_WRONG = 3;
@@ -8,17 +9,17 @@ export function buildChainView(session, eventLines = [], channelType) {
     const terminal = session.status !== 'active';
     const mode = sessionMode(session);
     const lines = [
-        `📜 **成语接龙** · ${modeLabel(mode)}`,
+        messages(session.locale ?? undefined, 'text1', { p0: modeLabel(mode, session.locale ?? undefined) }),
         '',
-        `词库 **${idiomCount()}** 条 · 局分 ${session.player_score}:${session.bot_score} · 连击 **${session.streak}**（最佳 ${session.best_streak}）`,
+        messages(session.locale ?? undefined, 'text2', { p0: idiomCount(), p1: session.player_score, p2: session.bot_score, p3: session.streak, p4: 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));
+        lines.push('', messages(session.locale ?? undefined, 'text3', { p0: session.last_idiom }) + (gloss ? `（${gloss}）` : ''));
+        lines.push(promptLine(session.last_idiom, mode, session.locale ?? undefined));
     }
     if (session.wrong_count > 0 && session.status === 'active') {
-        lines.push(`⚠️ 失误 ${session.wrong_count}/${MAX_WRONG}`);
+        lines.push(messages(session.locale ?? undefined, 'text4', { p0: session.wrong_count, p1: MAX_WRONG }));
     }
     if (eventLines.length) {
         lines.push('', ...eventLines);
@@ -26,19 +27,19 @@ export function buildChainView(session, eventLines = [], channelType) {
     if (terminal) {
         lines.push('');
         if (session.status === 'won')
-            lines.push('🏆 **你赢了本局！** 机器人接不上啦。');
+            lines.push(messages(session.locale ?? undefined, 'text5'));
         else if (session.status === 'lost')
-            lines.push('💀 **机器人获胜。** 发送「接龙 开始」再来。');
+            lines.push(messages(session.locale ?? undefined, 'text6'));
     }
     else {
-        lines.push('', '直接回复四字成语，或点下方按钮：');
+        lines.push('', messages(session.locale ?? undefined, 'text7'));
     }
     const choices = terminal
-        ? [{ id: 'restart', label: '🔄 再来一局', style: 'primary', keepEnabledWhenTerminal: true }]
+        ? [{ id: 'restart', label: messages(session.locale ?? undefined, 'text8'), style: 'primary', keepEnabledWhenTerminal: true }]
         : [
-            { id: 'hint', label: '💡 提示', style: 'secondary' },
-            { id: 'skip', label: '⏭️ 跳过', style: 'secondary' },
-            { id: 'quit', label: '🏳️ 认输', style: 'danger' },
+            { id: 'hint', label: messages(session.locale ?? undefined, 'text9'), style: 'secondary' },
+            { id: 'skip', label: messages(session.locale ?? undefined, 'text10'), style: 'secondary' },
+            { id: 'quit', label: messages(session.locale ?? undefined, 'text11'), style: 'danger' },
         ];
     return buildChoiceKeyboard({
         gamePrefix: CHAIN_PREFIX,
@@ -47,10 +48,24 @@ export function buildChainView(session, eventLines = [], channelType) {
         choices,
         terminal,
         buttonsPerRow: 3,
-        fallbackHint: '回复成语，或 1提示 2跳过 3认输',
+        fallbackHint: messages(session.locale ?? undefined, 'text12'),
         interactionProfile: terminal ? 'terminal' : 'gameplay',
         channelType,
     });
 }
 export { MAX_WRONG };
+const messages = createMessages({
+    text1: { 'zh-CN': "📜 **成语接龙** · {p0}", en: "📜 **Chinese Idiom Chain** · {p0}" },
+    text2: { 'zh-CN': "词库 **{p0}** 条 · 局分 {p1}:{p2} · 连击 **{p3}**（最佳 {p4}）", en: "Dictionary **{p0}** entries · Score {p1}:{p2} · Streak **{p3}** (best {p4})" },
+    text3: { 'zh-CN': "上一句：**{p0}**", en: "Last idiom: **{p0}**" },
+    text4: { 'zh-CN': "⚠️ 失误 {p0}/{p1}", en: "⚠️ Mistakes: {p0}/{p1}" },
+    text5: { 'zh-CN': "🏆 **你赢了本局！** 机器人接不上啦。", en: "🏆 **You won!** The bot has no next idiom." },
+    text6: { 'zh-CN': "💀 **机器人获胜。** 点击「再来一局」重新开始。", en: "💀 **The bot won.** Choose “Play again” to start again." },
+    text7: { 'zh-CN': "直接回复四字成语，或点下方按钮：", en: "Reply with a four-character Chinese idiom, or choose an option:" },
+    text8: { 'zh-CN': "🔄 再来一局", en: "🔄 Play again" },
+    text9: { 'zh-CN': "💡 提示", en: "💡 Hint" },
+    text10: { 'zh-CN': "⏭️ 跳过", en: "⏭️ Skip" },
+    text11: { 'zh-CN': "🏳️ 认输", en: "🏳️ Concede" },
+    text12: { 'zh-CN': "回复成语，或 1提示 2跳过 3认输", en: "Reply with an idiom, or 1 Hint · 2 Skip · 3 Concede" },
+});
 //# sourceMappingURL=view.js.map

package/lib/view.js.map

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

package/middlewares/chain-alias/index.js

@@ -1,18 +1,20 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { defineGameCommandAliasMiddleware, isChainAction, messageFromCommandInput, normalizeChainAction, } from '@zhin.js/game-kit';
-import { CHAIN_HELP, runChainCommand } from "../../lib/chain-command.js";
+import { getChainHelp, runChainCommand } from "../../lib/chain-command.js";
 import { resolveGameServices } from "../../lib/runtime-store.js";
 export default defineGameCommandAliasMiddleware({
     aliases: ['接龙', 'chain'],
     async run(action, input, context) {
+        const message = messageFromCommandInput(input, {
+            formatCommand: (path) => context.input.formatCommand?.(path, context.owner.id),
+        });
         const normalized = normalizeChainAction(String(action ?? ''));
         if (normalized === 'help')
-            return CHAIN_HELP;
+            return getChainHelp(message);
         // action 无法识别：放行给后续中间件，避免劫持普通聊天
         if (!isChainAction(normalized))
             return null;
         const services = resolveGameServices(context);
-        const message = messageFromCommandInput(input);
         return runChainCommand(services, message, normalized);
     },
 });

package/middlewares/chain-alias/index.ts

@@ -4,18 +4,20 @@ import {
   messageFromCommandInput,
   normalizeChainAction,
 } from '@zhin.js/game-kit';
-import { CHAIN_HELP, runChainCommand } from '../../src/chain-command.js';
+import { getChainHelp, runChainCommand } from '../../src/chain-command.js';
 import { resolveGameServices } from '../../src/runtime-store.js';
 
 export default defineGameCommandAliasMiddleware({
   aliases: ['接龙', 'chain'],
   async run(action, input, context) {
+    const message = messageFromCommandInput(input, {
+      formatCommand: (path) => context.input.formatCommand?.(path, context.owner.id),
+    });
     const normalized = normalizeChainAction(String(action ?? ''));
-    if (normalized === 'help') return CHAIN_HELP;
+    if (normalized === 'help') return getChainHelp(message);
     // action 无法识别：放行给后续中间件，避免劫持普通聊天
     if (!isChainAction(normalized)) return null;
     const services = resolveGameServices(context);
-    const message = messageFromCommandInput(input);
     return runChainCommand(services, message, normalized);
   },
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/plugin-idiom-chain",
-  "version": "1.1.14",
+  "version": "1.1.16",
   "description": "Zhin.js 成语接龙 — 四字成语文字接龙 (Plugin Runtime)",
   "type": "module",
   "main": "./lib/index.js",
@@ -24,13 +24,13 @@
   "license": "MIT",
   "dependencies": {
     "chinese-idiom-chengyu": "^1.1.0",
-    "@zhin.js/core": "1.1.49",
-    "@zhin.js/game-kit": "1.1.14"
+    "@zhin.js/core": "1.1.51",
+    "@zhin.js/game-kit": "1.1.16"
   },
   "devDependencies": {
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
-    "zhin.js": "1.1.14"
+    "zhin.js": "1.1.16"
   },
   "repository": {
     "type": "git",
@@ -67,9 +67,9 @@
     "plugins": []
   },
   "peerDependencies": {
-    "@zhin.js/command": "^1.1.9",
-    "@zhin.js/middleware": "^1.1.8",
-    "zhin.js": "^1.1.14"
+    "@zhin.js/command": "^1.1.11",
+    "@zhin.js/middleware": "^1.1.10",
+    "zhin.js": "^1.1.16"
   },
   "peerDependenciesMeta": {
     "@zhin.js/command": {

package/plugin.js

@@ -15,6 +15,10 @@ export default defineGamePlugin({
         displayName: 'Idiom Chain',
     },
     game: {
+        commandPath: 'chain',
+        titleI18n: { en: 'Chinese Idiom Chain' },
+        descriptionI18n: { en: 'Connect Chinese idioms by sound or character' },
+        quickStartI18n: { en: 'start_pinyin' },
         id: 'chain',
         title: '成语接龙',
         icon: '📜',

package/src/chain-command.ts

@@ -1,25 +1,30 @@
-import {
-  channelKey,
-  type GameMessageLike,
-  type GameReply,
-} from '@zhin.js/game-kit';
+import { formatGameHelp, gameCommandFeedback, gameCommandHint, channelKey, type GameMessageLike, type GameReply } from '@zhin.js/game-kit';
+import { createMessages } from 'zhin.js/i18n';
 import { continueGame, startGame } from './game-flow.js';
 import { idiomCount, modeLabel, promptLine, type MatchMode } from './engine.js';
 
 import type { SessionService } from './session-service.js';
 
-export const CHAIN_HELP = [
-  '📜 成语接龙（文字接龙 · 四字成语）',
-  `开源词库 ${idiomCount()} 条 · 机器人先出第一句`,
-  '接龙 / chain — 帮助',
-  '接龙 开始 / 同音 — 同音接龙（默认，首字同音即可）',
-  '接龙 同字 — 严格同字接龙',
-  '接龙 继续 — 刷新界面',
-  '接龙 放弃 — 结束对局',
-  '',
-  '进行中：直接回复四字成语',
-  '按钮：提示 · 跳过 · 认输（失误 3 次判负）',
-].join('\n');
+
+const messages = createMessages({
+  dictionary: { 'zh-CN': '开源词库 {count} 条 · 机器人先出第一句', en: 'Dictionary: {count} entries · The bot plays first' },
+  pinyin: { 'zh-CN': '{command} — 同音接龙', en: '{command} — Match the pronunciation' },
+  char: { 'zh-CN': '{command} — 严格同字接龙', en: '{command} — Match the character' },
+  instructions: { 'zh-CN': '进行中直接回复四字成语。按钮：提示 · 跳过 · 认输（失误 3 次判负）。', en: 'Reply with four-character Chinese idioms. Options: Hint · Skip · Concede. Three mistakes lose the game.' },
+  active: { 'zh-CN': '进行中：{player} · {mode} · 局分 {playerScore}:{botScore} · 连击 {streak}', en: 'Playing: {player} · {mode} · Score {playerScore}:{botScore} · Streak {streak}' },
+  quit: { 'zh-CN': '已放弃成语接龙。', en: 'You quit the idiom chain.' },
+});
+
+export function getChainHelp(message: Pick<GameMessageLike, 'locale' | 'formatCommand'> = {}): string {
+  const locale = message.locale ?? 'zh-CN';
+  const command = message.formatCommand?.('chain');
+  return [formatGameHelp(message, { 'zh-CN': '📜 成语接龙（文字接龙 · 四字成语）', en: '📜 Chinese Idiom Chain' }, 'chain', ['continue', 'quit']),
+    messages(locale, 'dictionary', { count: idiomCount() }),
+    ...(command ? [messages(locale, 'pinyin', { command: command + ' start_pinyin' }), messages(locale, 'char', { command: command + ' start_char' })] : []),
+    messages(locale, 'instructions'),
+  ].join('\n');
+}
+export const CHAIN_HELP = getChainHelp();
 
 export async function runChainCommand(
   services: SessionService,
@@ -31,15 +36,15 @@ export async function runChainCommand(
 
   if (!action || action === 'help') {
     const active = await services.getActiveByChannel(ch);
-    const lines = [CHAIN_HELP, ''];
+    const lines = [getChainHelp(message), ''];
     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}`,
+        messages(active.locale ?? undefined, 'active', { player: active.player_name, mode: modeLabel(mode, active.locale ?? undefined), playerScore: active.player_score, botScore: active.bot_score, streak: active.streak }),
       );
-      if (active.last_idiom) lines.push(promptLine(active.last_idiom, mode));
+      if (active.last_idiom) lines.push(promptLine(active.last_idiom, mode, active.locale ?? undefined));
     } else {
-      lines.push('暂无对局，发送「接龙 开始」或「接龙 同字」。');
+      lines.push(gameCommandFeedback(message, 'noGame'), gameCommandHint(message, 'chain', 'start_pinyin'));
     }
     return lines.join('\n');
   }
@@ -50,10 +55,10 @@ export async function runChainCommand(
 
   if (action === 'quit') {
     const row = await services.getActiveForUser(ch, userId);
-    if (!row) return '你没有进行中的接龙。';
+    if (!row) return gameCommandFeedback(message, 'noGame');
     await services.updateSession(row.id, { status: 'aborted' });
-    return '已放弃成语接龙。';
+    return messages(row.locale ?? undefined, 'quit');
   }
 
-  return `未知子命令：${action}\n\n${CHAIN_HELP}`;
+  return gameCommandFeedback(message, 'unknown', action) + '\n\n' + getChainHelp(message);
 }

package/src/game-flow.ts

@@ -1,3 +1,4 @@
+import { createMessages, resolveLocale } from 'zhin.js/i18n';
 import type { GameMessageLike, GameReply } from '@zhin.js/game-kit';
 import {
   CHAIN_PREFIX,
@@ -35,6 +36,7 @@ async function botTurn(
   session: ChainSessionRow,
   used: Set<string>,
 ): Promise<{ session: ChainSessionRow; lines: string[]; playerWon: boolean }> {
+  const locale = resolveLocale(session.locale);
   const mode = sessionMode(session);
   const bot = pickBotIdiom(session.last_idiom, mode, used);
   if (!bot) {
@@ -43,7 +45,7 @@ async function botTurn(
       player_score: session.player_score + 1,
     });
     const updated = (await services.getById(session.id))!;
-    return { session: updated, lines: ['🎉 机器人接不上，你赢本局！'], playerWon: true };
+    return { session: updated, lines: [messages(locale, 'text1')], playerWon: true };
   }
 
   used.add(bot.text);
@@ -57,8 +59,8 @@ async function botTurn(
   });
   const updated = (await services.getById(session.id))!;
   const lines = [
-    `🤖 机器人：${bot.text}${gloss ? `（${gloss}）` : ''}`,
-    promptLine(bot.text, mode),
+    messages(locale, 'text2', { p0: bot.text }) + (gloss ? `（${gloss}）` : ''),
+    promptLine(bot.text, mode, locale),
   ];
   return { session: updated, lines, playerWon: false };
 }
@@ -70,11 +72,12 @@ export async function startGame(
 ): Promise<GameReply | undefined> {
   const ch = `${message.$adapter}-${message.$endpoint}-${message.$channel.type}:${message.$channel.id}`;
   const active = await services.getActiveByChannel(ch);
+  const locale = resolveLocale(active ? active.locale : message.locale);
   if (active) {
     if (active.player_id === message.$sender.id) {
-      return '你已有进行中的接龙，发送「接龙 继续」刷新。';
+      return messages(locale, 'text3');
     }
-    return `本频道 ${active.player_name} 正在成语接龙。`;
+    return messages(locale, 'text4', { p0: active.player_name });
   }
 
   const used = new Set<string>();
@@ -89,8 +92,8 @@ export async function startGame(
 
   const gloss = starter.gloss ?? getGloss(starter.text);
   return sendOrEditView(services, message, session, [
-    `🎬 ${modeLabel(matchMode)}开局！我先出：**${starter.text}**${gloss ? `（${gloss}）` : ''}`,
-    promptLine(starter.text, matchMode),
+    messages(locale, 'text5', { p0: modeLabel(matchMode, locale), p1: starter.text }) + (gloss ? `（${gloss}）` : ''),
+    promptLine(starter.text, matchMode, locale),
   ]);
 }
 
@@ -102,7 +105,8 @@ export async function continueGame(
     `${message.$adapter}-${message.$endpoint}-${message.$channel.type}:${message.$channel.id}`,
     message.$sender.id,
   );
-  if (!session) return '你没有进行中的接龙，发送「接龙 开始」。';
+  const locale = resolveLocale(session ? session.locale : message.locale);
+  if (!session) return messages(locale, 'text6');
   return sendOrEditView(services, message, session);
 }
 
@@ -113,6 +117,7 @@ export async function processIdiomText(
 ): Promise<GameReply | null> {
   const ch = `${message.$adapter}-${message.$endpoint}-${message.$channel.type}:${message.$channel.id}`;
   const session = await services.getActiveForUser(ch, message.$sender.id);
+  const locale = resolveLocale(session ? session.locale : message.locale);
   if (!session || session.status !== 'active') return null;
 
   const mode = sessionMode(session);
@@ -120,9 +125,9 @@ export async function processIdiomText(
   const idiom = normalizeInput(raw);
   // 格式不合规（非四字）只提示、不扣失误：避免闲聊（「好的」「谢谢」）被累计判负
   if (!/^[\u4e00-\u9fff]{4}$/.test(idiom)) {
-    return '接龙请输入**四字成语**（这条不算失误）。';
+    return messages(locale, 'text7');
   }
-  const check = validatePlayerIdiom(idiom, session.last_idiom, mode, used);
+  const check = validatePlayerIdiom(idiom, session.last_idiom, mode, used, locale);
   if (!check.ok) {
     const wrong = session.wrong_count + 1;
     if (wrong >= MAX_WRONG) {
@@ -135,7 +140,7 @@ export async function processIdiomText(
       const updated = (await services.getById(session.id))!;
       return (await sendOrEditView(services, message, updated, [
         check.reason!,
-        '失误过多，本局结束。',
+        messages(locale, 'text8'),
       ])) ?? null;
     }
     await services.updateSession(session.id, { wrong_count: wrong, streak: 0 });
@@ -159,7 +164,7 @@ export async function processIdiomText(
   });
 
   const current = (await services.getById(session.id))!;
-  const userLine = `✅ 你：${idiom}${gloss ? `（${gloss}）` : ''}`;
+  const userLine = messages(locale, 'text9', { p0: idiom }) + (gloss ? `（${gloss}）` : '');
 
   const botResult = await botTurn(services, current, used);
   return (await sendOrEditView(services, message, botResult.session, [
@@ -175,16 +180,19 @@ export async function handleChoice(
   choiceId: string,
 ): Promise<GameReply | null> {
   const session = await services.getById(sessionId);
-  if (!session) return '对局不存在。';
-  if (session.player_id !== message.$sender.id) return '这是别人的接龙。';
+  const locale = resolveLocale(session ? session.locale : message.locale);
+  if (!session) return messages(locale, 'text10');
+  if (session.player_id !== message.$sender.id) return messages(locale, 'text11');
 
   const mode = sessionMode(session);
 
   if (choiceId === 'restart') {
+    const locale = resolveLocale(message.locale);
     const used = new Set<string>();
     const starter = pickStarterIdiom(used);
     used.add(starter.text);
     await services.updateSession(session.id, {
+      locale,
       last_idiom: starter.text,
       next_char: lastChar(starter.text),
       used_idioms: JSON.stringify([...used]),
@@ -196,13 +204,13 @@ export async function handleChoice(
     const updated = (await services.getById(session.id))!;
     const gloss = starter.gloss ?? getGloss(starter.text);
     return (await sendOrEditView(services, message, updated, [
-      `🎬 新一局！我先出：**${starter.text}**${gloss ? `（${gloss}）` : ''}`,
-      promptLine(starter.text, mode),
+      messages(locale, 'text12', { p0: starter.text }) + (gloss ? `（${gloss}）` : ''),
+      promptLine(starter.text, mode, locale),
     ])) ?? null;
   }
 
   if (session.status !== 'active') {
-    return '本局已结束，请点击再来一局。';
+    return messages(locale, 'text13');
   }
 
   const used = parseUsed(session.used_idioms);
@@ -214,15 +222,15 @@ export async function handleChoice(
       await services.updateSession(session.id, { status: 'won', player_score: session.player_score + 1 });
       const updated = (await services.getById(session.id))!;
       return (await sendOrEditView(services, message, updated, [
-        '💡 词库中暂无可用提示，你赢了！',
+        messages(locale, 'text14'),
       ])) ?? null;
     }
     const gloss = getGloss(hint);
     await services.updateSession(session.id, { hints_used: session.hints_used + 1, streak: 0 });
     const updated = (await services.getById(session.id))!;
     return (await sendOrEditView(services, message, updated, [
-      `💡 提示：可试 **${hint}**${gloss ? `（${gloss}）` : ''}`,
-      '（使用提示会清零连击）',
+      messages(locale, 'text15', { p0: hint }) + (gloss ? `（${gloss}）` : ''),
+      messages(locale, 'text16'),
     ])) ?? null;
   }
 
@@ -234,17 +242,39 @@ export async function handleChoice(
     });
     const updated = (await services.getById(session.id))!;
     return (await sendOrEditView(services, message, updated, [
-      '⏭️ 你选择跳过，机器人得一分。',
+      messages(locale, 'text17'),
     ])) ?? null;
   }
 
   if (choiceId === 'quit') {
     await services.updateSession(session.id, { status: 'lost', bot_score: session.bot_score + 1 });
     const updated = (await services.getById(session.id))!;
-    return (await sendOrEditView(services, message, updated, ['🏳️ 你认输了。'])) ?? null;
+    return (await sendOrEditView(services, message, updated, [messages(locale, 'text18')])) ?? null;
   }
 
-  return '未知操作。';
+  return messages(locale, 'text19');
 }
 
 export { CHAIN_PREFIX };
+
+const messages = createMessages({
+  text1: { 'zh-CN': "🎉 机器人接不上，你赢本局！", en: "🎉 The bot has no next idiom. You win!" },
+  text2: { 'zh-CN': "🤖 机器人：{p0}", en: "🤖 Bot: {p0}" },
+  text3: { 'zh-CN': "你已有进行中的接龙，请使用当前对局的操作入口继续。", en: "You already have an active idiom chain. Continue using its controls." },
+  text4: { 'zh-CN': "本频道 {p0} 正在成语接龙。", en: "{p0} is playing an idiom chain in this channel." },
+  text5: { 'zh-CN': "🎬 {p0}开局！我先出：**{p1}**", en: "🎬 Starting {p0}! My first idiom: **{p1}**" },
+  text6: { 'zh-CN': "你没有进行中的接龙。", en: "You have no active idiom chain." },
+  text7: { 'zh-CN': "接龙请输入**四字成语**（这条不算失误）。", en: "Enter a **four-character Chinese idiom** (this does not count as a mistake)." },
+  text8: { 'zh-CN': "失误过多，本局结束。", en: "Too many mistakes. This game has ended." },
+  text9: { 'zh-CN': "✅ 你：{p0}", en: "✅ You: {p0}" },
+  text10: { 'zh-CN': "对局不存在。", en: "This game no longer exists." },
+  text11: { 'zh-CN': "这是别人的接龙。", en: "This idiom chain belongs to another player." },
+  text12: { 'zh-CN': "🎬 新一局！我先出：**{p0}**", en: "🎬 New game! My first idiom: **{p0}**" },
+  text13: { 'zh-CN': "本局已结束，请点击再来一局。", en: "This game has ended. Choose Play again." },
+  text14: { 'zh-CN': "💡 词库中暂无可用提示，你赢了！", en: "💡 No next idiom is available in the dictionary. You win!" },
+  text15: { 'zh-CN': "💡 提示：可试 **{p0}**", en: "💡 Hint: try **{p0}**" },
+  text16: { 'zh-CN': "（使用提示会清零连击）", en: "(Using a hint resets your streak)" },
+  text17: { 'zh-CN': "⏭️ 你选择跳过，机器人得一分。", en: "⏭️ You skipped. The bot gets a point." },
+  text18: { 'zh-CN': "🏳️ 你认输了。", en: "🏳️ You conceded." },
+  text19: { 'zh-CN': "未知操作。", en: "Unknown action." },
+});

package/src/idiom-provider.ts

@@ -1,3 +1,4 @@
+import { createMessages, type Locale } from 'zhin.js/i18n';
 /**
  * 成语词库适配层 — 基于 npm `chinese-idiom-chengyu`（MIT，~3 万成语）
  * @see https://www.npmjs.com/package/chinese-idiom-chengyu
@@ -74,8 +75,8 @@ export function lastSyllableNoTone(idiom: string): string {
   return Util.pinyinToLetters(tail);
 }
 
-export function modeLabel(mode: MatchMode): string {
-  return mode === 'char' ? '同字接龙' : '同音接龙';
+export function modeLabel(mode: MatchMode, locale?: Locale): string {
+  return mode === 'char' ? messages(locale, 'text1') : messages(locale, 'text2');
 }
 
 export function getValidNext(
@@ -129,16 +130,17 @@ export function validatePlayerIdiom(
   prevIdiom: string,
   mode: MatchMode,
   used: Set<string>,
+  locale?: Locale,
 ): ValidateResult {
   const idiom = normalizeInput(text);
   if (!FOUR_CHAR.test(idiom)) {
-    return { ok: false, reason: '请输入**四字成语**（不要空格或标点）。' };
+    return { ok: false, reason: messages(locale, 'text3') };
   }
   if (!isKnownIdiom(idiom)) {
-    return { ok: false, reason: '开源词库中未收录该成语，请换一个常见四字成语。' };
+    return { ok: false, reason: messages(locale, 'text4') };
   }
   if (used.has(idiom)) {
-    return { ok: false, reason: '这个成语本局已经用过了。' };
+    return { ok: false, reason: messages(locale, 'text5') };
   }
 
   const valid = getValidNext(prevIdiom, mode, used);
@@ -146,21 +148,33 @@ export function validatePlayerIdiom(
 
   const tail = lastChar(prevIdiom);
   if (mode === 'char') {
-    return { ok: false, reason: `必须以「**${tail}**」开头（上一句尾字）。` };
+    return { ok: false, reason: messages(locale, 'text6', { p0: tail }) };
   }
 
   const py = lastSyllableNoTone(prevIdiom);
   return {
     ok: false,
-    reason: `首字需**同音**（${py}），如「${tail}」音；也可同字「${tail}」开头。`,
+    reason: messages(locale, 'text7', { p0: py, p1: tail, p2: tail }),
   };
 }
 
-export function promptLine(prevIdiom: string, mode: MatchMode): string {
+export function promptLine(prevIdiom: string, mode: MatchMode, locale?: Locale): string {
   const tail = lastChar(prevIdiom);
   if (mode === 'char') {
-    return `请接「**${tail}**」字开头的四字成语`;
+    return messages(locale, 'text8', { p0: tail });
   }
   const py = lastSyllableNoTone(prevIdiom);
-  return `请接**同音**「${py}」（尾字「${tail}」）开头的四字成语`;
-}
+  return messages(locale, 'text9', { p0: py, p1: tail });
+}
+
+const messages = createMessages({
+  text1: { 'zh-CN': "同字接龙", en: "Matching character" },
+  text2: { 'zh-CN': "同音接龙", en: "Matching pronunciation" },
+  text3: { 'zh-CN': "请输入**四字成语**（不要空格或标点）。", en: "Enter a **four-character Chinese idiom** without spaces or punctuation." },
+  text4: { 'zh-CN': "开源词库中未收录该成语，请换一个常见四字成语。", en: "This idiom is not in the dictionary. Try a common four-character idiom." },
+  text5: { 'zh-CN': "这个成语本局已经用过了。", en: "This idiom has already been used in this game." },
+  text6: { 'zh-CN': "必须以「**{p0}**」开头（上一句尾字）。", en: "The idiom must start with **{p0}**, the last character of the previous idiom." },
+  text7: { 'zh-CN': "首字需**同音**（{p0}），如「{p1}」音；也可同字「{p2}」开头。", en: "The first character must have the **same pronunciation** ({p0}) as “{p1}”, or be the character “{p2}”." },
+  text8: { 'zh-CN': "请接「**{p0}**」字开头的四字成语", en: "Enter a four-character idiom starting with **{p0}**" },
+  text9: { 'zh-CN': "请接**同音**「{p0}」（尾字「{p1}」）开头的四字成语", en: "Enter a four-character idiom whose first character sounds like **{p0}** (last character: “{p1}”)" },
+});

package/src/models.ts

@@ -7,6 +7,7 @@ declare module '@zhin.js/core' {
   interface Models {
     idiom_chain_sessions: {
       id: string;
+      locale?: 'zh-CN' | 'en' | null;
       adapter: string;
       endpoint: string;
       channel_type: string;
@@ -36,10 +37,11 @@ export type ChainSessionRow = Models['idiom_chain_sessions'];
 
 
 export function defineHostTables(
-  db: { define: (name: string, definition: Record<string, unknown>) => void },
+  db: { define: (name: string, definition: Record<string, unknown>, options?: { readonly addColumns?: readonly string[] }) => void },
 ): void {
   db.define('idiom_chain_sessions', {
     id: { type: 'text', primary: true },
+    locale: { type: 'text', nullable: true },
     adapter: { type: 'text', nullable: false },
     endpoint: { type: 'text', nullable: false },
     channel_type: { type: 'text', nullable: false },
@@ -61,5 +63,5 @@ export function defineHostTables(
     status: { type: 'text', default: 'active' },
     updated_at: { type: 'bigint', default: 0 },
     created_at: { type: 'bigint', default: 0 },
-  });
+  }, { addColumns: ['locale'] });
 }

package/src/session-service.ts

@@ -42,6 +42,7 @@ export class SessionService extends BaseSessionService<ChainSessionRow> {
     const now = Date.now();
     const row: ChainSessionRow = {
       id: generateSessionId(),
+      locale: message.locale ?? 'zh-CN',
       adapter: String(message.$adapter),
       endpoint: message.$endpoint,
       channel_type: message.$channel.type,