用量看板 LynnChrysteiin/dsh-token-dashboard

dsh-token-dashboard

DeepSeek Harness 的用量看板：把账户余额、Token 使用量和花费放在一个页面里，按天、按模型、按工作区看清钱花在哪。

数据全部来自本地 —— 会话日志 + DeepSeek 官方余额接口，不需要额外的云端账号。

功能

余额

实时账户余额，走 DeepSeek 官方接口，自动识别 CNY / USD，可强制刷新。

用量

三张数字卡：今日、近 7 天、近 30 天（滚动窗口，含今天往前数）。加请求数、缓存命中率、会话数。顶部可切换全局时间范围：近 7 天 / 近 30 天 / 全部，同步改变所显示的图表和分布。

花费

按 DeepSeek 的三档计费分别算出金额：缓存命中输入、缓存未命中输入、输出。

计费口径：

- 峰谷价：峰谷定价按照 DeepSeek 官网明示为基准。判断按事件自身的发生时间，因此不随查看时间或设备时区变化，但除周末外的法定节假日谷期定价尚未实现。
- 按日期分档计价：DeepSeek 每次调价记为一个新档位，事件用它自己那天生效的单价计算。所以后来调价不会改写之前几天的金额。
- 实际为估算：插件只读取会话日志里的 token 数，再乘自己的价目表，并不知道 DeepSeek 实际扣了多少。对账请以官方账单为准。
- 未知模型会被按 Flash 档计价，并在 /api/token-dashboard/stats 的 unpricedModels 里列出，以免静默算错。

改价：编辑 lib/index.js 里的 PRICE_TIERS，新增一条 { from: "YYYY-MM-DD", models: { ... } } 即可；不同时段的单价写成 [高峰, 空闲] 两个数。官方价目见 DeepSeek 定价页，发布日期见更新日志。PRICING_GAPS 记录了表里哪些数字不是官方来源。

分布与趋势

「用量分布」可切换按模型 / 按工作区，以及按 Token / 按成本，配占比条。每种分组各由一条每日曲线看出大致各自用量。

活跃度

整年热力图（53 周 × 7 天）。悬停可显示当天日期、Token 与花费。

下面这张图同时能看到分工作区曲线和整年热力图：

明细与导出

按模型明细表（请求数 + 三档花费）、最近会话列表，以及一键导出 CSV / JSON。

安装

dsh plugin --profile <profile> add @astralux/dsh-token-dashboard

装完刷新，看板出现在 设置 → 用量看板。

也可以从 GitHub 或本地目录安装：

dsh plugin --profile <profile> add github:LynnChrysteiin/dsh-token-dashboard
dsh plugin --profile <profile> add /本仓库的绝对路径

使用

1. 打开 设置 → 用量看板。
2. 顶部选时间范围（近 7 天 / 近 30 天 / 全部）。
3. 在「用量分布」里切换按模型 / 按工作区、按 Token / 按成本。
4. 鼠标移到热力图格子上看某一天的具体用量。
5. 需要留档就点「导出 CSV / 导出 JSON」。

配置

不用配置即可使用。想改的话，host 部分在 lib/index.js 里读这几个值：

| 项 | 默认 | 说明 |
| sessionsRoot | $DSH_HOME/sessions | 会话日志目录 |
| balanceCacheMs | 300000 | 余额缓存时长（5 分钟） |
| sweepIntervalMs | 60000 | 统计刷新间隔 |

也可以在 profile 的 patch 里覆盖整个价目表（config.priceTiers，结构与 PRICE_TIERS 相同，格式不合法时整份忽略并记一条 warning，回落到内置表）。改价方式见上面「花费」一节。

说明

- 金额是估算：插件只读会话日志里的 token 数，再乘自己的价目表，并不知道 DeepSeek 实际扣了多少。对账以官方账单为准。
- 余额显示「未配置 DeepSeek API Key」：说明你用的是账号态登录而不是 API Key。余额卡片会空着，Token 与花费统计不受影响（它们来自本地会话日志）。
- 没有构建步骤：纯 JavaScript，无依赖。改 lib/client.js 刷新页面即可，改 lib/index.js 需要重启 DSH。

来源

Fork 自 lyk308/dsh-token-dashboard，MIT 许可，原作者 @lyk308。本仓库在其基础上修好了 dsh 0.2.0-rc.2 的兼容问题（原版在这个版本上所有数字都读成 0），修正了按官方价目计价，并做了上面这些扩展。

许可证

MIT