Back to directory

dsh-balance

Maintenance: Active

twotwopiggy/dsh-balance

Real-time token tracking and accurate session cost estimation with dynamic peak/off-peak pricing for DeepSeek Harness.

View on GitHub
$ dsh plugin add dsh-balance

Install

dsh has no central install command — add this plugin’s entry (documented in its README) to your profile or patch config, then restart.

How installs work

12

stars

3

forks

JavaScript

Language

2026-08-13

Created

2026-11-20

Last push

README

dsh-balance

DeepSeek 余额实时显示插件: 在 dsh Web UI 输入框下方、命中率/输入输出 token 统计条所在的同一行, 实时显示:

  • 账户余额与充足度状态指示灯(如 🟢 余额 ¥97.69, 红/黄/绿三色直观反映余额充裕状况,点击状态圆点可直接手动强刷查询最新余额)
  • 本次对话的估算消耗(如 本会话约 ¥3.92, 按模型、按 DeepSeek 官方单价估算)
  • ? 定价参考图标: 悬停以 ? 为中心优雅浮现 DeepSeek V4 系列专属定价微卡片(全面支持官方主名 deepseek-flash(V4.1 Flash),以及 deepseek-v4-flash、deepseek-v4-flash-vision-exp 多模态视觉模型与 deepseek-v4-pro),点击直达官方定价页 https://api-docs.deepseek.com/zh-cn/quick_start/pricing/

悬停读数可查看左右双栏毛玻璃卡片:

  • 左栏【📊 账户余额】:实时大字总额、充足度 Badge、充值与赠送金额构成、5分钟自动刷新时间戳点击指示灯强刷指引以及偏好设置快速入口。
  • 右栏【⚡ 本会话消耗】:当前会话预估总花费、按模型细分明细(如 • deepseek-v4-flash: ¥3.92)、换行小字体展示输入/输出与缓存命中统计(如第一行 Token: 输入 124M · 输出 301K 与第二行 命中: 123M (99.3%))。
  • 时间感知引擎:内置 DeepSeek 谷峰计费自动切换机制(北京时间周一至周五 09:00~12:00, 14:00~18:00 为峰时 2 倍计费 / 其余时段含周末全天享 5 折空闲特惠),并严格对齐 2026-09-10 12:00 起生效的 Flash 最新降价分水岭,全自动无缝同步。
  • 显示时区(Timezone):设置面板可将峰时窗口换算为任意 IANA 时区展示(如 Europe/Moscow 显示为 04:00~07:00 / 09:00~13:00);计费判定始终锚定北京时间,切换时区不会影响会话消耗估算。

示例预览图

架构

┌─────────────┐  按 refreshIntervalMs 轮询   ┌──────────────────┐
│ DeepSeek API│◀────────────────────────────│ 服务器插件(host)  │
│ /user/balance│                            │ · 余额缓存(带陈旧回退)│
│             │  ?force=1 手动强刷路由       │ · /query-balance 路由│
└─────────────┘                             │ · queryBalanceCost  │
                                            │   会话花费投影(含V4谷峰)│
                                            └────────┬───────────┘
                                                     │ 只读缓存 / 投影推送帧
                                            ┌────────▼───────────┐
                                            │ 浏览器插件(client)   │
                                            │ · 双栏悬停卡片      │
                                            │ · 点击指示灯手动强刷  │
                                            │ · 单例轮询器(页面隐藏 │
                                            │   时暂停)            │
                                            └────────────────────┘
  • 性能: 浏览器只读本地缓存(每 clientPollIntervalMs 一次极小 JSON), 不直接访问 DeepSeek; 服务器按 refreshIntervalMs 拉取并缓存(失败保留上次成功值); 花费由投影折叠计算 (与 dsh-token-meter 相同的 O(1) 状态机, 同引用事件零开销), 随既有 session/projection 推送帧实时到达客户端, 无额外网络请求。
  • 手动强刷: 点击状态指示灯按钮可直接穿透缓存向 DeepSeek 官方发起实时查询,服务端内置 2000ms 冷却防刷保护。
  • 密钥: 复用 Harness 的 credentials 能力(ctx.credentials), 默认引用 DEEPSEEK_API_KEY(即 $DSH_HOME/.credentials.yaml 或进程环境), 无需在配置里写密钥。
  • 同行动态布局: 组件全 Flex 居中对齐,与输入框底部统计条完美处于绝对水平中线。

安装

方式一:使用 DSH CLI 自动安装与配置(推荐)

DeepSeek Harness 自带的插件管理命令可以为您一键完成下载安装和修改配置文件:

# 完整版(默认):包含可视化设置面板、定价参考浮层等丰富功能
dsh plugin --profile web add dsh-balance

# 精简版(可选):纯余额与会话消耗显示,去除所有弹窗与设置界面(体积仅为 1/3)
dsh plugin --profile web add dsh-balance-lite

💡 两个版本二选一安装即可。

执行完毕后,重启 dsh web 即可生效。

方式二:让 AI 助手帮您安装

如果您正在使用 Antigravity 等 AI 助手,直接复制以下提示词发给它:

请帮我在当前环境中安装 dsh-balance 插件,将其配置写入到我的 cordis.yml 中并启用它。

方式三:本地源码安装

如果您下载了源码,可以通过以下命令进行本地链接安装:

dsh plugin --profile web add <本目录绝对路径>

升级

当插件发布新版本后,您可以通过以下命令升级到最新版本:

dsh plugin --profile web remove dsh-balance
pnpm store prune
dsh plugin --profile web add dsh-balance@latest

为什么需要 pnpm store prune? pnpm 会在本地缓存已下载的包。如果不清除缓存,即使 NPM 上已经发布了新版本, dsh plugin add 仍然可能安装到旧版本。执行 pnpm store prune 可以清除过期缓存, 确保拉取到最新版本。


卸载

使用 DSH CLI 一键卸载并自动清理配置文件:

dsh plugin --profile web remove dsh-balance

⚙️ 可视化设置面板说明

在 Web 界面输入框底部的统计条最右侧,点击 ⚙️ 齿轮图标(或在悬停卡片底部点击 ⚙️ 打开偏好设置),即可呼出可视化配置弹窗:

配置分组 包含设置项 说明
🎯 常规与阈值 计价货币、显示时区、预警阈值、告急阈值、服务端查询间隔、前端读取缓存间隔 支持实时红黄绿三色阈值指示条预览;货币切换即时反映到会话消耗与余额展示;显示时区仅影响峰谷时段文案(计费始终按北京时间)。
🔑 API 凭证 API Key、Base URL、请求超时时间、连通性测试 支持自定义 API Key(留空自动继承环境凭证);提供 ⚡ 测试 API 连通性 按钮,一键验证密钥有效性并反馈真实余额。
⚡ 模型单价 各模型(V4 Flash / V4 Pro / Chat / Reasoner)每 1M Token 的命中/未命中/输出单价 支持微调模型单价,提供“恢复官方推荐单价”按钮。
📋 YAML 导出 实时生成 cordis.patch.yml 配置代码块 随调参实时渲染 YAML 配置文本,支持一键复制到剪贴板,方便将当前参数持久化写入配置文件。

提示:在设置弹窗中点击「保存并生效」,修改将立即应用到当前服务与页面,无需手动重启 dsh web!

配置模板

在 $DSH_HOME/profiles/web/cordis.patch.yml(或指定 profile 的 patch 文件)中覆盖配置。

模板 1:标准国内人民币账户(默认开箱即用 · 包含 DeepSeek V4 系列)

- id: dsh-balance
  config:
    apiKey: ''                    # 留空自动复用 DEEPSEEK_API_KEY
    apiKeyRef: DEEPSEEK_API_KEY
    baseUrl: https://api.deepseek.com
    warningThreshold: 10          # 余额 < 10 元显示黄色预警灯
    dangerThreshold: 5            # 余额 < 5 元显示红色告急灯
    refreshIntervalMs: 300000     # 服务器向 DeepSeek 拉取余额的查询间隔(单位: 毫秒 ms,300000ms = 5分钟)
    clientPollIntervalMs: 30000   # 浏览器从本地读取缓存的刷新间隔(单位: 毫秒 ms,30000ms = 30秒)
    timeoutMs: 8000               # 单次网络请求超时时间(单位: 毫秒 ms,8000ms = 8秒)
    currency: CNY
    timezone: Asia/Shanghai       # 峰谷时段展示时区(IANA 名称, 如 Europe/Moscow); 仅影响文案, 计费判定始终按北京时间
    prices:
      deepseek-v4-flash: { cacheHit: 0.04, cacheMiss: 2, output: 8 }
      deepseek-v4-flash-vision-exp: { cacheHit: 0.04, cacheMiss: 2, output: 8 }
      deepseek-v4-pro: { cacheHit: 0.3, cacheMiss: 9, output: 27 }
      deepseek-chat: { cacheHit: 0.1, cacheMiss: 1, output: 2 }
      deepseek-reasoner: { cacheHit: 1, cacheMiss: 4, output: 16 }
    defaultPrices: { cacheHit: 0.04, cacheMiss: 2, output: 8 }

模板 2:海外美元账户(USD 计价与小额阈值)

Read the full README on GitHub →

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.