dsh-consumption-badge 1.2.2 → 1.3.1

package/README.md

@@ -2,15 +2,28 @@
 
 A **persistent** DSH (DeepSeek Harness) Web UI plugin that puts a live consumption badge
 next to every assistant message, and opens a detail panel with the session's spend curve.
-The UI is **bilingual**: it follows the shell language (Chinese or English) and switches live.
+The UI is **bilingual** (follows the shell language, switches live) and amounts can be shown in
+**any of 17 major currencies** — pick one in Settings → Usage.
 
 ```
-⛽ 25.6k | ≈¥0.020 | Off-peak
+⛽ 3.2k | ≈¥0.004 | Off-peak | Balance = ¥42.50
 ```
 
-- **Collapsed pill** – session-cumulative tokens, estimated cost (always prefixed `≈`), and the
-  current peak/off-peak tier (red `Peak`, green `Off-peak`), injected into
+- **Collapsed pill** – **that assistant message's own** token count, its **own** estimated cost
+  (always prefixed `≈`), its pricing tier (red `Peak`, green `Off-peak`, attributed to the turn's
+  request start), and the DeepSeek **account balance**; injected into
   `conversation.chat.assistant-actions` right after the shipped copy/branch controls.
+  The two numbers are **this turn's, not the session's**: the slot renders once per turn
+  (`TurnTailNodeView`) and hands the badge that turn's final `messageId`; the host answers with a
+  `messageId → message` map (which carries the turn number) next to the per-turn fold, and the badge
+  renders that turn's folded total. Mapping is resolved in two steps so the pill is right even
+  before the host half is restarted: the host map first, then the `data-turn-tail` attribute the
+  shipped conversation view puts on the turn wrapper. If neither resolves (or the turn has no record
+  yet) the pill falls back to the session-wide figures instead of showing a false zero, and its
+  tooltip names the scope being shown. The balance segment renders `Balance = ¥42.50` when the
+  account API answers, `…` while loading and `—` on failure (the reason rides the tooltip); balance
+  uses the same 60 s cache as the modal, refreshed once a minute. The modal itself still shows the
+  whole session, unchanged.
 - **Detail modal** (centered, blurred backdrop, `Esc` or backdrop-click to close):
   cumulative tokens with hit/miss/output split, estimated cost, current pricing tier,
   DeepSeek account balance, and a **per-turn dual-axis line chart**
@@ -71,6 +84,111 @@ The UI is **bilingual**: it follows the shell language (Chinese or English) and
 
 Everything is an **estimate** for reference only — this plugin is not a billing system of record.
 
+## Currency
+
+The price table is always **CNY per 1M tokens** (that is what DeepSeek bills in); the currency
+setting only decides how amounts are *displayed*. Pick it in **Settings → Usage → Currency**:
+
+| Aspect | Behavior |
+| --- | --- |
+| Currencies | CNY (default) plus USD, EUR, GBP, JPY, HKD, TWD, KRW, SGD, AUD, CAD, CHF, INR, RUB, BRL, THB, MXN |
+| What converts | every amount in the plugin: pill (`≈# dsh-consumption-badge
+
+A **persistent** DSH (DeepSeek Harness) Web UI plugin that puts a live consumption badge
+next to every assistant message, and opens a detail panel with the session's spend curve.
+The UI is **bilingual** (follows the shell language, switches live) and amounts can be shown in
+**any of 17 major currencies** — pick one in Settings → Usage.
+
+```
+⛽ 3.2k | ≈¥0.004 | Off-peak | Balance = ¥42.50
+```
+
+- **Collapsed pill** – **that assistant message's own** token count, its **own** estimated cost
+  (always prefixed `≈`), its pricing tier (red `Peak`, green `Off-peak`, attributed to the turn's
+  request start), and the DeepSeek **account balance**; injected into
+  `conversation.chat.assistant-actions` right after the shipped copy/branch controls.
+  The two numbers are **this turn's, not the session's**: the slot renders once per turn
+  (`TurnTailNodeView`) and hands the badge that turn's final `messageId`; the host answers with a
+  `messageId → message` map (which carries the turn number) next to the per-turn fold, and the badge
+  renders that turn's folded total. Mapping is resolved in two steps so the pill is right even
+  before the host half is restarted: the host map first, then the `data-turn-tail` attribute the
+  shipped conversation view puts on the turn wrapper. If neither resolves (or the turn has no record
+  yet) the pill falls back to the session-wide figures instead of showing a false zero, and its
+  tooltip names the scope being shown. The balance segment renders `Balance = ¥42.50` when the
+  account API answers, `…` while loading and `—` on failure (the reason rides the tooltip); balance
+  uses the same 60 s cache as the modal, refreshed once a minute. The modal itself still shows the
+  whole session, unchanged.
+- **Detail modal** (centered, blurred backdrop, `Esc` or backdrop-click to close):
+  cumulative tokens with hit/miss/output split, estimated cost, current pricing tier,
+  DeepSeek account balance, and a **per-turn dual-axis line chart**
+  (left axis: tokens, right axis: ¥) with a hover tooltip showing the model,
+  input-hit / input-miss / output tokens, and the turn's peak/off-peak flag.
+- **Settings page · Usage** (`settings.section`, id `balance-dsh-consumption`, order 26):
+  a top row of four cards — **Total tokens** (with hit/miss/output split, all-history totals),
+  **Estimated cost**, **Current window** (peak/off-peak) and **Account balance** (reusing the
+  badge's cached balance) — then **all-session history** as one line chart, filterable by time range
+  (Today / Last 7 days / Last 30 days / Last 12 months), by workspace
+  (All workspaces + every registered workspace + Unassigned), and by an explicit
+  calendar range that overrides the dropdown. Bucket size follows the range:
+  **hourly for today and any single-day calendar range**, daily for multi-day ranges, and
+  monthly for the last 12 months. Left axis (tokens) is hidden until you
+  toggle it in the legend; the right axis (¥) is always on. Hovering a point shows its
+  total, its peak/off-peak split and the models involved; the footer sums the current
+  selection. No data in range → a plain "No usage recorded in this range" note instead of an
+  empty chart. The cards are **all-history** totals (independent of the filters); the footer is the
+  filtered total, so the two numbers differ by design.
+- **Personalization integration** (auto-detected, no configuration): when
+  [`dsh-plugin-personalization`](https://www.npmjs.com/package/dsh-plugin-personalization) is
+  installed alongside this plugin, a **Usage popup** block is appended to its settings page —
+  same `pp-block` / `pp-field` / `pp-modes` layout and the same `Pill` primitive as the shipped
+  personalization rows — offering four backgrounds for the consumption modal:
+  **Default / Glass / Custom image / Solid color**.
+  - **Default** keeps the themed surface; **Glass** is real `backdrop-filter` glass — both the veil
+    behind the modal and the panel itself are theme-derived (`--dsw-alias-bg-base`), so light themes
+    get a light haze and dark themes a dark one instead of the panel painting a dark slab over the
+    page; **Custom image** takes an image URL *or* a local image plus an **Opacity** slider
+    (0–100 %, default 85 %) that sets the background layer's own `opacity` — the same semantic as the
+    other personalization background rows, so lowering it fades the image over the themed panel
+    instead of dimming it; **Solid color** takes a hex colour and derives a light/dark ink palette so
+    the cards, chart and tooltips stay readable (the palette also overrides the tooltip surface).
+  - A **Glass** switch appears for Custom image and Solid color, so glass composites with them:
+    on an image it blurs the image itself (frosted photo), on a solid it makes the colour
+    translucent over a blurred page. A **Glass strength** slider (0–48 px, default 22 px) sets the
+    blur radius of the panel. The overlay behind the modal is deliberately never blurred.
+  - **Clear** wipes the image, the URL field and the file picker in one go. The image row shows a
+    **thumbnail** plus the live save state (Saving… / Saved on this device / `error: …`), and
+    failures are logged with a `[consumption-badge]` tag instead of failing silently. The picker is a
+    button (Choose image… / Change image…), not a raw file input, so saving never leaves a
+    misleading "no file chosen" label behind.
+  - Local images are **stored on this machine with no size limit**: the picked file is written as a
+    Blob into IndexedDB (`dsh-consumption-assets` → `images`), and the preference only keeps a small
+    key — so a 20 MB wallpaper no longer blows the `localStorage` quota. On startup the blob is read
+    back into a `blob:` URL for the modal; **Clear** deletes the stored record as well.
+    If IndexedDB is unavailable the file is read as a data URL instead, and the row says so.
+  - The choice is a local preference (`dsh-consumption:modal-style`) and is applied to the open
+    modal immediately. Nothing about the conversation or sidebar backgrounds is touched.
+- **Update notice** (same shape as `dsh-plugin-personalization`'s): ~2.5 s after the page loads the
+  plugin asks `https://registry.npmjs.org/dsh-consumption-badge/latest` for the newest version
+  (24 h cache, 5 s timeout, fails silently). If the installed version is older — and that version
+  was not ignored — a non-blocking card appears in the bottom-right corner with
+  **current → latest**, the exact `dsh plugin --profile web update dsh-consumption-badge` command,
+  and three actions: **Copy update command**, **Ignore this version** (remembered on this machine)
+  and **Remind me later** (this page load only). It never blocks the conversation and never covers
+  controls.
+
+Everything is an **estimate** for reference only — this plugin is not a billing system of record.
+
+), modal cards and both charts' right axis, the settings cards and footer totals, and the account balance (when the balance API reports CNY) |
+| Rates | 1 CNY = n target currency, cached **6 h**. Primary source `open.er-api.com`, fallback `@fawazahmed0/currency-api` via jsDelivr — fetched through the host route `/api/consumption/rates`, and **directly from the browser** when that route is unavailable (both endpoints send `access-control-allow-origin: *`) |
+| Offline | if no live rate can be fetched, a built-in fallback table is used and the settings hint says so |
+| Preference | `localStorage` key `dsh-consumption:currency`; the settings hint shows the active rate, its source and a timestamp |
+| Unchanged | the pricing table, peak/off-peak rules and every stored record stay in CNY — switching currency never rewrites data |
+
+```
+costCNY = (hit/1e6)*hit + (miss/1e6)*miss + (out/1e6)*out   [×2 at peak]
+shown   = costCNY × rate[currency]
+```
+
 ## Localization
 
 The plugin ships **Chinese and English** copy and follows the DSH shell language live — no reload,
@@ -191,8 +309,9 @@ The host half registers three exact, read-only routes on the DSH web server:
 
 | Route | Returns |
 | --- | --- |
-| `GET /api/consumption/turns?sessionId=<id>` | per-turn `{turn, hit, miss, out, time, model}` (log-length cached) |
+| `GET /api/consumption/turns?sessionId=<id>` | per-turn `{turn, hit, miss, out, time, model}` **plus** per-message `{id, turn, step, hit, miss, out, time, model}` (the `id` is the finalized message id the badge receives as `messageId`); log-length cached |
 | `GET /api/consumption/account` | current provider/model + whether the key is configured |
+| `GET /api/consumption/rates[?force=1]` | `{ok, base:"CNY", rates:{USD:…}, source, fetchedAt, stale}` — 16 curated currencies, 6 h cache; `stale:true` means the built-in fallback table |
 | `GET /api/consumption/balance[?force=1]` | `{ok, available, currency, total, granted, toppedUp}`; `is_available:false` renders a red "insufficient balance" |
 
 Failures are `{ok:false, code, detail, error}`: `code` is language-neutral
@@ -222,7 +341,7 @@ Install the DSH plugin "dsh-consumption-badge" into my web profile and prove it
    `{"ok":true,...}`. Verify the client half:
    `curl -s -o /dev/null -w '%{http_code}' http://127.0.0.1:<port>/plugins/dsh-consumption-badge/client.js`
    must return `200`.
-5. Open any session and confirm the `⛽ <tokens> | ≈¥<cost> | Peak|Off-peak` pill in the assistant
+5. Open any session and confirm the `⛽ <tokens> | ≈¥<cost> | Peak|Off-peak | Balance = ¥<total>` pill in the assistant
    action row; click it and confirm the modal shows the four cards, the dual-axis chart, the
    balance, and that Esc closes it.
 6. Keep Settings → Usage open, then switch the shell language between Chinese and English
@@ -255,7 +374,7 @@ plugin by "running" it — a session-scoped dynamic plugin always dies with the
 - Do not hard-code user-visible English or Chinese in new JSX: call `tt('…')` with the Chinese copy
   as the key and add the English entry to `DICT_EN`. `check.mjs` fails if any `tt()` key has no
   English translation or if a translation still contains Chinese.
-- Self-check without booting DSH: `node check.mjs` (224 assertions over the route contract, the
+- Self-check without booting DSH: `node check.mjs` (273 assertions over the route contract, the
   client bundle contract, the pricing/aggregation maths and the bilingual copy). It lives outside
   the published `files` list.
 

package/lib/client.js

@@ -95,6 +95,152 @@ window.__ModuleLoader__.load({
       if (n < 100) return n.toFixed(2)
       return n.toFixed(1)
     }
+
+    /* ===================== 显示币种（报价表始终是人民币） ===================== */
+    const LS_CURRENCY = 'dsh-consumption:currency'
+    const RATES_TTL_MS = 6 * 60 * 60 * 1000
+    /** 可选币种 + 符号；顺序与 Host 的 CURRENCY_CODES 一致（CNY 永远是第一项）。 */
+    const CURRENCIES = [
+      { code: 'CNY', symbol: '¥' },
+      { code: 'USD', symbol: '$' },
+      { code: 'EUR', symbol: '€' },
+      { code: 'GBP', symbol: '£' },
+      { code: 'JPY', symbol: 'JP¥' },
+      { code: 'HKD', symbol: 'HK$' },
+      { code: 'TWD', symbol: 'NT$' },
+      { code: 'KRW', symbol: '₩' },
+      { code: 'SGD', symbol: 'S$' },
+      { code: 'AUD', symbol: 'A$' },
+      { code: 'CAD', symbol: 'C$' },
+      { code: 'CHF', symbol: 'CHF ' },
+      { code: 'INR', symbol: '₹' },
+      { code: 'RUB', symbol: '₽' },
+      { code: 'BRL', symbol: 'R$' },
+      { code: 'THB', symbol: '฿' },
+      { code: 'MXN', symbol: 'MX$' },
+    ]
+
+    function currencyMeta(code) {
+      for (let i = 0; i < CURRENCIES.length; i += 1) {
+        if (CURRENCIES[i].code === code) return CURRENCIES[i]
+      }
+      return null
+    }
+    function symbolOf(code) {
+      const meta = currencyMeta(code)
+      return meta !== null ? meta.symbol : String(code) + ' '
+    }
+    /** 币种全名：优先用 Intl.DisplayNames（跟随系统语言），取不到就用代码。 */
+    function currencyName(code) {
+      try {
+        if (typeof Intl === 'object' && typeof Intl.DisplayNames === 'function') {
+          const names = new Intl.DisplayNames([localeTag()], { type: 'currency' })
+          const name = names.of(code)
+          if (typeof name === 'string' && name && name !== code) return name
+        }
+      } catch (e) { /* 回落代码 */ }
+      return code
+    }
+    /** 当前偏好币种（读不到/非法一律人民币）。 */
+    function readCurrency() {
+      const raw = lsGet(LS_CURRENCY)
+      return currencyMeta(raw) !== null ? raw : 'CNY'
+    }
+    /**
+     * 把人民币金额换算成当前偏好币种。
+     * @returns {{value: number, code: string, rate: number, converted: boolean}}
+     *   `converted: false` 表示汇率还没拿到或该币种没有汇率 → 保持人民币。
+     */
+    function convertCny(value) {
+      const n = Number(value) || 0
+      // `store` 是模块级常量，渲染期一定已初始化；仍然兜一层，避免任何早期调用撞 TDZ。
+      let st = null
+      try {
+        st = store.state
+      } catch (e) {
+        st = null
+      }
+      const code = st !== null && typeof st.currency === 'string' ? st.currency : 'CNY'
+      if (code === 'CNY') return { value: n, code: 'CNY', rate: 1, converted: false }
+      const payload = st !== null ? st.rates : null
+      const table = payload && payload.rates && typeof payload.rates === 'object' ? payload.rates : null
+      const rate = table !== null && typeof table[code] === 'number' ? table[code] : null
+      if (rate === null || !(rate > 0)) return { value: n, code: 'CNY', rate: 1, converted: false }
+      return { value: n * rate, code: code, rate: rate, converted: true }
+    }
+    /** 金额（按偏好币种换算 + 前缀符号）。 */
+    function money(value) {
+      const r = convertCny(value)
+      return symbolOf(r.code) + fmtYuan(r.value)
+    }
+    /** 估算金额前缀 `≈`。 */
+    function moneyApprox(value) {
+      return '≈' + money(value)
+    }
+    /** 账户余额：原生币种是 CNY 就走换算，其它币种按原样显示。 */
+    function moneyBalance(amount, nativeCode) {
+      const src = typeof nativeCode === 'string' && nativeCode ? nativeCode : 'CNY'
+      if (src !== 'CNY') return symbolOf(src) + fmtYuan(Number(amount) || 0)
+      return money(amount)
+    }
+    /**
+     * 浏览器直连的汇率源（两个都带 `access-control-allow-origin: *`）。
+     * 用来兜住「Host 半边还没重启、/rates 404」以及 Host 侧出网被挡的情况。
+     */
+    const RATE_ENDPOINTS = [
+      { url: 'https://open.er-api.com/v6/latest/CNY', source: 'open.er-api.com' },
+      { url: 'https://cdn.jsdelivr.net/npm/@fawazahmed0/currency-api@latest/v1/currencies/cny.json', source: 'currency-api' },
+    ]
+
+    /** 把两种公开汇率的响应归一成 `{ok, base, rates, source, fetchedAt}`。 */
+    function parseRatesPayload(json, source) {
+      if (!json || typeof json !== 'object') return null
+      const raw = json.rates && typeof json.rates === 'object' ? json.rates : (json.cny && typeof json.cny === 'object' ? json.cny : null)
+      if (raw === null) return null
+      const rates = {}
+      let found = 0
+      for (let i = 0; i < CURRENCIES.length; i += 1) {
+        const code = CURRENCIES[i].code
+        const v = typeof raw[code] === 'number' ? raw[code] : raw[code.toLowerCase()]
+        if (typeof v === 'number' && Number.isFinite(v) && v > 0) {
+          rates[code] = v
+          found += 1
+        }
+      }
+      if (found === 0) return null
+      const stamp = typeof json.time_last_update_unix === 'number'
+        ? json.time_last_update_unix * 1000
+        : (typeof json.date === 'string' ? Date.parse(json.date) : 0)
+      return {
+        ok: true,
+        base: 'CNY',
+        rates: rates,
+        source: source,
+        fetchedAt: Number.isFinite(stamp) && stamp > 0 ? stamp : 0,
+        stale: false,
+        via: 'browser',
+      }
+    }
+
+    /** 依次尝试浏览器直连的汇率源；全失败返回 null。 */
+    function fetchRatesDirect() {
+      if (typeof fetch !== 'function') return Promise.resolve(null)
+      let chain = Promise.resolve(null)
+      for (let i = 0; i < RATE_ENDPOINTS.length; i += 1) {
+        const endpoint = RATE_ENDPOINTS[i]
+        chain = chain.then(function (found) {
+          if (found !== null) return found
+          return fetch(endpoint.url, { headers: { accept: 'application/json' } })
+            .then(function (res) {
+              if (!res || res.ok === false) return null
+              return res.json()
+            })
+            .then(function (json) { return parseRatesPayload(json, endpoint.source) })
+            .catch(function () { return null })
+        })
+      }
+      return chain
+    }
     function bucketOfTurns(turns) {
       const out = { hit: 0, miss: 0, out: 0 }
       for (let i = 0; i < turns.length; i += 1) {
@@ -138,6 +284,17 @@ window.__ModuleLoader__.load({
       '账户余额': 'Account balance',
       '逐轮消耗趋势': 'Per-turn usage trend',
       '命中 {hit} · 未命中 {miss} · 输出 {out}': 'hit {hit} · miss {miss} · output {out}',
+      '本轮消耗（点击查看本会话明细）': 'This turn’s usage (click for session details)',
+      '货币': 'Currency',
+      '金额按人民币报价折算显示': 'Amounts are priced in CNY and converted for display',
+      '当前以人民币显示（可切换成其它币种）': 'Showing CNY — pick another currency to convert',
+      '1 CNY = {rate} {code}': '1 CNY = {rate} {code}',
+      '汇率来源 {source}': 'rates from {source}',
+      '内置兜底汇率': 'built-in fallback',
+      '联网失败时使用内置汇率': 'built-in rates used because the lookup failed',
+      '正在获取汇率…': 'Fetching exchange rates…',
+      '汇率获取失败，暂时按人民币显示：{msg}': 'Could not fetch exchange rates, showing CNY: {msg}',
+      '余额 = {amount}': 'Balance = {amount}',
       '{id}（按 flash 估算）': '{id} (priced as flash)',
       ' · 峰时 ×2': ' · peak ×2',
       ' · 谷时': ' · off-peak ×1',
@@ -168,8 +325,8 @@ window.__ModuleLoader__.load({
       '余额接口不可用': 'Balance API unavailable',
       '余额不足': 'Insufficient balance',
       '请前往 DeepSeek 开放平台充值': 'Top up at the DeepSeek open platform',
-      '赠送 ¥{v}': 'granted ¥{v}',
-      '充值 ¥{v}': 'topped up ¥{v}',
+      '赠送 {amount}': 'granted {amount}',
+      '充值 {amount}': 'topped up {amount}',
       'DeepSeek 账户余额': 'DeepSeek account balance',
       '空响应': 'Empty response',
       '余额获取失败': 'Balance request failed',
@@ -282,6 +439,15 @@ window.__ModuleLoader__.load({
      * 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.
+     *
+     * The dictionary namespace is `consumption-badge`. A **hot reload inside an
+     * open page** mounts a second fiber while the previous one's registration may
+     * still be alive (the shell re-imports the bundle); the locale service rejects
+     * a duplicate `(ns, locale)` pair, and the old dictionary would then stay bound
+     * forever — new keys added in a later build would render as their raw Chinese
+     * key. So: on a duplicate we register under a suffixed namespace instead of
+     * giving up, and we hand the disposer to `ctx.effect` so a clean unload frees
+     * the plain namespace again.
      * @param ctx client cordis context.
      */
     function attachLocale(ctx) {
@@ -296,15 +462,29 @@ window.__ModuleLoader__.load({
         service = null
       }
       if (service === null || typeof service.register !== 'function' || typeof service.bind !== 'function') return
+      // Only the `en` side is registered: the key already is the `zh` copy, and
+      // the locale service resolves a miss to the key itself.
+      let ns = LOCALE_NS
+      let dispose = null
       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)
+        dispose = service.register(ns, 'en', DICT_EN)
       } catch (e) {
-        // Already registered (hot re-mount of the same fiber) — binding is enough.
+        ns = LOCALE_NS + '#' + BUILD_TAG + '-' + Math.random().toString(36).slice(2, 7)
+        try {
+          dispose = service.register(ns, 'en', DICT_EN)
+          console.warn('[consumption-badge] previous dictionary still registered; bound a private locale namespace ' + ns)
+        } catch (e2) {
+          console.warn('[consumption-badge] locale dictionary registration failed: ' + msgOf(e2))
+          return
+        }
       }
-      boundTranslate = service.bind(LOCALE_NS)
+      boundTranslate = service.bind(ns)
       localeService = service
+      if (typeof dispose === 'function' && ctx && typeof ctx.effect === 'function') {
+        try {
+          ctx.effect(function () { return dispose })
+        } catch (e) { /* effects unavailable (tests): the dictionary simply stays */ }
+      }
     }
 
     /**
@@ -340,6 +520,20 @@ window.__ModuleLoader__.load({
       }
     }
 
+    /** Active locale id ('zh' when the service is absent). */
+    function activeLocaleId() {
+      try {
+        const snapshot = localeService !== null && typeof localeService.getLocale === 'function' ? localeService.getLocale() : null
+        if (snapshot && typeof snapshot.active === 'string' && snapshot.active) return snapshot.active
+      } catch (e) { /* fall through */ }
+      return 'zh'
+    }
+
+    /** BCP-47 tag for Intl: only zh/en are shipped. */
+    function localeTag() {
+      return activeLocaleId() === 'en' ? 'en' : 'zh-CN'
+    }
+
     /* Host error codes (lib/index.js) → the Chinese key tt() translates. */
     const HOST_ERROR_KEYS = {
       'no-credentials': 'credentials 服务不可用',
@@ -454,10 +648,10 @@ window.__ModuleLoader__.load({
 
     /* ================= 消耗弹窗背景样式（与个性化插件联动） ================= */
     const MODAL_STYLE_KEY = 'dsh-consumption:modal-style'
-    const BUILD_TAG = 'dcb-1.2.2'
+    const BUILD_TAG = 'dcb-1.3.1'
     // 本地版本：本包是零构建的手写客户端包，无法 import package.json，因此把版本号作为常量维护，
     // 并由 check.mjs 守卫与 package.json 严格一致（发布前不一致直接失败）。
-    const PLUGIN_VERSION = '1.2.2'
+    const PLUGIN_VERSION = '1.3.1'
     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
@@ -830,6 +1024,11 @@ window.__ModuleLoader__.load({
         version: 0,
         focusPending: false,
         turns: [],
+        // 逐条 assistant 消息的用量（messageId → 记录）：只用来把胶囊定位到「哪一轮」。
+        messages: [],
+        messageById: new Map(),
+        // turn 号 → /turns 里的折叠记录（胶囊显示的是这一轮的合计）。
+        turnByNumber: new Map(),
         turnsState: 'idle',
         turnsError: '',
         // Error copy is stored language-neutral: the kind names the sentence and
@@ -841,6 +1040,11 @@ window.__ModuleLoader__.load({
         accountState: 'idle',
         integrations: null,
         modalStyle: readModalStyle(),
+        // 显示币种（本地偏好）+ 汇率（Host 路由，6h 缓存）：金额展示都走 money()。
+        currency: readCurrency(),
+        rates: null,
+        ratesState: 'idle',
+        ratesError: '',
         // 已解析的弹窗背景图地址：URL 直接用，本地图片是 IndexedDB 里的 blob: 地址。
         modalImageUrl: '',
         // 图片保存过程的可观测状态：'' | 'saving' | 'saved' | 以 'error:' 开头的失败原因
@@ -856,11 +1060,13 @@ window.__ModuleLoader__.load({
         balanceErrorCode: '',
         balanceErrorFallback: '',
         balanceAt: 0,
+        ratesAt: 0,
       }
       const listeners = new Set()
       let turnsInFlight = null
       let accountInFlight = null
       let balanceInFlight = null
+      let ratesInFlight = null
 
       function emit() {
         state.version += 1
@@ -899,6 +1105,9 @@ window.__ModuleLoader__.load({
         if (state.sessionId !== sessionId) {
           state.sessionId = sessionId
           state.turns = []
+          state.messages = []
+          state.messageById = new Map()
+          state.turnByNumber = new Map()
           state.turnsState = 'idle'
           state.turnsError = ''
         }
@@ -921,7 +1130,33 @@ window.__ModuleLoader__.load({
                 cached: false,
               })
             }
+            // 逐条消息：仅当 Host 回了 messages（新增字段）时才覆盖，否则保持空表 ⇒ 徽章回落本会话口径。
+            const rawMessages = res && Array.isArray(res.messages) ? res.messages : []
+            const messages = []
+            const byId = new Map()
+            for (let i = 0; i < rawMessages.length; i += 1) {
+              const m = rawMessages[i]
+              if (!m || typeof m !== 'object') continue
+              const rec = {
+                id: typeof m.id === 'string' ? m.id : '',
+                turn: num(m.turn),
+                step: num(m.step),
+                hit: num(m.hit),
+                miss: num(m.miss),
+                out: num(m.out),
+                time: num(m.time),
+                model: typeof m.model === 'string' ? m.model : '',
+              }
+              messages.push(rec)
+              if (rec.id !== '') byId.set(rec.id, rec)
+            }
+            state.messages = messages
+            state.messageById = byId
             state.turns = restoreTurns(sessionId, normalized)
+            // 索引必须和 state.turns 用同一份数据（restoreTurns 会补上历史窗口外的轮次）。
+            const turnByNumber = new Map()
+            for (let i = 0; i < state.turns.length; i += 1) turnByNumber.set(state.turns[i].turn, state.turns[i])
+            state.turnByNumber = turnByNumber
             state.turnsState = res && res.ok === false ? 'error' : 'ready'
             if (res && res.ok === false) {
               state.turnsErrorKind = 'host'
@@ -1008,6 +1243,63 @@ window.__ModuleLoader__.load({
       function bump() {
         emit()
       }
+      /**
+       * 取汇率（Host 端 6h 缓存；`force` 强制刷新 Host 缓存）。
+       * 只要当前币种不是人民币就需要它，取不到时金额回落为人民币显示。
+       */
+      function ensureRates(force) {
+        const now = Date.now()
+        const fresh = state.rates && state.rates.ok && now - (state.ratesAt || 0) < RATES_TTL_MS
+        if (!force && fresh) return Promise.resolve(state.rates)
+        if (ratesInFlight) return ratesInFlight
+        state.ratesState = 'loading'
+        emit()
+        ratesInFlight = Promise.resolve()
+          .then(function () { return fetchJson(API + '/rates' + (force ? '?force=1' : '')) })
+          .catch(function () { return null })
+          .then(function (res) {
+            if (res && typeof res === 'object' && res.ok !== false && res.rates && typeof res.rates === 'object') {
+              return Object.assign({ via: 'host' }, res)
+            }
+            // Host 路由还没就绪（例如还没重启）或出网被挡：浏览器直连公开汇率源。
+            return fetchRatesDirect()
+          })
+          .then(function (res) {
+            if (res && typeof res === 'object' && res.ok !== false && res.rates && typeof res.rates === 'object') {
+              state.rates = res
+              state.ratesAt = Date.now()
+              state.ratesState = 'ready'
+              state.ratesError = ''
+            } else {
+              state.rates = null
+              state.ratesState = 'error'
+              state.ratesError = res && typeof res.error === 'string' ? res.error : 'rates unavailable'
+            }
+            emit()
+          })
+          .catch(function (e) {
+            state.rates = null
+            state.ratesState = 'error'
+            state.ratesError = msgOf(e)
+            emit()
+          })
+          .then(function () { ratesInFlight = null })
+        return ratesInFlight
+      }
+      /** 切换显示币种：落本地偏好 → 需要汇率时顺手取一次 → 通知所有订阅者（即时重绘）。 */
+      function setCurrency(code) {
+        const next = currencyMeta(code) !== null ? code : 'CNY'
+        if (state.currency === next) return
+        state.currency = next
+        lsSet(LS_CURRENCY, next)
+        emit()
+        if (next !== 'CNY') ensureRates(false)
+      }
+      /** 强制刷新汇率（设置页的「刷新汇率」按钮）。 */
+      function refreshRates() {
+        state.rates = null
+        return ensureRates(true)
+      }
       /** 更新弹窗背景配置：合并 → 落本地偏好 → 通知所有订阅者（弹层即时重绘）。 */
       function setModalStyle(patch) {
         const prev = state.modalStyle
@@ -1167,6 +1459,9 @@ window.__ModuleLoader__.load({
         ensureAccount: ensureAccount,
         ensureTurns: ensureTurns,
         ensureBalance: ensureBalance,
+        ensureRates: ensureRates,
+        setCurrency: setCurrency,
+        refreshRates: refreshRates,
         openPanel: openPanel,
         closePanel: closePanel,
         setModalStyle: setModalStyle,
@@ -1254,7 +1549,7 @@ window.__ModuleLoader__.load({
         const y = CHART_PAD.t + innerH * ratio
         grid.push(h('line', { key: 'g' + g, x1: CHART_PAD.l, x2: CHART_PAD.l + innerW, y1: y, y2: y, className: 'dcb-grid-line' }))
         leftLabels.push(h('text', { key: 'lt' + g, x: CHART_PAD.l - 8, y: y + 3.5, textAnchor: 'end', className: 'dcb-axis-label' }, fmtTokens(topToken * (1 - ratio))))
-        rightLabels.push(h('text', { key: 'rt' + g, x: CHART_PAD.l + innerW + 8, y: y + 3.5, textAnchor: 'start', className: 'dcb-axis-label' }, '¥' + fmtYuan(topCost * (1 - ratio))))
+        rightLabels.push(h('text', { key: 'rt' + g, x: CHART_PAD.l + innerW + 8, y: y + 3.5, textAnchor: 'start', className: 'dcb-axis-label' }, money(topCost * (1 - ratio))))
       }
       const step = n <= 8 ? 1 : Math.ceil(n / 8)
       const xLabels = []
@@ -1294,7 +1589,7 @@ window.__ModuleLoader__.load({
             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))))
+            h('div', { className: 'dcb-tooltip-row dcb-tooltip-total' }, h('span', null, tt('估算金额')), h('b', null, moneyApprox(hovered.cost))))
         : null
 
       return h('div', { className: 'dcb-chart-wrap' },
@@ -1357,6 +1652,26 @@ window.__ModuleLoader__.load({
         props.hint ? h('div', { className: 'dcb-card-hint' }, props.hint) : null)
     }
 
+    /**
+     * 从 DOM 里读出「自己在第几轮」：外壳把 assistant-actions 这个槽位渲染在
+     * `<div data-turn-tail="<turn>">` 里面。这是给「Host 还没重启、没回 messageId→turn 映射」
+     * 时用的兜底通道 —— 有 Host 映射时优先用 Host 的。
+     * @param el 胶囊自身的 DOM 节点。
+     * @returns 轮次号，取不到返回 undefined。
+     */
+    function turnFromElement(el) {
+      if (!el || typeof el.closest !== 'function') return undefined
+      let node = null
+      try {
+        node = el.closest('[data-turn-tail]')
+      } catch (e) {
+        node = null
+      }
+      if (!node || typeof node.getAttribute !== 'function') return undefined
+      const n = Number(node.getAttribute('data-turn-tail'))
+      return Number.isFinite(n) && n > 0 ? n : undefined
+    }
+
     function ConsumptionBadge(props) {
       const state = store.state
       const tick = React.useState(0)
@@ -1365,35 +1680,86 @@ window.__ModuleLoader__.load({
         return store.subscribe(function () { setTick(function (v) { return v + 1 }) })
       }, [])
       const sessionId = props && typeof props.sessionId === 'string' ? props.sessionId : ''
+      // 槽位 owner 传的是这条 finalized assistant 消息的身份；用它把自己的用量挑出来。
+      const messageId = props && typeof props.messageId === 'string' ? props.messageId : ''
+      const rootRef = React.useRef(null)
+      const domTurnState = React.useState(undefined)
+      const domTurn = domTurnState[0]
+      const setDomTurn = domTurnState[1]
+      React.useEffect(function () {
+        // 每次渲染后都对一遍（槽位可能在 DOM 变动后被重新挂载）。
+        const found = turnFromElement(rootRef.current)
+        if (found !== undefined && found !== domTurn) setDomTurn(found)
+      })
       const projection = props && typeof props.useProjection === 'function' ? props.useProjection('tokenUsage') : undefined
       React.useEffect(function () {
         store.ensureAccount()
         store.ensureTurns(sessionId)
+        // 胶囊里也要显示余额：走同一份 60s 缓存，不额外压测接口。
+        store.ensureBalance(false)
+        // 非人民币显示时才需要汇率（Host 端 6h 缓存）。
+        if (store.state.currency !== 'CNY') store.ensureRates(false)
       }, [sessionId, projection])
       React.useEffect(function () {
-        return everyTick(60000, function () { store.bump() })
+        return everyTick(60000, function () {
+          store.bump()
+          store.ensureBalance(false)
+        })
       }, [])
 
+      // 槽位是按「轮」渲染的（TurnTailNodeView 用该轮的 finalNode.messageId 调 useSlots），
+      // 所以这里要的是**这一轮**的合计，而不是某一步、更不是整个会话：
+      // messageId → turn 号（Host 回映射）→ 该 turn 的折叠记录（/turns 本来就有）。
+      const mapped = messageId !== '' ? state.messageById.get(messageId) : undefined
+      // 优先 Host 的 messageId→turn；Host 旧版本没回 messages 时退回 DOM 上的轮次号。
+      const turnNo = mapped !== undefined ? mapped.turn : domTurn
+      const ownTurn = typeof turnNo === 'number' ? state.turnByNumber.get(turnNo) : undefined
       const live = projection && typeof projection === 'object'
-      const bucket = live
-        ? {
-            hit: num(projection.cacheReadTokens),
-            miss: num(projection.uncachedInputTokens) + num(projection.cacheWriteTokens),
-            out: num(projection.outputTokens),
-          }
-        : bucketOfTurns(state.turns)
-      // Without the live projection the first paint has no numbers yet: show a
-      // placeholder instead of a misleading zero.
-      const pending = !live && state.turns.length === 0 && state.turnsState !== 'ready'
-      const model = state.account && typeof state.account.model === 'string' && state.account.model ? state.account.model : DEFAULT_MODEL
-      const peak = isPeakAt(Date.now())
-      const tokens = bucket.hit + bucket.miss + bucket.out
-      const cost = costOf(bucket, priceFor(model).table, peak)
+      // 三级口径：本轮合计 → 本会话（投影 / 折叠后的逐轮）→ 还没有数据。
+      let bucket = null
+      let scope = 'turn'
+      let bucketModel = ''
+      let bucketTime = 0
+      if (ownTurn !== undefined) {
+        bucket = { hit: ownTurn.hit, miss: ownTurn.miss, out: ownTurn.out }
+        bucketModel = ownTurn.model
+        bucketTime = ownTurn.time
+      } else if (live) {
+        scope = 'session'
+        bucket = {
+          hit: num(projection.cacheReadTokens),
+          miss: num(projection.uncachedInputTokens) + num(projection.cacheWriteTokens),
+          out: num(projection.outputTokens),
+        }
+      } else if (state.turns.length > 0) {
+        scope = 'session'
+        bucket = bucketOfTurns(state.turns)
+      }
+      // 还没有任何数字时显示占位符，而不是误导性的 0。
+      const pending = bucket === null && state.turnsState !== 'ready'
+      const model = bucketModel
+        || (state.account && typeof state.account.model === 'string' && state.account.model ? state.account.model : DEFAULT_MODEL)
+      const at = bucketTime > 0 ? bucketTime : Date.now()
+      const peak = isPeakAt(at)
+      const tokens = bucket === null ? 0 : bucket.hit + bucket.miss + bucket.out
+      const cost = bucket === null ? 0 : costOf(bucket, priceFor(model).table, peak)
+
+      // 账户余额：成功 → ¥金额；读取中 → …；失败/未配置 → —（原因放 title，不挤占胶囊宽度）。
+      const balance = state.balance
+      let balanceValue = '…'
+      if (balance && balance.ok === true && typeof balance.total === 'number') {
+        balanceValue = moneyBalance(balance.total, balance.currency)
+      } else if (state.balanceState === 'ready' || state.balanceState === 'error') {
+        balanceValue = '—'
+      }
+      const balanceTitle = balanceErrorText() || tt('账户余额')
 
       return h('button', {
         type: 'button',
         className: 'dcb-pill',
-        title: tt('本会话消耗（点击查看逐轮明细）'),
+        ref: function (el) { rootRef.current = el || null },
+        title: (scope === 'turn' ? tt('本轮消耗（点击查看本会话明细）') : tt('本会话消耗（点击查看逐轮明细）'))
+          + ' · ' + balanceTitle + ': ' + balanceValue,
         onClick: function (event) {
           try {
             event.preventDefault()
@@ -1405,9 +1771,11 @@ window.__ModuleLoader__.load({
         h('span', { className: 'dcb-pill-glyph' }, '⛽'),
         h('span', null, pending ? '…' : fmtTokens(tokens)),
         h('span', { className: 'dcb-pill-sep' }, '|'),
-        h('span', null, pending ? '…' : '≈¥' + fmtYuan(cost)),
+        h('span', null, pending ? '…' : moneyApprox(cost)),
+        h('span', { className: 'dcb-pill-sep' }, '|'),
+        h('span', { className: peak ? 'dcb-tag is-peak' : 'dcb-tag is-valley' }, tt(peak ? '峰' : '谷')),
         h('span', { className: 'dcb-pill-sep' }, '|'),
-        h('span', { className: peak ? 'dcb-tag is-peak' : 'dcb-tag is-valley' }, tt(peak ? '峰' : '谷')))
+        h('span', { className: 'dcb-pill-balance' }, tt('余额 = {amount}', { amount: balanceValue })))
     }
 
     function ConsumptionPanel() {
@@ -1432,6 +1800,7 @@ window.__ModuleLoader__.load({
         if (!open) return undefined
         store.ensureTurns(state.sessionId)
         store.ensureBalance(false)
+        if (store.state.currency !== 'CNY') store.ensureRates(false)
         return everyTick(60000, function () { store.ensureBalance(false) })
       }, [open, state.sessionId])
       if (!open) return null
@@ -1463,11 +1832,10 @@ window.__ModuleLoader__.load({
         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)
+        balanceValue = moneyBalance(balance.total, balance.currency)
         const parts = []
-        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) }))
+        if (typeof balance.granted === 'number') parts.push(tt('赠送 {amount}', { amount: moneyBalance(balance.granted, balance.currency) }))
+        if (typeof balance.toppedUp === 'number') parts.push(tt('充值 {amount}', { amount: moneyBalance(balance.toppedUp, balance.currency) }))
         balanceHint = parts.length ? parts.join(' · ') : tt('DeepSeek 账户余额')
       }
 
@@ -1506,7 +1874,7 @@ window.__ModuleLoader__.load({
               h('button', { type: 'button', className: 'dcb-btn dcb-btn-close', onClick: close, title: tt('Esc 关闭') }, '✕'))),
           h('div', { className: 'dcb-cards' },
             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: moneyApprox(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' }, tt('账户余额')),
@@ -1890,7 +2258,7 @@ window.__ModuleLoader__.load({
         const ratio = g / 4
         const y = HIST_PAD.t + innerH * ratio
         grid.push(h('line', { key: 'hg' + g, x1: HIST_PAD.l, x2: HIST_PAD.l + innerW, y1: y, y2: y, className: 'dcb-grid-line' }))
-        rightLabels.push(h('text', { key: 'hr' + g, x: HIST_PAD.l + innerW + 8, y: y + 3.5, textAnchor: 'start', className: 'dcb-axis-label' }, '¥' + fmtYuan(topCost * (1 - ratio))))
+        rightLabels.push(h('text', { key: 'hr' + g, x: HIST_PAD.l + innerW + 8, y: y + 3.5, textAnchor: 'start', className: 'dcb-axis-label' }, money(topCost * (1 - ratio))))
         if (showTokens) {
           leftLabels.push(h('text', { key: 'hl' + g, x: HIST_PAD.l - 8, y: y + 3.5, textAnchor: 'end', className: 'dcb-axis-label' }, fmtTokens(topToken * (1 - ratio))))
         }
@@ -1935,10 +2303,10 @@ window.__ModuleLoader__.load({
             h('div', { className: 'dcb-tooltip-title' },
               hovered.label,
               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 dcb-tooltip-total' }, h('span', null, tt('当日合计')), h('b', null, moneyApprox(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, 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, moneyApprox(hovered.peakCost) + ' / ' + fmtTokens(hovered.peakTokens))),
+            h('div', { className: 'dcb-tooltip-row' }, h('span', null, tt('谷时')), h('b', null, moneyApprox(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
 
@@ -2002,6 +2370,10 @@ window.__ModuleLoader__.load({
         store.ensureBalance(false)
         return everyTick(60000, function () { store.ensureBalance(false) })
       }, [])
+      // 非人民币显示时才需要汇率（Host 端 6h 缓存，切币种时 setCurrency 已经会取一次）。
+      React.useEffect(function () {
+        if (store.state.currency !== 'CNY') store.ensureRates(false)
+      }, [])
 
       // 工作区签名：id + 标题 + 归属会话（WorkspaceView.sessionIds 即归属账本）。
       const wsSig = props && typeof props.useWorkspaces === 'function'
@@ -2084,6 +2456,29 @@ window.__ModuleLoader__.load({
       }, [records, wsSig])
 
       const st = store.state
+      // 显示币种 + 汇率提示（报价表恒为人民币，这里只是展示换算）。
+      const currency = typeof st.currency === 'string' ? st.currency : 'CNY'
+      const rates = st.rates
+      const rateValue = rates && rates.rates && typeof rates.rates[currency] === 'number' ? rates.rates[currency] : null
+      let rateNote = tt('金额按人民币报价折算显示')
+      if (currency === 'CNY') {
+        rateNote = tt('当前以人民币显示（可切换成其它币种）')
+      } else if (rateValue !== null) {
+        const when = rates && rates.fetchedAt ? new Date(rates.fetchedAt) : null
+        const stamp = when !== null && !Number.isNaN(when.getTime())
+          ? when.toLocaleString(localeTag())
+          : ''
+        rateNote = tt('1 CNY = {rate} {code}', { rate: String(Number(rateValue.toFixed(6))), code: currency })
+          + ' · ' + tt('汇率来源 {source}', { source: rates.stale === true ? tt('内置兜底汇率') : String(rates.source || '') })
+          + (stamp ? ' · ' + stamp : '')
+          + (rates.stale === true ? ' · ' + tt('联网失败时使用内置汇率') : '')
+      } else if (st.ratesState === 'loading') {
+        rateNote = tt('正在获取汇率…')
+      } else if (st.ratesState === 'error') {
+        rateNote = tt('汇率获取失败，暂时按人民币显示：{msg}', { msg: String(st.ratesError || '') })
+      } else {
+        rateNote = tt('金额按人民币报价折算显示')
+      }
       const accountModel = st.account && typeof st.account.model === 'string' && st.account.model ? st.account.model : DEFAULT_MODEL
       const accountPrice = priceFor(accountModel)
       const nowPeak = isPeakAt(Date.now())
@@ -2105,11 +2500,10 @@ window.__ModuleLoader__.load({
         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)
+        balanceValue = moneyBalance(balance.total, balance.currency)
         const parts = []
-        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) }))
+        if (typeof balance.granted === 'number') parts.push(tt('赠送 {amount}', { amount: moneyBalance(balance.granted, balance.currency) }))
+        if (typeof balance.toppedUp === 'number') parts.push(tt('充值 {amount}', { amount: moneyBalance(balance.toppedUp, balance.currency) }))
         balanceHint = parts.length ? parts.join(' · ') : tt('DeepSeek 账户余额')
       }
 
@@ -2138,7 +2532,7 @@ window.__ModuleLoader__.load({
           }),
           h(Card, {
             label: tt('估算金额'),
-            value: allStats ? '≈¥' + fmtYuan(allStats.totalCost) : '—',
+            value: allStats ? moneyApprox(allStats.totalCost) : '—',
             hint: (accountPrice.known ? accountPrice.id : tt('{id}（按 flash 估算）', { id: accountPrice.id })) + tt(' · 全部历史逐轮计价'),
           }),
           h(Card, {
@@ -2197,7 +2591,20 @@ window.__ModuleLoader__.load({
                 : null)),
           h('div', { className: 'dcb-field' },
             h('span', { className: 'dcb-field-label' }, tt('数据')),
-            h('button', { type: 'button', className: 'dcb-btn', onClick: function () { setReloadTick(function (v) { return v + 1 }) } }, tt('刷新')))),
+            h('button', { type: 'button', className: 'dcb-btn', onClick: function () { setReloadTick(function (v) { return v + 1 }) } }, tt('刷新'))),
+          // 显示币种：报价表永远是人民币，这里只决定展示时换算成什么货币。
+          h('div', { className: 'dcb-field' },
+            h('label', { className: 'dcb-field-label', htmlFor: 'dcb-currency-select' }, tt('货币')),
+            h('select', {
+              id: 'dcb-currency-select',
+              className: 'dcb-select',
+              value: currency,
+              onChange: function (event) { store.setCurrency(event.target.value) },
+            },
+              CURRENCIES.map(function (c) {
+                return h('option', { key: c.code, value: c.code }, c.code + ' ' + c.symbol.trim() + ' · ' + currencyName(c.code))
+              })))),
+        h('div', { className: 'dcb-set-note dcb-rate-note' }, rateNote),
         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), tt('估算金额（右轴）')),
@@ -2211,11 +2618,11 @@ window.__ModuleLoader__.load({
             : h('div', { className: 'dcb-hist-empty' }, tt('该范围内暂无消耗记录'))),
         hasData
           ? h('div', { className: 'dcb-sum' },
-              h('span', null, tt('总消耗 '), h('b', null, '≈¥' + fmtYuan(stats.totalCost))),
+              h('span', null, tt('总消耗 '), h('b', null, moneyApprox(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, moneyApprox(stats.peakCost))),
+              h('span', null, tt('谷时 '), h('b', null, moneyApprox(stats.valleyCost))),
               h('span', null, tt('粒度 '), h('b', null, tt(stats.granularity === 'month' ? '按月' : (stats.granularity === 'hour' ? '按小时' : '按日')))))
           : null,
         h('div', { className: 'dcb-hist-aside' },
@@ -2620,6 +3027,7 @@ window.__ModuleLoader__.load({
 .dcb-pill:hover{border-color:var(--dsw-alias-brand-primary);color:var(--dsw-alias-label-primary)}
 .dcb-pill-glyph{font-size:11px;line-height:1}
 .dcb-pill-sep{opacity:.35}
+.dcb-pill-balance{font-variant-numeric:tabular-nums;max-width:160px;overflow:hidden;text-overflow:ellipsis}
 .dcb-tag{font-weight:600}
 .dcb-tag.is-peak{color:var(--dsw-alias-state-error-primary)}
 .dcb-tag.is-valley{color:var(--dsw-alias-state-success-primary)}
@@ -2690,6 +3098,10 @@ window.__ModuleLoader__.load({
 .dcb-field-label{font-size:11px;color:var(--dsw-alias-label-secondary)}
 .dcb-select,.dcb-date{height:28px;padding:0 8px;border-radius:8px;border:1px solid var(--dsw-alias-border-l1);background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-primary);font-size:12px;min-width:0}
 .dcb-select{min-width:132px;cursor:pointer}
+/* 币种下拉要放「代码 + 符号 + 全名」，给它多一点宽度 */
+#dcb-currency-select{min-width:196px;max-width:300px}
+/* 汇率说明行会显示汇率 / 来源 / 时间戳，允许换行 */
+.dcb-rate-note{white-space:normal;line-height:16px;margin:-6px 0 12px}
 .dcb-date{min-width:126px}
 .dcb-select:focus,.dcb-date:focus{outline:none;border-color:var(--dsw-alias-brand-primary)}
 .dcb-range{display:flex;align-items:center;gap:6px}

package/lib/index.js

@@ -27,6 +27,41 @@ let balanceCache = { at: 0, value: null }
 /** dsh-plugin-personalization 是否同时安装（null = 尚未探测）。 */
 let personalizationProbe = null
 
+/**
+ * 可选显示币种（报价表本身始终是人民币，浏览器半边只做展示换算）。
+ * 顺序即设置页下拉里的顺序。
+ */
+const CURRENCY_CODES = ['USD', 'EUR', 'GBP', 'JPY', 'HKD', 'TWD', 'KRW', 'SGD', 'AUD', 'CAD', 'CHF', 'INR', 'RUB', 'BRL', 'THB', 'MXN']
+
+/**
+ * 内置兜底汇率（1 CNY = n 目标币种），取自 2026-11-02 的 open.er-api.com。
+ * 只在取不到实时汇率（离线/被墙/接口改版）时使用，返回值里会标 `stale: true`。
+ */
+const FALLBACK_RATES = {
+  USD: 0.150131,
+  EUR: 0.134567,
+  GBP: 0.112169,
+  JPY: 23.670366,
+  HKD: 1.177898,
+  TWD: 4.889976,
+  KRW: 200.722601,
+  SGD: 0.191923,
+  AUD: 0.213732,
+  CAD: 0.2098,
+  CHF: 0.123863,
+  INR: 14.290818,
+  RUB: 12.180268,
+  BRL: 0.807624,
+  THB: 5.054541,
+  MXN: 2.816108,
+}
+const RATES_TTL_MS = 6 * 60 * 60 * 1000
+const RATES_SOURCES = [
+  'https://open.er-api.com/v6/latest/CNY',
+  'https://cdn.jsdelivr.net/npm/@fawazahmed0/currency-api@latest/v1/currencies/cny.json',
+]
+let ratesCache = { at: 0, value: null }
+
 /**
  * 探测 dsh-plugin-personalization 是否与本插件共存于同一 profile 的 node_modules：
  * 只 import 它那个空的 host 入口（不调用 apply），失败即视为未安装。
@@ -69,12 +104,15 @@ function sanitizeKey(value) {
 
 /**
  * 折叠会话日志：assistant/message 上的 usage 按 turn 归并，轮次上下文取当时生效的路由。
+ * 同一遍扫描里再按 `message.id` 留一份**逐条消息**记录 —— 徽章要显示「这条回复自己」的用量，
+ * 而 turn 会合并同轮多步（多步一问一答时两者不相等）。
  * @param events 会话事件数组（SessionEvent[]）。
- * @returns 按 turn 升序的逐轮记录。
+ * @returns {{turns: object[], messages: object[]}} turns 按 turn 升序；messages 按日志顺序。
  */
-function foldTurns(events) {
+function foldEvents(events) {
   const byTurn = new Map()
   const starts = new Map()
+  const messages = []
   let model = ''
   let provider = ''
   for (let i = 0; i < events.length; i += 1) {
@@ -119,6 +157,19 @@ function foldTurns(events) {
     rec.out += num(u.outputTokens)
     rec.steps += 1
     if (!rec.model && model) rec.model = model
+    // 逐条消息记录：id 来自 assistant/message 的 message.id（= 槽位给的 messageId）。
+    const message = d.message
+    const id = message && typeof message.id === 'string' ? message.id : ''
+    messages.push({
+      id: id,
+      turn: turn,
+      step: typeof d.step === 'number' ? d.step : 0,
+      hit: num(u.cacheReadTokens),
+      miss: num(u.inputTokens) + num(u.cacheWriteTokens),
+      out: num(u.outputTokens),
+      time: 0,
+      model: model || '',
+    })
   }
   const keys = []
   byTurn.forEach(function (_v, k) { keys.push(k) })
@@ -130,7 +181,12 @@ function foldTurns(events) {
     rec.time = typeof t0 === 'number' ? t0 : 0
     turns.push(rec)
   }
-  return turns
+  // 时间统一按「该轮请求开始的时刻」归属峰谷（与 turns 同口径）。
+  for (let i = 0; i < messages.length; i += 1) {
+    const t0 = starts.get(messages[i].turn)
+    messages[i].time = typeof t0 === 'number' ? t0 : 0
+  }
+  return { turns: turns, messages: messages }
 }
 
 /** 归一化 /user/balance 响应。 */
@@ -290,18 +346,22 @@ export function apply(ctx) {
 
   /** 逐轮用量（带 length 版本缓存，日志没变就不重折）。 */
   async function handleTurns(sessionId) {
-    if (!sessionId) return { ok: false, code: 'missing-session-id', error: 'missing sessionId', turns: [] }
+    if (!sessionId) return { ok: false, code: 'missing-session-id', error: 'missing sessionId', turns: [], messages: [] }
     const events = await readEvents(sessionId)
-    if (events === null) return { ok: false, code: 'log-unavailable', error: 'session log unavailable', turns: [] }
+    if (events === null) return { ok: false, code: 'log-unavailable', error: 'session log unavailable', turns: [], messages: [] }
     const cached = turnCache.get(sessionId)
-    if (cached && cached.length === events.length) return { ok: true, cached: true, turns: cached.turns }
-    const turns = foldTurns(events)
+    if (cached && cached.length === events.length) {
+      return { ok: true, cached: true, turns: cached.turns, messages: cached.messages }
+    }
+    const folded = foldEvents(events)
+    const turns = folded.turns
+    const messages = folded.messages
     if (turnCache.size >= TURN_CACHE_LIMIT && !turnCache.has(sessionId)) {
       const firstKey = turnCache.keys().next()
       if (!firstKey.done) turnCache.delete(firstKey.value)
     }
-    turnCache.set(sessionId, { length: events.length, turns: turns })
-    return { ok: true, cached: false, turns: turns }
+    turnCache.set(sessionId, { length: events.length, turns: turns, messages: messages })
+    return { ok: true, cached: false, turns: turns, messages: messages }
   }
 
   /** 当前模型（计价用），读不到就让浏览器回退 flash。 */
@@ -338,6 +398,93 @@ export function apply(ctx) {
     return out
   }
 
+  /**
+   * 取一次实时汇率（1 CNY = n 目标币种）。只取 CURRENCY_CODES 里那几种，避免整包塞给浏览器。
+   * 通道与本插件的余额请求一致（curl），另用全局 fetch 作为第二通道；
+   * 两个源都失败时回内置兜底表并标 `stale: true`（界面会说明这是兜底汇率）。
+   * @returns {{rates: object, source: string, fetchedAt: number, stale: boolean, error: string}}
+   */
+  async function fetchRates() {
+    const subprocess = ctx.get('subprocess')
+    let lastError = ''
+    for (let i = 0; i < RATES_SOURCES.length; i += 1) {
+      const url = RATES_SOURCES[i]
+      let text = ''
+      if (subprocess && typeof subprocess.spawn === 'function') {
+        try {
+          const handle = subprocess.spawn({
+            argv: ['curl', '-sS', '--max-time', '12', url],
+            cwd: process.cwd(),
+            stdio: { stdin: { data: '' }, stdout: { maxBytes: 262144 }, stderr: { maxBytes: 4096 } },
+            graceMs: 3000,
+          })
+          await handle.done
+          const collected = handle.collected || {}
+          const outRead = collected.stdout ? collected.stdout.readFrom(0) : null
+          text = outRead && typeof outRead.text === 'string' ? outRead.text.trim() : ''
+        } catch (e) {
+          lastError = errText(e)
+          text = ''
+        }
+      }
+      if (!text && typeof fetch === 'function') {
+        try {
+          const response = await fetch(url)
+          if (response && response.ok !== false) text = String(await response.text()).trim()
+        } catch (e) {
+          lastError = errText(e)
+          text = ''
+        }
+      }
+      if (!text) continue
+      let json = null
+      try {
+        json = JSON.parse(text)
+      } catch (e) {
+        lastError = 'bad rates payload'
+        continue
+      }
+      if (!json || typeof json !== 'object') continue
+      const raw = json.rates && typeof json.rates === 'object'
+        ? json.rates
+        : (json.cny && typeof json.cny === 'object' ? json.cny : null)
+      if (!raw) continue
+      const rates = {}
+      let found = 0
+      for (let k = 0; k < CURRENCY_CODES.length; k += 1) {
+        const code = CURRENCY_CODES[k]
+        const v = typeof raw[code] === 'number' ? raw[code] : raw[code.toLowerCase()]
+        if (typeof v === 'number' && Number.isFinite(v) && v > 0) {
+          rates[code] = v
+          found += 1
+        }
+      }
+      if (found === 0) continue
+      const stamp = typeof json.time_last_update_unix === 'number'
+        ? json.time_last_update_unix * 1000
+        : (typeof json.date === 'string' ? Date.parse(json.date) : 0)
+      return {
+        rates: rates,
+        source: url.indexOf('er-api') >= 0 ? 'open.er-api.com' : 'currency-api',
+        fetchedAt: Number.isFinite(stamp) && stamp > 0 ? stamp : 0,
+        stale: false,
+        error: '',
+      }
+    }
+    return { rates: FALLBACK_RATES, source: 'builtin', fetchedAt: 0, stale: true, error: lastError || 'live rates unavailable' }
+  }
+
+  /** 汇率入口：进程内缓存 6h，`?force=1` 强制刷新。 */
+  async function handleRates(force) {
+    const now = Date.now()
+    if (!force && ratesCache.value && now - ratesCache.at < RATES_TTL_MS) {
+      return Object.assign({ ok: true, base: 'CNY', codes: CURRENCY_CODES, cached: true }, ratesCache.value)
+    }
+    const fetched = await fetchRates()
+    ratesCache = { at: Date.now(), value: fetched }
+    return Object.assign({ ok: true, base: 'CNY', codes: CURRENCY_CODES, cached: false }, fetched)
+  }
+
   disposers.push(ctx.webServer.register({
     kind: 'exact',
     path: ROUTE_BASE + '/turns',
@@ -364,6 +511,19 @@ export function apply(ctx) {
     },
   }))
 
+  disposers.push(ctx.webServer.register({
+    kind: 'exact',
+    path: ROUTE_BASE + '/rates',
+    handler: async function (req, res) {
+      try {
+        const url = new URL(req.url || '/', 'http://127.0.0.1')
+        sendJson(res, 200, await handleRates(url.searchParams.get('force') === '1'))
+      } catch (e) {
+        sendJson(res, 500, { ok: false, error: errText(e) })
+      }
+    },
+  }))
+
   disposers.push(ctx.webServer.register({
     kind: 'exact',
     path: ROUTE_BASE + '/balance',
@@ -395,4 +555,4 @@ export function apply(ctx) {
       disposers.length = 0
     }
   })
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-consumption-badge",
-  "version": "1.2.2",
+  "version": "1.3.1",
   "description": "DSH Web UI plugin: a per-message consumption badge (tokens | estimated cost | peak/valley) plus a session detail modal with cumulative tokens, estimated cost, Beijing-time peak/off-peak pricing, a per-turn dual-axis chart, and the DeepSeek account balance",
   "keywords": [
     "deepseek-harness",