在 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 界面中增加个性化视觉元素的开发者或用户，这是一个实用的选择。
