前言¶

DSH 侧边栏默认不展示各模型平台的余额。开发者同时使用 DeepSeek、Kimi、OpenRouter、StepFun、Novita 等多家服务时，想确认还剩多少，需要逐个打开平台后台查看；订阅套餐的额度又是另一套口径，和按量充值的余额并不等同。dsh-balance-center 就是针对这个痛点的第三方社区插件。

下面介绍它的定位、支持范围、安装方式和实际使用步骤。

这是什么¶

dsh-balance-center 是面向 DeepSeek Harness（DSH）的第三方社区插件，由 dan-cube 维护，当前版本 1.0.0，许可证 MIT。它把多个模型平台的余额行常驻在侧边栏底部，并提供独立的「设置 → 余额与额度」页面，用于管理显示来源、排序、标签语言和刷新间隔。

一句话定位：它同时是余额中心和额度中心——余额按金额显示，订阅套餐额度按「剩余 % · 重置时间」显示。

需要先说明两点。第一，这是社区插件，项目放在 GitHub，作者为 dan-cube，不是 DeepSeek / 幻方官方出品。第二，插件以当前 DSH 进程权限运行，安装前应先查看源码和许可证，确认符合自身安全要求。

功能范围¶

显示方式¶

余额行常驻侧边栏底部、账号上方，每个平台一行，金额与币种一眼可见。打开「设置 → 余额与额度」，可以逐项选择要显示的来源，用 ↑ / ↓ 调整顺序，并单独设置每个来源行右侧的标签语言（自动 / 中文 / EN）。

刷新支持 15 秒、30 秒、1 分钟、2 分钟、5 分钟或手动；窗口重新聚焦、打开设置页时也会触发一次刷新。页面语言可跟随 DSH 应用，也可固定为中文或 English。

余额来源¶

订阅额度来源¶

订阅额度不是金额。只有对应套餐账号才能读取，普通充值账户会显示「无订阅套餐」。额度行优先展示 5 小时池，其次周池。

接入方式¶

1. 余额类：在 DSH「设置 → 模型」里添加服务商并填 API Key（DeepSeek 也可直接登录账号），插件自动识别；其他 JSON 接口用「添加自定义余额源」。
2. 订阅额度类：先订阅套餐，再用「第三方模型提供商」添加 zai / zai-coding-cn / minimax / minimax-cn / kimi-coding，填入会员 API Key 即可。插件读数不需要 OAuth，也不需要换成开放平台的按量 Key。
3. 自定义余额源：填写 GET 接口地址、鉴权方式、JSON 余额字段路径与币种。测试连接只使用已保存的密钥，未保存的密钥不会发送，需先保存再测试。鉴权源要求 HTTPS（本机回环地址除外）。

不可读连接怎么处理¶

插件只列出实际能读取的来源。某个来源没有出现，不代表模型无法调用，也可能是接口、权限或凭据暂不满足条件。设置页会区分两种情况：

• 密钥错误、网络失败等，留在「余额来源」列表内并标注原因，不会静默消失。
• 无余额接口、未配置密钥、无订阅套餐、登录过期的连接，列在「检测到的其他连接」中。

对应状态包括「未配置密钥」「无订阅套餐」「订阅登录已过期」「官方余额接口已下线（HTTP 410）」「密钥无效 / 读取失败」。

官方 DeepSeek 连接默认归并显示为一行，以减少同一账号的重复余额行；归并只展示一个可读取连接，不累加金额，也不证明这些连接属于同一账号。使用多个 DeepSeek 账号时，可开启「分开展示 DeepSeek 的多个连接」。

已知不支持的平台：OpenAI、Anthropic、Gemini、通义/百炼、火山方舟、文心/千帆、混元、Groq、Together 等只有用量/账单接口，插件不显示。SiliconFlow / 硅基流动官方已于 2026-08-14 下线 /user/info，实测返回 HTTP 410，暂无法显示，插件会在设置页标注原因。

安装与启用¶

这是 DSH 插件，需要由 DSH 安装并启用；单独运行 npm install 不会将它加载到 DSH。发布渠道为 GitHub Release tag v1.0.0，本次暂不发布 npm。

通过 DSH 插件页面¶

1. 打开 DSH 侧边栏的「插件」页面，点击「添加插件」。
2. 输入 git+https://github.com/dan-cube/dsh-balance-center.git#v1.0.0，按提示安装并启用。也可以先下载 Release 中的 .tgz，再输入它在本机的绝对路径安装。
3. 首次安装后重启一次 DSH，打开「设置 → 余额与额度」。

通过命令行¶

# DSH 桌面版，profile 通常为 desktop
dsh plugin --profile desktop add 'git+https://github.com/dan-cube/dsh-balance-center.git#v1.0.0'

# DSH Web 版，profile 通常为 web
dsh plugin --profile web add 'git+https://github.com/dan-cube/dsh-balance-center.git#v1.0.0'

# 从已下载的 Release 安装包安装（替换为实际绝对路径）
dsh plugin --profile desktop add /absolute/path/to/dsh-balance-center-1.0.0.tgz

如果使用了自定义 profile，把命令中的 desktop 或 web 换成自己的 profile 名称。桌面版命令应使用 DSH 桌面应用安装的 dsh；单独从 npm 安装的 DSH CLI 不管理桌面的 desktop profile。

升级与卸载¶

# 升级时，将 tag 换为 GitHub Release 中的新版本（Web 版将 desktop 换为 web）
dsh plugin --profile desktop add 'git+https://github.com/dan-cube/dsh-balance-center.git#v1.0.0'

# 卸载
dsh plugin --profile desktop remove dsh-balance-center

操作后重启 DSH，使宿主端加载或卸载生效。卸载不清除浏览器中保存的显示偏好。

典型用法¶

1. 接入模型平台：在 DSH「设置 → 模型」中配置要使用的服务商和 API。
2. 选择显示来源：打开「设置 → 余额与额度」，开启希望常驻侧边栏的项目。
3. 调整显示习惯：设置顺序、每项标签语言和刷新间隔。
4. 接入自己的接口：点击「添加自定义余额源」，填写 GET 接口与 JSON 字段路径；新密钥先保存，再使用已保存凭据测试连接。

以 DeepSeek 为例：登录 DSH 账号或在 platform.deepseek.com 创建 API Key 并填入「设置 → 模型」，重新打开插件设置页触发识别，侧边栏即可显示 DeepSeek 余额：¥xx。订阅额度类同理，例如在 z.ai / bigmodel.cn 控制台为 GLM Coding Plan 创建 Key，添加到第三方模型提供商后，插件读取额度百分比与重置时间。

隐私与兼容性¶

插件本身没有服务器，不收集、不上传数据，Key 基本不会离开本机。现有模型连接的密钥由 DSH 宿主进程解析；自定义来源的密钥通过设置页输入，经 DSH 凭据服务保存，余额查询由宿主发起。浏览器端只能拿到状态、金额/百分比和重置时间，未保存的 Key 不会发送。

兼容性声明为 >=0.2.1-rc.5 <0.3.0-0。本地实机验证基于 DSH 0.2.1-rc.5，验证项包括 DeepSeek 余额、Kimi / Moonshot 余额、Kimi For Coding 额度、侧边栏行、设置页、显示/隐藏与排序、中英文切换、SiliconFlow HTTP 410 状态说明。StepFun、Novita、GLM Coding Plan、MiniMax Token Plan 通过接口 fixtures 验证，但未在真实账号复现；DSH 0.3.x 未测试，暂不声明支持。

适用场景与注意¶

适合同时管理多家模型平台余额、且订阅了 GLM Coding Plan / MiniMax Token Plan / Kimi For Coding 的 DSH 开发者。如果平台没有公开余额接口，插件无法凭空显示，只能靠自定义 JSON 源兜底。

两点提醒：一是插件以当前 DSH 进程权限运行，安装前检查源码与 MIT 许可证；二是项目当前 GitHub 星标为 1，属于较新的社区维护项目，使用前评估维护风险。

结尾¶

dsh-balance-center 的价值在于把分散在各平台后台的余额与订阅额度收到同一侧边栏，并附上不可读连接的原因说明。目录页：https://www.skillhub.cn/plugins/dan-cube/dsh-balance-center ；源码与 Release：https://github.com/dan-cube/dsh-balance-center