前言¶

在 DeepSeek Harness（DSH）的工作流中，智能體通常在終端或後臺靜默運行，缺乏一種持久且直觀的交互載體。爲了增強用戶的感知存在感，桌面寵物插件應運而生。

這是什麼¶

DeepSeek Harness 3D 豬槽魚（鯨魚）桌面寵物插件是一個爲 DSH 環境設計的 3D 桌面寵物組件。

該插件由維護者 rongzi5 開發，旨在爲智能體會話提供一個可視化的交互窗口。它不僅是一個靜態模型，更集成了 LLM 聊天、記憶管理、會話進度查詢以及子代理任務調度功能，解決了單一終端交互缺乏上下文延續性和視覺反饋的問題。

核心功能¶

1. 3D 渲染與行爲
   使用 three@0.147.0 程序化渲染鯨魚模型，不依賴外部 CDN 或 iframe。寵物會停留在視口邊緣休息，並在隨機長間隔下進行巡邏。它具有形狀感知的拖拽能力，支持慣性釋放，並會跟隨鼠標指針。

2. 交互與控制
   - 點擊 Recap：點擊身體可循環顯示名稱、共同天數及最近會話事件。
   - 右鍵菜單：提供聊天（LLM）、記憶管理、重命名、調整大小、角吸附等功能。
   - 角吸附與快捷鍵：開啓後，拖拽鬆手會自動吸附至最近角落。使用 Ctrl/Cmd + Alt + W 快捷鍵可隨時隱藏或顯示寵物。
   - 拖拽眩暈：快速或長時間拖拽會導致寵物眩暈（翻肚皮），暫停交互。

3. 智能集成
   - LLM 聊天與記憶：通過右鍵菜單“和鯨鯨聊天”進行對話，記憶存儲於 localStorage。對話氣泡有 60 字符限制，但 [記住] 行不受此限。
   - 會話進度查詢：詢問“進度如何了”時，寵物會主動探測並報告當前會話狀態。
   - 子代理任務調度：當需要執行代碼或運行命令時，寵物會觸發真實的子代理任務。

安裝與啓用¶

目前未提供具體的安裝命令。該插件需要配合 DeepSeek Harness 3D 豬槽魚（鯨魚）環境 使用。

倉庫地址：github.com/rongzi5/dsh-whale-pet

典型用法¶

1. 開始對話
   右鍵點擊寵物，選擇“和鯨鯨聊天…”。在彈出的輸入框中發送消息（支持 Enter 發送，Esc 關閉）。寵物會通過氣泡回覆，支持 SSE 流式輸出。

2. 管理記憶
   右鍵點擊“鯨鯨記得什麼…”查看或刪除持久化記憶，或直接輸入 [記住] <事實> 來添加新記憶。

3. 查看狀態
   點擊寵物身體，查看名稱、共同天數以及最近的會話事件（如工具運行結果、里程碑）。

4. 調整大小與隱藏
   在右鍵菜單中拖動滑塊調整大小（50%-150%），或使用快捷鍵 Ctrl/Cmd + Alt + W 快速隱藏。

適用場景與注意¶

• 適用場景：需要長期跟蹤用戶上下文、通過視覺反饋增強智能體存在感、或需要寵物代理協助處理後臺任務的開發者。
• 注意：
• 大小調整僅改變渲染縮放，不影響寵物在邊緣的休息位置和巡邏路徑。
• 對話氣泡有 60 字符限制，但 [記住] 標記的行不受此限。
• 記憶與狀態通過 localStorage 持久化（注意私有模式下的兼容性）。
• 需確保 DeepSeek Harness 3D 環境正常運行。

短結尾¶

這是一個功能完備的桌面寵物插件，通過將 LLM 能力與 3D 交互結合，爲 DSH 用戶提供了更豐富的會話體驗。更多細節請參考項目主頁。