dsh-deepseek-balance：DeepSeek Harness 的实时 API 余额侧边栏指示器

kyya/dsh-deepseek-balance

模型与推理已验证
收录时间 2026-08-17
页面最后更新 2026-08-27

DSH plugin：在 Web 侧边栏实时展示 DeepSeek API 余额，状态点颜色区分可用性。

在 DeepSeek Harness 的 Web 侧边栏底部实时显示 API 余额，状态点颜色一目了然，悬停查看明细，点击强制刷新。

install
dsh plugin --profile web add github:kyya/dsh-deepseek-balance
分类
模型与推理
平台
DSH Plugin
作者
kyya
分发方式
插件

dsh-deepseek-balance 核心特性

侧边栏实时余额状态点颜色提示悬停显示明细点击强制刷新

Listed on dsh-plugin.org

dsh-deepseek-balance 仓库简介

dsh-deepseek-balance 是 DeepSeek Harness（DSH）的一个模型/推理类插件（DSH plugin），用于在 Web 侧边栏底部（设置按钮上方）实时展示 DeepSeek API 账户余额。它解决了开发者需要频繁手动查询 API 余额、难以直观监控消耗的问题。核心能力包括：状态点颜色指示（绿=可用，黄=账户不可用，红=拉取失败，蓝=加载中）、悬停显示完整明细（总额/赠送/充值/更新时间）、点击强制刷新，以及 API key 安全处理（每次拉取经 credentials 服务解析，永不下发浏览器）。该插件由 kyya 维护，采用 MIT 协议，最近更新于 2026-08。

dsh-deepseek-balance 这个 DSH plugin 支持哪些核心特性？

插件在 Node 侧（host）定时通过 GET <baseUrl><endpoint> 拉取余额（Bearer 鉴权），缓存快照，并通过 webServer.register 暴露 /deepseek-balance 接口；浏览器侧（client）向 sidebar.footer.action 插槽注册 React 指示器，每 30 秒轮询一次，点击指示器带 ?refresh=1 参数强制刷新。余额接口返回 JSON 数据，包含 is_available 和 balance_infos 数组（含货币、总额、赠送、充值等字段）。

dsh-deepseek-balance 怎么安装？

安装命令如下（支持本地目录或 git 方式），安装后需重启 dsh web 才能生效：

bash
dsh plugin --profile web add /绝对路径/dsh-deepseek-balance
# 或
dsh plugin --profile web add github:kyya/dsh-deepseek-balance
# 重启
dsh web

打开 http://127.0.0.1:3080，侧边栏左下角即可看到余额指示器。

dsh-deepseek-balance 怎么配置？

默认读取凭据 DEEPSEEK_API_KEY（来自 ~/.dsh/.credentials.yaml、环境变量或「设置 → 模型」中保存的 key）。可在 ~/.dsh/profiles/web/cordis.patch.yml 中覆盖配置，需写全字段：

yaml
- id: deepseek-balance
  config:
    refreshMs: 60000                 # 后台刷新间隔（毫秒）
    apiKeyEnv: DEEPSEEK_API_KEY      # 凭据引用名
    baseUrl: https://api.deepseek.com
    endpoint: /user/balance

dsh-deepseek-balance 如何卸载？

卸载命令：

bash
dsh plugin --profile web remove dsh-deepseek-balance

查看更多 DSH 插件，访问 dsh-plugin.org

DSH Plugin 常见问题