@linxin666/dsh-usage 0.4.8 → 0.4.10

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   node scripts/verify-docs.mjs --write <dir>
-README.md: 09251404a6aa753795f71a9b378fa4df13cd0595
-README.zh.md: 1e71587e55dbb3285423af2ec69bad7b091e91c0
+README.md: 56545c0c2e7799499caa38f098d327663081e5bc
+README.zh.md: 7cf471e394a185355c98bb7f67b43fb3a4455e5c

package/README.md

@@ -5,7 +5,7 @@ English | [中文](README.zh.md)
 <p align="center">
   <img src="https://img.shields.io/npm/v/@linxin666/dsh-usage?style=flat-square" alt="Version">
   &nbsp;
-  <img src="https://img.shields.io/badge/DSH-%3E%3D0.2.1--rc.2-4c6ef5?style=flat-square&amp;labelColor=454a54" alt="DSH">
+  <img src="https://img.shields.io/badge/DSH-%3E%3D0.2.1--rc.3-4c6ef5?style=flat-square&amp;labelColor=454a54" alt="DSH">
   &nbsp;
   <img src="https://img.shields.io/badge/license-Apache--2.0-blue?style=flat-square" alt="License">
 </p>
@@ -23,7 +23,7 @@ The plugin runs a host-side service and a first-level settings section (使用
 
 - **Usage tab (用量)**: today's token totals per bucket (input / output / cache read / cache write, disjoint as the provider reports them) with per-provider and per-model breakdown, the last 30 days as a horizontal provider/model bar chart, and the balance of every configured provider (one row per adapter family: a dormant catalog alias shadowed by the family's live route no longer renders its own balance row). A **day picker** switches that card to any retained day that recorded usage (today first, then the other days newest first) and the card then shows that day's own totals, provider rows, and estimated spend; the peak/off-peak line stays on today because it describes the pricing window now. The ledger folds live `session/event` streams (`request/header` route attribution plus `assistant/message` usage) into `$DSH_HOME/dsh-usage/usage-ledger.json` with day-based retention, so past days survive restarts; counting starts when the plugin is first enabled. For the official DeepSeek family the tab also shows the current peak/off-peak pricing period (Beijing weekdays 09:00-12:00 and 14:00-18:00 are peak, billed at double) and today's estimated spend in CNY; that line is toned by the current clock — red while peak, green while off-peak — and always carries the word plus a dot, so colour is never the only signal.
 - **Plans tab (个人套餐)**: coding-plan quota windows for every configured provider that exposes one — used percent and reset time per window (Kimi For Coding 5h/week, GLM Coding Plan 5h/week/month, OpenCode Go rolling/weekly/monthly, MiniMax 5h/week, Codex / ChatGPT subscription 5h/week). Providers without a real plan or subscription (DeepSeek, ZenMux, Moonshot, OpenRouter, SiliconFlow) never appear on this tab; their balance shows on the usage tab instead.
-- **Token Bank tab (Token 银行)**: the whale-yuan voucher (鲸元券) minted from the official DeepSeek family's ledger at an anti-inflation exchange rate of 1,000,000 tokens per whale yuan. The tab sums the family's retained-ledger tokens (the `deepseek` catalog alias and the live `deepseek-official` route combined), stamps the minted face value onto the banknote artwork with a serial line carrying the minting window, and offers a save-image button plus a native share button when the browser supports sharing files. The spend line shows the real CNY total observed from the official balance once available — balance decreases accrue as spend, top-ups never count — and falls back to the fold-time estimate before the first observation. The minted total prefers the host's whole-ledger aggregate and falls back to the last 30 days on an older host; with no official DeepSeek usage the tab shows its empty state. A day picker mints the note from one picked day instead of the whole retention window (the observed-spend line, which accrues from the first balance reading, is whole-window only and falls back to that day's fold-time estimate on a single day). The on-note text is locale-neutral (digits, latin captions, ISO dates) and the export is rendered locally in the browser.
+- **Token Bank tab (Token 银行)**: the whale-yuan voucher (鲸元券) minted from every provider's ledger usage at an anti-inflation exchange rate of 1,000,000 tokens per whale yuan: the DeepSeek official family (the `deepseek` catalog alias, the live `deepseek-official` route and the signed-in `deepseek-account` route) counts its tokens and calls beside every subscription and relay route. The tab sums those retained-ledger totals, stamps the minted face value onto the banknote artwork with a serial line carrying the minting window, and offers a save-image button plus a native share button when the browser supports sharing files. The spend line stays official-family only: it shows the real CNY total observed from the official balance once available — balance decreases accrue as spend, top-ups never count — and falls back to the fold-time estimate before the first observation, because subscription and relay routes ship no price book. The minted total prefers the host's whole-ledger aggregate and falls back to the last 30 days on an older host; with no usage at all the tab shows its empty state. A day picker mints the note from one picked day instead of the whole retention window (the observed-spend line, which accrues from the first balance reading, is whole-window only and falls back to that day's fold-time estimate on a single day). The on-note text is locale-neutral (digits, latin captions, ISO dates) and the export is rendered locally in the browser.
 - **Sidebar foot card**: a compact glance seated above the sidebar's Settings row — today's estimated spend as the headline (today's tokens when nothing priced is recorded yet), the tokens/calls line, and up to two configured-provider balances with a +N overflow. The whole card is one button that opens the usage settings section, so detail stays in one place, and the corner chevron folds it into a one-line strip (the spending provider's name, the peak marker, the label, and the headline value), a choice persisted across reloads. When today's spend runs on the official DeepSeek route the card marks the pricing clock for the current date and hour (weekends and Chinese public holidays are off-peak for the whole day, so the red state only ever appears inside a weekday peak window): a red dot with 高峰 (peak) or a green dot with 空闲 (off-peak), plus a line naming when the current period ends or when peak returns in the expanded state; a card for any other provider never carries the marker. It polls at a relaxed 30 s cadence while the tab is visible, hides in the collapsed 56 px rail, and disappears while the plugin is disabled.
 - Probes run entirely host-side on a poll cycle (default 60 s, manual refresh button); API keys are resolved through the harness credential seam (`llm-pi-ai` records, `apiKeyEnv` references) and never reach the browser.
 
@@ -39,7 +39,7 @@ The published rule bills a Chinese public holiday entirely off-peak even on a Mo
 
 ## Install
 
-Requires DSH 0.2.1-rc.2 or later: the plugin is developed against the 0.2.1-rc.2 DSH cohort (its settings page is the Host-generated page of the plugin's own Config schema) and its `@deepseek-ai/*` runtime imports are provided by the host itself.
+Requires DSH 0.2.1-rc.3 or later: the plugin is developed against the 0.2.1-rc.3 DSH cohort (its settings page is the Host-generated page of the plugin's own Config schema) and its `@deepseek-ai/*` runtime imports are provided by the host itself.
 
 In your profile (e.g. `~/.dsh/profiles/web`):
 

package/README.zh.md

@@ -5,7 +5,7 @@
 <p align="center">
   <img src="https://img.shields.io/npm/v/@linxin666/dsh-usage?style=flat-square" alt="Version">
   &nbsp;
-  <img src="https://img.shields.io/badge/DSH-%3E%3D0.2.1--rc.2-4c6ef5?style=flat-square&amp;labelColor=454a54" alt="DSH">
+  <img src="https://img.shields.io/badge/DSH-%3E%3D0.2.1--rc.3-4c6ef5?style=flat-square&amp;labelColor=454a54" alt="DSH">
   &nbsp;
   <img src="https://img.shields.io/badge/license-Apache--2.0-blue?style=flat-square" alt="License">
 </p>
@@ -23,7 +23,7 @@
 
 - **用量页签**：今日 token 分桶合计（输入 / 输出 / 缓存读 / 缓存写，按 provider 上报口径互不相加），分 provider 与模型细分，近 30 天以「提供方-模型」水平条形图展示，以及所有已配置 provider 的余额（同一适配器家族只渲染一行：被该家族运行时路由遮蔽的休眠目录别名不再单独出余额行）。卡片顶部的**日期选择器**可切换到保留期内任何有记录的一天（今日在最前，其余按新到旧排列），此时卡片展示该日自己的合计、分 provider 行与消费估算；峰谷计价时段行只跟随今日，因为它描述的是当前时段的计价。对 DeepSeek 官方路由，页签还展示当前峰谷计价时段（北京时间工作日 09:00-12:00、14:00-18:00 为高峰，按双倍计费）与今日消费估算（CNY）；该时段行按当时钟点着色——高峰为红、空闲为绿，并始终带「高峰 / 空闲」文字与圆点，颜色不是唯一信号。台账从 `session/event` 实时流折叠（`request/header` 归因路由 + `assistant/message` 用量），持久化到 `$DSH_HOME/dsh-usage/usage-ledger.json`，按本地日保留，因此历史日重启后仍在；统计自插件首次启用起计。
 - **个人套餐页签**：每个已配置且暴露套餐端点的 provider 的配额窗口——已用百分比与重置时间（Kimi For Coding 5 小时/每周、GLM 编程计划 5 小时/每周/每月、OpenCode Go 滚动/每周/每月、MiniMax 5 小时/每周、Codex / ChatGPT 订阅 5 小时/每周）。没有真实套餐/订阅体系的厂商（DeepSeek、ZenMux、Moonshot、OpenRouter、SiliconFlow）不出现在此页签，其余额显示在用量页签。
-- **Token 银行页签**：以 DeepSeek 官方家族的台账用量铸造「鲸元券」，汇率按 100 万 tokens 兑 1 鲸元（防膨胀）。页签把该家族保留台账内的 token 总量（`deepseek` 目录别名与运行时路由 `deepseek-official` 合并计算）折算成票面面额印在钞票图上，附带走票窗口的序列号行，并提供保存图片按钮与（浏览器支持文件分享时的）系统分享按钮。消费行优先展示从官方余额观测到的真实累计花费——余额下降即计为消费，充值上涨不计——首次观测到下降之前回落为折叠时刻估算。铸造总量优先取宿主的全台账聚合，旧宿主回落为近 30 天；无官方用量时展示空状态。页签的日期选择器可把票券改为按某一天铸造（真实花费观测行是自首次余额观测起的累计值，只在整段窗口下展示，单日票券回落为该日的折叠时刻估算）。票面文字与语言无关（数字、拉丁小字、ISO 日期），导出图在浏览器本地渲染。
+- **Token 银行页签**：以台账里全部 provider 的用量铸造「鲸元券」，汇率按 100 万 tokens 兑 1 鲸元（防膨胀）：DeepSeek 官方家族（`deepseek` 目录别名、运行时路由 `deepseek-official`、登录账号使用的 `deepseek-account`）与订阅、中转路由一起计入 token 与调用次数。页签把这些保留台账内的 token 总量折算成票面面额印在钞票图上，附带走票窗口的序列号行，并提供保存图片按钮与（浏览器支持文件分享时的）系统分享按钮。消费行只统计官方家族：优先展示从官方余额观测到的真实累计花费——余额下降即计为消费，充值上涨不计——首次观测到下降之前回落为折叠时刻估算，订阅与中转路由没有价目表，永不计入消费。铸造总量优先取宿主的全台账聚合，旧宿主回落为近 30 天；台账没有任何用量时展示空状态。页签的日期选择器可把票券改为按某一天铸造（真实花费观测行是自首次余额观测起的累计值，只在整段窗口下展示，单日票券回落为该日的折叠时刻估算）。票面文字与语言无关（数字、拉丁小字、ISO 日期），导出图在浏览器本地渲染。
 - **侧栏底部速览卡**：位于侧栏「设置」行上方、与更新/远程触发器同组的紧凑卡片——头条为今日消费估算（今日尚无可计价用量时回落为 tokens 总量），下方是 tokens/调用次数行，以及最多两个已配置 provider 的余额（超出折叠为 +N）。整张卡片主体是一个按钮，点击打开使用统计设置分区，细节只保留在一处；右上角箭头可把卡片收成一行摘要条（消费提供方名称 + 峰谷标记 + 标签 + 头条值），选择跨刷新保持。今日消费走 DeepSeek 官方路由时，卡片按当前钟点与日期标出峰谷（周末与中国法定节假日全天算空闲，红色只出现在工作日的高峰窗口）：红色圆点加「高峰」、绿色圆点加「空闲」，展开态另有一行注明当前时段何时结束（高峰）或何时进入高峰（空闲）；其他 provider 的卡片不出现该标记。标签页可见时以 30 秒的宽松周期轮询，侧栏折叠为 56px 栏轨时隐藏，插件停用时消失。
 - 探测完全在宿主侧按轮询周期执行（默认 60 秒，可手动刷新）；API key 经宿主凭据缝解析（`llm-pi-ai` 记录、`apiKeyEnv` 引用），永不进入浏览器。
 
@@ -39,7 +39,7 @@
 
 ## 安装
 
-要求 DSH 0.2.1-rc.2 或更高：插件基于 0.2.1-rc.2 DSH cohort 开发（其设置页即宿主根据插件自身 Config schema 生成的页面），`@deepseek-ai/*` 运行时导入由宿主本体提供。
+要求 DSH 0.2.1-rc.3 或更高：插件基于 0.2.1-rc.3 DSH cohort 开发（其设置页即宿主根据插件自身 Config schema 生成的页面），`@deepseek-ai/*` 运行时导入由宿主本体提供。
 
 在 profile（如 `~/.dsh/profiles/web`）中：
 

package/lib/client.js

@@ -97,13 +97,15 @@ window.__ModuleLoader__.load({
 			"usage.config.title": "设置",
 			"usage.config.enabled": "启用插件",
 			"usage.config.pollIntervalSec": "轮询间隔（秒）",
+			"usage.config.spendCurrency": "消费显示货币",
+			"usage.config.cnyPerUsd": "汇率（1 美元兑人民币）",
 			"usage.config.saveFailed": "保存失败：设置未被接受。",
 			"usage.bank.title": "鲸元券",
-			"usage.bank.hint": "DeepSeek 官方 API 与 MiMo 每消耗 100 万 tokens 铸造 1 鲸元；保存或分享这张票券。",
-			"usage.bank.noUsage": "暂无 DeepSeek 官方 / MiMo 用量数据（统计自插件启用起）",
+			"usage.bank.hint": "所有模型每消耗 100 万 tokens 铸造 1 鲸元；保存或分享这张票券。",
+			"usage.bank.noUsage": "暂无用量数据",
 			"usage.bank.minted": "累计铸造 {minted} 鲸元（{tokens} tokens）",
-			"usage.bank.spend.observed": "官方余额实测花费 ¥{cost}（自 {since} 起）",
-			"usage.bank.spend.estimated": "消费估算：约 ¥{cost}",
+			"usage.bank.spend.observed": "官方余额实测花费 {cost}（自 {since} 起）",
+			"usage.bank.spend.estimated": "消费估算：约 {cost}",
 			"usage.bank.window": "统计窗口 {from} ~ {to}",
 			"usage.bank.windowAll": "全部保留期",
 			"usage.bank.save": "保存图片",
@@ -167,13 +169,15 @@ window.__ModuleLoader__.load({
 			"usage.config.title": "Settings",
 			"usage.config.enabled": "Enable plugin",
 			"usage.config.pollIntervalSec": "Poll interval (seconds)",
+			"usage.config.spendCurrency": "Spend display currency",
+			"usage.config.cnyPerUsd": "Exchange rate (CNY per USD)",
 			"usage.config.saveFailed": "Save failed: the deployment did not accept the setting.",
 			"usage.bank.title": "Whale-yuan voucher",
-			"usage.bank.hint": "Every 1,000,000 tokens spent on the DeepSeek official API or on MiMo mint one whale yuan; save or share the note.",
-			"usage.bank.noUsage": "No DeepSeek official or MiMo usage yet (counting starts when the plugin is enabled)",
+			"usage.bank.hint": "Every 1,000,000 tokens spent across all models mint one whale yuan; save or share the note.",
+			"usage.bank.noUsage": "No usage data yet",
 			"usage.bank.minted": "Minted {minted} whale yuan ({tokens} tokens)",
-			"usage.bank.spend.observed": "Spent ¥{cost} observed on the official balance (watching since {since})",
-			"usage.bank.spend.estimated": "Estimated spend: about ¥{cost}",
+			"usage.bank.spend.observed": "Spent {cost} observed on the official balance (watching since {since})",
+			"usage.bank.spend.estimated": "Estimated spend: about {cost}",
 			"usage.bank.window": "Window {from} - {to}",
 			"usage.bank.windowAll": "All retained days",
 			"usage.bank.save": "Save image",
@@ -1096,7 +1100,7 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region src/client/voucher.ts
 		/**
-		* The Whale-yuan voucher (鲸元券): the mint family's retained ledger totals
+		* The Whale-yuan voucher (鲸元券): the profile's retained ledger totals
 		* stamped onto the banknote artwork as a denomination, ready
 		* to save or share. The canvas copy is deliberately locale-neutral (digits,
 		* latin captions, ISO dates) so the exported image needs no dictionary;
@@ -1119,30 +1123,23 @@ window.__ModuleLoader__.load({
 			return `${date.getFullYear()}-${month}-${day}`;
 		}
 		/**
-		* Provider route ids minted beside the DeepSeek official family: the MiMo
-		* gateway, which a profile may run as its default route and which the ledger
-		* records under its own route id. The bank counts the tokens a profile spends,
-		* not only the ones DeepSeek bills. Route ids rather than adapter families
-		* because minting is an accounting decision that must never widen the
-		* credential or probing paths — the same split `isDeepSeekProviderRoute()`
-		* keeps against `adapterFor()` (issue #1772). An empty list mints exactly the
-		* official family, which is how a profile that never runs MiMo behaves.
-		*/
-		const EXTRA_MINT_ROUTE_IDS = ["mimo"];
-		/** Whether one provider route's ledger rows mint whale yuan. */
-		function mintsWhaleYuan(provider) {
-			return isDeepSeekProviderRoute(provider) || EXTRA_MINT_ROUTE_IDS.includes(provider);
-		}
-		/**
-		* Sum the mint family's rows out of a usage window: the whole DeepSeek
-		* official family (the `deepseek` catalog alias, the live `deepseek-official`
-		* route and the signed-in `deepseek-account` route all fold into one voucher)
-		* plus {@link EXTRA_MINT_ROUTE_IDS}. Undefined when the window is absent
-		* (older host) or the family has no usage — a zero-token note mints nothing.
+		* Sum every provider's rows out of a usage window: the note is a
+		* proof-of-spend for what the profile actually used, so the tokens and calls
+		* of every route in the ledger mint — the DeepSeek official family (the
+		* `deepseek` catalog alias, the live `deepseek-official` route and the
+		* signed-in `deepseek-account` route) beside every subscription and relay
+		* route. Undefined when the window is absent (older host) or nothing was used
+		* — a zero-token note mints nothing.
+		*
+		* Minting is an accounting decision over ledger rows, so it reads no adapter:
+		* widening it must never widen the credential or balance-probe paths, which
+		* keep reading `adapterFor()` (the split `isDeepSeekProviderRoute()` also
+		* keeps, issue #1772).
 		*
-		* Only the priced family contributes `cost`: MiMo ships no price book, so it
-		* mints tokens and calls while the spend line keeps reporting the official
-		* family's fold-time estimate (and the observed-balance watch above it).
+		* Only the priced family contributes `cost`: subscription and relay routes
+		* ship no price book, so they mint tokens and calls while the spend line keeps
+		* reporting the official family's fold-time estimate (and the observed-balance
+		* watch above it).
 		*/
 		function voucherData(window) {
 			if (window === void 0) return void 0;
@@ -1150,7 +1147,6 @@ window.__ModuleLoader__.load({
 			let calls = 0;
 			let cost = 0;
 			for (const row of window.providers) {
-				if (!mintsWhaleYuan(row.provider)) continue;
 				tokens += totalTokens(row.totals);
 				calls += row.totals.calls;
 				if (isDeepSeekProviderRoute(row.provider)) cost += row.totals.cost;
@@ -1229,11 +1225,38 @@ window.__ModuleLoader__.load({
 			ctx.fillText(`NO.${voucherSerial(face)} ${data.from} - ${data.to}`, centerX, Math.round(art.height * .845));
 		}
 		//#endregion
+		//#region src/core/spend.ts
+		/**
+		* The rate used when the row configures none: a plain default, so an
+		* unconfigured display still has a defined美元 figure instead of a blank card.
+		* The plugin never fetches a live rate (its host routes are loopback-fenced and
+		* its browser half has no network), so there is no fetch that could fail and
+		* leave the card empty.
+		*/
+		const DEFAULT_CNY_PER_USD = 7.2;
+		/** The display used when the row carries no setting: the historical CNY rendering. */
+		const DEFAULT_SPEND_DISPLAY = {
+			currency: "CNY",
+			cnyPerUsd: DEFAULT_CNY_PER_USD
+		};
+		/**
+		* Render one stored CNY cost in the display currency.
+		* A non-finite or negative cost renders as zero rather than as `NaN`/`¥-0.10`.
+		* @param costCny - the stored cost in CNY.
+		* @param display - the display to render in; defaults to CNY.
+		* @returns the formatted amount with its currency symbol.
+		*/
+		function formatSpend(costCny, display = DEFAULT_SPEND_DISPLAY) {
+			const safe = Number.isFinite(costCny) && costCny > 0 ? costCny : 0;
+			if (display.currency === "USD") return "$" + (safe / (Number.isFinite(display.cnyPerUsd) && display.cnyPerUsd > 0 ? display.cnyPerUsd : DEFAULT_CNY_PER_USD)).toFixed(2);
+			return "¥" + safe.toFixed(2);
+		}
+		//#endregion
 		//#region src/client/UsageSectionCard.tsx
 		/**
 		* The usage statistics settings section: three tabs (用量: today's usage,
 		* balances, trend; 个人套餐: per-provider plan quota windows; Token 银行:
-		* the whale-yuan voucher minted from the DeepSeek official family's usage)
+		* the whale-yuan voucher minted from every provider's ledger usage)
 		* plus a compact settings row. Data comes from the host's loopback-fenced
 		* /api/dsh-usage/overview document; polling runs only while the section is
 		* mounted and the tab is visible.
@@ -1264,10 +1287,6 @@ window.__ModuleLoader__.load({
 				return "";
 			}
 		}
-		/** Formatted CNY spend estimate (the only priced currency today). */
-		function formatCost(cost) {
-			return "¥" + cost.toFixed(2);
-		}
 		function toneClass(percent) {
 			if (percent >= 90) return usage_module_css_default.barLow;
 			if (percent >= 70) return usage_module_css_default.barWarn;
@@ -1636,7 +1655,7 @@ window.__ModuleLoader__.load({
 										children: isToday ? t("usage.today.cost") : t("usage.day.cost")
 									}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 										className: usage_module_css_default.providerTokens,
-										children: formatCost(day?.totals.cost ?? 0)
+										children: formatSpend(day?.totals.cost ?? 0, snapshot.display)
 									})]
 								}),
 								(day?.providers.length ?? 0) > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
@@ -1655,7 +1674,7 @@ window.__ModuleLoader__.load({
 												formatTokens(row.totals.inputTokens + row.totals.cacheReadTokens + row.totals.cacheWriteTokens + row.totals.outputTokens),
 												" · ",
 												t("usage.calls", { n: row.totals.calls }),
-												row.totals.cost > 0 ? ` · ${formatCost(row.totals.cost)}` : ""
+												row.totals.cost > 0 ? ` · ${formatSpend(row.totals.cost, snapshot.display)}` : ""
 											]
 										})]
 									}, row.provider))
@@ -1725,6 +1744,7 @@ window.__ModuleLoader__.load({
 						window: bankWindow,
 						observedSpend: bankSelection === void 0 ? snapshot.usage.observedSpend : void 0,
 						loading: bankSelection !== void 0 && bankDayLoad?.status === "loading",
+						display: snapshot.display,
 						...bankDayLoad?.status === "error" ? { error: bankDayLoad.error ?? "" } : {}
 					})] })
 				]
@@ -1830,17 +1850,17 @@ window.__ModuleLoader__.load({
 			return totals.inputTokens + totals.cacheReadTokens + totals.cacheWriteTokens + totals.outputTokens;
 		}
 		/**
-		* The Token 银行 card: the mint family's (DeepSeek official + MiMo)
-		* retained-ledger usage minted onto the whale-yuan note at 1,000,000 tokens
-		* per whale yuan. The window is the whole retained ledger by default (the
-		* host's aggregate, falling back to the 30-day trend when an older host serves
-		* no `all`) or the single day the user picked; the spend line prefers the
-		* official balance watch (whole window only) and falls back to the fold-time
-		* estimate, which only the priced family feeds; the artwork draw failure
-		* degrades to an error line and never takes the section down.
+		* The Token 银行 card: every provider's retained-ledger usage minted onto the
+		* whale-yuan note at 1,000,000 tokens per whale yuan. The window is the whole
+		* retained ledger by default (the host's aggregate, falling back to the 30-day
+		* trend when an older host serves no `all`) or the single day the user picked;
+		* the spend line prefers the official balance watch (whole window only) and
+		* falls back to the fold-time estimate, which only the priced family feeds;
+		* the artwork draw failure degrades to an error line and never takes the
+		* section down.
 		*/
 		function VoucherCard(props) {
-			const { window: ledger, observedSpend, loading, error } = props;
+			const { window: ledger, observedSpend, loading, error, display } = props;
 			const data = voucherData(ledger);
 			const canvasRef = (0, react.useRef)(null);
 			const [drawError, setDrawError] = (0, react.useState)(void 0);
@@ -1940,9 +1960,9 @@ window.__ModuleLoader__.load({
 					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 						className: usage_module_css_default.muted,
 						children: observedSpend !== void 0 ? t("usage.bank.spend.observed", {
-							cost: observedSpend.cny.toFixed(2),
+							cost: formatSpend(observedSpend.cny, display),
 							since: formatDay(observedSpend.since)
-						}) : t("usage.bank.spend.estimated", { cost: data.cost.toFixed(2) })
+						}) : t("usage.bank.spend.estimated", { cost: formatSpend(data.cost, display) })
 					}),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 						className: usage_module_css_default.muted,
@@ -2060,30 +2080,65 @@ window.__ModuleLoader__.load({
 					}),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 						className: usage_module_css_default.settingsGrid,
-						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
-							className: usage_module_css_default.settingItem,
-							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
-								type: "checkbox",
-								checked: value.enabled ?? true,
-								disabled,
-								onChange: (event) => {
-									write("enabled", event.target.checked);
-								}
-							}), t("usage.config.enabled")]
-						}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
-							className: usage_module_css_default.settingItem,
-							children: [t("usage.config.pollIntervalSec"), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
-								type: "number",
-								min: 30,
-								max: 3600,
-								value: typeof value.pollIntervalSec === "number" ? value.pollIntervalSec : 60,
-								disabled,
-								onChange: (event) => {
-									const parsed = Number(event.target.value);
-									if (Number.isFinite(parsed) && parsed >= 30 && parsed <= 3600) write("pollIntervalSec", Math.round(parsed));
-								}
-							})]
-						})]
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
+								className: usage_module_css_default.settingItem,
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+									type: "checkbox",
+									checked: value.enabled ?? true,
+									disabled,
+									onChange: (event) => {
+										write("enabled", event.target.checked);
+									}
+								}), t("usage.config.enabled")]
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
+								className: usage_module_css_default.settingItem,
+								children: [t("usage.config.pollIntervalSec"), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+									type: "number",
+									min: 30,
+									max: 3600,
+									value: typeof value.pollIntervalSec === "number" ? value.pollIntervalSec : 60,
+									disabled,
+									onChange: (event) => {
+										const parsed = Number(event.target.value);
+										if (Number.isFinite(parsed) && parsed >= 30 && parsed <= 3600) write("pollIntervalSec", Math.round(parsed));
+									}
+								})]
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
+								className: usage_module_css_default.settingItem,
+								children: [t("usage.config.spendCurrency"), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("select", {
+									value: value.spendCurrency === "USD" ? "USD" : "CNY",
+									disabled,
+									onChange: (event) => {
+										write("spendCurrency", event.target.value === "USD" ? "USD" : "CNY");
+									},
+									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+										value: "CNY",
+										children: "CNY"
+									}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+										value: "USD",
+										children: "USD"
+									})]
+								})]
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
+								className: usage_module_css_default.settingItem,
+								children: [t("usage.config.cnyPerUsd"), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+									type: "number",
+									min: .01,
+									max: 1e3,
+									step: .01,
+									value: typeof value.cnyPerUsd === "number" ? value.cnyPerUsd : 7.2,
+									disabled,
+									onChange: (event) => {
+										const parsed = Number(event.target.value);
+										if (Number.isFinite(parsed) && parsed >= .01 && parsed <= 1e3) write("cnyPerUsd", Math.round(parsed * 100) / 100);
+									}
+								})]
+							})
+						]
 					}),
 					failure !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
 						className: usage_module_css_default.errorLine,
@@ -2317,7 +2372,7 @@ window.__ModuleLoader__.load({
 			const totals = snapshot.usage.today.totals;
 			if (totals.cost > 0) return {
 				label: t("usage.foot.cost"),
-				value: "¥" + totals.cost.toFixed(2),
+				value: formatSpend(totals.cost, snapshot.display),
 				tokenFallback: false,
 				provider: spendProvider(snapshot)
 			};
@@ -2328,7 +2383,7 @@ window.__ModuleLoader__.load({
 			};
 			return {
 				label: t("usage.foot.cost"),
-				value: "¥0.00",
+				value: formatSpend(0, snapshot.display),
 				tokenFallback: false
 			};
 		}
@@ -2528,45 +2583,130 @@ window.__ModuleLoader__.load({
 				}), toggle]
 			});
 		}
+		/** The shell slot whose occupant is the settings shell (and carries its store). */
+		const SETTINGS_SEAT_SLOT = "sidebar.settings";
+		/** The shell sidebar column, which also scopes the settings seat. */
+		const SIDEBAR_SELECTOR = "[data-pane=\"sidebar\"], [class*=\"sidebarCol\"]";
+		/** The shell's settings row: the launcher seat plus the Settings trigger fallback. */
+		const SETTINGS_AREA_SELECTOR = "[class*=\"settingsArea\"]";
+		/** A launcher that opens the settings dialog by itself (the shell's own gear). */
+		const DIALOG_TRIGGER_SELECTOR = "button[aria-haspopup=\"dialog\"]";
+		/** A launcher that opens a menu whose settings item opens the dialog (the account row). */
+		const MENU_ITEM_SELECTOR = "[role=\"menu\"] button[role=\"menuitem\"]";
+		/** One shell frame of the replay poll: menus and the panel mount a frame later. */
+		const REPLAY_STEP_MS = 50;
+		/** Replay poll budget in steps (about one second of shell frames). */
+		const REPLAY_STEPS = 20;
+		/** The shell sidebar column, when the shell has mounted one. */
+		function sidebarColumn() {
+			return document.querySelector(SIDEBAR_SELECTOR) ?? void 0;
+		}
 		/** The shell sidebar's foot area (footer actions + the Settings row), when mounted. */
 		function footArea() {
-			return document.querySelector("[data-pane=\"sidebar\"], [class*=\"sidebarCol\"]")?.querySelector("[class*=\"footArea\"]") ?? void 0;
+			return sidebarColumn()?.querySelector("[class*=\"footArea\"]") ?? void 0;
 		}
 		/**
-		* Open the settings panel on the usage section. The shell owns the panel's
-		* open state and exposes no service for it, so the card replays the user's
-		* own path: activate the sidebar Settings trigger, then pick the nav row
-		* carrying the section's (localized) label. Every step degrades silently —
-		* with the panel already open only the nav pick runs, and a missing row
-		* leaves the panel on its default section.
-		* @param label - the usage section's nav label in the active locale.
+		* Resolve the settings shell's store handle from the `sidebar.settings` seat.
+		*
+		* The seat is a single-occupant slot and the shell's own registration carries
+		* the store that owns the panel's open state and active section, so reading it
+		* is the one step that opens the panel without touching the DOM. A shell that
+		* exposes no seat, a seat without a store, or a registry answering mid-teardown
+		* all yield undefined, and the caller replays the DOM path instead.
+		* @param slots - the renderer-owned slot registry.
+		* @returns the store handle, or undefined when the seat carries none.
 		*/
-		function openUsageSettings(label) {
-			/** Click the nav row carrying the usage label inside the open panel. */
-			const pick = (panel) => {
-				const wanted = label();
-				for (const row of panel.querySelectorAll("nav button")) if (row.textContent !== null && row.textContent.includes(wanted)) {
-					row.click();
-					return;
-				}
-			};
+		function settingsShellStore(slots) {
+			let seat;
+			try {
+				seat = slots?.entries(SETTINGS_SEAT_SLOT)[0]?.store;
+			} catch {
+				return;
+			}
+			if (seat === void 0 || seat === null) return void 0;
+			return typeof seat.create === "function" ? seat : void 0;
+		}
+		/**
+		* Drive the shell's settings store onto the usage section.
+		* @param store - the seat's store handle.
+		* @param id - the section's slot registration id.
+		* @returns true when the store accepted the call, false when it threw.
+		*/
+		function openThroughStore(store, id) {
+			try {
+				store.create().actions.openSection(id);
+				return true;
+			} catch {
+				return false;
+			}
+		}
+		/**
+		* Click the nav row carrying the section's label inside the open panel.
+		* @param panel - the open settings dialog.
+		* @param label - the section's nav label in the active locale.
+		*/
+		function pickSectionRow(panel, label) {
+			const wanted = label();
+			for (const row of panel.querySelectorAll("nav button")) if (row.textContent !== null && row.textContent.includes(wanted)) {
+				row.click();
+				return;
+			}
+		}
+		/**
+		* Poll the page over the shell's next frames until a lookup yields a value.
+		* @param find - the lookup, run once per step.
+		* @param steps - remaining frame budget.
+		* @returns the first value found, or undefined once the budget is spent.
+		*/
+		function until(find, steps = REPLAY_STEPS) {
+			const found = find();
+			if (found !== void 0 && found !== null) return Promise.resolve(found);
+			if (steps <= 0) return Promise.resolve(void 0);
+			return new Promise((resolve) => {
+				window.setTimeout(resolve, REPLAY_STEP_MS);
+			}).then(() => until(find, steps - 1));
+		}
+		/**
+		* Replay the user's own settings path, one shell frame at a time.
+		* @param launcher - the settings seat's trigger.
+		* @param label - the section's nav label in the active locale.
+		*/
+		async function replay(launcher, label) {
+			launcher.click();
+			if (launcher.getAttribute("aria-haspopup") === "menu") {
+				const item = await until(() => document.querySelector(MENU_ITEM_SELECTOR));
+				if (item === void 0) return;
+				item.click();
+			}
+			const panel = await until(() => document.querySelector("[role=\"dialog\"]"));
+			if (panel !== void 0) pickSectionRow(panel, label);
+		}
+		/**
+		* Open the settings panel on the usage section.
+		*
+		* The seat's store is the primary path: `openSection` opens the dialog on the
+		* usage row in one call, with no dependence on which plugin occupies the
+		* `settings.launcher` seat — an account row there turns a trigger click into a
+		* menu, which is how this click used to land on the account menu instead of the
+		* panel. Without such a store the card replays the user's own path: activate
+		* the launcher (preferring the dialog trigger over a menu trigger), follow a
+		* menu launcher's first settings item, then pick the nav row carrying the
+		* section's label. Every step degrades silently — a missing surface leaves the
+		* page untouched, and with the panel already open only the nav pick runs.
+		* @param target - the section id, its localized label, and the seat's store.
+		*/
+		function openUsageSettings(target) {
+			const { id, label, store } = target;
+			if (store !== void 0 && openThroughStore(store, id)) return;
 			const open = document.querySelector("[role=\"dialog\"]");
 			if (open !== null) {
-				pick(open);
+				pickSectionRow(open, label);
 				return;
 			}
-			(document.querySelector("[data-pane=\"sidebar\"], [class*=\"sidebarCol\"]")?.querySelector("[class*=\"settingsArea\"] button"))?.click();
-			let tries = 0;
-			const attempt = () => {
-				const panel = document.querySelector("[role=\"dialog\"]");
-				if (panel !== null) {
-					pick(panel);
-					return;
-				}
-				tries += 1;
-				if (tries <= 20) window.setTimeout(attempt, 50);
-			};
-			window.setTimeout(attempt, 0);
+			const area = sidebarColumn()?.querySelector(SETTINGS_AREA_SELECTOR);
+			const launcher = area?.querySelector(DIALOG_TRIGGER_SELECTOR) ?? area?.querySelector("button");
+			if (launcher === void 0 || launcher === null) return;
+			replay(launcher, label);
 		}
 		/**
 		* Mount the sidebar foot card directly above the Settings row.
@@ -2583,7 +2723,7 @@ window.__ModuleLoader__.load({
 			const place = () => {
 				const foot = footArea();
 				if (foot === void 0) return;
-				const settings = foot.querySelector("[class*=\"settingsArea\"]");
+				const settings = foot.querySelector(SETTINGS_AREA_SELECTOR);
 				if (settings !== null) {
 					if (container.nextElementSibling !== settings) foot.insertBefore(container, settings);
 					return;
@@ -2717,6 +2857,8 @@ window.__ModuleLoader__.load({
 		];
 		/** First-level nav position: directly below the Workshop section (order 150). */
 		const SECTION_ORDER = 151;
+		/** The section's nav row id — what the shell's store selects when the card opens. */
+		const USAGE_SECTION_ID = "dsh-usage";
 		/** Required services. */
 		const inject = [
 			"slots",
@@ -2784,7 +2926,11 @@ window.__ModuleLoader__.load({
 				poll,
 				settings: settingsForm,
 				onOpen: () => {
-					openUsageSettings(() => t("usage.title"));
+					openUsageSettings({
+						id: USAGE_SECTION_ID,
+						label: () => t("usage.title"),
+						store: settingsShellStore(ctx.slots)
+					});
 				},
 				locale: ctx.locale
 			});
@@ -2797,7 +2943,7 @@ window.__ModuleLoader__.load({
 				try {
 					const unregister = ctx.slots.register({
 						name: "settings.section",
-						id: "dsh-usage",
+						id: USAGE_SECTION_ID,
 						order: SECTION_ORDER,
 						label: () => ctx.locale.bind(NS)("usage.title"),
 						locale: NS,