DeepSeek Harness 插件：dsh-balance-pill

前言¶

在 DeepSeek Harness（DSH）的 Web Profile 中開發或調試時，開發者通常需要頻繁確認當前的 API 餘額。打開儀表盤或刷新頁面會打斷工作流。dsh-balance-pill 插件通過在界面中直接嵌入一個始終可見的餘額指示器，解決了這一痛點，無需跳轉頁面即可獲取餘額狀態。

插件介紹¶

dsh-balance-pill 是一個 DeepSeek Harness Web 插件，由開發者 ivbrajkovic 維護，採用 MIT 協議開源。

其核心功能是在 DeepSeek Harness 的 Web 界面中顯示當前的 API 餘額。當會話打開時，餘額指示器顯示在會話頭部；無會話時，它會固定在右上角。插件不提供圖表或設置彈窗，僅作爲一個輕量級的視覺組件存在。

核心功能¶

該插件具備以下功能：

位置顯示：在有會話時位於會話頭部；無會話時固定在右上角，確保始終可見。
餘額輪詢：每分鐘自動輪詢一次餘額接口。
峯時/非峯時着色：根據當前時間是否處於配置的峯時範圍內，顯示紅色（峯時）或綠色（非峯時）的背景色。
配置管理：通過 DSH 的 Settings 界面配置峯時規則，配置持久化到本地。

安裝與啓用¶

安裝前請確保已配置 DEEPSEEK_API_KEY 並運行 DeepSeek Harness Web Profile。

使用以下命令安裝插件：

    dsh plugin --profile web add github:ivbrajkovic/dsh-balance-pill

安裝完成後，重啓 Web Profile 並刷新瀏覽器頁面。

如果需要固定特定版本，可以添加 commit hash：

dsh plugin --profile web add github:ivbrajkovic/dsh-balance-pill#<commit>

配置說明¶

插件的峯時規則通過 DSH 的設置界面進行配置，無需修改配置文件。

打開 Settings -> Plugins -> Plugin configuration。
展開並編輯 Balance pill peak hours 配置項。
設置時區（默認爲 UTC）和峯時時間段（格式爲 HH:MM - HH:MM，每行一個）。
保存設置。

配置數據會持久化到 ~/.dsh/settings.yaml（命名空間爲 dsh-balance-pill）。插件的邏輯判斷基於用戶瀏覽器的本地時區，且配置更新後會立即生效（無需重啓）。

配置結構示例如下：

{
  timezone: "UTC",
  peakHours: [
    ["01:00", "04:00"],
    ["06:00", "10:00"],
  ],
}

安全與架構¶

該插件在架構設計上注重安全性：

Host/Client 分離：API 密鑰僅存在於 DSH 的 Host 進程中，僅用於本地接口請求，絕不會發送到瀏覽器。
數據傳輸：瀏覽器端只接收簡化的數據格式 { "ok": true, "balance": 42.17, "currency": "CNY" } 或錯誤狀態，無法獲取敏感信息。
零依賴：Host 端使用 Node.js 內置的 fetch，無外部依賴；Client 端通過 DSH 的 dsh.client 加載。
權限控制：插件不直接讀取文件或啓動進程，僅調用 DSH 現有的 credentials 和 webServer 服務。

結尾¶

dsh-balance-pill 提供了一種輕量、安全且直觀的方式，在 DeepSeek Harness 的開發環境中監控餘額與使用時段。對於需要長期運行調試任務的開發者而言，它能有效減少查看餘額的操作步驟。

GitHub: https://github.com/ivbrajkovic/dsh-balance-pill
目錄: https://www.skillhub.cn/plugins/ivbrajkovic/dsh-balance-pill