dsh-token-usage-panel

dsh-token-usage-panel

在 DeepSeek Harness 的「设置」里看每天花了多少 Token。 不用离开 DSH，也不用另开网页：设置 → Token 用量，就是一张 GitHub 风格的每日消耗热力图。

浅色主题：

深色主题：

---

功能

• 今日消耗：总量，加上「输出 / 未缓存输入 / 缓存命中」三色明细；填了单价还会显示当天估算金额。
• 指标网格：近 7 天、近 30 天、累计、活跃天数、连续使用天数、缓存命中率。
• 每日消耗热力图：最近 53 周，GitHub 贡献图那种；颜色越深＝当天消耗越多。 悬停看当天四类 token 明细，点格子展开「当天明细」（当天各会话的占比）。
• 最近 30 天趋势：输出 / 未缓存输入 / 缓存命中 的堆叠柱状图，带网格线和峰值刻度。
• 会话明细：可排序、可搜索；窄面板自动精简列，宽面板额外显示工作区、缓存命中和 30 天迷你条。
• 按模型 / 按工作区汇总。
• 成本估算：填单价（元 / 百万 token）自动换算金额；价格只存在你本机浏览器里。

界面完全使用 DSH 自己的设计变量（--dsw-alias-*），浅色 / 深色主题自动适配； 面板宽度会随设置面板变化（实测 ~590px 也能完整放下 53 周热力图）。

安装

需要已安装 DeepSeek Harness（Web 或桌面版），且能正常使用 dsh 命令。

方式 A：在 DSH 里点几下（推荐）

1. 打开 DSH 侧边栏的 插件（Plugins） 页 → 安装。

2. 填入：

   github:Jun-Jun-Gao/dsh-token-usage-panel
   

3. 安装完成后会自动启用这个 bundle。若面板没立刻出现，刷新一次页面。

方式 B：命令行

#      "dsh-token-usage-panel"

第 2 步等价于让它出现在「插件」页被勾选；改完 DSH 会热重载，或重启应用生效。

方式 C：本地开发 / 手动

git clone https://github.com/Jun-Jun-Gao/dsh-token-usage-panel.git
dsh plugin --profile desktop add link:/绝对路径/dsh-token-usage-panel

#       - id: ui-settings-token-usage

#         name: 'dsh-token-usage-panel'

使用

打开 DSH 设置，左侧导航里选 Token 用量。

• 热力图按本机时区的自然日归档；颜色分 4 档，按「当天消耗 / 历史单日最大值」划分。
• 面板默认每 30 秒自动刷新一次，也可以点「刷新」；正在进行的会话也会被算进去。
• 「成本估算」四个单价留空即不显示金额；清空 按钮会清掉本机保存的价格。

统计口径

字段	含义
未缓存输入	真正按输入价计费的 prompt token
缓存命中	命中 prompt cache 的部分（单价通常最低）
输出	模型生成的 token（含思维链）
合计	以上四项之和，也就是服务商后台看到的那个总量

因为每一步都会重发上下文，「合计」通常被缓存命中主导（实测占比 99%+）， 所以真正贵的是「未缓存输入 + 输出」两项——面板把它们单独列出来就是为此。

工作原理

DSH Host 进程                                 浏览器
┌───────────────────────────────┐            ┌────────────────────────────┐
│ lib/index.js                  │            │ lib/client.js              │
│  · 扫描 $DSH_HOME/sessions/   │  GET       │  · 注册 settings.section   │
│    **/session*.jsonl.zstd     │ ─────────► │  · 拉取数据并渲染面板      │
│  · 聚合到「每天 / 每会话」     │ /token-    │  · 成本估算存 localStorage │
│  · 注册只读路由 /token-usage  │  usage/data│                            │
└───────────────────────────────┘            └────────────────────────────┘

• 数据来源是 DSH 自己写的会话日志里，每一条 assistant/message 的 usage 字段。
• 这些日志是多帧拼接的 zstd 文件（每追加一次一个帧），而 Node 的 zlib.zstdDecompressSync 只解第一帧。所以 Host 侧按 zstd 魔数切帧、逐帧解压，并在误切时自动合并重试—— 不需要外部 zstd 命令。
• 解析结果按「文件大小 + mtime」做增量缓存，历史会话再多刷新也很快。
• 只读本机文件，不联网、不上传，也不注册任何模型可见的东西（模型看不到这个面板）。

卸载

dsh plugin --profile desktop remove dsh-token-usage-panel

## 使用

打开 DSH **设置**，左侧导航里选 **Token 用量**。

- 热力图按**本机时区的自然日**归档；颜色分 4 档，按「当天消耗 / 历史单日最大值」划分。
- 面板默认每 30 秒自动刷新一次，也可以点「刷新」；正在进行的会话也会被算进去。
- 「成本估算」四个单价留空即不显示金额；`清空` 按钮会清掉本机保存的价格。

# 并在 profile 的 package.json 里把 "dsh-token-usage-panel" 从 dsh.profile.bundles 移掉

兼容性

• 开发与验证环境：DSH 0.2.0-rc.2（Electron 44 / Node 24.18）下的 Web GUI 与桌面版。
• 本包没有声明 @deepseek-ai/dsh* 的 peerDependencies，所以不会被版本范围拒装； 如果你在更新的 DSH 上遇到问题，欢迎开 issue 附上 DSH 版本。
• 面板用的是 settings.section、ctx.locale、ctx.webServer.register 这几个公开扩展点。

开发