DSH Web 界面右下角的常駐掛件：小鯨魚氣泡圖 + DeepSeek API 餘額 + 今日已用 + 每輪對話消耗。這是基於 MeteorNOX/DeepSeek-Balance-Whale-Widget 修改的鐵盆鯨魚娘版，整合了原版的桌面端適配、安全邊界與記賬內核，增加了頂碗/拿碗兩套形象與鋼管音效組。
安裝與啓用¶
使用官方 CLI 安裝：
dsh plugin --profile web add dsh-whale-widget-bowl
或通過 GitHub 安裝：
dsh plugin --profile web add github:Witherwithwinter/DeepSeek-Balance-Whale-Widget-Bowl
核心功能¶
餘額與記賬¶
掛件每 60 秒自動刷新余額，也可點擊手動刷新。餘額變化時伴隨滾動動畫，網絡抖動時自動沿用最近餘額。內置“小鯨魚記賬”功能，觀測餘額下降爲消費，餘額上升單獨記錄，支持在“小鯨魚記賬 -> DeepSeek（內置）-> 設置 -> 餘額校正”中進行校正。數據按 90 天或 2 萬條歸檔。
支持峯谷定價，工作日高峯時段（9:00-12:00, 14:00-18:00）與週末谷價。
自定義泡泡系統¶
泡泡內容可完全自定義，支持點擊序列、模塊化排版、隨機語句/圖片。模塊包括文本、超鏈接、隨機語句、圖片/動圖、總餘額、贈金、充值餘額、今日已用、峯谷時段、對話名等。支持拖拽排版，每行最多 6 個模塊，泡泡最多 6 行。樣式支持字體、字號、加粗/斜體、純色或跑馬燈漸變。
交互功能¶
支持拖拽吸附（可自定義四邊或角落吸附區）、貼左時的水平鏡像翻轉、按壓 Q 彈效果。提供隱藏菜單按鈕（電腦端右鍵、手機端長按約 1.5 秒喚出）。
音效與提示¶
內置三套音效組（小黃鴨、音效1、鋼管），每套有獨立音量控制。支持自定義音頻片段。可配置每輪對話消耗提示（監聽 usage，自動關閉秒數，自定義內容），以及等待交互音效（提問、授權）。
多廠商自定義 API¶
內置 34 個廠商模板，支持添加任意廠商。密鑰不落配置文件，寫入 DSH 官方憑據服務。支持餘額查詢與額度統計（訂閱資源包）。硅基流動餘額接口已於 2026-08-14 停止服務。
注意事項¶
- 路由衝突：本插件與上游
dsh-whale-widget不能共存，路由前綴均爲/dsh-whale/。 - 密鑰管理：密鑰需寫入 DSH 官方憑據服務，配置文件中僅存儲憑據名。
- 安裝方式：npm 包名與 GitHub 鏈接二選一，不要混用。
生態背景¶
DeepSeek Harness（DSH）採用“一切皆插件”的理念，社區目錄與 DeepSeek / 幻方無官方從屬關係。
