Er1c0v0/dsh-whale-pet 预览 preview

Er1c0v0/dsh-whale-pet

Plugin插件 Native原生 ⭐ 5 MIT Pets & Fun桌宠与娱乐

DeepSeek Harness Web UI 的可爱鲸鱼女孩宠物插件

Project Overview项目介绍

This is a native plugin built exclusively for the DeepSeek Harness (DSH) web UI, adding an interactive whale-girl desktop pet to the DSH interface. It hooks into DSH via the official shell.overlay extension slot, so it requires no patching of DSH core code or scraping of UI text to function. To install, users run the command dsh plugin --profile web add dsh-whale-pet@0.1.0, then regenerate the DSH config with dsh --profile web --dump-config and restart the web profile, after which the pet appears at the bottom right of the web UI.

The pet mirrors five different DSH session states, including idle, working, needs input, complete, and blocked. When DSH is idle, the pet hugs a DeepSeek whale-inspired pillow, falls asleep after 40 seconds of inactivity, and plays a friendly three-pose wave animation when hovered or focused by the user. Users can drag the pet anywhere around the screen, move it with keyboard shortcuts, reset its position to default, collapse or restore it as needed, and it supports both English and Simplified Chinese interfaces.

The plugin requires Node.js version 22.19+ or 24+ and DSH version 0.1.0-rc.6 or newer to work properly on any supported system. It is privacy-first: it only reads current session status and presentation metadata from DSH, never reads prompts, conversation text, or tool arguments, and sends no analytics data to any external server. All user preferences are stored locally in the browser, the code is distributed under the open-source MIT license, while the artwork is licensed under CC BY 4.0 with full attributions recorded.

这是专门为DeepSeek Harness(DSH)Web UI打造的原生桌面宠物插件,功能是在DSH界面右下角显示一个鲸娘形象的桌面宠物,同步反映DSH当前的会话状态。它使用官方提供的shell.overlay插槽接入,无需修改DSH源码或抓取界面文本就能正常运行。用户可以通过DSH的插件命令行工具完成安装,安装后宠物就会自动出现在Web界面右下角。

这款插件面向喜欢给工具增加趣味交互的DSH用户,能够同步匹配DSH的五种会话状态:空闲、运行中、需要输入、完成、阻塞。空闲状态下她会抱着深鲸主题的抱枕,40秒后自动入睡,被唤醒后会做出友好的挥手动作。用户可以拖动宠物移动位置,也支持快捷键移动、重置位置、收起恢复等操作。

该插件要求用户环境安装Node.js 22.19+或24+版本,同时需要DSH版本不低于0.1.0-rc.6。隐私方面,它仅读取当前会话状态和DSH提供的展示元数据,不会读取提示词、对话内容或工具参数,也不会发送分析请求,用户偏好保存在浏览器本地存储中。代码采用MIT许可证授权,插画采用CC BY 4.0授权。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 5 stars - very few users, little community feedback星标只有 5,几乎没人在用,遇到问题缺少社区反馈
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 dsh-whale-pet@0.1.0

把 Er1c0v0/dsh-whale-pet 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-whale-pet

简体中文

A whale-girl desktop pet plugin for the DeepSeek Harness Web UI.

Idle Hover wave Working Complete
Idle animation Hover wave Working animation Ready animation

Highlights

  • Mirrors five Harness states: idle, working, needs input, complete, and blocked.
  • Hugs a DeepSeek-whale-inspired pillow while idle, falls asleep after 40 seconds, startles awake, and plays one friendly three-pose wave when hovered or focused.
  • Shows privacy-safe activity summaries from Harness presentation metadata in bubbles that choose an on-screen position around the pet without covering the character.
  • Supports dragging, keyboard movement, position reset, collapse/restore, reduced motion, English, and Simplified Chinese.
  • Uses the official shell.overlay slot without patching Harness or scraping UI text.

Install

Requires Node.js 22.19+ or 24+ and DeepSeek Harness 0.1.0-rc.6.

dsh plugin --profile web add dsh-whale-pet@0.1.0
dsh --profile web --dump-config
dsh --profile web

The dump should contain exactly one dsh-whale-pet entry. The pet appears at the bottom-right of the Web UI.

To uninstall:

dsh plugin --profile web remove dsh-whale-pet
dsh --profile web --dump-config

State mapping

Priority Session condition Pet state
1 Removed Blocked
2 Approval, plan review, or question pending Needs input
3 Running Working
4 Explicit open, agent, or prompt error Blocked
5 A running session stops successfully Complete for 1600 ms
6 No session, cold/loading, or settled Idle

Development

pnpm install --frozen-lockfile
pnpm check
pnpm test:visual
npm pack
node scripts/smoke-harness.mjs --package ./dsh-whale-pet-*.tgz

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

← 上一个 Prev dsh-cross-session 下一个 Next dsh-connect →