前言¶

用 DeepSeek Harness（DSH）跑智能体时，会话会不断产生 Token 消耗，官方账单又往往滞后。若只靠记忆或零散日志，很难回答「今天花了多少」「哪个工作区、哪个模型占大头」。社区插件 dsh-token-dashboard 把账户余额、Token 使用量与按 DeepSeek 三档计费拆分的成本放在同一页面，数据来自本地会话日志与 DeepSeek 官方余额接口，不依赖额外云端账号。本仓库由 LynnChrysteiin 维护，Fork 自 lyk308/dsh-token-dashboard，在 dsh 0.2.0-rc.2 上修复了统计全为 0 的兼容问题，并扩展了计价与图表能力；npm 包名为 @astralux/dsh-token-dashboard，当前版本 0.2.2，MIT 许可。

这是什么¶

dsh-token-dashboard 是 DSH 的客户端插件：在 设置 → 用量看板 提供用量看板。服务端读 $DSH_HOME/sessions 下的会话日志做统计，余额走 DeepSeek 官方接口；纯 JavaScript、无额外依赖。

核心功能¶

余额¶

实时账户余额，自动识别 CNY / USD，支持强制刷新。若显示「未配置 DeepSeek API Key」，说明当前是账号态登录而非 API Key，余额卡片为空，Token 与花费统计仍来自本地日志，不受影响。

用量¶

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

花费¶

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

计费口径（README 原文要点）：

• 峰谷价：以 DeepSeek 官网明示为基准，按事件自身发生时间判断；除周末外的法定节假日谷期定价尚未实现。
• 按日期分档：每次调价记为新档位，事件用当天生效的单价计算，后续调价不会改写历史天数。
• 实际为估算：仅根据会话日志中的 token 数乘插件内置价目表，对账请以官方账单为准。
• 未知模型按 Flash 档计价，并在 /api/token-dashboard/stats 的 unpricedModels 中列出。

改价可编辑 lib/index.js 的 PRICE_TIERS，或于 profile patch 中覆盖 config.priceTiers（结构与 PRICE_TIERS 相同；格式不合法时整份忽略并记 warning，回落内置表）。官方价目见 DeepSeek 定价页。

分布、趋势与活跃度¶

「用量分布」可切换 按模型 / 按工作区、按 Token / 按成本，带占比条；每种分组有一条每日曲线。另有整年热力图（53 周 × 7 天），悬停可看当天日期、Token 与花费。

明细与导出¶

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

安装与启用¶

在目标 profile 下安装（README 给出的命令）：

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 /本仓库的绝对路径

装完后刷新 DSH，看板入口在 设置 → 用量看板。插件以当前 dsh 进程权限运行，安装前建议浏览仓库源码与 LICENSE。

典型用法¶

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

配置（可选）¶

默认可零配置使用。host 侧在 lib/index.js 中可调整：

改 lib/client.js 后刷新页面即可；改 lib/index.js 需重启 DSH。

适用场景与注意¶

适合需要在本机 DSH 环境里快速看清 Token 趋势、工作区/模型分布和成本构成的开发者。金额均为估算，财务对账仍以 DeepSeek 官方账单为准。DSH 生态强调「一切皆插件」；插件目录站 skillhub.cn 为社区收录，与 DeepSeek / 幻方无官方从属关系。

• 目录页：https://www.skillhub.cn/plugins/LynnChrysteiin/dsh-token-dashboard
• 源码与说明：https://github.com/LynnChrysteiin/dsh-token-dashboard