dsh-cost-meter 1.5.8 → 1.5.10

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) · 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.8-4176E6)](https://github.com/Han-1413141/dsh-cost-meter)
+[![version](https://img.shields.io/badge/version-1.5.10-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)
@@ -191,22 +191,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.8`** — 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.10`** — review the script before running):
 
 ```powershell
-irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.5.8/install.ps1 | iex
+irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.5.10/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.8
+dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.5.10
 ```
 
 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.8.tar.gz
+dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.5.10.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 六家)
 
-[![version](https://img.shields.io/badge/version-1.5.8-4176E6)](https://github.com/Han-1413141/dsh-cost-meter)
+[![version](https://img.shields.io/badge/version-1.5.10-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)
@@ -193,22 +193,22 @@
 dsh plugin --profile web add dsh-cost-meter
 ```
 
-**PowerShell 一键脚本**(复制整行粘贴回车;自动补齐 pnpm、自动探测 git,无需克隆仓库;安装链**固定到发布 tag `v1.5.8`**,建议先下载审阅再运行):
+**PowerShell 一键脚本**(复制整行粘贴回车;自动补齐 pnpm、自动探测 git,无需克隆仓库;安装链**固定到发布 tag `v1.5.10`**,建议先下载审阅再运行):
 
 ```powershell
-irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.5.8/install.ps1 | iex
+irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.5.10/install.ps1 | iex
 ```
 
 **或直接命令行**(机器上需已有 pnpm 与 git;同样固定到 tag):
 
 ```sh
-dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.5.8
+dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.5.10
 ```
 
 没有 git 时可用 GitHub tag 打包直链:
 
 ```sh
-dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.5.8.tar.gz
+dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.5.10.tar.gz
 ```
 
 安装后**重启** `dsh web`(插件行、Typert 清单与客户端 bundle 均在启动时扫描):

package/lib/backfill.js

@@ -141,7 +141,7 @@ export function listSessionLogs(root) {
  * @param records - readSessionRecords 的输出。
  * @param config - 账本配置(prices / peak* / priceMatch / priceOverrides)。
  * @param wantDates - 只统计这些日期键(YYYY-MM-DD)内的调用;null = 全部。
- * @returns { sessionId, days: { date: { providerKey: 桶 } } }。
+ * @returns { sessionId, title, createdAt, days: { date: { providerKey: 桶 } } }。
  */
 export function replaySessionRecords(records, config, wantDates = null) {
   const zeroBuckets = () => ({ input: 0, output: 0, cacheRead: 0, cacheWrite: 0, reasoning: 0, calls: 0, cost: 0 })
@@ -150,6 +150,8 @@ export function replaySessionRecords(records, config, wantDates = null) {
     return Number.isFinite(n) && n > 0 ? n : 0
   }
   let sessionId = ''
+  let title = ''
+  let createdAt = 0
   let provider = 'deepseek'
   let model = 'default'
   let last = null
@@ -171,6 +173,14 @@ export function replaySessionRecords(records, config, wantDates = null) {
     if (event === null || typeof event !== 'object') continue
     if (event.type === 'session' && typeof event.id === 'string') {
       sessionId = event.id
+      const created = Number(event.createdAt)
+      if (Number.isFinite(created) && created > 0) createdAt = created
+      continue
+    }
+    // 会话标题(宿主生成的 session/title 事件;同名多次时取最后一次)。
+    if (event.type === 'session/title') {
+      const nextTitle = event.data?.title
+      if (typeof nextTitle === 'string' && nextTitle.trim().length > 0) title = nextTitle.trim()
       continue
     }
     if (PACKED_ROW_TYPES.has(event.type)) continue
@@ -231,7 +241,7 @@ export function replaySessionRecords(records, config, wantDates = null) {
     shift(sample, 1)
     last = sample
   }
-  return { sessionId, days }
+  return { sessionId, title, createdAt, days }
 }
 
 /**
@@ -241,10 +251,10 @@ export function replaySessionRecords(records, config, wantDates = null) {
  *    写入该会话当日的回放拆分。
  * @param ledger - 已打开的账本。
  * @param sessionsRoot - 宿主会话根目录($DSH_HOME/sessions)。
- * @returns { days, sessions, scanned } 实际填补的日期/会话数与扫描文件数。
+ * @returns { days, sessions, scanned, titles } 实际填补的日期/会话数、扫描文件数与补齐的会话标题数。
  */
 export async function backfillLegacyLedger(ledger, sessionsRoot) {
-  const result = { days: 0, sessions: 0, scanned: 0 }
+  const result = { days: 0, sessions: 0, scanned: 0, titles: 0 }
   const needDates = new Set()
   for (const [date, day] of Object.entries(ledger.days ?? {})) {
     if ((day?.calls ?? 0) > 0 && Object.keys(day?.byProviderModel ?? {}).length === 0) needDates.add(date)
@@ -260,8 +270,21 @@ export async function backfillLegacyLedger(ledger, sessionsRoot) {
       }
     }
   }
-  if (needDates.size === 0) return result
+  // 会话标题/时间戳补齐:任一字段缺失则需扫描(日志里的 session/title / createdAt 是权威来源)。
+  let needTitles = false
+  for (const day of Object.values(ledger.days ?? {})) {
+    for (const session of day?.sessions ?? []) {
+      if (typeof session?.title !== 'string' || session.title.length === 0 || !Number.isFinite(Number(session?.at))) {
+        needTitles = true
+        break
+      }
+    }
+    if (needTitles) break
+  }
+  if (needDates.size === 0 && !needTitles) return result
   const bySession = new Map()
+  const titles = new Map()
+  const createdAts = new Map()
   let scannedCount = 0
   for (const path of listSessionLogs(sessionsRoot)) {
     // 会话日志多时逐份解压会长时间占住事件循环:每 8 份让出一次,不卡宿主 UI。
@@ -269,11 +292,14 @@ export async function backfillLegacyLedger(ledger, sessionsRoot) {
     result.scanned += 1
     let replayed
     try {
-      replayed = replaySessionRecords(readSessionRecords(path), ledger.config, needDates)
+      replayed = replaySessionRecords(readSessionRecords(path), ledger.config, needDates.size > 0 ? needDates : new Set(['-']))
     } catch {
       continue // 单文件损坏不阻断整体回填。
     }
     if (replayed.sessionId.length === 0) continue
+    if (replayed.title.length > 0 && !titles.has(replayed.sessionId)) titles.set(replayed.sessionId, replayed.title)
+    if (replayed.createdAt > 0 && !createdAts.has(replayed.sessionId)) createdAts.set(replayed.sessionId, replayed.createdAt)
+    if (needDates.size === 0) continue
     const existing = bySession.get(replayed.sessionId)
     if (existing === undefined) bySession.set(replayed.sessionId, replayed.days)
     else mergeDayMaps(existing, replayed.days)
@@ -351,7 +377,26 @@ export async function backfillLegacyLedger(ledger, sessionsRoot) {
       }
     }
   }
-  if (result.days > 0 || result.sessions > 0) ledger.scheduleWrite()
+  // 会话标题/时间戳补齐:只填缺失字段,不覆盖已有(幂等;实时新建的会话下次启动补齐)。
+  if (titles.size > 0 || createdAts.size > 0) {
+    for (const day of Object.values(ledger.days ?? {})) {
+      for (const session of day?.sessions ?? []) {
+        if (session === null || typeof session !== 'object') continue
+        if ((typeof session.title !== 'string' || session.title.length === 0) && titles.size > 0) {
+          const found = titles.get(session.id)
+          if (found !== undefined) {
+            session.title = found
+            result.titles += 1
+          }
+        }
+        if (!Number.isFinite(Number(session.at)) && createdAts.size > 0) {
+          const foundAt = createdAts.get(session.id)
+          if (foundAt !== undefined) session.at = foundAt
+        }
+      }
+    }
+  }
+  if (result.days > 0 || result.sessions > 0 || result.titles > 0) ledger.scheduleWrite()
   return result
 }
 

package/lib/client.js

@@ -79,6 +79,9 @@ window.__ModuleLoader__.load({
       '.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))}',
+      // 会话单元格:标题为主行(超出省略),会话 ID 为辅行(可选显示,等宽淡化)。
+      '.cm-sess-title{max-width:260px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}',
+      '.cm-sess-id{font-size:11px;font-family:ui-monospace,Consolas,monospace;color:var(--dsw-alias-label-tertiary)}',
       '.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}',
@@ -488,11 +491,18 @@ window.__ModuleLoader__.load({
         historyNoSessions: '该日无会话明细(早期数据或会话日志已清理)',
         historySessionsError: '会话明细加载失败',
         sessionRankTitle: '按会话统计(全部历史)',
-        sessionRankHint: '不按日期分组,全部历史会话按费用降序',
+        sessionRankHint: '不按日期分组,全部历史会话;排序与条数可切换',
         sessionRankEmpty: '暂无会话数据',
         sessionRankLoading: '会话排行加载中…',
         sessionRankError: '会话排行加载失败',
         sessionRankLimit: '显示条数',
+        showSessionIdLabel: '会话列表附显会话 ID',
+        sessionRankSort: '排序',
+        sessionSortCostDesc: '费用 高→低',
+        sessionSortCostAsc: '费用 低→高',
+        sessionSortTimeDesc: '时间 新→旧',
+        sessionSortTimeAsc: '时间 旧→新',
+        sessionSortRecent: '实时顺序',
         history: '历史记录',
         usageTitle: 'Token 用量统计',
         usageTotal: '累计 {tokens} tokens · 输入 {input} · 缓存 {cache} · 输出 {output} · {calls} 次调用',
@@ -774,11 +784,18 @@ window.__ModuleLoader__.load({
         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',
+        sessionRankHint: 'All historical sessions, not grouped by date; sort and row count are switchable',
         sessionRankEmpty: 'No session data yet',
         sessionRankLoading: 'Loading session ranking…',
         sessionRankError: 'Failed to load session ranking',
         sessionRankLimit: 'Rows',
+        showSessionIdLabel: 'Show session IDs in session lists',
+        sessionRankSort: 'Sort',
+        sessionSortCostDesc: 'Cost high→low',
+        sessionSortCostAsc: 'Cost low→high',
+        sessionSortTimeDesc: 'Time new→old',
+        sessionSortTimeAsc: 'Time old→new',
+        sessionSortRecent: 'Recent order',
         history: 'History',
         usageTitle: 'Token usage stats',
         usageTotal: 'All-time {tokens} tokens · input {input} · cache {cache} · output {output} · {calls} calls',
@@ -1177,6 +1194,10 @@ window.__ModuleLoader__.load({
       if (!Number.isFinite(Number(v))) fail('limit', 'number')
       return Number(v)
     })
+    const sortCodec = codecOf(v => {
+      if (typeof v !== 'string') fail('sort', 'string')
+      return v
+    })
     const topSessionsCodec = codecOf(v => {
       if (v === null || typeof v !== 'object' || Array.isArray(v)) fail('topSessions', 'object')
       return v
@@ -1238,7 +1259,11 @@ window.__ModuleLoader__.load({
         {
           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 } }],
+          parameters: [
+            { name: 'limit', wire: 'limit', source: 'json', codec: { mode: 'strict', typeSymbol: 'dsh-cost-meter#SessionLimit', schema: limitCodec } },
+            { name: 'sort', wire: 'sort', source: 'json', codec: { mode: 'strict', typeSymbol: 'dsh-cost-meter#SessionSort', schema: sortCodec } },
+            { name: 'dir', wire: 'dir', source: 'json', codec: { mode: 'strict', typeSymbol: 'dsh-cost-meter#SessionSortDir', schema: sortCodec } },
+          ],
           result: { mode: 'strict', typeSymbol: 'dsh-cost-meter#TopSessions', schema: topSessionsCodec },
         },
       ],
@@ -2330,6 +2355,19 @@ window.__ModuleLoader__.load({
         el('p', { className: 'cm-card-sub' }, props.sub))
     }
 
+    // 历史记录折叠面板(issue #22):三角展开/收起,内部为按天表格(日期行再展开会话明细)。
+    function HistoryPanel(props) {
+      const { state, api } = props
+      const t = makeT(resolveLocale(state.config?.locale))
+      const [open, setOpen] = useState(false)
+      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: () => setOpen(!open) },
+            el('span', { className: 'cm-caret' + (open ? ' open' : '') }),
+            el('h3', { className: 'cm-h' }, t('history')))),
+        open ? el('div', { className: 'cm-collapse-body' }, el(HistoryTable, { state, api })) : null)
+    }
+
     function HistoryTable(props) {
       const { state, api } = props
       const t = makeT(resolveLocale(state.config?.locale))
@@ -2350,7 +2388,7 @@ window.__ModuleLoader__.load({
           .finally(() => setBusyDate(null))
       }
       const sessionRows = sessions => sessions.map(session => el('tr', { key: session.id },
-        el('td', null, session.id.slice(0, 14) + '…'),
+        sessionCell(session, state.config?.showSessionId === true, t),
         el('td', { className: 'num' }, String(session.calls)),
         el('td', { className: 'num' }, formatTokens(session.input)),
         el('td', { className: 'num' }, formatTokens(session.cacheRead + session.cacheWrite)),
@@ -2389,19 +2427,22 @@ window.__ModuleLoader__.load({
           }))))
     }
 
-    // 按会话统计(issue #22 不分日期视角):全部历史会话按费用降序,默认收起、展开时按需拉取。
+    // 按会话统计(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)
+      // 排序模式:cost-desc / cost-asc / time-desc / time-asc / recent(实时顺序)。
+      const [sortMode, setSortMode] = useState('cost-desc')
       const [rows, setRows] = useState(null)
       const [busy, setBusy] = useState(false)
       const [err, setErr] = useState(false)
-      const load = n => {
+      const load = (n, mode) => {
+        const [sort, dir] = mode === 'recent' ? ['recent', 'desc'] : mode.split('-')
         setBusy(true)
         setErr(false)
-        api.getTopSessions(n)
+        api.getTopSessions(n, sort, dir)
           .then(res => setRows(Array.isArray(res?.sessions) ? res.sessions : []))
           .catch(() => setErr(true))
           .finally(() => setBusy(false))
@@ -2409,13 +2450,17 @@ window.__ModuleLoader__.load({
       const toggle = () => {
         setOpen(o => {
           const next = !o
-          if (next && rows === null && !busy) load(limit)
+          if (next && rows === null && !busy) load(limit, sortMode)
           return next
         })
       }
       const changeLimit = n => {
         setLimit(n)
-        if (open || rows !== null) load(n)
+        if (open || rows !== null) load(n, sortMode)
+      }
+      const changeSort = mode => {
+        setSortMode(mode)
+        if (open || rows !== null) load(limit, mode)
       }
       return el('div', { className: 'cm-budget' },
         el('div', { className: 'cm-budget-head' },
@@ -2424,12 +2469,21 @@ window.__ModuleLoader__.load({
             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'))),
+          el('div', { style: { display: 'flex', gap: '12px', flexWrap: 'wrap', margin: '6px 0' } },
+            el('div', { className: 'cm-field' },
+              el('label', null, t('sessionRankSort')),
+              el('select', { className: 'cm-input', value: sortMode, onChange: event => changeSort(event.target.value) },
+                el('option', { value: 'cost-desc' }, t('sessionSortCostDesc')),
+                el('option', { value: 'cost-asc' }, t('sessionSortCostAsc')),
+                el('option', { value: 'time-desc' }, t('sessionSortTimeDesc')),
+                el('option', { value: 'time-asc' }, t('sessionSortTimeAsc')),
+                el('option', { value: 'recent' }, t('sessionSortRecent')))),
+            el('div', { className: 'cm-field' },
+              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'))
@@ -2441,7 +2495,7 @@ window.__ModuleLoader__.load({
                       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) + '…'),
+                      sessionCell(session, state.config?.showSessionId === true, t),
                       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))),
@@ -2455,6 +2509,7 @@ window.__ModuleLoader__.load({
       const t = makeT(resolveLocale(state.config?.locale))
       const sessions = state.today.sessions ?? []
       if (sessions.length === 0) return el('p', { className: 'cm-empty' }, t('noSessionsToday'))
+      const showId = state.config?.showSessionId === true
       return el('div', { className: 'cm-scroll' },
         el('table', { className: 'cm-table' },
           el('thead', null, el('tr', null,
@@ -2462,7 +2517,7 @@ window.__ModuleLoader__.load({
             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, sessions.map(session => el('tr', { key: session.id },
-            el('td', null, session.id.slice(0, 14) + '…'),
+            sessionCell(session, showId, t),
             el('td', { className: 'num' }, String(session.calls)),
             el('td', { className: 'num' }, formatTokens(session.input)),
             el('td', { className: 'num' }, formatTokens(session.cacheRead + session.cacheWrite)),
@@ -2470,6 +2525,17 @@ window.__ModuleLoader__.load({
             el('td', { className: 'num' }, formatMoneyUsd(session.cost, state.config)))))))
     }
 
+    /** 会话单元格:标题为主行(未命名回落短 id),showId 时附显等宽短 id;悬停看完整标题与 id。 */
+    function sessionCell(session, showId, t) {
+      const rawTitle = typeof session.title === 'string' ? session.title.trim() : ''
+      const shortId = String(session.id).slice(0, 14) + '…'
+      const main = rawTitle.length > 0 ? rawTitle : shortId
+      const tooltip = rawTitle.length > 0 ? rawTitle + ' · ' + session.id : session.id
+      return el('td', { title: tooltip },
+        el('div', { className: 'cm-sess-title' + (rawTitle.length === 0 ? ' cm-sess-id' : '') }, main),
+        showId && rawTitle.length > 0 ? el('div', { className: 'cm-sess-id' }, shortId) : null)
+    }
+
     const CURRENCY_PRESETS = {
       CNY: { symbol: '¥', decimals: 4, exchangeRate: 7.2 },
       USD: { symbol: '$', decimals: 6, exchangeRate: 1 },
@@ -3736,10 +3802,8 @@ window.__ModuleLoader__.load({
         el('div', null,
           el('h3', { className: 'cm-h' }, t('todaySessions')),
           el(TodaySessions, { state, t })),
-        // 历史
-        el('div', null,
-          el('h3', { className: 'cm-h' }, t('history')),
-          el(HistoryTable, { state, api })),
+        // 历史(三角折叠面板;日期行可再展开会话明细)
+        el(HistoryPanel, { state, api }),
         // 按会话统计(全部历史,不分日期;issue #22)
         el(SessionRankPanel, { state, api }),
         // 显示设置
@@ -3781,6 +3845,13 @@ window.__ModuleLoader__.load({
               },
                 el('option', { value: 'on' }, t('sidebarOn')),
                 el('option', { value: 'off' }, t('off')))),
+            el('label', { className: 'cm-check' },
+              el('input', {
+                type: 'checkbox',
+                checked: draft?.showSessionId === true,
+                onChange: event => setField('showSessionId', event.target.checked),
+              }),
+              el('span', null, t('showSessionIdLabel'))),
             el('div', { className: 'cm-grid-group' }, t('groupMoney')),
             el('div', { className: 'cm-field' },
               el('label', null, t('currencyLabel')),
@@ -4159,8 +4230,8 @@ window.__ModuleLoader__.load({
         },
         // 按需拉取某天会话明细(issue #22),返回当日完整记录。
         getDaySessions: async date => call('getDaySessions', [date]),
-        // 跨全部日期按费用降序的会话排行(issue #22 不分日期视角)。
-        getTopSessions: async limit => call('getTopSessions', [limit]),
+        // 跨全部日期的会话排行(issue #22 不分日期视角):支持费用/时间升降序与实时顺序。
+        getTopSessions: async (limit, sort, dir) => call('getTopSessions', [limit, sort, dir]),
         refreshBalance: async () => {
           const result = await costMeter.refreshBalance()
           if (result === null || typeof result !== 'object' || result.ok !== true) {

package/lib/index.js

@@ -909,17 +909,28 @@ function createService(ctx, ledger) {
       return day === undefined ? zeroDay(date) : ledger.copyDay(day)
     },
 
-    // 跨全部日期按费用降序返回前 N 个会话(issue #22 按会话视角,不分日期)。
-    async getTopSessions(limit) {
+    // 跨全部日期返回前 N 个会话(issue #22 按会话视角,不分日期)。
+    // sort:cost(费用) | time(会话创建时间) | recent(实时顺序,即账本/侧边栏顺序);dir:asc | desc。
+    async getTopSessions(limit, sort = 'cost', dir = 'desc') {
       const n = Math.max(1, Math.min(500, Math.floor(Number(limit)) || 100))
+      const sortKey = sort === 'time' || sort === 'recent' ? sort : 'cost'
+      const asc = dir === 'asc'
       const all = []
-      for (const [date, day] of Object.entries(ledger.days)) {
+      const dateKeys = Object.keys(ledger.days)
+      // recent 的降序 = 侧边栏直觉的「新会话在前」:日期倒序 + 每日会话倒序。
+      if (sortKey === 'recent' && !asc) dateKeys.reverse()
+      for (const date of dateKeys) {
+        const day = ledger.days[date]
         if (!Array.isArray(day.sessions)) continue
-        for (const s of day.sessions) {
+        const rows = day.sessions.slice()
+        if (sortKey === 'recent' && !asc) rows.reverse()
+        for (const s of rows) {
           if (s === null || typeof s !== 'object') continue
           all.push({
             date,
             id: String(s.id ?? ''),
+            title: typeof s.title === 'string' && s.title.length > 0 ? s.title : undefined,
+            at: Number.isFinite(Number(s.at)) && Number(s.at) > 0 ? Number(s.at) : undefined,
             input: s.input ?? 0,
             output: s.output ?? 0,
             cacheRead: s.cacheRead ?? 0,
@@ -931,7 +942,16 @@ function createService(ctx, ledger) {
           })
         }
       }
-      all.sort((a, b) => b.cost - a.cost)
+      if (sortKey === 'cost') all.sort((a, b) => asc ? a.cost - b.cost : b.cost - a.cost)
+      else if (sortKey === 'time') {
+        // 无时间戳的条目排末尾。
+        all.sort((a, b) => {
+          const ta = Number.isFinite(a.at) ? a.at : asc ? Number.MAX_SAFE_INTEGER : 0
+          const tb = Number.isFinite(b.at) ? b.at : asc ? Number.MAX_SAFE_INTEGER : 0
+          return asc ? ta - tb : tb - ta
+        })
+      }
+      // recent 已按构造顺序排好,不再重排。
       return { sessions: all.slice(0, n) }
     },
   }
@@ -961,8 +981,13 @@ export function apply(ctx) {
   // 宿主会话日志填补空 byProviderModel(幂等,只填空条目,不重复计数)。
   const backfillTimer = setTimeout(() => {
     backfillLegacyLedger(ledger, join(resolveDshHome(), 'sessions')).then(filled => {
-      if (filled.days > 0 || filled.sessions > 0) {
-        console.log(`[dsh-cost-meter] 历史按模型统计回填完成:${filled.days} 天 / ${filled.sessions} 个会话(扫描 ${filled.scanned} 份会话日志${filled.recosted > 0 ? `,重算 ${filled.recosted} 天金额` : ''})`)
+      if (filled.days > 0 || filled.sessions > 0 || filled.titles > 0) {
+        const extras = [
+          filled.days > 0 || filled.sessions > 0 ? `${filled.days} 天 / ${filled.sessions} 个会话` : null,
+          filled.titles > 0 ? `${filled.titles} 个会话标题` : null,
+          filled.recosted > 0 ? `重算 ${filled.recosted} 天金额` : null,
+        ].filter(Boolean).join(',')
+        console.log(`[dsh-cost-meter] 历史按模型统计回填完成:${extras}(扫描 ${filled.scanned} 份会话日志)`)
       }
     }, error => {
       console.warn(`[dsh-cost-meter] 历史按模型统计回填失败: ${String(error?.message ?? error)}`)

package/lib/store.js

@@ -37,6 +37,7 @@ export function defaultConfig() {
     peakEffectiveAt: DEFAULT_PEAK_EFFECTIVE_AT,
     peakWindows: DEFAULT_PEAK_WINDOWS.map(w => ({ ...w })),
     peakNotice: true, // 峰时高价时段显著提示(侧边栏预算框/今日费用/设置页预算面板)
+    showSessionId: false, // 会话列表中附显会话 ID(默认只显示标题,需要时开启)
     peakStyle: 'compact', // 峰谷时段条样式:compact(简洁单行/竖向同构) | classic(经典分段/胶囊芯片)
     priceMatch: 'auto', // 未知模型名自动匹配价格表:auto(去后缀/前缀/家族相似) | exact(仅精确)
     priceOverrides: {}, // 手动匹配覆盖:{ 'provider:modelId': '同provider模型 | provider:模型 | deepseek:__default__' }
@@ -153,7 +154,7 @@ function sanitizeBuckets(target) {
  * 历史版本曾写入 `reasoning: null` 等非法数值,会导致 Typert strict 状态
  * codec 拒绝整个 getState 结果(账本不可用 / 额度刷新连带失败)。
  */
-function sanitizeDays(days) {
+export function sanitizeDays(days) {
   for (const day of Object.values(days)) {
     if (sanitizeBuckets(day) === null) continue
     day.byProviderModel = day.byProviderModel !== null && typeof day.byProviderModel === 'object' && !Array.isArray(day.byProviderModel)
@@ -169,6 +170,10 @@ function sanitizeDays(days) {
     for (const session of day.sessions) {
       if (sanitizeBuckets(session) === null) continue
       session.id = typeof session.id === 'string' ? session.id : ''
+      // 会话标题(由历史回填从会话日志补齐):非字符串一律剔除,防击穿 strict sessionSchema。
+      if (typeof session.title !== 'string' || session.title.length === 0) delete session.title
+      // 会话时间戳(实时入账/回填补齐):非正数剔除。
+      if (!Number.isFinite(Number(session.at)) || Number(session.at) <= 0) delete session.at
       session.byProviderModel = session.byProviderModel !== null && typeof session.byProviderModel === 'object' && !Array.isArray(session.byProviderModel)
         ? session.byProviderModel
         : {}
@@ -211,6 +216,7 @@ const VALIDATION_MESSAGES = {
     peakEffectiveAt: 'peakEffectiveAt 非法',
     peakWindows: 'peakWindows 必须是数组',
     peakNotice: 'peakNotice 必须是布尔值',
+    showSessionId: 'showSessionId 必须是布尔值',
     peakStyle: 'peakStyle 必须是 compact / classic',
     priceMatch: 'priceMatch 必须是 auto / exact',
     priceOverrides: 'priceOverrides 必须是字符串→字符串映射',
@@ -271,6 +277,7 @@ const VALIDATION_MESSAGES = {
     peakEffectiveAt: 'Invalid peakEffectiveAt',
     peakWindows: 'peakWindows must be an array',
     peakNotice: 'peakNotice must be a boolean',
+    showSessionId: 'showSessionId must be a boolean',
     peakStyle: 'peakStyle must be compact / classic',
     priceMatch: 'priceMatch must be auto / exact',
     priceOverrides: 'priceOverrides must be a string→string map',
@@ -387,6 +394,7 @@ export function applyConfigPatch(current, patch) {
   if (typeof candidate.peakEffectiveAt !== 'string') errors.push(vmsg(locale, 'peakEffectiveAt'))
   if (!Array.isArray(candidate.peakWindows)) errors.push(vmsg(locale, 'peakWindows'))
   if (typeof candidate.peakNotice !== 'boolean') errors.push(vmsg(locale, 'peakNotice'))
+  if (candidate.showSessionId !== undefined && typeof candidate.showSessionId !== 'boolean') errors.push(vmsg(locale, 'showSessionId'))
   if (candidate.peakStyle !== 'compact' && candidate.peakStyle !== 'classic') errors.push(vmsg(locale, 'peakStyle'))
   if (candidate.priceMatch !== 'auto' && candidate.priceMatch !== 'exact') errors.push(vmsg(locale, 'priceMatch'))
   const overrides = candidate.priceOverrides
@@ -569,6 +577,7 @@ export function sanitizeConfig(raw) {
   out.priceMatch = oneOf(out.priceMatch, ['auto', 'exact'], 'auto')
   out.decimals = Math.max(0, Math.min(10, Math.floor(Number(out.decimals) || 0)))
   out.historyDays = Math.max(7, Math.min(3650, Math.floor(Number(out.historyDays) || 180)))
+  out.showSessionId = out.showSessionId === true
   if (!isNum(out.exchangeRate) || out.exchangeRate <= 0) out.exchangeRate = base.exchangeRate
   if (!Array.isArray(out.peakWindows)) out.peakWindows = base.peakWindows
   else out.peakWindows = out.peakWindows.filter(w => w !== null && typeof w === 'object' && isNum(Number(w.start)) && isNum(Number(w.end)))
@@ -790,6 +799,7 @@ export class Ledger {
       let session = sessions.find(s => s.id === sessionId)
       if (session === undefined) {
         session = zeroSession(sessionId)
+        session.at = atMs // 会话首次入账时刻(按会话排行「按时间排序」用)。
         sessions.push(session)
         if (sessions.length > MAX_SESSIONS_PER_DAY) sessions = sessions.slice(-MAX_SESSIONS_PER_DAY)
         day.sessions = sessions

package/lib/typert.host.js

@@ -10,6 +10,8 @@ const num = z.number()
 
 const sessionSchema = z.object({
   id: z.string(),
+  title: z.string().optional(),
+  at: num.optional(),
   input: num,
   output: num,
   cacheRead: num,
@@ -101,6 +103,7 @@ const configSchema = z.object({
   peakEffectiveAt: z.string(),
   peakWindows: z.array(z.object({ start: num, end: num })),
   peakNotice: z.boolean().optional(),
+  showSessionId: z.boolean().optional(),
   peakStyle: z.enum(['compact', 'classic']).optional(),
   priceMatch: z.enum(['auto', 'exact']).optional(),
   priceOverrides: z.record(z.string(), z.string()).optional(),
@@ -252,6 +255,8 @@ const _day$codec = { mode: 'strict', typeSymbol: 'dsh-cost-meter#DayRecord', sch
 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 }
+const _sort$codec = { mode: 'strict', typeSymbol: 'dsh-cost-meter#SessionSort', schema: z.string() }
+const _dir$codec = { mode: 'strict', typeSymbol: 'dsh-cost-meter#SessionSortDir', schema: z.string() }
 
 export const TYPERT = {
   package: 'dsh-cost-meter',
@@ -353,6 +358,8 @@ export const TYPERT = {
       invocation: { kind: 'direct' },
       parameters: [
         { name: 'limit', wire: 'limit', source: 'json', codec: _limit$codec },
+        { name: 'sort', wire: 'sort', source: 'json', codec: _sort$codec },
+        { name: 'dir', wire: 'dir', source: 'json', codec: _dir$codec },
       ],
       result: _topSessions$codec,
     },
@@ -433,9 +440,9 @@ export const TYPERT = {
           {
             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 */',
+            signature: 'getTopSessions(limit: number, sort: string, dir: string): TopSessions',
+            summary: '跨全部日期按指定排序返回前 N 个会话(不分日期视角)。Return the top N sessions across all days with the given sort.',
+            jsDoc: '/**\n * 跨全部日期返回前 N 个会话(每条带所属日期/标题/创建时刻)。\n * @param limit - 返回条数上限(服务端限制 1-500)。\n * @param sort - cost(费用) | time(创建时间) | recent(实时顺序)。\n * @param dir - asc | desc(默认 desc)。\n * @returns 会话列表(含 date/title/at 字段)。\n * Return the top N sessions across all days (each tagged with date/title/createdAt).\n * @param limit - Max rows to return (server clamps to 1-500).\n * @param sort - cost | time | recent (ledger/sidebar order).\n * @param dir - asc | desc (defaults to desc).\n * @returns Session list with date/title/at fields.\n */',
           },
         ],
         types: [],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-cost-meter",
-  "version": "1.5.8",
+  "version": "1.5.10",
   "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",