前言¶
在使用 DeepSeek Harness (DSH) 時，開發者需要持續關注 Token 消耗、任務狀態和餘額變動。若工具僅提供後臺數據而缺乏直觀反饋，容易造成信息遺漏。dsh-whale-pet 插件將瀏覽器懸浮球與 Windows 置頂桌面寵結合，提供雙形態的陪伴體驗，將餘額、任務和消耗數據集中展示，並具備互動與通知功能。
插件簡介¶
插件名稱爲 dsh-whale-pet，由用戶 dleaf6211-hash 維護。它爲 DSH 提供一個陪伴型桌寵，包含瀏覽器右下角的懸浮鯨魚娘和 Windows 置頂桌面寵兩種形態，兩者共享同一份數據。所有數據僅存本機，語音與立繪隨包內置，無任何遙測上報。
安裝與啓用¶
使用 npm 預構建包安裝，命令如下：
dsh plugin --profile web add dsh-whale-pet-plugin
安裝後需重啓 Harness 或對應 profile，瀏覽器右下角會出現鯨魚娘。桌面寵默認不自動拉起，需在瀏覽器木牌點擊「拉起桌寵」按鈕，或在設置中開啓「自動拉起桌面寵」選項。
核心功能¶
- 餘額與用量木牌：顯示 DeepSeek 實時餘額、會話消耗、本月消耗及消耗差值，支持一鍵刷新。木牌可切換查看 Token 用量視圖（調用/輸入/輸出/緩存）。
- 任務通知：會話、子任務、工作流或後臺任務完成、失敗、等待審批或需協助時，木牌彈通知並觸發語音播報。完成通知包含本次任務的真實成本。
- 摸頭互動：鼠標懸停在鯨魚娘頭部約 0.7 秒，會觸發害羞貼紙、愛心和摸頭臺詞。
- 臺詞與語音：內置 19 句帶情感臺詞，預合成語音隨包分發，離線可用，無需調用 TTS 服務。
- Windows 桌面寵：置頂 WPF 小窗，與瀏覽器寵同步臺詞與通知。點擊桌面寵右上角眼睛圖標可進入透明模式（鼠標穿透），懸停眼睛再點可退出。
- 免打擾與低餘額：可設置靜音時段，僅靜音不消失，但審批與「需要協助」提醒不受影響。餘額低於 5 元時會彈提醒。
- 設置面板：提供隨機臺詞開關、語音開關、寵物大小、自動拉起、低餘額提醒、免打擾時段等配置項。
典型用法¶
- 切換視圖：點擊木牌上的「看用量」或「看餘額」切換顯示內容。
- 刷新數據：點擊木牌「刷新」立即拉取最新余額。
- 輸入框互動：在 DSH 的任意輸入框中輸入內容，鯨魚娘會自動冒出臺詞。
- 透明模式：在桌面寵右上角點擊眼睛圖標進入透明模式（鼠標穿透），懸停眼睛再點擊即可退出。
注意事項¶
- 系統要求：瀏覽器寵支持任意系統；Windows 桌面寵基於 PowerShell + WPF 開發，僅支持 Windows。
- 升級報錯：升級插件時若桌寵進程鎖着插件目錄，會報
EPERM rename錯誤。需先完全退出桌面寵和 DSH，再執行升級命令。 - 隱私：所有數據僅存本機，無任何遙測上報。
參考資源¶
- GitHub 倉庫：https://github.com/dleaf6211-hash/dsh-whale-pet
- 插件目錄：https://www.skillhub.cn/plugins/dleaf6211-hash/dsh-whale-pet
