浮动在 DSH Web 页面上的 DeepSeek 蓝色小鲸鱼桌宠:可拖拽,说话气泡与心情姿势随互动切换,模型可调用 pet_say 工具让它开口,对话开始/结束时自动进入思考与庆祝状态。
安装
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:txlznbzsdj-collab/dsh-deepseek-pet
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
DeepSeek 蓝色小鲸鱼桌宠 🐋 —— 浮动在 DSH Web 页面上的拟人化宠物插件。
- 可拖拽 / 撒娇 / 庆祝 / 摸鱼的萌系鲸鱼女仆,人设台词(主人 / 大肥鱼 / 吃白饭 / 摸鱼)
- 模型联动:Agent 可调用
pet_say工具让桌宠说话;桌宠会同步对话开始(思考)与结束(庆祝) - 素材风格:蓝色渐变长发、鲸鱼尾巴、深蓝白女仆装(角色美术来自 YunYueSama/codex-deepseek-pet 的 DeepSeek 拟人化桌宠素材。 注意:该仓库的角色图片不在其 MIT 许可范围内,但已获原作者授权复用,详见 ASSET_LICENSE.md)
功能(v3)
模型联动(新增)
pet_say工具:模型(Agent)可以调用pet_say {text, mood?}命令小鲸鱼在页面上说话—— 工具在 host 侧注册,经/plugins/pet-eventsSSE 通道实时推给浏览器里的桌宠。- 对话起止同步:监听会话
turn/start/turn/end—— 对话开始 → 小鲸鱼切换 curious 思考姿势 + "收到主人!深度思考中…"; 对话结束 → happy 庆祝 + "搞定啦主人!鲸鱼完美收工~"(自动忽略子代理噪音)。
桌面互动
- 右下角浮动,呼吸 + 摇摆动画,可拖拽(位置记忆,松手回弹,甩远吐槽)
- 单击说人设台词(主人 / 大肥鱼 / 吃白饭 / 摸鱼 / 撒娇)
- 双击开心庆祝 + 撒花粒子;长按撒娇
- 悬停挥手问候;打字偷看(输入框敲键盘时偶尔冒一句)
- 随机冒泡(45~90s);贴边挤压吐槽;失焦打盹(Zzz)
- 右键菜单(8 项):回到右下角 / 换姿势 / 讲个冷笑话 / 今日运势 / 摸摸头 / 自我介绍 / 说点什么 / 躲起来
- 隐藏后右下角 🐋 按钮唤回
架构
┌─ host 侧 (index.js) ─────────────────────────────┐
│ pet_say 工具 (agent.ctx.tools.register) │
│ └→ broadcast({type:'say', text, mood}) │
│ ctx.on('session/event') turn/start|end(根会话) │
│ └→ broadcast({type:'turn', phase}) │
│ webServer exact 路由 /plugins/pet-events (SSE) │
└────────────────────────┬─────────────────────────┘
│ SSE
┌─ 浏览器侧 (client.js) ──▼────────────────────────┐
│ EventSource('/plugins/pet-events') │
│ say 帧 → 气泡 + mood 姿势 │
│ turn start → curious 思考 / end → happy 庆祝 │
└──────────────────────────────────────────────────┘
安装
要求:已安装 DSH(dsh web)与 pnpm。
# 1. 克隆并构建(生成 client.js)
git clone https://github.com/<you>/dsh-deepseek-pet.git
cd dsh-deepseek-pet
powershell -ExecutionPolicy Bypass -File ./build.ps1
# 2. 安装到 web profile(dsh 会自动加入 bundles 并应用补丁层)
dsh plugin --profile web add <本目录绝对路径>
# 3. 重启 DSH Web 并刷新页面
dsh web --port 3173
重启后右下角出现小鲸鱼即可。模型联动无需额外配置:
对模型说「让小鲸鱼说句话」即可触发 pet_say 工具。
开发
powershell -ExecutionPolicy Bypass -File ./build.ps1 # 改素材/模板后重新生成 client.js
node ./smoke.test.mjs # 冒烟测试(Node VM + DOM stub)
文件
client.template.js— 浏览器端源码模板(__B64_*__占位符,含 SSE 接收)build.ps1— 把assets/small/*.pngbase64 嵌入生成client.jsclient.js— 构建产物(浏览器端 bundle,__ModuleLoader__.load格式,已 gitignore)index.js— host 侧插件(SSE 通道 + pet_say 工具 + 会话事件同步)cordis.patch.yml— bundle 补丁层(插入 host 行)smoke.test.mjs— Node VM + DOM stub 冒烟测试(含 SSE 帧处理)
链接
同类插件
PC2005-cloud/dsh-pet#dsh-pet★ 6236
DSH Web UI 桌面宠物,Windows / macOS / Linux 三端可用:浏览器浮层或透明置顶桌面窗口,106 个透明动画、带挤压与粒子的甩抛反弹物理、随会话事件实时联动的工作状态气泡、碎碎念与带持久记忆的对话、余额展示、表情包配图、多开同屏,并支持直接放入的自定义动画与宠物种类(pet pack)。
flizzywine/dsh-tavern#dsh-tavern★ 1606
基于 DeepSeek Harness 的 Agent 酒馆,兼容 SillyTavern 生态,人物卡导入即玩,支持多种模型和手机游玩。桌面端从「设置 → 酒馆启动器」安装酒馆。 基于 2NF/dsh-profile-bridge(MIT)改造的启动器:把酒馆下载到独立 DSH 配置并在重启时切换。与上游插件不能同装——两者都占用 /profile-bridge 通道。
Alterssss/dsh-bili-whale★ 1042
一条按自己作息过日子的 B 站插件:宿主里每 60 秒一次心跳,在设定的作息窗口里随机挑一个时刻叫醒专用会话(今天不想看是按概率跳过),再交给自带的 38 个子命令——信息流、字幕、弹幕、评论、ffmpeg 抽帧、两本日记。每天最多发 N 条评论/动态并 @ 主人(默认 3,按配额账本计数,撞到限流或验证码就停手)。同时轮询评论回复、私信和直播间弹幕;除主人以外的回复先入队,等主人在设置页批准。设置 → 养鱼 写 ~/.dsh/bili-whale.config.json;cookie 单独在 ~/.bili-ai/credentials.json,只写不回显。HTTP 路由只认回环地址并过 DSH 信任栅栏。抽帧需要 Node 18+ 与 ffmpeg。
Nagi-ovo/dsh-ads★ 722
2005 年中文站点风格的整活广告插件:侧栏广告/信息流/角落弹窗 + 假关闭叉,素材全虚构。
yyh-001/dsh-meme★ 566
聊天表情包:纯文本斗图、情绪主动发图、像 QQ/微信 一样发图、AI 自动学图、自定义表情包。
vlln/whale-girl★ 409
桌面宠物(QQ 宠物形态):右下角悬浮、可拖拽/投喂/玩耍。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。