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 add @astralux/dsh-token-dashboard
装完刷新，看板出现在 设置 → 用量看板。
也可以从 GitHub 或本地目录安装：
dsh plugin --profile add github:LynnChrysteiin/dsh-token-dashboard
dsh plugin --profile add /本仓库的绝对路径
使用
- 打开 设置 → 用量看板。
- 顶部选时间范围（近 7 天 / 近 30 天 / 全部）。
- 在「用量分布」里切换按模型 / 按工作区、按 Token / 按成本。
- 鼠标移到热力图格子上看某一天的具体用量。
- 需要留档就点「导出 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
