dsh-tokenlens 1.2.0 → 1.2.1

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 本项目遵循 [Semantic Versioning](https://semver.org/)：修复 = PATCH，新功能 = MINOR，不兼容变更 = MAJOR。发布时同步更新 `package.json` 的 `version`、`index.js` 的 `PLUGIN_VERSION` 与本文件（`node scripts/bump-version.mjs <version> "<note>"`）；已发布的条目保持原样。
 
+## 1.2.1 — 2026-10-31
+
+- feat(settings): 图表模式「明细」环形图的窗口选择（今日 / 最近7天 / 最近X天（或最近30天）/ 总计）持久化到插件设置：点击 pill 立即保存，重开弹窗、切换供应商或重启 DSH 后仍保留上次选择；当前供应商没有该窗口时自动回落到总计
+- feat(wire): `providers` 载荷与 `settingsUpdate` 增加 `settings.detailsWindow`（`today|last7Days|second|total`），旧 Host 会忽略未知字段、旧 client 读取时回落 `total`，双向兼容
+- 修复：请求进行中连续点击窗口时只保留最后一个选择（单定时器 200ms 重试）；「恢复默认设置」同时把窗口重置为总计
+- 测试：255 个自动化用例（新增 5 个持久化回归，更新 8 个既有设置/窗口用例）
+
 ## 1.2.0 — 2026-10-31
 
 - feat(chart): 图表模式点击某一天的柱子可下钻查看**当天 24 小时**的 Token 消耗棒状图（横轴 00:00–23:00，悬浮显示小时与占比，回车/空格同样可操作，返回或再次点击回到日趋势）

package/PROTOCOL.md

@@ -318,7 +318,7 @@ needs no provider catalog of its own.
 
 The dialog 「供应商管理」 page talks to three additional actions:
 
-- `{action:"providers"}` → `{ok:true, providers:[{providerId,label,shortLabel,kind,enabled,hasKey,keySource,apiKeyRef,baseURL,consoleUrl,builtin,dshManaged,dshProviderId}], dshProviders:[{providerId,label,supported,usageProviderId}], settings:{labelStyle:"short"|"full"}, storeFile, storeFileDisplay}`. `storeFile` is the real path (local tooling); `storeFileDisplay` replaces the user's home directory with `~` and is what the management page renders.
+- `{action:"providers"}` → `{ok:true, providers:[{providerId,label,shortLabel,kind,enabled,hasKey,keySource,apiKeyRef,baseURL,consoleUrl,builtin,dshManaged,dshProviderId}], dshProviders:[{providerId,label,supported,usageProviderId}], settings:{labelStyle,defaultView,defaultScope,detailsExpanded,detailsWindow}, storeFile, storeFileDisplay}`. `storeFile` is the real path (local tooling); `storeFileDisplay` replaces the user's home directory with `~` and is what the management page renders.
 - `{action:"providerUpdate", providerId, update:{enabled?,apiKey?,apiKeyRef?,baseURL?,consoleUrl?,label?,shortLabel?}}` → same list payload;
   empty strings clear a stored value (falling back to the profile/default). `label` (全名, ≤40 chars) and
   `shortLabel` (短标签, ≤12 chars) let the management page rename a provider. The shipped management page no
@@ -326,9 +326,7 @@ The dialog 「供应商管理」 page talks to three additional actions:
   saves enabled/consoleUrl/label/shortLabel. Overrides are persisted atomically to
   `$DSH_HOME/dsh-tokenlens/providers.json` (plugin-owned, not the profile patch); the same file also
 - `{action:"providerTest", providerId}` → the normal snapshot envelope (`{ok,snapshot}` or `{ok:false,error}`), forcing one upstream read.
-- `{action:"settingsUpdate", settings:{labelStyle:"short"|"full"}}` → the same providers payload; the choice is
-  persisted in the store (`settings.labelStyle`) and controls whether the composer chip shows each
-  provider's `shortLabel` or full `label`. Invalid values answer `unsupported-provider`.
+- `{action:"settingsUpdate", settings:{labelStyle?:"short"|"full", defaultView?:"chart"|"data", defaultScope?:"provider"|"all", detailsExpanded?:"auto"|"expanded"|"collapsed", detailsWindow?:"today"|"last7Days"|"second"|"total"}}` → the same providers payload; every field is optional and persisted in the store (`settings.*`). `labelStyle` controls whether the composer chip shows each provider's `shortLabel` or full `label`; `defaultView` / `defaultScope` / `detailsExpanded` are the usage-dialog defaults; `detailsWindow` (v1.2.1) is the remembered 明细 donut window (falls back visually to `total` when that window is unavailable on the current provider/host). Invalid values answer `unsupported-provider`.
 
 `dshProviders` lists every route registered in DSH model settings (in order) with a `supported` flag (whether a usage adapter exists); the shipped management page renders those routes as the primary list and keeps unconfigured preset adapters in a collapsed secondary section. `dshManaged`/`dshProviderId` tell the management page that the route already exists in DSH model settings
 (opencode-go / commandcode / deepseek), so the page can inherit the key and base URL instead of asking for them

package/README.en.md

@@ -9,7 +9,7 @@
 
 > One glance at your usage: plan capacity for the selected provider plus local token statistics across harnesses, right below the DSH composer.
 
-**dsh-TokenLens** is a usage plugin for DSH (DeepSeek Harness), version v1.2.0. It keeps two kinds of numbers separate:
+**dsh-TokenLens** is a usage plugin for DSH (DeepSeek Harness), version v1.2.1. It keeps two kinds of numbers separate:
 
 - **Plan capacity** — the provider's authoritative server-side values (percentage windows, used / cap, balance or remaining credit);
 - **Local token stats** — tokens consumed on this machine across every connected harness, for the selected provider or for all providers combined.
@@ -21,7 +21,7 @@ Everything is computed locally: zero runtime dependencies, no external database,
 - **Usage chip below the composer** — follows the selected model provider and shows its plan capacity; providers without an adapter or credentials stay hidden.
 - **Details dialog** — plan capacity windows with reset times (plus an optional "consumed · estimated consumable" hint) and local token stats for today / last 7 days / last 30 days / all-time, scoped to the current provider or all harnesses.
 - **Data and chart modes** — tables, a daily trend chart and ring charts with breakdowns by harness, provider, top model and unmapped providers. In chart mode, clicking a day's bar drills into that day's 24 hourly bars; the 明细 rings switch between today / last 7 days / last X days (or last 30 days) / all time.
-- **Provider management page** — enabled / built-in / all filters, enable switches, credential status, console links, label editing, connection tests, subscription badges and plugin settings.
+- **Provider management page** — enabled / built-in / all filters, enable switches, credential status, console links, label editing, connection tests, subscription badges and plugin settings (label style, default view/scope, details expansion, default 明细 donut window).
 - **Auto-discovery and agent tool** — providers configured in DSH Settings → Model Services are detected by route id or base-URL host and reuse their DSH credentials; `tokenlens_usage` lets the model query snapshots, local stats and diagnostics.
 - **Local-only** — 5 harnesses (DSH, ZCode, OpenCode CLI, WorkBuddy / CodeBuddy CLI, Qoder CN CLI), 25 built-in providers (16 with plan / balance adapters), read-only local data, no telemetry.
 
@@ -66,7 +66,7 @@ dsh plugin --profile <profile> add dsh-tokenlens
 Then make sure `dsh.profile.bundles` in `$DSH_HOME/profiles/<profile>/package.json` contains `"dsh-tokenlens"`:
 
 ```jsonc
-{ "dependencies": { "dsh-tokenlens": "^1.2.0" },
+{ "dependencies": { "dsh-tokenlens": "^1.2.1" },
   "dsh": { "profile": { "bundles": ["…", "dsh-tokenlens"] } } }
 ```
 
@@ -134,7 +134,7 @@ Host bridge route: `/api/tokenlens`; agent tool: `tokenlens_usage`.
 
 ## Development
 
-Node.js ≥ 24, zero runtime dependencies: `node --test` runs the 250 tests.
+Node.js ≥ 24, zero runtime dependencies: `node --test` runs the 255 tests.
 
 Release: `node scripts/bump-version.mjs <version> "<note>"` updates `package.json`, `PLUGIN_VERSION` and `CHANGELOG.md`; see [CONTRIBUTING.md](CONTRIBUTING.md) and [SECURITY.md](SECURITY.md).
 

package/README.md

@@ -9,7 +9,7 @@
 
 > **一眼看清你的用量**：在 DSH 输入框下方显示当前供应商的套餐容量，并汇总本机跨 Harness 的 Token 消耗。
 
-**dsh-TokenLens（词元透镜）** 是 DSH（DeepSeek Harness）的用量插件（v1.2.0，公开版本）。它把两类数字**按不同口径**分开呈现：
+**dsh-TokenLens（词元透镜）** 是 DSH（DeepSeek Harness）的用量插件（v1.2.1，公开版本）。它把两类数字**按不同口径**分开呈现：
 
 - **套餐容量**（供应商服务端权威值）：百分比窗口、`已用 / 上限`、账户余额或剩余额度；
 - **本机 Token 统计**（本机记录）：当前供应商在本机所有已接入 Harness 上的合计用量，也可切到「全部 Harness」看总账。
@@ -41,7 +41,7 @@
   - **本机 Token 统计**：今日 / 最近 7 天 / 最近 30 天 / 总计（订阅类供应商显示「最近 X 天」生效窗口），可按「当前供应商 · 全部 Harness」与「全部 Harness」两个视角查看。
   - **明细与图表**：按 Harness、按供应商、Top 模型、未映射供应商分组；支持「数据」（表格）与「图表」两种模式切换。图表模式里点击某一天的柱子可下钻查看**当天 24 小时**的 Token 消耗，底部「明细」环形图支持 **今日 / 最近 7 天 / 最近 X 天（或最近 30 天）/ 总计** 窗口切换。
   - **工作区徽标**（实验性）：左侧工作区列表的名称旁显示该工作区的本机 Token 合计，悬浮卡片显示今日 / 7 天 / 30 天 / 总计；纯展示，找不到对应 UI 时自动降级。
-- **供应商管理页**：「已配置 / 内置 / 全部」筛选、启用开关、凭据状态、控制台链接、短标签与全名编辑、测试连接、已订阅徽章；另有「插件设置」可配置标签样式、默认展示模式、默认统计范围与明细展开状态。
+- **供应商管理页**：「已配置 / 内置 / 全部」筛选、启用开关、凭据状态、控制台链接、短标签与全名编辑、测试连接、已订阅徽章；另有「插件设置」可配置标签样式、默认展示模式、默认统计范围、明细展开状态与图表「明细」环形图的默认窗口（今日 / 最近 7 天 / 最近 X 天 / 总计，记住上次选择）。
 - **自动识别**：在 DSH「设置 → 模型服务」中配置过的供应商会自动出现在管理页，并按路由 id 或 baseURL 主机匹配内置用量适配器，自动继承 DSH 中的凭据，无需重复填写。
 - **Agent 工具**：注册 `tokenlens_usage`，模型可以自行查询套餐容量与本机用量。
 
@@ -106,7 +106,7 @@ dsh plugin --profile <profile> add dsh-tokenlens
 ```jsonc
 {
   "dependencies": {
-    "dsh-tokenlens": "^1.2.0"
+    "dsh-tokenlens": "^1.2.1"
   },
   "dsh": {
     "profile": {
@@ -389,7 +389,7 @@ Host 半注册 `tokenlens_usage`，参数 `action`（默认 `snapshot`）与可
 
 ## 验证
 
-- `node --test`：**250 个自动化用例**，覆盖 Host 数据层、供应商适配器、统计折叠、各 harness 读取、插件集成与浏览器端渲染 / 交互。
+- `node --test`：**255 个自动化用例**，覆盖 Host 数据层、供应商适配器、统计折叠、各 harness 读取、插件集成与浏览器端渲染 / 交互。
 - 在真实环境中验证过 **5 个 harness** 的数据源；本机统计与独立的 SQLite 查询、独立的日志解析逐项对账（差额为 0），跨 harness 合并与供应商映射算术自洽。
 - 供应商接口按各官方文档与参考客户端行为验证；未配置凭据时 chip 静默隐藏，接口异常时按可重试错误降级。
 
@@ -400,7 +400,7 @@ Host 半注册 `tokenlens_usage`，参数 `action`（默认 `snapshot`）与可
 ```powershell
 git clone https://github.com/daigahou/dsh-tokenlens.git
 cd dsh-tokenlens
-node --test        # 250 个用例
+node --test        # 255 个用例
 ```
 
 本地联调安装方式见[方式 C](#方式-c本地开发从源码-link)。

package/client.js

@@ -66,6 +66,8 @@ window.__ModuleLoader__.load({
     const PROVIDERS_TTL_MS = 30000
     /** Auto-sync cadence of the provider list while the management page is open (v0.17.0). */
     const MANAGEMENT_SYNC_MS = 15000
+    /** Retry delay of a 明细-window save blocked by an in-flight settings request (v1.2.1). */
+    const DETAILS_WINDOW_SAVE_RETRY_MS = 200
     /** How many per-provider / per-model stats rows the dialog lists. */
     const MAX_PROVIDER_ROWS = 5
     const MAX_MODEL_ROWS = 3
@@ -125,14 +127,16 @@ window.__ModuleLoader__.load({
     /** Fixed segment palette of the 明细 donut charts (v0.27.0, color-blind friendly order). */
     const DONUT_PALETTE = ['#22c55e', '#3b82f6', '#f59e0b', '#a855f7', '#06b6d4', '#f97316']
     /**
-     * Host-side display defaults (v0.29.0). 「恢复默认设置」 sends exactly these;
-     * must stay in sync with DEFAULT_SETTINGS in lib/provider-store.mjs.
+     * Host-side display defaults (v0.29.0; the five fields include the v1.2.1
+     * 明细 donut window). 「恢复默认设置」 sends exactly these; must stay in sync
+     * with DEFAULT_SETTINGS in lib/provider-store.mjs.
      */
     const DEFAULT_PLUGIN_SETTINGS = {
       labelStyle: 'full',
       defaultView: 'chart',
       defaultScope: 'provider',
       detailsExpanded: 'auto',
+      detailsWindow: 'total',
     }
 
     const zh = {
@@ -1101,9 +1105,15 @@ window.__ModuleLoader__.load({
       return raw === 'expanded' || raw === 'collapsed' ? raw : 'auto'
     }
 
+    /** One `detailsWindow` setting: 'today' | 'last7Days' | 'second' | 'total' (junk means 总计). */
+    function normalizeDetailsWindow(raw) {
+      return raw === 'today' || raw === 'last7Days' || raw === 'second' ? raw : 'total'
+    }
+
     /**
-     * The four display settings of the `providers` payload (v0.29.0), every field
-     * normalized to a usable value so old Hosts keep the previous defaults.
+     * The five display settings of the `providers` payload (v0.29.0; the 明细
+     * donut window joined them in v1.2.1), every field normalized to a usable
+     * value so old Hosts keep the previous defaults.
      */
     function normalizePluginSettings(raw) {
       const source = raw !== null && typeof raw === 'object' && !Array.isArray(raw) ? raw : {}
@@ -1112,6 +1122,7 @@ window.__ModuleLoader__.load({
         defaultView: normalizeDisplayView(source.defaultView),
         defaultScope: normalizeDisplayScope(source.defaultScope),
         detailsExpanded: normalizeDetailsExpanded(source.detailsExpanded),
+        detailsWindow: normalizeDetailsWindow(source.detailsWindow),
       }
     }
 
@@ -1743,8 +1754,9 @@ window.__ModuleLoader__.load({
         // is charted instead of the daily trend, or null (daily trend).
         chartDay: null,
         // v1.2.0 明细 donut window: 'today' | 'last7Days' | 'second' | 'total'.
-        // Presentation state only (never persisted to the plugin settings).
-        detailsWindow: 'total',
+        // v1.2.1: persisted setting (the last choice survives reopening the dialog
+        // and restarting DSH; the startup bootstrap loads it back).
+        detailsWindow: DEFAULT_PLUGIN_SETTINGS.detailsWindow,
         // Provider management page (v0.9.0).
         view: 'usage', // 'usage' | 'management'
         management: defaultManagementState(),
@@ -1795,7 +1807,10 @@ window.__ModuleLoader__.load({
     /** Bumped whenever the selected provider changes; stale responses are dropped. */
     let usageEpoch = 0
 
-    /** The four display settings currently in effect (v0.29.0). */
+    /**
+     * The five display settings currently in effect (v0.29.0; the 明细 donut
+     * window joined them in v1.2.1).
+     */
     function currentPluginSettings() {
       const state = store.get()
       return {
@@ -1803,6 +1818,7 @@ window.__ModuleLoader__.load({
         defaultView: normalizeDisplayView(state.defaultView),
         defaultScope: normalizeDisplayScope(state.defaultScope),
         detailsExpanded: normalizeDetailsExpanded(state.detailsExpanded),
+        detailsWindow: normalizeDetailsWindow(state.detailsWindow),
       }
     }
 
@@ -1825,9 +1841,13 @@ window.__ModuleLoader__.load({
         statsView: settings.defaultView,
         statsScope: settings.defaultScope,
         showDetails: showDetailsFor(settings.detailsExpanded),
+        // v1.2.1: the 明细 donut window is a persisted setting, so reopening the
+        // dialog or switching provider keeps the last saved choice instead of
+        // always snapping back to 总计 (detailsWindowOf still falls back when the
+        // chosen window is absent from the stats payload).
+        detailsWindow: settings.detailsWindow,
         chartHover: null,
         chartDay: null,
-        detailsWindow: 'total',
       }
     }
 
@@ -2024,11 +2044,16 @@ window.__ModuleLoader__.load({
 
     /**
      * Adopt the display settings and wire label cache of a providers payload
-     * (v0.10.0, extended v0.29.0 with the plugin display defaults). The
-     * management list itself is applied by the caller, so a read-only startup
-     * load can reuse this without touching the page state.
+     * (v0.10.0, extended v0.29.0 with the plugin display defaults).
+     *
+     * `options.adoptDetailsWindow` is only set by the startup bootstrap: the
+     * persisted 明细 window must be loaded once, but a plain settingsUpdate
+     * answer must never repaint a just-clicked pill (the answer of an earlier
+     * save would otherwise overwrite the last of a fast click series, v1.2.1).
+     * The management list itself is applied by the caller, so a read-only
+     * startup load can reuse this without touching the page state.
      */
-    function adoptProvidersMeta(parsed) {
+    function adoptProvidersMeta(parsed, options = {}) {
       if (parsed === null || typeof parsed !== 'object') return
       const current = store.get()
       const patch = {}
@@ -2037,6 +2062,9 @@ window.__ModuleLoader__.load({
       if (current.defaultView !== settings.defaultView) patch.defaultView = settings.defaultView
       if (current.defaultScope !== settings.defaultScope) patch.defaultScope = settings.defaultScope
       if (current.detailsExpanded !== settings.detailsExpanded) patch.detailsExpanded = settings.detailsExpanded
+      if (options.adoptDetailsWindow === true && current.detailsWindow !== settings.detailsWindow) {
+        patch.detailsWindow = settings.detailsWindow
+      }
       if (parsed.labelCatalog !== null && typeof parsed.labelCatalog === 'object') {
         const catalog = { ...current.labelCatalog, ...parsed.labelCatalog }
         if (Object.keys(catalog).length > 0) patch.labelCatalog = catalog
@@ -2047,10 +2075,11 @@ window.__ModuleLoader__.load({
     /**
      * Read the providers payload once at controller startup (v0.10.0).
      *
-     * Only the display style and the wire label cache are adopted: the chip must
-     * honor a persisted 'full' style before the 管理 page is ever opened, while
-     * the page keeps its own lazy load. Silent on failure — an old Host without
-     * the action (or an unreachable bridge) keeps the short-label defaults.
+     * Only the display style, the persisted 明细 window and the wire label
+     * cache are adopted: the chip must honor a persisted 'full' style and the
+     * dialog must restore the saved donut window before the 管理 page is ever
+     * opened, while the page keeps its own lazy load. Silent on failure — an
+     * old Host without the action (or an unreachable bridge) keeps the defaults.
      */
     async function bootstrapProviders() {
       let data
@@ -2062,7 +2091,7 @@ window.__ModuleLoader__.load({
       if (data === null || typeof data !== 'object' || data.ok !== true) return { kind: 'envelope' }
       const parsed = normalizeProvidersPayload(data)
       if (parsed === null) return { kind: 'transport' }
-      adoptProvidersMeta(parsed)
+      adoptProvidersMeta(parsed, { adoptDetailsWindow: true })
       return { kind: 'ok' }
     }
 
@@ -2203,10 +2232,11 @@ window.__ModuleLoader__.load({
     }
 
     /**
-     * Persist one display-settings change (v0.29.0): the FULL four-field settings
-     * object is always sent, because the Host accepts any subset but the page
-     * keeps a single source of truth. The answered payload's settings, wire
-     * labels and provider list are adopted. Never throws.
+     * Persist one display-settings change (v0.29.0): the FULL five-field settings
+     * object is always sent (the v1.2.1 明细 window included), because the Host
+     * accepts any subset but the page keeps a single source of truth. The
+     * answered payload's settings, wire labels and provider list are adopted.
+     * Never throws.
      */
     async function requestSettingsUpdate(settings) {
       const next = normalizePluginSettings(settings)
@@ -2255,7 +2285,37 @@ window.__ModuleLoader__.load({
       return { kind: 'transport' }
     }
 
-    /** Change one display setting; the other three keep their current values. */
+    /** Pending retry timer of the 明细-window save (a single timer, v1.2.1). */
+    let detailsWindowSaveTimer = null
+
+    /**
+     * Persist the 明细 donut window choice (v1.2.1).
+     *
+     * The store field is also the persisted setting value, so a pill click saves
+     * the FULL current settings through `settingsUpdate`. When another settings
+     * request is still in flight, one 200ms retry timer keeps the LAST click of a
+     * fast series (the earlier answer must not overwrite it: adoptProvidersMeta
+     * ignores detailsWindow for non-bootstrap answers). The bridge answers
+     * locally within a few milliseconds, so a single retry is enough. The Host's
+     * answer then refreshes the provider list as usual.
+     */
+    function persistDetailsWindow() {
+      if (detailsWindowSaveTimer !== null) {
+        window.clearTimeout(detailsWindowSaveTimer)
+        detailsWindowSaveTimer = null
+      }
+      if (store.get().management.settingsBusy === true) {
+        detailsWindowSaveTimer = window.setTimeout(() => {
+          detailsWindowSaveTimer = null
+          if (store.get().management.settingsBusy === true) return
+          void requestSettingsUpdate(currentPluginSettings())
+        }, DETAILS_WINDOW_SAVE_RETRY_MS)
+        return
+      }
+      void requestSettingsUpdate(currentPluginSettings())
+    }
+
+    /** Change one display setting; the other four keep their current values. */
     function savePluginSetting(field, value) {
       if (store.get().management.settingsBusy === true) return
       const next = { ...currentPluginSettings(), [field]: value }
@@ -2265,6 +2325,9 @@ window.__ModuleLoader__.load({
     /** 「恢复默认设置」: send the Host-side display defaults as one full payload. */
     function resetPluginSettings() {
       if (store.get().management.settingsBusy === true) return
+      // v1.2.1: reset the persisted 明细 window locally too — a plain
+      // settingsUpdate answer intentionally does not adopt that field.
+      store.set({ detailsWindow: DEFAULT_PLUGIN_SETTINGS.detailsWindow })
       void requestSettingsUpdate({ ...DEFAULT_PLUGIN_SETTINGS })
     }
 
@@ -4382,9 +4445,10 @@ window.__ModuleLoader__.load({
     }
 
     /**
-     * The active 明细 donut window (v1.2.0): the stored choice while that window
-     * still exists, else 总计. The state lives in the store next to statsView /
-     * statsScope and is never persisted to the plugin settings.
+     * The active 明细 donut window (v1.2.1): the stored choice while that window
+     * still exists, else 总计. Since v1.2.1 the choice is also persisted to the
+     * plugin settings (the startup bootstrap loads it back), so reopening the
+     * dialog / restarting DSH restores it.
      */
     function detailsWindowOf(state, ctx) {
       const key = typeof state.detailsWindow === 'string' ? state.detailsWindow : 'total'
@@ -4415,7 +4479,7 @@ window.__ModuleLoader__.load({
       return bucket === null ? 0 : bucket.total ?? 0
     }
 
-    /** The window pill row under the 明细 donut title (v1.2.0). */
+    /** The window pill row under the 明细 donut title (v1.2.0; saved since v1.2.1). */
     function buildDetailsWindowSwitch(state, ctx, t) {
       const active = detailsWindowOf(state, ctx)
       const option = (key, label) =>
@@ -4429,7 +4493,10 @@ window.__ModuleLoader__.load({
             'data-active': active === key ? 'true' : 'false',
             'aria-pressed': active === key ? 'true' : 'false',
             onClick: () => {
-              if (active !== key) store.set({ detailsWindow: key })
+              if (active !== key) {
+                store.set({ detailsWindow: key })
+                persistDetailsWindow()
+              }
             },
           },
           label,
@@ -5123,7 +5190,7 @@ window.__ModuleLoader__.load({
      * v1.2.0: a 今日 / 最近7天 / 最近X天 / 总计 window switch under the title picks
      * which stats window the three donuts aggregate (default 总计). The pills of
      * windows an old Host does not report are hidden; the state lives in the store
-     * (never persisted to the plugin settings).
+     * and, since v1.2.1, is persisted to the plugin settings.
      */
     function buildStatsDetailsCharts(state, ctx, t) {
       const { stats } = ctx

package/index.js

@@ -25,6 +25,7 @@ import { createUsageStats } from './lib/usage-stats.mjs'
 import {
   DEFAULT_SETTINGS,
   DETAILS_DEFAULTS,
+  DETAILS_WINDOWS,
   DISPLAY_VIEWS,
   LABEL_STYLES,
   STATS_SCOPES,
@@ -71,7 +72,7 @@ export const inject = []
 export const PLUGIN_NAME = 'dsh-tokenlens'
 
 /** Plugin version; mirrors package.json (kept here so diagnostics need no fs read). */
-export const PLUGIN_VERSION = '1.2.0'
+export const PLUGIN_VERSION = '1.2.1'
 
 /** Documented defaults; every field of the raw row config is optional. */
 const DEFAULTS = {
@@ -1655,6 +1656,14 @@ export function apply(ctx, rawConfig) {
           }
           next.detailsExpanded = incoming.detailsExpanded
         }
+        if (Object.prototype.hasOwnProperty.call(incoming, 'detailsWindow')) {
+          if (!DETAILS_WINDOWS.includes(incoming.detailsWindow)) {
+            throw new UsageError('unsupported-provider', `settings.detailsWindow must be one of ${DETAILS_WINDOWS.join(', ')}`, {
+              retryable: false,
+            })
+          }
+          next.detailsWindow = incoming.detailsWindow
+        }
         providerStore = saveProviderStore(providerStoreFile, {
           ...providerStore,
           settings: next,

package/lib/provider-store.mjs

@@ -29,6 +29,8 @@ export const LABEL_STYLES = ['short', 'full']
 export const DISPLAY_VIEWS = ['chart', 'data']
 export const STATS_SCOPES = ['provider', 'all']
 export const DETAILS_DEFAULTS = ['auto', 'expanded', 'collapsed']
+/** The 明细 donut windows of the chart mode (v1.2.1): 今日 / 最近7天 / 最近X天 / 总计. */
+export const DETAILS_WINDOWS = ['today', 'last7Days', 'second', 'total']
 
 /** Default display settings (management 插件设置 tab). */
 export const DEFAULT_SETTINGS = {
@@ -36,6 +38,8 @@ export const DEFAULT_SETTINGS = {
   defaultView: 'chart',
   defaultScope: 'provider',
   detailsExpanded: 'auto',
+  // v1.2.1 图表明细窗口默认值: 总计 (the last choice is persisted there).
+  detailsWindow: 'total',
 }
 
 /** The default override file: `$DSH_HOME/dsh-tokenlens/providers.json`. */
@@ -119,6 +123,9 @@ export function sanitizeSettings(value) {
     detailsExpanded: DETAILS_DEFAULTS.includes(source.detailsExpanded)
       ? source.detailsExpanded
       : DEFAULT_SETTINGS.detailsExpanded,
+    detailsWindow: DETAILS_WINDOWS.includes(source.detailsWindow)
+      ? source.detailsWindow
+      : DEFAULT_SETTINGS.detailsWindow,
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-tokenlens",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "type": "module",
   "description": "dsh-TokenLens (词元透镜) — provider-aware plan capacity plus local token statistics (today/7d/30d/all-time, by harness/provider/model/workspace) for DSH.",
   "license": "MIT",