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)