前言¶

DSH 的扩展方式偏“一切皆插件”，社区目录属于独立站点，与 DeepSeek / 幻方无官方从属关系。对于经常使用 Web UI 的 DSH 使用者，dsh-whale-pet 提供一只漂浮的交互式鲸鱼桌宠：它会游动、跟踪鼠标、响应拖拽和点击，也可以在 web profile 中跨 session、跨重启保留。

这是什么¶

lglglglgy/dsh-whale-pet 是由 lglglglgy 维护的 DSH 插件，许可证为 MIT。它的作用是为 DeepSeek Harness Web UI 增加一个漂浮交互式鲸鱼桌宠。

使用前提是 profile 必须带 Web 运行时。web profile 自带 @deepseek-ai/dsh-web-app。如果装在 headless / TUI profile 中，不会显示。

核心功能¶

下面是已核实的交互能力：

• 自由游动：插件会自动在界面上游动。
• 眼神跟踪：眼睛会跟随鼠标位置。
• 拖拽：按住鲸鱼可以拖动位置。
• 点击喷水：单击会触发喷水效果。
• 晕眩：快速来回甩动会进入晕眩状态。
• 连点叫醒：晕眩后连点 5 次可恢复。
• 水波：显示流动的水波效果。
• 腹鳍摆动：游动时腹鳍会摆动。

在 web profile 安装并重启后，该状态可跨 session、跨重启保留。

安装与启用¶

先确认当前 profile 是 web，并且具备 Web 运行时。执行：

dsh plugin --profile web add github:lglglglgy/dsh-whale-pet

这条命令从 GitHub 仓库安装插件。由于 client.js 已是构建产物，从 GitHub 安装不需要额外 build 授权。

安装后重启 Web UI：

dsh web

插件集合变更需要重启后生效。

可以检查配置：

dsh --profile web --dump-config

确认输出中能看到 dsh-whale-pet 相关项。该插件的 peerDependencies 要求 react ^18.2.0，安装环境需满足这一依赖条件。

典型用法¶

安装并重启后，可以按下面方式操作：

1、直接观察自由游动。

2、按住鲸鱼拖动；松手后它会休息 20 秒再继续游。

3、单击喷水，并出现随机气泡对话和一圈泡泡。

4、使用键盘时，Tab 聚焦到鲸鱼后按 Enter 或空格，等同于点击。

5、触发晕眩：快速来回甩动。

6、叫醒：晕眩后连点 5 次。

适用场景与注意¶

它适合希望在 DSH Web UI 里增加轻量交互元素，并且熟悉插件安装流程的使用者。需要注意：

• 只适用于带 Web 运行时的 profile；headless / TUI profile 不显示。
• 插件集合变更要重启 Web UI 后生效。
• 许可证为 MIT。
• 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。

如需移除，执行：

dsh plugin --profile web remove dsh-whale-pet

结尾¶

dsh-whale-pet 的价值比较具体：给 DSH Web UI 增加一只可拖拽、可点击、可晕眩的鲸鱼桌宠，并在 web profile 重启后保留。GitHub 仓库地址是：

https://github.com/lglglglgy/dsh-whale-pet