用量花费仪表盘hnmrxz/dsh-plugin-usage-dashboard

dsh-plugin-usage-dashboard

在 DeepSeek Harness (dsh) 底部状态栏显示 DeepSeek 用量与估算花费：按会话聚合 token 成本、余额预算告警。

DSH 的估算 token 成本与用量仪表盘：按会话聚合 token/成本，并带有低余额预算告警，直接显示在底部状态栏中。

screenshot

功能特性

- 状态栏 chip：DS ¥12.34 · 估算花费，余额低于阈值时变橙色 ⚠ 余额偏低
- 悬停查看明细：总花费 / 会话数 / token 数 + 按会话 Top 8 的成本排行
- 每 30 秒自动刷新，点击立即刷新
- 数据完全来自 dsh 自己的投影缓存（tokenUsage / sessionStats），零核心改动、零运行时依赖
- 余额告警复用 DEEPSEEK_API_KEY 凭据（与余额插件同一条链路），无需再配置
- 中英文自动跟随 DSH 界面语言

安装

需要 DSH 0.1.0-rc.x（Web profile）。

1. 安装到 profile

cd ~/.dsh/profiles/web
npm install dsh-plugin-usage-dashboard
本地开发：npm install /path/to/dsh-plugin-usage-dashboard

2. 加入 composition

编辑 ~/.dsh/profiles/web/cordis.patch.yml：

- insert:
- id: usage-dashboard
name: dsh-plugin-usage-dashboard

3. 重启 dsh

dsh --profile web

配置

无配置项。Key 复用 DEEPSEEK_API_KEY（Models 设置页或环境变量）。

成本为估算值：按 DeepSeek 公开定价（CNY/1M tokens）折算——缓存命中输入 ¥0.5、未命中输入 ¥2、输出 ¥8。如需调整，编辑 lib/index.js 顶部的 PRICE 常量；余额告警阈值 BALANCE_ALERT_THRESHOLD（默认 10 CNY）同理。

工作原理

Browser client.js          dsh Host process
┌──────────────┐   GET    ┌───────────────────────────┐
│ composer.dock│ ───────► │ /dsh-usage                │
│  chip        │ ◄─────── │   ├─ sessionQuery         │
└──────────────┘  JSON    │   │   .listSessions()     │
│   ├─ sessionProjections   │
│   │   .snapshot()          │
│   │   (tokenUsage,         │
│   │    sessionStats,       │
│   │    title)              │
│   ├─ credentials.resolve() │
│   └─ fetch /user/balance   │
└───────────────────────────┘

开发

lib/index.js    # Host half：聚合用量 + 余额告警，注册 /dsh-usage 路由
lib/client.js   # Client half：状态栏 chip（__ModuleLoader__ bundle）

许可证

MIT