dsh-blackjack 0.1.5 → 0.2.1

package/dist/i18n/messages.js

@@ -0,0 +1,33 @@
+/**
+ * 面向玩家的全部文案，按 locale 分成两份实现。
+ *
+ * 为什么是"接口 + 两个实现"而不是 t(key) 查表：`satisfies Messages` 让漏翻一条
+ * 直接编译失败，根本发不出去；查表方案漏翻通常只是静默回退或输出 key。这个项目
+ * 已经因为"同一句话在两处不同步"吃过两次亏，多语言会把这个风险乘以二。
+ *
+ * 为什么每条是函数而不是模板串：中文没有复数、英文有（1 hand / 2 hands），语序
+ * 也不同。函数让两种语言各自把话说顺。
+ */
+export const LOCALES = ['zh', 'en'];
+/**
+ * 英文文案的红线，对标 render.ts 的 `BANNED`。
+ *
+ * 曾经写作 `/gambl|casino|\bwager\b|\bbet\b|real money/i`，只挡五个字面 token，
+ * 比中文那条松得多，而且松在两个地方：
+ *
+ * 一是词形。`\bbet\b` 的词边界在 bet 之后就断了，bets / betting / bettor 全部
+ * 漏网——而这三个正是英文里真正会写出来的形态，光秃秃的 "bet" 反而少见。
+ *
+ * 二是概念。中文的 `赢钱` 禁的是"把赢来的东西说成钱"这件事本身，英文这边却
+ * 只禁 real money，cash out / winnings / payout / jackpot 一律放行。这个项目的
+ * 全部合规站位就建立在"赢来的 CHIP 不是钱、不可提现"上，用 payout 或 winnings
+ * 描述结算，等于在文案层面把这条站位拆掉。
+ *
+ * 收紧的时机是现在而不是以后：后面还有五个任务要写新的英文文案，每一条都按
+ * 这条正则验收。先把线划到位，比等文案写完再回头重审所有文案便宜得多。
+ *
+ * 词边界要当心：`bett?` 单独用会误伤 better/betterment，所以后缀写成显式的
+ * `(?:s|ing|or|ors)?` 再收一个 `\b`。i18n.test.ts 里有一张"必须拦下"和一张
+ * "不许误伤"的清单钉住这两侧。
+ */
+export const BANNED_EN = /gambl|casino|\bwager(?:s|ing|ed)?\b|\bbett?(?:s|ing|or|ors)?\b|real money|\bcash(?:ing|es|ed)?[\s-]?out|winnings|payout|jackpot/i;

package/dist/i18n/zh.d.ts

@@ -0,0 +1,112 @@
+export declare const zh: {
+    freeStakeLine: (bet: number) => string;
+    raiseStakeLine: (bet: number) => string;
+    freeWin: (payout: number) => string;
+    freeLose: () => string;
+    freePush: () => string;
+    raiseWin: (payout: number, bet: number) => string;
+    raiseLose: (bet: number) => string;
+    raisePush: (bet: number) => string;
+    handLabel: () => string;
+    splitHandLabel: (handIndex: number) => string;
+    dealerLabel: () => string;
+    totalInParens: (total: number, isSoft: boolean) => string;
+    doubled: () => string;
+    actionsPrefix: () => string;
+    actionLabels: {
+        hit: string;
+        stand: string;
+        double: string;
+        split: string;
+        insure: string;
+        decline: string;
+    };
+    actionsSeparator: () => string;
+    balanceLine: (chips: number, exchangedChips: number) => string;
+    freeHandsLine: (freeHandsRemaining: number, seasonId: string) => string;
+    thresholdLine: (exchangeThresholdChips: number) => string;
+    pointsLine: (points: number) => string;
+    poolEmptyNotice: () => string;
+    pointsGrantedNotice: (points: number) => string;
+    chipValidityNotice: () => string;
+    consentText: () => string;
+    agreeHint: () => string;
+    noRoundHint: () => string;
+    commandUsage: () => string;
+    actionDescriptions: {
+        hit: string;
+        stand: string;
+        double: string;
+        split: string;
+        insure: string;
+        decline: string;
+    };
+    blackjackCommandDescription: () => string;
+    genericFailure: () => string;
+    serviceUnreachable: () => string;
+    dailyFreeHandsExhausted: () => string;
+    belowExchangeThreshold: (thresholdChips: number) => string;
+    insufficientBalance: () => string;
+    roundAlreadyInProgress: () => string;
+    githubBindingRequired: () => string;
+    seasonCapReached: (capChips: number, exchangedThisSeasonChips: number) => string;
+    exchangeUnavailable: () => string;
+    betAmountAboveLimit: (maxChips: number) => string;
+    illegalAction: () => string;
+    registerRateLimited: () => string;
+    unknownPlayerToken: () => string;
+    agreeWelcome: () => string;
+    invalidBetAmount: () => string;
+    pairingInstructions: (url: string, minutes: number) => string;
+    exchangeAmountPrompt: (githubLogin: string, chips: number, exchangeThresholdChips: number) => string;
+    invalidExchangeAmount: () => string;
+    exchangeSuccess: (chips: number, exchangedChips: number) => string;
+    exchangedQuotaNote: (inactiveRecycleDays: number, expiresAtSeasonEnd: boolean) => string;
+    resetConfirmPrompt: () => string;
+    resetDone: () => string;
+    unknownSubcommand: (sub: string, usage: string) => string;
+    poolSwitchNotice: () => string;
+    poolFallbackFailed: (reason: string) => string;
+    poolFallbackBusy: () => string;
+    noCredentialHint: () => string;
+    hiddenCardLabel: () => string;
+    tableHandLabel: () => string;
+    tableSplitHandLabel: (handIndex: number) => string;
+    tableDealerLabel: () => string;
+    tableActionLabels: {
+        hit: string;
+        stand: string;
+        double: string;
+        split: string;
+        insure: string;
+        decline: string;
+    };
+    tableBalanceHeader: (chips: number, freeHandsRemaining: number) => string;
+    tablePointsSuffix: (points: number) => string;
+    tableExchangedSuffix: (exchangedChips: number) => string;
+    tableExchangeThresholdReached: (exchangeThresholdChips: number) => string;
+    tableExchangeThresholdShort: (shortChips: number, exchangeThresholdChips: number) => string;
+    tableExchangedQuotaNote: (exchangedChips: number) => string;
+    tablePoolEmptyNotice: () => string;
+    actionShortfallHint: (costChips: number) => string;
+    tableCostSuffix: (costChips: number) => string;
+    betAmountMissing: () => string;
+    betAmountExceedsCap: (maxChips: number) => string;
+    betAmountExceedsBalance: () => string;
+    customBetToggle: () => string;
+    customBetSubmit: () => string;
+    customBetRange: (maxChips: number) => string;
+    noActiveRoundNotice: () => string;
+    freeHandsGroupTitle: () => string;
+    freeHandsRemainingToday: (freeHandsRemaining: number) => string;
+    freeHandsExhaustedToday: () => string;
+    freeHandExplainer: (baseChips: number, naturalBlackjackPayoutChips: number) => string;
+    startFreeHandButton: () => string;
+    raiseGroupTitle: () => string;
+    insufficientBalanceSuffix: () => string;
+    raiseExplainer: () => string;
+    rematchFreeLabel: () => string;
+    dealButtonFreeHandsSuffix: (freeHandsRemaining: number) => string;
+    dismissButton: () => string;
+    actionFailedNotice: () => string;
+};

package/dist/i18n/zh.js

@@ -0,0 +1,170 @@
+const n = (v) => v.toLocaleString('en-US');
+export const zh = {
+    freeStakeLine: (bet) => `这是免费的一局：赢了拿 ${n(bet)} CHIP，输了不损失任何东西。`,
+    raiseStakeLine: (bet) => `本局已加注 ${n(bet)} CHIP，从你的余额里出。`,
+    freeWin: (payout) => `赢了，拿到 ${n(payout)} CHIP。`,
+    freeLose: () => '这手输了。免费手不损失任何东西。',
+    freePush: () => '平局。这手不损失也不获得。',
+    raiseWin: (payout, bet) => `赢了，拿回 ${n(payout)} CHIP（加注 ${n(bet)}）。`,
+    raiseLose: (bet) => `这手输了，加注的 ${n(bet)} CHIP 收不回。`,
+    raisePush: (bet) => `平局。加注的 ${n(bet)} CHIP 原样退回。`,
+    handLabel: () => '你的牌：',
+    splitHandLabel: (handIndex) => `你的第 ${handIndex} 手：`,
+    dealerLabel: () => '庄家：',
+    totalInParens: (total, isSoft) => `（${isSoft ? '软' : ''}${total}）`,
+    doubled: () => ' [双倍]',
+    actionsPrefix: () => '可选：',
+    actionLabels: {
+        hit: '/bj-hit 要牌',
+        stand: '/bj-stand 停牌',
+        double: '/bj-double 双倍',
+        split: '/bj-split 分牌',
+        insure: '/bj-insure 买保险',
+        decline: '/bj-decline 不买保险',
+    },
+    actionsSeparator: () => '　',
+    balanceLine: (chips, exchangedChips) => `余额：${n(chips)} CHIP　已兑换额度：${n(exchangedChips)} CHIP`,
+    freeHandsLine: (freeHandsRemaining, seasonId) => `今日剩余免费手：${freeHandsRemaining}　赛季：${seasonId}`,
+    thresholdLine: (exchangeThresholdChips) => `兑换门槛：${n(exchangeThresholdChips)} CHIP（达标后可用 /blackjack exchange 兑换）`,
+    pointsLine: (points) => `积分：${n(points)}`,
+    poolEmptyNotice: () => '提示：本期奖池已发完，现在赢牌将发放积分。',
+    pointsGrantedNotice: (points) => `本期奖池已发完，改为发放 ${n(points)} 积分。`,
+    chipValidityNotice: () => '（赛季结束时，未达兑换门槛的 CHIP 会折算为积分并回收；达标的结转）',
+    // 第四条的措辞是运营者单独批准改的，不属于本分支"中文只搬运不改写"的范围
+    // （改动理由与授权见 messages.ts 里 consentText 的文档）。原句只披露了赛季末
+    // 回收，而服务端 jobs.ts 的 recycleInactive 每天 00:15 跑一次，对
+    // `inactive_recycle_days`（当前 7 天）内无游戏且无消费的账户调 recycleAll——
+    // 游戏余额和已兑换额度**一起清零**，而且是**赛季中途**就发生。一个赢了 CHIP、
+    // 停手一周、回来发现余额归零的玩家，在他点"同意"的那一刻什么都没被告知。
+    // 仍然不写天数：`inactive_recycle_days` 是运营者可调的配置，写死数字就是又
+    // 一次"文案比代码更精确"的假承诺（这个项目已经为这个形状翻过两次车）。
+    consentText: () => [
+        '【首次使用请先阅读】',
+        '· 这是社区开发者发布的第三方小游戏，与任何模型厂商均无关联，不代表其立场。',
+        '· 参与免费：每日有限次免费手，输了不扣任何东西，你自己的密钥与余额不受影响。',
+        '· 赢得的 CHIP 只能在本插件内兑换为模型额度消费：不可提现、不可转让、不可转入任何厂商账户。',
+        '· 奖励有赛季有效期，赛季结束后、或长期不活跃时，未使用的部分按规则回收。',
+        '',
+        '阅读并同意以上内容后，执行 /blackjack agree confirm 开始。',
+    ].join('\n'),
+    agreeHint: () => '请先阅读须知并执行 /blackjack agree 后再使用。',
+    noRoundHint: () => '当前没有进行中的牌局，先用 /blackjack deal 开一局。',
+    commandUsage: () => 'agree | deal [注额] | exchange [数量] | reset',
+    actionDescriptions: {
+        hit: '21 点：向牌桌要一张牌',
+        stand: '21 点：停牌，进入结算',
+        double: '21 点：加倍注额并再要一张牌',
+        split: '21 点：把一对相同点数的牌分成两手',
+        insure: '21 点：庄家明牌为 A 时购买保险',
+        decline: '21 点：不购买保险',
+    },
+    blackjackCommandDescription: () => '21 点牌桌（需先进入会话）：查看状态、开局、兑换额度、重置凭证',
+    genericFailure: () => '操作没有成功，请稍后再试。',
+    serviceUnreachable: () => '暂时连不上牌桌服务，请稍后再试。',
+    dailyFreeHandsExhausted: () => '今天的免费手用完了，明天再来。',
+    belowExchangeThreshold: (thresholdChips) => `余额还没到兑换门槛（需要 ${n(thresholdChips)} CHIP）。`,
+    insufficientBalance: () => '余额不足以完成这个动作。',
+    roundAlreadyInProgress: () => '已经有一局在进行中。',
+    // 不建议玩家重新执行 /blackjack exchange——那正是触发这个 code 的那条命令，
+    // 重新执行只会命中"请补上数量"的提示，不是一条真的能走通的恢复路径（详见
+    // messages.ts 里这个方法的文档：核实过服务端没有任何路径能让这个状态发生）。
+    githubBindingRequired: () => '这个钱包的 GitHub 绑定状态有问题，暂时无法直接兑换。请稍后再试；如果一直这样，请联系运营者处理。',
+    seasonCapReached: (capChips, exchangedThisSeasonChips) => `这笔会超过本赛季兑换总额上限（上限 ${n(capChips)} CHIP，本赛季已兑换 ${n(exchangedThisSeasonChips)} CHIP）。`,
+    exchangeUnavailable: () => '兑换功能暂时不可用（运营者部署未配置完整），牌局本身不受影响，请稍后再试。',
+    betAmountAboveLimit: (maxChips) => `注额超过上限，最多可下注 ${n(maxChips)} CHIP。`,
+    illegalAction: () => '这个动作现在不可用了，牌局状态可能已经变化，请用 /blackjack 查看最新状态。',
+    registerRateLimited: () => '当前网络注册次数过多，请稍后再试。',
+    // 两条命令都要点名：只 reset 不 agree 拿不到新令牌，只 agree 不 reset 会被
+    // identity.accept() 的 `if (existing) return existing` 原样退回那枚坏令牌
+    // （见 messages.ts 里这条方法的文档，恢复路径是照着代码核对过的）。
+    unknownPlayerToken: () => '这台机器上的牌桌凭证，服务端已经不认识了（服务端重置过，或者 serverUrl 改指到了另一个部署）。请先执行 /blackjack reset confirm 清掉它，再执行 /blackjack agree 重新开始。',
+    agreeWelcome: () => [
+        '已确认须知，欢迎上桌。',
+        '/blackjack deal 开始今天的免费手，或 /blackjack deal <注额> 用余额加注。',
+    ].join('\n'),
+    invalidBetAmount: () => '注额必须是正整数。',
+    pairingInstructions: (url, minutes) => [
+        '首次兑换要先绑定 GitHub，只需做这一次。',
+        '',
+        '请在浏览器里打开这个链接：',
+        url,
+        '',
+        '打开后点「用 GitHub 继续」授权，然后在同一个页面填写要兑换的数量并提交。',
+        `链接约 ${minutes} 分钟内有效；过期了就再执行一次 /blackjack exchange 拿一个新的。`,
+        '绑定完成后，以后直接用 /blackjack exchange <数量> 兑换，不用再开浏览器。',
+    ].join('\n'),
+    exchangeAmountPrompt: (githubLogin, chips, exchangeThresholdChips) => [
+        `已绑定 GitHub 账号：${githubLogin}`,
+        `当前余额：${n(chips)} CHIP　兑换门槛：${n(exchangeThresholdChips)} CHIP`,
+        '请用 /blackjack exchange <数量> 指定要兑换的 CHIP 数量。',
+    ].join('\n'),
+    invalidExchangeAmount: () => '兑换数量必须是正整数。',
+    exchangeSuccess: (chips, exchangedChips) => [
+        `已兑换 ${n(chips)} CHIP。`,
+        `累计已兑换额度：${n(exchangedChips)} CHIP`,
+        '这份额度会在你自己的模型额度耗尽时，自动接管那一次失败的请求；平时不会动用，你不需要做任何事。',
+    ].join('\n'),
+    // 原句从服务端 exchangedQuotaNote() 搬运，字节不变——这是 Task 6 的要求：
+    // 这句话的分寸是踩过两次坑才校准的（有效期至本赛季末是一句代码不兑现的
+    // 承诺），移动过程中不能顺手"顺一顺"措辞。
+    // expiresAtSeasonEnd 为 true 时只把中间那半句拿掉（承接的「但」跟着去掉，
+    // 否则前面没有转折可承接），不反过来说"会在赛季末清零"——服务端只说了"会
+    // 过期"，没说什么时候、按什么比例，补一个细节出来就是再造一次假承诺。
+    // 今天服务端恒发 false（seasonSettle 从头到尾不碰 exchanged_micro），这条
+    // 分支是为"哪天真改了"准备的，见 messages.ts 里这条方法的文档。
+    exchangedQuotaNote: (inactiveRecycleDays, expiresAtSeasonEnd) => expiresAtSeasonEnd
+        ? `已兑换额度仅限本插件内消费，不可提现、不可转让。连续 ${inactiveRecycleDays} 天无游戏且无消费的账户，余额会被回收进奖池。`
+        : `已兑换额度仅限本插件内消费，不可提现、不可转让。它不会因赛季结束而清零；但连续 ${inactiveRecycleDays} 天无游戏且无消费的账户，余额会被回收进奖池。`,
+    resetConfirmPrompt: () => '这会清除本机保存的牌桌凭证（不影响服务端记录，重新配对即可找回）。确认请执行 /blackjack reset confirm',
+    resetDone: () => '已清除本机凭证，可用 /blackjack agree 重新开始。',
+    unknownSubcommand: (sub, usage) => `未知子命令「${sub}」。可用：${usage}`,
+    poolSwitchNotice: () => '已切换至奖池余额继续本次请求。',
+    poolFallbackFailed: (reason) => `你自己的模型额度已耗尽，奖池接管了这次请求但也没成功（奖池：${reason}）。已兑换额度没有被扣。`,
+    poolFallbackBusy: () => '你自己的模型额度已耗尽，奖池接管了这次请求，但同时进行的请求太多被挡下了。已兑换额度没有被扣，稍等一下再试。',
+    noCredentialHint: () => '续命只在你自己的模型额度耗尽时接管；当前是没有配置 key，所以用不到你已兑换的额度。',
+    hiddenCardLabel: () => '暗牌',
+    tableHandLabel: () => '你的牌',
+    tableSplitHandLabel: (handIndex) => `你的第 ${handIndex} 手`,
+    tableDealerLabel: () => '庄家',
+    tableActionLabels: {
+        hit: '要牌',
+        stand: '停牌',
+        double: '双倍',
+        split: '分牌',
+        insure: '买保险',
+        decline: '不买保险',
+    },
+    tableBalanceHeader: (chips, freeHandsRemaining) => `余额：${n(chips)} CHIP　今日剩余免费手：${freeHandsRemaining}`,
+    tablePointsSuffix: (points) => `　积分：${n(points)}`,
+    tableExchangedSuffix: (exchangedChips) => `　已兑换额度：${n(exchangedChips)} CHIP`,
+    tableExchangeThresholdReached: (exchangeThresholdChips) => `已达兑换门槛（${n(exchangeThresholdChips)} CHIP）· 用 /blackjack exchange 把 CHIP 换成模型额度`,
+    tableExchangeThresholdShort: (shortChips, exchangeThresholdChips) => `还差 ${n(shortChips)} CHIP 到兑换门槛（${n(exchangeThresholdChips)}）· 过线后可用 /blackjack exchange 换成模型额度`,
+    tableExchangedQuotaNote: (exchangedChips) => `已兑换的 ${n(exchangedChips)} CHIP 会在你自己的模型额度耗尽时自动接管那一次请求，平时不会动用。`,
+    tablePoolEmptyNotice: () => '（本期奖池已发完，现在赢牌将发放积分）',
+    actionShortfallHint: (costChips) => `还要再出 ${n(costChips)} CHIP，余额不足`,
+    tableCostSuffix: (costChips) => `（${n(costChips)}）`,
+    betAmountMissing: () => '请输入注额。',
+    betAmountExceedsCap: (maxChips) => `单局最多 ${n(maxChips)} CHIP。`,
+    betAmountExceedsBalance: () => '余额不足以下这个注。',
+    customBetToggle: () => '自定义注额',
+    customBetSubmit: () => '开始',
+    customBetRange: (maxChips) => `1 ～ ${n(maxChips)} CHIP`,
+    noActiveRoundNotice: () => '当前没有进行中的牌局。',
+    freeHandsGroupTitle: () => '免费手',
+    freeHandsRemainingToday: (freeHandsRemaining) => ` · 今日剩 ${freeHandsRemaining} 手`,
+    freeHandsExhaustedToday: () => ' · 今日已用完，明天再来',
+    freeHandExplainer: (baseChips, naturalBlackjackPayoutChips) => `不用出 CHIP。赢了拿 ${n(baseChips)} CHIP；头两张牌就凑成 21 点（A 配 10/J/Q/K）拿 ${n(naturalBlackjackPayoutChips)}。输了或平局都不损失任何东西。`,
+    startFreeHandButton: () => '开始免费的一局',
+    raiseGroupTitle: () => '用余额加注',
+    insufficientBalanceSuffix: () => ' · 余额不足',
+    raiseExplainer: () => '加注的 CHIP 从你的余额里出，赢了翻倍，输了收不回。',
+    // 全角括号自己开自己闭：这颗按钮渲染出来是 `再来一局（免费）·剩 3 手`，
+    // 后缀 `dealButtonFreeHandsSuffix` 不带右括号（英文那版 `Play again (free)`
+    // 从一开始就是闭合的——同一颗按钮，两个 locale 对"这是不是个 bug"给了相反
+    // 的答案）。少一个右括号的写法在图形牌桌最常被点的按钮上活了这么久，唯一的
+    // 原因是从没有任何断言拼完整之后的整串；client.test.tsx 现在钉住渲染结果本身。
+    rematchFreeLabel: () => '再来一局（免费）',
+    dealButtonFreeHandsSuffix: (freeHandsRemaining) => `·剩 ${freeHandsRemaining} 手`,
+    dismissButton: () => '收起',
+    actionFailedNotice: () => '上一次操作没有成功，已为你刷新到最新状态。',
+};

package/dist/index.js

@@ -2,6 +2,7 @@ import { createApi } from './api.js';
 import { registerCommands } from './commands.js';
 import { Config, PLUGIN_NAME } from './config.js';
 import { createIdentity } from './identity.js';
+import { resolveMessages } from './i18n/index.js';
 import { registerRouter } from './router.js';
 import { registerRoutes } from './routes.js';
 export const name = PLUGIN_NAME;
@@ -20,13 +21,19 @@ export function apply(ctx, config) {
         return;
     const api = createApi({ serverUrl: config.serverUrl });
     const identity = createIdentity(ctx, api);
-    registerCommands(ctx, { api, identity });
+    // Node 侧读不到宿主（dsh 客户端）的语言设置——`ctx.settings.get('locale')`
+    // 这个 namespace 的 owner 是个 client 插件，host 作用域里没有它的注册者，
+    // 三次尝试自己挂这个 namespace 都在模块解析上失败（细节见 spec）。所以命令
+    // 面的语言只能来自插件自己的配置项，不是"读不到就退化"，是设计本身。
+    // 图形牌桌是另一条链路（浏览器能读到宿主设置），归下一个任务管，这里不碰。
+    const m = resolveMessages(config.locale);
+    registerCommands(ctx, { api, identity, m });
     // The switch notice goes to ctx.logger.info and nowhere else — never a
     // session message, so a fallback can never pollute model-visible
     // conversation history. That also means the player does not normally SEE
     // it; see the known-limitation note on `registerRouter` for why no
     // in-conversation channel is reachable from a waterfall listener here.
-    registerRouter(ctx, { serverUrl: config.serverUrl, identity });
+    registerRouter(ctx, { serverUrl: config.serverUrl, identity, m });
     // The graphical table's HTTP surface is a NESTED plugin injecting
     // `webServer` — a headless/tui host simply leaves this fiber pending
     // (no `webServer` service to satisfy the inject) while the commands

package/dist/render.d.ts

@@ -1,4 +1,5 @@
 import type { Card, HiddenCard, MeView, RoundView } from './api.js';
+import type { Messages } from './i18n/index.js';
 /**
  * Regex of vocabulary this project's copy must never contain (parent spec §2
  * red line 6, 文案去赌场化).
@@ -10,7 +11,6 @@ import type { Card, HiddenCard, MeView, RoundView } from './api.js';
  * which meant tightening one copy silently left the other looser.
  */
 export declare const BANNED: RegExp;
-export declare const CONSENT_TEXT: string;
 export declare function renderCard(card: Card | HiddenCard): string;
-export declare function renderRound(view: RoundView): string;
-export declare function renderMe(me: MeView): string;
+export declare function renderRound(view: RoundView, m: Messages): string;
+export declare function renderMe(me: MeView, m: Messages): string;

package/dist/render.js

@@ -11,61 +11,49 @@ const SUITS = { S: '♠', H: '♥', D: '♦', C: '♣' };
  * which meant tightening one copy silently left the other looser.
  */
 export const BANNED = /赌|博彩|casino|赢钱|下注赢|筹码/i;
-export const CONSENT_TEXT = [
-    '【首次使用请先阅读】',
-    '· 这是社区开发者发布的第三方小游戏，与任何模型厂商均无关联，不代表其立场。',
-    '· 参与免费：每日有限次免费手，输了不扣任何东西，你自己的密钥与余额不受影响。',
-    '· 赢得的 CHIP 只能在本插件内兑换为模型额度消费：不可提现、不可转让、不可转入任何厂商账户。',
-    '· 奖励有赛季有效期，赛季结束后未使用的部分按规则回收。',
-    '',
-    '阅读并同意以上内容后，执行 /blackjack agree confirm 开始。',
-].join('\n');
 export function renderCard(card) {
     if ('hidden' in card)
         return '??';
     return `${card.rank}${SUITS[card.suit] ?? card.suit}`;
 }
-const n = (v) => v.toLocaleString('en-US');
-export function renderRound(view) {
+export function renderRound(view, m) {
     const lines = [];
     for (const [i, hand] of view.hands.entries()) {
-        const label = view.hands.length > 1 ? `你的第 ${i + 1} 手` : '你的牌';
+        const label = view.hands.length > 1 ? m.splitHandLabel(i + 1) : m.handLabel();
         const cards = hand.cards.map(renderCard).join(' ');
-        const soft = hand.soft ? '软' : '';
-        lines.push(`${label}：${cards}（${soft}${hand.total}）${hand.doubled ? ' [双倍]' : ''}`);
+        lines.push(`${label}${cards}${m.totalInParens(hand.total, hand.soft)}${hand.doubled ? m.doubled() : ''}`);
     }
     const dealer = view.dealer.cards.map(renderCard).join(' ');
-    lines.push(`庄家：${dealer}${view.dealer.total !== undefined ? `（${view.dealer.total}）` : ''}`);
+    const dealerTotal = view.dealer.total !== undefined ? m.totalInParens(view.dealer.total, false) : '';
+    lines.push(`${m.dealerLabel()}${dealer}${dealerTotal}`);
     if (view.phase === 'settled') {
         const won = view.payoutChips ?? 0;
-        lines.push(outcomeLine(view));
+        lines.push(outcomeLine(view, m));
         if (view.pointsGranted)
-            lines.push(`本期奖池已发完，改为发放 ${n(view.pointsGranted)} 积分。`);
+            lines.push(m.pointsGrantedNotice(view.pointsGranted));
+        // 按事实：赛季结算只回收**未达兑换门槛**的余额（折算积分），达标的结转。
         if (won > 0)
-            lines.push('（已获得的 CHIP 有效期至本赛季末）');
+            lines.push(m.chipValidityNotice());
     }
     else {
-        lines.push(stakeLine(view));
-        const map = {
-            hit: '/bj-hit 要牌', stand: '/bj-stand 停牌', double: '/bj-double 双倍',
-            split: '/bj-split 分牌', insure: '/bj-insure 买保险', decline: '/bj-decline 不买保险',
-        };
-        const actions = view.actions.map((a) => map[a] ?? a).join('　');
+        lines.push(stakeLine(view, m));
+        const actionLabels = m.actionLabels;
+        const actions = view.actions.map((a) => actionLabels[a] ?? a).join(m.actionsSeparator());
         if (actions)
-            lines.push(`可选：${actions}`);
+            lines.push(`${m.actionsPrefix()}${actions}`);
     }
     return lines.join('\n');
 }
-export function renderMe(me) {
+export function renderMe(me, m) {
     const lines = [
-        `余额：${n(me.chips)} CHIP　已兑换额度：${n(me.exchangedChips)} CHIP`,
-        `今日剩余免费手：${me.freeHandsRemaining}　赛季：${me.seasonId}`,
-        `兑换门槛：${n(me.exchangeThresholdChips)} CHIP（达标后可用 /blackjack exchange 兑换）`,
+        m.balanceLine(me.chips, me.exchangedChips),
+        m.freeHandsLine(me.freeHandsRemaining, me.seasonId),
+        m.thresholdLine(me.exchangeThresholdChips),
     ];
     if (me.points > 0)
-        lines.push(`积分：${n(me.points)}`);
+        lines.push(m.pointsLine(me.points));
     if (me.poolEmpty)
-        lines.push('提示：本期奖池已发完，现在赢牌将发放积分。');
+        lines.push(m.poolEmptyNotice());
     if (me.sponsorText)
         lines.push(me.sponsorText);
     return lines.join('\n');

package/dist/router.d.ts

@@ -1,6 +1,7 @@
 import type { Context } from '@deepseek-ai/cordis';
 import { type GenerateOptions, type StreamChunk } from '@deepseek-ai/dsh-llm';
 import type { Identity } from './identity.js';
+import type { Messages } from './i18n/index.js';
 /** Provider route the pool adapter is registered under; also the loop-guard for `shouldFallback`. */
 export declare const POOL_PROVIDER = "blackjack-pool";
 /**
@@ -27,6 +28,8 @@ export declare function shouldFallback(input: {
     hasToken: boolean;
     provider: string;
 }): boolean;
+/** 抛出来的错误是否读作"没配 key"。 */
+export declare function isMissingCredentialError(error: unknown): boolean;
 /**
  * 这次失败是否该提示玩家"你有已兑换额度，但续命现在用不上"。
  *
@@ -35,9 +38,6 @@ export declare function shouldFallback(input: {
  * MISSING_CREDENTIAL，于是什么都没发生，也没有任何东西解释为什么。这里只负责
  * 说明，不改变任何行为——原始失败照样原样透传。
  */
-export declare const NO_CREDENTIAL_HINT = "\u7EED\u547D\u53EA\u5728\u4F60\u81EA\u5DF1\u7684\u6A21\u578B\u989D\u5EA6\u8017\u5C3D\u65F6\u63A5\u7BA1\uFF1B\u5F53\u524D\u662F\u6CA1\u6709\u914D\u7F6E key\uFF0C\u6240\u4EE5\u7528\u4E0D\u5230\u4F60\u5DF2\u5151\u6362\u7684\u989D\u5EA6\u3002";
-/** 抛出来的错误是否读作"没配 key"。 */
-export declare function isMissingCredentialError(error: unknown): boolean;
 export declare function shouldHintNoCredential(input: {
     finish: StreamChunk & {
         type: 'finish';
@@ -50,6 +50,18 @@ export interface FallbackDeps {
     notify: (line: string) => void;
     /** Diagnostic-only sink for a swallowed pool-retry failure; never required, never surfaced to the player. */
     logError?: (error: unknown) => void;
+    /**
+     * Locale-resolved copy for the two player-facing strings this module ever
+     * produces itself (the pool-switch notice and the no-credential hint).
+     * Required, not defaulted: this is the fallback route, the one code path
+     * this whole product exists for, and a silent default is exactly the
+     * failure mode the plugin's i18n migration exists to eliminate — a caller
+     * that forgets this argument should fail to compile, not quietly speak
+     * the wrong language. Every call site (including the three test files
+     * that call `runWithFallback`/`registerRouter` directly) passes it
+     * explicitly.
+     */
+    m: Messages;
 }
 /**
  * Wrap one model call: pass everything through, and only when the call ends
@@ -73,6 +85,21 @@ export interface FallbackDeps {
  *   entirely once a fallback is underway — the pool call reports its own —
  *   instead of both being forwarded and double-counting tokens.
  */
+/**
+ * 奖池也失败时，替换交还给宿主的失败**消息**，保留 `code`/`status` 等机器字段。
+ *
+ * 原样交还原始失败是有意的（"装了这个插件不会让任何调用变差"），但那条消息说的是
+ * 玩家自己额度不足——他明明有已兑换额度，续命也确实接管了，只是奖池这侧没成。
+ * 假话出现在他最需要看懂的时刻，所以人读的那半必须换掉。
+ */
+export declare function withTruthfulMessage(original: StreamChunk & {
+    type: 'finish';
+}, poolFailure: {
+    code?: string;
+    message?: string;
+}, m: Messages): StreamChunk & {
+    type: 'finish';
+};
 export declare function runWithFallback(options: GenerateOptions, next: () => AsyncIterable<StreamChunk>, deps: FallbackDeps): AsyncIterable<StreamChunk>;
 /**
  * Register the pool-route adapter and hang the `llm/stream` fallback
@@ -114,4 +141,5 @@ export declare function registerRouter(ctx: Context, deps: {
     serverUrl: string;
     identity: Identity;
     notify?: (line: string) => void;
+    m: Messages;
 }): void;

package/dist/router.js

@@ -49,6 +49,13 @@ export function shouldFallback(input) {
  * 的注释（"Distinct from `MISSING_CREDENTIAL`"）与宿主 UI 上的徽章共同确认。
  */
 const MISSING_CREDENTIAL_CODE = 'MISSING_CREDENTIAL';
+/** 抛出来的错误是否读作"没配 key"。 */
+export function isMissingCredentialError(error) {
+    const e = error;
+    if (e && typeof e === 'object' && e.code === MISSING_CREDENTIAL_CODE)
+        return true;
+    return typeof e?.message === 'string' && /no API key|MISSING_CREDENTIAL/i.test(e.message);
+}
 /**
  * 这次失败是否该提示玩家"你有已兑换额度，但续命现在用不上"。
  *
@@ -57,14 +64,6 @@ const MISSING_CREDENTIAL_CODE = 'MISSING_CREDENTIAL';
  * MISSING_CREDENTIAL，于是什么都没发生，也没有任何东西解释为什么。这里只负责
  * 说明，不改变任何行为——原始失败照样原样透传。
  */
-export const NO_CREDENTIAL_HINT = '续命只在你自己的模型额度耗尽时接管；当前是没有配置 key，所以用不到你已兑换的额度。';
-/** 抛出来的错误是否读作"没配 key"。 */
-export function isMissingCredentialError(error) {
-    const e = error;
-    if (e && typeof e === 'object' && e.code === MISSING_CREDENTIAL_CODE)
-        return true;
-    return typeof e?.message === 'string' && /no API key|MISSING_CREDENTIAL/i.test(e.message);
-}
 export function shouldHintNoCredential(input) {
     if (input.provider === POOL_PROVIDER)
         return false;
@@ -95,7 +94,28 @@ export function shouldHintNoCredential(input) {
  *   entirely once a fallback is underway — the pool call reports its own —
  *   instead of both being forwarded and double-counting tokens.
  */
+/**
+ * 奖池也失败时，替换交还给宿主的失败**消息**，保留 `code`/`status` 等机器字段。
+ *
+ * 原样交还原始失败是有意的（"装了这个插件不会让任何调用变差"），但那条消息说的是
+ * 玩家自己额度不足——他明明有已兑换额度，续命也确实接管了，只是奖池这侧没成。
+ * 假话出现在他最需要看懂的时刻，所以人读的那半必须换掉。
+ */
+export function withTruthfulMessage(original, poolFailure, m) {
+    const reason = original.reason;
+    if (reason.kind !== 'error' || !reason.failure)
+        return original;
+    const busy = poolFailure.code === 'RATE_LIMIT' || /concurrent|rate limit/i.test(poolFailure.message ?? '');
+    const message = busy
+        ? m.poolFallbackBusy()
+        : m.poolFallbackFailed(poolFailure.message ?? poolFailure.code ?? 'unknown');
+    return {
+        ...original,
+        reason: { ...reason, failure: { ...reason.failure, message } },
+    };
+}
 export async function* runWithFallback(options, next, deps) {
+    const m = deps.m;
     let emittedContent = false;
     let finish;
     const pendingUsage = [];
@@ -126,7 +146,7 @@ export async function* runWithFallback(options, next, deps) {
                 hinted = false;
             }
             if (hinted)
-                deps.notify(NO_CREDENTIAL_HINT);
+                deps.notify(m.noCredentialHint());
         }
         throw error;
     }
@@ -150,7 +170,7 @@ export async function* runWithFallback(options, next, deps) {
                 hinted = false;
             }
             if (hinted) {
-                deps.notify(NO_CREDENTIAL_HINT);
+                deps.notify(m.noCredentialHint());
             }
         }
         yield* pendingUsage;
@@ -181,12 +201,14 @@ export async function* runWithFallback(options, next, deps) {
                 // 奖池回的是 `unknown model: deepseek-v4-flash`（模型不在价目表里），
                 // 而玩家只看到原始的 Insufficient Balance，跟没装插件一模一样。
                 deps.logError?.(new Error(`dsh-blackjack: pool retry failed after a quota exhaustion; pool said ${JSON.stringify(c.reason.failure)}`));
-                yield finish;
+                // 交还的仍然是**原始**失败（不改 code，宿主的路由与徽章认的是它），但把
+                // 给人读的那半换成真话：原样交还等于告诉一个明明有额度的玩家"余额不足"。
+                yield withTruthfulMessage(finish, c.reason.failure, m);
                 return;
             }
             if (!announced) {
                 announced = true;
-                deps.notify('已切换至奖池余额继续本次请求。');
+                deps.notify(m.poolSwitchNotice());
             }
             if (c.type === 'finish')
                 poolFinished = true;
@@ -243,5 +265,6 @@ export function registerRouter(ctx, deps) {
         poolStream: (o) => ctx.llm.stream(o),
         notify,
         logError: (error) => ctx.logger.warn('dsh-blackjack: pool fallback failed after a quota exhaustion; the original failure was surfaced instead', error),
+        m: deps.m,
     }));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-blackjack",
-  "version": "0.1.5",
+  "version": "0.2.1",
   "description": "社区福利小游戏插件：在 dsh 里玩 21 点赢取可消费的模型额度",
   "license": "MIT",
   "keywords": [
@@ -65,6 +65,7 @@
     "@deepseek-ai/cordis": "4.0.1",
     "@deepseek-ai/dsh-agent": "0.1.0-rc.6",
     "@deepseek-ai/dsh-anonymous-user-id": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-locale": "0.1.0-rc.6",
     "@deepseek-ai/dsh-client-runtime": "0.1.0-rc.6",
     "@deepseek-ai/dsh-client-ui-conversation": "0.1.0-rc.6",
     "@deepseek-ai/dsh-client-ui-slots": "0.1.0-rc.6",