前言¶
在 DeepSeek Harness（DSH）裏跑智能體時，狀態多在側邊欄或日誌裏：誰在調工具、是否在等審批、子代理是否在跑，都要自己掃一眼界面。網頁裏的小掛件可以裝飾，但往往不直接綁宿主的真實事件。
下面介紹社區插件 鯨娘桌寵（倉庫 GHSYES/dsh-whale-girl-pet）。它在 Windows 上開一塊獨立的 Electron 透明置頂窗，監聽 DSH 的會話、工具調用、審批、子代理與歸檔等事件，用 22 個像素動作表達「正在幹什麼」；同時支持戳臉、拖動、縮放與本地換裝。維護者爲 GHSYES，在技能目錄中歸類爲趣味換裝。
這是什麼¶
鯨娘不是嵌在 DSH 頁面裏的懸浮層：她是獨立桌面窗，不佔任務欄，也不會在頁面裏重複出現。插件作爲 DSH 宿主插件（ESM，index.js）掛 HTTP 路由、維護狀態機，並拉起 Electron 進程渲染透明窗口。
素材隨插件分發；若在 %DSH_HOME%\pets\whale-girl-emoji 放置同名 GIF，會覆蓋內置資源，便於換裝。README 註明像素素材來源於 dsh-tui，美術資源許可與代碼許可分開（見倉庫 THIRD-PARTY-NOTICES.md）。
核心功能¶
與會話綁定的狀態，而非隨機動畫¶
狀態來自真實會話事件，並按 README 給出的優先級裁決（節選理解要點）：
- 設置裏的動作預覽優先。
- 互動反應（戳臉、撓癢等）覆蓋短時待機。
- 等待確認（審批或提問）、出錯、上下文清理/歸檔、worktree、多子代理、多會話調工具等，分別映射到對應動作。
- 無高優先級事件時進入待機循環：先「待機眨眼」約 30 秒，再隨機播一輪其他待機動作，然後回到眨眼；5 分鐘無互動進入「呼呼大睡」，點擊喚醒後重新循環。
- 主會話正常結束，或（可選）個人工作臺任務驗收通過時，循環播放「任務完成」，需單擊一次纔會播「舉大拇指」並回到正常待機。
共 22 個動作（如 thinking、typing、notification、happy 等），完整 key 與觸發條件見倉庫 README 表格。
桌面交互¶
- 單擊左臉/右臉：戳臉反應；1 秒內連點 3 下：撓癢。
- 按住 Ctrl 再拖：移動窗口（普通拖動不會挪窗）。
- 右鍵：原生菜單（放大 / 縮小 / 恢復默認 / 收起）。
- 戳臉約 12% 概率「冒愛心」；主會話正常結束約 18% 概率冒愛心，其餘進入任務完成循環。
窗口大小可在設置中調節 72–480 px；右鍵菜單每次 ±32 px。位置與尺寸寫入 %DSH_HOME%\whale-pet\desktop\window-state.json，下次啓動復原。
DSH 設置面板¶
路徑：DSH 設置 → 鯨娘桌寵。可調顯示開關、大小、不透明度（20%–100%）、點擊穿透、待機輪換，並用網格預覽並強制播放各動作約 3 秒。首次無 Electron 運行時時會自動下載固定版本 44.0.0 的 win32-x64 運行時（npmmirror / GitHub Releases，SHA-256 校驗）；已安裝 dsh-orb 時可複用其運行時。
數據與網絡¶
狀態與設置僅寫本機 %DSH_HOME%\whale-pet\。README 說明不發送遙測；主動外網請求主要是首次下載 Electron。桌面頁加載本機 DSH 的 /whale-pet/standalone。若安裝可選插件 @dely0/dsh-personal-workbench，會每 2 秒輪詢本機 GET /api/workbench/tasks 以聯動任務完成慶祝；未安裝則靜默跳過。
環境與依賴¶
| 項 | 要求 |
|---|---|
| 系統 | Windows 10/11 x64 |
| DSH | Desktop 配置，engines.dsh >= 0.2.0-rc.2（package.json 中 dsh.engines.dsh 同爲 >=0.2.0-rc.2） |
| Node.js | 20+ |
| 磁盤 | 插件約 3.5 MB；Electron 運行時下載約 160 MB、解壓約 370 MB（已有 dsh-orb 運行時可不重複下載） |
當前插件包版本爲 1.0.1，代碼許可證 MIT。
安裝與啓用¶
推薦在 DSH 插件 → 發現 / 插件市場 搜索 dsh-whale-girl-pet 或「鯨娘桌寵」安裝。市場目錄與 awesome-dsh-plugin 同步，收錄後通常一天內可見；若暫時搜不到，可用界面或命令行添加來源。
界面「添加插件」¶
打開 插件 → 添加插件，在輸入框填寫倉庫來源（不要粘貼整條 dsh plugin ... add ... 命令，否則會報無法識別）：
github:GHSYES/dsh-whale-girl-pet
也可使用 README 提供的歸檔地址作爲來源（僅填來源字段）。
命令行（desktop profile）¶
在 PowerShell 中執行：
dsh plugin --profile desktop add github:GHSYES/dsh-whale-girl-pet
成功後 dsh-whale-pet 會寫入 profile 的 dsh.profile.bundles。需重啓 DSH Desktop 生效（宿主插件僅在啓動時加載）。若提示先初始化 profile，則啓動並完全退出一次 DSH Desktop 後再重跑命令。可在 %DSH_HOME%\profiles\desktop\package.json 的 bundles 中確認是否包含 dsh-whale-pet。
無網絡或不想自動下載 Electron¶
任選其一：安裝 dsh-orb 讓插件複用 %DSH_HOME%\dsh-orb\electron-runtime\electron.exe；或自備 Electron 44.x，設置環境變量 WHALE_PET_ELECTRON 指向 electron.exe 後啓動 DSH。下載日誌見 %DSH_HOME%\whale-pet\spawn.log 與 desktop.log。
典型用法¶
- 完成安裝並重啓 DSH Desktop 後，在設置中打開「顯示在桌面上」，等待 Electron 就緒（必要時在面板查看下載進度或重試）。
- 照常使用 DSH 會話：調工具時可見「敲代碼」等狀態；出現審批或提問時可見「需要你確認」。
- 需要挪動桌寵時按住 Ctrl 拖動；被窗口擋住工作時可在設置中開啓「點擊穿透」。
- 換裝：將自定義 GIF 放到
%DSH_HOME%\pets\whale-girl-emoji，文件名與內置動作一致即可覆蓋。 - 在設置網格中點某個動作，可預覽 3 秒，對應宿主 API
POST /whale-pet/api/preview。
適用場景與注意¶
適合誰：在 Windows 上使用 DSH Desktop、希望用桌面像素角色直觀看會話與子代理狀態，並願意接受首次 Electron 運行時下載的開發者。
權限與信任：插件以當前 DSH 進程權限運行，向本機 webServer 註冊 /whale-pet 路由並管理 Electron 子進程。安裝前宜瀏覽倉庫源碼與 LICENSE、THIRD-PARTY-NOTICES.md。
已知限制（摘自 README）：
- DSH 完全退出後桌寵關閉；重新打開 DSH 會自動恢復。
- 改
index.js、runtime.js、desktop/*需重啓 DSH Desktop；改standalone.js僅需重啓桌寵窗口。 - 自動下載的 Electron 僅覆蓋 Windows x64；其他平臺需
WHALE_PET_ELECTRON。 - 同一 Windows 用戶僅允許一個桌寵窗口（單實例鎖）。
技能目錄頁：skillhub.cn 插件條目。社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
鯨娘桌寵把 DSH 裏抽象的「智能體正在做什麼」轉成桌面上的像素反饋，並保留戳弄、縮放與本地換裝。若你要在 Windows 上邊寫代碼邊看狀態，可按上文命令安裝 github:GHSYES/dsh-whale-girl-pet，在設置裏打開桌面窗即可。
- 目錄頁：https://www.skillhub.cn/plugins/GHSYES/dsh-whale-girl-pet
- 源碼與完整動作表：https://github.com/GHSYES/dsh-whale-girl-pet
