BorisShaw6/dsh-cyber-pet 预览 preview

BorisShaw6/dsh-cyber-pet

为DeepSeek Harness设计的“赛博鲸鱼”宠物:一条悬浮在网页上的鲸鱼,可喂养、会变色,实时显示令牌使用量、限制、上下文占用、交互次数和对话框数量——内置三个聊天后端、成长等级、情绪系统及里程碑庆祝功能。

Project Overview项目介绍

This is a native DeepSeek Harness (DSH) plugin that adds an interactive cyber whale pet to the DSH web UI. The whale is floating, can be fed, customized for color, and comes with two built-in skins: pixel-art and skeuomorphic. It tracks useful session metrics including token usage, remaining quota, context occupancy, conversation counts, and all your interactions with the agent. It also includes features like growth levels, mood changes, milestone celebrations, and a one-click option to generate a PNG report card of your session stats. A public live demo is available for testing before you install the plugin to your local DSH instance.

The plugin offers two installation paths, and the recommended one-click install method requires only Node.js 22.19 or newer and pnpm installed on your system. You run a single npx command to add the plugin to your DSH web profile, then restart the DSH web UI to see the whale appear. For developers who want to modify or extend the plugin, a source checkout install method is also available, which lets you clone the full source code and customize it to your needs. This plugin is for any DSH user who wants a fun interactive companion while working with their AI agent.

The plugin is released under the open source MIT license, matching the license of DeepSeek Harness itself. Common troubleshooting tips are documented in the README for common issues like missing whale or port conflicts. Since DSH is currently in developer preview, its API may change between releases, so there are version requirements for the two installation methods. One-click install is for DSH version 0.1.0-rc.6 and newer, while source install is pinned to work with DSH 0.1.0-rc.5. You cannot mix the two installation methods on the same DSH instance, and you will need to restart the DSH web UI after install for the plugin to load.

这是一款专为 DeepSeek Harness(DSH)开发的原生插件,它为DSH的网页界面添加了一只可互动的电子鲸鱼宠物。这只鲸鱼支持投喂、自定义颜色,会追踪你的token用量、配额、上下文占用、对话次数和交互记录。它还拥有成长等级、情绪变化、里程碑庆祝功能,支持一键生成PNG格式的会话统计报告卡,也提供在线试用演示。

插件提供两种安装方式,推荐使用一键命令安装,只需要提前安装Node.js 22.19以上版本和pnpm,运行一行npx命令就能完成安装,重启DSH网页端后就能看到游动的鲸鱼。开发者也可以选择源码检出安装,适合想要自定义修改功能的用户,能满足普通用户和二次开发者的不同使用需求。

本插件采用MIT许可证开源,和DeepSeek Harness本身的许可证一致。需要注意的是,由于DSH目前处于开发者预览版,API可能会在不同版本间发生不兼容变动,一键安装针对DSH 0.1.0-rc.6以上版本,源码安装固定适配0.1.0-rc.5版本,两种安装方式不能混用。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
  • No DSH plugin manifest detected - it may only carry the dsh-plugin topic, so the install method must be confirmed on the spot未检测到 DSH 插件清单:可能只是打了 dsh-plugin 话题,安装方式要现场确认
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命令行安装

npx @deepseek-ai/dsh plugin --profile web add @borisshaw6/dsh-cyber-pet

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

READMEREADME

dsh-cyber-pet 🐳

English | 中文 · 🎮 Live Demo


A cyber whale pet for DeepSeek Harness: a floating, feedable, color-customizable whale that lives inside the Web UI and reports your token usage, quota, context occupancy, interactions, and conversation counts — with three chat backends, growth levels, moods, milestone celebrations, and a one-click PNG report card.

🎮 Try it without installing anything: Live Demo — swap skins, recolor the whale, simulate turns, and feed it, right in your browser.

Gallery

Two skins — pixel-art and skeuomorphic (the animated tiles are live SVG recreations of the in-app skins; the photos are real screenshots):

Pixel-art Skeuomorphic
pixel whale demo skeuo whale demo
pixel whale in app skeuo whale in app

The dashboard in both UI languages (Chinese / English):

Chinese UI English UI
dashboard zh dashboard en

It talks — the whale reports every completed turn (cost + remaining quota) in a speech bubble:

speech bubble

Install

Option A — one-line install (recommended, zero source code)

All you need is Node.js (≥ 22.19, LTS recommended) and pnpm — the plugin command delegates to it, one-time setup: npm install -g pnpm. No Git, no source checkout, no build.

1. Add the whale to your harness web profile — one line:

npx @deepseek-ai/dsh plugin --profile web add @borisshaw6/dsh-cyber-pet

The first run asks y to confirm downloading the harness; when you see + @borisshaw6/dsh-cyber-pet, it is installed.

2. Start (or restart) the web UI:

npx @deepseek-ai/dsh web

The whale loads at profile startup. If a web session is already running, stop it and run the command again — a bare browser refresh is not enough.

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-verify 下一个 Next dsh-session-drafts →