dsh-balance-monitor：DSH Web 側邊欄餘額與用量監控插件

DSH 理念是“一切皆插件”。在多渠道 API 開發中，實時監控餘額與用量是剛需。下面介紹 dsh-balance-monitor，一款在 DSH Web 側邊欄展示餘額與用量的插件。

是什麼¶

該插件由 ShawnKung 維護，解決多渠道 API 賬戶管理繁瑣的問題。它可以在 DSH Web 側邊欄直接查看所選渠道的餘額與 Token 用量詳情，支持 DeepSeek 官方 API 和 TeamoRouter，並具備自動刷新與主題適配能力。

安裝與啓用¶

安裝前請確保已安裝 DSH（版本 >= 0.1.7-rc.1）並運行 dsh web，環境需滿足 Node.js >= 20。

使用官方 npm 包安裝最新版本：

dsh plugin --profile web add @shawnkung/dsh-balance-monitor@latest
dsh plugin --profile web list

安裝完成後，重啓 DSH Web 進程，並在瀏覽器中執行硬刷新（macOS：Cmd+Shift+R；Windows/Linux：Ctrl+Shift+R）以加載插件。

核心功能¶

1. 側邊欄展示
   在“新會話”或工作區之間，側邊欄顯示所選渠道的餘額概覽。

2. 詳情彈窗
   點擊側邊欄入口，彈窗展示各渠道的詳細數據，包括消費金額、請求數和 Token 用量。

3. 自動刷新
   支持會話結束後自動刷新對應渠道，也支持手動點擊刷新按鈕。插件會檢查 npm 最新版本並在啓動時提示更新。

4. 主題適配
   支持淺色、深色和跟隨系統主題。

5. 渠道支持
   支持的渠道包括：DeepSeek 官方 API、Kimi 官方 API、智譜 GLM 和 TeamoRouter。

配置¶

進入 DSH 側邊欄的“插件”，打開 @shawnkung/dsh-balance-monitor 配置項：

1. 側邊欄展示渠道
   默認僅展示 DeepSeek，可多選，最多展示 3 個渠道。

2. 餘額保留位數
   通過滑塊控制顯示精度，默認保留 2 位，可選無小數位、1 至 6 位或精確。

3. API Key 憑據引用
   配置各渠道的 Key 來源，默認引用環境變量。例如：

   • DeepSeek：DEEPSEEK_API_KEY
   • Kimi：KIMI_API_KEY
   • 智譜 GLM：ZAI_API_KEY
   • TeamoRouter：TEAMO_API_KEY

4. TeamoRouter 統計天數
   配置區間統計範圍，支持 2 至 90 天。

依賴與兼容性¶

• DSH 版本：>= 0.1.7-rc.1 < 0.2.0
• Node.js 版本：>= 20
• Profile：僅支持 Web
• 許可證：MIT

安全說明¶

API Key 僅通過 DSH 的 credentials 服務解析和寫入，明文 Key 不會發送到瀏覽器。插件運行在 DSH 進程權限下，僅讀取必要的配置文件。

相關鏈接¶

• GitHub 倉庫
• 社區目錄