dsh-balance-chip：DSH 側邊欄與右下角餘額監控

前言¶

在 DSH 環境下進行開發或模型調用時，需要頻繁確認 API 餘額以避免超額扣費。頻繁切換到網頁端查看既低效又幹擾操作流。dsh-balance-chip 插件將餘額查詢集成到客戶端界面，在側邊欄底部和右下角提供常駐狀態。

是什麼¶

該插件由 AKUSH99 維護，開源協議爲 MIT。它通過讀取本地憑證庫的 API Key，在 DSH 客戶端展示 DeepSeek API 的當前餘額。

安裝¶

使用以下命令安裝插件：

dsh plugin --profile web add github:AKUSH99/dsh-balance-chip

安裝完成後，重啓 dsh web 即可應用。

核心功能¶

插件在界面中提供兩個展示位置：

1. 側邊欄底部：以狀態點的形式存在，位於設置選項旁。
2. 右下角膠囊：常駐顯示，默認不阻擋鼠標點擊（pointer-events: none）。

兩種展示均每 60 秒自動刷新。鼠標懸停可查看幣種與最後更新時間。

狀態顏色指示如下：
* 綠色：餘額 ≥ $5
* 橙色：餘額 < $5
* 紅色：請求出錯

安全機制¶

插件本身不包含 API Key。Key 僅在運行時從本地 DSH 憑證庫讀取，並僅向官方餘額接口發起請求。插件無遙測數據，無外部依賴。

使用前提¶

使用前需確認憑證庫中存在 DEEPSEEK_API_KEY 引用。該引用可通過網頁端模型頁面寫入。

典型用法¶

安裝並重啓 dsh web 後，插件會自動開始輪詢。在主界面右下角即可看到膠囊，在側邊欄底部即可看到狀態點。

注意事項¶

插件以當前 DSH 進程權限運行。安裝前請檢查源碼與許可證（MIT）。

故障排查¶

• 顯示 Key?：憑證庫中缺少 DEEPSEEK_API_KEY 引用。
• 顯示 …：首次輪詢尚未完成，等待幾秒。
• 顯示紅色：無法連接到官方餘額接口或 Key 無效，請檢查網絡與 Key 配置。

生態背景¶

DSH 理念是“一切皆插件”。本插件託管於社區目錄，與 DeepSeek 官方應用無從屬關係。