dsh-usage

简体中文 | English

把 DeepSeek Harness 的 token 账单摊开在侧栏。余额、命中率、成本曲线、热力图，一个「用量」按钮全看完。

成本是估算的，命中的是真实缓存。

dsh-usage 在 dsh web 侧栏设置按钮上方注入「用量」按钮，点开是一个单页模态面板。所有 token 用量从 dsh 会话日志（内存活跃 + 磁盘持久化，zstd 解码）解析；成本按请求时刻套用官方峰谷价目估算；凭据只在 host 侧解析，不出本机。

面板五块

供应商余额

支持 DeepSeek（DEEPSEEK_API_KEY）与 OpenRouter（OPENROUTER_API_KEY），凭据经 dsh credentials 服务解析，key 不进浏览器。

用量与命中率

标题行可切换全部会话 / 单个会话（下拉显示会话标题）。命中率为输入侧缓存命中率。

折线图

仅显示当天、按小时聚合的平滑曲线，Token / 成本双视图，悬浮显示该小时三桶 token 与成本估算。

热力图

时间模式 = 最近 13 周每日；会话模式 = 每个会话每轮。GitHub 官方 4 档绿阶。

历史明细

全量明细分页（每页 15 行、限高内部滚动、悬浮高亮），一键导出 CSV（带 BOM，Excel 直接打开）。

🚧 更多查询内容开发中：会话过滤、排序、时间区间筛选等查询能力陆续补充中，敬请期待。

数据口径

• 用量来源：assistant/chunk(usage) 与 assistant/message 事件；同一 (turn, step) 替换不累加
• 命中率 = cacheRead / (uncachedInput + cacheRead + cacheWrite)（输入侧缓存命中率）
• 成本 = 未命中输入×miss + 命中×hit + 输出×out；按请求时刻套用官方峰谷价（DeepSeek 2026-08-17 起高峰 9:00–12:00、14:00–18:00），并定期在线同步官方价格页（失败回退内置价目）
• 成本为估算值，非精确计费金额，统一以 USD 显示

安装

dsh plugin --profile web add @dshd/dsh-usage

# 在 ~/.dsh/profiles/web/package.json 的 dependencies 与 dsh.profile.bundles 加入 @dshd/dsh-usage

## 配置

| 项 | 说明 | 默认 |
|---|---|---|
| `DEEPSEEK_API_KEY` | DeepSeek 余额凭据（credentials 服务或环境变量） | — |
| `OPENROUTER_API_KEY` | OpenRouter 余额凭据 | — |
| `cnyPerUsd` | USD 换算汇率 | `6.76` |
| `pricing` | 单价覆盖（可带 `schedules` 峰谷段） | 内置官方刊例价 |