cookiesheep/whale-on-desk

Name: cookiesheep/whale-on-desk
Author: cookiesheep

Desktop桌面端 Native原生 ⭐ 8 MIT Pets & Fun桌宠与娱乐 Approval & Security审批与安全 UI & Themes界面与主题

DeepSeek Harness 的像素风鲸鱼伙伴——当你的智能体工作时它会游动，有审批待处理时会轻敲玻璃。

Project Overview项目介绍

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

whale-on-desk is a native pixel-art whale desktop pet plugin built exclusively for DeepSeek Harness. It tracks the real-time working status of the DSH Agent and displays matching interactive animations. To install the plugin on the official DSH web interface, you just run the command dsh plugin --profile web add whale-on-desk then open or restart the DSH web interface. For the community DSH Desktop Electron build, open DSH Terminal from the app tray, run the same install command then restart DSH Desktop. No API key or extra configuration is required after installation.

The whale automatically responds to every Agent status: it swims fast when a task is running, shows a thought bubble while the model generates output, and taps the glass with amber pulse and flashing browser tab title when the Agent requests user approval. After a task completes, it does a flip and reads out a summary of time, tools used and files edited; if the task fails, it sinks down with sad eyes. You can drag the whale anywhere on the screen, and its position is automatically saved for future sessions. Hovering over it shows your task stats, and clicking triggers playful reactions with synthesized sound effects.

whale-on-desk is released under the open source MIT license, with no associated costs for personal or commercial use. It includes a growth system that accumulates experience for every completed task and session, with 8 unique titles to unlock, and never penalizes users for failed tasks. The AI Pet Forge feature lets you ask the Agent to generate a custom pet directly from a text prompt, which requires ffmpeg available in your system PATH. You can also manually add custom pets by adding sprite GIFs and a manifest file to the plugin’s config directory, and switch between them instantly without restarting DSH.

whale-on-desk 是专为 DeepSeek Harness 开发的原生像素风鲸鱼桌宠插件，会实时跟随 DSH 中 Agent 的工作状态变化，展示不同的动画交互。当 Agent 运行任务时鲸鱼快速游动，模型输出时冒思考泡泡，调用工具时吐出对应标签的泡泡，请求用户批准时会贴边敲玻璃并触发提醒，任务完成后空翻庆祝，失败则下沉难过。

本插件同时支持官方 DSH 网页版和社区开发的 DSH Desktop Electron 桌面版，通过一条命令即可完成安装，重启 DSH 界面就能使用。用户可将鲸鱼拖动到任意位置，位置信息会自动保存，右键点击鲸鱼可调出菜单，支持静音、重置位置、切换桌宠、隐藏等操作。它还内置成长系统，完成任务可累积经验解锁称号，全程无惩罚机制。

本项目采用 MIT 许可开源，可免费使用修改。它内置 AI 宠物工坊功能，支持让 Agent 直接生成自定义桌宠并热切换，该功能需要系统 PATH 中配置 ffmpeg。用户也可手动添加自定义桌宠，只需将精灵图 GIF 和对应配置清单放入指定配置目录即可。它还支持全屏水族馆模式，可边写代码边养鱼，所有音效实时合成，不占用额外存储空间。

View on GitHub在 GitHub 查看

Send to your DSH发给你的 DSH 安装

请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】，检查通过再动手。

插件：whale-on-desk（cookiesheep/whale-on-desk）
仓库：https://github.com/cookiesheep/whale-on-desk
本站详情页：https://www.yhbd.top/plugins/cookiesheep-whale-on-desk/
本站登记：类型 client · 归类 原生 DSH 插件 · 许可证 MIT · ⭐ 8 · 最近提交 2026-08-19 · 主语言 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兼容性 · 安全性 2 warnings2 项注意

Only 8 stars - very few users, little community feedback星标只有 8，几乎没人在用，遇到问题缺少社区反馈
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 whale-on-desk

把 cookiesheep/whale-on-desk 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

5.6 KB · 缓存于 2026-08-23 03:42:33 · 5.6 KB

whale-on-desk 🐳 鲸桌

中文 | English | 🏠 官网

给 DeepSeek Harness 的像素鲸鱼桌宠。 Agent 干活时它游泳,调工具时吐泡泡,请求批准时贴着屏幕敲玻璃。

它会做什么

鲸鱼住在 DeepSeek Harness 网页界面的一角,实时反映 Agent 的状态:

Agent 在干嘛	鲸鱼在干嘛
任务运行中	快速游泳 🏊
模型输出中	陪它思考,头顶思考泡泡 💭
调用工具	吐一个带友好标签的泡泡(敲命令 / 读文件 / …)
请求批准	贴住屏幕边缘敲玻璃 + 琥珀色脉冲,浏览器标签标题闪 🔔
任务完成	空翻庆祝 + 开口汇报:"搞定! 3 分 12 秒,跑了 8 个工具,改了 5 个文件" 🎉
任务失败	下沉,眼睛变横线 😢
上下文约 62% / 82%	喂鱼时间——"还能吃一点 / 吃饱了" 🍤
闲置 5 分钟	主动讨活:"我闲着呢,有活吗?"
闲置 10 分钟	睡着 💤
本地 00:00–06:00	戴睡帽 🌙
悬停鲸鱼	显示当前任务统计牌(耗时 / 工具数)
点击鲸鱼	惊吓反应 + 随机台词("别戳啦")
单击 / 双击它	吱吱叫 / 惊醒炸毛(带音效)

可以拖到任何位置,位置自动记住。音效为实时合成,零音频文件。

安装

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

打开(或重启)DSH 网页界面即可。无需 API Key,无需配置。

DSH Desktop(社区 Electron 桌面版)同样支持——它跑的就是官方 Web 客户端,插件体系和 DSH home 与网页版一致。在应用托盘打开 Open DSH Terminal,执行 dsh plugin add whale-on-desk,重启 DSH Desktop 即可。

卸载 / 配置

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

睡眠超时可在 cordis.patch.yml 配置(sleepAfterMinutes,默认 10)。右键点鲸鱼有小菜单(静音 / 回到默认位置 / 换桌宠 / 隐藏——隐藏后双击右下角 🐳 恢复)。配置 allowPreview: true 会额外开启 POST /whale/preview {"state":"glass-tap"}(传 {"state":null} 恢复)——方便录演示和截图,默认关闭。

成长系统与 Agent 语音

鲸鱼会陪你长大——完成任务获得经验,开启会话获得经验,陪伴时长持续累积。8 个称号等你解锁。升级和解锁称号时鲸鱼开口庆祝。悬停可见等级、称号和经验进度。零负反馈:永不扣分,永不惩罚。

whale_say 工具——你的 Agent 可以让鲸鱼说话和表演。鲸鱼成了 Agent 的通知通道。

水族馆模式

水族馆

右键鲸鱼 → 🐠 水族馆,进入全屏水族箱:手绘水体背景(自动适配明暗主题)、海草摇曳、随工具调用生长的进度珊瑚、计数本回合工具数的小鱼群——大鲸鱼本体就是 Agent:等批准时冲向缸边敲玻璃(警示浮标闪烁)。水层保持半透明且点击穿透,可以边写代码边养鱼。按 Esc(或 ✕ 按钮)回到桌面伙伴模式。

AI 宠物工坊

插件向 harness 注册了 pet-forge 技能:直接对 Agent 说"给我做一只粉色章鱼桌宠"——它会设计精灵图、跑和内置鲸鱼同款的像素审计、切出 GIF、装成宠物包并当场热切换,全程无需重启。(需要 PATH 里有 ffmpeg。)

自定义桌宠

把一套精灵放进 ~/.dsh/whale-on-desk/pets/<名字>/——一个把状态映射到 GIF 文件的 manifest.json,加上 GIF 本体:

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

渲染基于仓库 cookiesheep/whale-on-desk 的 README.md。在 GitHub 查看原文 →