页面内容

• 汇总数据（全部历史） —— 计费输入 / 输出 Token、会话数量（次级标注总会话数与主/子代理用量拆分）、最常用模型及其占比。
• 缓存命中率 —— 缓存读 ÷（未缓存输入 + 缓存读 + 缓存写），附读写绝对量。
• 活跃热力图 —— 最近半年，GitHub 贡献图式布局（列为周、行为星期）。按非零日用量的四分位分 4 级色阶。
• 每日柱状图 —— 按模型堆叠的每日用量，可切换最近 7 / 14 / 30 天。
• 会话用量排行 —— 最耗 Token 的 10 个会话（含折叠标题）。
• Provider 用量 —— 多 Provider 时按路由展示各自用量。
• 模型环形图 —— 各模型全历史占比，旁边列出前 5 名，其余合并为「其他」。
• 导出 —— 完整 JSON、每日 CSV、模型 CSV（防公式注入、RFC 4180、UTF-8 BOM）。

悬停柱子或环形图分段可以看到具体明细：

柱状图悬停	环形图悬停	暗色主题

安装

插件以 bundle 形式发布：dsh plugin add 会把它追加到 profile 的 bundle 列表，patch 行负责挂载 Host 半。

# 从 npm 安装（推荐）
dsh plugin --profile web add dsh-usage-panel

# 或从 GitHub 安装
dsh plugin --profile web add github:AlfredChaos/dsh-usage-panel

# 或从本地目录安装
dsh plugin --profile web add ./dsh-usage-panel

重启 dsh --profile web，打开「设置 → 消耗统计」。npm 包内 lib/ 下是预构建的纯 JavaScript 产物，无安装脚本；GitHub 安装同样不需要 pnpm 的构建放行，因为仓库里提交了相同的文件。卸载：

dsh plugin --profile web remove dsh-usage-panel

数据来源

Host 半聚合持久化会话日志：

• 主路径（增量）：注册一个会话投影（ctx.sessionProjections，带 stateVersion 校验），把每个已提交事件折叠进四个互斥桶 —— 未缓存输入 / 输出 / 缓存读 / 缓存写 —— 以及按模型、按 Provider、按天（UTC）的映射。checkpoint 落盘，重启与保鲜扫描几乎零回放。
• 回退路径（全量重扫）：投影服务不可用时，同一套 reducer 通过只读 sessionQuery 服务重放每个会话日志。

记账规则：request/header 与 request/context 记录模型（context 打底、header 覆盖）；该步骤的 assistant/message 用量替换流式暂记用量（同一步重试的消息不会重复累计）；llm/retry 事件只计重试次数、不计 Token；compaction/summary 用量归属其自身模型并单独披露；reasoning token 已含于 output，绝不重复相加。

子会话（fork）去重：最后一个 session/end-seed 标记之前的事件（fork / resume / replay 种子历史）一律不计数，fork 出的会话不会重复计算父会话的用量。

日期口径声明：日桶与导出均按 UTC 自然日（YYYY-MM-DD）。面板明确标注范围（"仅本机会话日志 · UTC"）。

因为不写回任何数据，统计在重启后依然存在，也能覆盖插件安装之前的历史会话。

加载策略

插件加载时立即开始首次扫描，打开页面时通常直接命中缓存。缓存 10 分钟内视为新鲜；更旧的缓存会立即返回并标记 stale（页面显示「后台更新中…」），同时后台重扫刷新。每 10 分钟定时轻量重扫保鲜，刷新按钮始终强制同步重扫。浏览器还会把最近一次成功载荷存入 localStorage（带版本号与结构校验），刷新页面即刻渲染；刷新失败时保留旧数据并如实标注，绝不伪装最新。

单位

中文界面：≥ 1 亿 用「亿」，≥ 1 万 用「万」，否则原值；英文界面：K / M / B。

实现

源码为 TypeScript（strict）位于 src/，esbuild 构建；lib/ 产物提交进仓库，安装无需构建步骤。

文件	说明
src/host/index.ts → lib/index.js	Host 半（Cordis 插件）：投影注册、聚合、带预热的 RPC 缓存、fail-soft 回退
src/host/projection.ts	纯函数会话投影 reducer（四桶、fork 去重、重试/压缩语义、UTC 日桶）
src/host/aggregate.ts	跨会话合并 → overview 载荷
src/client/* → lib/client.js	Client 半（./client 导出，__ModuleLoader__ bundle）：TSX 设置页 UI，--dsw-* 变量，中英双语
src/shared/contract.ts	host↔client wire 契约（单一来源）
cordis.patch.yml	Bundle patch：向 profile 组合插入 usage-stats 行

Host 通过 ctx.connection.rpc.handle('/usage-stats', …, { authority: 'loopback' }) 提供 overview 端点，浏览器经 rpc.call('/usage-stats', 'overview', …) 调用。overview 载荷新增 coverage（会话成功/失败/待落盘、数据路径、UTC 声明、事件范围）、topSessions、providers，并保留 v0.1.0 形态的 days / totals / byModel / allTime。基于 DeepSeek Harness 0.1.0-rc.6 开发验证。测试使用 Node 内置 test runner（npm test）；CI 执行 typecheck + build + test + 打包门禁。

License

MIT