返回目录

dsh-usage-billing

精选清单收录维护状态: 活跃

940842546/dsh-usage-billing

用量与费用统计插件,支持峰谷计价、浮动汇总面板、分会话明细与多维热度图。

前往 GitHub
$ dsh plugin add dsh-usage-billing

安装

dsh 没有统一的安装命令——把该插件 README 中的配置行加入你的 profile/patch 配置,然后重启即可。

了解安装方式

9

星标

1

Fork

JavaScript

语言

MIT

许可证

2026-08-14

创建于

2026-11-13

最近推送

README

dsh-usage-billing · DeepSeek 用量与消费统计插件

Awesome DSH Plugin Awesome DSH Plugin

中文 | English

针对 DeepSeek Harness 的免构建双面插件:自动统计本机所有会话的 DeepSeek 模型调用,按官方定价分段计费,并在主界面与设置页提供图表化的用量面板。

计费口径:2026-08-17 00:00(北京时间)前旧价;之后峰谷定价(高峰为工作日 9:00–12:00、14:00–18:00(2026-08-23 起生效,此前周末同样计高峰),空闲价为高峰价的一半;9/10 12:00 起 flash 系列再次调价(空闲 hit 0.02 / miss 1 / out 4,高峰 ×2,pro 不变;V4 Pro 官方已确认 9/14 后继续提供服务、计费方式不变(仍按 pro 价;插件保留路由开关供将来官方恢复路由时开启,当前关闭)))。法定节假日与调休上班的周末全天空闲计费(内置 2026 年国务院放假安排,可在设置中自行增补)。价格表见文末。

功能

  • 全自动统计:监听 llm/stream,所有会话的每次模型调用都会被记录(输入/输出/缓存命中/未命中 tokens)
  • 历史回填:首次启动自动扫描本机会话日志,重建历史用量与消费,并附会话标题
  • 分段计费:按北京时间自动归入「调价前旧价 / 调价后高峰 / 调价后空闲」三段(2026-08-23 起高峰仅限工作日,周末全天空闲;此前周末同样计高峰;法定节假日与调休上班日全天空闲,节假日名单可在设置页编辑,2027 年安排公布后可自行增补)
  • 面板内快速设预算:详情面板底部「今日预算已用」一行可点击,弹出日/月预算设置(留空即不限),保存后立即生效
  • 预算告警通知:跨 80%/100% 阈值时桌面 toast 主动提醒(每日每档一次),进度条临近变橙、超支变红
  • 月度预测与突增提醒:统计弹窗与设置页常显「本月已用 · 预计月底 · 近 7 天日均」(按本月已过天数线性外推,无需设置预算);今日花费达到近 7 天日均 3 倍(且 ≥¥1)时弹一次「花费突增」提醒(每天最多一次)
  • 定价可配置:价格表、高峰时段、调价边界日期、美元汇率均可编辑(改动只对后续调用生效),一键恢复默认
  • 第三方模型计价:内置 GLM / Grok / 混元 HY4 的官方标准价(可按模型名子串匹配、CNY 或 USD,USD 按汇率折算),这些调用不再记为 ¥0;设置页可增删改规则。Kimi 的官方价表暂未提供可抓取的数字,需要手动添加。
  • 数据导出:一键导出 CSV(按日 / 按会话,文件名含日期范围)或 JSON,便于对账
  • 官方余额拉取:自动检测已配置的 DeepSeek API Key,拉取官方账户余额(总余额 / 充值 / 赠金),每 10 分钟自动刷新,未配置 Key 时静默跳过
  • 余额续航预估:按近 7 天日均花费估算余额可用天数与预计耗尽日期
  • 余额低阈值提醒:余额低于阈值(默认 20,可留空关闭)时提醒一次,跌破阈值一半再提醒一次(每天最多两次)
  • 告警历史:设置页展示最近预算告警记录
  • 日趋势图:设置页近 30 天每日费用柱状图
  • 统计更稳健:写入带 temp 副本,主文件损坏时自动恢复;双实例心跳检测告警
  • 主界面:
    • 侧边栏底部「Token 用量」卡片(当前模型 + 本会话 tokens/费用,千分位显示,底部近 7 天花费迷你趋势,悬停看每天金额)→ 点击弹出居中「Token 用量与费用统计」弹窗(¥/USD 币种切换、总览卡片、按模型/按会话表格(斑马纹、表头点击排序)、预算进度、官方余额、分段占比、用量热力图)
    • 输入框下方常驻一行当前会话的用量:环形进度(今日预算,≥80% 变橙、≥100% 变红)+ 花费/调用/tokens,点击弹出详情面板(本会话累计花费与本会话今日花费、按计费时段着色的占比条、调用/输入/缓存命中率/输出明细、时段花费、模型分布、今日预算进度;悬停「本会话今日」显示全部会话今日合计;Esc 或点击面板外关闭)——交互与样式对齐官方 ContextMeter
  • 设置页 → 用量统计:完整明细(统计卡片、预算进度、分段占比、日/周/月/年/累计热力图(悬停即时显示 token 与金额)、按会话 Top 8(可点击打开对应会话)、按模型、最近调用、回填/清空/导出、计费与预算设置)
  • 动态工具 usage_billing:模型可直接查询统计(“现在用了多少钱?”“今天呢?”——支持 today/month/all 范围;group 可按 band/model/session/day 给出花费排行,session 可按会话 id 或标题筛选并返回该会话的时段/模型分布,limit 控制条数)
  • 持久化:数据写入写策略根目录 .dsh-usage-billing.json,重启不丢(v0.5.4 前为 .dsh-usage-stats.json,升级后自动迁移)
  • 中英双语:所有界面文案跟随应用语言设置即时切换(中文 / English)

界面预览

以下截图基于虚构演示数据。

统计弹窗 · 总览(主界面侧边栏卡片点开)

统计弹窗总览

统计弹窗 · 图表区(分段占比 + 用量热力图,支持 ¥/USD 切换)

统计弹窗图表

美元模式(弹窗右上角一键切换,汇率换算)

美元模式

设置页 · 用量统计

设置页概览

安装

方式 A:npm 一键安装(推荐,预构建)

dsh plugin --profile web add dsh-usage-billing

npm 包:https://www.npmjs.com/package/dsh-usage-billing

应用启动时通过本包的 dsh.bundle.patch(cordis.patch.yml)自动挂载,无需任何其他配置。

⚠ 不要直接修改官方 bundle(如 @deepseek-ai/dsh-web-app/cordis.patch.yml), 也不要把插件放进 npm-cache\_npx 缓存(npm reify 会随时重建并留下悬空链接)。

本地路径形式同样支持:dsh plugin --profile web add <本仓库路径>。

📌 link:/本地 link 开发安装的机器绑定说明:@deepseek-ai/dsh-tools 由宿主 dsh 提供(见 peerDependencies),npm 上暂无匹配版本,因此本地 link 安装时它解析自 宿主侧。若插件的 node_modules 中没有对应链接,可在插件目录建一个指向 dsh 农场的 junction(农场由当前活跃引擎自动维护,跟随引擎版本):

New-Item -ItemType Junction -Path "node_modules\@deepseek-ai\dsh-tools" `
  -Target "$env:USERPROFILE\.dsh\profiles\node_modules\@deepseek-ai\dsh-tools"

该 junction 与本机 ~/.dsh 绑定,换机器需重建(dsh plugin add 本地路径方式 不受影响);npm 方式安装(方式 A)完全无此问题。

方式 B:用户级补丁(不动 profile)

把本仓库根目录的 cordis.patch.yml 内容加入:

%USERPROFILE%\.dsh\cordis.patch.yml
- insert:
    - id: usage-billing
      name: 'dsh-usage-billing'

内置进打包部署(开箱即用)的完整方案见 PUBLISH.md。

数据与口径

数据 位置 / 说明
统计文件 写策略根目录下 .dsh-usage-billing.json(通常为用户主目录)
计费时段 北京时间;调价边界 2026-08-17 00:00
计费单位 元 / 百万 tokens

价格表(元 / 百万 tokens):

时段 模型 命中 未命中 输出
8/17 前 flash 0.02 1 2
8/17 前 v4-pro 0.025 3 6
8/17 后·空闲 flash 0.05 1.5 4.5
8/17 后·高峰 flash 0.10 3.0 9.0
8/17 后·空闲 v4-pro 0.15 4.5 13.5
8/17 后·高峰 v4-pro 0.30 9.0 27.0
9/10 12:00 后·空闲 flash 0.02 1 4
9/10 12:00 后·高峰 flash 0.04 2 8

模型按名称子串归类计价:名字含 flash(含新名 deepseek-flash 及旧名 deepseek-v4-flash、deepseek-v4-flash-vision-exp——旧名已下线、由 V4.1-Flash 服务并同价计费)按 flash 档,含 pro 按 pro 档,其余归入「未定价/免费」;命中自定义价目的模型优先按自定义价计费并归入「其他模型」(因此 glm-5.3-flash 不会被误判成 DeepSeek flash 档)。

节假日计费:内置 2026 年(国办发明电〔2025〕7号)与 2027 年(国办发明电〔2026〕10号)国务院放假安排,含放假日期与调休上班日,命中即全天空闲;设置页「非高峰日」可编辑(每行一个 YYYY-MM-DD),后续年份公布后可自行增补。

内置第三方模型价目(元或美元 / 百万 tokens,2026-11 渲染官方定价页核对;共 71 条,设置页可增删改):

在 GitHub 阅读完整 README →

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。