dsh-cost-meter 1.5.6 → 1.5.8

package/README.en.md

@@ -6,7 +6,8 @@
 
 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) · 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)
 
-[![version](https://img.shields.io/badge/version-1.5.6-4176E6)](https://github.com/Han-1413141/dsh-cost-meter)
+[![version](https://img.shields.io/badge/version-1.5.8-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)
 [![awesome · DSH plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
@@ -184,22 +185,28 @@ Real captures from an actual DSH sidebar of the period strip and collapsed verti
 
 ### One-click install (recommended)
 
-**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.6`** — review the script before running):
+**npm package name** (published to the npm registry, always tracks the latest version; no git needed):
+
+```sh
+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.8`** — review the script before running):
 
 ```powershell
-irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.5.6/install.ps1 | iex
+irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.5.8/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.6
+dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.5.8
 ```
 
 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.6.tar.gz
+dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.5.8.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,8 @@
 
 本会话费用 · 当日费用 · 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 六家)
 
-[![version](https://img.shields.io/badge/version-1.5.6-4176E6)](https://github.com/Han-1413141/dsh-cost-meter)
+[![version](https://img.shields.io/badge/version-1.5.8-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)
 [![awesome · DSH plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
@@ -186,22 +187,28 @@
 
 ### 一键安装(推荐)
 
-**PowerShell 一键脚本**(复制整行粘贴回车;自动补齐 pnpm、自动探测 git,无需克隆仓库;安装链**固定到发布 tag `v1.5.6`**,建议先下载审阅再运行):
+**npm 包名安装**(已发布到 npm registry,始终跟随最新版本;无需 git):
+
+```sh
+dsh plugin --profile web add dsh-cost-meter
+```
+
+**PowerShell 一键脚本**(复制整行粘贴回车;自动补齐 pnpm、自动探测 git,无需克隆仓库;安装链**固定到发布 tag `v1.5.8`**,建议先下载审阅再运行):
 
 ```powershell
-irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.5.6/install.ps1 | iex
+irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.5.8/install.ps1 | iex
 ```
 
 **或直接命令行**(机器上需已有 pnpm 与 git;同样固定到 tag):
 
 ```sh
-dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.5.6
+dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.5.8
 ```
 
 没有 git 时可用 GitHub tag 打包直链:
 
 ```sh
-dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.5.6.tar.gz
+dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.5.8.tar.gz
 ```
 
 安装后**重启** `dsh web`(插件行、Typert 清单与客户端 bundle 均在启动时扫描):

package/lib/client.js

@@ -77,6 +77,8 @@ window.__ModuleLoader__.load({
       '.cm-table th{color:var(--dsw-alias-label-tertiary);font-weight:500}',
       '.cm-table td.num,.cm-table th.num{text-align:right;font-variant-numeric:tabular-nums}',
       '.cm-table tr:last-child td{border-bottom:none}',
+      '.cm-table tr.cm-row-click{cursor:pointer}',
+      '.cm-table tr.cm-row-click:hover td{background:var(--dsw-alias-bg-hover,rgba(127,127,127,.08))}',
       '.cm-empty{font-size:12px;color:var(--dsw-alias-label-tertiary);padding:8px 0}',
       '.cm-scroll{max-height:320px;overflow:auto;border:1px solid var(--dsw-alias-border-l1);border-radius:10px}',
       '.cm-grid{display:grid;grid-template-columns:repeat(2,minmax(220px,1fr));gap:12px}',
@@ -203,7 +205,7 @@ window.__ModuleLoader__.load({
       '.cm-bbox.warn{border-color:var(--dsw-alias-state-warn-primary)}',
       '.cm-bbox.over{border-color:var(--dsw-alias-state-error-primary)}',
       '.cm-bbox-head{display:flex;align-items:center;justify-content:space-between;gap:8px}',
-      '.cm-bbox-label{font-size:12px;color:var(--dsw-alias-label-secondary)}',
+      '.cm-bbox-label{font-size:12px;font-weight:600;color:var(--dsw-alias-label-primary)}',
       '.cm-bbox-pct{font-size:12px;font-weight:600;color:var(--dsw-alias-label-primary)}',
       '.cm-bbox.warn .cm-bbox-pct{color:var(--dsw-alias-state-warn-primary)}',
       '.cm-bbox.over .cm-bbox-pct{color:var(--dsw-alias-state-error-primary)}',
@@ -229,6 +231,16 @@ 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)}',
+      '.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}',
+      '.cm-mm-row .cm-bbox-label{flex:none;width:22px;font-weight:400;color:var(--dsw-alias-label-secondary);font-variant-numeric:tabular-nums}',
+      '.cm-mm-row .cm-bbox-bar{flex:1;min-width:0;height:6px}',
+      '.cm-mm-row .cm-bbox-pct{flex:none;min-width:2.4em;text-align:right;font-variant-numeric:tabular-nums}',
+      '.cm-mm-row.warn .cm-bbox-label,.cm-mm-row.warn .cm-bbox-pct{color:var(--dsw-alias-state-warn-primary)}',
+      '.cm-mm-row.over .cm-bbox-label,.cm-mm-row.over .cm-bbox-pct{color:var(--dsw-alias-state-error-primary)}',
+      '.cm-mm-row.warn .cm-bbox-fill{background:var(--dsw-alias-state-warn-primary)}',
+      '.cm-mm-row.over .cm-bbox-fill{background:var(--dsw-alias-state-error-primary)}',
       '.cm-bal-line{font-size:13px;color:var(--dsw-alias-label-secondary)}',
       '.cm-bal-line.warn{color:var(--dsw-alias-state-warning-primary,#b45309)}',
       '.cm-bal-line.err,.cm-bal-err{color:var(--dsw-alias-state-error-primary)}',
@@ -371,6 +383,9 @@ window.__ModuleLoader__.load({
         codingPlanAnthropic: 'Anthropic(Claude Pro/Max)',
         codingPlanZai: 'Z.ai / 智谱 GLM Coding Plan',
         codingPlanMinimax: 'MiniMax Token Plan',
+        codingPlanMinimaxTitle: 'MiniMax Plan',
+        codingPlanRemain5h: '5h',
+        codingPlanRemain7d: '7d',
         enableCodingPlan: '启用额度查询',
         codingPlanKeyLabel: 'API Key(可选,留空自动发现)',
         refreshCodingPlan: '刷新',
@@ -468,6 +483,16 @@ window.__ModuleLoader__.load({
         cardTotal: '累计费用',
         cardTotalSub: '自账本建立以来 · 调用 {calls} 次',
         todaySessions: '今日会话',
+        historyExpandHint: '点击日期行可展开当日会话明细',
+        historySessionsLoading: '会话明细加载中…',
+        historyNoSessions: '该日无会话明细(早期数据或会话日志已清理)',
+        historySessionsError: '会话明细加载失败',
+        sessionRankTitle: '按会话统计(全部历史)',
+        sessionRankHint: '不按日期分组,全部历史会话按费用降序',
+        sessionRankEmpty: '暂无会话数据',
+        sessionRankLoading: '会话排行加载中…',
+        sessionRankError: '会话排行加载失败',
+        sessionRankLimit: '显示条数',
         history: '历史记录',
         usageTitle: 'Token 用量统计',
         usageTotal: '累计 {tokens} tokens · 输入 {input} · 缓存 {cache} · 输出 {output} · {calls} 次调用',
@@ -645,6 +670,9 @@ window.__ModuleLoader__.load({
         codingPlanAnthropic: 'Anthropic (Claude Pro/Max)',
         codingPlanZai: 'Z.ai / Zhipu GLM Coding Plan',
         codingPlanMinimax: 'MiniMax Token Plan',
+        codingPlanMinimaxTitle: 'MiniMax Plan',
+        codingPlanRemain5h: '5h',
+        codingPlanRemain7d: '7d',
         enableCodingPlan: 'Enable quota queries',
         codingPlanKeyLabel: 'API key (optional; empty = auto-detect)',
         refreshCodingPlan: 'Refresh',
@@ -741,6 +769,16 @@ window.__ModuleLoader__.load({
         cardTotal: 'All time',
         cardTotalSub: 'Since the ledger was created · Calls {calls}',
         todaySessions: "Today's sessions",
+        historyExpandHint: 'Click a date row to expand its session details',
+        historySessionsLoading: 'Loading session details…',
+        historyNoSessions: 'No session details for this day (early data or session logs cleaned)',
+        historySessionsError: 'Failed to load session details',
+        sessionRankTitle: 'By session (all history)',
+        sessionRankHint: 'All historical sessions sorted by cost, not grouped by date',
+        sessionRankEmpty: 'No session data yet',
+        sessionRankLoading: 'Loading session ranking…',
+        sessionRankError: 'Failed to load session ranking',
+        sessionRankLimit: 'Rows',
         history: 'History',
         usageTitle: 'Token usage stats',
         usageTotal: 'All-time {tokens} tokens · input {input} · cache {cache} · output {output} · {calls} calls',
@@ -1127,6 +1165,22 @@ window.__ModuleLoader__.load({
       if (typeof v !== 'string') fail('provider', 'string')
       return v
     })
+    const dateCodec = codecOf(v => {
+      if (typeof v !== 'string') fail('date', 'string')
+      return v
+    })
+    const dayCodec = codecOf(v => {
+      if (v === null || typeof v !== 'object' || Array.isArray(v)) fail('day', 'object')
+      return v
+    })
+    const limitCodec = codecOf(v => {
+      if (!Number.isFinite(Number(v))) fail('limit', 'number')
+      return Number(v)
+    })
+    const topSessionsCodec = codecOf(v => {
+      if (v === null || typeof v !== 'object' || Array.isArray(v)) fail('topSessions', 'object')
+      return v
+    })
 
     // ── RPC 贡献(与服务端 ./typert 清单一一对应) ───────────────────────────
 
@@ -1175,6 +1229,18 @@ window.__ModuleLoader__.load({
           invocation: { kind: 'direct' }, parameters: [],
           result: { mode: 'strict', typeSymbol: 'dsh-cost-meter#CostState', schema: stateCodec },
         },
+        {
+          id: 'dsh-cost-meter#costMeter/getDaySessions', service: 'costMeter', namespace: 'costMeter', method: 'getDaySessions',
+          invocation: { kind: 'direct' },
+          parameters: [{ name: 'date', wire: 'date', source: 'json', codec: { mode: 'strict', typeSymbol: 'dsh-cost-meter#DayKey', schema: dateCodec } }],
+          result: { mode: 'strict', typeSymbol: 'dsh-cost-meter#DayRecord', schema: dayCodec },
+        },
+        {
+          id: 'dsh-cost-meter#costMeter/getTopSessions', service: 'costMeter', namespace: 'costMeter', method: 'getTopSessions',
+          invocation: { kind: 'direct' },
+          parameters: [{ name: 'limit', wire: 'limit', source: 'json', codec: { mode: 'strict', typeSymbol: 'dsh-cost-meter#SessionLimit', schema: limitCodec } }],
+          result: { mode: 'strict', typeSymbol: 'dsh-cost-meter#TopSessions', schema: topSessionsCodec },
+        },
       ],
     }
 
@@ -2027,6 +2093,86 @@ window.__ModuleLoader__.load({
           wide ? view.body : el('div', { className: 'cm-bbox-rail cm-num' }, view.rail)))
     }
 
+    /** MiniMax Token Plan:percent 为已用%,界面按余量(100-已用)展示。 */
+    function miniMaxRemainPct(win) {
+      if (win === null || typeof win !== 'object' || typeof win.percent !== 'number') return null
+      return Math.max(0, Math.min(100, 100 - Number(win.percent)))
+    }
+
+    function miniMaxWindowsOf(windows) {
+      const map = windows !== null && typeof windows === 'object' ? windows : {}
+      return {
+        five: map['5h'] ?? null,
+        seven: map['7d'] ?? map.week ?? map.weekly ?? null,
+      }
+    }
+
+    function miniMaxRemainLevel(remain) {
+      if (remain === null) return 'ok'
+      if (remain <= 0) return 'over'
+      if (remain <= 20) return 'warn'
+      return 'ok'
+    }
+
+    function miniMaxResetText(win, t) {
+      if (!win || typeof win.resetsAt !== 'string' || win.resetsAt.length === 0) return ''
+      return t('goResetAt', { time: new Date(win.resetsAt).toLocaleString() })
+    }
+
+    function miniMaxRow(label, win) {
+      const remain = miniMaxRemainPct(win)
+      const pct = remain === null ? 0 : remain
+      const level = miniMaxRemainLevel(remain)
+      return {
+        level,
+        remain,
+        row: el('div', { className: 'cm-mm-row' + (level === 'ok' ? '' : ' ' + level) },
+          el('span', { className: 'cm-bbox-label' }, label),
+          el('div', { className: 'cm-bbox-bar' },
+            el('div', { className: 'cm-bbox-fill', style: { width: Math.min(100, pct) + '%' } })),
+          el('span', { className: 'cm-bbox-pct cm-num' }, remain === null ? '—' : Math.round(pct) + '%')),
+      }
+    }
+
+    function MiniMaxPlanCard(props) {
+      const { five, seven, fetchedAt, t, wide } = props
+      const fiveView = miniMaxRow(t('codingPlanRemain5h'), five)
+      const sevenView = miniMaxRow(t('codingPlanRemain7d'), seven)
+      const level = fiveView.level === 'over' || sevenView.level === 'over' ? 'over'
+        : fiveView.level === 'warn' || sevenView.level === 'warn' ? 'warn' : 'ok'
+      const lineOf = (label, win, view) => {
+        const pct = view.remain === null ? '—' : Math.round(view.remain) + '%'
+        const reset = miniMaxResetText(win, t)
+        return label + ' ' + pct + (reset ? ' · ' + reset : '')
+      }
+      const detail = [
+        t('codingPlanMinimaxTitle'),
+        lineOf(t('codingPlanRemain5h'), five, fiveView),
+        lineOf(t('codingPlanRemain7d'), seven, sevenView),
+        fetchedAt > 0 ? t('goQuotaFetchedAt', { time: new Date(fetchedAt).toLocaleTimeString() }) : null,
+      ].filter(Boolean).join('; ')
+      const body = el(Fragment, null,
+        el('div', { className: 'cm-mm-title' }, t('codingPlanMinimaxTitle')),
+        fiveView.row,
+        sevenView.row)
+      const rail = el(Fragment, null,
+        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' : '') },
+          wide === false ? rail : body))
+    }
+
+    function MiniMaxPlanBox(props) {
+      const { state, wide } = props
+      const live = state.codingPlans?.minimax
+      const t = makeT(resolveLocale(state.config?.locale))
+      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 })
+    }
+
     function BudgetBoxContent(props) {
       const { state, wide } = props
       const today = state.today
@@ -2140,14 +2286,20 @@ window.__ModuleLoader__.load({
       const goOk = (config.goQuota?.enabled !== false)
         && (config.goQuota?.display === 'sidebar' || config.goQuota?.display === 'both')
         && state.goQuota?.status === 'ok' && state.goQuota?.[goMainKey] !== null
+      const mmLive = state.codingPlans?.minimax
+      const mmWins = miniMaxWindowsOf(mmLive?.windows)
+      const mmOk = config.codingPlans?.minimax?.enabled === true
+        && mmLive?.status === 'ok'
+        && (mmWins.five != null || mmWins.seven != null)
       const budgetOn = (config.budget ?? {}).enabled === true
       const showToday = config.sidebar !== false
-      if (!showBalance && !showCustomBalance && !goOk && !budgetOn && !showToday) return null
+      if (!showBalance && !showCustomBalance && !goOk && !mmOk && !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 (mmOk) nodes.push(el(MiniMaxPlanBox, { state, wide }))
       if (goOk && budgetOn && wide) {
         // 同时出现:合并为一张卡片(Go 在上、预算在下,细分隔线),各自保留预警色与自己的详细信息开关。
         const goView = goBoxBody(state, config, t)
@@ -2179,23 +2331,123 @@ window.__ModuleLoader__.load({
     }
 
     function HistoryTable(props) {
-      const { state } = props
+      const { state, api } = props
       const t = makeT(resolveLocale(state.config?.locale))
+      // 点击日期行展开当日会话明细(issue #22):按需经 getDaySessions 拉取并缓存。
+      const [openDate, setOpenDate] = useState(null)
+      const [cache, setCache] = useState({})
+      const [busyDate, setBusyDate] = useState(null)
       const rows = state.history ?? []
       if (rows.length === 0) return el('p', { className: 'cm-empty' }, t('noHistory'))
+      const toggle = date => {
+        if (openDate === date) { setOpenDate(null); return }
+        setOpenDate(date)
+        if (cache[date] !== undefined || busyDate !== null) return
+        setBusyDate(date)
+        api.getDaySessions(date)
+          .then(day => setCache(c => ({ ...c, [date]: Array.isArray(day?.sessions) ? day.sessions : [] })))
+          .catch(() => setCache(c => ({ ...c, [date]: 'error' })))
+          .finally(() => setBusyDate(null))
+      }
+      const sessionRows = sessions => sessions.map(session => el('tr', { key: session.id },
+        el('td', null, session.id.slice(0, 14) + '…'),
+        el('td', { className: 'num' }, String(session.calls)),
+        el('td', { className: 'num' }, formatTokens(session.input)),
+        el('td', { className: 'num' }, formatTokens(session.cacheRead + session.cacheWrite)),
+        el('td', { className: 'num' }, formatTokens(session.output)),
+        el('td', { className: 'num' }, formatMoneyUsd(session.cost, state.config))))
       return el('div', { className: 'cm-scroll' },
+        el('p', { className: 'cm-hint', style: { padding: '6px 10px 0' } }, t('historyExpandHint')),
         el('table', { className: 'cm-table' },
           el('thead', null, el('tr', null,
             el('th', null, t('colDate')), el('th', { className: 'num' }, t('colCalls')),
             el('th', { className: 'num' }, t('colInTok')), el('th', { className: 'num' }, t('colCacheTok')), el('th', { className: 'num' }, t('colOutTok')),
             el('th', { className: 'num' }, t('colCost')))),
-          el('tbody', null, rows.map(day => el('tr', { key: day.date },
-            el('td', null, day.date),
-            el('td', { className: 'num' }, String(day.calls)),
-            el('td', { className: 'num' }, formatTokens(day.input)),
-            el('td', { className: 'num' }, formatTokens(day.cacheRead + day.cacheWrite)),
-            el('td', { className: 'num' }, formatTokens(day.output)),
-            el('td', { className: 'num' }, formatMoneyUsd(day.cost, state.config)))))))
+          el('tbody', null, rows.flatMap(day => {
+            const base = el('tr', { key: day.date, className: 'cm-row-click', onClick: () => toggle(day.date) },
+              el('td', null, (openDate === day.date ? '▾ ' : '▸ ') + day.date),
+              el('td', { className: 'num' }, String(day.calls)),
+              el('td', { className: 'num' }, formatTokens(day.input)),
+              el('td', { className: 'num' }, formatTokens(day.cacheRead + day.cacheWrite)),
+              el('td', { className: 'num' }, formatTokens(day.output)),
+              el('td', { className: 'num' }, formatMoneyUsd(day.cost, state.config)))
+            if (openDate !== day.date) return [base]
+            const cached = cache[day.date]
+            const detail = busyDate === day.date && cached === undefined
+              ? el('p', { className: 'cm-empty' }, t('historySessionsLoading'))
+              : cached === 'error'
+                ? el('p', { className: 'cm-empty' }, t('historySessionsError'))
+                : !Array.isArray(cached) || cached.length === 0
+                  ? el('p', { className: 'cm-empty' }, t('historyNoSessions'))
+                  : el('table', { className: 'cm-table' },
+                    el('thead', null, el('tr', null,
+                      el('th', null, t('colSession')), el('th', { className: 'num' }, t('colCalls')),
+                      el('th', { className: 'num' }, t('colInTok')), el('th', { className: 'num' }, t('colCacheTok')), el('th', { className: 'num' }, t('colOutTok')),
+                      el('th', { className: 'num' }, t('colCost')))),
+                    el('tbody', null, sessionRows(cached)))
+            return [base, el('tr', { key: day.date + '-sessions' }, el('td', { colSpan: 6 }, detail))]
+          }))))
+    }
+
+    // 按会话统计(issue #22 不分日期视角):全部历史会话按费用降序,默认收起、展开时按需拉取。
+    function SessionRankPanel(props) {
+      const { state, api } = props
+      const t = makeT(resolveLocale(state.config?.locale))
+      const [open, setOpen] = useState(false)
+      const [limit, setLimit] = useState(100)
+      const [rows, setRows] = useState(null)
+      const [busy, setBusy] = useState(false)
+      const [err, setErr] = useState(false)
+      const load = n => {
+        setBusy(true)
+        setErr(false)
+        api.getTopSessions(n)
+          .then(res => setRows(Array.isArray(res?.sessions) ? res.sessions : []))
+          .catch(() => setErr(true))
+          .finally(() => setBusy(false))
+      }
+      const toggle = () => {
+        setOpen(o => {
+          const next = !o
+          if (next && rows === null && !busy) load(limit)
+          return next
+        })
+      }
+      const changeLimit = n => {
+        setLimit(n)
+        if (open || rows !== null) load(n)
+      }
+      return el('div', { className: 'cm-budget' },
+        el('div', { className: 'cm-budget-head' },
+          el('button', { type: 'button', className: 'cm-collapse-h', 'aria-expanded': String(open), onClick: toggle },
+            el('span', { className: 'cm-caret' + (open ? ' open' : '') }),
+            el('h3', { className: 'cm-h' }, t('sessionRankTitle')))),
+        open ? el('div', { className: 'cm-collapse-body' },
+          el('p', { className: 'cm-hint' }, t('sessionRankHint')),
+          el('div', { className: 'cm-field', style: { margin: '6px 0' } },
+            el('label', null, t('sessionRankLimit')),
+            el('select', { className: 'cm-input', value: String(limit), onChange: event => changeLimit(Number(event.target.value)) },
+              el('option', { value: '50' }, '50'),
+              el('option', { value: '100' }, '100'),
+              el('option', { value: '200' }, '200'))),
+          busy ? el('p', { className: 'cm-empty' }, t('sessionRankLoading'))
+            : err ? el('p', { className: 'cm-empty' }, t('sessionRankError'))
+              : rows === null || rows.length === 0 ? el('p', { className: 'cm-empty' }, t('sessionRankEmpty'))
+                : el('div', { className: 'cm-scroll' },
+                  el('table', { className: 'cm-table' },
+                    el('thead', null, el('tr', null,
+                      el('th', null, t('colDate')), el('th', null, t('colSession')), el('th', { className: 'num' }, t('colCalls')),
+                      el('th', { className: 'num' }, t('colInTok')), el('th', { className: 'num' }, t('colCacheTok')), el('th', { className: 'num' }, t('colOutTok')),
+                      el('th', { className: 'num' }, t('colCost')))),
+                    el('tbody', null, rows.map(session => el('tr', { key: session.date + ':' + session.id },
+                      el('td', null, session.date),
+                      el('td', null, String(session.id).slice(0, 14) + '…'),
+                      el('td', { className: 'num' }, String(session.calls)),
+                      el('td', { className: 'num' }, formatTokens(session.input)),
+                      el('td', { className: 'num' }, formatTokens((session.cacheRead ?? 0) + (session.cacheWrite ?? 0))),
+                      el('td', { className: 'num' }, formatTokens(session.output)),
+                      el('td', { className: 'num' }, formatMoneyUsd(session.cost, state.config))))))))
+          : null)
     }
 
     function TodaySessions(props) {
@@ -3151,7 +3403,15 @@ window.__ModuleLoader__.load({
           : live.status === 'ok'
             ? el('div', { className: 'cm-go-list' },
               Object.keys(windows).length > 0
-                ? Object.entries(windows).map(([name, win]) => windowRow(name, win))
+                ? (id === 'minimax' && (miniMaxWindowsOf(windows).five != null || miniMaxWindowsOf(windows).seven != null)
+                  ? el(MiniMaxPlanCard, {
+                    five: miniMaxWindowsOf(windows).five,
+                    seven: miniMaxWindowsOf(windows).seven,
+                    fetchedAt: live.fetchedAt,
+                    t,
+                    wide: true,
+                  })
+                  : Object.entries(windows).map(([name, win]) => windowRow(name, win)))
                 : el('div', { className: 'cm-bal-line' }, t('codingPlanNotQueried')),
               el('div', { className: 'cm-go-time' }, t('goQuotaFetchedAt', {
                 time: live.fetchedAt > 0 ? new Date(live.fetchedAt).toLocaleTimeString() : '—',
@@ -3479,7 +3739,9 @@ window.__ModuleLoader__.load({
         // 历史
         el('div', null,
           el('h3', { className: 'cm-h' }, t('history')),
-          el(HistoryTable, { state, t })),
+          el(HistoryTable, { state, api })),
+        // 按会话统计(全部历史,不分日期;issue #22)
+        el(SessionRankPanel, { state, api }),
         // 显示设置
         el('div', null,
           el('h3', { className: 'cm-h' }, t('displaySettings')),
@@ -3895,6 +4157,10 @@ window.__ModuleLoader__.load({
           store.set({ status: 'ready', error: null, state })
           return state
         },
+        // 按需拉取某天会话明细(issue #22),返回当日完整记录。
+        getDaySessions: async date => call('getDaySessions', [date]),
+        // 跨全部日期按费用降序的会话排行(issue #22 不分日期视角)。
+        getTopSessions: async limit => call('getTopSessions', [limit]),
         refreshBalance: async () => {
           const result = await costMeter.refreshBalance()
           if (result === null || typeof result !== 'object' || result.ok !== true) {

package/lib/coding-plans.js

@@ -143,48 +143,92 @@ export function parseZaiUsage(data) {
   return Object.keys(windows).length > 0 ? windows : null
 }
 
+/** 0-100 已用百分比,保留 1 位。 */
+function clampPct(p) {
+  return Math.max(0, Math.min(100, Math.round(p * 10) / 10))
+}
+
 /**
- * 解析 MiniMax 用量响应。兼容三种官方形态:
- *  - Token Plan(2026-08 现行,issue #20):GET https://www.minimaxi.com|io/v1/token_plan/remains
- *    平铺结构——根节点(或 data.data)直接含 current_interval_*(5小时固定窗)与
- *    current_weekly_*(周窗)字段,无窗口数组;status=3 表示不限量,不展示该窗;
- *  - Token Plan(旧数组形态):窗口数组字段,条目含 total/used/remain 与 interval 标签;
- *  - Coding Plan(旧计数制):GET .../v1/api/openplatform/coding_plan/remains
- *    { model_remains: [{ current_interval_total_count, current_interval_usage_count, ... }] }。
+ * MiniMax 窗口剩余百分比。优先 *_remaining_percent(现行 Token Plan,total 常为 0);
+ * 否则用 total/remain 或 total/used 反推。非法 → null。
  */
-export function parseMiniMaxRemains(data) {
-  if (data === null || typeof data !== 'object') return null
-  const windows = {}
-  const payload = data.data !== null && typeof data.data === 'object' && !Array.isArray(data.data) ? data.data : data
-  // 平铺窗口字段(现行形态,issue #20):优先计数推导,其次剩余百分比反推。
-  const clampPct = p => Math.max(0, Math.min(100, Math.round(p * 10) / 10))
-  const usedPercentOf = (totalKey, usedKey, remainKey, remainPctKey) => {
-    const total = Number(payload[totalKey])
-    const used = Number(payload[usedKey])
-    const remain = Number(payload[remainKey])
-    if (Number.isFinite(total) && total > 0) {
-      if (Number.isFinite(used)) return (used / total) * 100
-      if (Number.isFinite(remain)) return ((total - remain) / total) * 100
-    }
-    // *_remaining_percent 是剩余百分比(<=1 视为比例),反推已用。
-    const rp = Number(payload[remainPctKey])
-    if (Number.isFinite(rp)) return 100 - Math.min(100, Math.max(0, rp <= 1 ? rp * 100 : rp))
-    return null
+function remainingPercentOf(row, remainPctKey, totalKey, usedKey, remainKey) {
+  if (row === null || typeof row !== 'object') return null
+  const rp = Number(row[remainPctKey])
+  if (Number.isFinite(rp)) return Math.min(100, Math.max(0, rp <= 1 ? rp * 100 : rp))
+  const total = Number(row[totalKey])
+  const used = Number(row[usedKey])
+  const remain = Number(row[remainKey])
+  if (Number.isFinite(total) && total > 0) {
+    if (Number.isFinite(remain)) return (remain / total) * 100
+    if (Number.isFinite(used)) return ((total - used) / total) * 100
   }
-  // status=3 = 不限量:进度条无意义,跳过该窗(与 OpenClaw 同策略)。
-  if (Number(payload.current_interval_status) !== 3) {
-    const intervalPct = usedPercentOf('current_interval_total_count', 'current_interval_usage_count', 'current_interval_remain_count', 'current_interval_remaining_percent')
-    if (intervalPct !== null) {
-      windows['5h'] = { percent: clampPct(intervalPct), resetsAt: normalizeResetAt(payload.end_time ?? payload.reset_time ?? payload.next_reset_time) }
+  return null
+}
+
+/**
+ * 从单条 MiniMax 记录抽出 5h / 7d 窗口。percent 存已用%(与其它厂商一致);
+ * status=3 表示不限量,跳过该窗。
+ */
+function windowsFromMiniMaxRecord(row) {
+  if (row === null || typeof row !== 'object') return {}
+  const windows = {}
+  if (Number(row.current_interval_status) !== 3) {
+    const remain = remainingPercentOf(
+      row,
+      'current_interval_remaining_percent',
+      'current_interval_total_count',
+      'current_interval_usage_count',
+      'current_interval_remain_count',
+    )
+    if (remain !== null) {
+      windows['5h'] = {
+        percent: clampPct(100 - remain),
+        resetsAt: normalizeResetAt(row.end_time ?? row.reset_time ?? row.next_reset_time),
+      }
     }
   }
-  if (Number(payload.current_weekly_status) !== 3) {
-    const weeklyPct = usedPercentOf('current_weekly_total_count', 'current_weekly_usage_count', 'current_weekly_remain_count', 'current_weekly_remaining_percent')
-    if (weeklyPct !== null) {
-      windows.week = { percent: clampPct(weeklyPct), resetsAt: normalizeResetAt(payload.weekly_end_time) }
+  if (Number(row.current_weekly_status) !== 3) {
+    const remain = remainingPercentOf(
+      row,
+      'current_weekly_remaining_percent',
+      'current_weekly_total_count',
+      'current_weekly_usage_count',
+      'current_weekly_remain_count',
+    )
+    if (remain !== null) {
+      windows['7d'] = {
+        percent: clampPct(100 - remain),
+        resetsAt: normalizeResetAt(row.weekly_end_time),
+      }
     }
   }
-  if (Object.keys(windows).length > 0) return windows
+  return windows
+}
+
+/** 选 chat/通用额度行:general → MiniMax-M* → 第一条能解析出窗口的记录。跳过仅 video/speech 的无限量行。 */
+function pickMiniMaxModelRow(rows) {
+  const list = rows.filter(row => row !== null && typeof row === 'object')
+  const byName = name => list.find(row => String(row.model_name ?? '').toLowerCase() === name)
+  return byName('general')
+    ?? list.find(row => /^minimax-m/i.test(String(row.model_name ?? '')))
+    ?? list.find(row => Object.keys(windowsFromMiniMaxRecord(row)).length > 0)
+    ?? list[0]
+    ?? null
+}
+
+/**
+ * 解析 MiniMax 用量响应。兼容四种官方形态:
+ *  - Token Plan(2026-08 现行,model_remains):GET https://www.minimaxi.com|io/v1/token_plan/remains
+ *    { model_remains: [{ model_name, current_interval_remaining_percent, current_weekly_remaining_percent, ... }] }
+ *    total_count 常为 0,以 remaining_percent 为准;取 general(或 MiniMax-M*)一行抽出 5h/7d,不按模型拆条;
+ *  - Token Plan 平铺结构(issue #20):根节点(或 data.data)直含 current_interval_* 与 current_weekly_*;
+ *  - Token Plan 旧数组形态:窗口数组字段,条目含 total/used/remain 与 interval 标签;
+ *  - Coding Plan 旧计数制:model_remains 仅有 total/used、无 remaining_percent 时汇总。
+ */
+export function parseMiniMaxRemains(data) {
+  if (data === null || typeof data !== 'object') return null
+  const payload = data.data !== null && typeof data.data === 'object' && !Array.isArray(data.data) ? data.data : data
   const pickArray = (...keys) => {
     for (const key of keys) {
       const direct = Array.isArray(data?.[key]) ? data[key] : null
@@ -194,7 +238,36 @@ export function parseMiniMaxRemains(data) {
     }
     return null
   }
+
+  // 现行 Token Plan:model_remains + remaining_percent(total 可为 0)。优先于平铺,避免根对象空字段误判。
+  const modelRows = pickArray('model_remains')
+  if (modelRows !== null) {
+    const row = pickMiniMaxModelRow(modelRows)
+    const fromRow = windowsFromMiniMaxRecord(row)
+    if (Object.keys(fromRow).length > 0) return fromRow
+    // 旧计数制:无 remaining_percent、靠 total>0 汇总(忽略零额度行)。
+    let total = 0
+    let used = 0
+    let found = false
+    for (const item of modelRows) {
+      if (item === null || typeof item !== 'object') continue
+      const t = Number(item.current_interval_total_count ?? item.total)
+      const u = Number(item.current_interval_usage_count ?? item.used)
+      if (!Number.isFinite(t) || t <= 0) continue
+      found = true
+      total += t
+      used += Number.isFinite(u) ? u : 0
+    }
+    if (found && total > 0) {
+      return { current: { percent: Math.min(100, Math.round((used / total) * 1000) / 10), resetsAt: '' } }
+    }
+  }
+
+  const flat = windowsFromMiniMaxRecord(payload)
+  if (Object.keys(flat).length > 0) return flat
+
   // Token Plan:窗口数组(字段名容错)。
+  const windows = {}
   const planRows = pickArray('token_plan_remains', 'plan_remains', 'remains', 'windows')
   if (planRows !== null) {
     planRows.forEach((row, index) => {
@@ -215,28 +288,6 @@ export function parseMiniMaxRemains(data) {
       }
     })
   }
-  // 旧 Coding Plan 计数制:model_remains。
-  const modelRows = pickArray('model_remains')
-  if (modelRows !== null) {
-    let total = 0
-    let used = 0
-    let found = false
-    for (const row of modelRows) {
-      if (row === null || typeof row !== 'object') continue
-      const t = Number(row.current_interval_total_count ?? row.total)
-      const u = Number(row.current_interval_usage_count ?? row.used)
-      if (!Number.isFinite(t) || t <= 0) continue
-      found = true
-      total += t
-      used += Number.isFinite(u) ? u : 0
-    }
-    if (found && total > 0) {
-      windows.current = {
-        percent: Math.min(100, Math.round((used / total) * 1000) / 10),
-        resetsAt: '',
-      }
-    }
-  }
   return Object.keys(windows).length > 0 ? windows : null
 }
 

package/lib/index.js

@@ -18,7 +18,7 @@ import fs from 'node:fs'
 import { join } from 'node:path'
 import { credentialRef } from '@deepseek-ai/dsh-credentials'
 import { resolveDshHome } from '@deepseek-ai/dsh-home-paths'
-import { Ledger, applyConfigPatch, localDayKey, reconcileBalanceDelta } from './store.js'
+import { Ledger, applyConfigPatch, localDayKey, reconcileBalanceDelta, zeroDay } from './store.js'
 import { backfillLegacyLedger } from './backfill.js'
 import { OFFICIAL_PRICING_URL, normalizePrice, parsePricingHtml, costOf, priceEntryFor, providerPriceEntryFor, buildPriceCatalog } from './pricing.js'
 import { CODING_PLAN_PROVIDERS, CODING_PLAN_PROVIDER_IDS, queryCodingPlan, emptyCustomBalance, queryCustomBalance } from './coding-plans.js'
@@ -898,6 +898,42 @@ function createService(ctx, ledger) {
       ledger.scheduleWrite()
       return build(false)
     },
+
+    // 按需读取某一天的完整记录(含会话明细;issue #22):history() 输出为轻量副本
+    // 不含会话,历史各天的会话明细由本 RPC 展开时才拉取,避免 state 膨胀。
+    async getDaySessions(date) {
+      if (typeof date !== 'string' || !/^\d{4}-\d{2}-\d{2}$/.test(date)) {
+        throw new Error('invalid date')
+      }
+      const day = ledger.days[date]
+      return day === undefined ? zeroDay(date) : ledger.copyDay(day)
+    },
+
+    // 跨全部日期按费用降序返回前 N 个会话(issue #22 按会话视角,不分日期)。
+    async getTopSessions(limit) {
+      const n = Math.max(1, Math.min(500, Math.floor(Number(limit)) || 100))
+      const all = []
+      for (const [date, day] of Object.entries(ledger.days)) {
+        if (!Array.isArray(day.sessions)) continue
+        for (const s of day.sessions) {
+          if (s === null || typeof s !== 'object') continue
+          all.push({
+            date,
+            id: String(s.id ?? ''),
+            input: s.input ?? 0,
+            output: s.output ?? 0,
+            cacheRead: s.cacheRead ?? 0,
+            cacheWrite: s.cacheWrite ?? 0,
+            reasoning: s.reasoning ?? 0,
+            calls: s.calls ?? 0,
+            cost: s.cost ?? 0,
+            byProviderModel: s.byProviderModel ?? {},
+          })
+        }
+      }
+      all.sort((a, b) => b.cost - a.cost)
+      return { sessions: all.slice(0, n) }
+    },
   }
   Object.defineProperty(service, 'typertRemote', {
     configurable: false,

package/lib/store.js

@@ -125,7 +125,7 @@ export function localDayKey(ms) {
   return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`
 }
 
-function zeroDay(date) {
+export function zeroDay(date) {
   return { date, input: 0, output: 0, cacheRead: 0, cacheWrite: 0, reasoning: 0, calls: 0, cost: 0, byProviderModel: {}, sessions: [] }
 }
 

package/lib/typert.host.js

@@ -33,6 +33,13 @@ const daySchema = z.object({
   sessions: z.array(sessionSchema),
 })
 
+// 带所属日期的会话条目(issue #22 按会话排行:不分日期视角)。
+const datedSessionSchema = sessionSchema.extend({ date: z.string() })
+
+const topSessionsSchema = z.object({
+  sessions: z.array(datedSessionSchema),
+})
+
 const priceTierSchema = z.object({
   cacheHit: num,
   cacheMiss: num,
@@ -241,6 +248,10 @@ const _state$codec = { mode: 'strict', typeSymbol: 'dsh-cost-meter#CostState', s
 const _patch$codec = { mode: 'strict', typeSymbol: 'dsh-cost-meter#ConfigPatch', schema: patchSchema }
 const _fetch$codec = { mode: 'strict', typeSymbol: 'dsh-cost-meter#FetchPricesResult', schema: fetchPricesSchema }
 const _provider$codec = { mode: 'strict', typeSymbol: 'dsh-cost-meter#CodingPlanProvider', schema: z.string() }
+const _day$codec = { mode: 'strict', typeSymbol: 'dsh-cost-meter#DayRecord', schema: daySchema }
+const _date$codec = { mode: 'strict', typeSymbol: 'dsh-cost-meter#DayKey', schema: z.string() }
+const _topSessions$codec = { mode: 'strict', typeSymbol: 'dsh-cost-meter#TopSessions', schema: topSessionsSchema }
+const _limit$codec = { mode: 'strict', typeSymbol: 'dsh-cost-meter#SessionLimit', schema: num }
 
 export const TYPERT = {
   package: 'dsh-cost-meter',
@@ -323,6 +334,28 @@ export const TYPERT = {
       parameters: [],
       result: _state$codec,
     },
+    {
+      id: 'dsh-cost-meter#costMeter/getDaySessions',
+      service: 'costMeter',
+      namespace: 'costMeter',
+      method: 'getDaySessions',
+      invocation: { kind: 'direct' },
+      parameters: [
+        { name: 'date', wire: 'date', source: 'json', codec: _date$codec },
+      ],
+      result: _day$codec,
+    },
+    {
+      id: 'dsh-cost-meter#costMeter/getTopSessions',
+      service: 'costMeter',
+      namespace: 'costMeter',
+      method: 'getTopSessions',
+      invocation: { kind: 'direct' },
+      parameters: [
+        { name: 'limit', wire: 'limit', source: 'json', codec: _limit$codec },
+      ],
+      result: _topSessions$codec,
+    },
   ],
   model: {
     services: [
@@ -390,6 +423,20 @@ export const TYPERT = {
             summary: '清空全部历史记录。Clear all history records.',
             jsDoc: '/**\n * 清空全部历史记录。\n * @returns 清空后的完整快照。\n * Clear all history records.\n * @returns The full snapshot after clearing.\n */',
           },
+          {
+            kind: 'method',
+            name: 'getDaySessions',
+            signature: 'getDaySessions(date: string): DayRecord',
+            summary: '按需读取某一天的完整记录(含会话明细)。Read a day\'s full record on demand (with session details).',
+            jsDoc: '/**\n * 按需读取某一天的完整记录(含会话明细;历史记录列表为轻量副本不含会话)。\n * @param date - 本地日期键 YYYY-MM-DD。\n * @returns 该日完整记录;不存在时返回零值记录。\n * Read a day\'s full record on demand (with session details; the history list is a light copy without sessions).\n * @param date - Local day key YYYY-MM-DD.\n * @returns The full day record; a zero record when absent.\n */',
+          },
+          {
+            kind: 'method',
+            name: 'getTopSessions',
+            signature: 'getTopSessions(limit: number): TopSessions',
+            summary: '跨全部日期按费用降序返回前 N 个会话(不分日期视角)。Return the top N sessions by cost across all days.',
+            jsDoc: '/**\n * 跨全部日期按费用降序返回前 N 个会话(每条带所属日期;不含今日实时条目之外的去重)。\n * @param limit - 返回条数上限(服务端限制 1-500)。\n * @returns 会话列表(含 date 字段)。\n * Return the top N sessions by cost across all days (each tagged with its date).\n * @param limit - Max rows to return (server clamps to 1-500).\n * @returns Session list with a date field.\n */',
+          },
         ],
         types: [],
       },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-cost-meter",
-  "version": "1.5.6",
+  "version": "1.5.8",
   "description": "DeepSeek Harness 会话费用统计插件:本会话成本、当日费用、历史记录与官方价格同步,支持多厂商多模型价格计费(内置 90+ 模型价格目录与自动匹配)、主流 Coding Plan 订阅额度查询与显示(6 家)、自定义 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 6 vendors, custom provider balance lookup (configurable HTTP endpoint) and balance progress bar, in a bilingual (Chinese/English) UI.",
   "type": "module",
   "main": "lib/index.js",