DSH plugin 鲸鱼宠物挂件怎么装？DeepSeek Harness 桌面宠物安装与互动设置

DSH plugin 鲸鱼宠物挂件（中文也常写作 DSH插件、DeepSeek插件），指的就是社区里的 3D 桌面宠物 dsh-whale-pet：它常驻在 DeepSeek Harness 界面里会游动、按会话状态做表情，还能和它聊天（来源）。 它和「余额鲸鱼挂件」是两个不同插件——一个是宠物向，一个是数据面板向，别混为一谈。下面从五个方向讲全：① 它是什么、和余额挂件差在哪；② 它能做什么互动；③ 怎么装与启用；④ 聊天功能的密钥从哪来；⑤ 加载不出来怎么排查。想找同类挂件，可以在 DSH Plugin Hub 的市场里按 whale、pet 等关键词搜。

DSH plugin 鲸鱼宠物挂件是什么，和余额挂件有什么区别

鲸鱼宠物挂件是「宠物向」的界面组件：重点是陪你玩、跟着会话状态做反应，而不是显示余额数据（来源）。 它的主要表现：

1. 常驻游动：停在视口边缘、长时间随机巡逻，会朝指针方向看、被悬停时冒出爱心。
2. 临场反应：按会话状态切换表情——思考、工作、专注、庆祝、出错、犯困、等你审批等，长任务完成会绕圈庆祝。
3. 可互动：可拖动、吸附到角落、右键改名与调整大小（50%–150%）、隐藏，也能用快捷键一键显示或隐藏。
4. 能聊天：右键「和鲸鲸聊天」可用大模型对话，并记住关于你的少量长期信息。

和余额挂件的区别很清楚：余额鲸鱼挂件是数据面板，显示 DeepSeek 账户余额与用量；鲸鱼宠物挂件是桌面宠物，重心是互动与状态表情，两者并非同一个插件。对照着看更清楚：

一句话记：名字都带鲸鱼，但一个是「养着玩」，一个是「看钱用」。

它能做什么：状态表情与交互一览

把它的行为按「什么时候触发、表现成什么」摊开，能更直观地理解这只宠物在做什么：

除了被动反应，你还能主动操作它：拖动挪位置、吸附到角落、右键改名、调整大小（50%–150%）、隐藏，或用快捷键一键显示 / 隐藏。 这些都属于界面层的互动，不影响会话本身——换句话说，它是个「不影响正事的陪伴层」。

DSH plugin 鲸鱼宠物挂件怎么装与启用：从下载仓库到重启 Web 界面

鲸鱼宠物挂件不用常规的 dsh plugin add，而是走仓库自带的安装脚本 node install-profile.mjs web（来源）。 按顺序做四步：

1. 下载仓库：用 GitHub ZIP 或 git clone 把仓库取到本机；这一步需要本机 Node.js 22+。预期：本机出现仓库目录，node -v 显示 22 或更高。
2. 运行安装脚本：在仓库目录执行 node install-profile.mjs web。它会把包复制到 $DSH_HOME/profiles/web/plugins/ui-whale-pet，加进 profile 清单与 node_modules，并把 ui-whale-pet 的 Cordis 行追加到该 profile 的 cordis.patch.yml。该脚本只适用于 Node 版 CLI / Web profile。预期：$DSH_HOME/profiles/web/plugins/ 下出现 ui-whale-pet，profile 清单与 cordis.patch.yml 里有对应条目。
3. 配置聊天密钥：想让鲸鱼能聊天，需要给它配好代理用的 API key，否则聊天会报未配置；它可读插件配置、DSH_WHALE_API_KEY，或退回 DeepSeek Harness 凭据里的 DEEPSEEK_API_KEY。预期：配好 key 后聊天不再报未配置。
4. 重启并强刷：重启 dsh web，再硬刷新浏览器，宠物就会出现。

第 2 步和第 4 步之后各有一个校验点，可以用命令确认到位：

# 2) 脚本是否真的写进了 profile
ls "$DSH_HOME/profiles/web/plugins/ui-whale-pet"
# 应看到该目录存在；目录不存在说明安装脚本没成功

# 3) 加载行是否被追加
grep -n "ui-whale-pet" "$DSH_HOME/profiles/web/cordis.patch.yml"
# 应看到 ui-whale-pet 的 Cordis 行；没有这一行，界面里就不会出现宠物

预期：两条都有输出，说明「文件已写入」且「加载已登记」；缺任何一条，都要回到对应步骤重做。

补充：官方桌面客户端读的是保留的 desktop profile，不能用这个脚本，也不能用常规 CLI 装——桌面端请在其 Plugins 页面安装打包后的 bundle。

聊天功能的密钥从哪来：三层优先级

鲸鱼宠物能不能聊天，取决于它的聊天代理能不能拿到一把可用的 key。它按固定顺序找三层来源，命中即停：

三层都没有时，聊天功能就会以错误表情提示代理不可用。 所以如果只想让宠物能聊天又不想单独配 key，确保 DeepSeek Harness 凭据里已经有一把可用的 DEEPSEEK_API_KEY 就行。

DSH plugin 常见问题：加载不出来、与余额挂件并存、换同类挂件

鲸鱼宠物挂件的常见问题集中在「没写进 profile」和「和别的挂件抢位置」两类。

1. 加载不出来：先确认安装脚本真的执行成功、profile 清单里能看到 ui-whale-pet；再重启 dsh web 并硬刷新浏览器，排除旧缓存。预期：profile 清单里能看到 ui-whale-pet，刷新后宠物重新出现。
2. 和余额挂件同时装：两者是独立插件，一般能共存，但都占右下角，可能挤在一起；只想留一个时，隐藏或卸载对应插件即可。预期：只留一个挂件时，右下角不再重叠。
3. 想换成别同类挂件：宠物向与数据向是两条线，先想清楚要「陪玩」还是「看数据」，再到 DSH Plugin Hub 按关键词挑选，避免把两个挂件当成同一个重复安装。预期：按关键词能找到宠物向或数据向的对应条目。

排查时记住一条分界线：「清单里没有条目」是安装问题，「清单里有但界面不显示」多半是缓存或没重启——两类原因的处理完全不同，先分清再动手。

关于 DSH plugin 鲸鱼宠物挂件的常见误解

下面是搜索与讨论里最常出现的误解，逐条对照一遍：

1. 「它和余额挂件是同一个」——不是。 宠物向与数据向是两个独立插件。
2. 「用 dsh plugin add 就能装」——不行。 它走仓库自带的 install-profile.mjs 脚本。
3. 「脚本随便什么环境都能跑」——不是。 只适用于 Node 版 CLI / Web profile，桌面端另走一路。
4. 「装完立刻就能看到」——要重启并强刷。 宠物在重启 dsh web 后才会加载。
5. 「聊天不用配 key」——要配。 三层密钥来源都没有时，聊天会报未配置。

关于 DSH plugin 鲸鱼宠物挂件的注意事项

记住「它是宠物不是余额面板、它用脚本装不是用 plugin add」这两点，就够用了。

1. 别混淆插件：鲸鱼宠物（宠物向）与余额鲸鱼（数据向）是两个不同插件。
2. 用对安装方式：走 node install-profile.mjs web，不是常规 dsh plugin add。
3. 准备 Node 版本：安装脚本要求本机 Node.js 22+。
4. 装完看两处：plugins/ui-whale-pet 目录存在、cordis.patch.yml 里有条目。
5. 聊天要配密钥：不配 key 会报未配置，补上后重启即可。
6. 桌面端另走一路：desktop profile 保留，桌面端在其 Plugins 页面装 bundle。
7. 装完要强刷：重启 dsh web 后硬刷新浏览器。
8. 余额挂件见《余额鲸鱼挂件怎么装》，同类插件在 DSH Plugin Hub 里找。

来源：社区插件仓库 - dsh-whale-pet、DeepSeek Harness CLI 官方 README。