dsh-usage-cost
English · 中文 · 日本語 · Русский · Español · Français
DeepSeek Harness 的 Token 用量与费用监控插件：跨会话聚合 token 用量、按模型计算费用（USD / 约合 RMB）、支持时间窗口筛选与自动刷新，并在「设置」内以原生面板展示——无需记 URL。
功能
- 跨会话聚合 — 通过
ctx.sessionPersistence扫描全部会话日志（天然支持多帧 zstd、packChunks、崩溃恢复），按模型统计：输入·未命中、输入·命中缓存、输出、推理 token 与调用次数。 - 费用计算 — 三档单价 × 用量：
未命中价×miss + 命中价×hit + 输出价×out；总费用 USD + 实时汇率换算人民币。 - 三重定价来源 — 抓取官方定价页 → 失败回退内置价表 → 面板内手动改价（自定义覆盖，持久化保存，删除即回退）。
- 时间窗口 — 全部 / 近一天 / 当天 / 近一周 / 近一个月，切换即查，每个窗口独立缓存。
- 自动刷新 — 后台静默刷新，可选频率：关闭 / 1分钟 / 5分钟 / 30分钟 / 1小时 / 12小时，不打断操作。
- 命中率三色 — <60% 红 · 60–80% 黄 · ≥80% 绿，一眼看健康度。
- 界面语言 — 跟随 DSH 自身的界面语言（中文 / English），无需单独开关。
- 秒开体验 — 前端模块级缓存 + 后端 60 秒聚合缓存，重进设置立即显示，后台静默更新。
数据指标（面板顶部六张卡片）
| 卡片 | 含义 |
|---|---|
| 总费用(USD) | 全部调用按计费口径的美元总费用 |
| 总费用(≈RMB) | USD × 实时汇率 |
| 总 Token | 输入 + 命中 + 输出 + 推理的全部 token |
| 会话 / 调用 | 有调用的会话数 / 总调用次数 |
| 平均token价格 | 总费用(CNY) ÷ 总token(百万) = 元/M |
| 推理占比(占输出) | 推理 ÷ (输出+推理)，反映思考量占比 |
计费口径：miss = 输入未命中 + 写入缓存；hit = 命中缓存；out = 输出 + 推理；费用 = miss×未命中价 + hit×命中价 + out×输出价。
两张明细表：
- 按模型用量：模型 / 输入·未命中 / 输入·命中缓存 / 缓存命中率(三色) / 输出 / 推理 / 调用 / 费用。
- API 单价：模型 / 输入·命中 / 输入·未命中 / 输出 / 保存·删除（每行小图标按钮，可新增模型）。
安装
# npm 安装
dsh plugin --profile web add dsh-usage-cost
# 或直接从这个仓库安装
dsh plugin --profile web add github:lin-nanxing/dsh-usage-cost
# 或本地安装（需要 pnpm，无需 dsh 命令）
bash scripts/install.sh重启 dsh web 后，打开界面的 设置 → 用量与费用。独立的 http://127.0.0.1:<端口>/usage-cost 页面也保留可用。
License
MIT