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 覆盖。

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

npm version npm downloads License: MIT

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.jsonversionnpm publish(账号需 2FA 绕过 token,见 npm 文档)。

许可

MIT

上一个 Prev dsh-plugin-auth-webserver 下一个 Next dsh-ccswitch-importer