@zzerx/dsh-plugin-usage-billing

Plugin Usage Billing

Billing display: aggregates actual token usage from existing session logs and locks in costs based on prices at the time of each event; sidebar / entry below the input box + click popover + usage view on the settings page.

Target profile

The plugin will be installed here. Keep web if you are unsure.

npx -y @deepseek-ai/dsh plugin --profile web add @zzerx/dsh-plugin-usage-billing@1.3.1

Compatibility and provenance

Plugin Usage Billing is published as @zzerx/dsh-plugin-usage-billing and currently resolves to version 1.3.1. The Hub verifies its manifest and preserves the exact installation source for reproducible installs.

DSH compatibility: *
Runtime surfaces: web
Release source: npm
Registry updated: 11/4/2026

Versions

1.3.1stable

10/27/2026

1.3.0stable

10/8/2026

1.2.1stable

9/29/2026

Show 3 more versionsCollapse versions

1.1.0stable

9/23/2026

1.0.1stable

9/22/2026

1.0.0stable

9/22/2026

README

@zzerx/dsh-plugin-usage-billing

从既有会话日志聚合真实 token 用量，按事件发生时刻的价格写时锁定费用。入口可以放在侧栏底部或输入框下方，点开就能看到本月花了多少、离预算还有多远。不伪造样本：没有数据就显示空快照，未收录的模型绝不静默计 0。

安装

dsh plugin --profile <你的 profile 名> add @zzerx/dsh-plugin-usage-billing

用量视图在设置 → 计费里。

怎么用

两个计费入口，各自开关（设置 → 计费 →「计费入口位置」）：侧栏底部是一张卡，显示本月 / 今日金额与预算进度，卡的左侧并着一条 75×35 的 mini 峰谷图（只在侧栏宽态画）；输入框下方是一粒小胶囊，显示当前会话金额与预算饼图。两处都关掉也能从设置页看用量。
点入口弹出详情：本月已用 / 预算、累计（会话 / 项目）、今日消耗分布（本项目 / 其他项目），以及未收录模型的提示。点面板外或按 Esc 关闭。面板顶部的峰谷时段图与侧栏卡左侧的 mini 图可以在设置里一起关掉（设置 → 计费 →「显示峰谷时段图」，默认开）。
设置里的用量视图分三页：概览（累计与今日的 Token 和金额、活跃度热力图、分模型消耗）、趋势、明细（逐日 / 按模型 / 生效价目三张表，可过滤、排序、分页）。
月度预算：设置里填金额（默认 ¥100），跨 50% / 80% / 100% 各提醒一次，进度条 ≥80% 转琥珀、超支转红。
峰谷分时：北京工作日 09:00–12:00 与 14:00–18:00 按高峰价，其余时段（含周末与法定节假日全天）按空闲价 = 高峰价 × 0.5。判档按事件发生时刻定，写进账本后不再随改价变动。
价表：内置表 + models.dev 联网投影（联网优先、内置兜底），汇率取 open.er-api.com，默认每 6 小时后台刷新，也可在设置里手动刷新。联网失败会降级为内置价并标明，不假装是实时价。
自定义单价与别名：可以给某个 provider / model（也支持 <provider>/*、*/*）配自定义价；未收录或已改名的模型可以手工绑到标准模型上，只在同一个 provider 内合并展示，不改动账本。

计费口径

写时锁定：每条助手回复的 token 用量按该事件发生时刻的价格计价并写入账本，之后改价不影响历史。只有「未计价」的行可以按当前价表重算。
为什么会显示「—」：价表里没有这个模型，或命中了美元价但当时没有可用汇率 —— 这两种情况都不写金额，宁可标成不可计价，也不猜一个 0 记进账本。
安装前的历史：插件装上之前的记录没有真实价格，按安装时的价表估算，并在三处标明是估算（设置页顶部提示条、概览 / 趋势 / 明细里的「估算」角标、常驻的口径说明）。
统计维度：provider / 模型 / 天 / 会话 / 工作区，按本机时区归天。子代理会话默认计入，可在设置里筛选。
不占用模型额度：本插件不注册任何模型工具，也不注入系统提示段。

已知边界

目录刷新（含它的网络请求）期间会占用写锁，此时改自定义价要等它结束。
改了刷新间隔要等当前缓存过期才生效。
会话维度的数据由「按工作区」的分组结果带回，在明细页展开工作区时才看得到。
热力图的单格明细只在悬停 / 触摸提示里；键盘用户读到的是上方的活跃天数与区间合计。

开发

pnpm --filter @zzerx/dsh-plugin-usage-billing build       # lib/index.js + lib/client.js + lib/types
pnpm --filter @zzerx/dsh-plugin-usage-billing typecheck

License

MIT

README

@zzerx/dsh-plugin-usage-billing

安装

dsh plugin --profile <你的 profile 名> add @zzerx/dsh-plugin-usage-billing

用量视图在设置 → 计费里。

怎么用

两个计费入口，各自开关（设置 → 计费 →「计费入口位置」）：侧栏底部是一张卡，显示本月 / 今日金额与预算进度，卡的左侧并着一条 75×35 的 mini 峰谷图（只在侧栏宽态画）；输入框下方是一粒小胶囊，显示当前会话金额与预算饼图。两处都关掉也能从设置页看用量。
点入口弹出详情：本月已用 / 预算、累计（会话 / 项目）、今日消耗分布（本项目 / 其他项目），以及未收录模型的提示。点面板外或按 Esc 关闭。面板顶部的峰谷时段图与侧栏卡左侧的 mini 图可以在设置里一起关掉（设置 → 计费 →「显示峰谷时段图」，默认开）。
设置里的用量视图分三页：概览（累计与今日的 Token 和金额、活跃度热力图、分模型消耗）、趋势、明细（逐日 / 按模型 / 生效价目三张表，可过滤、排序、分页）。
月度预算：设置里填金额（默认 ¥100），跨 50% / 80% / 100% 各提醒一次，进度条 ≥80% 转琥珀、超支转红。
峰谷分时：北京工作日 09:00–12:00 与 14:00–18:00 按高峰价，其余时段（含周末与法定节假日全天）按空闲价 = 高峰价 × 0.5。判档按事件发生时刻定，写进账本后不再随改价变动。
价表：内置表 + models.dev 联网投影（联网优先、内置兜底），汇率取 open.er-api.com，默认每 6 小时后台刷新，也可在设置里手动刷新。联网失败会降级为内置价并标明，不假装是实时价。
自定义单价与别名：可以给某个 provider / model（也支持 <provider>/*、*/*）配自定义价；未收录或已改名的模型可以手工绑到标准模型上，只在同一个 provider 内合并展示，不改动账本。

计费口径

写时锁定：每条助手回复的 token 用量按该事件发生时刻的价格计价并写入账本，之后改价不影响历史。只有「未计价」的行可以按当前价表重算。
为什么会显示「—」：价表里没有这个模型，或命中了美元价但当时没有可用汇率 —— 这两种情况都不写金额，宁可标成不可计价，也不猜一个 0 记进账本。
安装前的历史：插件装上之前的记录没有真实价格，按安装时的价表估算，并在三处标明是估算（设置页顶部提示条、概览 / 趋势 / 明细里的「估算」角标、常驻的口径说明）。
统计维度：provider / 模型 / 天 / 会话 / 工作区，按本机时区归天。子代理会话默认计入，可在设置里筛选。
不占用模型额度：本插件不注册任何模型工具，也不注入系统提示段。

已知边界

目录刷新（含它的网络请求）期间会占用写锁，此时改自定义价要等它结束。
改了刷新间隔要等当前缓存过期才生效。
会话维度的数据由「按工作区」的分组结果带回，在明细页展开工作区时才看得到。
热力图的单格明细只在悬停 / 触摸提示里；键盘用户读到的是上方的活跃天数与区间合计。

开发

pnpm --filter @zzerx/dsh-plugin-usage-billing build       # lib/index.js + lib/client.js + lib/types
pnpm --filter @zzerx/dsh-plugin-usage-billing typecheck

License

MIT

Plugin Usage Billing

Compatibility and provenance

Versions

Related plugins

Plugin Usage Billing

README

@zzerx/dsh-plugin-usage-billing

安装

怎么用

计费口径

已知边界

开发

License

Compatibility and provenance

Versions

Related plugins

Related plugins

Related plugins

README

@zzerx/dsh-plugin-usage-billing

安装

怎么用

计费口径

已知边界

开发

License