Vulcan626/dsh-pet
30Last commit Aug 14, 2026
dsh-pet DSH plugin
dsh-pet keeps a DeepSeek whale visible in the DSH Web viewport, swimming in place and reflecting session lifecycle states. It provides a click-to-open panel with current chat title, provider/model identity, and API statistics from sessionStats, tokenUsage, and contextPressure. The plugin also includes a Snake mini-game that can be toggled via commands or the statistics panel.
How to install the dsh-pet DSH plugin
dsh plugin --profile <name> add github:Vulcan626/dsh-petThis source command needs manual review. Copying does not run it.
dsh-pet DSH plugin data source
dsh-pet DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-pet DSH plugin can do
- Session-aware overlay with a swimming whale and status animations (idle, running, waiting, failed, completed).
- Click-to-open statistics panel showing chat title, provider/model, and API usage (cache hit, context occupancy).
- Draggable overlay with persistent browser-local position and viewport edge clamping.
- Commands /pet and /pet-game to toggle the overlay and mini-game from the DSH command input.
- Built-in Snake mini-game with countdown, arrow/WASD controls, pause, restart, and browser-local high score.
Where the dsh-pet DSH plugin fits
- Add a visual pet to the DSH interface for a more engaging development experience.
- Quickly monitor API token usage, cache hit rate, and context pressure without leaving the chat.
- Take a break with a Snake mini-game that can be launched from the statistics panel or command input.
- Use the overlay as a visual indicator of the current session state (running, waiting, failed, etc.).
Who the dsh-pet DSH plugin is for
- Developers using DeepSeek Harness (DSH) who want a playful UI enhancement.
- Users who enjoy interactive elements or gamification in their development environment.
dsh-pet DSH plugin limitations
- Cannot be installed directly via `dsh plugin add`; requires manual integration into the DSH monorepo workspace.
- Depends on specific DSH workspace dependencies and TypeScript project references; not self-contained for Git install.
- Mini-game high score is local to the browser tab and does not sync across tabs or persist outside the browser.
dsh-pet DSH plugin: from the repository README
Quoted from the Vulcan626/dsh-pet README, the upstream source of the dsh-pet DSH plugin. Copyright remains with the original authors.
English | [中文](README.zh.md) A community DeepSeek Pet plugin for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness). It keeps a DeepSeek whale visible in the Web viewport, swims in place, follows the current session lifecycle, and opens a compact API statistics panel.   ## What it provides - A fixed viewport overlay with an in-place swimming whale; a frame-sized atlas viewport advances through discrete frames with a one-pixel vertical bob, without horizontal travel or rotation. - Current-session states for idle, running, waiting, failed, and completed turns, with English and Simplified Chinese dictionaries. - A click-to-open panel for the current chat title, latest provider/model identity, and API statistics from `sessionStats`, `tokenUsage`, and `contextPressure` projections. - Primary-pointer dragging with grab-point tracking, an 8px viewport margin, persistent browser-local position, and viewport clamping. - An expanded panel that chooses the side with more room, collides with ev
Read the full READMERepository license: MIT
dsh-pet DSH plugin questions
How do I install dsh-pet?
dsh-pet is not yet available as a standalone installable plugin. You need to manually place the source in the DSH monorepo under `packages/client/ui-pet`, add the workspace dependency, and run the build steps described in the README. Follow the official DSH plugin publishing guide for future self-contained installation.
How do I open the statistics panel?
Click on the swimming whale overlay. The panel will expand showing the current chat title, provider/model, and API statistics including cache hit rate and context pressure. You can also use the `/pet` command to toggle the overlay visibility.
Can I move the whale around the screen?
Yes, you can drag the whale by clicking and holding on it. The position is saved in your browser's local storage and will be restored on reload. The overlay is constrained to stay within the viewport with an 8px margin.
How does the Snake mini-game work?
Use the `/pet-game` command or click the 'Open mini-game' button in the statistics panel. The game starts with a 3-second countdown. Control the snake with arrow keys or WASD. Space pauses/resumes, double Space restarts. The score blocks are colorful and food placement adapts to your score.
Does the plugin affect my API usage or model requests?
No, the plugin reads session statistics through DSH runtime hooks but does not send any model requests or add model-visible content. It only displays data already available in the session. The mini-game is entirely local to your browser.