前言¶
在 DeepSeek Harness (DSH) 或 Claude Code 等開發環境中，長時間運行任務時往往缺乏視覺反饋。鯨魚娘桌寵提供了一個陪伴方案：她不僅出現在桌面上，還能根據開發者的行爲（如發消息、模型幹活、輪次結束）做出相應反應。
這是什麼¶
這是一個開源的桌寵項目，由 wei125775-lab 維護，代碼使用 MIT 許可證。插件支持兩個主要平臺版本：dsh（DshDesktop） 和 Claude Code（PetPet 框架）。
核心特點是角色的所有動作素材由 AI 視頻生成，待機動畫則通過分層 PSD 烘焙程序化生成，而非簡單的幀動畫。
核心功能¶
-
雙平臺支持
- dsh 版本：適配 DshDesktop，使用frames2d格式。
- Claude Code 版本：適配 PetPet 框架。
- WorkBuddy 版本：提供鉤子插件，適配騰訊的 WorkBuddy 工作臺。 -
待機表現
- 由分層 PSD 烘焙生成，包含呼吸、飄發和眨眼效果，動作幅度較小，避免 AI 視頻常見的抽幀抖動。 -
交互動作
- 喫飯與收碗：發消息或模型幹活時捧碗喫，一輪結束後收碗。
- 打斷反應：按 Esc 鍵打斷當前動作時，會立刻停止並甩出“屑表情”。
- 點擊反饋：點擊角色會觸發揮手或比心。
- 起子代理：在起子代理（Subagent）運行時，腳邊會游出小海豚並繞圈。 -
素材來源
- 所有角色素材均由 AI 生成。
安裝與啓用¶
根據你使用的環境選擇對應的安裝方式。
dsh 版本¶
在項目根目錄執行安裝腳本。腳本會自動處理依賴，包括檢測並安裝 @linxin666/dsh-pet 渲染器（如果需要）。
node install.mjs
Claude Code 版本¶
進入 claude 目錄執行安裝腳本。
cd claude
node install.mjs
綠色版（Windows）¶
直接下載 Releases 中的綠色壓縮包（如 whalegirl-petpet-win-x64.zip），解壓後雙擊 啓動.cmd 啓動。
WorkBuddy 版本¶
下載 whalegirl-workbuddy-win-x64.zip，先運行 啓動.cmd 啓動桌寵本體，再運行 裝WorkBuddy鉤子.cmd，最後完全退出並重啓 WorkBuddy。
典型用法¶
- 工作狀態：當你發消息或模型開始處理任務時，她端着碗喫飯。
- 輪次結束：一輪任務完成後，她收起碗，可能進入托腮、雙手合十或待機狀態。
- 緊急打斷：在任務中途按下 Esc，她會停下手中的動作並給你一個“屑表情”。
- 點擊互動：直接點擊桌面上的她，會觸發揮手或比心動作。
- 特殊事件：當起子代理介入時，她腳邊會出現小海豚遊動。
注意事項¶
- Windows 安全提示：雙擊解壓後的
.cmd文件時，Windows 可能會彈出“已保護你的電腦”提示。這是因爲瀏覽器下載的 zip 標記爲“來自 Internet”。點“更多信息”後選擇“仍要運行”即可解決，文件本身未損壞。 - 包體積：綠色版包含完整的 Electron 運行時，包體積較大（約 200MB）。
- 平臺條款：所有素材均由 AI 生成，使用前需確認相關平臺的服務條款。
- 依賴與版本：
- dsh 版本依賴dsh >=0.1.5-rc.1或@linxin666/dsh-pet。
- 渲染器版本必須與目標 dsh profile 的版本對應，否則可能導致顯示異常或安裝失敗。 - MIT 代碼：代碼部分採用 MIT 協議開源。
總結¶
鯨魚娘桌寵通過 AI 生成的素材和程序化烘焙的待機動畫，爲 DSH 和 Claude Code 用戶提供了具備交互性的桌面反饋。安裝過程相對簡單，但需注意 Windows 系統的安全提示及不同平臺的渲染器版本兼容性。
