dsh-consumption-badge 1.1.0 → 1.2.1

package/README.md

@@ -15,6 +15,58 @@ next to every assistant message, and opens a detail panel with the session's spe
   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
+  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
+  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 —
+  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:
+    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.
+  - 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.
+    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: **复制更新命令**, **忽略此版本** (remembered on this machine) and
+  **稍后提醒** (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.
 
@@ -82,6 +134,14 @@ Turn records are also mirrored into browser `localStorage` under
 `dsh-consumption:<sessionId>:<turn>` so the chart survives reloads. Persistence writes are
 scheduled off the render path (`requestIdleCallback`), and the aggregation is O(turns).
 
+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.
+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.
+
 ## Pricing model
 
 Off-peak prices in **CNY per 1M tokens**; peak multiplies everything by **2**.
@@ -141,7 +201,15 @@ Install the DSH plugin "dsh-consumption-badge" into my web profile and prove it
 5. Open any session and confirm the `⛽ <tokens> | ≈¥<cost> | peak|valley` 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. Report which step failed and paste the boot log lines that mention `consumption-badge`.
+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`.
 
 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