deepseek-token-dashboard
!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)自 2026-08-17 00:00 起按北京时间峰谷定价:
- 高峰时段:9:00–12:00、14:00–18:00
- 空闲时段:高峰的半价
- deepseek-chat / deepseek-reasoner:历史公开平铺价
完整单价表与配置方式见 [deepseek-token-dashboard/README.md](deepseek-token-dashboard/README.md)。
仓库结构
| 路径 | 说明 |
|---|---|
deepseek-token-dashboard/ | 插件源码(CommonJS 静态 Cordis 插件) |
deepseek-token-dashboard/docs/ | 插件安装说明 / 设计文档 / 实现计划 |
docs/ | 工作区设计规范与实现计划 |
releases/ | 各版本打包产物 .tgz(最新 deepseek-token-dashboard-1.5.1.tgz,Git 已忽略) |
.github/workflows/ | CI:npm test 自动验证 |
安装
# 方式 A:已有 .tgz 包(推荐)
cd "$HOME\.dsh\profiles\web"
pnpm.cmd add <path-to>/deepseek-token-dashboard-1.5.1.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](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,36 个用例(usage / cost / rates / balance / view / accrue)架构与设计依据见 [deepseek-token-dashboard/docs/DESIGN.md](deepseek-token-dashboard/docs/DESIGN.md), 实现计划见 [deepseek-token-dashboard/docs/PLAN.md](deepseek-token-dashboard/docs/PLAN.md)。
License
[MIT](LICENSE)