nabin-qq273274877/dsh-model-balance 预览 preview

nabin-qq273274877/dsh-model-balance

Plugin插件 Native原生 ⭐ 3 MIT Usage & Cost用量与计费

为DeepSeek Harness Web GUI提供多供应商真实账户余额显示

Project Overview项目介绍

This is a native plugin built exclusively for the DeepSeek Harness Web GUI. It adds balance or remaining quota capsules for multiple LLM providers right in front of DSH's model selector, and updates the balance automatically whenever usage changes. When you switch models, it immediately displays the current balance for the selected provider, and currently supports official API queries from more than 6 popular providers including DeepSeek, StepFun, OpenRouter, and xAI. For providers without a public balance endpoint, it supports opening their console page in a new tab for manual checking.

After installation, no extra complex configuration is required if you already have your provider API keys set up correctly in DSH. It automatically caches query results for successful responses for 60 seconds to reduce unnecessary API calls, so API keys never reach the browser, which keeps your credentials secure. You can add custom providers by editing a local configuration file, or you can submit a pull request to the repository to add support for new providers for all users. It is especially useful for DSH users who manage multiple LLM provider accounts at the same time.

The plugin is released under the open-source MIT license, so you can use it, modify it, and redistribute it freely per the license terms. There are three supported installation methods: via npm, via direct GitHub install, or via local link for local development testing. After any installation or configuration change, you need to restart the DSH web service and refresh your browser page for changes to take effect. Currently, providers like Mistral, Groq, and Cohere do not have support for balance queries yet. Custom providers must follow the specified JSON configuration format to work correctly.

这是一个专为 DeepSeek Harness Web GUI 开发的原生插件,核心功能是在 DSH 的模型选择器前方显示多供应商的账户余额或剩余配额胶囊。切换模型时会立即展示对应供应商的余额,每次用量变动后也会自动刷新,当前支持 DeepSeek、StepFun、OpenRouter、xAI 等多个主流大模型供应商的官方接口查询,对未提供公开接口的供应商也支持跳转控制台查看。

用户安装插件后无需额外复杂配置,只要对应供应商的 API Key 已经按 DSH 要求正确配置,插件就会自动读取凭据查询余额,API Key 全程不会流出到浏览器,保障了凭据安全。插件支持用户自定义添加新供应商,既可以修改本地配置文件快速添加,也可以提交 PR 贡献代码适配新供应商,适合需要同时管理多个大模型账户的 DSH 用户使用。

插件采用 MIT 许可证开源,可免费使用和修改。安装可通过 npm 命令、GitHub 地址或本地开发链接三种方式完成,安装后需要重启 DSH Web 服务并刷新页面才能生效。目前 Mistral、Groq、Cohere 等供应商暂不支持余额查询,自定义添加新供应商需要符合指定的 JSON 配置格式,修改配置后也需要重启 DSH 生效。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

npx @deepseek-ai/dsh plugin --profile web add dsh-model-balance

把 nabin-qq273274877/dsh-model-balance 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-model-balance

npm License: MIT

中文 | English

为 DeepSeek Harness Web GUI 提供多供应商真实账户余额显示。

在 composer 的模型选择器前面显示余额胶囊。切换模型 → 立即显示该供应商的余额。每次用量变动自动刷新。

目前支持的供应商

供应商 查询接口 数据类型 状态
DeepSeek GET /user/balance 账户余额(¥) ✅ 官方接口
DeepSeek Account(官方登录) Host 账号服务 get_user_summary 充值余额 + 赠金(¥) ✅ 官方登录
StepFun GET /v1/accounts 账户余额(¥) ✅ 官方接口
Kimi Coding GET /v1/usages 配额(7 天 + 5 小时) ✅ 官方接口
OpenRouter GET /api/v1/auth/key Credit 余额 ($) ✅ 官方接口
MiniMax GET /v1/token_plan/remains 剩余额度 ✅ 官方接口
xAI / Grok GET /v1/dashboard/billing/credit_grants Credit 余额 ($) ✅ 官方接口
通义 Token Plan 百炼控制台 登录查看 🔗 需登录
小米 MiMo 小米平台控制台 登录查看 🔗 需登录
Mistral、Groq、Cohere 等 — — ⚠️ 暂不支持

添加新供应商? 有两种方式:

  1. 配置文件(推荐):编辑插件目录的 providers.json 或创建 ~/.dsh/model-balance-providers.json
  2. 提交 PR:参见 src/host/strategies.ts — 添加解析器 + 策略条目

显示状态

胶囊根据供应商类型显示四种状态:

金额余额

金额余额

DeepSeek、StepFun、OpenRouter、xAI 等按金额计费的供应商,直接显示账户余额(点击刷新)。

额度百分比

额度百分比

Kimi Coding 同时显示「7 天周额度」与「5 小时速率额度」的剩余百分比(鼠标悬停可看剩余次数与重置时间)。

登录查看

登录查看

千问(百炼 Token Plan)、小米 MiMo 等无 API 余额接口,点击在新页面打开对应控制台。DeepSeek Account(官方登录)在尚未登录时也是这个状态,登录后即显示钱包余额。

暂不支持

暂不支持

既无 API 接口也无公开控制台入口的供应商。

工作原理

┌─────────┐    GET /model-balance/query    ┌──────────┐   Bearer API key    ┌──────────────┐
│  浏览器  │ ──────────────────────────────→│ DSH 宿主 │ ──────────────────→│ 供应商 API   │
│  (胶囊)  │←──────────────────────────────│  (路由)   │←──────────────────│  (真实数据)  │
└─────────┘    JSON 信封                    └──────────┘   余额/配额        └──────────────┘

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-maestro-sync 下一个 Next dsh-pdf →