dsh-usage-balance-v2
Balance readings in the DSH Web bottom usage bar: current session spending, total session duration, remaining balance, and peak/off-peak periods, embedded between the official token usage and context percentages
The plugin will be installed here. Keep web if you are unsure.
npx -y @deepseek-ai/dsh plugin --profile web add github:3493750852/dsh-usage-balance-v2#4db38b79f0067cc3c0b0300d2c637c30de64dc0a
Usage Balance V2 is published as dsh-usage-balance-v2 and currently resolves to version 1.0.0. The Hub verifies its manifest and preserves the exact installation source for reproducible installs.
中文 | English
DSH Web 底部用量条旁的余额/消耗读数插件。
默认嵌在原生统计条的 token 用量与上下文百分比之间，沿用原生字号、颜色和分隔符风格：
… 4.8M tok · 缓存命中 98% [¥] ¥0.77 [⏱] 4m50s [◉] ¥230.88 峰 ⌄ 13%
三个读数分别是：本会话消耗、本会话总用时、剩余余额；金币/时钟/钱包都是简易内联 SVG 图标。
点击展开详情卡：
tokenUsage 投影的整段会话 token（缓存命中 / 未命中 / 输出），分别乘以当前峰/谷单价。详情卡直接列出乘法公式，例如
缓存 4.7M × ¥0.04/M + 未命中 73k × ¥2/M + 输出 54k × ¥8/M。
不是只统计插件启用后的轮次，因此和原生 tok 数对得上。sessionStats 投影的 LLM + 工具 时间，并显示步数。DEEPSEEK_API_KEY 调 DeepSeek /user/balance；
没有 API key 时回退到 DSH 账号登录态的余额服务（充值钱包 + 赠金钱包）。
展开后显示充值/赠金构成；失败时显示具体原因。布局上把三个读数放在原生 token 用量 与 上下文百分比 之间，用 14px 简易图标 + 紧凑数字，不额外增加行高，也不会把原生用量挤成省略号。
不会在每轮结束时弹窗；所有明细都收在点击展开的详情卡里。
价目表（人民币 / 百万 tokens，[谷时, 高峰]）：
| 模型 | 缓存命中 | 未命中输入 | 输出 |
|---|---|---|---|
deepseek-flash / deepseek-v4-flash / deepseek-v4-flash-vision-exp | 0.02 / 0.04 | 1 / 2 | 4 / 8 |
deepseek-v4-pro | 0.15 / 0.3 | 4.5 / 9 | 13.5 / 27 |
价目与节假日集中在 lib/pricing.mjs 的 PRICING、PEAK_HOURS、HOLIDAY_VALLEY。
2027 年及以后，国务院公布节假日安排后需要补 HOLIDAY_VALLEY。
本插件不依赖任何 @deepseek-ai/* npm 包，不会触发 DSH 的版本兼容性拦截。
git clone https://github.com/3493750852/dsh-usage-balance-v2.git
$plugin = (Resolve-Path .\dsh-usage-balance-v2).Path
New-Item -ItemType Junction `
-Path "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\dsh-usage-balance-v2" `
-Target $plugin
Web profile 把路径里的 desktop 换成 web。
cordis.patch.yml 末尾追加- insert:
- id: dsh-usage-balance-v2
name: dsh-usage-balance-v2
DSH profile 默认 patchReload: live，保存后宿主会热加载；刷新一次页面即可看到读数。
如果刷新后仍不显示，重启一次 DSH。
fetch('/dsh-usage-balance-v2/state.json').then((r) => r.json()).then(console.log)
应返回 { ok: true, totals, balance, pricing, lastTurn, ... }。
$DSH_HOME/.dsh-usage-balance-v2.json
totals 是累计值，today 按北京时间每天自动清零。本会话（外部读数与详情卡主值）：
费用 = 缓存命中 tokens / 1e6 × 命中价
+ (未缓存输入 + 缓存写入) / 1e6 × 未命中价
+ 输出 tokens / 1e6 × 输出价
token 直接取 DSH 官方 tokenUsage 投影的整段会话累计值；价格按当前峰/谷时段取。
reasoningTokens 已包含在 outputTokens 中，不再单独加。
最近一轮：宿主按每一步 assistant/message 的真实 usage 与该步到达时的峰谷价累计，
所以跨 12:00 / 18:00 的轮次会按实际时段拆价。
不会在每轮结束时弹窗；所有信息都收在点击展开的详情卡里。
MIT