$ dsh plugin add dsh-balance12
スター
3
フォーク
JavaScript
言語
2026-08-13
作成日
2026-11-20
最終プッシュ
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 计价与小额阈值)
利用量・課金 の他のプラグイン
dsh-cost-meter
by han-1413141
セッション/日次 API コスト、予算使用率、公式残高、履歴ダッシュボード、公式価格ワンクリック同期(ピーク/オフピーク)
dsh-usage-stats
by ychris12138
DSH Web GUI 向けトークンヒートマップ、モデル別内訳、DeepSeek 残高
dsh-plugin-langfuse
by linyp
Langfuse 可観測性:GenAI semconv の OTel trace を Langfuse OTLP へ
dsh-token-usage
by laoyuehanni
リクエストごとのモデルのトークン使用量を日別 JSONL ファイルに記録し、Web 設定の統計ページで日次推移グラフ・モデル別内訳・日付/モデル絞り込みを表示
