前言¶
DSH 的理念是「一切皆插件」。對 Web GUI 場景來說，插件不一定要擴展聊天鏈路，也可以擴展界面角落：比如在側邊欄旁邊增加一個輕量的 3D 對象，用於伴隨聊天、消息慶祝、隨手拖拽和交互反饋。
下面介紹 mmzm0808 維護的 DSH 插件 dsh-ventus-whale。它是一個由 DeepSeek 虎鯨 logo 輪廓構建的可交互 3D 桌寵，可以懸浮在 Web GUI 角落，支持拖拽、旋轉、愛心、彈跳、轉圈等簡單互動。
這是什麼¶
dsh-ventus-whale 是一個 DSH Web 插件，當前版本爲 v0.1.0，許可證爲 MIT。
它解決的問題很簡單：在 DSH 的 Web GUI 裏提供一個輕量 3D 桌寵浮窗。這個桌寵由 DeepSeek 虎鯨 logo 輪廓構建，默認出現在界面角落，用戶可以拖走、旋轉、改名，並在發送消息時觸發慶祝動作。
倉庫地址：
https://github.com/mmzm0808/dsh-ventus-whale
核心功能¶
下面列出已覈實的主要能力。
- 由 DeepSeek 虎鯨 logo 輪廓構建的可交互 3D 桌寵。
- 懸浮在 Web GUI 角落。
- 左鍵拖拽旋轉，使用 arcball + 慣性。
- 右鍵或「拖動」模式自由定位。
- 單擊觸發愛心。
- 雙擊觸發彈跳。
- 發送消息時自動翻 360° 前空翻，可關閉。
- 懸停工具欄：改名、重置、拖動、愛心開關、轉圈。
- 設置大小、靈敏度、顯示文字。
- three.js 內聯進 client bundle，gzip 約 124KB。
- 空閒降幀渲染，隱藏時零渲染。
- 配置持久化在
~/.dsh/dsh-ventus-whale/config.json。 - 提供本機 API：
/api/ventus-whale/state、/api/ventus-whale/update、/api/ventus-whale/reset，僅限 loopback 訪問。
模型幾何體來自 DeepSeek 虎鯨 logo 輪廓的 swept 重建，着色器實現 logo 眼斑圖案。
安裝與啓用¶
先安裝插件，再重啓 DSH，使新的 bundle 層加載。
dsh plugin --profile web add github:mmzm0808/dsh-ventus-whale#v0.1.0
倉庫已提交完整 lib/ 構建產物，安裝無需執行構建腳本；pnpm ≥10 的 allowBuilds 門禁不影響本插件。
package.json 聲明瞭以下運行與打包信息：
{
"platform": "web",
"packageManager": "pnpm@11.7.0",
"engines": {
"node": "^22.19.0 || >=24.0.0"
}
}
如果要做本地開發安裝，可以用倉庫本地絕對路徑：
dsh plugin --profile web add "<本倉庫本地絕對路徑>"
典型用法¶
1、召喚桌寵
點側邊欄底部、設置旁的鯨魚按鈕，即可召喚桌寵；再點一次會隱藏。桌寵默認停靠視口右側中部，也可以自由拖走。
2、基礎交互
- 左鍵拖動旋轉。
- 右鍵或「拖動」按鈕移動。
- 單擊愛心。
- 雙擊彈跳。
- 懸停工具欄，可執行改名、重置、拖動、愛心開關、轉圈。
3、調整設置
進入：
設置 → Ventus 插件 → 大肥魚桌寵
可以調整大小、靈敏度、顯示文字，然後點「保存」生效。
4、本機接口
本機可以訪問以下接口：
/api/ventus-whale/state
/api/ventus-whale/update
/api/ventus-whale/reset
這些接口是 loopback-only，僅限本機訪問。
配置與數據¶
配置持久化位置：
~/.dsh/dsh-ventus-whale/config.json
寫入方式爲原子寫入 + fsync。
第三方依賴方面，three.js 爲 MIT 許可證，並已內聯進 client bundle。
適用場景與注意¶
這個插件適合希望在 DSH Web GUI 裏增加一個輕量 3D 桌寵的開發者。它的價值不是擴展聊天能力，而是提供一個可以拖拽、旋轉、互動、隨消息反應的角落浮窗。
使用前需要注意：插件會在當前 DSH 進程權限下運行，安裝前應檢查源碼、許可證和依賴邊界。本插件爲 MIT 許可證，three.js 爲 MIT 許可證並已內聯進 client bundle。
結尾¶
dsh-ventus-whale 把 DeepSeek 虎鯨 logo 做成了一個可交互的 Web GUI 3D 桌寵：安裝命令明確，交互路徑簡單，配置寫入本地，API 也限制在本機訪問範圍內。
倉庫地址：
https://github.com/mmzm0808/dsh-ventus-whale
