deepseek-token-dashboard

August 29, 2026 · View on GitHub

version license tests platform

DSH（DeepSeek Harness）插件：在 Web 界面左下角实时显示当前会话的 Token 用量、 预估花费与 DeepSeek 账户余额，信息精简、不遮挡任何界面。

特性

  • Token 用量：当前会话累计的 输入 / 输出 / 缓存读取 / 缓存写入 / 合计， 来自每次模型调用上报的真实 usage，经会话投影实时推送。
  • 预估花费（v1.5.1 修复）：每条用量按事件发生时间所在时段的峰谷单价定格累计—— 峰时段的花费不会在切到空闲时段后被改写成半价；环境变量可显式覆盖单价。
  • 账户余额：DeepSeek 官方 GET /user/balance（总额 / 赠送 / 是否可用），每 60 秒刷新。
  • 紧凑读数 UI：常驻侧边栏底部"设置"旁——Token 合计·花费、Token 构成堆叠条、 花费/会话起始余额利用率条（按会话开始时余额快照计算，避免"花费>当前余额"假超支；超支标红并提示金额）；侧边栏收起时缩为状态圆点，悬停查看全部详情。

定价规则（内置单价表）

v4 模型（deepseek-v4-flash / deepseek-v4-pro / deepseek-v4-flash-vision-exp，后两者价格与 flash 一致）自 2026-08-17 00:00 起按北京时间峰谷定价：

  • 高峰时段：工作日 9:00–12:00、14:00–18:00
  • 空闲时段：高峰的半价
  • 周末优惠（2026-08-23 00:00 起）：周六/周日全天按空闲价计费，不设高峰
  • deepseek-chat / deepseek-reasoner：历史公开平铺价

完整单价表与配置方式见 deepseek-token-dashboard/README.md。

仓库结构

路径说明
deepseek-token-dashboard/插件源码（CommonJS 静态 Cordis 插件）
deepseek-token-dashboard/docs/插件安装说明 / 设计文档 / 实现计划
docs/工作区设计规范与实现计划
releases/各版本打包产物 .tgz（最新 deepseek-token-dashboard-1.6.2.tgz，Git 已忽略）
.github/workflows/CI：npm test 自动验证

安装

# 方式 A：已有 .tgz 包（推荐）
cd "$HOME\.dsh\profiles\web"
pnpm.cmd add <path-to>/deepseek-token-dashboard-1.6.2.tgz

# 方式 B：通过 dsh 插件命令
dsh plugin --profile web add deepseek-token-dashboard

安装后确认 profile 的 package.json 中 dsh.profile.bundles 包含 deepseek-token-dashboard， 然后重启 dsh（Host 插件与 Client bundle 在启动时加载），刷新浏览器页面。

PowerShell 执行策略默认拦截 npm.ps1/pnpm.ps1，请改用 npm.cmd/pnpm.cmd。 卸载与故障排查见 deepseek-token-dashboard/docs/INSTALL.md。

配置

项方式默认
API Key复用宿主凭据 DEEPSEEK_API_KEY（$HOME/.dsh/.credentials.yaml 或环境变量）—
单价自动按 模型 + 事件发生时段 选价；DEEPSEEK_TOKEN_DASHBOARD_RATES（JSON）可覆盖内置 MODEL_PRICES
余额刷新代码常量 BALANCE_INTERVAL_MS（lib/index.js）60s

开发

cd deepseek-token-dashboard
npm.cmd test     # node:test，42 个用例（usage / cost / rates / balance / view / accrue）

架构与设计依据见 deepseek-token-dashboard/docs/DESIGN.md， 实现计划见 deepseek-token-dashboard/docs/PLAN.md。

License

MIT