前言¶
在使用 DeepSeek Harness（DSH）進行智能體開發或接口測試時，隨時掌握賬戶餘額變化是一項基礎需求。雖然 DSH 的基礎功能提供了一定的統計，但缺乏一個輕量級、懸浮式的實時監控入口。dsh-balance-bubble 正是爲了解決這個問題而生的。
插件介紹¶
這是一個由 Jescoi 維護的 Cordis 插件，專爲 DSH 的 Web 界面設計。它會在界面右上角懸浮一個半透明的“玻璃態”氣泡，實時顯示 DeepSeek 賬戶餘額，並每隔 20 秒自動刷新數據。
核心功能¶
- 實時餘額同步：插件採用 Host 和 Browser 分離的架構。Host 端通過
ctx.credentials讀取 API Key，調用官方接口獲取餘額，並在ctx.webServer上暴露GET /dsh-balance路由。Browser 端則註冊氣泡組件，每 20 秒輪詢該接口獲取最新數據。 - 液態玻璃視覺：氣泡採用半透明淺藍圓形設計，具備背景模糊、頂部光澤高光以及柔和內陰影效果，呈現液態玻璃質感。
- 自由拖動與自適應：氣泡支持鼠標拖拽，位置會自動限制在窗口範圍內。當瀏覽器窗口大小改變時，氣泡會按比例縮放以保持相對位置。
- 狀態同步控制：氣泡右上角提供關閉按鈕；側邊欄底部（位於 Cordis 插件條目上方）提供“餘額”切換開關。兩者狀態實時同步。
- 低餘額告警：當餘額低於閾值（默認 5 CNY）時，氣泡會變紅並出現脈衝環，即便氣泡處於隱藏狀態也會強制重新顯示。
- 暗色模式適配：監聽
theme/change事件，在暗色主題下自動調整顏色和文字對比度。
安裝與啓用¶
該插件僅支持 DSH 的 Web Profile。
- 執行安裝命令：
dsh plugin --profile web add dsh-balance-bubble
- 重啓 DSH 進程，插件會自動加載。
配置與使用¶
- 顯示/隱藏：點擊氣泡上的關閉按鈕，或使用側邊欄底部的“餘額”開關進行切換。
- 餘額閾值修改：目前插件沒有提供設置 UI。如需調整低餘額警報閾值，需直接編輯
lib/client.js中的totalBalance < 5條件。 - API Key：插件不存儲密鑰，而是從 DSH 的憑據服務中讀取
DEEPSEEK_API_KEY，與設置頁面中配置的 Key 共用。
已知限制¶
- 位置不持久：氣泡的拖拽位置在頁面刷新後會重置爲默認位置。
- 僅限 Web 界面：目前僅支持 Web Profile，不支持 TUI 界面。
- 硬編碼配置：低餘額閾值等配置項目前硬編碼在代碼中，暫未開放配置界面。
總結¶
dsh-balance-bubble 通過極簡的 UI 設計，解決了 Web 界下實時監控餘額的需求，適合需要頻繁調用 API 的開發者使用。
- 倉庫：https://github.com/Jescoi/dsh-balance-bubble
- 目錄：https://www.skillhub.cn/plugins/Jescoi/dsh-balance-bubble
