dsh-balance：DeepSeek Harness 側邊欄餘額監控插件

前言¶

DeepSeek Harness（DSH）採用插件化架構。在使用 Web profile 進行開發或調試時，需要頻繁查看 API 餘額。手動刷新頁面查看既低效又不直觀。dsh-balance 插件解決了這個問題，將餘額直接嵌入側邊欄，提供實時的額度監控。

插件介紹¶

dsh-balance 是一個 DeepSeek Harness Web 插件，用於在側邊欄底部顯示 DeepSeek API 餘額。該插件由 eka3os 維護，解決了在開發過程中實時監控 DeepSeek API 剩餘額度的問題。

核心功能¶

1. 餘額顯示：在側邊欄設置區域附近同時顯示 CNY 和 USD 餘額。
2. 官方接口：通過 DeepSeek 官方 API 端點讀取餘額數據。
3. 安全設計：API Key 僅在服務端使用，瀏覽器端僅接收規範化後的餘額數值。
4. 自動刷新：每 60 秒自動刷新一次餘額，保持數據最新。
5. 狀態反饋：在加載中、無餘額或請求失敗時顯示 --。
6. 安裝方式：支持直接從 GitHub 倉庫安裝。

安裝與啓用¶

在安裝前，請確保本地已安裝 DeepSeek Harness 且版本不低於 0.1.0-rc.7，並已啓用 web profile。

1. 執行安裝命令：

dsh plugin --profile web add github:eka3os/dsh-balance

2. 安裝完成後，需要重啓 Web profile 以加載插件：

dsh web

dsh plugin 命令會將包安裝到指定的 profile，並根據插件聲明的配置自動激活。

典型用法¶

插件使用 DEEPSEEK_API_KEY 作爲憑據引用。你需要提前配置好該密鑰。

方式一：通過環境變量配置（單次運行）¶

在啓動 DSH Web 時通過環境變量傳入 Key：

DEEPSEEK_API_KEY=sk-your-key dsh web

方式二：通過本地憑據文件配置¶

將 API Key 寫入 DSH 的本地憑據文件：

# 文件路徑爲 $DSH_HOME/.credentials.yaml
DEEPSEEK_API_KEY: sk-your-key

配置完成後，側邊欄底部將出現餘額顯示區域。

適用場景與注意¶

1. 版本要求：需要 DeepSeek Harness >=0.1.0-rc.7。插件版本爲 0.1.0。
2. Profile 限制：該插件僅在 web profile 下工作。
3. 安全建議：API Key 或憑據文件不應提交到 Git 倉庫。
4. 分發渠道：該插件僅通過 GitHub 分發，未發佈到 npm。
5. 源碼審查：在安裝社區插件前，建議查閱其 GitHub 倉庫（https://github.com/eka3os/dsh-balance）的源碼與許可證（MIT）。

結尾¶

dsh-balance 插件通過在側邊欄提供直觀的餘額展示，簡化了開發調試流程。對於需要頻繁監控 API 資源的開發者而言，這是一個實用且安全的選擇。