dsh-cost-meter 1.5.31 → 1.5.32

package/README.en.md

@@ -6,7 +6,7 @@
 
 Per-conversation cost · daily totals · OpenCode Go subscription quota display · budget with usage percentage · official account balance · custom provider balance · balance progress bar · history · peak/off-peak pricing hours display (peak hours UTC 01:00–04:00, 06:00–10:00) · pre-switch popup & system-notification alerts for peak/off-peak changes (position / lead time / alert type configurable) · one-click price sync from the official docs · Codex-style token usage heat grid · multi-vendor model pricing (built-in 90+ model price catalog with auto-matching) · mainstream Coding Plan quota queries & display (Anthropic / Z.ai / MiniMax / Kimi / OpenRouter / SiliconFlow / CommandCode / SCNet) · quota strip above the input box (budget / Go / coding-plan usage in one row, toggleable)
 
-[![version](https://img.shields.io/badge/version-1.5.31-4176E6)](https://github.com/Han-1413141/dsh-cost-meter)
+[![version](https://img.shields.io/badge/version-1.5.32-4176E6)](https://github.com/Han-1413141/dsh-cost-meter)
 [![npm](https://img.shields.io/npm/v/dsh-cost-meter?label=npm)](https://www.npmjs.com/package/dsh-cost-meter)
 [![license](https://img.shields.io/badge/license-MIT-green)](LICENSE)
 [![dsh](https://img.shields.io/badge/DeepSeek%20Harness-dsh--plugin-4176E6)](https://github.com/deepseek-ai/deepseek-harness)
@@ -19,7 +19,7 @@ English | [中文](README.md)
 
 ---
 
-![Promo art](docs/promo.png)
+![Promo art](docs/promo.en.png)
 
 ## Feature overview
 
@@ -31,6 +31,7 @@ English | [中文](README.md)
 | OpenCode Go quota | Sidebar / Settings / bottom-right dock (configurable) | Rolling-5h / weekly / monthly usage percent and reset times, each window toggleable independently, budget used % can show alongside; key auto-discovered (DSH credential store OPENCODE_GO_API_KEY / env / opencode login) or entered manually |
 | Coding plan quotas | Sidebar / Settings page (per vendor) | Multi-vendor coding-plan quota queries (Anthropic Claude Pro/Max, Z.ai / Zhipu GLM Coding Plan, MiniMax Token Plan, Kimi/Moonshot balance, OpenRouter credits, SiliconFlow balance, CommandCode 5h/weekly windows + monthly credits balance); per-vendor enable switch, key, display position and refresh interval (sidebar card in the same box style as the Go quota; the collapsed rail shows percentages), credentials only sent to official endpoints; neutral hints when no credentials/subscription; SCNet Token Plan has no quota API — monthly usage is estimated from the local ledger via the official credits deduction table (no credentials needed) |
 | Quota strip | Above the input box (toggle in Display settings) | One compact chip row for budget used % / the Go main window / each enabled coding-plan usage window (short label + mini progress bar, ≥80% warn, ≥100% over, hover for reset times); a first-run guide card lets you decide whether to enable it; hides itself when there is no quota data |
+| Click to refresh | Sidebar balance/quota boxes | Click the official balance / custom balance / coding-plan box (collapsed rail included) to fetch the latest data immediately; the box pulses while refreshing, failures keep the previous value and surface the reason in the hover tooltip; keyboard Enter/Space also triggers; a one-time guide card appears after the update |
 | Today's cost | Sidebar bottom (above the settings button) | “Today ¥x”, hover for call count and token details |
 | Budget box | Sidebar bottom (between the balance row and the settings button) | Rounded-square frame: budget, used %, progress bar, today's cost & share of budget, used/limit; ≥80% warning, ≥100% over-budget |
 | Summary cards | Settings page | Today / this month / cumulative cost and call counts |
@@ -227,22 +228,22 @@ Real captures from an actual DSH sidebar of the period strip and collapsed verti
 dsh plugin --profile web add dsh-cost-meter
 ```
 
-**PowerShell one-click script** (copy the whole line, paste, press Enter; pnpm is provisioned automatically, git is auto-detected — no clone needed; the install chain is **pinned to the release tag `v1.5.31`** — review the script before running):
+**PowerShell one-click script** (copy the whole line, paste, press Enter; pnpm is provisioned automatically, git is auto-detected — no clone needed; the install chain is **pinned to the release tag `v1.5.32`** — review the script before running):
 
 ```powershell
-irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.5.31/install.ps1 | iex
+irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.5.32/install.ps1 | iex
 ```
 
 **Or a plain command line** (the machine must already have pnpm and git; also pinned to the tag):
 
 ```sh
-dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.5.31
+dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.5.32
 ```
 
 Without git, use the GitHub tag archive:
 
 ```sh
-dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.5.31.tar.gz
+dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.5.32.tar.gz
 ```
 
 After installing, **restart** `dsh web` (plugin rows, the Typert manifest and the client bundle are all scanned at startup):

package/README.md

@@ -6,7 +6,7 @@
 
 本会话费用 · 当日费用 · OpenCode Go 订阅额度显示 · 预算与已用百分比 · 官方账户余额 · 自定义 Provider 余额查询(可配任意 HTTP 端点) · 余额三段进度条 · 历史记录 · 峰谷计价时段显示(UTC 01:00–04:00、06:00–10:00 为峰时段) · 峰/谷切换前弹窗与系统通知提醒(位置/提前量/提醒类型可配) · 官方价格一键同步 · 类 Codex Token 用量热图 · 多厂商多模型价格计费(内置 90+ 模型价格目录与自动匹配) · 主流 Coding Plan 额度查询与显示(Anthropic / Z.ai / MiniMax / Kimi / OpenRouter / SiliconFlow / CommandCode / SCNet 八家) · 输入框上方额度横条(预算/Go/Coding Plan 用量一条横排显示,可开关)
 
-[![version](https://img.shields.io/badge/version-1.5.31-4176E6)](https://github.com/Han-1413141/dsh-cost-meter)
+[![version](https://img.shields.io/badge/version-1.5.32-4176E6)](https://github.com/Han-1413141/dsh-cost-meter)
 [![npm](https://img.shields.io/npm/v/dsh-cost-meter?label=npm)](https://www.npmjs.com/package/dsh-cost-meter)
 [![license](https://img.shields.io/badge/license-MIT-green)](LICENSE)
 [![dsh](https://img.shields.io/badge/DeepSeek%20Harness-dsh--plugin-4176E6)](https://github.com/deepseek-ai/deepseek-harness)
@@ -31,6 +31,7 @@
 | OpenCode Go 额度 | 侧边栏 / 设置页 / 右下角(dock,可配) | 滚动 5 小时 / 本周 / 本月用量百分比与重置时间,三档可分别开关,可同时显示预算已用%;Key 自动发现(DSH 凭据库 OPENCODE_GO_API_KEY / 环境变量 / opencode 登录态)或手动填写 |
 | Coding Plan 额度 | 侧边栏 / 设置页(每家可配) | 多厂商 coding plan 订阅额度查询(Anthropic Claude Pro/Max、Z.ai/智谱 GLM、MiniMax Token Plan、Kimi/Moonshot 余额、OpenRouter credits、SiliconFlow 余额、CommandCode 5h/周窗口与月度 Credits 余额),各家独立启用开关、Key、显示位置与刷新间隔(侧边栏卡片与 Go 额度同款,收起窄栏显示百分比),凭据只发往官方端点;无凭据/无订阅为中性提示;SCNet 超算互联网 Token Plan 无 API 额度端点,按官方 Credits 抵扣表由本地账本估算月度用量(无需凭据) |
 | 额度横条 | 输入框上方(显示设置可开关) | 一条横排 chips 实时显示预算已用% / Go 主窗口 / 各已启用 Coding Plan 用量窗口(短标签+迷你进度条,≥80% 预警、≥100% 超支,悬停见重置时刻);首次更新弹引导卡由用户自主决定开关;无可用数据自动隐藏 |
+| 点击立即刷新 | 侧边栏余额/额度图框 | 官方余额 / 自定义余额 / Coding Plan 图框(含窄栏收起态)点击即触发一次查询,刷新中呼吸闪烁,失败保持原值并在悬停提示说明;键盘 Enter/Space 可触发;更新后首次进入有引导提示 |
 | 当日费用 | 侧边栏底部(设置按钮上方) | 「今日 ¥x」,悬停见调用次数与 token 明细 |
 | 预算图框 | 侧边栏底部(余额行与设置按钮之间) | 圆角方形图框:预算、已用%、进度条、今日费用与占预算%、已用/额度,≥80% 预警、≥100% 超支 |
 | 汇总卡片 | 设置页 | 今日 / 本月 / 累计费用与调用次数 |
@@ -229,22 +230,22 @@
 dsh plugin --profile web add dsh-cost-meter
 ```
 
-**PowerShell 一键脚本**(复制整行粘贴回车;自动补齐 pnpm、自动探测 git,无需克隆仓库;安装链**固定到发布 tag `v1.5.31`**,建议先下载审阅再运行):
+**PowerShell 一键脚本**(复制整行粘贴回车;自动补齐 pnpm、自动探测 git,无需克隆仓库;安装链**固定到发布 tag `v1.5.32`**,建议先下载审阅再运行):
 
 ```powershell
-irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.5.31/install.ps1 | iex
+irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.5.32/install.ps1 | iex
 ```
 
 **或直接命令行**(机器上需已有 pnpm 与 git;同样固定到 tag):
 
 ```sh
-dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.5.31
+dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.5.32
 ```
 
 没有 git 时可用 GitHub tag 打包直链:
 
 ```sh
-dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.5.31.tar.gz
+dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.5.32.tar.gz
 ```
 
 安装后**重启** `dsh web`(插件行、Typert 清单与客户端 bundle 均在启动时扫描):

package/lib/client.js

@@ -272,6 +272,12 @@ window.__ModuleLoader__.load({
       '.cm-bbox-section.over .cm-bbox-pct{color:var(--dsw-alias-state-error-primary)}',
       '.cm-bbox-section.warn .cm-bbox-fill{background:var(--dsw-alias-state-warn-primary)}',
       '.cm-bbox-section.over .cm-bbox-fill{background:var(--dsw-alias-state-error-primary)}',
+      // 点击立即刷新(issue #37):余额/额度图框可点击,刷新中呼吸闪烁。
+      '.cm-bbox.clickable,.cm-foot.clickable{cursor:pointer}',
+      '.cm-bbox.clickable:hover{border-color:var(--dsw-alias-state-business-primary)}',
+      '.cm-bbox.clickable:focus-visible,.cm-foot.clickable:focus-visible{outline:2px solid var(--dsw-alias-state-business-primary);outline-offset:1px}',
+      '@keyframes cm-click-refresh-pulse{0%,100%{opacity:.55}50%{opacity:1}}',
+      '.cm-bbox.clickable.busy,.cm-foot.clickable.busy{animation:cm-click-refresh-pulse 1.1s ease-in-out infinite}',
       '.cm-mm{padding:8px 10px;gap:4px}',
       '.cm-mm-title{font-size:12px;font-weight:600;color:var(--dsw-alias-label-primary)}',
       '.cm-mm-row{display:flex;align-items:center;gap:8px;padding:2px 0}',
@@ -606,6 +612,10 @@ window.__ModuleLoader__.load({
         quotaStripGuideBody: '可以在输入框上方用一条横条实时查看预算与多家订阅额度(OpenCode Go / Coding Plan)的用量百分比。要现在开启吗?可随时在「设置 → 显示设置」中更改。',
         quotaStripGuideOn: '开启横条',
         quotaStripGuideOff: '暂不开启',
+        clickToRefresh: '点击立即刷新',
+        balanceClickGuideTitle: '新增:余额图框点击刷新',
+        balanceClickGuideBody: '现在点击侧边栏的官方余额 / 自定义余额 / Coding Plan 图框,即可立即刷新最新数据,无需等待自动刷新间隔或进入设置页;刷新中会有呼吸闪烁,失败时保持原值并在悬停提示中说明原因。',
+        balanceClickGuideOk: '知道了',
         sidebarLabel: '当日费用显示',
         sidebarOn: '侧边栏底部',
         currencyLabel: '货币单位',
@@ -951,6 +961,10 @@ window.__ModuleLoader__.load({
         quotaStripGuideBody: 'Show budget and subscription quotas (OpenCode Go / coding plans) as one compact strip above the input box. Enable it now? You can change this anytime in Settings → Display.',
         quotaStripGuideOn: 'Enable the strip',
         quotaStripGuideOff: 'Not now',
+        clickToRefresh: 'Click to refresh now',
+        balanceClickGuideTitle: 'New: click the balance box to refresh',
+        balanceClickGuideBody: 'Click the official balance / custom balance / coding-plan box in the sidebar to fetch the latest data immediately — no need to wait for the auto-refresh interval or open Settings. While refreshing the box pulses; on failure the previous value is kept and the reason appears in the hover tooltip.',
+        balanceClickGuideOk: 'Got it',
         sidebarLabel: 'Today cost display',
         sidebarOn: 'Sidebar footer',
         currencyLabel: 'Currency',
@@ -1214,6 +1228,7 @@ window.__ModuleLoader__.load({
           refreshMinutes: typeof v.balance?.refreshMinutes === 'number' && Number.isFinite(v.balance.refreshMinutes) ? v.balance.refreshMinutes : 5,
           showProgressBar: v.balance?.showProgressBar === true,
           budgetCap: typeof v.balance?.budgetCap === 'number' && Number.isFinite(v.balance.budgetCap) && v.balance.budgetCap > 0 ? v.balance.budgetCap : null,
+          clickHintSeen: v.balance?.clickHintSeen === true,
         },
         goQuota: {
           enabled: v.goQuota?.enabled !== false,
@@ -1838,14 +1853,51 @@ window.__ModuleLoader__.load({
       return lines.join(' · ')
     }
 
+    // 点击立即刷新(issue #37):侧边栏余额/额度图框点击触发一次手动刷新;
+    // busy 期间忽略连点防并发;失败保持原值(fast-fail 抛错不会写入 store),
+    // 错误信息供 tooltip 展示,下次刷新开始时清除。
+    function useClickRefresh(call) {
+      const [busy, setBusy] = useState(false)
+      const [err, setErr] = useState(null)
+      const run = () => {
+        if (busy || typeof call !== 'function') return
+        setBusy(true)
+        setErr(null)
+        Promise.resolve().then(call)
+          .catch(error => { setErr(error?.message ?? String(error)) })
+          .finally(() => { setBusy(false) })
+      }
+      return { busy, err, run }
+    }
+
+    // 可点击图框的通用 a11y/事件属性(键盘 Enter/Space 同样触发;aria-busy 标记刷新中)。
+    const clickableRefreshProps = (busy, run) => ({
+      role: 'button',
+      tabIndex: 0,
+      'aria-busy': busy ? 'true' : 'false',
+      onClick: run,
+      onKeyDown: event => {
+        if (event.key === 'Enter' || event.key === ' ') { event.preventDefault(); run() }
+      },
+    })
+
+    // 点击刷新的 tooltip 附加行:提示语 + 刷新中 + 最近一次失败原因。
+    function clickRefreshTipLines(t, refresh) {
+      const lines = [t('clickToRefresh')]
+      if (refresh.busy) lines.push(t('refreshing'))
+      if (refresh.err) lines.push('⚠ ' + t('balanceRefreshFailed', { message: refresh.err }))
+      return lines
+    }
+
     function BalanceRowContent(props) {
-      const { state, wide } = props
+      const { state, wide, api } = props
       const balance = state.balance
       const t = makeT(resolveLocale(state.config?.locale))
+      const refresh = useClickRefresh(api ? () => api.refreshBalance() : null)
       if (!balance || balance.status === 'off') return null
       if (balance.status === 'error') {
-        return el(Tooltip, { label: t('balanceQueryFailed', { message: balance.message || t('unknownError') }), side: 'right', delayMs: 300 },
-          el('div', { className: 'cm-foot' + (wide ? '' : ' cm-foot-rail') + ' cm-bal-err' },
+        return el(Tooltip, { label: [t('balanceQueryFailed', { message: balance.message || t('unknownError') }), ...clickRefreshTipLines(t, refresh)].join('; '), side: 'right', delayMs: 300 },
+          el('div', { className: 'cm-foot clickable' + (wide ? '' : ' cm-foot-rail') + ' cm-bal-err' + (refresh.busy ? ' busy' : ''), ...clickableRefreshProps(refresh.busy, refresh.run) },
             wide ? el(Fragment, null, t('balance'), ' ', el('span', { className: 'cm-num' }, t('queryFailed'))) : '⚠'))
       }
       const detail = [
@@ -1857,17 +1909,19 @@ window.__ModuleLoader__.load({
         }),
         t('updatedAt', { time: new Date(balance.fetchedAt).toLocaleTimeString() }),
         ...(state.reconcile?.ok === false ? ['⚠ ' + state.reconcile.message] : []),
+        ...clickRefreshTipLines(t, refresh),
       ].join('; ')
       return el(Tooltip, { label: detail, side: 'right', delayMs: 300 },
-        el('div', { className: 'cm-foot' + (wide ? '' : ' cm-foot-rail') },
+        el('div', { className: 'cm-foot clickable' + (wide ? '' : ' cm-foot-rail') + (refresh.busy ? ' busy' : ''), ...clickableRefreshProps(refresh.busy, refresh.run) },
           wide ? el(Fragment, null, t('balance'), ' ', el('span', { className: 'cm-num' }, formatBalanceMoney(balance.totalBalance, state.config)), state.reconcile?.ok === false ? ' ⚠' : '') : el(WalletIcon, { size: 16 })))
     }
 
     function BalanceBox(props) {
-      const { state, wide } = props
+      const { state, wide, api } = props
       const config = state.config
       const balance = state.balance
       const t = makeT(resolveLocale(config?.locale))
+      const refresh = useClickRefresh(api ? () => api.refreshBalance() : null)
       if (!balance || balance.status !== 'ok') return null
       const segments = segmentsForOfficialBalance(state, config)
       const remaining = formatBalanceMoney(balance.totalBalance, config)
@@ -1881,6 +1935,7 @@ window.__ModuleLoader__.load({
         }),
         t('updatedAt', { time: new Date(balance.fetchedAt).toLocaleTimeString() }),
         ...(state.reconcile?.ok === false ? ['⚠ ' + state.reconcile.message] : []),
+        ...clickRefreshTipLines(t, refresh),
       ].join('; ')
       const body = el(Fragment, null,
         el('div', { className: 'cm-bbox-head' },
@@ -1888,7 +1943,7 @@ window.__ModuleLoader__.load({
           el('span', { className: 'cm-bbox-pct cm-num cm-bal-amt' }, remaining)),
         el(BalanceBar, { segments }))
       return el(Tooltip, { label: detail, side: 'right', delayMs: 300 },
-        el('div', { className: 'cm-bbox' + (wide ? '' : ' rail') },
+        el('div', { className: 'cm-bbox clickable' + (wide ? '' : ' rail') + (refresh.busy ? ' busy' : ''), ...clickableRefreshProps(refresh.busy, refresh.run) },
           wide ? body : el('div', { className: 'cm-bbox-rail cm-num' }, Math.round(segments.remainingPct) + '%')))
     }
 
@@ -1961,34 +2016,36 @@ window.__ModuleLoader__.load({
     }
 
     function CustomBalanceBox(props) {
-      const { state, wide } = props
+      const { state, wide, api } = props
       const custom = state.customBalance
       const config = state.config
       const t = makeT(resolveLocale(config?.locale))
+      const refresh = useClickRefresh(api ? () => api.refreshCustomBalance() : null)
       if (!custom || custom.status !== 'ok') return null
       const view = customBalanceBoxBody(state, config, t)
-      const detail = customBalanceDetailText(custom, config, t, state)
+      const detail = [customBalanceDetailText(custom, config, t, state), ...clickRefreshTipLines(t, refresh)].join(' · ')
       return el(Tooltip, { label: detail, side: 'right', delayMs: 300 },
-        el('div', { className: 'cm-bbox' + (view.level === 'ok' ? '' : ' ' + view.level) + (wide ? '' : ' rail') },
+        el('div', { className: 'cm-bbox clickable' + (view.level === 'ok' ? '' : ' ' + view.level) + (wide ? '' : ' rail') + (refresh.busy ? ' busy' : ''), ...clickableRefreshProps(refresh.busy, refresh.run) },
           wide ? view.body : el('div', { className: 'cm-bbox-rail cm-num' }, view.rail)))
     }
 
     function CustomBalanceRowContent(props) {
-      const { state, wide } = props
+      const { state, wide, api } = props
       const custom = state.customBalance
       const config = state.config
       const t = makeT(resolveLocale(config?.locale))
+      const refresh = useClickRefresh(api ? () => api.refreshCustomBalance() : null)
       if (!custom || custom.status === 'off') return null
       const label = resolveCustomBalanceLabel(config.customBalance ?? {}, resolveLocale(config?.locale))
       if (custom.status === 'error') {
-        return el(Tooltip, { label: custom.message || t('unknownError'), side: 'right', delayMs: 300 },
-          el('div', { className: 'cm-foot' + (wide ? '' : ' cm-foot-rail') + ' cm-bal-err' },
+        return el(Tooltip, { label: [custom.message || t('unknownError'), ...clickRefreshTipLines(t, refresh)].join('; '), side: 'right', delayMs: 300 },
+          el('div', { className: 'cm-foot clickable' + (wide ? '' : ' cm-foot-rail') + ' cm-bal-err' + (refresh.busy ? ' busy' : ''), ...clickableRefreshProps(refresh.busy, refresh.run) },
             wide ? el(Fragment, null, label, ' ', el('span', { className: 'cm-num' }, t('queryFailed'))) : '⚠'))
       }
       const amount = formatCustomBalanceMoney(custom.remaining, config, custom)
-      const detail = customBalanceDetailText(custom, config, t, state)
+      const detail = [customBalanceDetailText(custom, config, t, state), ...clickRefreshTipLines(t, refresh)].join(' · ')
       return el(Tooltip, { label: detail, side: 'right', delayMs: 300 },
-        el('div', { className: 'cm-foot' + (wide ? '' : ' cm-foot-rail') },
+        el('div', { className: 'cm-foot clickable' + (wide ? '' : ' cm-foot-rail') + (refresh.busy ? ' busy' : ''), ...clickableRefreshProps(refresh.busy, refresh.run) },
           wide ? el(Fragment, null, label, ' ', el('span', { className: 'cm-num' }, amount)) : el(WalletIcon, { size: 16 })))
     }
 
@@ -2115,6 +2172,11 @@ window.__ModuleLoader__.load({
     // 预览通道事件名:设置页按钮/控制台经 window.cmPeakAlertPreview(kind) 触发真实组件。
     const PEAK_ALERT_PREVIEW_EVENT = 'cm-peak-alert-preview'
 
+    // 峰谷 Web 通知去重:记录最近一次已通知的切换点时刻(nextAtMs)。
+    // 必须放模块级——配置变化会重挂 PeakAlert(内部 ref 归零),若用组件内状态,
+    // 重挂后同一切换点会再发一条;切换点时刻单调递增,存单值即可。
+    let lastPeakNotifyAtMs = 0
+
     /**
      * 峰/谷切换前弹窗提醒:距下次相位切换不足配置提前量(默认 2 分钟)时弹浮层,
      * 位置可选屏幕右下角 / 屏幕中心;提醒类型按配置过滤(进入峰/进入谷/峰和谷);
@@ -2129,7 +2191,6 @@ window.__ModuleLoader__.load({
       const [now, setNow] = useState(Date.now())
       const [dismissedAt, setDismissedAt] = useState(null)
       const [preview, setPreview] = useState(null)
-      const notifiedAtRef = useRef(null)
       useEffect(() => {
         const timer = window.setInterval(() => setNow(Date.now()), 10000)
         return () => window.clearInterval(timer)
@@ -2158,10 +2219,10 @@ window.__ModuleLoader__.load({
         }
       }, []) // eslint-disable-line react-hooks/exhaustive-deps
       useEffect(() => {
-        // Web 通知:每次 tick 自包含重算切换点,同一切换点只发一次。
+        // Web 通知:每次 tick 自包含重算切换点,按切换点(nextAtMs)在模块级去重,
+        // 同一切换点只发一次(旧实现比较 tick 时间戳,每 10 秒都"未通知过",会连发)。
         if (!config || config.peakAlertEnabled !== true || config.peakEnabled !== true) return
         if (config.peakAlertWebNotify !== true || !window.Notification || Notification.permission !== 'granted') return
-        if (notifiedAtRef.current === now) return
         const wv = peakPhaseAt(now, Array.isArray(config.peakWindows) ? config.peakWindows : [])
         if (wv === null) return
         const tgt = config.peakAlertTarget === 'peak' || config.peakAlertTarget === 'offpeak' ? config.peakAlertTarget : 'both'
@@ -2170,8 +2231,9 @@ window.__ModuleLoader__.load({
         const mins = Number(config.peakAlertAhead)
         const aheadMs = (Number.isFinite(mins) && mins >= 1 ? mins : 2) * 60000
         if (now < wv.nextAtMs - aheadMs || now >= wv.nextAtMs) return
+        if (lastPeakNotifyAtMs === wv.nextAtMs) return
         const t = makeT(resolveLocale(config.locale))
-        notifiedAtRef.current = now
+        lastPeakNotifyAtMs = wv.nextAtMs
         try {
           new Notification(
             t(intoPeak ? 'peakAlertTitlePeak' : 'peakAlertTitleOffPeak'),
@@ -2448,7 +2510,7 @@ window.__ModuleLoader__.load({
     }
 
     function MiniMaxPlanCard(props) {
-      const { five, seven, fetchedAt, t, wide } = props
+      const { five, seven, fetchedAt, t, wide, refresh } = props
       const fiveView = miniMaxRow(t('codingPlanRemain5h'), five)
       const sevenView = miniMaxRow(t('codingPlanRemain7d'), seven)
       const level = fiveView.level === 'over' || sevenView.level === 'over' ? 'over'
@@ -2463,6 +2525,7 @@ window.__ModuleLoader__.load({
         lineOf(t('codingPlanRemain5h'), five, fiveView),
         lineOf(t('codingPlanRemain7d'), seven, sevenView),
         fetchedAt > 0 ? t('goQuotaFetchedAt', { time: new Date(fetchedAt).toLocaleTimeString() }) : null,
+        ...(refresh ? clickRefreshTipLines(t, refresh) : []),
       ].filter(Boolean).join('; ')
       const body = el(Fragment, null,
         el('div', { className: 'cm-mm-title' }, t('codingPlanMinimaxTitle')),
@@ -2472,18 +2535,23 @@ window.__ModuleLoader__.load({
         el('div', { className: 'cm-bbox-rail cm-num' }, fiveView.remain === null ? '—' : Math.round(fiveView.remain) + '%'),
         el('div', { className: 'cm-bbox-rail cm-num' }, sevenView.remain === null ? '—' : Math.round(sevenView.remain) + '%'))
       return el(Tooltip, { label: detail, side: 'right', delayMs: 300 },
-        el('div', { className: 'cm-bbox cm-mm' + (level === 'ok' ? '' : ' ' + level) + (wide === false ? ' rail' : '') },
+        el('div', {
+          className: 'cm-bbox cm-mm' + (level === 'ok' ? '' : ' ' + level) + (wide === false ? ' rail' : '')
+            + (refresh ? ' clickable' + (refresh.busy ? ' busy' : '') : ''),
+          ...(refresh ? clickableRefreshProps(refresh.busy, refresh.run) : {}),
+        },
           wide === false ? rail : body))
     }
 
     function MiniMaxPlanBox(props) {
-      const { state, wide } = props
+      const { state, wide, api } = props
       const live = state.codingPlans?.minimax
       const t = makeT(resolveLocale(state.config?.locale))
+      const refresh = useClickRefresh(api ? () => api.refreshCodingPlan('minimax') : null)
       if (!live || live.status !== 'ok') return null
       const { five, seven } = miniMaxWindowsOf(live.windows)
       if (five == null && seven == null) return null
-      return el(MiniMaxPlanCard, { five, seven, fetchedAt: live.fetchedAt, t, wide })
+      return el(MiniMaxPlanCard, { five, seven, fetchedAt: live.fetchedAt, t, wide, refresh })
     }
 
     /** 通用 Coding Plan 侧边栏卡片(issue #31):每窗口一行进度条;文本窗口(余额等)整行文本。 */
@@ -2495,9 +2563,10 @@ window.__ModuleLoader__.load({
     }
 
     function CodingPlanBox(props) {
-      const { id, state, wide } = props
+      const { id, state, wide, api } = props
       const live = state.codingPlans?.[id]
       const t = makeT(resolveLocale(state.config?.locale))
+      const refresh = useClickRefresh(api ? () => api.refreshCodingPlan(id) : null)
       const rowDef = CODING_PLAN_ROWS.find(r => r.id === id)
       if (!rowDef || !live || live.status !== 'ok') return null
       const windows = live.windows !== null && typeof live.windows === 'object' ? live.windows : {}
@@ -2526,6 +2595,7 @@ window.__ModuleLoader__.load({
         return codingPlanWindowLabel(name, t) + ' ' + value + reset
       })
       if (live.fetchedAt > 0) detailParts.push(t('goQuotaFetchedAt', { time: new Date(live.fetchedAt).toLocaleTimeString() }))
+      detailParts.push(...clickRefreshTipLines(t, refresh))
       const detail = [t(rowDef.labelKey), ...detailParts].join('; ')
       const pcts = entries.map(([, win]) => pctOf(win)).filter(p => p !== null)
       const level = pcts.some(p => p >= 100) ? 'over' : pcts.some(p => p >= 80) ? 'warn' : 'ok'
@@ -2533,7 +2603,7 @@ window.__ModuleLoader__.load({
         ? pcts.slice(0, 2).map(p => p + '%').join(' ')
         : (typeof entries[0][1]?.text === 'string' ? entries[0][1].text : '—')
       return el(Tooltip, { label: detail, side: 'right', delayMs: 300 },
-        el('div', { className: 'cm-bbox cm-mm' + (level === 'ok' ? '' : ' ' + level) + (wide === false ? ' rail' : '') },
+        el('div', { className: 'cm-bbox cm-mm clickable' + (level === 'ok' ? '' : ' ' + level) + (wide === false ? ' rail' : '') + (refresh.busy ? ' busy' : ''), ...clickableRefreshProps(refresh.busy, refresh.run) },
           wide === false
             ? el('div', { className: 'cm-bbox-rail cm-num' }, railText)
             : el(Fragment, null,
@@ -2678,6 +2748,44 @@ window.__ModuleLoader__.load({
           el('button', { type: 'button', className: 'cm-btn small primary', onClick: () => choose(true) }, t('quotaStripGuideOn'))))
     }
 
+    // 更新后的提醒(issue #37):告知侧边栏余额/额度图框支持点击立即刷新;
+    // 「知道了」写回 balance.clickHintSeen=true 后永久消失(挂常驻 sidebar.footer.action)。
+    // 仅在侧边栏确有可点击图框(官方余额 / 自定义余额 / Coding Plan)时展示,避免噪音。
+    function BalanceClickGuide(props) {
+      // Hook 全部前置(promptSeen 类标记翻转时会提前 return null,顺序必须稳定)。
+      const costStore = props.useCost ? props.useCost(s => s) : undefined
+      const busyRef = useRef(false)
+      const [dismissed, setDismissed] = useState(false)
+      const state = costStore?.state
+      if (!state) return null
+      const config = state.config
+      const sidebarBalanceOn = config.balance?.display === 'sidebar' || config.balance?.display === 'both'
+      const sidebarCustomOn = config.customBalance?.enabled === true
+        && (config.customBalance?.display === 'sidebar' || config.customBalance?.display === 'both')
+      const sidebarPlansOn = CODING_PLAN_ROWS.some(r => {
+        const entry = config.codingPlans?.[r.id]
+        return entry?.enabled === true && (entry.display === 'sidebar' || entry.display === 'both')
+      })
+      if (dismissed || config.balance?.clickHintSeen === true || (!sidebarBalanceOn && !sidebarCustomOn && !sidebarPlansOn)) return null
+      // 串行展示:横条引导(QuotaStripGuide)与本卡同为 fixed 顶部卡片,同屏会完全重叠,
+      // 点掉一张露出另一张,视觉上像「点了没反应」。等横条引导处理完(promptSeen)再出现。
+      if (config.quotaStrip?.promptSeen !== true) return null
+      const t = makeT(resolveLocale(config?.locale))
+      const dismiss = () => {
+        if (busyRef.current === true) return
+        // 乐观消失:点击立即隐藏,落盘确认失败才恢复可见(避免宿主渲染时序让卡片看起来「点不掉」)。
+        setDismissed(true)
+        busyRef.current = true
+        props.api.updateConfig({ balance: { ...(config.balance ?? {}), clickHintSeen: true } })
+          .catch(() => { busyRef.current = false; setDismissed(false) })
+      }
+      return el('div', { className: 'cm-qguide', role: 'dialog', 'aria-label': t('balanceClickGuideTitle') },
+        el('h4', null, t('balanceClickGuideTitle')),
+        el('p', null, t('balanceClickGuideBody')),
+        el('div', { className: 'cm-buttons' },
+          el('button', { type: 'button', className: 'cm-btn small primary', onClick: dismiss }, t('balanceClickGuideOk'))))
+    }
+
     function BudgetBoxContent(props) {
       const { state, wide } = props
       const today = state.today
@@ -2809,13 +2917,13 @@ window.__ModuleLoader__.load({
       const showToday = config.sidebar !== false
       if (!showBalance && !showCustomBalance && !goOk && !plansOn && !budgetOn && !showToday) return null
       const nodes = []
-      if (showBalanceBar) nodes.push(el(BalanceBox, { state, wide }))
-      else if (showBalance) nodes.push(el(BalanceRowContent, { state, wide }))
-      if (showCustomBalanceBar) nodes.push(el(CustomBalanceBox, { state, wide }))
-      else if (showCustomBalance) nodes.push(el(CustomBalanceRowContent, { state, wide }))
+      if (showBalanceBar) nodes.push(el(BalanceBox, { state, wide, api: props.api }))
+      else if (showBalance) nodes.push(el(BalanceRowContent, { state, wide, api: props.api }))
+      if (showCustomBalanceBar) nodes.push(el(CustomBalanceBox, { state, wide, api: props.api }))
+      else if (showCustomBalance) nodes.push(el(CustomBalanceRowContent, { state, wide, api: props.api }))
       if (plansOn) nodes.push(...sidebarPlanIds.map(id => id === 'minimax'
-        ? el(MiniMaxPlanBox, { state, wide })
-        : el(CodingPlanBox, { id, state, wide })))
+        ? el(MiniMaxPlanBox, { state, wide, api: props.api })
+        : el(CodingPlanBox, { id, state, wide, api: props.api })))
       if (goOk && budgetOn && wide) {
         // 同时出现:合并为一张卡片(Go 在上、预算在下,细分隔线),各自保留预警色与自己的详细信息开关。
         const goView = goBoxBody(state, config, t)
@@ -5037,6 +5145,14 @@ window.__ModuleLoader__.load({
         )
         return dispose
       })
+      // 更新后的提醒(issue #37):余额/额度图框点击刷新,常驻插槽 + clickHintSeen 门控。
+      slots.inject('sidebar.footer.action', () => {
+        const dispose = slots.register(
+          { name: 'sidebar.footer.action', id: 'cost-meter-balance-click-guide', order: 2, inject: injected },
+          BalanceClickGuide,
+        )
+        return dispose
+      })
 
       // 峰/谷切换前弹窗提醒:全局 fixed 浮层(fixed 定位与宿主位置无关),挂在常驻的
       // sidebar.footer.action 插槽——conversation.composer.dock 仅在有活跃会话的页面渲染,

package/lib/pricing.js

@@ -199,7 +199,7 @@ export const DEFAULT_PROVIDER_PRICE_TABLE = {
 
 /** 拓展价格表目录的模型家族分组(展示用;未列出的模型自成一家)。 */
 export const PROVIDER_MODEL_FAMILIES = {
-  deepseek: { 'deepseek-v4-flash': 'DeepSeek v4', 'deepseek-v4-pro': 'DeepSeek v4' },
+  deepseek: { 'deepseek-v4-flash': 'DeepSeek v4', 'deepseek-v4-pro': 'DeepSeek v4', 'deepseek-v4-flash-vision-exp': 'DeepSeek v4' },
   openai: {
     'gpt-5.6-sol': 'GPT-5.6', 'gpt-5.6-terra': 'GPT-5.6', 'gpt-5.6-luna': 'GPT-5.6',
     'gpt-5.5': 'GPT-5.5', 'gpt-5.5-pro': 'GPT-5.5',
@@ -283,6 +283,14 @@ export const DEFAULT_PRICE_TABLE = {
       peak: { cacheHit: 0.044, cacheMiss: 1.32, output: 3.96 },
       legacyBase: { cacheHit: 0.003625, cacheMiss: 0.435, output: 0.87 },
     },
+    // Vision-Exp(实验版多模态)与 flash 同价;峰谷时代后发布,无历史基础价档。
+    'deepseek-v4-flash-vision-exp': {
+      cacheHit: 0.007,
+      cacheMiss: 0.22,
+      output: 0.66,
+      offPeak: { cacheHit: 0.007, cacheMiss: 0.22, output: 0.66 },
+      peak: { cacheHit: 0.014, cacheMiss: 0.44, output: 1.32 },
+    },
   },
   default: { cacheHit: 0.007, cacheMiss: 0.22, output: 0.66 },
 }

package/lib/store.js

@@ -89,6 +89,7 @@ export function defaultConfig() {
       showProgressBar: false, // 全局:侧边栏余额以三段进度条展示(蓝=余额,橙=当日,灰=已用)
       budgetCap: null, // 可选:手动额度上限;留空则优先用 API 返回的 max_budget;仍无则整条蓝色
       reconcile: true, // 余额差交叉校验:官方余额当日变动与本地账本今日合计偏差超阈值时提示
+      clickHintSeen: false, // 更新后提醒:余额图框点击刷新的引导是否已处理(issue #37)
     },
     goQuota: {
       enabled: true, // 启用 OpenCode Go 订阅额度读取与显示(像预算开关一样的总开关)
@@ -282,6 +283,7 @@ const VALIDATION_MESSAGES = {
     balanceDisplay: 'balance.display 必须是 sidebar / settings / both / off',
     balanceRefresh: 'balance.refreshMinutes 必须是 1-1440 的整数',
     balanceShowBar: 'balance.showProgressBar 必须是布尔值',
+    balanceClickHint: 'balance.clickHintSeen 必须是布尔值',
     balanceReconcile: 'balance.reconcile 必须是布尔值',
     balanceBudgetCap: 'balance.budgetCap 必须是非负数或 null',
     goQuota: 'goQuota 非法',
@@ -350,6 +352,7 @@ const VALIDATION_MESSAGES = {
     balanceDisplay: 'balance.display must be sidebar / settings / both / off',
     balanceRefresh: 'balance.refreshMinutes must be an integer from 1 to 1440',
     balanceShowBar: 'balance.showProgressBar must be a boolean',
+    balanceClickHint: 'balance.clickHintSeen must be a boolean',
     balanceReconcile: 'balance.reconcile must be a boolean',
     balanceBudgetCap: 'balance.budgetCap must be a non-negative number or null',
     goQuota: 'Invalid goQuota',
@@ -517,6 +520,7 @@ export function applyConfigPatch(current, patch) {
     if (!Number.isInteger(refreshMinutes) || refreshMinutes < 1 || refreshMinutes > 1440) errors.push(vmsg(locale, 'balanceRefresh'))
     else balance.refreshMinutes = refreshMinutes
     if (balance.showProgressBar !== undefined && typeof balance.showProgressBar !== 'boolean') errors.push(vmsg(locale, 'balanceShowBar'))
+    if (balance.clickHintSeen !== undefined && typeof balance.clickHintSeen !== 'boolean') errors.push(vmsg(locale, 'balanceClickHint'))
     if (balance.reconcile !== undefined && typeof balance.reconcile !== 'boolean') errors.push(vmsg(locale, 'balanceReconcile'))
     if (balance.budgetCap !== undefined && balance.budgetCap !== null) {
       const cap = Number(balance.budgetCap)
@@ -700,6 +704,7 @@ export function sanitizeConfig(raw) {
       : base.balance.showProgressBar === true
   }
   balance.showProgressBar = balance.showProgressBar === true
+  balance.clickHintSeen = balance.clickHintSeen === true
   balance.reconcile = balance.reconcile !== false
   const cap = Number(balance.budgetCap)
   balance.budgetCap = Number.isFinite(cap) && cap > 0 ? cap : null

package/lib/typert.host.js

@@ -144,6 +144,8 @@ const configSchema = z.object({
     showProgressBar: z.boolean().optional(),
     budgetCap: z.union([num, z.null()]).optional(),
     reconcile: z.boolean().optional(),
+    // 更新后提醒:余额图框点击刷新引导是否已处理(issue #37,内部标记)。
+    clickHintSeen: z.boolean().optional(),
   }),
   goQuota: z.object({
     enabled: z.boolean(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-cost-meter",
-  "version": "1.5.31",
+  "version": "1.5.32",
   "description": "DeepSeek Harness 会话费用统计插件:本会话成本、当日费用、历史记录与官方价格同步,支持多厂商多模型价格计费(内置 90+ 模型价格目录与自动匹配)、主流 Coding Plan 订阅额度查询与显示(7 家,含 SCNet Token Plan 本地 Credits 计量)、自定义 Provider 余额查询(可配任意 HTTP 端点)与余额进度条、峰谷计价时段显示与切换前弹窗/系统通知提醒(位置/提前量/类型可配),界面中英双语。Session cost tracking plugin for DeepSeek Harness: per-conversation cost, daily totals, history and official price sync, with multi-vendor model pricing (built-in 90+ model catalog with auto-matching), Coding Plan quota queries & display for 7 vendors (incl. local credits metering for the SCNet Token Plan), custom provider balance lookup (configurable HTTP endpoint) and balance progress bar, plus peak/off-peak pricing display with pre-switch popup & system-notification alerts (position / lead time / type configurable), in a bilingual (Chinese/English) UI.",
   "type": "module",
   "main": "lib/index.js",