dsh-deepseek-balance-widget 2.0.0 → 2.1.0

package/README.md

@@ -2,29 +2,53 @@
 
 [English](README_EN.md) | 中文
 
-在 dsh Web 侧边栏显示 AI 余额的插件：内置 DeepSeek，可添加 MiMo 等平台，实时展示**余额 / 今日消费 / 今日 Token**，每 30 秒自动刷新。
+在 dsh Web 侧边栏显示 AI 余额的多平台插件：内置 **DeepSeek**，可添加 **MiMo（小米）** 等平台，每 30 秒自动刷新。
 
 ## 功能
 
 ![AI 余额侧边栏展示](assets/screenshot.png)
 
-- 侧边栏显示余额 / 今日消费 / 今日 Token，30 秒自动刷新
-- 点击弹出详情：累计消费、本月消耗、Tokens
-- 多平台 Tab 切换（DeepSeek / MiMo…），可「+ 添加」新平台
+- 侧边栏实时显示余额 / 今日消费 / 今日 Token，30 秒自动刷新，并随当前平台切换
+- 弹窗顶部 **Tab** 切换平台（DeepSeek / MiMo…），侧边栏数值同步更新
+- 弹窗右上角「**+ 添加**」：随时加入 MiMo 等其他 AI 平台
+- 详情字段：余额、累计消费、今日消费、今日 Token、本月消耗（本月消费 / Tokens）
+- 「**AI 帮我配置**」：凭证抓取与写入全交给智能体，无需手动翻 Cookies
+- 弹窗底部显示版本号，有新版时一键自动更新
 
 ## 安装
 
+需要：已安装 dsh（可用 `dsh web`）。
+
 ```bash
 dsh plugin --profile web add dsh-deepseek-balance-widget
 ```
 
-从 npm 拉取安装，dsh 自动注册，**重启 `dsh web`** 后侧边栏出现余额按钮。
+从 npm 拉取安装，dsh 自动注册到 `dsh.profile.bundles`，完成后**重启 `dsh web`** 即可。
 
 也可以直接对 AI 说：*帮我用 npm 安装 dsh-deepseek-balance-widget 插件。*
 
 ## 配置
 
-打开弹窗 →「+ 添加」→ 选平台 →「AI 帮我配置」→ 把提示语发给智能体，AI 会引导你完成配置并写入本机。
+插件首次使用会自动创建 DeepSeek 条目，读取你本机的 `DEEPSEEK_API_KEY`。其他平台通过弹窗「+ 添加」加入。两种方式任选：
+
+**方式一：弹窗内添加**
+1. 打开弹窗，点右上角「+ 添加」。
+2. 选择平台，点「AI 帮我配置」，把提示语发给智能体。
+3. AI 一步步引导你获取凭证，自动写入本机配置。
+
+**方式二：直接对 AI 说**
+
+> 帮我配置 dsh-deepseek-balance-widget。
+
+AI 会接管全部：问 API Key / 引导获取平台 Cookie → 写入本机 → 提醒重启 `dsh web`。
+
+| 平台 | 凭据 | 备注 |
+|---|---|---|
+| DeepSeek | `DEEPSEEK_API_KEY` | 必填，余额 |
+| DeepSeek 用量 | `DEEPSEEK_PLATFORM_TOKEN` | 可选，统计累计消费 / 本月 / 今日 |
+| MiMo（小米） | 登录 Cookie | AI 引导获取 |
+
+凭据保存在你本机的 `~/.dsh/ai-balances.json`，不随插件分发。
 
 ## 卸载
 
@@ -32,6 +56,8 @@ dsh plugin --profile web add dsh-deepseek-balance-widget
 dsh plugin --profile web rm dsh-deepseek-balance-widget
 ```
 
+或者直接对 AI 说：*帮我用 npm 卸载 dsh-deepseek-balance-widget 插件。*
+
 ## License
 
-[MIT](LICENSE)
+[MIT](LICENSE)

package/README_EN.md

@@ -2,18 +2,23 @@
 
 English | [中文](README.md)
 
-A plugin that shows AI balances in the dsh web sidebar: DeepSeek built in, add MiMo and more, with live **balance / today spend / today tokens**, auto-refreshed every 30 s.
+A multi-provider AI balance widget for the dsh web sidebar. **DeepSeek** is built in; add **MiMo (Xiaomi)** and others with one click. Auto-refreshes every 30 seconds.
 
 ## Features
 
-![AI balance sidebar](assets/screenshot.png)
+![AI balance sidebar](assets/screenshot-en.png)
 
-- Sidebar widget: Balance / Today spend / Today tokens, auto-refresh every 30 s
-- Click for details: cumulative spend, monthly usage, tokens
-- Multi-provider tabs (DeepSeek / MiMo…), "＋ Add" to add new providers
+- Sidebar shows Balance / Today spend / Today tokens, auto-refresh every 30 s; values follow the selected provider
+- **Tabs** in the popover switch between providers (DeepSeek / MiMo…), sidebar updates with the tab
+- **"＋ Add"** button: add MiMo or any other AI provider at any time
+- Details: balance, cumulative spend, today spend, today tokens, monthly usage (monthly spend / tokens)
+- **"AI 帮我配置"**: credentials are handled by your AI — no digging through cookies by hand
+- Version shown in the popover footer; one-click auto-update when a new version is available
 
 ## Install
 
+Requires: dsh installed (with `dsh web` working).
+
 ```bash
 dsh plugin --profile web add dsh-deepseek-balance-widget
 ```
@@ -24,7 +29,26 @@ Or just tell your AI: *Install the dsh-deepseek-balance-widget plugin for me via
 
 ## Configuration
 
-Open the popover → "＋ Add" → pick a provider → "AI 帮我配置" → send the copied prompt to your AI; it will guide you through the setup and write the config locally.
+On first use the plugin creates a DeepSeek entry and reads your local `DEEPSEEK_API_KEY`. Other providers are added via "＋ Add". Either:
+
+**Option 1: Add inside the popover**
+1. Open the popover and click "＋ Add".
+2. Pick a provider, then click "AI 帮我配置" and send the copied prompt to your AI.
+3. Your AI walks you through getting the credentials and writes them locally.
+
+**Option 2: Just tell your AI**
+
+> Configure dsh-deepseek-balance-widget for me.
+
+The AI takes care of everything: asks for your API key / guides you through getting the platform cookie → writes the local config → reminds you to **restart `dsh web`**.
+
+| Provider | Credential | Notes |
+|---|---|---|
+| DeepSeek | `DEEPSEEK_API_KEY` | Required, balance |
+| DeepSeek usage | `DEEPSEEK_PLATFORM_TOKEN` | Optional, cumulative / monthly / today stats |
+| MiMo (Xiaomi) | Login cookie | Guided by your AI |
+
+Credentials are stored locally in `~/.dsh/ai-balances.json`; nothing is shipped with the plugin.
 
 ## Uninstall
 
@@ -32,6 +56,8 @@ Open the popover → "＋ Add" → pick a provider → "AI 帮我配置" → sen
 dsh plugin --profile web rm dsh-deepseek-balance-widget
 ```
 
+Or just tell your AI: *Uninstall the dsh-deepseek-balance-widget plugin for me via npm.*
+
 ## License
 
-[MIT](LICENSE)
+[MIT](LICENSE)

package/lib/client.js

@@ -19,11 +19,261 @@ window.__ModuleLoader__.load({
     /** One-shot sync from dsh settings to the local balance store. */
     const SYNC_ENDPOINT = "/ai-balances-sync";
     /** Client-side provider metadata (label only; balance logic lives on host). */
-    const PROVIDER_META = { deepseek: { label: "DeepSeek" }, mimo: { label: "MiMo" } };
+    const PROVIDER_META = {
+      deepseek: { label: { zh: "DeepSeek", en: "DeepSeek" } },
+      mimo: { label: { zh: "MiMo（小米）", en: "MiMo" } }
+    };
     /** Auto-refresh cadence, milliseconds. */
     const REFRESH_MS = 30000;
-    /** How long the "update succeeded, restart dsh" message stays visible, milliseconds. */
-    const UPDATE_SUCCESS_MS = 5000;
+    /** LocalStorage key for the UI language preference (no longer used; dsh settings drive language). */
+    const LANG_KEY = null;
+    /** Supported UI languages. */
+    const I18N = {
+      zh: {
+        entryAriaLabel: "AI 余额（余额 / 今日消费 / 今日Token）",
+        balance: "余额",
+        todaySpend: "今日消费",
+        todayTokens: "今日Token",
+        checking: "检查中…",
+        checkFailed: "检查失败",
+        upToDate: "已是最新",
+        updating: "更新中…",
+        updateSuccess: "成功，请重启 dsh",
+        updateFailed: "更新失败",
+        failed: "失败",
+        usageUnavailable: "用量接口不可用（{0}）",
+        usageNotConfigured: "未配置 DEEPSEEK_PLATFORM_TOKEN，仅显示余额。对 AI 说「帮我配置用量统计」，AI 会帮你设置（可选）。",
+        usageThisMonth: "本月消耗",
+        usageDisabled: "未启用",
+        periodSpend: "{0}消耗",
+        all: "全部",
+        thisMonthSpend: "本月消费",
+        tokens: "Tokens",
+        yi: "亿",
+        wan: "万",
+        error: "错误",
+        cumulativeSpend: "累计消费",
+        items: "项",
+        mimoFieldLabels: {
+          code: "状态码", message: "消息", frozenBalance: "冻结余额", overdraftLimit: "透支额度",
+          remainingOverdraftLimit: "剩余透支额度", giftBalance: "赠送余额", cashBalance: "现金余额",
+          rechargeBalance: "充值余额", accountBalance: "账户余额", walletBalance: "钱包余额",
+          plan: "套餐", expiredAt: "过期时间"
+        },
+        dailyUsage: "每日消耗",
+        date: "日期",
+        requests: "请求",
+        spend: "消费",
+        needSetup: "需设置",
+        remove: "移除",
+        mimoCookieHint: "MiMo 余额需用浏览器登录 Cookie 查询。请重新在浏览器登录 platform.xiaomimimo.com 后，将 Cookie 更新到 ~/.dsh/ai-balances.json 对应条目中。",
+        readFailed: "读取失败：{0}",
+        rawPrefix: "原始响应：",
+        aiGuide: "AI 帮我配置",
+        configMethod: "配置方式",
+        aiGuideNote: "点「AI 帮我配置」会复制一句话，发给智能体后它会读取本机教程文件、一步步引导你抓取凭证并写入插件。数据仅存本机，不上传。",
+        localKeyNote: "密钥仅保存在本机 ~/.dsh/ai-balances.json，不会上传。",
+        platform: "平台",
+        mimoOption: "MiMo（小米）",
+        deepseekOption: "DeepSeek",
+        name: "名称",
+        namePlaceholderDeepseek: "例如 DeepSeek",
+        namePlaceholderMimo: "例如 MiMo",
+        save: "保存",
+        cancel: "取消",
+        saving: "保存中…",
+        aiChatGuideTitle: "让 AI 在聊天里帮你配置",
+        step1: "Step 1",
+        step2: "Step 2",
+        openMimoBalance: "打开 platform.xiaomimimo.com/#/console/balance",
+        copyPromptToChat: "复制提示语 → 和智能体对话",
+        step1Desc: "点击下方链接打开 MiMo 余额页并登录",
+        step2Desc: "复制下方提示语，发送给智能体，AI 会在对话中一步步引导你完成配置",
+        manualPasteCookie: "我要手动粘贴 Cookie",
+        manualCookieTitle: "手动粘贴 Cookie",
+        cookiePlaceholder: "粘贴 Cookie / cURL / 请求头…",
+        extractResult: "识别结果：",
+        cookieNotFound: "未识别到 Cookie，请粘贴完整 cURL 或请求头",
+        backToAiGuide: "返回 AI 引导",
+        syncFailed: "同步失败：{0}",
+        syncAddedN: "已从 dsh 设置同步 {0} 个平台",
+        aiBalance: "AI 余额",
+        add: "+ 添加",
+        noProviders: "还没有任何 AI 余额，点右上角「+ 添加」。",
+        updatedAt: "更新于 ",
+        checkUpdate: "检查更新",
+        update: "更新",
+        fillName: "请填写名称",
+        saveFailed: "保存失败：{0}",
+        confirmRemove: "确定移除该 AI 余额？",
+        pasteCookieHint: "请粘贴 Cookie 或 cURL，AI 会自动提取",
+        copied: "已复制",
+        copyFailed: "复制失败",
+        refresh: "刷新"
+      },
+      en: {
+        entryAriaLabel: "AI Balance (Balance / Today Spend / Today Tokens)",
+        balance: "Balance",
+        todaySpend: "Today Spend",
+        todayTokens: "Today Tokens",
+        checking: "Checking…",
+        checkFailed: "Check failed",
+        upToDate: "Up to date",
+        updating: "Updating…",
+        updateSuccess: "Success, please restart dsh",
+        updateFailed: "Update failed",
+        failed: "Failed",
+        usageUnavailable: "Usage API unavailable ({0})",
+        usageNotConfigured: "DEEPSEEK_PLATFORM_TOKEN not configured, showing balance only. Tell the AI 'help me configure usage stats' to set it up (optional).",
+        usageThisMonth: "This Month",
+        usageDisabled: "Disabled",
+        periodSpend: "{0} Usage",
+        all: "All",
+        thisMonthSpend: "This Month Spend",
+        tokens: "Tokens",
+        yi: "B",
+        wan: "M",
+        error: "Error",
+        cumulativeSpend: "Cumulative Spend",
+        items: "items",
+        mimoFieldLabels: {
+          code: "Code", message: "Message", frozenBalance: "Frozen Balance", overdraftLimit: "Overdraft Limit",
+          remainingOverdraftLimit: "Remaining Overdraft", giftBalance: "Gift Balance", cashBalance: "Cash Balance",
+          rechargeBalance: "Recharge Balance", accountBalance: "Account Balance", walletBalance: "Wallet Balance",
+          plan: "Plan", expiredAt: "Expires At"
+        },
+        dailyUsage: "Daily Usage",
+        date: "Date",
+        requests: "Requests",
+        spend: "Spend",
+        needSetup: "Setup",
+        remove: "Remove",
+        mimoCookieHint: "MiMo balance requires a browser login Cookie. Please log in to platform.xiaomimimo.com again, then update the Cookie in ~/.dsh/ai-balances.json.",
+        readFailed: "Read failed: {0}",
+        rawPrefix: "Raw response: ",
+        aiGuide: "AI Configure",
+        configMethod: "Configuration",
+        aiGuideNote: "Clicking 'AI Configure' copies a prompt. Send it to the AI and it will read the local guide, walk you through capturing credentials, and write them to the plugin. Data stays local.",
+        localKeyNote: "Keys are only stored locally in ~/.dsh/ai-balances.json and are never uploaded.",
+        platform: "Platform",
+        mimoOption: "MiMo (Xiaomi)",
+        deepseekOption: "DeepSeek",
+        name: "Name",
+        namePlaceholderDeepseek: "e.g. DeepSeek",
+        namePlaceholderMimo: "e.g. MiMo",
+        save: "Save",
+        cancel: "Cancel",
+        saving: "Saving…",
+        aiChatGuideTitle: "Let the AI configure it in chat",
+        step1: "Step 1",
+        step2: "Step 2",
+        openMimoBalance: "Open platform.xiaomimimo.com/#/console/balance",
+        copyPromptToChat: "Copy prompt → chat with AI",
+        step1Desc: "Click the link below to open the MiMo balance page and log in",
+        step2Desc: "Copy the prompt below and send it to the AI. It will guide you step by step.",
+        manualPasteCookie: "I'll paste the Cookie manually",
+        manualCookieTitle: "Paste Cookie manually",
+        cookiePlaceholder: "Paste Cookie / cURL / headers…",
+        extractResult: "Extracted: ",
+        cookieNotFound: "No Cookie found. Paste the full cURL or headers.",
+        backToAiGuide: "Back to AI guide",
+        syncFailed: "Sync failed: {0}",
+        syncAddedN: "Synced {0} providers from dsh settings",
+        aiBalance: "AI Balance",
+        add: "+ Add",
+        noProviders: "No AI balances yet. Click '+ Add' in the top right.",
+        updatedAt: "Updated ",
+        checkUpdate: "Check update",
+        update: "Update",
+        fillName: "Please enter a name",
+        saveFailed: "Save failed: {0}",
+        confirmRemove: "Remove this AI balance?",
+        pasteCookieHint: "Paste a Cookie or cURL; the AI will extract it",
+        copied: "Copied",
+        copyFailed: "Copy failed",
+        refresh: "Refresh"
+      }
+    };
+    /** Authoritative source: host route reads ~/.dsh/settings.yaml locale.preference. */
+    const LOCALE_ENDPOINT = "/deepseek-balance-locale";
+    async function fetchDshLang() {
+      try {
+        const res = await fetch(LOCALE_ENDPOINT, { method: "GET", headers: { Accept: "application/json" } });
+        if (!res.ok) return null;
+        const env = await res.json();
+        if (env && (env.lang === "en" || env.lang === "zh")) return env.lang;
+      } catch { /* ignore */ }
+      return null;
+    }
+    /** Fallback: read dsh's <html lang> attribute (only useful if dsh updates it). */
+    function detectLangFromHtml() {
+      const raw = (document?.documentElement?.lang || "").trim().toLowerCase();
+      if (raw.startsWith("en")) return "en";
+      if (raw.startsWith("zh")) return "zh";
+      return null;
+    }
+    let currentLang = "zh";
+    function applyLangChange(next) {
+      if (next !== currentLang) {
+        currentLang = next;
+        if (typeof remountEntry === "function") remountEntry();
+        if (typeof updateEntryLabels === "function") updateEntryLabels();
+        if (lastEnvelope !== void 0) renderValue(lastEnvelope, lastUsage);
+        if (popRef !== null) renderPopover();
+      }
+    }
+    /** Poll the host route (authoritative settings.yaml) and re-render on change. */
+    async function pollDshLang() {
+      const next = await fetchDshLang();
+      if (next !== null) applyLangChange(next);
+      else {
+        const fb = detectLangFromHtml();
+        if (fb !== null) applyLangChange(fb);
+      }
+    }
+    if (typeof document !== "undefined" && document.documentElement) {
+      // 启动时立即问宿主端；之后每 8 秒问一次。
+      pollDshLang();
+      setInterval(pollDshLang, 8000);
+      // dsh 偶尔改 <html lang> 时也能跟上。
+      new MutationObserver(() => {
+        const fb = detectLangFromHtml();
+        if (fb !== null) applyLangChange(fb);
+      }).observe(document.documentElement, { attributes: true, attributeFilter: ["lang"] });
+    }
+    /** Translate a key, optionally replacing {0}, {1}... placeholders. */
+    function t(key, ...args) {
+      const dict = I18N[currentLang] || I18N.zh;
+      let text = dict[key];
+      if (text === void 0) text = I18N.zh[key] ?? key;
+      if (args.length && typeof text === "string") {
+        text = text.replace(/\{(\d+)\}/g, (_, n) => String(args[Number(n)] ?? ""));
+      }
+      return text;
+    }
+    /** Update sidebar entry stat labels to the current language. */
+    function updateEntryLabels() {
+      // 用 data-stat-key 按语义查找 label，避免位置错乱（即便 dsh 注入了其他 .dshBalanceStatLabel 也不会错位）。
+      const entry = document.querySelector("[data-dsh-balance-entry]");
+      if (!entry) return;
+      const spendLabel = entry.querySelector('[data-stat-key="todaySpend"] .dshBalanceStatLabel');
+      const tokenLabel = entry.querySelector('[data-stat-key="todayTokens"] .dshBalanceStatLabel');
+      if (spendLabel) spendLabel.textContent = t("todaySpend");
+      if (tokenLabel) tokenLabel.textContent = t("todayTokens");
+      entry.setAttribute("aria-label", t("entryAriaLabel"));
+    }
+    /** Remove the entry from DOM; dsh's rootObserver (childList:true) will rebuild it via createEntry(),
+     *  which calls statHtml with the current currentLang — so the new entry comes up in the right language. */
+    function remountEntry() {
+      const entry = document.querySelector("[data-dsh-balance-entry]");
+      if (!entry) return;
+      entry.remove();
+    }
+    /** How long the "update succeeded, restart dsh" message stays visible, milliseconds.
+     *  Set to infinite so the message persists until dsh is restarted.
+     *  dsh restart re-executes client.js, resetting all variables (including updateSuccessUntil),
+     *  which makes the success message disappear and restores the normal version check button. */
+    const UPDATE_SUCCESS_MS = Number.MAX_SAFE_INTEGER;
     /** Absolute path to the AI-setup guide file the chat AI should read before guiding the user. */
     const AI_GUIDE_FILE = "D:/deepseek harness内置余额显示功能/main program/dsh-deepseek-balance-widget/AI_BALANCE_SETUP_GUIDE.md";
     /** Prompt copied to the chat when the user asks the AI to configure MiMo Cookie. */
@@ -74,7 +324,9 @@ window.__ModuleLoader__.load({
         ".dshBalanceRow{display:flex;justify-content:space-between;gap:12px;padding:3px 0}",
         ".dshBalanceRow span:first-child{color:#9aa4b2}",
         ".dshBalanceRow span:last-child{font-variant-numeric:tabular-nums}",
-        ".dshBalanceFoot{display:flex;justify-content:space-between;align-items:center;margin-top:12px;padding-top:10px;border-top:1px solid rgba(255,255,255,.08);color:#7b8494;font-size:11px}",
+        // Footer 内的按钮不许被 flex 压缩成单字符宽度导致文字竖排（英文 label 更长时容易触发）。
+        ".dshBalanceFoot .dshBalanceBtn,.dshBalanceFoot .dshBalanceVersionBtn{white-space:nowrap;flex-shrink:0}",
+        ".dshBalanceFoot{display:flex;flex-wrap:wrap;justify-content:space-between;align-items:center;gap:6px;margin-top:12px;padding-top:10px;border-top:1px solid rgba(255,255,255,.08);color:#7b8494;font-size:11px}",
         ".dshBalanceBtn{appearance:none;cursor:pointer;background:#2d333b;color:#e6e9ef;border:1px solid rgba(255,255,255,.12);border-radius:7px;padding:4px 10px;font:inherit;font-size:12px}",
         ".dshBalanceBtn:hover{background:#363d47}",
         ".dshBalanceVersion{display:flex;align-items:center;gap:6px;font-size:11px;color:#7b8494}",
@@ -194,9 +446,9 @@ window.__ModuleLoader__.load({
       for (const child of root.children) if (child.tagName === "BUTTON") return child;
     }
 
-    /** One labeled stat column (label above value). */
-    function statHtml(label, valueHtml) {
-      return '<span class="dshBalanceStat"><span class="dshBalanceStatLabel">' + label + "</span>" + valueHtml + "</span>";
+    /** One labeled stat column (label above value). key 用作 data-stat-key 标记，便于按语义查找。 */
+    function statHtml(label, valueHtml, key) {
+      return '<span class="dshBalanceStat" data-stat-key="' + key + '"><span class="dshBalanceStatLabel">' + label + "</span>" + valueHtml + "</span>";
     }
 
     /** Build the entry row (a detached button). */
@@ -205,11 +457,11 @@ window.__ModuleLoader__.load({
       entry.type = "button";
       entry.dataset.dshBalanceEntry = "";
       entry.className = "dshBalanceEntry" + (variant === "compact" ? " compact" : "");
-      entry.setAttribute("aria-label", "AI 余额（余额 / 今日消费 / 今日Token）");
+      entry.setAttribute("aria-label", t("entryAriaLabel"));
       entry.innerHTML =
-        statHtml('<span class="dshBalanceStatLabel dshBalanceProviderLabel">余额</span>', '<span class="dshBalanceValue" data-state="loading">…</span>') +
-        statHtml("今日消费", '<span class="dshBalanceToday" data-state="loading">…</span>') +
-        statHtml("今日Token", '<span class="dshBalanceTodayTok" data-state="loading">…</span>');
+        statHtml('<span class="dshBalanceStatLabel dshBalanceProviderLabel">' + t("balance") + "</span>", '<span class="dshBalanceValue" data-state="loading">…</span>', "balance") +
+        statHtml(t("todaySpend"), '<span class="dshBalanceToday" data-state="loading">…</span>', "todaySpend") +
+        statHtml(t("todayTokens"), '<span class="dshBalanceTodayTok" data-state="loading">…</span>', "todayTokens");
       return entry;
     }
 
@@ -261,31 +513,31 @@ window.__ModuleLoader__.load({
     async function handleUpdateClick(btn) {
       btn.disabled = true;
       const originalText = btn.textContent;
-      btn.textContent = "检查中…";
+      btn.textContent = t("checking");
       const version = await fetchVersion();
       lastVersion = version;
       if (!version || version.ok === false) {
-        btn.textContent = "检查失败";
+        btn.textContent = t("checkFailed");
         btn.title = version ? String(version.error || "") : "";
         setTimeout(() => { btn.textContent = originalText; btn.disabled = false; btn.title = ""; }, 2000);
         return;
       }
       if (!version.updateAvailable) {
-        btn.textContent = "已是最新";
+        btn.textContent = t("upToDate");
         setTimeout(() => { btn.textContent = originalText; btn.disabled = false; }, 1500);
         return;
       }
-      btn.textContent = "更新中…";
+      btn.textContent = t("updating");
       const result = await updatePackage();
       if (result.ok) {
-        btn.textContent = "成功，请重启 dsh";
+        btn.textContent = t("updateSuccess");
         btn.disabled = true;
         // Keep the success message visible for a while before reverting to version info.
         updateSuccessUntil = Date.now() + UPDATE_SUCCESS_MS;
         setTimeout(() => checkVersion(), UPDATE_SUCCESS_MS);
       } else {
-        btn.textContent = "更新失败";
-        btn.title = String(result.error || "更新失败") + (result.output ? "\n" + result.output.slice(-200) : "");
+        btn.textContent = t("updateFailed");
+        btn.title = String(result.error || t("updateFailed")) + (result.output ? "\n" + result.output.slice(-200) : "");
         setTimeout(() => { btn.textContent = originalText; btn.disabled = false; btn.title = ""; }, 3000);
       }
     }
@@ -389,8 +641,8 @@ window.__ModuleLoader__.load({
       if (n === void 0 || n === null || n === "") return "—";
       const v = Number(String(n).replace(/,/g, ""));
       if (!Number.isFinite(v)) return String(n);
-      if (v >= 1e8) return (v / 1e8).toFixed(1) + "亿";
-      if (v >= 1e4) return (v / 1e4).toFixed(1) + "万";
+      if (v >= 1e8) return (v / 1e8).toFixed(1) + t("yi");
+      if (v >= 1e4) return (v / 1e4).toFixed(1) + t("wan");
       return v.toLocaleString();
     }
 
@@ -472,6 +724,18 @@ window.__ModuleLoader__.load({
 
     /** Render balance + today stats into the entry spans. */
     function renderValue(envelope, usageEnvelope) {
+      // 每次刷新都从 DOM 重新拿 entry，并按当前语言同步所有 stat label —— 避免 dsh 自愈重建或 React 重渲染导致 label 不同步。
+      // 直接问宿主端读 settings.yaml（权威）。fire-and-forget：不等返回，下次轮询或下次 refresh 时自动同步。
+      pollDshLang();
+      const entry = document.querySelector("[data-dsh-balance-entry]");
+      if (entry) {
+        entryRef = entry;
+        const spendLabel = entry.querySelector('[data-stat-key="todaySpend"] .dshBalanceStatLabel');
+        const tokenLabel = entry.querySelector('[data-stat-key="todayTokens"] .dshBalanceStatLabel');
+        if (spendLabel) spendLabel.textContent = t("todaySpend");
+        if (tokenLabel) tokenLabel.textContent = t("todayTokens");
+        entry.setAttribute("aria-label", t("entryAriaLabel"));
+      }
       const provider = activeProvider();
       const isDeepseek = provider && provider.kind === "deepseek";
       const bal = isDeepseek ? envelope : (balances[provider.id] || null);
@@ -481,26 +745,22 @@ window.__ModuleLoader__.load({
       const todayEl = entryRef && entryRef.querySelector(".dshBalanceToday");
       const tokEl = entryRef && entryRef.querySelector(".dshBalanceTodayTok");
 
-      // 平台名称（提醒这是哪个 provider 的余额）
+      // 平台名称（提醒这是哪个 provider 的余额）；按当前语言查 PROVIDER_META，避免宿主端硬编码的中文混入英文界面。
       if (labelEl !== null) {
-        labelEl.textContent = provider ? (provider.label || provider.kind) : "余额";
+        const meta = provider ? PROVIDER_META[provider.kind] : null;
+        const metaLabel = meta ? meta.label[currentLang] : null;
+        const fallbackLabel = provider ? (provider.label || provider.kind) : t("balance");
+        labelEl.textContent = metaLabel || fallbackLabel;
       }
 
-      // 余额（入口处不显示货币符号）
+      // 余额（统一显示货币符号，与 MiMo 入口保持一致）
       if (valueEl !== null) {
         if (!bal || bal.ok === false) {
           valueEl.dataset.state = "err";
-          valueEl.textContent = "失败";
+          valueEl.textContent = t("failed");
         } else {
-          const info = (bal.data && bal.data.balance_infos && bal.data.balance_infos[0]) || null;
-          let total = void 0;
-          if (info !== null) {
-            total = info.total_balance;
-          } else if (bal.data && bal.data.total !== void 0) {
-            total = bal.data.total;
-          }
           valueEl.dataset.state = "ok";
-          valueEl.textContent = total !== void 0 ? total : "—";
+          valueEl.textContent = formatProviderBalance(bal.data);
         }
       }
 
@@ -540,8 +800,10 @@ window.__ModuleLoader__.load({
       if (popRef === null) return;
       popRef.innerHTML = popoverHtml();
       positionPopover();
-      const btn = popRef.querySelector(".dshBalanceBtn");
-      if (btn !== null) btn.addEventListener("click", () => { refresh(true); checkVersion(); });
+      const refreshBtn = popRef.querySelector("[data-refresh]");
+      if (refreshBtn !== null) refreshBtn.addEventListener("click", () => { refresh(true); checkVersion(); });
+      const langBtn = popRef.querySelector("[data-lang-toggle]");
+      if (langBtn !== null) langBtn.remove();
       const updateBtn = popRef.querySelector("[data-update-cmd]");
       if (updateBtn !== null) {
         updateBtn.addEventListener("click", () => handleUpdateClick(updateBtn));
@@ -570,11 +832,11 @@ window.__ModuleLoader__.load({
           const prompt = AI_GUIDE_PROMPT_BY_KIND[addFormState.kind] || MIMO_COOKIE_GUIDE_PROMPT;
           try {
             await navigator.clipboard.writeText(prompt);
-            aiGuideBtn.textContent = "已复制";
+            aiGuideBtn.textContent = t("copied");
           } catch {
-            aiGuideBtn.textContent = "复制失败";
+            aiGuideBtn.textContent = t("copyFailed");
           }
-          setTimeout(() => aiGuideBtn.textContent = "AI 帮我配置", 1500);
+          setTimeout(() => aiGuideBtn.textContent = t("aiGuide"), 1500);
         });
       }
       const cookieCancel = popRef.querySelector("[data-cookie-cancel]");
@@ -589,9 +851,9 @@ window.__ModuleLoader__.load({
           const previewEl = popRef.querySelector(".dshBalanceCookiePreview");
           if (previewEl !== null) {
             previewEl.dataset.found = String(!!cookieExtracted);
-            previewEl.innerHTML = '<b>识别结果：</b>' + (cookieExtracted
+            previewEl.innerHTML = '<b>' + t("extractResult") + "</b>" + (cookieExtracted
               ? '<code>' + escapeHtml(cookieExtracted.slice(0, 180) + (cookieExtracted.length > 180 ? '…' : '')) + '</code>'
-              : '未识别到 Cookie，请粘贴完整 cURL 或请求头');
+              : t("cookieNotFound"));
           }
         });
       }
@@ -603,11 +865,11 @@ window.__ModuleLoader__.load({
           const prompt = MIMO_COOKIE_GUIDE_PROMPT;
           try {
             await navigator.clipboard.writeText(prompt);
-            copyStep2.textContent = "已复制";
+            copyStep2.textContent = t("copied");
           } catch {
-            copyStep2.textContent = "复制失败";
+            copyStep2.textContent = t("copyFailed");
           }
-          setTimeout(() => copyStep2.textContent = "复制提示语 → 和智能体对话", 1500);
+          setTimeout(() => copyStep2.textContent = t("copyPromptToChat"), 1500);
         });
       }
       const cookieManual = popRef.querySelector("[data-cookie-manual]");
@@ -621,18 +883,19 @@ window.__ModuleLoader__.load({
       const usage = usageStateOf(usageEnvelope);
       if (!usage.src) {
         const hint = usage.state === "err"
-          ? "用量接口不可用（" + String(usage.error || "").slice(0, 60) + "）"
-          : "未配置 DEEPSEEK_PLATFORM_TOKEN，仅显示余额。对 AI 说「帮我配置用量统计」，AI 会帮你设置（可选）。";
+          ? t("usageUnavailable", String(usage.error || "").slice(0, 60))
+          : t("usageNotConfigured");
         return '<div class="dshBalanceUsage">' +
-          '<div class="dshBalanceUsageTitle"><b>本月消耗</b><span>未启用</span></div>' +
+          '<div class="dshBalanceUsageTitle"><b>' + t("usageThisMonth") + "</b><span>" + t("usageDisabled") + "</span></div>" +
           '<div class="dshBalanceHint">' + hint + "</div>" +
           "</div>";
       }
       const src = usage.src;
       return '<div class="dshBalanceUsage">' +
-        '<div class="dshBalanceUsageTitle"><b>' + (src.period || "本月") + "消耗</b><span>" + (src.apiKey || "全部") + "</span></div>" +
-        '<div class="dshBalanceRow"><span>本月消费</span><span>' + String(src.totalSpend ?? "—") + "</span></div>" +
-        '<div class="dshBalanceRow"><span>Tokens</span><span>' + String(src.tokens ?? "—") + "</span></div>" +
+        // 宿主端 src.apiKey 是硬编码的中文「API Key 全部」，英文下不能用；DeepSeek 当前只有 1 个 API Key，直接用 i18n key。
+        '<div class="dshBalanceUsageTitle"><b>' + t("usageThisMonth") + "</b><span>" + t("all") + "</span></div>" +
+        '<div class="dshBalanceRow"><span>' + t("thisMonthSpend") + "</span><span>" + String(src.totalSpend ?? "—") + "</span></div>" +
+        '<div class="dshBalanceRow"><span>' + t("tokens") + "</span><span>" + String(src.tokens ?? "—") + "</span></div>" +
         "</div>";
     }
 
@@ -643,24 +906,24 @@ window.__ModuleLoader__.load({
       const cur = info ? (sym(info.currency) || "¥") : "¥";
       let rows = "";
       if (envelope && envelope.error && !info) {
-        rows += '<div class="dshBalanceRow"><span>错误</span><span>' + String(envelope.error).slice(0, 80) + "</span></div>";
+        rows += '<div class="dshBalanceRow"><span>' + t("error") + "</span><span>" + String(envelope.error).slice(0, 80) + "</span></div>";
       } else if (!info) {
-        rows += '<div class="dshBalanceRow"><span>余额</span><span>—</span></div>';
+        rows += '<div class="dshBalanceRow"><span>' + t("balance") + "</span><span>—</span></div>";
       } else {
         const total = info.total_balance;
-        rows += '<div class="dshBalanceRow"><span>余额</span><span>' + cur + (total !== void 0 ? total : "—") + "</span></div>";
+        rows += '<div class="dshBalanceRow"><span>' + t("balance") + "</span><span>" + cur + (total !== void 0 ? total : "—") + "</span></div>";
       }
       // 累计消费（全部时间）——放在余额下面，不属于「本月消耗」区块
       const usage = usageStateOf(usageEnvelope);
       const usageSrc = usage.src;
       if (usageSrc && usageSrc.cumulativeSpend) {
-        rows += '<div class="dshBalanceRow"><span>累计消费</span><span>' + String(usageSrc.cumulativeSpend) + "</span></div>";
+        rows += '<div class="dshBalanceRow"><span>' + t("cumulativeSpend") + "</span><span>" + String(usageSrc.cumulativeSpend) + "</span></div>";
       }
       if (usageSrc && usageSrc.todaySpend) {
-        rows += '<div class="dshBalanceRow"><span>今日消费</span><span>' + fmtYuan(usageSrc.todaySpend) + "</span></div>";
+        rows += '<div class="dshBalanceRow"><span>' + t("todaySpend") + "</span><span>" + fmtYuan(usageSrc.todaySpend) + "</span></div>";
       }
       if (usageSrc && usageSrc.todayTokens) {
-        rows += '<div class="dshBalanceRow"><span>今日Token</span><span>' + String(usageSrc.todayTokens) + "</span></div>";
+        rows += '<div class="dshBalanceRow"><span>' + t("todayTokens") + "</span><span>" + String(usageSrc.todayTokens) + "</span></div>";
       }
       return rows + usageHtmlOf(usageEnvelope);
     }
@@ -676,28 +939,17 @@ window.__ModuleLoader__.load({
           const s = JSON.stringify(v);
           out.push([k, s.length > 48 ? s.slice(0, 48) + "…" : s]);
         } else if (Array.isArray(v)) {
-          out.push([k, "[" + v.length + " 项]"]);
+          out.push([k, "[" + v.length + " " + t("items") + "]"]);
         } else {
           out.push([k, String(v)]);
         }
       }
     }
 
-    /** Chinese labels for known MiMo balance response fields. */
-    const MIMO_FIELD_LABELS = {
-      code: "状态码",
-      message: "消息",
-      frozenBalance: "冻结余额",
-      overdraftLimit: "透支额度",
-      remainingOverdraftLimit: "剩余透支额度",
-      giftBalance: "赠送余额",
-      cashBalance: "现金余额",
-      rechargeBalance: "充值余额",
-      accountBalance: "账户余额",
-      walletBalance: "钱包余额",
-      plan: "套餐",
-      expiredAt: "过期时间"
-    };
+    /** Labels for known MiMo balance response fields (localized). */
+    function mimoFieldLabel(key) {
+      return (I18N[currentLang]?.mimoFieldLabels ?? I18N.zh.mimoFieldLabels)[key] || key;
+    }
 
     /** Build the MiMo usage block (from /api/v1/usage): 与 DeepSeek「本月消耗」一模一样. */
     function mimoUsageHtml(usage) {
@@ -710,9 +962,9 @@ window.__ModuleLoader__.load({
       const tokens = token.totalToken !== void 0 ? fmtInt(token.totalToken) : "—";
       if (totalSpend === "—" && tokens === "—") return "";
       return '<div class="dshBalanceUsage">' +
-        '<div class="dshBalanceUsageTitle"><b>本月消耗</b><span>全部</span></div>' +
-        '<div class="dshBalanceRow"><span>本月消费</span><span>' + totalSpend + "</span></div>" +
-        '<div class="dshBalanceRow"><span>Tokens</span><span>' + tokens + "</span></div>" +
+        '<div class="dshBalanceUsageTitle"><b>' + t("usageThisMonth") + "</b><span>" + t("all") + "</span></div>" +
+        '<div class="dshBalanceRow"><span>' + t("thisMonthSpend") + "</span><span>" + totalSpend + "</span></div>" +
+        '<div class="dshBalanceRow"><span>' + t("tokens") + "</span><span>" + tokens + "</span></div>" +
         "</div>";
     }
 
@@ -722,16 +974,16 @@ window.__ModuleLoader__.load({
       const data = bal.data || {};
       const cur = sym(data.currency) || "¥";
       // 余额（首行，与 DeepSeek 一致）
-      let rows = '<div class="dshBalanceRow"><span>余额</span><span>' + cur + (data.total !== void 0 ? data.total : "—") + "</span></div>";
+      let rows = '<div class="dshBalanceRow"><span>' + t("balance") + "</span><span>" + cur + (data.total !== void 0 ? data.total : "—") + "</span></div>";
       const usage = data.usage || null;
       const cost = usage ? (usage.costUsage || {}) : {};
       // 与 DeepSeek 同款：累计消费 + 今日消费/今日Token（来自 /usage/detail 逐日明细；无今日记录则显示 0）
       if (cost.totalCost !== void 0) {
-        rows += '<div class="dshBalanceRow"><span>累计消费</span><span>¥' + String(cost.totalCost) + "</span></div>";
+        rows += '<div class="dshBalanceRow"><span>' + t("cumulativeSpend") + "</span><span>¥" + String(cost.totalCost) + "</span></div>";
       }
       const today = data.today || null;
-      rows += '<div class="dshBalanceRow"><span>今日消费</span><span>' + (today ? fmtYuan(today.cost) : "¥0.00") + "</span></div>";
-      rows += '<div class="dshBalanceRow"><span>今日Token</span><span>' + (today ? fmtInt(today.tokens) : "0") + "</span></div>";
+      rows += '<div class="dshBalanceRow"><span>' + t("todaySpend") + "</span><span>" + (today ? fmtYuan(today.cost) : "¥0.00") + "</span></div>";
+      rows += '<div class="dshBalanceRow"><span>' + t("todayTokens") + "</span><span>" + (today ? fmtInt(today.tokens) : "0") + "</span></div>";
       // 本月消耗区块（与 DeepSeek 同款样式）
       rows += mimoUsageHtml(usage);
       return rows;
@@ -742,9 +994,9 @@ window.__ModuleLoader__.load({
       if (!Array.isArray(daily) || daily.length === 0) return "";
       // 接口按日期升序返回，全部展示（一个月最多 31 行）。
       let html = '<div class="dshBalanceUsage">' +
-        '<div class="dshBalanceUsageTitle"><b>每日消耗</b><span>MiMo</span></div>' +
+        '<div class="dshBalanceUsageTitle"><b>' + t("dailyUsage") + "</b><span>MiMo</span></div>" +
         '<div class="dshBalanceDaily">' +
-        '<div class="dshBalanceDailyHead"><span>日期</span><span>Token</span><span>请求</span><span>消费</span></div>';
+        '<div class="dshBalanceDailyHead"><span>' + t("date") + "</span><span>Token</span><span>" + t("requests") + "</span><span>" + t("spend") + "</span></div>";
       for (const d of daily) {
         const costStr = Number(d.cost) > 0 ? String(d.cost) : "0";
         html += '<div class="dshBalanceDailyRow">' +
@@ -765,7 +1017,7 @@ window.__ModuleLoader__.load({
       let balanceText = "—";
       let stateAttr = "";
       if (bal) {
-        if (bal.ok === false) { balanceText = bal.needCookie ? "需设置" : "失败"; stateAttr = ' data-state="err"'; }
+        if (bal.ok === false) { balanceText = bal.needCookie ? t("needSetup") : t("failed"); stateAttr = ' data-state="err"'; }
         else balanceText = formatProviderBalance(bal.data);
       }
       return '<button class="dshBalanceTab' + (isActive ? " active" : "") + '" type="button" data-tab="' + escapeHtml(p.id) + '">' +
@@ -781,16 +1033,16 @@ window.__ModuleLoader__.load({
       let actions = "";
       // 所有 provider 详情操作区统一只保留「× 移除」（AI 引导配置入口保留在添加表单里）。
       actions = '<div class="dshBalanceProvActions">' +
-        '<button class="dshBalanceProvRemove" type="button" data-remove="' + escapeHtml(p.id) + '" title="移除">× 移除</button></div>';
+        '<button class="dshBalanceProvRemove" type="button" data-remove="' + escapeHtml(p.id) + '" title="' + t("remove") + '">× ' + t("remove") + "</button></div>";
 
       let errHint = "";
       if (bal && bal.ok === false) {
         if (bal.needCookie) {
-          errHint = '<div class="dshBalanceHint" style="margin-top:8px">MiMo 余额需用浏览器登录 Cookie 查询。请重新在浏览器登录 platform.xiaomimimo.com 后，将 Cookie 更新到 ~/.dsh/ai-balances.json 对应条目中。</div>';
+          errHint = '<div class="dshBalanceHint" style="margin-top:8px">' + t("mimoCookieHint") + "</div>";
         } else {
           const raw = bal.data && bal.data.raw ? String(bal.data.raw).slice(0, 260) : "";
-          errHint = '<div class="dshBalanceHint" style="margin-top:8px">读取失败：' + escapeHtml(String(bal.error || "").slice(0, 50)) +
-            (raw ? '<br><span class="dshBalanceRawHint">' + escapeHtml(raw) + "</span>" : "") + "</div>";
+          errHint = '<div class="dshBalanceHint" style="margin-top:8px">' + t("readFailed", String(bal.error || "").slice(0, 50)) +
+            (raw ? '<br><span class="dshBalanceRawHint">' + t("rawPrefix") + escapeHtml(raw) + "</span>" : "") + "</div>";
         }
       }
       return detail + actions + errHint;
@@ -803,50 +1055,50 @@ window.__ModuleLoader__.load({
       const isMimo = addFormState.kind === "mimo";
       const isDeepseek = addFormState.kind === "deepseek";
       const aiGuide = (isMimo || isDeepseek)
-        ? '<div class="dshBalanceField"><label>配置方式</label>' +
-          '<button class="dshBalanceBtn" type="button" data-ai-guide style="width:100%;justify-content:center">AI 帮我配置</button></div>'
+        ? '<div class="dshBalanceField"><label>' + t("configMethod") + "</label>" +
+          '<button class="dshBalanceBtn" type="button" data-ai-guide style="width:100%;justify-content:center">' + t("aiGuide") + "</button></div>"
         : "";
       const note = (isMimo || isDeepseek)
-        ? '<div class="dshBalanceHint">点「AI 帮我配置」会复制一句话，发给智能体后它会读取本机教程文件、一步步引导你抓取凭证并写入插件。数据仅存本机，不上传。</div>'
-        : '<div class="dshBalanceHint">密钥仅保存在本机 ~/.dsh/ai-balances.json，不会上传。</div>';
+        ? '<div class="dshBalanceHint">' + t("aiGuideNote") + "</div>"
+        : '<div class="dshBalanceHint">' + t("localKeyNote") + "</div>";
       return '<div class="dshBalanceAddForm">' +
-        '<div class="dshBalanceField"><label>平台</label><select class="dshBalanceInput" data-f-kind>' +
-        '<option value="mimo"' + mimoSelected + '>MiMo（小米）</option>' +
-        '<option value="deepseek"' + deepseekSelected + '>DeepSeek</option></select></div>' +
-        '<div class="dshBalanceField"><label>名称</label><input class="dshBalanceInput" data-f-label value="' + escapeHtml(addFormState.label) + '" placeholder="' + (addFormState.kind === "deepseek" ? "例如 DeepSeek" : "例如 MiMo") + '" /></div>' +
+        '<div class="dshBalanceField"><label>' + t("platform") + '</label><select class="dshBalanceInput" data-f-kind>' +
+        '<option value="mimo"' + mimoSelected + ">" + t("mimoOption") + "</option>" +
+        '<option value="deepseek"' + deepseekSelected + ">" + t("deepseekOption") + "</option></select></div>" +
+        '<div class="dshBalanceField"><label>' + t("name") + "</label><input class=\"dshBalanceInput\" data-f-label value=\"" + escapeHtml(addFormState.label) + "\" placeholder=\"" + (addFormState.kind === "deepseek" ? t("namePlaceholderDeepseek") : t("namePlaceholderMimo")) + "\" /></div>" +
         aiGuide +
-        '<div class="dshBalanceFormBtns"><button class="dshBalanceBtn" type="button" data-save>保存</button>' +
-        '<button class="dshBalanceBtn" type="button" data-cancel>取消</button></div>' +
+        '<div class="dshBalanceFormBtns"><button class="dshBalanceBtn" type="button" data-save>' + t("save") + "</button>" +
+        '<button class="dshBalanceBtn" type="button" data-cancel>' + t("cancel") + "</button></div>" +
         note + "</div>";
     }
 
     /** Build the chat-based AI guide panel for MiMo Cookie configuration. */
     function aiGuideCookiePanelHtml() {
       return '<div class="dshBalanceCookiePanel">' +
-        '<div class="dshBalanceHint" style="margin-bottom:4px;font-weight:600">让 AI 在聊天里帮你配置</div>' +
+        '<div class="dshBalanceHint" style="margin-bottom:4px;font-weight:600">' + t("aiChatGuideTitle") + "</div>" +
         '<div class="dshBalanceWizard">' +
-        '<div class="dshBalanceWizardStep"><b>Step 1</b><span>点击下方链接打开 MiMo 余额页并登录</span>' +
-        '<span class="dshBalanceWizardLink" data-open-mimo>打开 platform.xiaomimimo.com/#/console/balance</span></div>' +
-        '<div class="dshBalanceWizardStep"><b>Step 2</b><span>复制下方提示语，发送给智能体，AI 会在对话中一步步引导你完成配置</span>' +
-        '<span class="dshBalanceWizardLink" data-copy-step2>复制提示语 → 和智能体对话</span></div>' +
+        '<div class="dshBalanceWizardStep"><b>' + t("step1") + "</b><span>" + t("step1Desc") + "</span>" +
+        '<span class="dshBalanceWizardLink" data-open-mimo>' + t("openMimoBalance") + "</span></div>" +
+        '<div class="dshBalanceWizardStep"><b>' + t("step2") + "</b><span>" + t("step2Desc") + "</span>" +
+        '<span class="dshBalanceWizardLink" data-copy-step2>' + t("copyPromptToChat") + "</span></div>" +
         '</div>' +
-        '<div class="dshBalanceFormBtns"><button class="dshBalanceBtn" type="button" data-cookie-cancel>取消</button></div>' +
-        '<div style="margin-top:6px"><span class="dshBalanceWizardLink" data-cookie-manual>我要手动粘贴 Cookie</span></div></div>';
+        '<div class="dshBalanceFormBtns"><button class="dshBalanceBtn" type="button" data-cookie-cancel>' + t("cancel") + "</button></div>" +
+        '<div style="margin-top:6px"><span class="dshBalanceWizardLink" data-cookie-manual>' + t("manualPasteCookie") + "</span></div></div>";
     }
 
     /** Build the manual fallback textarea for Cookie configuration. */
     function manualCookiePanelHtml() {
       const preview = cookieExtracted
         ? '<code>' + escapeHtml(cookieExtracted.slice(0, 180) + (cookieExtracted.length > 180 ? '…' : '')) + '</code>'
-        : '未识别到 Cookie，请粘贴完整 cURL 或请求头';
+        : t("cookieNotFound");
       const found = !!cookieExtracted;
       return '<div class="dshBalanceCookiePanel">' +
-        '<div class="dshBalanceHint" style="margin-bottom:4px;font-weight:600">手动粘贴 Cookie</div>' +
-        '<textarea class="dshBalanceInput dshBalanceTextarea" data-cookie-value placeholder="粘贴 Cookie / cURL / 请求头…">' + escapeHtml(cookieEditValue) + '</textarea>' +
-        '<div class="dshBalanceCookiePreview" data-found="' + found + '"><b>识别结果：</b>' + preview + '</div>' +
-        '<div class="dshBalanceFormBtns"><button class="dshBalanceBtn" type="button" data-cookie-save>保存</button>' +
-        '<button class="dshBalanceBtn" type="button" data-cookie-cancel>取消</button></div>' +
-        '<div style="margin-top:6px"><span class="dshBalanceWizardLink" data-cookie-guide>返回 AI 引导</span></div></div>';
+        '<div class="dshBalanceHint" style="margin-bottom:4px;font-weight:600">' + t("manualCookieTitle") + "</div>" +
+        '<textarea class="dshBalanceInput dshBalanceTextarea" data-cookie-value placeholder="' + t("cookiePlaceholder") + '">' + escapeHtml(cookieEditValue) + '</textarea>' +
+        '<div class="dshBalanceCookiePreview" data-found="' + found + '"><b>' + t("extractResult") + "</b>" + preview + '</div>' +
+        '<div class="dshBalanceFormBtns"><button class="dshBalanceBtn" type="button" data-cookie-save>' + t("save") + '</button>' +
+        '<button class="dshBalanceBtn" type="button" data-cookie-cancel>' + t("cancel") + '</button></div>' +
+        '<div style="margin-top:6px"><span class="dshBalanceWizardLink" data-cookie-guide>' + t("backToAiGuide") + "</span></div></div>";
     }
 
     /** Build the MiMo Cookie configuration panel (AI guide or manual fallback). */
@@ -858,17 +1110,17 @@ window.__ModuleLoader__.load({
     function syncHintHtml() {
       if (!lastSyncResult) return "";
       if (!lastSyncResult.ok) {
-        return '<div class="dshBalanceSyncHint" data-state="err">同步失败：' + escapeHtml(String(lastSyncResult.error || "").slice(0, 60)) + "</div>";
+        return '<div class="dshBalanceSyncHint" data-state="err">' + t("syncFailed", escapeHtml(String(lastSyncResult.error || "").slice(0, 60))) + "</div>";
       }
       if (lastSyncResult.added > 0) {
-        return '<div class="dshBalanceSyncHint" data-state="ok">已从 dsh 设置同步 ' + lastSyncResult.added + " 个平台</div>";
+        return '<div class="dshBalanceSyncHint" data-state="ok">' + t("syncAddedN", lastSyncResult.added) + "</div>";
       }
       return "";
     }
 
     /** Build the popover HTML from current state. */
     function popoverHtml() {
-      const header = '<h4>AI 余额<button class="dshBalanceAddBtn" type="button" data-add>+ 添加</button></h4>';
+      const header = '<h4>' + t("aiBalance") + '<button class="dshBalanceAddBtn" type="button" data-add>' + t("add") + "</button></h4>";
       const syncHint = showAddForm ? "" : syncHintHtml();
       let body;
       if (showAddForm) {
@@ -878,7 +1130,7 @@ window.__ModuleLoader__.load({
       } else {
         body = '<div class="dshBalanceProviders">';
         if (providers.length === 0) {
-          body += '<div class="dshBalanceHint">还没有任何 AI 余额，点右上角「+ 添加」。</div>';
+          body += '<div class="dshBalanceHint">' + t("noProviders") + "</div>";
         } else {
           const activeP = providers.find((p) => p.id === activeProviderId) || activeProvider();
           body += '<div class="dshBalanceTabs">';
@@ -894,30 +1146,30 @@ window.__ModuleLoader__.load({
       return header + syncHint + body +
         '<div class="dshBalanceFoot">' + versionHtml +
         '<span style="display:flex;align-items:center;gap:8px">' +
-        '<span>更新于 ' + updated + "</span>" +
-        '<button class="dshBalanceBtn" type="button">刷新</button></span></div>';
+        '<button class="dshBalanceBtn" type="button" data-refresh>' + t("refresh") + "</button>" +
+        '<span>' + t("updatedAt") + updated + "</span></span></div>";
     }
 
     /** Build the npm version snippet shown in the footer (always a clickable button). */
     function versionHtmlOf(versionEnvelope) {
       if (Date.now() < updateSuccessUntil) {
-        return '<span class="dshBalanceVersion" data-state="ok">成功，请重启 dsh</span>';
+        return '<span class="dshBalanceVersion" data-state="ok">' + t("updateSuccess") + "</span>";
       }
       if (!versionEnvelope) {
-        return '<span class="dshBalanceVersion" data-state="ok"><button class="dshBalanceVersionBtn" type="button" data-update-cmd>检查更新</button></span>';
+        return '<span class="dshBalanceVersion" data-state="ok"><button class="dshBalanceVersionBtn" type="button" data-update-cmd>' + t("checkUpdate") + "</button></span>";
       }
       if (versionEnvelope.ok === false) {
-        return '<span class="dshBalanceVersion" data-state="err"><button class="dshBalanceVersionBtn" type="button" data-update-cmd>检查更新</button></span>';
+        return '<span class="dshBalanceVersion" data-state="err"><button class="dshBalanceVersionBtn" type="button" data-update-cmd>' + t("checkUpdate") + "</button></span>";
       }
       const local = versionEnvelope.local || "?";
       if (versionEnvelope.updateAvailable && versionEnvelope.latest) {
         return '<span class="dshBalanceVersion" data-state="update">' +
           'v' + local + " → v" + versionEnvelope.latest +
-          '<button class="dshBalanceVersionBtn" type="button" data-update-cmd>更新</button>' +
+          '<button class="dshBalanceVersionBtn" type="button" data-update-cmd>' + t("update") + "</button>" +
           "</span>";
       }
       return '<span class="dshBalanceVersion" data-state="ok">' +
-        'v' + local + '<button class="dshBalanceVersionBtn" type="button" data-update-cmd>检查更新</button>' +
+        'v' + local + '<button class="dshBalanceVersionBtn" type="button" data-update-cmd>' + t("checkUpdate") + "</button>" +
         "</span>";
     }
 
@@ -927,11 +1179,11 @@ window.__ModuleLoader__.load({
       const kind = (popRef.querySelector("[data-f-kind]")?.value || "mimo");
       const label = (popRef.querySelector("[data-f-label]")?.value || "").trim();
       if (!label) {
-        window.alert("请填写名称");
+        window.alert(t("fillName"));
         return;
       }
       const saveBtn = popRef.querySelector("[data-save]");
-      if (saveBtn !== null) { saveBtn.disabled = true; saveBtn.textContent = "保存中…"; }
+      if (saveBtn !== null) { saveBtn.disabled = true; saveBtn.textContent = t("saving"); }
       const body = { label, kind };
       const result = await saveProvider(body);
       if (result && result.ok) {
@@ -939,15 +1191,15 @@ window.__ModuleLoader__.load({
         showAddForm = false;
         await refresh(true);
       } else {
-        if (saveBtn !== null) { saveBtn.disabled = false; saveBtn.textContent = "保存"; }
-        window.alert("保存失败：" + (result && result.error ? result.error : "未知错误"));
+        if (saveBtn !== null) { saveBtn.disabled = false; saveBtn.textContent = t("save"); }
+        window.alert(t("saveFailed", result && result.error ? result.error : "unknown"));
       }
     }
 
     /** Handle the "remove" action for a provider. */
     async function onRemoveProvider(id) {
       if (id === "deepseek") return;
-      if (!window.confirm("确定移除该 AI 余额？")) return;
+      if (!window.confirm(t("confirmRemove"))) return;
       await removeProvider(id);
       if (activeProviderId === id) activeProviderId = null;
       await refresh(true);
@@ -956,16 +1208,16 @@ window.__ModuleLoader__.load({
     /** Handle the "save cookie" action from the MiMo cookie panel. */
     async function onSaveCookie() {
       if (popRef === null || !cookieEditId) return;
-      if (!cookieExtracted) { window.alert("请粘贴 Cookie 或 cURL，AI 会自动提取"); return; }
+      if (!cookieExtracted) { window.alert(t("pasteCookieHint")); return; }
       const saveBtn = popRef.querySelector("[data-cookie-save]");
-      if (saveBtn !== null) { saveBtn.disabled = true; saveBtn.textContent = "保存中…"; }
+      if (saveBtn !== null) { saveBtn.disabled = true; saveBtn.textContent = t("saving"); }
       const result = await saveProvider({ id: cookieEditId, kind: "mimo", cookie: cookieExtracted });
       if (result && result.ok) {
         cookieEditId = null; cookieEditValue = ""; cookieExtracted = "";
         await refresh(true);
       } else {
-        if (saveBtn !== null) { saveBtn.disabled = false; saveBtn.textContent = "保存"; }
-        window.alert("保存失败：" + (result && result.error ? result.error : "未知错误"));
+        if (saveBtn !== null) { saveBtn.disabled = false; saveBtn.textContent = t("save"); }
+        window.alert(t("saveFailed", result && result.error ? result.error : "unknown"));
       }
     }
 
@@ -1084,7 +1336,7 @@ window.__ModuleLoader__.load({
       } catch (e) {
         if (entryRef) {
           const v = entryRef.querySelector(".dshBalanceValue");
-          if (v) { v.dataset.state = "err"; v.textContent = "失败"; }
+          if (v) { v.dataset.state = "err"; v.textContent = t("failed"); }
         }
         lastEnvelope = { ok: false, error: String(e?.message ?? e) };
         renderPopover();
@@ -1105,6 +1357,22 @@ window.__ModuleLoader__.load({
     function apply(ctx) {
       ensureStyle();
       if (typeof document !== "undefined" && document.querySelector("[data-dsh-balance-entry]") !== null) return () => {};
+      // 用 dsh 的 LocaleRuntime 服务读取/订阅语言（ctx.locale 由 @deepseek-ai/dsh-client-locale provide）。
+      let offLocaleChange = null;
+      try {
+        const snap = ctx.locale && typeof ctx.locale.getLocale === "function" ? ctx.locale.getLocale() : null;
+        if (snap && typeof snap.active === "string") currentLang = snap.active === "en" ? "en" : "zh";
+        if (ctx.locale && typeof ctx.locale.subscribe === "function") {
+          offLocaleChange = ctx.locale.subscribe(() => {
+            const s = ctx.locale.getLocale();
+            const next = s && s.active === "en" ? "en" : "zh";
+            if (next !== currentLang) {
+              currentLang = next;
+              applyLangChange(next);
+            }
+          });
+        }
+      } catch { /* locale service optional */ }
       const effect = ctx.effect(() => {
         const entry = createEntry("compact");
         entryRef = entry;
@@ -1156,6 +1424,7 @@ window.__ModuleLoader__.load({
         return () => {
           waitObserver.disconnect();
           rootObserver.disconnect();
+          if (offLocaleChange !== null) { try { offLocaleChange(); } catch { /* ignore */ } offLocaleChange = null; }
           if (timer !== null) clearInterval(timer);
           if (versionTimer !== null) clearInterval(versionTimer);
           if (outsideHandler !== null) {
@@ -1173,7 +1442,8 @@ window.__ModuleLoader__.load({
     }
 
     exports.apply = apply;
-    exports.inject = [];
+    /** Declare the locale service dependency so ctx.locale is available (dsh i18n). */
+    exports.inject = ["locale"];
     return module.exports;
   }
 });

package/lib/index.js

@@ -885,10 +885,6 @@ function apply(ctx) {
             return;
           }
           const result = await queryBalance(key);
-          // 入口不展示货币符号：把币种字段清空，任何版本的前端都不会拼出 ¥。
-          if (result.ok && Array.isArray(result.data?.balance_infos)) {
-            for (const info of result.data.balance_infos) info.currency = "";
-          }
           res.writeHead(result.ok ? 200 : 502, { "content-type": "application/json; charset=utf-8" });
           res.end(JSON.stringify(result));
         } catch (error) {
@@ -996,6 +992,40 @@ function apply(ctx) {
     return dispose;
   }, "deepseek-balance-widget: update route");
 
+  /** Read the user's locale from dsh settings.yaml (locale.preference). */
+  ctx.effect(() => {
+    const dispose = ctx.webServer.register({
+      kind: "prefix",
+      path: "/deepseek-balance-locale",
+      handler: async (req, res) => {
+        const url = new URL(req.url ?? "/", "http://x");
+        if (req.method !== "GET" || url.pathname !== "/deepseek-balance-locale") {
+          res.writeHead(404, { "content-type": "application/json; charset=utf-8" });
+          res.end(JSON.stringify({ ok: false, error: "not found" }));
+          return;
+        }
+        try {
+          let lang = "zh";
+          try {
+            const text = await readFile(DSH_SETTINGS_PATH, "utf8");
+            // 解析 YAML 顶层 locale: 段下的 preference: 字段（宽松匹配缩进）。
+            const match = text.match(/^locale:\s*\r?\n(\s+preference:\s*(\S+))/m);
+            if (match) {
+              const value = match[2].replace(/^["']|["']$/g, "").toLowerCase();
+              if (value === "en" || value === "zh") lang = value;
+            }
+          } catch { /* settings file missing/unreadable -> default zh */ }
+          res.writeHead(200, { "content-type": "application/json; charset=utf-8" });
+          res.end(JSON.stringify({ ok: true, lang }));
+        } catch (error) {
+          res.writeHead(500, { "content-type": "application/json; charset=utf-8" });
+          res.end(JSON.stringify({ ok: false, error: String(error?.message ?? error) }));
+        }
+      }
+    });
+    return dispose;
+  }, "deepseek-balance-widget: locale route");
+
   /** Provider list (GET), add/update (POST), remove (DELETE). */
   ctx.effect(() => {
     const dispose = ctx.webServer.register({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-deepseek-balance-widget",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "type": "module",
   "description": "Multi-provider AI balance widget for the dsh web sidebar: a live, auto-refreshing balance pill plus a detail popover listing DeepSeek and any added providers (MiMo etc.). Keys are stored per-machine in ~/.dsh/ai-balances.json and resolved from the local credential seam, never hardcoded.",
   "keywords": [