dsh-token-usage-dashboard：DeepSeek Harness Token 用量统计面板

DeepSeek Harness (DSH) 采用插件化架构，对于需要精细化控制成本和优化模型的开发者而言，实时监控 Token 用量是核心需求。dsh-token-usage-dashboard 插件为 DSH Web UI 提供了一个类似 GitHub 的 Activity Heatmap 的统计面板，聚合了会话日志中的关键指标，帮助快速定位高耗能环节。

功能概览¶

该插件包含以下核心模块：

• 5 个统计卡片：展示总 Token 数、单日峰值、最长会话、当前连续使用天数、历史最长连续天数。数值支持自动缩放以适应单行显示。
• GitHub 风格热力图：53 列 x 7 行的滚动网格，支持“每日”和“每周”视图切换（每周视图以底部为起点，每 7 格为一周）。鼠标悬停可查看具体日期的 Token 数量与请求次数。
• 洞察面板：统计总轮次、LLM 请求数、活跃会话数、活跃天数、缓存命中率，以及平均每轮 Token 数和耗时。
• 模型排名：按 Token 使用量统计 Top 5 的 Favorite Models，并提供比例条形图直观展示。
• 数据同步：支持实时增量更新，并在后台持久化快照，重启后可快速恢复。

安装与启用¶

使用官方 CLI 安装该插件：

dsh plugin --profile web add github:solstice621/dsh-token-usage-dashboard

安装完成后，重启 Web Profile 以应用插件。随后在 DSH 界面中打开 Settings → Stats 即可查看仪表盘。首次打开时，插件会扫描历史会话日志进行初始化，随后开始实时更新。

典型用法¶

1. 查看统计：在仪表盘首页查看 5 个核心指标卡片和热力图概览。
2. 切换视图：在热力图区域点击切换“每日”或“每周”模式。
3. 语言适配：根据 DSH 界面的语言设置（中文或英文），仪表盘标签会自动切换。

注意事项与边界¶

使用前需注意以下事实：

• 插件形式冲突：该插件提供“Bundle 形式”（推荐）和“Dynamic Plugin 形式”（toksta-5）。两者注册的设置区块 ID 均为 token-stats，切勿同时运行。
• 环境依赖：dsh plugin 命令依赖于 pnpm，请确保 pnpm 已在系统 PATH 中（可通过 corepack enable pnpm 启用）。
• 数据统计规则：
  • 仅统计 Adapter 报告了 usage 的调用，标题生成调用不计入。
  • 模型归属信息来自会话最新请求的 request/header。
  • 当前连续天数若今日无使用，则统计至昨日。
• 样式渲染：CSS 注入通过客户端内置样式完成，不支持 ctx.get('styles') 这种服务端写法。

结语¶

dsh-token-usage-dashboard 是解决 DeepSeek Harness 开发者 Token 监控需求的有效工具。它通过可视化方式整合了 Session 日志中的关键数据，减少了手动查看日志的时间成本。更多细节与源码，请访问 GitHub 仓库。