A 3D-rendered whale desktop pet that swims around the lower-right corner of the dsh web UI and reacts to task events with attention animations and whale-call sounds.
Install
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:FaMuer/dsh-real-fish-pet
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
This plugin publishes its README in Chinese only.
在 DeepSeek Harness web 界面里游动的 3D 渲染鲸鱼桌面宠物（个人用插件）。
鲸鱼模型为原创 Blender 作品（受 DeepSeek 标志启发），所有动画帧由 Blender 头less 逐帧渲染，行为全部由本插件自定义实现（不依赖 dsh-pet 状态机）。
行为
- 默认状态：在屏幕右下 1/4 区域（52–84vw / 54–78vh）内随机连续游动，出界自动折返；鼠标悬停时原地冻结，移开后继续。
- attention（任务事件提示）：模型任务完成 / 出错 / 需要手动处理（批准请求）等事件触发跳跃 attention 动画 + 随机播放鲸吟 1/2/3.mp3（两次事件间隔 ≥6s 防轰炸；声音需先与页面有过一次交互才会自动播放）。
- 交互：
- 单击：停下游动 + 反应动画 + 气泡
- 双击：位置不变，直接恢复自由游动
- 拖拽：可拖到任意位置，松手后从新位置继续游动
- 右键菜单（宠物头上
⋮）：开心一下 / 原地睡觉 / 回家睡觉（游到右下角 HOME 然后睡 5 分钟后自动醒来游动）/ 自由游动 / 隐藏宠物 - 隐藏后右下角出现「召唤宠物」按钮
结构
lib/index.js host 半：资源静态路由 + 事件队列 HTTP API（node:fs，无额外依赖）
lib/client.js browser 半：ModuleLoader bundle（手写，无构建步骤）
assets/ 帧图（idle/react/drag/swimL/swimR/turn）+ 鲸吟音效
cordis.patch.yml 一行插件行挂载
- 资源路由：
/dsh-real-fish/assets/...（PNG/MP3，Cache-Control: public, max-age=86400） - 事件 API：
GET /dsh-real-fish/api/poll（client 每 2s 轮询）、/api/stats
安装（本地开发）
dsh plugin --profile web add link:<本目录绝对路径>
# 重启 dsh web 后宠物自动出现（无需手动运行插件）
发布
npm pack产出 tarball（或直接推 GitHub 仓库）。- 发布到 npm registry（需 npm 账号）后即可被市场 /
dsh plugin add安装。
许可
- 代码与资产：CC-BY-4.0（详见 LICENSE）。
- 鲸鱼为原创模型二次创作（灵感来自 DeepSeek 标志），与 DeepSeek 官方无关联。
Links
More in this category
PC2005-cloud/dsh-pet#dsh-pet★ 3496
Desktop pet for the DSH Web UI on Windows, macOS and Linux: 106 transparent animations in the browser overlay or a transparent always-on-top desktop window, throw-and-bounce drag physics with squash and particle scoring, a work-status bubble driven by live session events, self-talk and chat with persistent memory, balance display, meme-image bubbles, multiple pets on screen, and drop-in custom animations and pet packs.
Nagi-ovo/dsh-ads★ 682
Parody ads in 2005-Chinese-web style: sidebar banners, in-chat feeds, corner popups, and a close button whose hit area is smaller than it looks. All fictional.
vlln/whale-girl★ 375
Desktop pet (QQ-pet style): floats in the corner, draggable, feedable, playable.
yyh-001/dsh-meme★ 295
Chat meme stickers: text-only send, mood auto-send, QQ/WeChat-style picker, auto-learn, custom packs.
a86582751/dsh-nexttavern★ 191
NextTavern is a long-form roleplay plugin for DeepSeek Harness 0.1.7-rc.2 Web, with character-card import and creation, worldlines, worldbooks, layered long-term memory, keyword/semantic/hybrid retrieval, character agents, and card or novel export. SillyTavern character-card import is supported; v0.2.9 fixes distribution and installation.
Sutera-Diffusus/dsh-whale-musume★ 156
A whale-girl companion for DeepSeek Harness with 45 achievements, daily quests and weekly check-ins, three mini-games, 92 artworks, 620 dialogue lines, a growth journal, weather and festival reactions, per-tool work poses, cross-device save export/import (JSON file or migration code), accessibility mode and an optional MiMo TTS bridge. Data stays in the host localStorage with no telemetry. Verified on DSH desktop 0.2.0-rc.2; compatible with 0.2.1-rc.1/rc.2 and legacy 0.1.x web.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.