前言¶
DeepSeek Harness (DSH) 運行時，進程在後臺運行，狀態變化難以直接感知。爲了解決這個痛點，引入鯨娘桌寵插件，通過桌面浮窗實時反饋工作狀態。
插件定位¶
這是一個運行在鯨港 WhaleHarbor 上的桌面寵物插件，由 MoonlitDropOfBlood 維護。它通過 2D 拆件與 CSS 動畫技術，將 DeepSeek Harness 的運行狀態映射到桌面上。
核心功能¶
- 2D 拆件 + CSS 動畫：原畫拆分爲 13 個零件（底座、眼、嘴等），通過 CSS keyframes 驅動呼吸、眨眼、汗滴等動作，支持 60fps 動畫。
- 實時狀態反映：支持空閒、忙碌、審批等待、提問等待、出錯、完成慶祝、打盹、子代理分身等 8 種狀態切換。
- 桌面交互：支持拖動、戳一戳（點擊）、右鍵菜單（小/中/大號尺寸切換）、托盤菜單。
- 氣泡副欄：實時統計本次開機工具調用數、累計忙碌分鐘、被戳次數。
- 浮窗特性：透明置頂浮窗，不搶焦點，避免打斷工作流。
安裝與啓用¶
安裝命令如下：
dsh plugin --profile web add @duke-dsh-plugins/dsh-whaleharbor-pet
國內網絡環境下，請顯式指定 --registry=https://registry.npmjs.org 以避免鏡像源干擾。
裝完必須重啓 DSH 核心（Ctrl+Alt+R 或設置 → 核心 → 重啓）才能生效。
典型用法¶
本地開發時，可使用 node 命令導出浮窗頁面：
node -e "console.log(require('./index.js')._buildPetPage())"
瀏覽器直接打開生成的 index.html，可添加參數 ?mood=xxx 釘死特定狀態進行預覽。
適用場景與注意¶
- 平臺要求：需要 WhaleHarbor 桌面殼提供浮窗能力（當前僅發佈 Windows 構建）。純瀏覽器或 CLI 啓動時插件會安靜空轉，無副作用。
- 浮窗限制：每插件浮窗限額 3 個，全侷限額 6 個；本插件僅使用 1 個。
- 窗口行爲：改變浮窗大小會關閉並重建浮窗，位置會重置爲默認。
- 降級處理：零件缺失時自動退回佔位鯨魚，不會白屏。
- 狀態同步：
float.window.state爲替換最新值語義，頁面刷新時會自動補發最新狀態。
總結¶
該插件通過可視化的方式解決了後臺進程狀態不透明的問題，適合需要監控 DSH 運行狀態的開發者。
