在 DeepSeek Harness (DSH) 的插件生態中，除了功能性的增強，桌面交互也是提升使用體驗的一環。dsh-ventus-whale 是一款名爲“藍色大肥魚”的桌面插件，它將 DeepSeek 的虎鯨 logo 幾何體轉化爲一個可交互的 3D 桌寵，懸浮於 Web 界面右側。
核心功能¶
- 3D 模型與動畫：模型基於 DeepSeek 虎鯨 logo 輪廓進行 swept 重建，包含尾鰭、背鰭、胸鰭以及眨眼動畫，支持透明背景。
- 交互操作：支持左鍵拖拽旋轉（arcball + 慣性），右鍵或“拖動”按鈕自由定位。支持單擊愛心、雙擊彈跳。
- 動作觸發：發送消息時可自動觸發 360° 前空翻（可關閉），或在懸停工具欄點擊“轉圈”按鈕手動觸發。
- 工具欄與設置：懸停顯示工具欄（支持改名、重置、拖動、愛心開關、轉圈），觸屏設備可點按喚出。設置項包括大小（窗口縮放但鯨魚始終完整可見）、靈敏度、顯示文字。設置採用草稿式保存/取消。
- 輕量化設計：three.js 代碼內聯至 client bundle（gzip 約 124KB）。空閒時降低渲染幀率，隱藏時停止渲染。
安裝¶
通過 DSH CLI 安裝插件：
dsh plugin --profile web add github:mmzm0808/dsh-ventus-whale#v0.1.0
安裝後需重啓 DSH，新 bundle 層會在啓動時加載。
使用¶
- 召喚/隱藏：點擊側邊欄底部（設置旁）的 🐋 按鈕。默認停靠在視口右側中部，可拖拽移動。
- 操作：左鍵拖動旋轉，右鍵或“拖動”按鈕移動，懸停工具欄進行改名、重置、愛心開關或轉圈操作。
- 配置：進入“設置” → “Ventus 插件” → “大肥魚桌寵”，調整大小、靈敏度或文字後點擊“保存”。
數據與安全¶
- 配置文件存儲於
~/.dsh/dsh-ventus-whale/config.（使用原子寫入 + fsync）。 - 提供以下 API 接口，均爲 loopback-only（僅本機可訪問）：
/api/ventus-whale/state、/api/ventus-whale/update、/api/ventus-whale/reset。
注意事項¶
- 性能：插件在隱藏時爲零渲染，節省資源。
- 模型來源：模型幾何體來源於 DeepSeek 虎鯨 logo 輪廓的 swept 重建。
- 許可證：MIT License。
- 維護者：mmzm0808。
總結¶
dsh-ventus-whale 提供了一個輕量、可定製且具備一定交互性的桌面陪伴功能。對於希望在 DSH 界面中增加個性化視覺元素的開發者或用戶，這是一個實用的選擇。
