dsh-consumption-badge 1.2.1 → 1.3.1

package/README.md

@@ -2,61 +2,74 @@
 
 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.
 
 ```
-⛽ 25.6k | ≈¥0.020 | valley
+⛽ 3.2k | ≈¥0.004 | Off-peak | Balance = ¥42.50
 ```
 
-- **Collapsed pill** – session-cumulative tokens, estimated cost (always prefixed `≈`), and the
-  current peak/valley tier (red `peak`, green `valley`), 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**
   (left axis: tokens, right axis: ¥) with a hover tooltip showing the model,
-  input-hit / input-miss / output tokens, and the turn's peak/valley flag.
-- **Settings page · 消耗** (`settings.section`, id `balance-dsh-consumption`, order 26):
-  a top row of four cards — **累计 Token** (with hit/miss/output split, all-history totals),
-  **估算金额**, **当前时段** (peak/idle) and **账户余额** (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
-  (全部工作区 + every registered workspace + 未归属工作区), and by an explicit
+  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/valley split and the models involved; the footer sums the current
-  selection. No data in range → a plain “该范围内暂无消耗记录” note instead of an empty chart.
-  The cards are **all-history** totals (independent of the filters); the footer is the
+  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 **消耗弹窗** block is appended to its settings page —
+  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:
-  **默认 / 毛玻璃 / 自定义背景 / 纯色**.
-  - **默认** keeps the themed surface; **毛玻璃** 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;
-    **自定义背景** takes an image URL *or* a local image plus an **不透明度** 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; **纯色** 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 **毛玻璃** switch appears for 自定义背景 and 纯色, so glass composites with them:
+  **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 **毛玻璃强度** slider (0–48 px, default 22 px) sets the
-    blur radius for both the panel and the veil behind it.
-  - **清除** wipes the image, the URL field and the file picker in one go. The image row shows a
-    **thumbnail** plus the live save state
-    (正在保存 / 已保存到本机 / `error: …`), and failures are logged with a
-    `[consumption-badge]` tag instead of failing silently. The picker is a button
-    (“选择图片… / 更换图片…”), not a raw file input, so saving never leaves a misleading
-    “未选择文件” label behind.
+    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; **清除** deletes the stored record as well.
+    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.
@@ -65,11 +78,135 @@ next to every assistant message, and opens a detail panel with the session's spe
   (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: **复制更新命令**, **忽略此版本** (remembered on this machine) and
-  **稍后提醒** (this page load only). It never blocks the conversation and never covers controls.
+  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.
 
+## 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,
+no second settings page.
+
+| Aspect | How it works |
+| --- | --- |
+| Source of truth | The client-side `locale` service (`@deepseek-ai/dsh-client-locale`, `ctx.get('locale')`) |
+| Dictionary | `DICT_EN` in `lib/client.js`, keyed by the **Chinese copy itself**; under `zh` no dictionary is needed because the key is the text, and any key missing from `DICT_EN` falls back to that Chinese text (never a blank string) |
+| Live switching | Slot outlets re-render on a locale switch (the shell subscribes to the locale revision), so `tt()` picks up the new language during the next render; the personalization page block renders in its own React root and subscribes to the locale face itself |
+| Slot labels | The action-row label and the settings tab title are **thunks**, resolved by the slot system at read time, so the tab renames itself on a switch |
+| Late service | If the `locale` service is provided after this plugin's `apply()` ran (boot order differs per composition), the first render retries the bind |
+| Missing service | Without the locale service everything falls back to Chinese — the plugin still works standalone |
+| Host errors | `lib/index.js` never returns localized prose: failures carry a language-neutral `code` + `detail` (and an English `error` for logs). The client maps `code` → copy in the active language, and prints the host's `error` only for an unknown code |
+
+Adding a language means adding one dictionary next to `DICT_EN`; the lookup order is
+*active locale → key*, so untranslated keys degrade to Chinese rather than breaking.
+
 ## Requirements
 
 | Capability | Why |
@@ -125,7 +262,7 @@ deployments where the bundle layer does mount. Keep only **one** of the two acti
 | Data | Source |
 | --- | --- |
 | Per-turn tokens | `assistant/message.usage` events in the session log, folded per turn (`cacheReadTokens` → hit, `inputTokens + cacheWriteTokens` → miss, `outputTokens` → output; multi-step turns are summed) |
-| Turn timing | `turn/start` event time (peak/valley is attributed to **request start**) |
+| Turn timing | `turn/start` event time (peak/off-peak is attributed to **request start**) |
 | Model per turn | `request/context` / `request/header.config`; falls back to the agent default model, then `deepseek-flash` |
 | Session totals | the shipped `tokenUsage` projection when present, otherwise the folded turns |
 | Balance | `GET https://api.deepseek.com/user/balance` via curl, 60s cache |
@@ -137,7 +274,7 @@ scheduled off the render path (`requestIdleCallback`), and the aggregation is O(
 The settings page reads **those same records** (no second store, no new field): workspace
 attribution is resolved at read time from DSH's own accounting ledger
 (`WorkspaceView.sessionIds` from `useWorkspaces`), so historical records are attributed without
-any backfill. Records whose session no longer exists land in the 未归属工作区 bucket.
+any backfill. Records whose session no longer exists land in the **Unassigned** bucket.
 Above 5000 records the aggregation runs in a Web Worker (built from the pure aggregator's own
 source, so both paths are the same code); if the browser refuses the Worker it silently falls
 back to the main thread, where 6000 records aggregate in ~6 ms.
@@ -156,7 +293,7 @@ cost = (hit/1e6)*hit_price + (miss/1e6)*miss_price + (out/1e6)*out_price   [×2
 ```
 
 **Peak** = Beijing time (UTC+8), Monday–Friday, 09:00–12:00 and 14:00–18:00, excluding statutory
-holidays. Everything else, plus weekends, is **valley**.
+holidays. Everything else, plus weekends, is **off-peak**.
 
 Unrecognised model ids are priced as `deepseek-flash` (or `deepseek-v4-pro` when the id contains
 `pro`) and the UI marks the figure as an estimate. The table lives in `PRICES` at the top of
@@ -172,9 +309,15 @@ 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/balance[?force=1]` | `{ok, available, currency, total, granted, toppedUp}`; `is_available:false` renders a red “insufficient balance” |
+| `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
+(`no-credentials`, `no-key`, `key-read-failed`, `no-subprocess`, `curl-empty`, `spawn-failed`,
+`bad-response`, `balance-request-failed`, `missing-session-id`, `log-unavailable`), `detail` is raw
+text, `error` is an English fallback for logs.
 
 These routes are **unauthenticated**. If your DSH web server binds `0.0.0.0`, anyone on the
 network can read the balance and token figures; keep it on `127.0.0.1` unless you need otherwise.
@@ -198,18 +341,20 @@ 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|valley` 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. Open Settings → 消耗: confirm the history chart renders, then
-   switch the time range (今天 / 近一周 / 近一月 / 近一年), switch the workspace
-   (全部工作区 → a specific workspace → 未归属工作区), set the calendar range and confirm both
-   the chart and the footer totals update, and that the Token axis only appears after clicking
-   its legend chip.
-7. If `dsh-plugin-personalization` is installed, open Settings → 个性化 and confirm a 消耗弹窗
-   block appears at the bottom; switch it to 毛玻璃 / 纯色 / 自定义背景 and confirm the ⛽ modal
-   (click a badge) re-renders with that background.
-8. Report which step failed and paste the boot log lines that mention `consumption-badge`.
+6. Keep Settings → Usage open, then switch the shell language between Chinese and English
+   (Settings → General → Language) and confirm every visible string in the badge, the modal, the
+   settings page and the personalization block switches without a reload.
+7. On the Usage page switch the time range (Today / Last 7 days / Last 30 days / Last 12 months),
+   switch the workspace (All workspaces → a specific workspace → Unassigned), set the calendar range
+   and confirm both the chart and the footer totals update, and that the Token axis only appears
+   after clicking its legend chip.
+8. If `dsh-plugin-personalization` is installed, open Settings → Personalization and confirm a
+   Usage popup block appears at the bottom; switch it to Glass / Solid color / Custom image and
+   confirm the ⛽ modal (click a badge) re-renders with that background.
+9. Report which step failed and paste the boot log lines that mention `consumption-badge`.
 
 Rules while doing this: never write to the DSH credentials file yourself (ask me for
 DEEPSEEK_API_KEY), never bind a second server to the same port, and do not try to persist the
@@ -226,12 +371,16 @@ plugin by "running" it — a session-scoped dynamic plugin always dies with the
   `require("react")` — React must stay external (a second React instance breaks slot rendering).
 - `lib/index.js` imports nothing at all (no `@deepseek-ai/cordis`), so it does not depend on the
   profile being able to resolve Cordis; it exports plain `name` / `inject` / `apply`.
-- Self-check without booting DSH: `node check.mjs` (46 assertions over the route contract and the
-  client bundle contract). It lives outside the published `files` list.
+- 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` (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.
 
 ## Known limitations
 
-- All amounts are **estimates** — price table, peak/valley rules and model detection can drift
+- All amounts are **estimates** — price table, peak/off-peak rules and model detection can drift
   from your actual invoice.
 - One chart point per turn; multiple steps in a turn are summed.
 - Balance parsing depends on DeepSeek's `/user/balance` response shape; failures only affect the
@@ -239,6 +388,7 @@ plugin by "running" it — a session-scoped dynamic plugin always dies with the
 - The chart covers turns present in the session log fold (whole log), while the pill's total uses
   the shipped `tokenUsage` projection — both are whole-session, but a heavily-compacted session may
   differ by the tokens lost to compaction.
+- Only `zh` and `en` are shipped; any other shell locale falls back to `zh` (the dictionary keys).
 
 ## License