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 倉庫。