dsh-usage
<p align="center">
<strong>简体中文</strong> | <a href="README.en.md">English</a>
</p>
<p align="center"> <strong>把 DeepSeek Harness 的 token 账单摊开在侧栏。余额、命中率、成本曲线、热力图，一个「用量」按钮全看完。</strong><br> 成本是估算的，命中的是真实缓存。 </p> 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 web 后，侧栏设置按钮上方出现「用量」按钮开发
# 本地目录安装（跳过 npm）
mkdir -p ~/.dsh/profiles/web/node_modules/@dshd/dsh-usage
cp package.json host.js client.js cordis.patch.yml ~/.dsh/profiles/web/node_modules/@dshd/dsh-usage/
# 在 ~/.dsh/profiles/web/package.json 的 dependencies 与 dsh.profile.bundles 加入 @dshd/dsh-usage
# 修改后重新 cp，重启 dsh web 生效（dsh plugin list 不会显示本地目录安装，属正常）配置
| 项 | 说明 | 默认 |
|---|---|---|
DEEPSEEK_API_KEY | DeepSeek 余额凭据（credentials 服务或环境变量） | — |
OPENROUTER_API_KEY | OpenRouter 余额凭据 | — |
cnyPerUsd | USD 换算汇率 | 6.76 |
pricing | 单价覆盖（可带 schedules 峰谷段） | 内置官方刊例价 |
License
[MIT](LICENSE)。@dshd/dsh-usage 与 DeepSeek 及任何供应商无关联；不保存凭据、不上传数据，全部计算在本机完成。成本为按官方刊例价与请求时刻计算的估算值，可能因价格变动、峰谷时段或计费口径差异与真实账单不一致。