DeepSeek Harness (DSH) 採用插件化架構，擴展能力主要集中在 Web 界面。dsh-whale-widget-plus 是一款位於 DSH Web 界面右下角的掛件插件，由用戶 louke6572 維護。它通過四套表情素材和情緒動畫，將 DeepSeek 餘額與火山引擎 Coding Plan 用量監控融入日常交互中。
核心功能¶
這款插件主要包含以下能力：
- 四表情版本切換：支持 v1-v4 四套素材，每套包含 18-33 張圖片。支持 localStorage 記憶，刷新頁面後保持選擇。
- 雙數據模式：支持火山引擎 Coding Plan 用量查詢和 DeepSeek 官方餘額查詢。支持多賬號輪詢。
- 情緒動畫：連點觸發生氣，懸停觸發害羞，長時間無交互觸發失落，配額≥90% 觸發疲憊。
- 臺詞系統：內置 6 組隨機臺詞，支持自定義增刪改，支持手動固定選擇。表情與臺詞分離。
- 可調參數：大小、氣泡顏色、眨眼頻率、音效、手動鎖定。
- 桌面版支持：支持 dsh >= 0.1.7-rc.2 的桌面版，通過
dsh.client模塊掛載。
安裝與啓用¶
安裝過程分爲本體掛件和火山數據源兩部分。
- 安裝本體
dsh plugin --profile web add link:C:\path\to\dsh-whale-widget-plus
- 安裝火山數據源（可選，火山模式必需）
dsh plugin --profile web add link:C:\path\to\dsh-whale-widget-plus\plugins\volc-usage
-
配置憑證
在DSH_HOME（默認~/.dsh）目錄下的.credentials.yaml中配置火山憑證。 -
刷新頁面
重啓 dsh web，瀏覽器 Ctrl+F5 強刷即可看到小鯨魚。
實現與安全¶
- 安全機制：憑證永不進前端，所有 API Key / AccessKey 只在 Node 端使用，前端僅拿到歸一化後的百分比或金額。
- Web 模式掛載：通過
webServer.tapIndex注入。 - 桌面版掛載：桌面版界面不走 HTTP 頁面注入，插件通過 package.json 的
dsh.client客戶端模塊聲明，在客戶端啓動時自動掛載。
這款插件通過本地存儲和同源數據獲取，在不暴露 API Key 的情況下實現了數據的可視化。適合希望在開發或使用 DSH Web 界面時，直觀監控 DeepSeek 餘額與用量的用戶。
