前言¶
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
