DeepSeek Harness API 用量余额插件介绍

DeepSeek Harness（DSH）采用「一切皆插件」的理念。在使用过程中，开发者常需要查看账户余额或详细的 API 用量。默认的 WebUI 仅在发送按钮旁显示当前上下文 token，无法直接获取账户余额与消费明细。下面介绍 dsh-api-balance 插件，它在 WebUI 的用量圆圈弹出面板中增加了「用量 / 余额」标签切换，用于展示账户相关信息。

这是什么¶

dsh-api-balance 是一个为 DeepSeek Harness 提供的 API 用量余额插件。该插件由维护者「狐莉」开发，因维护者患有视网膜色素变性（锥杆营养不良15型）且属于一级视力残疾，目前无法独立完成 NPM 软件包提交流程，因此暂不提供 npm 打包。用户需通过 GitHub 源码或声明式配置进行安装。

核心功能¶

余额 / 用量面板：在 WebUI 的用量圆圈弹出面板内切换「用量」与「余额」标签。
账户余额：通过 DeepSeek 官方 API（GET /user/balance）查询当前账户余额。
用量明细：展示当日、当月及 30 日的消耗数据，包含金额、Token 及分模型明细，并配有图表。
平台令牌自动获取：默认从本地浏览器登录态自动扫描获取令牌，支持手动连接作为回退方案。
语音播报：集成语音包与 TTS（浏览器内置或自定义 API），支持峰谷计费提示，并按界面语言自动匹配音色。
界面增强：提供峰时红色标识、优化疑问窗口滚动等细节调整。

安装与启用¶

从 GitHub 源码安装¶

在终端执行以下命令，通过 GitHub 源码安装插件：

dsh plugin --profile web add github:Kihara777/dsh-api-balance

安装后，插件包内的 dsh.bundle 会指向 cordis.patch.yml，激活后作为 profile 的一个 layer 生效。

若需卸载，可执行：

dsh plugin --profile web remove @kihara777/dsh-api-balance

声明式安装（NixOS）¶

NixOS 用户可使用 NixKits 的 nixkits.dsh 模块进行声明式安装。这种方式由 Nix 锁定版本，随系统代际更新，且具备可复现性。配置示例如下：

{
  nixkits.dsh.plugins.packages = [{
    package = pkgs.dsh-api-balance;
    id = "api-balance";
    name = "@kihara777/dsh-api-balance";
  }];
}

典型用法¶

安装完成后，在 DeepSeek Harness 的 WebUI 中，发送按钮左侧的用量圆圈将显示当前上下文使用情况。点击该圆圈，在弹出的面板中切换至「余额」标签，即可查看账户余额及消费明细。

适用场景与注意¶

适用场景：需要精细化管理 API 账户、监控 Token 消耗及余额的 DeepSeek Harness 用户。
注意：插件以当前 DSH 进程的权限运行。安装前建议查阅源码与许可证（MIT）。由于维护者视力限制，目前无法提供 npm 包，请通过源码或 Nix 配置安装。

该插件通过在 WebUI 原有用量显示旁添加标签切换，解决了账户监控缺失的问题。更多细节请参阅 GitHub 仓库。