dsh-consumption-badge 1.2.1 → 1.2.2

package/lib/client.js

@@ -107,12 +107,263 @@ window.__ModuleLoader__.load({
 
     // 同源取数：Host 半边的只读路由，失败一律转成 store 里的错误文案。
     async function fetchJson(path) {
-      if (typeof fetch !== 'function') throw new Error('fetch 不可用')
+      if (typeof fetch !== 'function') throw new Error(tt('fetch 不可用'))
       const res = await fetch(path, { headers: { accept: 'application/json' }, credentials: 'same-origin' })
       if (!res.ok) throw new Error('HTTP ' + String(res.status))
       return await res.json()
     }
 
+    /* ============ i18n: follow the shell locale (zh / en) ============ */
+    // Design: the Chinese copy IS the dictionary key. Under `zh` no dictionary is
+    // needed (the key is the text); under `en` DICT_EN supplies the translation.
+    // Anything missing from DICT_EN falls back to the key, so a gap can only show
+    // Chinese — never an empty string.
+    //
+    // No manual re-render plumbing for slot-mounted UI: dsh-client-web-react's
+    // SlotOutlet subscribes to the locale face revision (useLocaleRevision), so
+    // every outlet re-renders on a language switch and these module-level calls
+    // pick up the new locale. Only the personalization page's own React root
+    // (rendered outside the slot system) subscribes explicitly.
+    const LOCALE_NS = 'consumption-badge'
+    const DICT_EN = {
+      /* badge + panel */
+      '本会话消耗（点击查看逐轮明细）': 'Session usage (click for per-turn details)',
+      '本会话消耗': 'Session usage',
+      '⛽ 本会话消耗': '⛽ Session usage',
+      '刷新余额': 'Refresh balance',
+      'Esc 关闭': 'Esc to close',
+      '累计 Token': 'Total tokens',
+      '估算金额': 'Estimated cost',
+      '当前时段': 'Current window',
+      '账户余额': 'Account balance',
+      '逐轮消耗趋势': 'Per-turn usage trend',
+      '命中 {hit} · 未命中 {miss} · 输出 {out}': 'hit {hit} · miss {miss} · output {out}',
+      '{id}（按 flash 估算）': '{id} (priced as flash)',
+      ' · 峰时 ×2': ' · peak ×2',
+      ' · 谷时': ' · off-peak ×1',
+      '高峰': 'Peak',
+      '空闲': 'Off-peak',
+      '峰': 'Peak',
+      '谷': 'Off-peak',
+      '峰时': 'Peak',
+      '谷时': 'Off-peak',
+      '北京时间 工作日 09:00-12:00 / 14:00-18:00': 'Beijing time, weekdays 09:00-12:00 / 14:00-18:00',
+      '金额按 DeepSeek 官方价估算（谷/峰 ×1/×2），仅供参考；数据源为本会话日志，刷新后自动恢复。': 'Costs are estimated from DeepSeek list prices (off-peak/peak ×1/×2) and are for reference only; the source is this session log, restored automatically after a refresh.',
+      /* chart tooltips */
+      '本会话还没有可统计的轮次': 'No turns to chart in this session yet',
+      '输入命中': 'Cache hit',
+      '输入未命中': 'Cache miss',
+      '输出': 'Output',
+      '本轮合计': 'Turn total',
+      '每轮 Token': 'Tokens per turn',
+      '每轮估算金额': 'Cost per turn',
+      '{n} 轮': '{n} turns',
+      '当日合计': 'Total',
+      '模型': 'Model',
+      /* balance + error copy */
+      '打开面板时请求一次': 'Fetched once per panel open',
+      '打开设置页时请求一次': 'Fetched once per settings open',
+      '读取中…': 'Loading…',
+      '获取失败': 'Failed',
+      '余额接口不可用': 'Balance API unavailable',
+      '余额不足': 'Insufficient balance',
+      '请前往 DeepSeek 开放平台充值': 'Top up at the DeepSeek open platform',
+      '赠送 ¥{v}': 'granted ¥{v}',
+      '充值 ¥{v}': 'topped up ¥{v}',
+      'DeepSeek 账户余额': 'DeepSeek account balance',
+      '空响应': 'Empty response',
+      '余额获取失败': 'Balance request failed',
+      '余额获取失败：{msg}': 'Balance request failed: {msg}',
+      '会话消耗读取失败：{msg}': 'Failed to read session usage: {msg}',
+      'fetch 不可用': 'fetch is not available',
+      /* host error codes (lib/index.js) → zh copy; DICT_EN supplies the English */
+      'credentials 服务不可用': 'The credentials service is unavailable.',
+      '读取 API Key 失败：{detail}': 'Failed to read the API key: {detail}',
+      '未配置 {detail}': 'No API key configured ({detail}).',
+      'subprocess 服务不可用': 'The subprocess service is unavailable.',
+      'curl 没有输出：{detail}': 'curl produced no output: {detail}',
+      'curl 启动失败：{detail}': 'curl could not be started: {detail}',
+      '响应解析失败：{detail}': 'Could not parse the response: {detail}',
+      '余额接口请求失败': 'The balance request failed.',
+      '缺少 sessionId': 'Missing sessionId.',
+      '会话日志不可用': 'The session log is unavailable.',
+      /* settings page */
+      '消耗统计': 'Usage statistics',
+      '本地估算，非官方账单': 'Local estimate, not an official bill',
+      '今天': 'Today',
+      '近一周': 'Last 7 days',
+      '近一月': 'Last 30 days',
+      '近一年': 'Last 12 months',
+      '全部历史 · 含所有工作区': 'All history · every workspace',
+      ' · 全部历史逐轮计价': ' · per-turn pricing over all history',
+      '时间范围': 'Time range',
+      '自定义区间': 'Custom range',
+      '工作区': 'Workspace',
+      '全部工作区': 'All workspaces',
+      '未归属工作区': 'Unassigned',
+      '日历选择（覆盖时间范围）': 'Calendar (overrides the range)',
+      '清除': 'Clear',
+      '数据': 'Data',
+      '刷新': 'Refresh',
+      '估算金额（右轴）': 'Estimated cost (right axis)',
+      'Token（左轴，默认隐藏）': 'Tokens (left axis, hidden by default)',
+      '该范围内暂无消耗记录': 'No usage recorded in this range',
+      '总消耗 ': 'Total cost ',
+      '总 Token ': 'Total tokens ',
+      '记录 ': 'Records ',
+      ' 条': '',
+      '峰时 ': 'Peak ',
+      '谷时 ': 'Off-peak ',
+      '粒度 ': 'Bucket ',
+      '按月': 'monthly',
+      '按日': 'daily',
+      '按小时': 'hourly',
+      '数据源：本机逐轮记录（localStorage {prefix}<sessionId>:<turn>）；按北京时间聚合（今天与单日区间逐小时，多日逐日，近一年逐月）{worker}。金额按 DeepSeek 官方价估算（谷/峰 ×1/×2），仅供参考。': 'Source: local per-turn records (localStorage {prefix}<sessionId>:<turn>), aggregated in Beijing time (hourly for today and single-day ranges, daily for multi-day ranges, monthly for the last 12 months){worker}. Costs are estimated from DeepSeek list prices (off-peak/peak ×1/×2) and are for reference only.',
+      '；聚合已在 Web Worker 中完成': '; aggregation ran in a Web Worker',
+      /* personalization page block */
+      '消耗弹窗': 'Usage popup',
+      '背景': 'Background',
+      '点击对话里的 ⛽ 胶囊弹出的消耗面板': 'The usage panel opened by the ⛽ pill in the chat',
+      '消耗弹窗背景': 'Usage popup background',
+      '默认': 'Default',
+      '毛玻璃': 'Glass',
+      '自定义背景': 'Custom image',
+      '纯色': 'Solid color',
+      '弹窗底色；文字颜色会按明暗自动切换': 'Popup base color; text color adapts automatically to lightness',
+      '正在保存…': 'Saving…',
+      '已保存到本机': 'Saved on this device',
+      '取回失败，请重新选择': 'Could not read it back — please pick again',
+      '当前：本地图片（{status}）': 'Using: local image ({status})',
+      '当前：本地图片（已保存到本机）': 'Using: local image (saved on this device)',
+      '当前：图片 URL': 'Using: image URL',
+      '未设置图片（此时按默认背景显示）': 'No image set (falls back to the default background)',
+      '图片': 'Image',
+      '；可选 URL 或本地图片，不限大小': '; a URL or a local image, any size',
+      '更换图片…': 'Change image…',
+      '选择图片…': 'Choose image…',
+      '已使用本地图片，输入 URL 可替换': 'Local image in use — enter a URL to replace it',
+      '不透明度': 'Opacity',
+      '背景图片自身的透明度（0% 完全不可见，100% 完整显示）': 'Opacity of the background image itself (0% invisible, 100% fully visible)',
+      '把背景图片磨砂化（对图片做真模糊）': 'Frost the background image (a real blur on the image)',
+      '底色半透明并模糊背后的页面': 'Translucent base that blurs the page behind it',
+      '毛玻璃强度': 'Glass strength',
+      '模糊半径（0–48px）': 'Blur radius (0–48px)',
+      '消耗徽章弹层的背景样式；不影响对话区与侧边栏背景。{tag}': 'Background style of the badge popup; it does not affect the chat or sidebar background. {tag}',
+      '重置本栏': 'Reset this section',
+      '消耗弹窗设置需要 react-dom，当前环境不可用。': 'Popup settings need react-dom, which is not available here.',
+      'error: IndexedDB 与 FileReader 都不可用': 'error: IndexedDB and FileReader are both unavailable',
+      'IndexedDB 与 FileReader 都不可用': 'IndexedDB and FileReader are both unavailable',
+      /* update notice */
+      '消耗徽章有新版本': 'A new version of the usage badge is available',
+      '当前 v{current} → 最新 v{latest}': 'current v{current} → latest v{latest}',
+      '复制更新命令': 'Copy update command',
+      '已复制': 'Copied',
+      '忽略此版本': 'Ignore this version',
+      '稍后提醒': 'Remind me later',
+      '更新后需重启 dsh 进程': 'Restart the dsh process after updating',
+      '版本来自 npm registry（24h 缓存）；「忽略此版本」会记住，直到出现更高版本。': 'Versions come from the npm registry (24h cache); “Ignore this version” is remembered until a higher version appears.',
+      /* slot labels */
+      '消耗': 'Usage',
+    }
+
+    let boundTranslate = null
+    let localeService = null
+    let appCtx = null
+
+    /** Fill `{name}` placeholders (same template syntax as the locale service). */
+    function applyParams(template, params) {
+      if (!params) return String(template)
+      return String(template).replace(/\{(\w+)\}/g, function (all, name) {
+        return Object.prototype.hasOwnProperty.call(params, name) ? String(params[name]) : all
+      })
+    }
+
+    /**
+     * Bind the shell's locale service when the composition provides one.
+     * Optional dependency on purpose: without the service every string falls
+     * back to its Chinese key, so the plugin still works standalone.
+     * @param ctx client cordis context.
+     */
+    function attachLocale(ctx) {
+      if (localeService !== null) return
+      let service = null
+      try {
+        // ctx.get(name, strict = true) throws when the service is missing: this is an
+        // optional dependency, so read it non-strictly. The try/catch also covers
+        // contexts without a get() (older shells, test doubles).
+        if (ctx && typeof ctx.get === 'function') service = ctx.get('locale', false) || null
+      } catch (e) {
+        service = null
+      }
+      if (service === null || typeof service.register !== 'function' || typeof service.bind !== 'function') return
+      try {
+        // Only the `en` side is registered: the key already is the `zh` copy, and
+        // the locale service resolves a miss to the key itself.
+        service.register(LOCALE_NS, 'en', DICT_EN)
+      } catch (e) {
+        // Already registered (hot re-mount of the same fiber) — binding is enough.
+      }
+      boundTranslate = service.bind(LOCALE_NS)
+      localeService = service
+    }
+
+    /**
+     * Late-binding guard: the locale service may be provided after this plugin's
+     * apply() ran (boot order differs between compositions), so the first render
+     * retries the bind. Costs one ctx.get per tt() call while unbound.
+     */
+    function ensureLocaleBound() {
+      if (localeService !== null || appCtx === null) return
+      attachLocale(appCtx)
+    }
+
+    /** Translate a key with the active locale; falls back to the key itself. */
+    function tt(key, params) {
+      if (localeService === null) ensureLocaleBound()
+      if (boundTranslate !== null) {
+        try {
+          return boundTranslate(key, params)
+        } catch (e) { /* fall through to the key */ }
+      }
+      return applyParams(key, params)
+    }
+
+    /** Subscribe to locale switches (only the self-built React root needs this). */
+    function subscribeLocale(fn) {
+      const service = localeService
+      if (service === null || typeof service.subscribe !== 'function') return function () {}
+      try {
+        const off = service.subscribe(fn)
+        return typeof off === 'function' ? off : function () {}
+      } catch (e) {
+        return function () {}
+      }
+    }
+
+    /* Host error codes (lib/index.js) → the Chinese key tt() translates. */
+    const HOST_ERROR_KEYS = {
+      'no-credentials': 'credentials 服务不可用',
+      'key-read-failed': '读取 API Key 失败：{detail}',
+      'no-key': '未配置 {detail}',
+      'no-subprocess': 'subprocess 服务不可用',
+      'curl-empty': 'curl 没有输出：{detail}',
+      'spawn-failed': 'curl 启动失败：{detail}',
+      'bad-response': '响应解析失败：{detail}',
+      'balance-request-failed': '余额接口请求失败',
+      'missing-session-id': '缺少 sessionId',
+      'log-unavailable': '会话日志不可用',
+    }
+
+    /**
+     * Render a host error payload in the active locale. Unknown codes fall back
+     * to the host's own (English) message so nothing is ever swallowed.
+     */
+    function hostErrorText(code, detail, fallback) {
+      const key = typeof code === 'string' ? HOST_ERROR_KEYS[code] : undefined
+      if (key === undefined) return typeof fallback === 'string' ? fallback : ''
+      return tt(key, { detail: typeof detail === 'string' ? detail : '' })
+    }
+
     /* local persistence: one record per <sessionId>:<turn> */
     function lsGet(key) {
       try {
@@ -203,10 +454,10 @@ window.__ModuleLoader__.load({
 
     /* ================= 消耗弹窗背景样式（与个性化插件联动） ================= */
     const MODAL_STYLE_KEY = 'dsh-consumption:modal-style'
-    const BUILD_TAG = 'dcb-1.2.1'
+    const BUILD_TAG = 'dcb-1.2.2'
     // 本地版本：本包是零构建的手写客户端包，无法 import package.json，因此把版本号作为常量维护，
     // 并由 check.mjs 守卫与 package.json 严格一致（发布前不一致直接失败）。
-    const PLUGIN_VERSION = '1.2.1'
+    const PLUGIN_VERSION = '1.2.2'
     const PKG_NAME = 'dsh-consumption-badge'
     const UPDATE_REGISTRY_URL = 'https://registry.npmjs.org/' + PKG_NAME + '/latest'
     const UPDATE_COMMAND = 'dsh plugin --profile web update ' + PKG_NAME
@@ -219,6 +470,7 @@ window.__ModuleLoader__.load({
     // opacity：背景图片自身的不透明度（0–100，与个性化插件其它背景栏同口径）；
     // 旧版的 scrim（压暗遮罩）在读取时折算成 100 - scrim，老配置不会丢。
     const DEFAULT_MODAL_STYLE = { mode: 'default', color: '#17181c', image: '', imageKey: '', opacity: 85, glass: false, blur: 22 }
+    // label 是词典 key（中文原文），渲染时统一走 tt(mode.label)，所以这里不能直接显示。
     const MODAL_MODES = [
       { value: 'default', label: '默认' },
       { value: 'glass', label: '毛玻璃' },
@@ -521,7 +773,7 @@ window.__ModuleLoader__.load({
           return latest !== '' ? latest : null
         })
         .catch(function (err) {
-          console.warn('[consumption-badge] 更新检查失败（静默）：' + (err && err.message ? err.message : String(err)))
+          console.warn('[consumption-badge] update check failed (silent): ' + (err && err.message ? err.message : String(err)))
           return null
         })
       if (controller === null) return request
@@ -580,6 +832,11 @@ window.__ModuleLoader__.load({
         turns: [],
         turnsState: 'idle',
         turnsError: '',
+        // Error copy is stored language-neutral: the kind names the sentence and
+        // the raw detail rides turnsError, so a locale switch re-renders the text.
+        turnsErrorKind: '',
+        turnsErrorCode: '',
+        turnsErrorFallback: '',
         account: null,
         accountState: 'idle',
         integrations: null,
@@ -595,6 +852,9 @@ window.__ModuleLoader__.load({
         balance: null,
         balanceState: 'idle',
         balanceError: '',
+        balanceErrorKind: '',
+        balanceErrorCode: '',
+        balanceErrorFallback: '',
         balanceAt: 0,
       }
       const listeners = new Set()
@@ -663,13 +923,26 @@ window.__ModuleLoader__.load({
             }
             state.turns = restoreTurns(sessionId, normalized)
             state.turnsState = res && res.ok === false ? 'error' : 'ready'
-            state.turnsError = res && typeof res.error === 'string' ? res.error : ''
+            if (res && res.ok === false) {
+              state.turnsErrorKind = 'host'
+              state.turnsErrorCode = typeof res.code === 'string' ? res.code : ''
+              state.turnsError = typeof res.detail === 'string' ? res.detail : ''
+              state.turnsErrorFallback = typeof res.error === 'string' ? res.error : ''
+            } else {
+              state.turnsErrorKind = ''
+              state.turnsErrorCode = ''
+              state.turnsError = ''
+              state.turnsErrorFallback = ''
+            }
             persistTurns(sessionId, normalized)
             emit()
           })
           .catch(function (e) {
             state.turnsState = 'error'
-            state.turnsError = '会话消耗读取失败：' + msgOf(e)
+            state.turnsErrorKind = 'read'
+            state.turnsErrorCode = ''
+            state.turnsError = msgOf(e)
+            state.turnsErrorFallback = ''
             emit()
           })
           .then(function () { turnsInFlight = null })
@@ -684,17 +957,35 @@ window.__ModuleLoader__.load({
         balanceInFlight = Promise.resolve()
           .then(function () { return fetchJson(API + '/balance' + (force ? '?force=1' : '')) })
           .then(function (res) {
-            const value = res && typeof res === 'object' ? res : { ok: false, error: '空响应' }
+            const value = res && typeof res === 'object' ? res : { ok: false }
             state.balance = value
             state.balanceAt = Date.now()
             state.balanceState = 'ready'
-            state.balanceError = value.ok ? '' : (typeof value.error === 'string' ? value.error : '余额获取失败')
+            if (!res || typeof res !== 'object') {
+              state.balanceErrorKind = 'empty'
+              state.balanceError = ''
+              state.balanceErrorCode = ''
+              state.balanceErrorFallback = ''
+            } else if (value.ok) {
+              state.balanceErrorKind = ''
+              state.balanceError = ''
+              state.balanceErrorCode = ''
+              state.balanceErrorFallback = ''
+            } else {
+              state.balanceErrorKind = 'host'
+              state.balanceErrorCode = typeof value.code === 'string' ? value.code : ''
+              state.balanceError = typeof value.detail === 'string' ? value.detail : ''
+              state.balanceErrorFallback = typeof value.error === 'string' ? value.error : ''
+            }
             emit()
           })
           .catch(function (e) {
             state.balance = null
             state.balanceState = 'error'
-            state.balanceError = '余额获取失败：' + msgOf(e)
+            state.balanceErrorKind = 'fetch'
+            state.balanceErrorCode = ''
+            state.balanceError = msgOf(e)
+            state.balanceErrorFallback = ''
             emit()
           })
           .then(function () { balanceInFlight = null })
@@ -767,10 +1058,10 @@ window.__ModuleLoader__.load({
         const key = 'modal-bg-' + Date.now().toString(36) + '-' + Math.random().toString(36).slice(2, 8)
         return idbPutImage(key, file).then(function (stored) {
           if (stored !== true) {
-            console.warn('[consumption-badge] IndexedDB 写入失败，退回 dataURL')
+            console.warn('[consumption-badge] IndexedDB write failed, falling back to a data URL')
             return readAsDataUrl(file).then(function (dataUrl) {
               if (!dataUrl) {
-                state.modalImageStatus = 'error: IndexedDB 与 FileReader 都不可用'
+                state.modalImageStatus = 'error: ' + tt('IndexedDB 与 FileReader 都不可用')
                 emit()
                 return
               }
@@ -785,7 +1076,7 @@ window.__ModuleLoader__.load({
             if (typeof URL !== 'undefined' && typeof URL.createObjectURL === 'function' && blob) {
               setResolvedImageUrl(URL.createObjectURL(blob))
             } else if (blob === null) {
-              console.warn('[consumption-badge] 图片已入库但取回失败', key)
+              console.warn('[consumption-badge] image stored but could not be read back', key)
             }
             if (prevKey && prevKey !== key) idbDeleteImage(prevKey)
             state.modalImageStatus = 'saved'
@@ -793,7 +1084,7 @@ window.__ModuleLoader__.load({
           })
         }).catch(function (err) {
           const text = err && err.message ? err.message : String(err)
-          console.error('[consumption-badge] 保存图片失败：' + text)
+          console.error('[consumption-badge] failed to save the image: ' + text)
           state.modalImageStatus = 'error: ' + text
           emit()
         })
@@ -931,7 +1222,7 @@ window.__ModuleLoader__.load({
       const holder = React.useState(-1)
       const hover = holder[0]
       const setHover = holder[1]
-      if (!series.length) return h('div', { className: 'dcb-empty' }, '本会话还没有可统计的轮次')
+      if (!series.length) return h('div', { className: 'dcb-empty' }, tt('本会话还没有可统计的轮次'))
       const innerW = CHART_W - CHART_PAD.l - CHART_PAD.r
       const innerH = CHART_H - CHART_PAD.t - CHART_PAD.b
       let maxToken = 1
@@ -998,18 +1289,18 @@ window.__ModuleLoader__.load({
             h('div', { className: 'dcb-tooltip-title' },
               '#' + String(hovered.turn),
               h('span', { className: 'dcb-tooltip-model' }, hovered.model || DEFAULT_MODEL),
-              h('span', { className: hovered.peak ? 'dcb-tag is-peak' : 'dcb-tag is-valley' }, hovered.peak ? '峰时' : '谷时')),
-            h('div', { className: 'dcb-tooltip-row' }, h('span', null, '输入命中'), h('b', null, fmtTokens(hovered.hit))),
-            h('div', { className: 'dcb-tooltip-row' }, h('span', null, '输入未命中'), h('b', null, fmtTokens(hovered.miss))),
-            h('div', { className: 'dcb-tooltip-row' }, h('span', null, '输出'), h('b', null, fmtTokens(hovered.out))),
-            h('div', { className: 'dcb-tooltip-row dcb-tooltip-total' }, h('span', null, '本轮合计'), h('b', null, fmtTokens(hovered.tokens))),
-            h('div', { className: 'dcb-tooltip-row dcb-tooltip-total' }, h('span', null, '估算金额'), h('b', null, '≈¥' + fmtYuan(hovered.cost))))
+              h('span', { className: hovered.peak ? 'dcb-tag is-peak' : 'dcb-tag is-valley' }, tt(hovered.peak ? '峰时' : '谷时'))),
+            h('div', { className: 'dcb-tooltip-row' }, h('span', null, tt('输入命中')), h('b', null, fmtTokens(hovered.hit))),
+            h('div', { className: 'dcb-tooltip-row' }, h('span', null, tt('输入未命中')), h('b', null, fmtTokens(hovered.miss))),
+            h('div', { className: 'dcb-tooltip-row' }, h('span', null, tt('输出')), h('b', null, fmtTokens(hovered.out))),
+            h('div', { className: 'dcb-tooltip-row dcb-tooltip-total' }, h('span', null, tt('本轮合计')), h('b', null, fmtTokens(hovered.tokens))),
+            h('div', { className: 'dcb-tooltip-row dcb-tooltip-total' }, h('span', null, tt('估算金额')), h('b', null, '≈¥' + fmtYuan(hovered.cost))))
         : null
 
       return h('div', { className: 'dcb-chart-wrap' },
         h('div', { className: 'dcb-chart-legend' },
-          h('span', { className: 'dcb-legend-item' }, h('i', { className: 'dcb-legend-dot' }), '每轮 Token'),
-          h('span', { className: 'dcb-legend-item' }, h('i', { className: 'dcb-legend-dot dcb-dot-cost' }), '每轮估算金额')),
+          h('span', { className: 'dcb-legend-item' }, h('i', { className: 'dcb-legend-dot' }), tt('每轮 Token')),
+          h('span', { className: 'dcb-legend-item' }, h('i', { className: 'dcb-legend-dot dcb-dot-cost' }), tt('每轮估算金额'))),
         h('div', { className: 'dcb-chart-body' },
           h('svg', {
             className: 'dcb-chart-svg',
@@ -1031,6 +1322,24 @@ window.__ModuleLoader__.load({
 
     /* components: one store per plugin instance */
     const store = createStore()
+
+    /* Error copy is composed at render time (not at fetch time) so it follows the locale. */
+    function turnsErrorText() {
+      const st = store.state
+      if (st.turnsErrorKind === 'host') return hostErrorText(st.turnsErrorCode, st.turnsError, st.turnsErrorFallback)
+      if (st.turnsErrorKind === 'read') return tt('会话消耗读取失败：{msg}', { msg: st.turnsError })
+      return st.turnsError
+    }
+    function balanceErrorText() {
+      const st = store.state
+      if (st.balanceErrorKind === 'empty') return tt('空响应')
+      if (st.balanceErrorKind === 'host') {
+        const text = hostErrorText(st.balanceErrorCode, st.balanceError, st.balanceErrorFallback)
+        return text === '' ? tt('余额获取失败') : text
+      }
+      if (st.balanceErrorKind === 'fetch') return tt('余额获取失败：{msg}', { msg: st.balanceError })
+      return st.balanceError
+    }
     // Assigned by the overlay's callback ref, so Esc can reach a focused node without useRef.
     let panelRootEl = null
 
@@ -1084,7 +1393,7 @@ window.__ModuleLoader__.load({
       return h('button', {
         type: 'button',
         className: 'dcb-pill',
-        title: '本会话消耗（点击查看逐轮明细）',
+        title: tt('本会话消耗（点击查看逐轮明细）'),
         onClick: function (event) {
           try {
             event.preventDefault()
@@ -1098,7 +1407,7 @@ window.__ModuleLoader__.load({
         h('span', { className: 'dcb-pill-sep' }, '|'),
         h('span', null, pending ? '…' : '≈¥' + fmtYuan(cost)),
         h('span', { className: 'dcb-pill-sep' }, '|'),
-        h('span', { className: peak ? 'dcb-tag is-peak' : 'dcb-tag is-valley' }, peak ? '峰' : '谷'))
+        h('span', { className: peak ? 'dcb-tag is-peak' : 'dcb-tag is-valley' }, tt(peak ? '峰' : '谷')))
     }
 
     function ConsumptionPanel() {
@@ -1138,27 +1447,28 @@ window.__ModuleLoader__.load({
       const totalCost = costOf(aggregated, price.table, peak)
       const balance = state.balance
       const loading = state.balanceState === 'loading'
+      const balanceErr = balanceErrorText()
       let balanceValue = '—'
-      let balanceHint = state.balanceError || '打开面板时请求一次'
+      let balanceHint = balanceErr || tt('打开面板时请求一次')
       let balanceClass = 'dcb-card-value'
       if (loading && !balance) {
-        balanceValue = '读取中…'
+        balanceValue = tt('读取中…')
         balanceHint = 'GET /user/balance'
       } else if (balance && balance.ok === false) {
-        balanceValue = '获取失败'
-        balanceHint = state.balanceError || '余额接口不可用'
+        balanceValue = tt('获取失败')
+        balanceHint = balanceErr || tt('余额接口不可用')
         balanceClass = 'dcb-card-value dcb-bad'
       } else if (balance && balance.available === false) {
-        balanceValue = '余额不足'
-        balanceHint = '请前往 DeepSeek 开放平台充值'
+        balanceValue = tt('余额不足')
+        balanceHint = tt('请前往 DeepSeek 开放平台充值')
         balanceClass = 'dcb-card-value dcb-bad'
       } else if (balance) {
         const symbol = balance.currency && balance.currency !== 'CNY' ? String(balance.currency) + ' ' : '¥'
         balanceValue = symbol + fmtYuan(balance.total)
         const parts = []
-        if (typeof balance.granted === 'number') parts.push('赠送 ¥' + fmtYuan(balance.granted))
-        if (typeof balance.toppedUp === 'number') parts.push('充值 ¥' + fmtYuan(balance.toppedUp))
-        balanceHint = parts.length ? parts.join(' · ') : 'DeepSeek 账户余额'
+        if (typeof balance.granted === 'number') parts.push(tt('赠送 ¥{v}', { v: fmtYuan(balance.granted) }))
+        if (typeof balance.toppedUp === 'number') parts.push(tt('充值 ¥{v}', { v: fmtYuan(balance.toppedUp) }))
+        balanceHint = parts.length ? parts.join(' · ') : tt('DeepSeek 账户余额')
       }
 
       function close() {
@@ -1186,27 +1496,27 @@ window.__ModuleLoader__.load({
         h('div', {
           className: surface.className,
           role: 'dialog',
-          'aria-label': '本会话消耗',
+          'aria-label': tt('本会话消耗'),
           style: surface.style,
         },
           h('div', { className: 'dcb-head' },
-            h('div', { className: 'dcb-head-title' }, '⛽ 本会话消耗'),
+            h('div', { className: 'dcb-head-title' }, tt('⛽ 本会话消耗')),
             h('div', { className: 'dcb-head-actions' },
-              h('button', { type: 'button', className: 'dcb-btn', onClick: function () { store.ensureBalance(true) } }, '刷新余额'),
-              h('button', { type: 'button', className: 'dcb-btn dcb-btn-close', onClick: close, title: 'Esc 关闭' }, '✕'))),
+              h('button', { type: 'button', className: 'dcb-btn', onClick: function () { store.ensureBalance(true) } }, tt('刷新余额')),
+              h('button', { type: 'button', className: 'dcb-btn dcb-btn-close', onClick: close, title: tt('Esc 关闭') }, '✕'))),
           h('div', { className: 'dcb-cards' },
-            h(Card, { label: '累计 Token', value: fmtTokens(tokens), hint: '命中 ' + fmtTokens(aggregated.hit) + ' · 未命中 ' + fmtTokens(aggregated.miss) + ' · 输出 ' + fmtTokens(aggregated.out) }),
-            h(Card, { label: '估算金额', value: '≈¥' + fmtYuan(totalCost), hint: (price.known ? price.id : price.id + '（按 flash 估算）') + (peak ? ' · 峰时 ×2' : ' · 谷时') }),
-            h(Card, { label: '当前时段', value: peak ? '高峰' : '空闲', hint: '北京时间 工作日 09:00-12:00 / 14:00-18:00' }),
+            h(Card, { label: tt('累计 Token'), value: fmtTokens(tokens), hint: tt('命中 {hit} · 未命中 {miss} · 输出 {out}', { hit: fmtTokens(aggregated.hit), miss: fmtTokens(aggregated.miss), out: fmtTokens(aggregated.out) }) }),
+            h(Card, { label: tt('估算金额'), value: '≈¥' + fmtYuan(totalCost), hint: (price.known ? price.id : tt('{id}（按 flash 估算）', { id: price.id })) + tt(peak ? ' · 峰时 ×2' : ' · 谷时') }),
+            h(Card, { label: tt('当前时段'), value: tt(peak ? '高峰' : '空闲'), hint: tt('北京时间 工作日 09:00-12:00 / 14:00-18:00') }),
             h('div', { className: 'dcb-card' },
-              h('div', { className: 'dcb-card-label' }, '账户余额'),
+              h('div', { className: 'dcb-card-label' }, tt('账户余额')),
               h('div', { className: balanceClass }, balanceValue),
               h('div', { className: 'dcb-card-hint' }, balanceHint))),
-          h('div', { className: 'dcb-section-title' }, '逐轮消耗趋势'),
+          h('div', { className: 'dcb-section-title' }, tt('逐轮消耗趋势')),
           h(UsageChart, { series: series }),
           h('div', { className: 'dcb-foot' },
-            state.turnsError ? h('span', { className: 'dcb-foot-warn' }, state.turnsError + ' ') : null,
-            '金额按 DeepSeek 官方价估算（谷/峰 ×1/×2），仅供参考；数据源为本会话日志，刷新后自动恢复。')))
+            state.turnsError ? h('span', { className: 'dcb-foot-warn' }, turnsErrorText() + ' ') : null,
+            tt('金额按 DeepSeek 官方价估算（谷/峰 ×1/×2），仅供参考；数据源为本会话日志，刷新后自动恢复。'))))
     }
 
     /* ===================== settings section: history page ===================== */
@@ -1624,12 +1934,12 @@ window.__ModuleLoader__.load({
         ? h('div', { className: 'dcb-tooltip', style: { left: String((xAt(hover) / HIST_W) * 100) + '%' } },
             h('div', { className: 'dcb-tooltip-title' },
               hovered.label,
-              h('span', { className: 'dcb-tooltip-model' }, hovered.records + ' 轮')),
-            h('div', { className: 'dcb-tooltip-row dcb-tooltip-total' }, h('span', null, '当日合计'), h('b', null, '≈¥' + fmtYuan(hovered.cost))),
+              h('span', { className: 'dcb-tooltip-model' }, tt('{n} 轮', { n: hovered.records }))),
+            h('div', { className: 'dcb-tooltip-row dcb-tooltip-total' }, h('span', null, tt('当日合计')), h('b', null, '≈¥' + fmtYuan(hovered.cost))),
             h('div', { className: 'dcb-tooltip-row' }, h('span', null, 'Token'), h('b', null, fmtTokens(hovered.tokens))),
-            h('div', { className: 'dcb-tooltip-row' }, h('span', null, '峰时'), h('b', null, '≈¥' + fmtYuan(hovered.peakCost) + ' / ' + fmtTokens(hovered.peakTokens))),
-            h('div', { className: 'dcb-tooltip-row' }, h('span', null, '谷时'), h('b', null, '≈¥' + fmtYuan(hovered.valleyCost) + ' / ' + fmtTokens(hovered.valleyTokens))),
-            h('div', { className: 'dcb-tooltip-row' }, h('span', null, '模型'), h('b', null, hovered.models.length ? hovered.models.join(', ') : '—')))
+            h('div', { className: 'dcb-tooltip-row' }, h('span', null, tt('峰时')), h('b', null, '≈¥' + fmtYuan(hovered.peakCost) + ' / ' + fmtTokens(hovered.peakTokens))),
+            h('div', { className: 'dcb-tooltip-row' }, h('span', null, tt('谷时')), h('b', null, '≈¥' + fmtYuan(hovered.valleyCost) + ' / ' + fmtTokens(hovered.valleyTokens))),
+            h('div', { className: 'dcb-tooltip-row' }, h('span', null, tt('模型')), h('b', null, hovered.models.length ? hovered.models.join(', ') : '—')))
         : null
 
       return h('div', { className: 'dcb-chart-body' },
@@ -1779,69 +2089,70 @@ window.__ModuleLoader__.load({
       const nowPeak = isPeakAt(Date.now())
       const balance = st.balance
       const balanceLoading = st.balanceState === 'loading'
+      const balanceErr = balanceErrorText()
       let balanceValue = '—'
-      let balanceHint = st.balanceError || '打开设置页时请求一次'
+      let balanceHint = balanceErr || tt('打开设置页时请求一次')
       let balanceClass = 'dcb-card-value'
       if (balanceLoading && !balance) {
-        balanceValue = '读取中…'
+        balanceValue = tt('读取中…')
         balanceHint = 'GET /user/balance'
       } else if (balance && balance.ok === false) {
-        balanceValue = '获取失败'
-        balanceHint = st.balanceError || '余额接口不可用'
+        balanceValue = tt('获取失败')
+        balanceHint = balanceErr || tt('余额接口不可用')
         balanceClass = 'dcb-card-value dcb-bad'
       } else if (balance && balance.available === false) {
-        balanceValue = '余额不足'
-        balanceHint = '请前往 DeepSeek 开放平台充值'
+        balanceValue = tt('余额不足')
+        balanceHint = tt('请前往 DeepSeek 开放平台充值')
         balanceClass = 'dcb-card-value dcb-bad'
       } else if (balance) {
         const symbol = balance.currency && balance.currency !== 'CNY' ? String(balance.currency) + ' ' : '¥'
         balanceValue = symbol + fmtYuan(balance.total)
         const parts = []
-        if (typeof balance.granted === 'number') parts.push('赠送 ¥' + fmtYuan(balance.granted))
-        if (typeof balance.toppedUp === 'number') parts.push('充值 ¥' + fmtYuan(balance.toppedUp))
-        balanceHint = parts.length ? parts.join(' · ') : 'DeepSeek 账户余额'
+        if (typeof balance.granted === 'number') parts.push(tt('赠送 ¥{v}', { v: fmtYuan(balance.granted) }))
+        if (typeof balance.toppedUp === 'number') parts.push(tt('充值 ¥{v}', { v: fmtYuan(balance.toppedUp) }))
+        balanceHint = parts.length ? parts.join(' · ') : tt('DeepSeek 账户余额')
       }
 
       const index = buildWorkspaceIndex(wsSig)
       const points = stats ? stats.points : []
       const hasData = !!stats && stats.count > 0
       const rangeOptions = [
-        { id: 'today', label: '今天' },
-        { id: 'week', label: '近一周' },
-        { id: 'month', label: '近一月' },
-        { id: 'year', label: '近一年' },
+        { id: 'today', label: tt('今天') },
+        { id: 'week', label: tt('近一周') },
+        { id: 'month', label: tt('近一月') },
+        { id: 'year', label: tt('近一年') },
       ]
 
       return h('div', { className: 'dcb-set' },
         h('div', { className: 'dcb-set-head' },
-          h('div', { className: 'dcb-set-title' }, '消耗统计'),
-          h('div', { className: 'dcb-set-note' }, '本地估算，非官方账单')),
+          h('div', { className: 'dcb-set-title' }, tt('消耗统计')),
+          h('div', { className: 'dcb-set-note' }, tt('本地估算，非官方账单'))),
         // 顶部四卡：累计（全部历史，不受下面筛选影响）+ 当前时段 + 账户余额
         h('div', { className: 'dcb-cards dcb-cards-set' },
           h(Card, {
-            label: '累计 Token',
+            label: tt('累计 Token'),
             value: allStats ? fmtTokens(allStats.totalTokens) : '—',
             hint: allStats
-              ? ('命中 ' + fmtTokens(allStats.totalHit) + ' · 未命中 ' + fmtTokens(allStats.totalMiss) + ' · 输出 ' + fmtTokens(allStats.totalOut))
-              : '全部历史 · 含所有工作区',
+              ? tt('命中 {hit} · 未命中 {miss} · 输出 {out}', { hit: fmtTokens(allStats.totalHit), miss: fmtTokens(allStats.totalMiss), out: fmtTokens(allStats.totalOut) })
+              : tt('全部历史 · 含所有工作区'),
           }),
           h(Card, {
-            label: '估算金额',
+            label: tt('估算金额'),
             value: allStats ? '≈¥' + fmtYuan(allStats.totalCost) : '—',
-            hint: (accountPrice.known ? accountPrice.id : accountPrice.id + '（按 flash 估算）') + ' · 全部历史逐轮计价',
+            hint: (accountPrice.known ? accountPrice.id : tt('{id}（按 flash 估算）', { id: accountPrice.id })) + tt(' · 全部历史逐轮计价'),
           }),
           h(Card, {
-            label: '当前时段',
-            value: nowPeak ? '高峰' : '空闲',
-            hint: '北京时间 工作日 09:00-12:00 / 14:00-18:00',
+            label: tt('当前时段'),
+            value: tt(nowPeak ? '高峰' : '空闲'),
+            hint: tt('北京时间 工作日 09:00-12:00 / 14:00-18:00'),
           }),
           h('div', { className: 'dcb-card' },
-            h('div', { className: 'dcb-card-label' }, '账户余额'),
+            h('div', { className: 'dcb-card-label' }, tt('账户余额')),
             h('div', { className: balanceClass }, balanceValue),
             h('div', { className: 'dcb-card-hint' }, balanceHint))),
         h('div', { className: 'dcb-set-controls' },
           h('div', { className: 'dcb-field' },
-            h('label', { className: 'dcb-field-label', htmlFor: 'dcb-range-select' }, '时间范围'),
+            h('label', { className: 'dcb-field-label', htmlFor: 'dcb-range-select' }, tt('时间范围')),
             h('select', {
               id: 'dcb-range-select',
               className: 'dcb-select',
@@ -1853,20 +2164,20 @@ window.__ModuleLoader__.load({
               },
             },
               rangeOptions.map(function (opt) { return h('option', { key: opt.id, value: opt.id }, opt.label) }),
-              (calFrom || calTo) ? h('option', { key: 'custom', value: 'custom' }, '自定义区间') : null)),
+              (calFrom || calTo) ? h('option', { key: 'custom', value: 'custom' }, tt('自定义区间')) : null)),
           h('div', { className: 'dcb-field' },
-            h('label', { className: 'dcb-field-label', htmlFor: 'dcb-workspace-select' }, '工作区'),
+            h('label', { className: 'dcb-field-label', htmlFor: 'dcb-workspace-select' }, tt('工作区')),
             h('select', {
               id: 'dcb-workspace-select',
               className: 'dcb-select',
               value: wid,
               onChange: function (event) { setWid(event.target.value) },
             },
-              h('option', { key: 'all', value: '' }, '全部工作区'),
+              h('option', { key: 'all', value: '' }, tt('全部工作区')),
               index.list.map(function (it) { return h('option', { key: it.id, value: it.id }, it.title) }),
-              h('option', { key: 'none', value: UNKNOWN_WORKSPACE }, '未归属工作区'))),
+              h('option', { key: 'none', value: UNKNOWN_WORKSPACE }, tt('未归属工作区')))),
           h('div', { className: 'dcb-field' },
-            h('span', { className: 'dcb-field-label' }, '日历选择（覆盖时间范围）'),
+            h('span', { className: 'dcb-field-label' }, tt('日历选择（覆盖时间范围）')),
             h('div', { className: 'dcb-range' },
               h('input', {
                 type: 'date',
@@ -1882,36 +2193,36 @@ window.__ModuleLoader__.load({
                 onChange: function (event) { setCalTo(event.target.value) },
               }),
               (calFrom || calTo)
-                ? h('button', { type: 'button', className: 'dcb-btn', onClick: function () { setCalFrom(''); setCalTo('') } }, '清除')
+                ? h('button', { type: 'button', className: 'dcb-btn', onClick: function () { setCalFrom(''); setCalTo('') } }, tt('清除'))
                 : null)),
           h('div', { className: 'dcb-field' },
-            h('span', { className: 'dcb-field-label' }, '数据'),
-            h('button', { type: 'button', className: 'dcb-btn', onClick: function () { setReloadTick(function (v) { return v + 1 }) } }, '刷新'))),
+            h('span', { className: 'dcb-field-label' }, tt('数据')),
+            h('button', { type: 'button', className: 'dcb-btn', onClick: function () { setReloadTick(function (v) { return v + 1 }) } }, tt('刷新')))),
         h('div', { className: 'dcb-set-body' },
           h('div', { className: 'dcb-hist-legend' },
-            h('span', { className: 'dcb-tog dcb-tog-cost is-on' }, h('i', null), '估算金额（右轴）'),
+            h('span', { className: 'dcb-tog dcb-tog-cost is-on' }, h('i', null), tt('估算金额（右轴）')),
             h('button', {
               type: 'button',
               className: showTokens ? 'dcb-tog is-on' : 'dcb-tog',
               onClick: function () { setShowTokens(function (v) { return v === true ? false : true }) },
-            }, h('i', null), 'Token（左轴，默认隐藏）')),
+            }, h('i', null), tt('Token（左轴，默认隐藏）'))),
           hasData
             ? h(HistoryChart, { points: points, showTokens: showTokens })
-            : h('div', { className: 'dcb-hist-empty' }, '该范围内暂无消耗记录')),
+            : h('div', { className: 'dcb-hist-empty' }, tt('该范围内暂无消耗记录'))),
         hasData
           ? h('div', { className: 'dcb-sum' },
-              h('span', null, '总消耗 ', h('b', null, '≈¥' + fmtYuan(stats.totalCost))),
-              h('span', null, '总 Token ', h('b', null, fmtTokens(stats.totalTokens))),
-              h('span', null, '记录 ', h('b', null, String(stats.count)), ' 条'),
-              h('span', null, '峰时 ', h('b', null, '≈¥' + fmtYuan(stats.peakCost))),
-              h('span', null, '谷时 ', h('b', null, '≈¥' + fmtYuan(stats.valleyCost))),
-              h('span', null, '粒度 ', h('b', null, stats.granularity === 'month' ? '按月' : (stats.granularity === 'hour' ? '按小时' : '按日'))))
+              h('span', null, tt('总消耗 '), h('b', null, '≈¥' + fmtYuan(stats.totalCost))),
+              h('span', null, tt('总 Token '), h('b', null, fmtTokens(stats.totalTokens))),
+              h('span', null, tt('记录 '), h('b', null, String(stats.count)), tt(' 条')),
+              h('span', null, tt('峰时 '), h('b', null, '≈¥' + fmtYuan(stats.peakCost))),
+              h('span', null, tt('谷时 '), h('b', null, '≈¥' + fmtYuan(stats.valleyCost))),
+              h('span', null, tt('粒度 '), h('b', null, tt(stats.granularity === 'month' ? '按月' : (stats.granularity === 'hour' ? '按小时' : '按日')))))
           : null,
         h('div', { className: 'dcb-hist-aside' },
-          '数据源：本机逐轮记录（localStorage ' + LS_PREFIX + '<sessionId>:<turn>' + '）；按北京时间聚合'
-          + '（今天与单日区间逐小时，多日逐日，近一年逐月）'
-          + (stats && stats.via === 'worker' ? '；聚合已在 Web Worker 中完成' : '')
-          + '。金额按 DeepSeek 官方价估算（谷/峰 ×1/×2），仅供参考。'))
+          tt('数据源：本机逐轮记录（localStorage {prefix}<sessionId>:<turn>）；按北京时间聚合（今天与单日区间逐小时，多日逐日，近一年逐月）{worker}。金额按 DeepSeek 官方价估算（谷/峰 ×1/×2），仅供参考。', {
+            prefix: LS_PREFIX,
+            worker: stats && stats.via === 'worker' ? tt('；聚合已在 Web Worker 中完成') : '',
+          })))
     }
 
     /* ============ 与 dsh-plugin-personalization 联动：个性化页内新增「消耗弹窗」栏 ============ */
@@ -1943,6 +2254,11 @@ window.__ModuleLoader__.load({
       React.useEffect(function () {
         return store.subscribe(function () { setTick(function (v) { return v + 1 }) })
       }, [])
+      // This block renders in its own React root outside the slot system, so it
+      // subscribes to the locale face itself (slot outlets do that for us).
+      React.useEffect(function () {
+        return subscribeLocale(function () { setTick(function (v) { return v + 1 }) })
+      }, [])
       const cfg = store.state.modalStyle
 
       function patch(next) {
@@ -1978,23 +2294,23 @@ window.__ModuleLoader__.load({
       const rows = []
       rows.push(h('div', { className: 'pp-field', key: 'mode' },
         h('div', { className: 'pp-fieldLabelWrap' },
-          h('span', { className: 'pp-fieldLabel' }, '背景'),
-          h('span', { className: 'pp-fieldHint' }, '点击对话里的 ⛽ 胶囊弹出的消耗面板')),
+          h('span', { className: 'pp-fieldLabel' }, tt('背景')),
+          h('span', { className: 'pp-fieldHint' }, tt('点击对话里的 ⛽ 胶囊弹出的消耗面板'))),
         h('div', { className: 'pp-fieldControl' },
-          h('div', { className: 'pp-modes', role: 'radiogroup', 'aria-label': '消耗弹窗背景' },
+          h('div', { className: 'pp-modes', role: 'radiogroup', 'aria-label': tt('消耗弹窗背景') },
             MODAL_MODES.map(function (mode) {
               return h(ModalPill, {
                 key: mode.value,
                 active: cfg.mode === mode.value,
                 onClick: function () { patch({ mode: mode.value }) },
-              }, mode.label)
+              }, tt(mode.label))
             })))))
 
       if (cfg.mode === 'solid') {
         rows.push(h('div', { className: 'pp-field', key: 'solid' },
           h('div', { className: 'pp-fieldLabelWrap' },
-            h('span', { className: 'pp-fieldLabel' }, '纯色'),
-            h('span', { className: 'pp-fieldHint' }, '弹窗底色；文字颜色会按明暗自动切换')),
+            h('span', { className: 'pp-fieldLabel' }, tt('纯色')),
+            h('span', { className: 'pp-fieldHint' }, tt('弹窗底色；文字颜色会按明暗自动切换'))),
           h('div', { className: 'pp-fieldControl' },
             h('div', { className: 'pp-colorRow' },
               h('input', {
@@ -2021,17 +2337,17 @@ window.__ModuleLoader__.load({
         const previewSrc = localImage ? store.state.modalImageUrl : cfg.image
         const status = store.state.modalImageStatus
         let statusText = ''
-        if (status === 'saving') statusText = '正在保存…'
-        else if (status === 'saved') statusText = '已保存到本机'
+        if (status === 'saving') statusText = tt('正在保存…')
+        else if (status === 'saved') statusText = tt('已保存到本机')
         else if (typeof status === 'string' && status.indexOf('error:') === 0) statusText = status
-        else if (localImage && !store.state.modalImageUrl) statusText = '取回失败，请重新选择'
+        else if (localImage && !store.state.modalImageUrl) statusText = tt('取回失败，请重新选择')
         const summary = localImage
-          ? ('当前：本地图片' + (statusText ? '（' + statusText + '）' : '（已保存到本机）'))
-          : (urlImage ? '当前：图片 URL' : '未设置图片（此时按默认背景显示）')
+          ? (statusText ? tt('当前：本地图片（{status}）', { status: statusText }) : tt('当前：本地图片（已保存到本机）'))
+          : (urlImage ? tt('当前：图片 URL') : tt('未设置图片（此时按默认背景显示）'))
         rows.push(h('div', { className: 'pp-field', key: 'image' },
           h('div', { className: 'pp-fieldLabelWrap' },
-            h('span', { className: 'pp-fieldLabel' }, '图片'),
-            h('span', { className: 'pp-fieldHint' }, summary + '；可选 URL 或本地图片，不限大小')),
+            h('span', { className: 'pp-fieldLabel' }, tt('图片')),
+            h('span', { className: 'pp-fieldHint' }, summary + tt('；可选 URL 或本地图片，不限大小'))),
           h('div', { className: 'pp-fieldControl' },
             h('div', { className: 'pp-urlRow' },
               // 原生 file 输入隐藏起来：它在保存后必然显示"未选择文件"，容易误判成没存上。
@@ -2049,13 +2365,13 @@ window.__ModuleLoader__.load({
                   const el = fileRef.current
                   if (el && typeof el.click === 'function') el.click()
                 },
-              }, hasImage ? '更换图片…' : '选择图片…'),
+              }, hasImage ? tt('更换图片…') : tt('选择图片…')),
               h('button', {
                 type: 'button',
                 className: 'pp-blockReset',
                 disabled: !hasImage,
                 onClick: clearImage,
-              }, '清除'),
+              }, tt('清除')),
               previewSrc
                 ? h('img', { className: 'pp-thumb', src: previewSrc, alt: '' })
                 : null,
@@ -2063,14 +2379,14 @@ window.__ModuleLoader__.load({
                 type: 'text',
                 className: 'dcb-date',
                 style: { flex: '1 1 160px', minWidth: '0' },
-                placeholder: localImage ? '已使用本地图片，输入 URL 可替换' : 'https://…',
+                placeholder: localImage ? tt('已使用本地图片，输入 URL 可替换') : 'https://…',
                 value: localImage ? '' : cfg.image,
                 onChange: function (event) { patch({ image: event.target.value, imageKey: '' }) },
               })))))
         rows.push(h('div', { className: 'pp-field', key: 'opacity' },
           h('div', { className: 'pp-fieldLabelWrap' },
-            h('span', { className: 'pp-fieldLabel' }, '不透明度'),
-            h('span', { className: 'pp-fieldHint' }, '背景图片自身的透明度（0% 完全不可见，100% 完整显示）')),
+            h('span', { className: 'pp-fieldLabel' }, tt('不透明度')),
+            h('span', { className: 'pp-fieldHint' }, tt('背景图片自身的透明度（0% 完全不可见，100% 完整显示）'))),
           h('div', { className: 'pp-fieldControl' },
             h('div', { className: 'pp-opacityRow' },
               h('input', {
@@ -2079,7 +2395,7 @@ window.__ModuleLoader__.load({
                 min: '0',
                 max: '100',
                 step: '1',
-                'aria-label': '不透明度',
+                'aria-label': tt('不透明度'),
                 value: String(typeof cfg.opacity === 'number' ? cfg.opacity : DEFAULT_MODAL_STYLE.opacity),
                 onChange: function (event) { patch({ opacity: Number(event.target.value) }) },
               }),
@@ -2091,9 +2407,9 @@ window.__ModuleLoader__.load({
       if (cfg.mode === 'image' || cfg.mode === 'solid') {
         rows.push(h('div', { className: 'pp-field', key: 'glass' },
           h('div', { className: 'pp-fieldLabelWrap' },
-            h('span', { className: 'pp-fieldLabel' }, '毛玻璃'),
+            h('span', { className: 'pp-fieldLabel' }, tt('毛玻璃')),
             h('span', { className: 'pp-fieldHint' },
-              cfg.mode === 'image' ? '把背景图片磨砂化（对图片做真模糊）' : '底色半透明并模糊背后的页面')),
+              tt(cfg.mode === 'image' ? '把背景图片磨砂化（对图片做真模糊）' : '底色半透明并模糊背后的页面'))),
           h('div', { className: 'pp-fieldControl' },
             h('button', {
               type: 'button',
@@ -2108,8 +2424,8 @@ window.__ModuleLoader__.load({
       if (cfg.mode === 'glass' || cfg.glass === true) {
         rows.push(h('div', { className: 'pp-field', key: 'blur' },
           h('div', { className: 'pp-fieldLabelWrap' },
-            h('span', { className: 'pp-fieldLabel' }, '毛玻璃强度'),
-            h('span', { className: 'pp-fieldHint' }, '模糊半径（0–48px），遮罩层按 45% 跟随')),
+            h('span', { className: 'pp-fieldLabel' }, tt('毛玻璃强度')),
+            h('span', { className: 'pp-fieldHint' }, tt('模糊半径（0–48px）'))),
           h('div', { className: 'pp-fieldControl' },
             h('div', { className: 'pp-opacityRow' },
               h('input', {
@@ -2126,8 +2442,8 @@ window.__ModuleLoader__.load({
       return h('section', { className: 'pp-block', 'data-section': 'dcb-consumption', 'data-dcb-build': BUILD_TAG },
         h('header', { className: 'pp-blockHead' },
           h('div', { className: 'pp-blockHeadMain' },
-            h('h3', { className: 'pp-blockTitle' }, '消耗弹窗'),
-            h('p', { className: 'pp-blockDesc' }, '消耗徽章弹层的背景样式；不影响对话区与侧边栏背景。' + BUILD_TAG)),
+            h('h3', { className: 'pp-blockTitle' }, tt('消耗弹窗')),
+            h('p', { className: 'pp-blockDesc' }, tt('消耗徽章弹层的背景样式；不影响对话区与侧边栏背景。{tag}', { tag: BUILD_TAG }))),
           h('button', {
             type: 'button',
             className: 'pp-blockReset',
@@ -2140,7 +2456,7 @@ window.__ModuleLoader__.load({
                 } catch (e) { /* ignore */ }
               }
             },
-          }, '重置本栏')),
+          }, tt('重置本栏'))),
         h('div', { className: 'pp-blockBody' }, rows))
     }
 
@@ -2173,7 +2489,7 @@ window.__ModuleLoader__.load({
           root = reactDom.createRoot(container)
           root.render(h(ConsumptionModalSettings, null))
         } else {
-          container.textContent = '消耗弹窗设置需要 react-dom，当前环境不可用。'
+          container.textContent = tt('消耗弹窗设置需要 react-dom，当前环境不可用。')
         }
         return container
       }
@@ -2189,7 +2505,7 @@ window.__ModuleLoader__.load({
         if (node.parentNode !== page) page.appendChild(node)
         if (!announced) {
           announced = true
-          console.log('[consumption-badge] 检测到 dsh-plugin-personalization：已在其设置页注入「消耗弹窗」栏')
+          console.log('[consumption-badge] dsh-plugin-personalization detected: injected the usage popup section into its settings page')
         }
       }
 
@@ -2259,43 +2575,43 @@ window.__ModuleLoader__.load({
       function copyCommand() {
         const clipboard = typeof navigator !== 'undefined' && navigator !== null ? navigator.clipboard : null
         if (clipboard === null || clipboard === undefined || typeof clipboard.writeText !== 'function') {
-          console.warn('[consumption-badge] 剪贴板不可用，请手动复制命令')
+          console.warn('[consumption-badge] clipboard unavailable, copy the command manually')
           return
         }
         try {
           const pending = clipboard.writeText(UPDATE_COMMAND)
           if (pending && typeof pending.then === 'function') {
             pending.then(function () { setCopied(true) }, function () {
-              console.warn('[consumption-badge] 剪贴板写入失败')
+              console.warn('[consumption-badge] clipboard write failed')
             })
             return
           }
           setCopied(true)
         } catch (e) {
-          console.warn('[consumption-badge] 剪贴板写入抛错')
+          console.warn('[consumption-badge] clipboard write threw')
         }
       }
 
       return h('div', { className: 'dcb-notice', role: 'status', 'aria-live': 'polite' },
         h('div', { className: 'dcb-notice-head' },
-          h('span', { className: 'dcb-notice-title' }, '消耗徽章有新版本'),
+          h('span', { className: 'dcb-notice-title' }, tt('消耗徽章有新版本')),
           h('span', { className: 'dcb-notice-versions' },
-            '当前 v' + String(info.currentVersion) + ' → 最新 v' + String(info.latestVersion)),
+            tt('当前 v{current} → 最新 v{latest}', { current: String(info.currentVersion), latest: String(info.latestVersion) })),
           h('button', {
             type: 'button',
             className: 'dcb-notice-x',
-            title: '稍后提醒',
+            title: tt('稍后提醒'),
             onClick: function () { store.dismissUpdate('later') },
           }, '✕')),
         h('div', { className: 'dcb-notice-cmd', title: UPDATE_COMMAND }, UPDATE_COMMAND),
         h('div', { className: 'dcb-notice-actions' },
           h('button', { type: 'button', className: 'dcb-btn dcb-btn-primary', onClick: copyCommand },
-            copied ? '已复制' : '复制更新命令'),
-          h('button', { type: 'button', className: 'dcb-btn', onClick: function () { store.dismissUpdate('ignore') } }, '忽略此版本'),
-          h('button', { type: 'button', className: 'dcb-btn', onClick: function () { store.dismissUpdate('later') } }, '稍后提醒'),
-          h('span', { className: 'dcb-notice-hint' }, '更新后需重启 dsh 进程')),
+            copied ? tt('已复制') : tt('复制更新命令')),
+          h('button', { type: 'button', className: 'dcb-btn', onClick: function () { store.dismissUpdate('ignore') } }, tt('忽略此版本')),
+          h('button', { type: 'button', className: 'dcb-btn', onClick: function () { store.dismissUpdate('later') } }, tt('稍后提醒')),
+          h('span', { className: 'dcb-notice-hint' }, tt('更新后需重启 dsh 进程'))),
         h('div', { className: 'dcb-notice-foot' },
-          '版本来自 npm registry（24h 缓存）；「忽略此版本」会记住，直到出现更高版本。'))
+          tt('版本来自 npm registry（24h 缓存）；「忽略此版本」会记住，直到出现更高版本。')))
     }
 
     /* styles + registration */
@@ -2429,9 +2745,15 @@ window.__ModuleLoader__.load({
 
     exports.apply = function apply(ctx) {
       insertCss(ctx)
+      // Bind the shell locale first: every render below reads through tt().
+      appCtx = ctx
+      attachLocale(ctx)
+      // Slot labels are thunks so the settings nav / action row re-read the copy
+      // after a language switch (the slot system resolves labels at read time).
+      const labelThunk = function () { return tt('消耗') }
       ctx.slots.inject('conversation.chat.assistant-actions', function () {
         const dispose = ctx.slots.register(
-          { name: 'conversation.chat.assistant-actions', id: 'consumption', order: 20, label: '消耗' },
+          { name: 'conversation.chat.assistant-actions', id: 'consumption', order: 20, label: labelThunk },
           function (props) { return h(ConsumptionBadge, props) },
         )
         return function () { dispose() }
@@ -2446,7 +2768,7 @@ window.__ModuleLoader__.load({
       // 设置页整页：settings.section（不是 settings.plugin.item 的卡片位）。
       ctx.slots.inject('settings.section', function () {
         const dispose = ctx.slots.register(
-          { name: 'settings.section', id: 'balance-dsh-consumption', order: 26, label: '消耗' },
+          { name: 'settings.section', id: 'balance-dsh-consumption', order: 26, label: labelThunk },
           function (props) { return h(ConsumptionSettings, props) },
         )
         return function () { dispose() }