DSH Plugin HubDSH 插件市场
nzl153/dsh-pet-whale 预览 preview

nzl153/dsh-pet-whale

Desktop桌面端 Native原生 ⭐ 11 MIT Pets & Fun桌宠与娱乐Clients & Launchers客户端与启动器

Translation result: 请提供需要翻译的英文插件描述原文。

Project Overview项目介绍

Edited by Zhiwei Agent (zhiwei)由知微Agent(zhiwei)编辑

This is a desktop pet plugin built natively for the DeepSeek Harness (DSH) web interface. It places an official branded little whale in the bottom right corner of the DSH UI, and the whale’s animations update automatically to match the current state of the DSH agent. It is implemented entirely with pure DOM, so it has no dependencies on React or any third-party runtime libraries. Sound effects are generated via WebAudio synthesis, so no separate audio files are required to be bundled with the plugin, keeping the installation size small.

The whale supports a wide range of interactive operations, including clicking to nudge, double-clicking to 360-degree roll, dragging to reposition, right-click context menus for settings, and automatic movement to avoid blocking user interactions. It tracks DSH agent status through a full featured state machine that covers idle, thinking, working, successful completion, error, and waiting states, updating animations and behavior accordingly. It is designed for DSH users who want to add a cute, interactive companion to their development interface that responds dynamically to their daily workflow.

To install this plugin, you need a DSH version between 0.1.5-alpha.2 and 0.2.0, and Node.js version 22.19.0 or newer, with 24.0.0 or later also fully supported. You can install it either by linking a local directory or directly via a Git link to this repository, and client-side development changes support hot reload without needing to restart DSH. The plugin is released under the open source MIT license, and it also includes optional reference patches for custom DSH UI styling that users can apply if they wish.

这是专为DeepSeek Harness（DSH）Web界面打造的原生桌宠插件，会在界面右下角添加一只官方轮廓版小鲸鱼，动画会随Agent的工作状态实时切换。它采用纯DOM实现，零React依赖、零运行时第三方依赖，音效通过WebAudio合成，无需额外音频文件，支持点击、拖拽、右键菜单等多种交互操作。

它拥有完整的状态机，覆盖空闲、思考、工作、完成庆祝、报错等多种Agent状态，还支持智能避让、主题联动、页面切后台自动暂停、多套换肤、多语言切换、久坐提醒等丰富功能，能给想要给界面增加趣味陪伴的DSH用户带来生动的交互体验。

它要求DSH版本不低于0.1.5-alpha.2且低于0.2.0，Node.js版本为^22.19.0或≥24.0.0，支持本地目录链接安装或Git直装，客户端侧开发支持热更新无需重启DSH，代码基于MIT协议开源，同时提供了自用的DSH界面美化补丁供开发者参考。

View on GitHub在 GitHub 查看

Recommended强烈推荐 Send to your DSH发给你的 DSH 安装 
请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】，检查通过再动手。

插件：dsh-pet-whale（nzl153/dsh-pet-whale）
仓库：https://github.com/nzl153/dsh-pet-whale
本站详情页：https://www.yhbd.top/plugins/nzl153-dsh-pet-whale/
本站登记：类型 client · 归类 原生 DSH 插件 · 许可证 MIT · ⭐ 11 · 最近提交 2026-10-02 · 主语言 JavaScript

按下面顺序执行，每步先把结论告诉我，再进入下一步：

【1 兼容性检查】
① 我这边：DSH 版本、Node 版本、操作系统、当前 profile（web / desktop）。
② 读它的 README、package.json、插件 manifest，列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对，结论只写「满足 / 不满足 / 未知」三种；不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突：命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。

【2 安全性检查】
① 仓库可信度：和上面「本站登记」是否一致；star / fork 数、创建时间、最近提交，是否归档或长期停更。
② 安装脚本：逐行看 package.json 的 preinstall / install / postinstall，以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名，立刻停下来告诉我，不要继续装。
③ 依赖：列出新增依赖，标出无人维护、或与知名包拼写近似的可疑包（typosquatting）。
④ 权限与副作用：它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限（filesystem / network / shell / clipboard 等），以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限，或权限明显超出功能所需，先停下来问我。

【3 安装】
上面两步没有「不满足」和「高危项」时才执行；用官方推荐方式安装，不要自行提权。

【4 汇报】
用表格输出：检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜，也不要替我决定。

Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH：它会先核对兼容性与安全性（逐条给「满足 / 不满足 / 未知」），确认没问题再安装，有高危项会停下来问你。框内可滚动，复制到的是完整提示词；安装命令不一定准确，发给 DSH 更稳。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • 11 stars - an early-stage project星标 11，属于早期项目
  • Desktop client: installation downloads an executable - verify the publisher and checksums桌面客户端：安装会下载可执行文件，请核对发布者与校验和
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时（Electron / Python / Docker 等）是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突：命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致，是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需（filesystem / network / shell / clipboard）
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限，以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照，不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装（适合开发者）

CLI Install命令行安装 

dsh plugin --profile web add "github:nzl153/dsh-pet-whale#main"

把 nzl153/dsh-pet-whale 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

14.3 KB · 缓存于 2026-10-02 22:10:15 · 14.3 KB

pet-whale · 桌宠小鲸鱼 🐳

English | 中文

DeepSeek Harness（DSH）的桌宠插件，桌面端和网页端都能用：右下角一只官方轮廓版小鲸鱼，随 agent 状态实时切换动画。纯 DOM 实现、零 React 依赖、零运行时第三方依赖，WebAudio 合成音效无音频文件。

桌宠小鲸鱼：连戳到闹脾气 → 甩晕 → 翻肚皮 → 按在底边压扁 → 思考 → 敲代码 → 别的会话在跑 → 全部收工庆祝

连戳闹脾气 → 甩晕 → 翻肚皮 → 压扁 → 思考 → 敲代码 → 多会话角标 → 全部收工

在线预览 · 安装 · 特性 · 社区 fork · 开发

在线预览

无需安装，点开即玩（全部状态与交互，官方轮廓版）：

👉 https://nzl153.github.io/dsh-pet-whale/preview.html

预览页 preview.html 直接加载插件本体 lib/client.js，用几个按钮代替 DSH 喂状态；本地用任意静态服务器打开仓库根目录即可。

安装

在你正在用的 profile 目录（桌面端和网页版各用各的 profile，网页版一般是 ~/.dsh/profiles/web）的 package.json 里加上依赖和 bundle：

{
  "dependencies": { "pet-whale": "^1.2.7" },
  "dsh": { "profile": { "bundles": ["...原有的...", "pet-whale"] } }
}

然后在该目录执行 pnpm install，重启 DSH。桌面端要从托盘「退出」再打开。

也可以不走 npm：

# 本地目录安装（仓库已包含构建产物 lib/，无需先构建）
dsh plugin --profile web add link:/path/to/pet-whale

# 或 git 直装
dsh plugin --profile web add "github:nzl153/dsh-pet-whale#main"

要求 DSH >=0.1.5-alpha.2 <0.3.0，Node.js ^22.19.0 || >=24.0.0。各版本的验证情况见兼容性。

特性

状态与陪伴

能力 说明
状态机 idle / think（深潜）/ working（游动 + 敲键盘 + 代码粒子）/ celebrate（跃起冒泡）/ error（发抖 + 尴尬黑线）/ disappointed（报错后短暂失落）/ wait（等待你的输入）；优先级 error > celebrate > think > working > idle
表情 眼睛跟着情绪变：庆祝时笑成 ^，失落时垂下眼、挑起八字眉还掉眼泪，报错是叉叉眼，睡觉和翻肚皮是弯月眼，闹脾气吊眉，被抓住是 >_<
回合语义 回合进行中永不发呆：有工具 = working，无工具（文字流或内部推理）= think 深潜；工具密集期键盘动画粘滞 2.5s
思考流 真实状态为 think 时，模型最近 200 字思考内容悬在桌宠正上方缓慢滚动（可右键开关），同时鲸鱼保持深潜思考动画
跟随所有会话 DSH 0.1.7 起可用：当前会话闲着、别的会话在跑时鲸鱼照样干活，头前一颗小气泡角标显示在跑的个数（跟着身体起伏、轻轻摆动，数字变化时弹一下）；别的会话跑完会庆祝并报出会话名，等你确认时会提醒是哪个会话。子代理不算。「更多设置 → 行为」可关
并发播报 跟随所有会话打开时生效：同时在跑的会话（含当前）到 2 个喊「全速并发推进中」，到 4 个开始抱怨加班；每档只喊一次，这一批真并发过的活全部跑完才说「好累啊，终于全部搞定了」
错误关怀 error 状态下点击鲸鱼或右键「📋 复制错误信息」，直接把错误文本复制到剪贴板
失落安抚 报错后的失落状态下戳它算安慰：开心动画 + 暖心台词，并提前结束自愈
熟悉度 互动次数、完成回合、共处天数一起攒分，关系分三档：初识 / 熟络 / 形影不离。档位会改戳戳台词和回来时的问候，到形影不离还会偶尔主动冒泡搭话；升档时它自己会说出来，当前档位和进度在「陪伴记录」里看
idle 小动作 idle 久了会随机游动、左右张望、吐泡泡，不再只是打瞌睡
自主游动 右键菜单「🏊 游泳」开关：鲸鱼沿三次贝塞尔曲线在页面里自主巡游，带俯仰角、水平自适应翻转、下潜、航迹水圈和破浪水花；忙碌时自动让位，偏好持久化

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要，完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

渲染基于仓库 nzl153/dsh-pet-whale 的 README.md。 在 GitHub 查看原文 →

Related相关推荐

← 上一个 Prev minta 下一个 Next clawtouch-mcp →