dsh-usage-plugin：DeepSeek Harness 的用量与消耗统计插件

dsh-usage 是 DeepSeek Harness（DSH）的用量与消耗统计插件（DSH plugin），由 feiyang-dev 维护，采用 MIT 协议，最近更新于 2026-08。它解决的是开发者对模型调用成本不可见的问题：每次调用消耗了多少 token、缓存命中情况如何、费用如何按峰谷计费，以及账户余额还剩多少。安装后，在 WebUI 顶部会出现「用量与消耗」与「剩余余额查询」两个 tab，核心能力包括：token 用量与缓存命中统计、按 DeepSeek 峰谷/基础价格计算消耗、日历热力图、缓存命中列表、官方价格表编辑、余额查询，以及 CSV/JSON/PNG 长图导出与导入合并。

dsh-usage 这个 DSH plugin 支持哪些核心统计与计费功能？

插件会记录每次模型调用的 token 用量与缓存命中（输入未命中、缓存命中、缓存写入、输出、推理、结束原因），并按 DeepSeek 峰谷价格计算消耗，高峰时段自动按北京时间 9:00–12:00、14:00–18:00 计价。模型名以请求参数为准如实显示，非 DeepSeek 模型不再显示为「未知模型」，无官方价格的模型消耗按 0 统计。概览含「按模型」表与「按 API 服务商 × 模型」明细表，底部有总费用合计。

dsh-usage 怎么查看每日用量热力图与缓存命中列表？

「用量日历」按月展示每日用量热力图，按消耗或调用数着色，悬停查看详情（含高峰/空闲消耗拆分），点击某天可查看当日调用明细与高峰/空闲消耗统计，附本月每日统计表与月度汇总。「缓存命中列表」最新记录排在最前，支持今天/近7天/近30天/全部快捷筛选与自定义日期区间，列表分页渲染（每页 100 条），记录量大也不卡顿。

dsh-usage 怎么查询余额、编辑价格表并导出数据？

「剩余余额查询」用当前配置的 DEEPSEEK_API_KEY 查询 DeepSeek 账户余额。「价格表」展示 DeepSeek 官方 API 基础价与峰谷价，支持在面板内直接编辑并持久化到 pricing.json，也可一键恢复默认。导出支持 CSV/JSON/PNG 长图（最多含最近 2000 条，PNG 报告含高峰/空闲消耗分列统计），可导出到任意目录（原生目录选择器），导出后自动打开所在目录；导入支持 JSON/CSV 合并并按时间去重。

dsh-usage 怎么安装？

推荐使用桌面端一键安装，或使用命令行。安装命令如下：

dsh plugin --profile web add github:feiyang-dev/dsh-usage-plugin

也可对其它 profile 安装，把 web 换成对应 profile 名即可。装完重启 dsh web 服务即可生效。

dsh-usage 兼容哪些 DeepSeek Harness 版本和平台？

插件支持 Windows / macOS / Linux，路径按当前平台处理（node:path），目录选择与「打开所在目录」均调用系统原生方式（macOS 用 osascript / open，Linux 用 zenity / xdg-open），余额查询与导出不依赖 Windows 专用命令。记录实时落盘到 <会话工作区>/dsh-usage/usage-records.json，重启自动恢复（上限 100000 条）。面板字号跟随应用「显示大小」设置自动缩放，宽表格在容器内横向滑动，任何窗口大小下所有列与合计都完整可见。

查看更多 DSH 插件，访问 dsh-plugin.org