dsh-balance

DeepSeek API 余额显示插件(dsh bundle):在 dsh web 的对话输入框下方常驻显示账户剩余金额,每 60 秒自动刷新,并为模型提供 check_balance 工具。

中文 | English

特性

• 🖥️ Web 常驻读数 — 输入框下方与统计信息同一排显示 DeepSeek 余额:¥xx.xx,悬停显示赠送/充值明细
• 🤖 模型工具 — 注册 check_balance,直接对 agent 说"查下余额"即可
• 🔐 零密钥泄露 — API key 只存在于宿主进程(经 dsh credentials 服务解析 DEEPSEEK_API_KEY),浏览器只拉取宿主缓存的 JSON 摘要
• 📦 一条命令安装 — 声明 dsh.bundle,安装后自动加入 profile 层并挂载自身 patch,无需手改任何配置文件
• ⚡ 常驻缓存 — 宿主每 60 秒查询一次官方余额接口,客户端同源拉取,不依赖模型调用

效果

对话输入框下方(与上下文统计同一排)显示一行小字:

DeepSeek 余额:¥14.39

• 悬停显示明细:赠送 0.00 / 充值 14.39
• 查询失败时显示错误原因,60 秒后自动重试

环境要求

• dsh(deepseek-harness)web 部署,Node.js ≥ 18(宿主使用内置 fetch)
• DeepSeek API key 已配置,且 credentials 服务可解析 DEEPSEEK_API_KEY(通常位于 $DSH_HOME/.credentials.yaml)

安装

从 GitHub 安装(推荐)

dsh plugin --profile web add git+https://github.com/Yogioo/dsh-balance.git

安装器自动把 dsh-balance 追加到 dsh.profile.bundles(因为包声明了 dsh.bundle),自带 patch 完成挂载。重启 dsh web 后生效,刷新页面即可看到读数。

从 tarball 安装

dsh plugin --profile web add ./dsh-balance-0.1.0.tgz

本地开发安装

dsh plugin --profile web add file:C:/projects/dsh-balance

验证

dsh --profile web --dump-config    # 组合树中应出现 # == dsh-balance 行
curl http://127.0.0.1:3080/balance # 返回余额 JSON

配置(可选)

默认无需配置。如需覆盖,在 profile 的 cordis.patch.yml 中按行 id 覆盖(整行替换 config):

- id: dsh-balance
  config:
    baseUrl: https://api.deepseek.com   # 供应商 API 根地址
    apiKeyEnv: DEEPSEEK_API_KEY         # 凭据引用名(credentials 服务解析)
    refreshMs: 60000                    # 自动刷新间隔(毫秒)
    routePath: /balance                 # webServer 路由路径

架构