zoumutou/dsh-cost-balance
DeepSeek Harness 插件:输入框下方 iOS 风格统计条——会话花费、账户余额、缓存命中、Token 用量一键展开
Project Overview项目介绍
dsh-cost-balance is a DeepSeek Harness Web UI plugin that displays an iOS-style bar beneath the input box, expanding into a translucent panel showing session cost, account balance, cache hit rate, and token usage. Cost is computed from model pricing, while balance is fetched in real time from DeepSeek's official API and refreshed every 60 seconds. Use it to monitor spending and quotas. Note: built-in prices may require override via cordis.patch.yml when models or rates change.
dsh-cost-balance 是 DeepSeek Harness Web UI 插件,在输入框下方展示 iOS 风格黑条,点击展开半透明面板,查看会话花费、账户余额、缓存命中与 Token 用量等统计。花费按模型定价与官方 API 实时计算余额,60 秒自动刷新。适用于需要掌控调用成本与配额的使用场景。注意:价格表基于内置模型定价,模型调整或费率变动时需通过 cordis.patch.yml 覆盖。
请帮我了解并安装插件:【dsh-cost-balance】【https://github.com/zoumutou/dsh-cost-balance】
Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.把上面这条消息直接发给当前会话里的 DSH,让它帮你了解并安装。安装命令不一定准确,发给 DSH 更稳。
Or use CLI install (for developers)或使用命令行安装(适合开发者)
CLI Install命令行安装
dsh plugin --profile web add dsh-cost-balance
把 zoumutou/dsh-cost-balance 加入你的 DSH 配置(web profile)即可启用。
READMEREADME
dsh-cost-balance
DeepSeek Harness(DSH)Web UI 插件:在输入框下方显示一条 iOS 风格的小黑条,点击展开轻盈的半透明多行面板,查看会话花费、账户余额、缓存命中、Token 用量等统计。
默认折叠为一条居中的小黑条(类似 iOS 底部横条),点击展开毛玻璃面板:
| 行 | 内容 |
|---|---|
| 轮次 · 步数 | 3 轮 · 12 步 |
| LLM 耗时 / 工具调用 | 45.2s / 12.3s |
| 首 token 平均 / 吞吐 | 1.4s / 25.4 tok/s |
| 缓存命中 | 87% |
| Token | 输入 12.2K · 输出 517 |
| 花费 | $0.0123(本会话,按官方定价) |
| 余额 | ¥9.00(DeepSeek 账户实时余额,60s 自动刷新) |
安装(npm 发布版)
dsh plugin --profile web add dsh-cost-balance
该命令从 npm registry 拉取已发布的 dsh-cost-balance(dsh.bundle),自动加入 profile 的 bundle 层。
然后重启(或刷新)DSH Web UI。卸载:dsh plugin --profile web remove dsh-cost-balance。
工作原理
- Client 半(
lib/client.js):注册在conversation.composer.dock槽位(接管 shipped 的stats单元格,与产品自带统计行同源同数据),展示折叠/展开 UI;通过同源GET /api/cost-balance读取数据,每 60 秒自动刷新,token 用量变化时即时重算。 - Host 半(
lib/index.js):经webServer注册/api/cost-balance路由——花费按会话累计 token(未命中输入 / 缓存命中 / 缓存写入 / 输出)× 模型单价计算;余额经credentials服务解析DEEPSEEK_API_KEY后调用 DeepSeek 官方GET /user/balance(60s 缓存、失败 30s 抑制)。
余额取自用户自己的 API Key 账户,无需任何配置;未配置或抓取失败时面板显示 余额 --。
定价与覆盖
内置 DeepSeek 官方定价(USD / 1M tokens):
| 模型 | 缓存命中 | 缓存未命中 | 输出 |
|---|---|---|---|
| deepseek-v4-flash | $0.0028 | $0.14 | $0.28 |
| deepseek-v4-pro | $0.003625 | $0.435 | $0.87 |
DeepSeek 将于 2026-08-16 16:00 UTC 起切换峰谷计费(off-peak 为 peak 的一半)。价格变更时无需等插件更新——在 profile 的
cordis.patch.yml里覆盖即可:
# ~/.dsh/profiles/<你的profile>/cordis.patch.yml
- id: cost-balance
config:
prices:
deepseek-v4-flash:
cacheHit: 0.014
cacheMiss: 0.44
output: 1.32
(覆盖是整行替换,务必保留 id: cost-balance。)
从源码安装(开发)
git clone https://github.com/zoumutou/dsh-cost-balance.git
cd dsh-cost-balance
dsh plugin --profile web add .
发布新版本:修改 package.json 的 version 后 npm publish(账号需 2FA 绕过 token,见 npm 文档)。
许可
MIT
feiyang-dev/dsh-usage-plugin
nonewind/dsh-spend
MeteorNOX/DeepSeek-Balance-Whale-Widget
wssfk12138/dsh-damage-pulse
Ychris12138/dsh-usage-stats
yxxbc/dsh-balance-plugin
Lxiayu/DshCockpit
Witherwithwinter/DeepSeek-Balance-Whale-Widget-Bowl