前言¶
DeepSeek Harness（DSH）強調插件化擴展能力。whalebuddy 是一款桌面寵物插件，它將 DSH agent 會話的運行狀態映射到桌面上的鯨魚舷窗中。該插件包含感知層插件（運行在 DSH 進程中）和桌面殼（Tauri 應用），通過 WebSocket 實時同步狀態。
核心功能¶
- 狀態感知：寵物窗口實時反映 agent 會話狀態。任務在跑時“幹活”，空閒時“睡覺”，等待批准時“敲門”提醒。
- 交互管理：雙擊鯨魚可管理當前聚焦工作區（項目）的待辦清單。
- 個性化設置：支持設置開機自啓動與更換皮膚。
- 透明置頂：桌面殼爲透明置頂窗口，不遮擋主要操作區。
安裝與啓用¶
安裝感知層插件需使用 DSH Plugin CLI。
dsh plugin --profile web add github:2DogsLee/dsh_whalebuddy
安裝後，bundle 僅在 DSH 啓動時加載，因此需要重啓 DSH。
桌面殼（寵物窗口）是一個獨立的 Tauri 程序（僅支持 Windows）。安裝感知層後，克隆倉庫並在 app/src-tauri 目錄下執行構建。
cd app/src-tauri
cargo build
Start-Process .\target\debug\dsh-pet.exe
配置與使用¶
寵物窗口啓動後，通過以下方式配置：
- DSH GUI 配置：在 DSH GUI 的「設置 → 插件 → 插件配置」中找到「🐋 桌面寵物 whalebuddy」卡片。
- 右鍵菜單：在寵物窗口上右鍵，選擇「🐋 whalebuddy 設置…」。
配置項包括：
* autostart：開機自啓動寵物（需寵物進程在線時保存以寫入註冊表）。
* launchOnDshStart：DSH 啓動時自動啓動寵物。
* petPath：寵物 exe 完整路徑，留空則按註冊表自動發現。
* skin：皮膚 ID，默認爲 dsh-black-whale。
依賴與環境¶
- 平臺支持：桌面殼目前僅支持 Windows 10/11。macOS/Linux 的感知層插件理論可用但未實測，桌面殼未適配。
- 運行時依賴：Windows 10/11 一般自帶 WebView2 運行時。
- 構建依賴：
- Rust/MSVC：僅構建寵物殼時需要。
- Node.js：感知層插件依賴，版本需 ≥ 18。
注意事項¶
- 插件以當前 DSH 進程權限運行。
- 開機自啓功能通過寫入註冊表
HKCU\...\Run\whalebuddy實現，需確保寵物進程在配置保存時處於在線狀態。 - 端口發現依賴於
netstat命令，確保 DSH 進程正在運行且未更改默認端口配置。
