Introduction

When running multiple sessions on the DSH web interface, developers usually need to check which threads are busy, what tools they are calling, and what stage the current event is at. Looking at logs directly is possible, but the information is scattered.

dsh-pet-shura puts this information onto an animated desktop pet: event bubbles are displayed above the pet, double-clicking or right-clicking opens the thread status card, and busy threads correspond to tool nodes displayed around the pet.

Below is an introduction to its capabilities, installation methods, and typical usage.

What is it

dsh-pet-shura is an animated desktop pet for the DeepSeek Harness (DSH) web interface maintained by brittanistrehlowll-oss, with the Chinese name “Shura Little Brain Tiger”. The license is MIT.

It is based on the v2 spritesheet:

1536×2288
8 columns × 11 rows
192×208 cells

The package.json version is 1.5.0, type is module, and the main entry is lib/index.js. The README declares it a zero-dependency host plugin and states, “Nothing touches your model traffic.”

Core Features

Event Bubbles and Thread Overview

  • SSE Bubbles: Displays Codex-style bubbles above the pet via /pet/events.
  • Thread Overview: Tracks busy threads (sessions), refreshing every 15 seconds.
  • Chinese Dialogue Library: Changes based on event types like user/work/done/error/ask/reply/turn-end/workflow/goal, and has 45–90 seconds of idle self-talk.

Animation, Cursor Following, and State Expression

  • Full v2 Animation: Covers 11 rows of the spritesheet, including idle, running left/right, waving, jumping, failed, waiting, task-running, review, and 16-direction panning.
  • Look-at-mouse: Follows the cursor with 16-direction frames (240px radius).
  • Drag and remember position: Saved in localStorage['dsh.pet.pos'].
  • Random Actions: Waves, jumps, rolls, or walks every 7–16 seconds, entering a waiting pose after 22 seconds of idling.
  • Status Symbols: Displays ? when thinking, a red shaking ! on error, a blinking checkmark on success, and Zzz when waiting.
  • Plugin Ring: A semi-circle tool ring around the pet, with up to 6 nodes corresponding to busy threads, driven by GET /pet/status.
  • Core Glow: Enhanced while working, presenting a visible energy core state.

Thread Status Card, Settings, and Right-click Menu

  • Thread Status Card: Double-click the pet or right-click “Thread Status” to view busy threads and tool information provided by GET /pet/status.
  • Settings Panel: Right-click “Settings” to adjust size (60/75/100%), random actions, look-at-mouse, or reset position, saved in localStorage['dsh.pet.settings'].
  • Right-click Menu: Pet Info, Hide/Recall, Thread Status, Settings.
  • Safe Fallback: The script removes itself if the spritesheet is unavailable, without disturbing the host page.

Installation and Activation

First, run the installation command:

dsh plugin --profile web add "github:brittanistrehlowll-oss/dsh-pet-shura"

Then restart dsh web and refresh the page.

To uninstall, run:

dsh plugin --profile web remove dsh-pet-shura

Then restart dsh web.

Typical Usage

  1. Double-click the pet or right-click “Thread Status” to view busy threads and their tools.

  2. Right-click the pet and select “Settings” to adjust size, random actions, look-at-mouse, or reset position.

  3. If making minor changes, usually just edit lib/pet-client.js; this file is inlined to index.html by tapIndex, requiring no build steps.

Applicable Scenarios and Notes

Suitable for developers who need to maintain visibility of multiple thread states on the dsh web surface. It writes position settings to the browser:

localStorage['dsh.pet.pos']
localStorage['dsh.pet.settings']

It uses /pet/events SSE, GET /pet/status, and dedicated spritesheet routes at runtime.

The plugin runs with the current dsh process permissions. Before installing, check the source code and license, and only enable trusted plugins.

Related Pages

  • Directory Page: https://www.skillhub.cn/plugins/brittanistrehlowll-oss/dsh-pet-shura
  • GitHub: https://github.com/brittanistrehlowll-oss/dsh-pet-shura