dsh-usage-dashboard

DeepSeek Harness (dsh) 的 Web 插件：在侧边栏底部显示 API 余额 和 今日花费。

• 余额：通过 DeepSeek API GET /user/balance 实时获取（带缓存，默认 60s）
• 今日花费：扫描 $DSH_HOME/sessions 的会话日志（zstd 多帧解码），汇总今日 token 用量 × 官方定价估算
• 支持 DeepSeek 2026-08-17 起的峰谷定价（高峰 9-12 / 14-18 点，空闲半价），按每条请求的发生时间自动选用费率

界面

侧边栏底部小部件：

• 展开时显示 余额 ¥xx.xx 与 今日花费 ¥xx.xx，点击展开详情卡（余额构成、调用次数、Token 用量、按模型明细、计价方式）
• 收起时显示 ¥ 图标按钮，悬停提示
• 每 60 秒自动刷新，可手动点击刷新

安装

前提：已安装 dsh（dsh web 可正常运行）。

方式一：npm 安装

dsh plugin add dsh-usage-dashboard --profile web

方式二：本地目录

## 配置

| 字段 | 说明 | 默认 |
|---|---|---|
| `apiKeyRef` | DeepSeek API Key 的凭证引用 | `DEEPSEEK_API_KEY` |
| `baseURL` | 余额接口地址；留空则用 `$DEEPSEEK_BASE_URL`，再回退 `https://api.deepseek.com` | `""` |
| `prices` | 按模型单价覆盖（元 / 百万 tokens：`{ input, cacheRead, output }`） | 官方现行价 |
| `priceSchedule` | 日期生效的峰谷定价表 `{ from, peak, idle }` | 2026-08-17 起峰谷定价 |
| `balanceCacheMs` | 余额缓存毫秒数 | `60000` |
| `sessionsRoot` | 会话日志目录覆盖 | `/sessions` |
| `scanWindowMs` | 只扫描此时间窗口内修改的日志 | `48h` |

### 默认价格（官方现行价，2026-08-17 前）

| 模型 | 缓存命中 | 缓存未命中 | 输出 |
|---|---|---|---|
| `deepseek-v4-flash` | ¥0.02/M | ¥1/M | ¥2/M |
| `deepseek-v4-pro` | ¥0.025/M | ¥3/M | ¥6/M |

### 2026-08-17 起峰谷定价（已内置，无需配置）

| 模型 | 时段 | 缓存命中 | 未命中 | 输出 |
|---|---|---|---|---|
| flash | 高峰 | ¥0.10 | ¥3.0 | ¥9.0 |
| flash | 空闲 | ¥0.05 | ¥1.5 | ¥4.5 |
| pro | 高峰 | ¥0.30 | ¥9.0 | ¥27.0 |
| pro | 空闲 | ¥0.15 | ¥4.5 | ¥13.5 |

价格有变动时在 `cordis.patch.yml` 的 `prices` / `priceSchedule` 里覆盖即可。

### 2026-08-17 起峰谷定价（已内置，无需配置）

| 模型 | 时段 | 缓存命中 | 未命中 | 输出 |
|---|---|---|---|---|
| flash | 高峰 | ¥0.10 | ¥3.0 | ¥9.0 |
| flash | 空闲 | ¥0.05 | ¥1.5 | ¥4.5 |
| pro | 高峰 | ¥0.30 | ¥9.0 | ¥27.0 |
| pro | 空闲 | ¥0.15 | ¥4.5 | ¥13.5 |

价格有变动时在 `cordis.patch.yml` 的 `prices` / `priceSchedule` 里覆盖即可。