跳到正文

TwotwoPiggy/dsh-balance

61最近提交 2026年8月15日

dsh-balance DSH 插件

dsh-balance 在 DSH Web UI 输入框下方添加了实时余额和会话消耗估算功能。显示账户余额与绿/黄/红三色充足度指示灯、当前会话预估花费，以及悬停查看详细双栏卡片。插件内置时间感知计费引擎，2026年8月17日后自动切换谷峰定价。

developer-tools

如何安装 dsh-balance DSH 插件

dsh plugin --profile web add dsh-balance

复制不会执行命令。安装 dsh-balance DSH 插件前请核对仓库和版本。

dsh-balance DSH 插件数据来源

dsh-balance DSH 插件快照日期：2026年8月16日

discovered

dsh-balance DSH 插件能做什么

  • 实时余额显示，带颜色编码的充足度指示灯（绿/黄/红），点击指示灯可手动强制刷新
  • 基于 DeepSeek 官方每 Token 单价估算本会话消耗，支持 V4 Flash 和 V4 Pro 模型
  • 悬停卡片双栏布局，左侧账户余额详情，右侧按模型细分的会话消耗
  • 时间感知计费引擎，2026年8月17日后自动应用峰时/谷时定价（谷时5折）
  • 可视化设置面板，可在输入栏底部调出，调整阈值、货币、API Key、自定义定价和 YAML 导出
  • 服务端缓存（陈旧回退）和浏览器端轮询，页面隐藏时暂停轮询
  • 手动强制刷新带 2000ms 冷却保护

dsh-balance DSH 插件适合哪些场景

  • 实时监控 DeepSeek 账户余额，避免长对话期间因欠费中断
  • 估算每次会话花费，跟踪 API 使用成本并优化调用
  • 根据个人预算敏感度配置自定义预警/告急阈值
  • 切换 CNY/USD 货币并匹配对应定价模板，方便全球用户
  • 使用不同 Profile 和端口隔离开发与生产环境

dsh-balance DSH 插件适合谁

  • 频繁监控 DeepSeek 账户余额的 API 用户
  • 希望在 DSH Web UI 中集成成本可见性的用户
  • 管理多个环境多个 DeepSeek API Key 的开发者和运维人员

dsh-balance DSH 插件的限制

  • 仅支持 DeepSeek 官方 API 端点，不兼容其他供应商
  • 会话消耗估算依赖用户配置的模型单价；未列出的模型使用默认价格，可能不准确
  • 手动强制刷新有 2000ms 内置冷却，快速点击会被限制
  • 可视化设置面板仅在 DSH Web UI 中可用；终端用户需直接编辑 YAML

dsh-balance DSH 插件的仓库 README 摘录

以下文字摘自 dsh-balance DSH 插件的上游仓库 TwotwoPiggy/dsh-balance 的 README，版权归原作者，仅作引用。

DeepSeek 余额实时显示插件: 在 dsh Web UI 输入框**下方、命中率/输入输出 token 统计条所在的同一行**, 实时显示: - **账户余额与充足度状态指示灯**(如 `🟢 余额 ¥97.69`, 红/黄/绿三色直观反映余额充裕状况，**点击状态圆点可直接手动强刷查询最新余额**) - **本次对话的估算消耗**(如 `本会话约 ¥3.92`, 按模型、按 DeepSeek 官方单价估算) - **`?` 定价参考图标**: 悬停以 `?` 为中心优雅浮现 **DeepSeek V4 系列专属定价微卡片**（支持 `deepseek-v4-flash` 与 `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%)`）。 - **时间感知引擎**：内置 2026 年 8 月 17 日起 DeepSeek 谷峰计费自动切换机制（09:00~12:00, 14:00~18:00 峰时 / 其他时段 5 折谷时），全自动无缝同步。 ![示例预览图](./assets/preview.png) ## 架构 ``` ┌─────────────┐ 按 refreshIntervalMs 轮询 ┌──────────────────┐ │ DeepSeek API│◀────────────────────────────│ 服务器插件(host) │ │ /user/balance│ │ · 余额缓存(带陈旧回退)│ │ │ ?force=1 手动强刷路由 │ · /query-balance 路由│ └─────────────┘ │ · queryBalanceCost │ │ 会话花费投影(含V4谷峰)│ └

阅读完整 README仓库未声明许可，使用前请先与作者确认。

dsh-balance DSH 插件常见问题

如何安装 dsh-balance？

在终端中执行 `dsh plugin --profile web add dsh-balance` 即可一键安装。安装完成后，重启 `dsh web` 使插件生效。你也可以使用 README 中提供的 AI 助手提示词模板，让 AI 帮你自动完成安装。

如何配置预警和告急阈值？

编辑 Profile 目录下的 `cordis.patch.yml` 文件（例如 `$DSH_HOME/profiles/web/cordis.patch.yml`），设置 `warningThreshold` 和 `dangerThreshold` 的值。例如，要设置预警 10 元、告急 5 元，可使用标准模板。保存后修改立即生效。

能否使用美元账户？

可以。在配置中将 `currency` 设为 `USD`，并调整对应的阈值和定价。README 提供了完整的美元账户模板，包含预警 2.0 美元、告急 0.5 美元以及 DeepSeek V4 模型的美元定价。

如何手动刷新余额而不等待轮询间隔？

在 DSH Web UI 中点击余额显示区域的状态指示灯（彩色圆点），即可触发手动强制刷新，直接查询 DeepSeek API 获取最新余额。注意每次手动刷新有 2000ms 冷却时间，防止频繁请求。

如何更新 dsh-balance 到最新版本？

先执行 `dsh plugin --profile web remove dsh-balance` 移除旧版本，然后运行 `pnpm store prune` 清除 pnpm 缓存，最后执行 `dsh plugin --profile web add dsh-balance@latest` 安装最新版本。这样可以确保拉取到最新发布，而不是缓存的旧版本。