DSH（DeepSeek Harness）採用“一切皆插件”的理念，支持通過插件擴展 Web 客戶端的功能。在使用 Web 界面進行智能體開發或調試時，實時掌握 DeepSeek API 的賬戶餘額與今日消耗是控制成本的關鍵。dsh-deepseek-balance 插件將這兩項數據直接集成到左側 rail 的底部，無需跳轉頁面即可查看。
這是一個由 qschen86 維護的 Web 客戶端插件，用於在 DSH 界面的側邊欄底部展示餘額徽章和消耗統計。
核心功能¶
- 餘額徽章：顯示在
sidebar.rail.footer槽位。內容爲當前餘額 + 今日消耗。當餘額低於 5 元時，徽章顏色會變紅。 - 詳情面板：點擊徽章彈出面板，顯示餘額明細（CNY/USD）、今日消耗量與 Token 數、以及近 30 天的消耗曲線（基於本地快照差分計算）。
- 自動刷新：在會話開始或結束回合時刷新數據。採用 60 秒緩存 + 單飛去重 + 服務端節流機制。若刷新失敗，會回退顯示最後一次成功獲取的快照（Stale 數據）。
- 消耗統計：基於會話日誌進行增量掃描（結合水印與 Liveness 機制），不重放全部歷史日誌，保證統計效率。
安裝與啓用¶
- 安裝插件：
dsh plugin --profile web add dsh-deepseek-balance
（也可以直接指定 GitHub Release 的 tarball 路徑，但第一種方式更簡潔。安裝後可使用 `dsh --profile web --dump-config` 驗證條目。）
- 重啓 dsh web 服務（部分配置生效）。
- 刷新瀏覽器頁面（部分配置生效）。
典型用法¶
- 配置憑據：進入 DSH 設置，找到“憑據”選項，添加名爲
DEEPSEEK_API_KEY的憑據，其值填入 DeepSeek 開放平臺的 API Key。 - 驗證顯示：刷新頁面後，左側 rail 底部應出現餘額徽章。
- 查看詳情：點擊徽章，彈出詳情面板查看餘額明細和消耗曲線。
注意事項與已知限制¶
- 版本兼容：該插件驗證於 dsh 0.1.0-rc.6。餘額和消耗面板完全基於官方槽位和服務注入，升級後通常兼容。
- 手動補丁（已知問題）：在當前驗證版本下，“Deep diving…”鯨魚噴水動畫與插件清單標籤頁，需要手動對閉包內的兩個客戶端文件進行補丁（
dsh-client-ui-conversation/dsh-client-ui-settings-plugin-inventory）。這些補丁在 dsh 升級後會丟失，需要重新應用，但不影響餘額和消耗功能。 - 權限與隱私：插件僅通過
ctx.credentials讀取 API Key，不接觸其他存儲，且不讀取憑據之外的配置。
該插件通過官方槽位將 API 消耗可視化，適合需要在本地頻繁調用 DeepSeek API 的開發者。項目源碼與詳細文檔可在 GitHub 查看。
