DeepSeek Harness (DSH) 支持通過插件擴展功能。對於習慣在代碼或終端中監控 Token 消耗和上下文佔用的開發者，缺乏直觀的視覺反饋會影響使用體驗。本插件在 DSH 桌面環境中提供了一個桌面掛件，實時展示 DeepSeek 的餘額、用量以及上下文佔用情況，並提供交互式物理反饋。
功能概覽¶
掛件包含以下核心功能：
- 鯨魚娘立繪：圖片與音效內嵌，無網絡依賴。
- 資源監控：實時顯示餘額、用量、上下文佔用進度條（≥90% 會主動提醒）以及峯谷時段提醒。
- 交互與彩蛋：支持甩拋彈跳、中鍵彈弓拋擲、右鍵菜單配置、彩蛋氣泡以及音效切換。
- 性能調節：提供省電模式、毛玻璃強度調節、底板透明度調節等功能。
安裝與啓用¶
通過 DSH 命令行工具安裝該插件：
dsh plugin add nickkkkkk123123/dsh-whale-girl
安裝完成後，鯨魚娘將默認顯示在 DSH Desktop 右下角。
使用方法¶
- 顯示與交互：在 DSH Desktop 右下角顯示鯨魚娘。按住鼠標中鍵拖動可進行彈弓拋擲，鬆手後掛件會沿原位置方向彈射。
- 配置修改：在掛件上點擊右鍵，通過可視化菜單修改配置，如切換音效、調節彈弓力度、開啓省電模式等。
- 彩蛋觸發：點擊掛件可觸發隨機臺詞或彩蛋；空閒 2~5 分鐘後掛件也會自動開口說話。
配置說明¶
掛件配置保存在 ~/.dsh/.whale-girl-config.json。你可以通過右鍵菜單可視化修改，也可直接編輯該文件：
{
"soundMode": "cute",
"showProgress": true,
"showBubble": true,
"showBalance": true,
"showPeak": true,
"slingPower": 20,
"ecoMode": true,
"frost": 4,
"panelOpacity": 0.82,
"lowBalance": 10
}
| 字段 | 說明 |
|---|---|
soundMode |
音效模式：cute（可愛合成音）或 duck（鴨叫） |
showProgress |
是否顯示上下文佔用進度條 |
showBubble |
是否顯示彩蛋/隨機臺詞氣泡 |
showBalance |
是否在詳情裏顯示餘額 |
showPeak |
是否顯示峯谷提醒 |
slingPower |
中鍵彈弓發射力度係數（5~60） |
ecoMode |
省電模式開關：空閒 60 秒暫停漂浮動畫並停用毛玻璃 |
frost |
毛玻璃強度（0~16），0 爲關閉 |
panelOpacity |
底板與菜單透明度（0.2~1），默認 0.82 對應 18% 不透明度 |
lowBalance |
餘額預警線（元），低於該值觸發氣泡提醒，0 爲關閉 |
注意事項¶
- 流式輸出卡頓：在 DSH 進行流式輸出時，掛件可能會出現卡頓。這是 DSH 官方的流式渲染瓶頸導致的，並非本插件問題。
- 網絡依賴：圖片與音效已內嵌，無需網絡請求即可使用。
- 數據殘留：卸載插件後，
DSH_HOME（默認爲~/.dsh）目錄下會殘留.whale-girl-config.json、.whale-girl-usage.json等數據文件，若需徹底清理需手動刪除。 - API Key：需在 DSH 中配置
DEEPSEEK_API_KEY才能讀取餘額信息。 - 資源佔用：安裝包約 346KB，不產生額外進程，但在流式輸出時可能受 DSH 主進程性能影響。
