前言¶
DSH 的理念是「一切皆插件」。对使用 DSH Web 的开发者来说，页面里已经有模型对话和工具调用，但缺少一个轻量、可见的交互反馈对象。dsh-deepseek-pet 把 DeepSeek 蓝色小鲸鱼桌宠放进 DSH Web 页面，让桌宠浮动在页面右下角，并允许 Agent 通过 pet_say 工具触发台词；对话开始和结束时，桌宠也会做思考与庆祝状态。
下面介绍它的功能、安装和典型用法。
这是什么¶
dsh-deepseek-pet 是一个浮动在 DSH Web 页面上的拟人化宠物插件，仓库路径为 txlznbzsdj-collab/dsh-deepseek-pet，许可证为 MIT。
它解决的核心问题是：在 DSH Web 页面中提供一个可拖动、可点击、可由模型触发说话的蓝色小鲸鱼反馈对象，让开发者在 Web 端观察 Agent 与页面插件的联动。
核心功能¶
模型联动¶
- Agent 可调用
pet_say工具让桌宠说话。 - 模型可以调用
pet_say {text, mood?}命令小鲸鱼在页面上说话。 - 对话开始（思考）与结束（庆祝）会同步到桌宠状态。
桌面互动¶
- 右下角浮动，带呼吸 + 摇摆动画，可拖拽；位置记忆，松手回弹，甩远吐槽。
- 单击说人设台词，台词包括主人 / 大肥鱼 / 吃白饭 / 摸鱼。
- 双击触发开心庆祝和撒花粒子；长按触发撒娇。
- 悬停挥手问候；打字时偷看；随机冒泡（45~90s）；贴边挤压吐槽；失焦打盹（Zzz）。
- 右键菜单有 8 项：回到右下角 / 换姿势 / 讲个冷笑话 / 今日运势 / 摸摸头 / 自我介绍 / 说点什么 / 躲起来。
- 隐藏后，右下角小鲸鱼按钮可以唤回。
安装与启用¶
先确认环境：已安装 DSH（dsh web）与 pnpm。
下面步骤会克隆仓库、构建浏览器端 client.js，再把插件安装到 web profile。
git clone https://github.com/txlznbzsdj-collab/dsh-deepseek-pet.git
cd dsh-deepseek-pet
powershell -ExecutionPolicy Bypass -File ./build.ps1
build.ps1 会把 assets/small/*.png base64 嵌入生成 client.js；client.js 是构建产物，已 gitignore。
dsh plugin --profile web add <本目录绝对路径>
这里的 <本目录绝对路径> 填你本地克隆后的 dsh-deepseek-pet 目录绝对路径。
dsh web --port 3173
经过上面的步骤，重启 DSH Web 并刷新页面后，右下角出现小鲸鱼即可。
典型用法¶
启用后，可以直接在页面上与桌宠互动：单击、双击、长按、悬停、右键菜单都可用。
如果要触发模型联动，可以对模型说：
让小鲸鱼说句话
模型侧的调用形式是：
pet_say {text, mood?}
适用场景与注意¶
适合以下情况：
- 希望 DSH Web 页面里有一个轻量反馈对象。
- 希望 Agent 通过
pet_say触发桌宠台词。 - 希望在对话开始与结束时看到桌宠的状态变化。
安装前需要特别注意：
- 插件以当前
dsh进程权限运行；安装前应检查源码、构建脚本和许可证。 - 插件许可证为 MIT。
- 角色美术来自
YunYueSama/codex-deepseek-pet的 DeepSeek 拟人化桌宠素材；该仓库的角色图片不在其 MIT 许可范围内，但已获原作者授权复用，详见ASSET_LICENSE.md。 client.js为构建产物，已 gitignore；修改素材或模板后需要重新运行build.ps1生成。- 需要已安装 DSH（
dsh web）与pnpm。
结尾¶
dsh-deepseek-pet 的价值很具体：给 DSH Web 页面加一个可互动、可被模型触发的 DeepSeek 蓝色小鲸鱼，并把对话开始与结束状态同步到桌宠。
相关链接：
- GitHub：https://github.com/txlznbzsdj-collab/dsh-deepseek-pet
- 社区目录页（插件线索）：https://www.skillhub.cn/plugins/txlznbzsdj-collab/dsh-deepseek-pet
