dsh-plugin-whale-maid
Manifest validA chibi whale-maid companion plugin for DeepSeek Harness
Whale Maid Companion
A chibi whale-maid companion who works, waits, celebrates and naps alongside you.

All six states, rendered by a real browser in both themes. Regenerate with python artwork/tools/review-states.py.
一只住在 DSH 窗口里的 Q 版鲸鱼小管家:陪你工作、等你确认、为你欢呼,也陪你打个盹。
This plugin keeps the full feature set of its upstream project
dsh-plugin-whale-pet (MIT code, v0.2.9)
and replaces the character: the whale stickers are gone, and every state is drawn from an
owner-supplied chibi whale-maid illustration with its own transparent cut-out, per-state
recolouring and small vector effects.
Features
- Drag, resize, hide, and restore the companion inside the DSH window.
- Choose All sessions or Current session, with a working-session count for ordinary main sessions.
- Six states: resting, working, waiting, celebrating, sleeping, and error.
- A custom plugin-manager icon, built from the same artwork and legible at 16 px.
- English and Chinese text, light and dark settings menus, and reduced-motion support.
- Separate normal completion from cancellation and failure; a falling working count or a green unread indicator alone does not mean success.
This is an in-window plugin, not a separate operating-system desktop overlay.
The six states
| State | Look |
|---|---|
| resting | the character as drawn, with soft floating hearts |
| working | slightly warmer and brighter, with small progress sparkles |
| waiting | a thought bubble appears above the head |
| celebrate | brighter still, with stars and confetti around her |
| sleeping | dimmed and blue-shifted, with drifting "Z" marks |
| error | desaturated to grey, with a warning badge |
![]()
The plugin-manager icon at the sizes DSH actually draws it.
Each state ships as one SVG that embeds the character raster plus its own vector effects.
The artwork is generated from the source illustration by the scripts in artwork/, so the
whole set can be regenerated after the illustration changes:
python artwork/tools/make-assets.py # writes assets/*.svg and assets/icon.svg
python artwork/tools/review-states.py # writes artwork/build/states-with-effects.png
Install
Direct download: dsh-plugin-whale-maid-1.0.0.tgz from the v1.0.0 release, then enter its absolute path in DSH's plugin installation interface:
<wherever you saved it>\dsh-plugin-whale-maid-1.0.0.tgz
Verify the download before installing:
size 747460 bytes
sha256 8a9a71681a14af84a0444fc58655996f9da66e727d85f996defc62a3b55a24f7
Install straight from this repository
Enter this in the same interface; DSH fetches and installs the package for you:
github:yangyiqun747/dsh-plugin-whale-maid
Build the package yourself
npm pack # writes dsh-plugin-whale-maid-1.0.0.tgz
The package carries prebuilt lib/ output, so installing it runs no build step and downloads
nothing. After an update that changes Host or client modules, wait for running tasks to
finish, fully quit DSH, and reopen it — closing a window may not quit the application.
The plugin never edits your profile by itself. It inserts exactly one row (entry id
whale-maid) through its cordis.patch.yml.
Usage
- Click the companion to say hello; drag her to reposition.
- Right-click to change session scope, size, animation, and nap timing.
- Use the restore button to bring back a hidden companion.
- Global scope covers ordinary main sessions on the currently connected Host—not multiple devices or Hosts.
- Waiting for user input has higher display priority. Brief completion notices are not queued for later replay.
Development
Use Node.js 22 or newer. The build needs esbuild and zod@4.4.3 as development
dependencies (declare them locally, for example with pnpm install); nothing is installed
or downloaded at plugin install time.
node tools/bridge-build.mjs # regenerate lib/remote.js + lib/index.js
node tools/build.mjs # regenerate lib/client.js + offline preview
node --test "tests/*.test.mjs"
tools/check-glyphs.mjs reports any bubble phrase that the embedded font subset cannot
draw; the shipped Chinese dictionary is kept inside that subset so the bubble font never
falls back mid-sentence.
The build validates every state SVG: no scripting, no remote reference, <image> only with
an inline PNG payload, and a size ceiling. Open preview/index.html directly in a browser
for an offline preview that never connects to DSH or a model.
Privacy and runtime boundaries
- Does not modify DSH itself, send model messages, add model inference calls, or act on approvals for you.
- Uses DSH's existing authenticated connection. No additional listening port, telemetry, or runtime font/CDN requests.
- The completion bridge projects only session identity and turn-boundary metadata—not chat content.
- Preferences stay in client-local storage.
Licensing
- Code: MIT, inherited from the upstream project. The upstream repository, its build tooling, its state machine and its wording are the work of the upstream authors.
- Character artwork: supplied by this package's owner. See the notice and character asset notes; it is not covered by the MIT code license.
- Bubble fonts: unchanged upstream subsets, see font licenses.
This is a personal project, not an official DeepSeek product. It does not represent
DeepSeek's official views or endorsement, and it is not affiliated with the upstream
dsh-plugin-whale-pet project beyond the MIT-licensed code it builds on.
Comments
Loading…
Similar plugins
by Gorkaseto
A lightweight, pixel-art companion plugin for DeepSeek Harness (DSH) that adds an animated whale pet above the input composer during new sessions.
★ 0
Apache-2.0
JavaScript
Oct 21, 2026
dsh plugin --profile web add dsh-whale-petby Er1c0v0
Cute whale-girl pet plugin for the DeepSeek Harness Web UI
★ 4
↓ 147/wk
MIT
TypeScript
Aug 18, 2026
dsh plugin --profile web add dsh-whale-petby AcidGr
DeepSeek Harness (dsh) Web plugin — Anime maid whale desktop pet with satiety system and real-time LLM interaction
★ 10
↓ 191/wk
MIT
JavaScript
Sep 23, 2026
dsh plugin --profile web add dsh-web-whale-maidby yefeng7531
DeepSeek 娘 (whale maid) in-page mascot plugin for DeepSeek Harness web UI
★ 10
NOASSERTION
JavaScript
Sep 19, 2026
dsh plugin --profile web add dsh-whale-maid-mascotby pythonshiyi
DeepSeek Harness whale girl token feeding desktop pet plugin
★ 0
MIT
JavaScript
Aug 15, 2026
dsh plugin --profile web add dsh-plugin-whalefeedby Sutera-Diffusus
DeepSeek Harness 桌宠插件:元气鲸鱼娘陪你写代码 🐋
★ 216
↓ 2.6k/wk
MIT
JavaScript
Nov 17, 2026
dsh plugin --profile web add dsh-whale-musume