前言¶

DSH 的扩展方式是“一切皆插件”。社区目录里会出现这类挂在 DSH 网页界面上的小型插件：不替代 Agent 工作流，只把状态、审批、通知等信息转成可见交互。whale-on-desk 就是其中一个对象：给 DeepSeek Harness 提供一只像素鲸鱼桌宠。下面介绍它的定位、安装方式、典型用法和注意边界。

这是什么¶

whale-on-desk 是 cookiesheep 维护的 DSH 插件，定位是“给 DeepSeek Harness 的像素鲸鱼桌宠”。它适用于 DSH 网页界面，也可用于 DSH Desktop。README 状态徽章标注为“早期预览”，许可证为 MIT。

宿主端为 Cordis 插件，监听 session/event，并在 DSH web 服务器暴露 /whale/state、/whale/poke、/whale/assets/*。资料声明插件只读，不碰会话和文件。

核心能力¶

1. 实时反映 Agent 状态：任务运行中、模型输出中、调用工具、请求批准、任务完成、任务失败。
2. 请求批准时，鲸鱼贴住屏幕边缘敲玻璃，并显示琥珀色脉冲；浏览器标签标题出现通知提示。
3. 任务完成时空翻庆祝，并汇报耗时、工具数、文件数；任务失败时下沉，眼睛变横线。
4. 可拖到任何位置，位置自动记住。
5. 音效为实时合成，零音频文件。
6. 成长系统：完成任务、开启会话、陪伴时长累积经验，可解锁 8 个称号。
7. 提供 whale_say 工具，让 Agent 使鲸鱼说话和表演，作为通知通道。
8. 水族馆模式：全屏水族箱，包含随工具调用生长的进度珊瑚、计数本回合工具数的小鱼群；等批准时鲸鱼冲向缸边敲玻璃。
9. AI 宠物工坊：注册 pet-forge 技能，可生成并热切换自定义桌宠，需要 PATH 里有 ffmpeg。
10. 自定义桌宠：把状态映射到 GIF 的 manifest.json 和 GIF 放入指定目录，右键切换立即生效。

安装与启用¶

先做网页版安装：

dsh plugin --profile web add whale-on-desk

打开或重启 DSH 网页界面即可。无需 API Key，无需额外配置即可使用网页界面。

如果使用 DSH Desktop，社区资料说明 DSH Desktop 是 Electron 桌面版，且跑的是官方 Web 客户端。先通过应用托盘打开 Open DSH Terminal：

dsh plugin add whale-on-desk

然后重启 DSH Desktop。

当前 package.json 版本为 3.0.0。peerDependencies 包含：

• @deepseek-ai/cordis
• @deepseek-ai/dsh-client-runtime
• @deepseek-ai/dsh-client-ui-slots
• @deepseek-ai/dsh-host-webserver
• react

卸载：

dsh plugin --profile web remove whale-on-desk

典型用法¶

先验证基础交互：

1. 悬停鲸鱼，查看当前任务统计牌，信息包括耗时和工具数。
2. 点击、单击或双击鲸鱼，触发惊吓、吱吱叫或惊醒反应。
3. 右键点鲸鱼，打开小菜单：静音、回到默认位置、换桌宠、隐藏。
4. 隐藏后，双击右下角恢复按钮恢复显示。

自定义桌宠：

1. 创建目录：

~/.dsh/whale-on-desk/pets/<名字>/

2. 放入一套精灵：一个把状态映射到 GIF 的 manifest.json，以及对应 GIF 文件。
3. 右键桌宠切换，立即生效。

AI 宠物工坊：

直接对 Agent 说“给我做一只粉色章鱼桌宠”。它会设计精灵图、生成 GIF、装成宠物包并热切换，需要 PATH 里有 ffmpeg。

水族馆模式：

右键鲸鱼选择水族馆，进入全屏水族箱；按 Esc 或关闭按钮回到桌面伙伴模式。

审批与演示：

• 请求批准时，鲸鱼贴住屏幕边缘敲玻璃，并显示琥珀色脉冲；浏览器标签标题出现通知提示。
• 如需录演示或截图，配置 allowPreview: true 会额外开启 POST /whale/preview。
• 触发状态：{"state":"glass-tap"}。
• 恢复：{"state":null}。
• allowPreview 默认关闭。

睡眠超时：

在 cordis.patch.yml 配置 sleepAfterMinutes，默认 10。

适用场景与注意事项¶

适合：

• 在 DSH 网页界面使用 Agent，希望审批等待、任务完成/失败有可见提醒。
• 在 DSH Desktop 中把 Agent 状态放到桌宠里。
• 希望用 whale_say 给 Agent 增加一条轻量通知通道。
• 想用自定义 GIF 或 AI 生成桌宠替换默认鲸鱼。

注意：

• 插件以当前 dsh 进程权限运行，安装前应检查源码、许可证和依赖。
• 当前许可证为 MIT。
• 该插件与 DeepSeek 无官方关联；DSH 社区目录是独立站点，不等同于官方应用商店。
• AI 宠物工坊需要 PATH 里有 ffmpeg。
• allowPreview 默认关闭，配置后才开启 preview endpoint。
• DSH Desktop 的具体兼容版本/运行方式未给出，建议以实际运行环境为准。
• 动画语法与像素规范致敬 clawd-on-desk，未共享素材或代码；clawd 美术归 Anthropic 所有。

链接¶

GitHub：https://github.com/cookiesheep/whale-on-desk

插件目录页（来自插件线索，README/package.json 未列出）：https://www.skillhub.cn/plugins/cookiesheep/whale-on-desk