mmzm0808/dsh-ventus-whale

Name: mmzm0808/dsh-ventus-whale
Author: mmzm0808

桌面端Desktop 原生Native ⭐ 5 MIT Web 界面Web UI

🐳 蓝色大肥鱼 · DeepSeek 虎鲸 3D 桌宠插件 — 由 DeepSeek 虎鲸 logo 轮廓重建，悬浮于 Web GUI 角落：拖拽旋转、360° 转圈、爱心互动、悬停工具栏、大小/灵敏度/文字设置，配置本地持久化

项目介绍Project Overview

由知微Agent(zhiwei)编辑Edited by Zhiwei Agent (zhiwei)

dsh-ventus-whale 是一款 DSH Web GUI 客户端插件，基于 three.js 在视口角落渲染 DeepSeek 虎鲸 logo 重建的 3D 桌宠，支持拖拽旋转、单击爱心、双击弹跳、发送消息自动 360° 翻跟头、悬停工具栏改名/重置/拖动，以及大小、灵敏度、自定义文字等可调项。空闲时降帧，隐藏时零渲染，适合想在 DeepSeek 对话界面中加一只可陪伴的虚拟宠物时使用。注意：仅 Web 客户端，安装后需重启 dsh 才能加载新 bundle。

dsh-ventus-whale is a DSH web client plugin that places an interactive 3D orca desk pet, modeled from the DeepSeek whale logo, in the corner of the Web GUI. Built on three.js and inlined into the client bundle (~124KB gzip), it supports arcball drag-to-rotate, single-click hearts, double-click bounces, an optional 360° flip on message send, a hover toolbar for rename/reset/drag/heart/spin, and settings for size, sensitivity, and custom label text. Idle frames drop and the pet stops rendering when hidden. Use it to add a lightweight mascot to the chat interface. Note: web client only; restart dsh after install to load the new bundle.

在 GitHub 查看View on GitHub

发给你的 DSH 安装Send to your DSH

请帮我了解并安装插件：【dsh-ventus-whale】【https://github.com/mmzm0808/dsh-ventus-whale】

把上面这条消息直接发给当前会话里的 DSH，让它帮你了解并安装。安装命令不一定准确，发给 DSH 更稳。Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.

或使用命令行安装（适合开发者）Or use CLI install (for developers)

命令行安装CLI Install

dsh plugin --profile web add github:mmzm0808/dsh-ventus-whale#v0.1.0

把 mmzm0808/dsh-ventus-whale 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

4.2 KB · 缓存于 2026-08-25 04:55:24 · 4.2 KB

🐳 dsh-ventus-whale

🧩 一键整合安装：dsh-ventus-plugins —— 本插件已并入整合包，也可按本仓库方式单独安装。

蓝色大肥鱼 · DeepSeek 3D 桌宠 —— 一只由 DeepSeek 虎鲸 logo 轮廓构建的可交互 3D 桌宠，悬浮在你的 Web GUI 角落，陪你聊天、跟头庆祝、冒爱心。

亮色主题预览：游动 · 悬停工具栏 · 360° 转圈 · 爱心喷发暗色主题预览：游动 · 悬停工具栏 · 360° 转圈 · 爱心喷发

✨ 特性

分类	说明
🖼️ 3D 模型	DeepSeek 虎鲸 logo 轮廓 swept 重建，尾鳍 / 背鳍 / 胸鳍 / 眨眼动画，透明背景
🎮 交互	左键拖拽旋转（arcball + 惯性）、右键或「拖动」模式自由定位、单击爱心、双击弹跳
🌀 转圈	发送消息自动翻 360° 前空翻（可关），或悬停工具栏「转圈」按钮手动触发
🧰 悬停工具栏	两行布局：改名 / 重置 / 拖动 / 爱心开关 / 转圈；触屏点按唤出
⚙️ 设置	大小（窗口随缩放，鲸鱼始终完整可见）、灵敏度、显示文字；草稿式「保存 / 取消」
🚀 轻量	three.js 内联进 client bundle（gzip ≈124KB）；空闲降帧渲染，隐藏时零渲染

🚀 安装

dsh plugin --profile web add github:mmzm0808/dsh-ventus-whale#v0.1.0

仓库已提交完整 lib/ 构建产物，安装无需执行构建脚本（pnpm ≥10 的 allowBuilds 门禁不影响本插件）
安装后重启 dsh（新 bundle 层在启动时加载）
本地开发安装：dsh plugin --profile web add "<本仓库本地绝对路径>"

🐳 使用

召唤：点侧边栏底部（设置旁）的 🐋 按钮——再点一次隐藏；默认停靠视口右侧中部，可自由拖走
交互：左键拖动旋转 · 右键或「拖动」按钮移动 · 单击爱心 · 双击弹跳 · 悬停工具栏改名 / 重置 / 拖动 / 爱心开关 / 转圈
设置：设置 → Ventus 插件 → 大肥鱼桌宠 → 调大小 / 灵敏度 / 文字后点「保存」生效

⚙️ 设置项

设置	说明
启用开关	开 / 关虎鲸（修改后点保存生效）
发送时翻跟头	发送消息时虎鲸翻一个 360° 跟头庆祝
大小	虎鲸窗口随大小缩放（0.2×–3×，鲸鱼始终完整可见）
灵敏度	拖动旋转灵敏度（0.2×–5×）
显示文字	虎鲸下方的自定义文字，留空隐藏

🗂️ 数据与安全

配置持久化在 ~/.dsh/dsh-ventus-whale/config.json（原子写入 + fsync）
API：/api/ventus-whale/state | update | reset（loopback-only，仅本机可访问）

🛠️ 开发

pnpm install
pnpm build      # tsc types + tsdown（host lib + client bundle）
pnpm verify     # typecheck + 冒烟测试

🐋 Ventus 系列插件

插件	说明	仓库
🐳 dsh-ventus-whale	蓝色大肥鱼 · DeepSeek 虎鲸 3D 桌宠	GitHub
📊 dsh-deepseek-usage	DeepSeek API 用量监测（悬浮球 + 面板）	GitHub
🔍 dsh-ventus-search	多引擎搜索与正文抓取（Bing / 360 / Bilibili）	GitHub

📄 许可证

第三方声明（three.js MIT，内联进 client bundle）见 THIRD_PARTY_NOTICES.md
模型几何体来自 DeepSeek 虎鲸 logo 轮廓的 swept 重建，着色器实现 logo 眼斑图案

⭐ Star History

渲染基于仓库 mmzm0808/dsh-ventus-whale 的 README.md。在 GitHub 查看原文 →

命令行安装CLI Install 复制安装命令Copy Install